feature: agent publish guide - #4011
Merged
Merged
Conversation
MoeexT
requested review from
Dallas98,
Jasonxia007,
WMC001,
YehongPan,
hhhhsc701 and
jeffwu-1999
as code owners
September 23, 2026 09:24
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Unresolved critical and moderate issues affect share routing, concurrency, runtime cleanup, validation, deployment, and frontend links/tests.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 5
Open (11)
What changed in this PR
Adds an Agent publishing/usage guide with localized deep links, authenticated sharing, isolated runtime sessions, and deployment support.
Changes:
- Adds frontend guide, sharing, authentication, localization, and deep-link flows.
- Adds signed share tokens, sessions, rate limits, and identity isolation.
- Updates APIs, persistence, proxying, deployment, logging, and tests.
| File | Description |
|---|---|
test/backend/utils/test_logging_utils.py |
Token-redaction tests |
test/backend/services/test_runtime_state_service.py |
Scoped rate-limit tests |
test/backend/services/test_core_service_slimming.py |
Share memory-isolation tests |
test/backend/services/test_conversation_management_service.py |
Empty-history handling tests |
test/backend/services/test_agent_share_token_service.py |
Token validation tests |
test/backend/services/test_agent_share_service.py |
Share workflow tests |
test/backend/services/test_agent_service.py |
Identity and run tests |
test/backend/services/test_agent_repository_service.py |
Internal-name assertion |
test/backend/database/test_conversation_db.py |
Share filtering tests |
test/backend/database/test_agent_share_schema.py |
Schema migration tests |
test/backend/database/test_agent_share_db.py |
Share persistence tests |
test/backend/consts/test_agent_share_config.py |
Configuration boundary tests |
test/backend/app/test_northbound_app.py |
Missing-Agent 404 test |
frontend/vitest.config.ts |
Vitest component-test configuration |
frontend/types/agentRepository.ts |
Internal Agent-name type |
frontend/tests/proxyRouting.test.ts |
Proxy-routing test |
frontend/tests/frontendConfig.test.ts |
Public-config test |
frontend/tests/component/shareAuthenticationLayout.test.tsx |
Share authentication UI tests |
frontend/tests/component/setup.ts |
Component test setup |
frontend/tests/component/i18nStub.ts |
i18n test stub |
frontend/tests/component/agentUsageGuideDeepLink.test.tsx |
Usage-guide deep-link tests |
frontend/tests/component/agentShareService.test.tsx |
Share-service test |
frontend/tests/component/agentPublishAndSharePage.test.tsx |
Publish/share page tests |
frontend/tests/component/agentChatPageDeepLink.test.tsx |
Chat deep-link tests |
frontend/tests/component/agentChatDeepLink.test.tsx |
Deep-link state tests |
frontend/tests/agentUsageGuideLocales.test.ts |
Locale consistency tests |
frontend/tests/agentUsageGuide.test.ts |
Guide helper tests |
frontend/tests/agentShareChat.test.ts |
Share-chat helper tests |
frontend/services/configService.ts |
Runtime configuration typing |
frontend/services/api.ts |
Share endpoints |
frontend/services/agentShareService.ts |
Share management API |
frontend/services/agentShareRuntimeService.ts |
Share runtime API |
frontend/server.js |
Runtime and Northbound proxying |
frontend/runtime-frontend-config.mjs |
Public runtime configuration |
frontend/public/locales/zh/common.json |
Chinese guide copy |
frontend/public/locales/en/common.json |
English guide copy |
frontend/proxy-routing.mjs |
Runtime route classification |
frontend/pnpm-workspace.yaml |
Build permission |
frontend/package.json |
Test tooling and dependencies |
frontend/lib/agentUsageGuide.ts |
Guide URL and state helpers |
frontend/lib/agentShareChat.ts |
Share-chat helpers |
frontend/hooks/auth/useAuthenticationUI.ts |
Share authentication behavior |
frontend/hooks/auth/useAuthenticationState.ts |
Login return-path handling |
frontend/app/[locale]/share/agent/[shareToken]/page.tsx |
Shared Agent chat page |
frontend/app/[locale]/newchat/page.tsx |
Agent deep-link handling |
frontend/app/[locale]/layout.client.tsx |
Authentication dialogs |
frontend/app/[locale]/agents/versions/AgentVersionPubulishModal.tsx |
Publish completion behavior |
frontend/app/[locale]/agents/page.tsx |
Publish-to-guide navigation |
frontend/app/[locale]/agents/components/a2a/A2AServerSettingsPanel.tsx |
Accessible copy controls |
frontend/app/[locale]/agents/agent-config.tsx |
Default version names |
frontend/app/[locale]/agent-space/my-agent.tsx |
Usage-guide deep links |
frontend/app/[locale]/agent-space/components/MyAgentCard.tsx |
Guide menu action |
frontend/app/[locale]/agent-space/components/AgentUsageGuideModal.tsx |
Usage-guide UI |
deploy/sql/migrations/v2.6.2_001_grant_resource_space_to_su.sql |
SU navigation permissions |
deploy/sql/migrations/v2.5.4_agent_share.sql |
Agent-share schema |
deploy/k8s/helm/nexent/charts/nexent-web/templates/deployment.yaml |
Northbound backend configuration |
deploy/images/dockerfiles/web/Dockerfile |
Runtime asset packaging |
deploy/images/build.sh |
Image build argument handling |
deploy/docker/compose/docker-compose.yml |
Compose Northbound configuration |
deploy/docker/compose/docker-compose.prod.yml |
Production Northbound configuration |
backend/utils/logging_utils.py |
Share-token log redaction |
backend/services/runtime_state_service.py |
Scoped Redis rate limiting |
backend/services/northbound_service.py |
Lookup error propagation |
backend/services/conversation_management_service.py |
Share conversation support |
backend/services/agent_share_token_service.py |
Signed share tokens |
backend/services/agent_share_service.py |
Share orchestration |
backend/services/agent_repository_service.py |
Internal Agent names |
backend/runtime_service.py |
Runtime logging setup |
backend/management/services/agent/run.py |
Runtime identity separation |
backend/management/services/agent/run_identity.py |
Identity context |
backend/management/services/agent/run_context.py |
Memory suppression |
backend/management/services/agent/management.py |
Agent lookup error mapping |
backend/database/db_models.py |
Share ORM models |
backend/database/conversation_db.py |
Share conversation filtering |
backend/database/agent_share_db.py |
Share persistence |
backend/consts/model.py |
Share-run request validation |
backend/apps/runtime_app.py |
Runtime share router |
backend/apps/northbound_app.py |
Northbound 404 mapping |
backend/apps/agent_app.py |
Share APIs |
backend/agents/create_agent_info.py |
Memory flag propagation |
.gitignore |
Ignore additions |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Codecov Report❌ Patch coverage is 📢 Thoughts on this report? Let us know! |
Jasonxia007
requested changes
Sep 24, 2026
Jasonxia007
reviewed
Sep 28, 2026
Jasonxia007
reviewed
Sep 28, 2026
WMC001
reviewed
Sep 28, 2026
Jasonxia007
reviewed
Sep 28, 2026
…nt-publish-guide # Conflicts: # .gitignore # frontend/app/[locale]/agent-space/components/MyAgentCard.tsx # frontend/app/[locale]/agent-space/my-agent.tsx # frontend/app/[locale]/agents/page.tsx
WMC001
approved these changes
Sep 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
publish.mp4