fix(postgresql): support schemas in base store

[zouyx]

AgentScope-Java Version

2.0.1-SNAPSHOT

Description

Closes #2192.

PostgresBaseStore previously only supported unqualified table names. This PR adds optional PostgreSQL schema support while preserving the existing behavior when no schema is configured.

Changes:

• Add PostgresBaseStore.Builder#schemaName(String).
• Use quoted schema.table identifiers for all BaseStore SQL when a schema is configured.
• Create the schema before the table when initializeSchema(true) is enabled.
• Validate schema and table identifiers before including them in SQL.
• Add unit tests for schema-qualified queries, schema initialization, and invalid schema names.

Testing:

• mvn -q -pl agentscope-extensions/agentscope-extensions-postgresql -am -Dtest=PostgresBaseStoreTest -Dsurefire.failIfNoSpecifiedTests=false test
• Result: 40 tests passed.

Checklist

• Code formatting was verified by Spotless during the Maven build.
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions.
• Related API documentation has been updated.
• Code is ready for review.

[Copilot]

Pull request overview

Adds optional PostgreSQL schema support to PostgresBaseStore while keeping the existing unqualified-table behavior when no schema is configured. This aligns PostgresBaseStore more closely with other PostgreSQL-backed stores in the extensions module and addresses #2192.

Changes:

• Add PostgresBaseStore.Builder#schemaName(String) and build schema-qualified, quoted identifiers when configured.
• Create the schema (if configured) before creating the table when initializeSchema(true) is enabled.
• Add tests for schema-qualified SQL, schema initialization, and invalid schema names.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
agentscope-extensions/agentscope-extensions-postgresql/src/main/java/io/agentscope/extensions/postgresql/store/PostgresBaseStore.java	Adds schema configuration, qualified table naming, schema creation on initialization, and shared identifier validation.
agentscope-extensions/agentscope-extensions-postgresql/src/test/java/io/agentscope/extensions/postgresql/store/PostgresBaseStoreTest.java	Adds unit tests covering schema-qualified SQL usage, schema creation, and schema name validation.

[ningmeng0503]

#2167

[zouyx]

i think the problem the same as #2260

In #2260 , i have fixed in
agentscope-harness/src/test/java/io/agentscope/harness/agent/HarnessAgentSubagentStreamEventsTest.java

[AgentScopeJavaBot]

🤖 AI Review

This PR adds optional PostgreSQL schema support to PostgresBaseStore while preserving backward compatibility when no schema is configured. The implementation is clean and well-structured: it introduces a schemaName builder parameter, properly validates identifiers to prevent SQL injection, and generates correctly-quoted schema-qualified table names ("schema"."table"). The test coverage is good, covering schema-qualified queries, schema initialization, and invalid identifier rejection. However, there's one concern about the ON CONFLICT SET clause behavior with schema-qualified names that should be verified against a real PostgreSQL database, as the current tests use mocks.

(inline comments could not be attached — line numbers fell outside PR hunks. See archived report.)

[AgentScopeJavaBot]

🤖 AI Review

This PR adds optional PostgreSQL schema support to PostgresBaseStore while preserving backward compatibility when no schema is configured. The implementation is clean and well-structured: it introduces a schemaName builder parameter, properly validates identifiers to prevent SQL injection, and generates correctly-quoted schema-qualified table names ("schema"."table"). The test coverage is good, covering schema-qualified queries, schema initialization, and invalid identifier rejection. However, there's one concern about the ON CONFLICT SET clause behavior with schema-qualified names that should be verified against a real PostgreSQL database, as the current tests use mocks.

(inline comments could not be attached — line numbers fell outside PR hunks. See archived report.)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[oss-maintainer]

Summary

This PR contains 205 lines of changes. Review in progress.

---

Automated review by github-manager-bot