{"full_name":"agentscope-ai/agentscope-java","owner":"agentscope-ai","name":"agentscope-java","shard":"1","url":"https://github.com/agentscope-ai/agentscope-java","description":"Build distributed, production-grade, long-running agents.","homepage":"https://java.agentscope.io/","topics":["agent","agentic","agentic-ai","ai","llm","adk","agent-framework","agentscope","harness"],"tag_pages":["agent","agent-framework","agentic","agentic-ai","ai","harness","llm"],"language":"Java","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/211762292?v=4","created_at":"2025-09-23T04:37:43Z","pushed_at":"2026-11-15T15:18:46Z","metrics":{"stars":6374,"forks":1612,"watchers":45,"issues":1628,"prs":2529,"releases":30,"issues_open":655,"issues_closed":973,"prs_open":334,"prs_closed":887,"prs_merged":1308,"discussions":37},"growth":{"day":{"stars":7,"forks":3,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[6334,6349,6351,6365,6367,6374],"forks":[1598,1602,1602,1608,1609,1612],"watchers":[43,43,43,44,44,45],"issues_open":[672,652,645,650,654,655],"prs_open":[329,332,324,325,325,334]},"boards":{},"same_owner":[{"full_name":"agentscope-ai/AgentTeams","name":"AgentTeams","shard":"1","boards":{}},{"full_name":"agentscope-ai/QwenPaw","name":"QwenPaw","shard":"1","boards":{}},{"full_name":"agentscope-ai/ReMe","name":"ReMe","shard":"1","boards":{}},{"full_name":"agentscope-ai/agentscope","name":"agentscope","shard":"1","boards":{}}],"issues":[{"number":2338,"title":"Wanted: Who's using AgentScope 用户案例征集","comments":17,"created_at":"2026-07-21T06:55:43Z"},{"number":1535,"title":"历史对话消息页面如何加载渲染，ag-ui的实现里并没有MESSAGES_SNAPSHOT事件类型","comments":15,"created_at":"2026-05-30T09:38:13Z"},{"number":1875,"title":"MCP 动态注入","comments":12,"created_at":"2026-06-23T03:23:16Z"},{"number":3178,"title":"[Bug]: Declared/general-purpose subagents never inherit MCP tools (inherited toolkit captured from b.toolkit before MCP registration)","comments":9,"created_at":"2026-09-17T01:03:28Z"},{"number":1797,"title":"为什么模型会返回DSML","comments":9,"created_at":"2026-06-17T08:14:40Z"},{"number":1619,"title":"[Bug]:同一个HarnessAgent，不同的sessionId，不同的userId，上下文能互相访问到","comments":9,"created_at":"2026-06-05T00:46:35Z"},{"number":918,"title":"[Bug]:agentscope agent as tools模式下流式场景报错：Cannot add messages without tool results when pending tool calls exist.","comments":9,"created_at":"2026-03-11T03:29:29Z"},{"number":2821,"title":"开启长期记忆后，每次对话完成，会同步卡在那里等待，能不能做成异步的","comments":8,"created_at":"2026-08-24T07:46:49Z"}],"discussions":[{"number":4044,"title":"关于 2.1.x 中的 HarnessAgent 事件仅存单kv 表的问题。","comments":2,"category":"Q&A","created_at":"2026-11-07T10:23:36Z"},{"number":3706,"title":"[Bug] Service 2.1.0-BETA1: Chat remains empty despite successful model response","comments":0,"category":"General","created_at":"2026-10-21T09:52:20Z"},{"number":3698,"title":"agentscope-java realtime","comments":0,"category":"General","created_at":"2026-10-21T06:38:20Z"},{"number":3605,"title":"Declarative Extension (Middleware/Hook) Mounting for Managed Agents","comments":0,"category":"Ideas","created_at":"2026-10-16T06:57:08Z"},{"number":3530,"title":"历史对话消息存储问题","comments":1,"category":"Q&A","created_at":"2026-10-13T07:40:35Z"},{"number":3523,"title":"基于仓库的doc生成了一个更易读的学习文档","comments":0,"category":"General","created_at":"2026-10-12T16:15:22Z"},{"number":3522,"title":"如何工具运行在workspace之外的路径 （指定项目路径）","comments":1,"category":"Q&A","created_at":"2026-10-12T12:10:11Z"},{"number":3478,"title":"内置 ShellExecuteTool 没有规则配置 只能自定义tool吗","comments":1,"category":"Q&A","created_at":"2026-10-10T16:16:57Z"}],"latest_release":{"name":"v2.0.5","tag":"v2.0.5","published_at":"2026-11-14T02:46:38Z","body":"AgentScope Java 2.0.5 is a maintenance release that backports fixes from the main branch to 2.0.x. It hardens state persistence and cancellation, tool-call argument handling, context compaction, memory durability, skills, and sandboxes, and updates the default Anthropic and Gemini models. There are no new modules and no removed public APIs.\r\n\r\n### Behavior changes and upgrade notes\r\n\r\n- **Default model changes.** `AnthropicChatModel.builder()` now defaults to `claude-sonnet-5-5`, and `GeminiChatModel.builder()` defaults to `gemini-3.8-flash`. Set `modelName(...)` explicitly to keep model selection, behavior, and pricing independent of library upgrades; these defaults do not override a model name set in Spring Boot properties.\r\n- **Filesystem queue layout.** The filesystem-backed `WorkspaceMessageBus` now writes `{id}.payload` plus a `{id}.ready` claim marker instead of a single `{id}.json` ([#3281](https://github.com/agentscope-ai/agentscope-java/pull/3281)). Older drain-side instances only scan `.json` and cannot see new entries. On a shared backend, upgrade every drain-side instance before new writers publish, or pause queue traffic during the rollout; legacy `.json` entries remain readable.\r\n- **Namespaced memory reads.** For callers with a namespace, `MEMORY.md` and `memory/*.md` now fall back only inside that namespace; a root-level copy is no longer served to identified callers. Move existing root memory files into the namespace directory when upgrading. Contexts without a namespace or filesystem keep the root read ([workspace](/v2/en/docs/harness/workspace)).\r\n- **Structured output no longer forces strict mode.** The framework stops setting `strict: true` on the JSON schema it generates for structured output ([#2608](https://github.com/agentscope-ai/agentscope-java/pull/2608)). Enable it per model where the endpoint supports it with `OpenAIChatModel.builder().strictJsonSchema(true)`; a schema that already declares `strict` is left unchanged.\r\n- **Stricter tool schemas.** `@Tool(strict = true)` now recursively injects `additionalProperties: false` into every object node of the generated schema, so undeclared arguments are rejected on any provider and the schema satisfies OpenAI strict mode ([#1392](https://github.com/agentscope-ai/agentscope-java/pull/1392)). Hand-written schemas (`SchemaOnlyTool` or a custom `AgentTool`) are unchanged.\r\n- **SQL schema changes.** New PostgreSQL and H2 tables in `agentscope-extensions-jdbc` use `item_key VARCHAR(2048)` ([#3464](https://github.com/agentscope-ai/agentscope-java/pull/3464)); new MySQL tables pin the key columns to `utf8mb4_bin` ([#3288](https://github.com/agentscope-ai/agentscope-java/pull/3288)). Existing tables are never altered automatically and need a manual migration — see [MySQL / JDBC](/v2/en/integration/distributed/mysql) and [MySQL session storage](/v2/en/integration/session/mysql). After the MySQL migration, key comparisons become case-sensitive.\r\n- **Kubernetes workspace setup fails fast.** A non-zero `mkdir` exit code now fails the call with `SandboxErrorCode.WORKSPACE_START_ERROR` instead of continuing with a workspace that was never created ([#3951](https://github.com/agentscope-ai/agentscope-java/pull/3951)).\r\n- **Opt-in Redis cluster key layout.** `RedisAgentStateStore` can wrap the `userId/sessionId` segment in a Redis hash tag with `keyLayoutVersion(KeyLayoutVersion.V1)` so multi-key operations stay in one cluster slot ([#3129](https://github.com/agentscope-ai/agentscope-java/pull/3129)). The V0 layout remains the default; configure the same version on every store sharing a key prefix.\r\n\r\n### Fixed\r\n\r\n**Core / State / Cancellation**\r\n\r\n- Persist `ConfirmResult` rules into the session permission context, and make declared permission rules authoritative on every call ([#3377](https://github.com/agentscope-ai/agentscope-java/pull/3377), [#3361](https://github.com/agentscope-ai/agentscope-java/pull/3361)).\r\n- Persist the paused state before publishing a HITL au","is_prerelease":false},"readme":true,"readme_zh":true,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}