dsh-plugin-guide 0.3.21 → 0.3.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README-es.md +15 -12
- package/README-hi.md +15 -12
- package/README-pt.md +15 -12
- package/README-zh.md +15 -12
- package/README.md +290 -280
- package/SKILL.md +36 -19
- package/dist/dsh-plugin-dev.js +113 -9
- package/guide/choosing-a-plugin.md +412 -0
- package/guide/choosing-a-plugin.zh-CN.md +414 -0
- package/guide/links.md +20 -2
- package/guide/migration-0.2.md +219 -0
- package/guide/plugin-dev-guide.md +99 -24
- package/guide/quick-reference.es.md +14 -8
- package/guide/quick-reference.hi.md +15 -9
- package/guide/quick-reference.md +18 -10
- package/guide/quick-reference.pt.md +15 -9
- package/guide/quick-reference.zh-CN.md +19 -11
- package/guide/release-engineering.md +2 -2
- package/guide/release-engineering.zh-CN.md +2 -2
- package/guide/unfixed-issues.md +117 -82
- package/guide/when-to-retire-a-plugin.md +127 -0
- package/guide/when-to-retire-a-plugin.zh-CN.md +127 -0
- package/icon.svg +5 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +8 -4
- package/references/official-docs/AGENTS.md +8 -5
- package/references/official-docs/CONTRIBUTING.i18n.yaml +6 -5
- package/references/official-docs/README.i18n.yaml +33 -5
- package/references/official-docs/README.zh.md +3 -3
- package/references/official-docs/SNAPSHOT.md +3 -3
- package/references/official-docs/THIRD_PARTY_NOTICES.md +34 -6
- package/references/official-docs/docs/AGENTS.md +4 -4
- package/references/official-docs/docs/agent-lifecycle.i18n.yaml +9 -5
- package/references/official-docs/docs/api-gateway.i18n.yaml +27 -5
- package/references/official-docs/docs/api-gateway.md +10 -9
- package/references/official-docs/docs/api-gateway.zh.md +10 -9
- package/references/official-docs/docs/architecture.i18n.yaml +36 -5
- package/references/official-docs/docs/architecture.md +10 -8
- package/references/official-docs/docs/architecture.zh.md +10 -8
- package/references/official-docs/docs/capability-seams.i18n.yaml +9 -5
- package/references/official-docs/docs/capability-seams.md +76 -32
- package/references/official-docs/docs/capability-seams.zh.md +76 -32
- package/references/official-docs/docs/config-catalog.i18n.yaml +18 -5
- package/references/official-docs/docs/config-catalog.md +1360 -765
- package/references/official-docs/docs/config-catalog.zh.md +1363 -767
- package/references/official-docs/docs/cookbook/adding-a-package.i18n.yaml +27 -5
- package/references/official-docs/docs/cookbook/adding-a-package.md +56 -3
- package/references/official-docs/docs/cookbook/adding-a-package.zh.md +54 -3
- package/references/official-docs/docs/cookbook/adding-a-remote-api.i18n.yaml +24 -5
- package/references/official-docs/docs/cookbook/adding-a-remote-api.md +2 -2
- package/references/official-docs/docs/cookbook/adding-a-remote-api.zh.md +2 -2
- package/references/official-docs/docs/cookbook/adding-a-session-format-version.i18n.yaml +39 -5
- package/references/official-docs/docs/cookbook/adding-a-session-format-version.md +46 -6
- package/references/official-docs/docs/cookbook/adding-a-session-format-version.zh.md +46 -6
- package/references/official-docs/docs/cookbook/adding-a-settings-card.i18n.yaml +21 -5
- package/references/official-docs/docs/cookbook/adding-a-settings-card.md +34 -64
- package/references/official-docs/docs/cookbook/adding-a-settings-card.zh.md +34 -64
- package/references/official-docs/docs/cookbook/adding-a-tool.i18n.yaml +30 -5
- package/references/official-docs/docs/cookbook/adding-a-tool.md +2 -2
- package/references/official-docs/docs/cookbook/adding-a-tool.zh.md +2 -2
- package/references/official-docs/docs/cookbook/adding-a-vendored-package.i18n.yaml +18 -5
- package/references/official-docs/docs/cookbook/adding-an-llm-adapter.i18n.yaml +18 -5
- package/references/official-docs/docs/cookbook/extension-cookbook.i18n.yaml +24 -5
- package/references/official-docs/docs/cookbook/extension-cookbook.md +3 -3
- package/references/official-docs/docs/cookbook/extension-cookbook.zh.md +3 -3
- package/references/official-docs/docs/cookbook/maintaining-dsh-code-review.i18n.yaml +21 -5
- package/references/official-docs/docs/cookbook/responding-to-pr-review-on-a-stack.i18n.yaml +15 -5
- package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.i18n.yaml +30 -5
- package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.md +13 -1
- package/references/official-docs/docs/cookbook/reviewing-persistence-type-changes.zh.md +13 -1
- package/references/official-docs/docs/cordis-api/context.i18n.yaml +72 -5
- package/references/official-docs/docs/cordis-api/events.i18n.yaml +36 -5
- package/references/official-docs/docs/cordis-api/fiber.i18n.yaml +75 -5
- package/references/official-docs/docs/cordis-api/inherited.md +15 -13
- package/references/official-docs/docs/cordis-api/registry.i18n.yaml +21 -5
- package/references/official-docs/docs/cordis-api/service.i18n.yaml +36 -5
- package/references/official-docs/docs/cordis-primer.i18n.yaml +21 -5
- package/references/official-docs/docs/cordis-tutorial/01-first-plugin.i18n.yaml +21 -5
- package/references/official-docs/docs/cordis-tutorial/02-lifecycle-and-effects.i18n.yaml +15 -5
- package/references/official-docs/docs/cordis-tutorial/03-services.i18n.yaml +21 -5
- package/references/official-docs/docs/cordis-tutorial/04-events.i18n.yaml +15 -5
- package/references/official-docs/docs/cordis-tutorial/05-config.i18n.yaml +18 -5
- package/references/official-docs/docs/cordis-tutorial/05-config.md +27 -0
- package/references/official-docs/docs/cordis-tutorial/05-config.zh.md +27 -0
- package/references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.i18n.yaml +15 -5
- package/references/official-docs/docs/cordis-tutorial/07-into-the-harness.i18n.yaml +18 -5
- package/references/official-docs/docs/cordis-tutorial/index.i18n.yaml +15 -5
- package/references/official-docs/docs/deepseek-llm-api-wire-extensions.i18n.yaml +33 -5
- package/references/official-docs/docs/deepseek-llm-api-wire-extensions.md +7 -7
- package/references/official-docs/docs/deepseek-llm-api-wire-extensions.zh.md +7 -7
- package/references/official-docs/docs/defensive-patterns.i18n.yaml +27 -5
- package/references/official-docs/docs/dependency-catalog.json +2 -2
- package/references/official-docs/docs/development.i18n.yaml +48 -5
- package/references/official-docs/docs/development.md +27 -10
- package/references/official-docs/docs/development.zh.md +27 -10
- package/references/official-docs/docs/event-producer-consumer.i18n.yaml +12 -5
- package/references/official-docs/docs/event-producer-consumer.md +78 -66
- package/references/official-docs/docs/event-producer-consumer.zh.md +78 -66
- package/references/official-docs/docs/glossary.i18n.yaml +24 -5
- package/references/official-docs/docs/graph-atlas.i18n.yaml +9 -5
- package/references/official-docs/docs/i18n/README.i18n.yaml +18 -5
- package/references/official-docs/docs/i18n/README.md +12 -8
- package/references/official-docs/docs/i18n/README.zh.md +12 -8
- package/references/official-docs/docs/i18n/terminology.md +4 -4
- package/references/official-docs/docs/i18n/translation-prompt.md +2 -2
- package/references/official-docs/docs/i18n/translation-rules.i18n.yaml +27 -5
- package/references/official-docs/docs/module-graph.i18n.yaml +9 -5
- package/references/official-docs/docs/module-graph.md +348 -245
- package/references/official-docs/docs/module-graph.zh.md +348 -245
- package/references/official-docs/docs/persistence-catalog.i18n.yaml +2064 -5
- package/references/official-docs/docs/persistence-catalog.md +5275 -3205
- package/references/official-docs/docs/persistence-catalog.zh.md +5275 -3205
- package/references/official-docs/docs/persistence-changes/2026-09-11-initial.i18n.yaml +27 -5
- package/references/official-docs/docs/persistence-changes/2026-09-12-auto-review-error-metadata.i18n.yaml +27 -5
- package/references/official-docs/docs/persistence-changes/2026-09-14-image-offload.i18n.yaml +27 -5
- package/references/official-docs/docs/persistence-changes/2026-09-14-workspace-changes-event.i18n.yaml +27 -5
- package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.i18n.yaml +28 -0
- package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.md +120 -0
- package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.schema.json +16212 -0
- package/references/official-docs/docs/persistence-changes/2026-09-16-session-format-v4.zh.md +120 -0
- package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.i18n.yaml +28 -0
- package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.md +48 -0
- package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.schema.json +302 -0
- package/references/official-docs/docs/persistence-changes/2026-09-18-schedule-optional-title.zh.md +48 -0
- package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.i18n.yaml +28 -0
- package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.md +48 -0
- package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.schema.json +250 -0
- package/references/official-docs/docs/persistence-changes/2026-09-20-unknown-child-catalog.zh.md +48 -0
- package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.i18n.yaml +28 -0
- package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.md +60 -0
- package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.schema.json +11405 -0
- package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.zh.md +60 -0
- package/references/official-docs/docs/persistence-changes/README.i18n.yaml +27 -5
- package/references/official-docs/docs/persistence-changes/README.md +17 -3
- package/references/official-docs/docs/persistence-changes/README.zh.md +17 -3
- package/references/official-docs/docs/persistence-changes/finalized/v4.json +379 -0
- package/references/official-docs/docs/persistence-changes/historical-formats/README.i18n.yaml +27 -5
- package/references/official-docs/docs/persistence-changes/historical-formats/README.md +3 -2
- package/references/official-docs/docs/persistence-changes/historical-formats/README.zh.md +3 -2
- package/references/official-docs/docs/persistence-changes/historical-formats/v0.i18n.yaml +1284 -5
- package/references/official-docs/docs/persistence-changes/historical-formats/v1.i18n.yaml +1284 -5
- package/references/official-docs/docs/persistence-changes/historical-formats/v2.i18n.yaml +1344 -5
- package/references/official-docs/docs/persistence-changes/historical-formats/v3.i18n.yaml +1441 -0
- package/references/official-docs/docs/persistence-changes/historical-formats/v3.md +5634 -0
- package/references/official-docs/docs/persistence-changes/historical-formats/v3.schema.json +61307 -0
- package/references/official-docs/docs/persistence-changes/historical-formats/v3.zh.md +5634 -0
- package/references/official-docs/docs/persistence-changes/releases/README.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.3.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.4.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.0.1-rc.5.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.3.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.5.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.6.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.7.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.3.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.4.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-alpha.5.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.2-rc.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.3-alpha.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-alpha.2.schema.json +3 -3
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.i18n.yaml +30 -5
- package/references/official-docs/docs/persistence-schema.json +12692 -48753
- package/references/official-docs/docs/postmortem/0001-acp-default-export-drops-inject.i18n.yaml +33 -5
- package/references/official-docs/docs/postmortem/0002-js-expression-disabled-filesystem-tools.i18n.yaml +27 -5
- package/references/official-docs/docs/postmortem/0003-web-agent-gui-feedback-loop.i18n.yaml +27 -5
- package/references/official-docs/docs/postmortem/0004-landlock-partial-notice-misclassified-child-failures.i18n.yaml +27 -5
- package/references/official-docs/docs/postmortem/README.i18n.yaml +6 -5
- package/references/official-docs/docs/rescope.i18n.yaml +18 -5
- package/references/official-docs/docs/rescope.md +1 -1
- package/references/official-docs/docs/rescope.zh.md +1 -1
- package/references/official-docs/docs/session-format-status.i18n.yaml +27 -5
- package/references/official-docs/docs/session-format-status.md +17 -3
- package/references/official-docs/docs/session-format-status.zh.md +17 -3
- package/references/official-docs/docs/subsystems/README.i18n.yaml +6 -5
- package/references/official-docs/docs/subsystems/README.md +6 -3
- package/references/official-docs/docs/subsystems/README.zh.md +6 -3
- package/references/official-docs/docs/subsystems/agent-team.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/agent-team.md +52 -28
- package/references/official-docs/docs/subsystems/agent-team.zh.md +52 -28
- package/references/official-docs/docs/subsystems/approval.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/approval.md +1 -1
- package/references/official-docs/docs/subsystems/approval.zh.md +1 -1
- package/references/official-docs/docs/subsystems/attachment.i18n.yaml +12 -5
- package/references/official-docs/docs/subsystems/attachment.md +2 -2
- package/references/official-docs/docs/subsystems/attachment.zh.md +2 -2
- package/references/official-docs/docs/subsystems/boot.i18n.yaml +9 -5
- package/references/official-docs/docs/subsystems/boot.md +117 -17
- package/references/official-docs/docs/subsystems/boot.zh.md +117 -17
- package/references/official-docs/docs/subsystems/browser-use.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/claude-code-mods.i18n.yaml +28 -0
- package/references/official-docs/docs/subsystems/claude-code-mods.md +146 -0
- package/references/official-docs/docs/subsystems/claude-code-mods.zh.md +146 -0
- package/references/official-docs/docs/subsystems/client-modules.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/client-modules.md +13 -7
- package/references/official-docs/docs/subsystems/client-modules.zh.md +13 -7
- package/references/official-docs/docs/subsystems/client-resources.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/commands.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/commands.md +1 -1
- package/references/official-docs/docs/subsystems/commands.zh.md +1 -1
- package/references/official-docs/docs/subsystems/compaction.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/compaction.md +2 -2
- package/references/official-docs/docs/subsystems/compaction.zh.md +2 -2
- package/references/official-docs/docs/subsystems/computer-use.i18n.yaml +15 -5
- package/references/official-docs/docs/subsystems/conversation.i18n.yaml +30 -5
- package/references/official-docs/docs/subsystems/conversation.md +35 -6
- package/references/official-docs/docs/subsystems/conversation.zh.md +34 -5
- package/references/official-docs/docs/subsystems/core.i18n.yaml +36 -5
- package/references/official-docs/docs/subsystems/core.md +70 -214
- package/references/official-docs/docs/subsystems/core.zh.md +70 -214
- package/references/official-docs/docs/subsystems/credentials.i18n.yaml +24 -5
- package/references/official-docs/docs/subsystems/credentials.md +168 -5
- package/references/official-docs/docs/subsystems/credentials.zh.md +168 -5
- package/references/official-docs/docs/subsystems/deliverables.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/extensions.i18n.yaml +6 -5
- package/references/official-docs/docs/subsystems/extensions.md +6 -4
- package/references/official-docs/docs/subsystems/extensions.zh.md +6 -4
- package/references/official-docs/docs/subsystems/feedback.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/filesystem.i18n.yaml +33 -5
- package/references/official-docs/docs/subsystems/filesystem.md +10 -0
- package/references/official-docs/docs/subsystems/filesystem.zh.md +10 -0
- package/references/official-docs/docs/subsystems/goal.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/goal.md +1 -1
- package/references/official-docs/docs/subsystems/goal.zh.md +1 -1
- package/references/official-docs/docs/subsystems/jobs.i18n.yaml +24 -5
- package/references/official-docs/docs/subsystems/jobs.md +335 -126
- package/references/official-docs/docs/subsystems/jobs.zh.md +335 -126
- package/references/official-docs/docs/subsystems/llm-streaming.i18n.yaml +48 -5
- package/references/official-docs/docs/subsystems/llm-streaming.md +60 -31
- package/references/official-docs/docs/subsystems/llm-streaming.zh.md +60 -31
- package/references/official-docs/docs/subsystems/lsp.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/mcp.i18n.yaml +33 -5
- package/references/official-docs/docs/subsystems/mcp.md +2 -2
- package/references/official-docs/docs/subsystems/mcp.zh.md +2 -2
- package/references/official-docs/docs/subsystems/office-to-pdf.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/office-to-pdf.md +4 -4
- package/references/official-docs/docs/subsystems/office-to-pdf.zh.md +4 -4
- package/references/official-docs/docs/subsystems/otel.i18n.yaml +7 -0
- package/references/official-docs/docs/subsystems/otel.md +44 -0
- package/references/official-docs/docs/subsystems/otel.zh.md +44 -0
- package/references/official-docs/docs/subsystems/permission-presets.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/permission-presets.md +7 -6
- package/references/official-docs/docs/subsystems/permission-presets.zh.md +7 -6
- package/references/official-docs/docs/subsystems/persistence.i18n.yaml +36 -5
- package/references/official-docs/docs/subsystems/persistence.md +3 -3
- package/references/official-docs/docs/subsystems/persistence.zh.md +3 -3
- package/references/official-docs/docs/subsystems/plan.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/plan.md +1 -1
- package/references/official-docs/docs/subsystems/plan.zh.md +1 -1
- package/references/official-docs/docs/subsystems/product-telemetry.i18n.yaml +10 -0
- package/references/official-docs/docs/subsystems/product-telemetry.md +79 -0
- package/references/official-docs/docs/subsystems/product-telemetry.zh.md +79 -0
- package/references/official-docs/docs/subsystems/ptc-runtime.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/sandbox.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/sandbox.md +1 -1
- package/references/official-docs/docs/subsystems/sandbox.zh.md +1 -1
- package/references/official-docs/docs/subsystems/schedule.i18n.yaml +39 -5
- package/references/official-docs/docs/subsystems/schedule.md +391 -33
- package/references/official-docs/docs/subsystems/schedule.zh.md +391 -33
- package/references/official-docs/docs/subsystems/scope.i18n.yaml +15 -5
- package/references/official-docs/docs/subsystems/scope.md +1 -1
- package/references/official-docs/docs/subsystems/scope.zh.md +1 -1
- package/references/official-docs/docs/subsystems/session-projection.i18n.yaml +15 -5
- package/references/official-docs/docs/subsystems/session-projection.md +20 -18
- package/references/official-docs/docs/subsystems/session-projection.zh.md +20 -18
- package/references/official-docs/docs/subsystems/session-query.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/session-reference.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/session-telemetry.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/session-telemetry.md +6 -4
- package/references/official-docs/docs/subsystems/session-telemetry.zh.md +6 -4
- package/references/official-docs/docs/subsystems/session-title.i18n.yaml +15 -5
- package/references/official-docs/docs/subsystems/session.i18n.yaml +66 -5
- package/references/official-docs/docs/subsystems/session.md +113 -62
- package/references/official-docs/docs/subsystems/session.zh.md +113 -62
- package/references/official-docs/docs/subsystems/settings.i18n.yaml +12 -5
- package/references/official-docs/docs/subsystems/settings.md +42 -292
- package/references/official-docs/docs/subsystems/settings.zh.md +42 -292
- package/references/official-docs/docs/subsystems/shell.i18n.yaml +24 -5
- package/references/official-docs/docs/subsystems/shell.md +29 -22
- package/references/official-docs/docs/subsystems/shell.zh.md +29 -22
- package/references/official-docs/docs/subsystems/sidebar-right.i18n.yaml +36 -5
- package/references/official-docs/docs/subsystems/sidebar-right.md +14 -9
- package/references/official-docs/docs/subsystems/sidebar-right.zh.md +14 -9
- package/references/official-docs/docs/subsystems/skills.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/skills.md +2 -2
- package/references/official-docs/docs/subsystems/skills.zh.md +2 -2
- package/references/official-docs/docs/subsystems/slots.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/slots.md +21 -7
- package/references/official-docs/docs/subsystems/slots.zh.md +21 -7
- package/references/official-docs/docs/subsystems/spill.i18n.yaml +15 -5
- package/references/official-docs/docs/subsystems/spill.md +1 -1
- package/references/official-docs/docs/subsystems/spill.zh.md +1 -1
- package/references/official-docs/docs/subsystems/ssh.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/storage.i18n.yaml +24 -5
- package/references/official-docs/docs/subsystems/storage.md +1 -2
- package/references/official-docs/docs/subsystems/storage.zh.md +1 -2
- package/references/official-docs/docs/subsystems/subagent.i18n.yaml +30 -5
- package/references/official-docs/docs/subsystems/subagent.md +35 -60
- package/references/official-docs/docs/subsystems/subagent.zh.md +35 -60
- package/references/official-docs/docs/subsystems/subprocess.i18n.yaml +30 -5
- package/references/official-docs/docs/subsystems/system-prompt.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/terminal.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/todo.i18n.yaml +12 -5
- package/references/official-docs/docs/subsystems/todo.md +3 -3
- package/references/official-docs/docs/subsystems/todo.zh.md +3 -3
- package/references/official-docs/docs/subsystems/token-meter.i18n.yaml +12 -5
- package/references/official-docs/docs/subsystems/tools.i18n.yaml +24 -5
- package/references/official-docs/docs/subsystems/tools.md +15 -4
- package/references/official-docs/docs/subsystems/tools.zh.md +15 -4
- package/references/official-docs/docs/subsystems/typert.i18n.yaml +21 -5
- package/references/official-docs/docs/subsystems/typert.md +147 -6
- package/references/official-docs/docs/subsystems/typert.zh.md +147 -6
- package/references/official-docs/docs/subsystems/user-questions.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/user-questions.md +128 -1
- package/references/official-docs/docs/subsystems/user-questions.zh.md +129 -2
- package/references/official-docs/docs/subsystems/voice-input.i18n.yaml +19 -0
- package/references/official-docs/docs/subsystems/voice-input.md +164 -0
- package/references/official-docs/docs/subsystems/voice-input.zh.md +164 -0
- package/references/official-docs/docs/subsystems/web-client.i18n.yaml +36 -5
- package/references/official-docs/docs/subsystems/web-client.md +10 -5
- package/references/official-docs/docs/subsystems/web-client.zh.md +10 -5
- package/references/official-docs/docs/subsystems/web-server.i18n.yaml +15 -5
- package/references/official-docs/docs/subsystems/web-server.md +12 -4
- package/references/official-docs/docs/subsystems/web-server.zh.md +12 -4
- package/references/official-docs/docs/subsystems/web.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/webhook.i18n.yaml +18 -5
- package/references/official-docs/docs/subsystems/webhook.md +1 -1
- package/references/official-docs/docs/subsystems/webhook.zh.md +1 -1
- package/references/official-docs/docs/subsystems/workflow.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/workflow.md +2 -2
- package/references/official-docs/docs/subsystems/workflow.zh.md +2 -2
- package/references/official-docs/docs/subsystems/workspace.i18n.yaml +27 -5
- package/references/official-docs/docs/subsystems/workspace.md +175 -35
- package/references/official-docs/docs/subsystems/workspace.zh.md +175 -35
- package/references/official-docs/docs/testing.i18n.yaml +33 -5
- package/references/official-docs/docs/testing.md +2 -2
- package/references/official-docs/docs/testing.zh.md +2 -2
- package/references/official-docs/docs/tool-catalog.i18n.yaml +312 -5
- package/references/official-docs/docs/tool-catalog.md +321 -92
- package/references/official-docs/docs/tool-catalog.zh.md +321 -92
- package/references/official-docs/docs/tool-execution-pipeline.i18n.yaml +9 -5
- package/references/official-docs/docs/tool-execution-pipeline.md +6 -3
- package/references/official-docs/docs/tool-execution-pipeline.zh.md +6 -3
- package/references/official-docs/docs/ui-radius.i18n.yaml +31 -0
- package/references/official-docs/docs/ui-radius.md +115 -0
- package/references/official-docs/docs/ui-radius.zh.md +115 -0
- package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/schedule-optional-bundle/guide.i18n.yaml +16 -0
- package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/schedule-optional-bundle/guide.md +22 -0
- package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/schedule-optional-bundle/guide.zh.md +22 -0
- package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/transcript-view-legacy-normal/guide.i18n.yaml +16 -0
- package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/transcript-view-legacy-normal/guide.md +25 -0
- package/references/official-docs/docs/upgrade-guide/v0.1.7-rc.2/transcript-view-legacy-normal/guide.zh.md +25 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/account-sign-in-errors/guide.i18n.yaml +16 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/account-sign-in-errors/guide.md +18 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/account-sign-in-errors/guide.zh.md +18 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/remove-runtime-invariants/guide.i18n.yaml +16 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/remove-runtime-invariants/guide.md +23 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/remove-runtime-invariants/guide.zh.md +23 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.i18n.yaml +16 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.md +22 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/schedule-bundle-retired/guide.zh.md +22 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.i18n.yaml +16 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.md +27 -0
- package/references/official-docs/docs/upgrade-guide/v0.2.0-rc.2/subpath-plugin-display-manifest/guide.zh.md +27 -0
- package/references/official-docs/docs/user/develop/basic/config.i18n.yaml +27 -5
- package/references/official-docs/docs/user/develop/basic/index.i18n.yaml +36 -5
- package/references/official-docs/docs/user/develop/basic/publish.i18n.yaml +30 -5
- package/references/official-docs/docs/user/develop/basic/publish.md +7 -1
- package/references/official-docs/docs/user/develop/basic/publish.zh.md +7 -1
- package/references/official-docs/docs/user/develop/basic/tool.i18n.yaml +15 -5
- package/references/official-docs/docs/user/develop/framework/events.i18n.yaml +45 -5
- package/references/official-docs/docs/user/develop/framework/index.i18n.yaml +30 -5
- package/references/official-docs/docs/user/develop/framework/service.i18n.yaml +39 -5
- package/references/official-docs/docs/user/develop/practice/dynamic-cordis.i18n.yaml +9 -5
- package/references/official-docs/docs/user/develop/practice/index.i18n.yaml +45 -5
- package/references/official-docs/docs/user/develop/practice/llm-adapter.i18n.yaml +33 -5
- package/references/official-docs/docs/user/develop/practice/llm-adapter.md +1 -1
- package/references/official-docs/docs/user/develop/practice/llm-adapter.zh.md +1 -1
- package/references/official-docs/docs/user/guide/github-review.i18n.yaml +24 -5
- package/references/official-docs/docs/user/guide/index.i18n.yaml +18 -5
- package/references/official-docs/docs/user/guide/index.md +1 -0
- package/references/official-docs/docs/user/guide/index.zh.md +1 -0
- package/references/official-docs/docs/user/guide/mcp-memory.i18n.yaml +36 -5
- package/references/official-docs/docs/user/guide/network-proxy.i18n.yaml +24 -5
- package/references/official-docs/docs/user/guide/providers-custom-form.png +0 -0
- package/references/official-docs/docs/user/guide/providers-custom-form.zh.png +0 -0
- package/references/official-docs/docs/user/guide/providers-models-page.png +0 -0
- package/references/official-docs/docs/user/guide/providers-models-page.zh.png +0 -0
- package/references/official-docs/docs/user/guide/providers.i18n.yaml +36 -5
- package/references/official-docs/docs/user/guide/providers.md +88 -78
- package/references/official-docs/docs/user/guide/providers.zh.md +102 -92
- package/references/official-docs/docs/user/guide/public-deployments.i18n.yaml +19 -0
- package/references/official-docs/docs/user/guide/public-deployments.md +33 -0
- package/references/official-docs/docs/user/guide/public-deployments.zh.md +33 -0
- package/references/official-docs/docs/user/guide/python-sdk.i18n.yaml +27 -5
- package/references/official-docs/docs/user/guide/python-sdk.md +1 -1
- package/references/official-docs/docs/user/guide/python-sdk.zh.md +1 -1
- package/references/official-docs/docs/user/guide/schedule.i18n.yaml +30 -5
- package/references/official-docs/docs/user/guide/schedule.md +69 -11
- package/references/official-docs/docs/user/guide/schedule.zh.md +69 -11
- package/references/official-docs/docs/user/index.i18n.yaml +9 -5
- package/references/official-docs/docs/web-styling.i18n.yaml +18 -5
- package/references/official-docs/docs/web-styling.md +12 -3
- package/references/official-docs/docs/web-styling.zh.md +12 -3
- package/references/official-docs/packages/AGENTS.md +1 -2
- package/references/official-docs/packages/README.md +5 -5
- package/references/official-docs/vendor/README.md +6 -2
- package/references/official-docs/website-docs.ts +10 -3
- package/references/official-plugin-dev-skill.md +124 -0
- package/references/sources.md +10 -5
- package/scripts/archive-discussions.ps1 +9 -1
- package/scripts/build-llms-full.mjs +64 -0
- package/scripts/check-docs-drift.ps1 +1 -1
- package/scripts/sync-official-docs.ps1 +1 -1
- package/templates/js/icon.svg +4 -0
- package/templates/js/locale/en.json +6 -0
- package/templates/js/locale/zh.json +6 -0
- package/templates/js/package.json +9 -1
- package/templates/ts/icon.svg +4 -0
- package/templates/ts/locale/en.json +6 -0
- package/templates/ts/locale/zh.json +6 -0
- package/templates/ts/package.json +9 -1
- package/references/official-docs/docs/subsystems/invariants.i18n.yaml +0 -6
- package/references/official-docs/docs/subsystems/invariants.md +0 -88
- package/references/official-docs/docs/subsystems/invariants.zh.md +0 -88
|
@@ -122,20 +122,24 @@ The persisted projection cache service. Opens the `session_projcache` domain at
|
|
|
122
122
|
```ts cordis-catalog
|
|
123
123
|
/**
|
|
124
124
|
* The zero-I/O listing read: whole values viewed straight from the stored
|
|
125
|
-
* rows (version-matching keys only)
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
*
|
|
130
|
-
*
|
|
125
|
+
* rows (version-matching keys only) of the record bound to the caller's
|
|
126
|
+
* lifecycle. The header is the only identity witness a listing holds, so
|
|
127
|
+
* this face matches the lifecycle identity (`formatVersion`, `createdAt`,
|
|
128
|
+
* `cwd`, `isSeeded`) and not the inherited cut: within one format
|
|
129
|
+
* generation the cut is fixed at fork time, so it distinguishes no
|
|
130
|
+
* lifecycle the other fields do not, and a viewed value never seeds a fold.
|
|
131
|
+
* The view is as stale as the last durable checkpoint but never wrong and
|
|
132
|
+
* never from an unrelated log. Its `asOfSeq` is the lowest watermark among
|
|
133
|
+
* the served rows: the stored record's own position, which the header
|
|
134
|
+
* cannot relate to the log the caller later opens. The Session list
|
|
135
|
+
* therefore labels the block as cached, and the client lets every value the
|
|
136
|
+
* connected Session produces supersede it whatever this number says.
|
|
131
137
|
* @param meta - the listed session's header (identity witness; no log read).
|
|
132
|
-
* @param inheritedEventCount - exact inherited prefix length that completes
|
|
133
|
-
* the checkpoint identity.
|
|
134
138
|
* @param keys - optional projection keys required by the caller's audience.
|
|
135
|
-
* @returns the
|
|
136
|
-
*
|
|
139
|
+
* @returns the viewed block, or `undefined` when no usable row exists for
|
|
140
|
+
* this lifecycle at the current Session format.
|
|
137
141
|
*/
|
|
138
|
-
cachedSnapshot( meta: SessionHeader,
|
|
142
|
+
cachedSnapshot( meta: SessionHeader, keys?: readonly Extract<keyof SessionProjectionMap, string>[], ): ProjectionSnapshot | undefined
|
|
139
143
|
|
|
140
144
|
/**
|
|
141
145
|
* Read only a predecessor checkpoint's title as a zero-I/O listing hint.
|
|
@@ -146,15 +150,13 @@ cachedSnapshot( meta: SessionHeader, inheritedEventCount: SessionLogOffset, keys
|
|
|
146
150
|
* fact from this Session. The registry still requires the current title
|
|
147
151
|
* projection's row version and schema. No other predecessor projection is
|
|
148
152
|
* exposed: format normalization can change their current meaning, and the
|
|
149
|
-
*
|
|
153
|
+
* {@link cachedSnapshot} / hydration paths continue to reject them.
|
|
150
154
|
* @param meta - authoritative listed Session header.
|
|
151
|
-
* @
|
|
152
|
-
*
|
|
153
|
-
*
|
|
154
|
-
* with the title unit. The sentinel avoids reusing a sequence that a
|
|
155
|
-
* cardinality-changing Session migration may have remapped.
|
|
155
|
+
* @returns a title-only block at the stored title row's watermark, or
|
|
156
|
+
* `undefined` when the record is current, newer, unrelated, missing, or
|
|
157
|
+
* incompatible with the title unit.
|
|
156
158
|
*/
|
|
157
|
-
cachedPredecessorTitle(
|
|
159
|
+
cachedPredecessorTitle(meta: SessionHeader): ProjectionSnapshot | undefined
|
|
158
160
|
|
|
159
161
|
/**
|
|
160
162
|
* Hydrate projection cells for an already-prepared Session without another
|
|
@@ -122,20 +122,24 @@ The persisted projection cache service. Opens the `session_projcache` domain at
|
|
|
122
122
|
```ts cordis-catalog
|
|
123
123
|
/**
|
|
124
124
|
* The zero-I/O listing read: whole values viewed straight from the stored
|
|
125
|
-
* rows (version-matching keys only)
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
*
|
|
130
|
-
*
|
|
125
|
+
* rows (version-matching keys only) of the record bound to the caller's
|
|
126
|
+
* lifecycle. The header is the only identity witness a listing holds, so
|
|
127
|
+
* this face matches the lifecycle identity (`formatVersion`, `createdAt`,
|
|
128
|
+
* `cwd`, `isSeeded`) and not the inherited cut: within one format
|
|
129
|
+
* generation the cut is fixed at fork time, so it distinguishes no
|
|
130
|
+
* lifecycle the other fields do not, and a viewed value never seeds a fold.
|
|
131
|
+
* The view is as stale as the last durable checkpoint but never wrong and
|
|
132
|
+
* never from an unrelated log. Its `asOfSeq` is the lowest watermark among
|
|
133
|
+
* the served rows: the stored record's own position, which the header
|
|
134
|
+
* cannot relate to the log the caller later opens. The Session list
|
|
135
|
+
* therefore labels the block as cached, and the client lets every value the
|
|
136
|
+
* connected Session produces supersede it whatever this number says.
|
|
131
137
|
* @param meta - the listed session's header (identity witness; no log read).
|
|
132
|
-
* @param inheritedEventCount - exact inherited prefix length that completes
|
|
133
|
-
* the checkpoint identity.
|
|
134
138
|
* @param keys - optional projection keys required by the caller's audience.
|
|
135
|
-
* @returns the
|
|
136
|
-
*
|
|
139
|
+
* @returns the viewed block, or `undefined` when no usable row exists for
|
|
140
|
+
* this lifecycle at the current Session format.
|
|
137
141
|
*/
|
|
138
|
-
cachedSnapshot( meta: SessionHeader,
|
|
142
|
+
cachedSnapshot( meta: SessionHeader, keys?: readonly Extract<keyof SessionProjectionMap, string>[], ): ProjectionSnapshot | undefined
|
|
139
143
|
|
|
140
144
|
/**
|
|
141
145
|
* Read only a predecessor checkpoint's title as a zero-I/O listing hint.
|
|
@@ -146,15 +150,13 @@ cachedSnapshot( meta: SessionHeader, inheritedEventCount: SessionLogOffset, keys
|
|
|
146
150
|
* fact from this Session. The registry still requires the current title
|
|
147
151
|
* projection's row version and schema. No other predecessor projection is
|
|
148
152
|
* exposed: format normalization can change their current meaning, and the
|
|
149
|
-
*
|
|
153
|
+
* {@link cachedSnapshot} / hydration paths continue to reject them.
|
|
150
154
|
* @param meta - authoritative listed Session header.
|
|
151
|
-
* @
|
|
152
|
-
*
|
|
153
|
-
*
|
|
154
|
-
* with the title unit. The sentinel avoids reusing a sequence that a
|
|
155
|
-
* cardinality-changing Session migration may have remapped.
|
|
155
|
+
* @returns a title-only block at the stored title row's watermark, or
|
|
156
|
+
* `undefined` when the record is current, newer, unrelated, missing, or
|
|
157
|
+
* incompatible with the title unit.
|
|
156
158
|
*/
|
|
157
|
-
cachedPredecessorTitle(
|
|
159
|
+
cachedPredecessorTitle(meta: SessionHeader): ProjectionSnapshot | undefined
|
|
158
160
|
|
|
159
161
|
/**
|
|
160
162
|
* Hydrate projection cells for an already-prepared Session without another
|
|
@@ -1,6 +1,28 @@
|
|
|
1
|
-
# Bilingual-pair consistency record (docs/i18n/README.md):
|
|
2
|
-
#
|
|
3
|
-
#
|
|
1
|
+
# Bilingual-pair consistency record for session-query.md (docs/i18n/README.md): per heading
|
|
2
|
+
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
|
|
3
|
+
# After editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write docs/subsystems/session-query.md
|
|
5
|
-
session-query
|
|
6
|
-
|
|
5
|
+
/session-query:
|
|
6
|
+
en: 041684440d88fbbc
|
|
7
|
+
zh: 376e7f0b173b238d
|
|
8
|
+
/session-query/logical-records:
|
|
9
|
+
en: 839a70b2761c16f1
|
|
10
|
+
zh: 883277abce68c750
|
|
11
|
+
/session-query/provider-independent-filters-and-documents:
|
|
12
|
+
en: a1818c567b28613c
|
|
13
|
+
zh: 5dd442cf5ce0438e
|
|
14
|
+
/session-query/full-text-search-pages:
|
|
15
|
+
en: 192dc8ec7f3a9d28
|
|
16
|
+
zh: c18aef45c61610b9
|
|
17
|
+
/session-query/session-lineage:
|
|
18
|
+
en: c4b3e9e77a1b07d8
|
|
19
|
+
zh: e510802ab034ceac
|
|
20
|
+
/session-query/bounded-event-reads:
|
|
21
|
+
en: 2f4a5fa959be3554
|
|
22
|
+
zh: 3590a7f6aeeb7e02
|
|
23
|
+
/session-query/event-relationships:
|
|
24
|
+
en: 2ec376e3a10ee5fa
|
|
25
|
+
zh: 3a7706de112f6e17
|
|
26
|
+
/session-query/errors:
|
|
27
|
+
en: 34e775125232d999
|
|
28
|
+
zh: 0c5c608760c4865d
|
|
@@ -1,6 +1,19 @@
|
|
|
1
|
-
# Bilingual-pair consistency record (docs/i18n/README.md):
|
|
2
|
-
#
|
|
3
|
-
#
|
|
1
|
+
# Bilingual-pair consistency record for session-reference.md (docs/i18n/README.md): per heading
|
|
2
|
+
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
|
|
3
|
+
# After editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write docs/subsystems/session-reference.md
|
|
5
|
-
session-
|
|
6
|
-
|
|
5
|
+
/session-references:
|
|
6
|
+
en: 93adc903a71245f0
|
|
7
|
+
zh: 5222fc148480de3e
|
|
8
|
+
/session-references/file-candidates:
|
|
9
|
+
en: ec03370596bf2322
|
|
10
|
+
zh: 85cf6439dc6484b3
|
|
11
|
+
/session-references/inputs-and-candidates:
|
|
12
|
+
en: f9b6c0e14246cec7
|
|
13
|
+
zh: 4d43ed22592ba306
|
|
14
|
+
/session-references/prepared-messages:
|
|
15
|
+
en: e3e21e0dd9b27a7b
|
|
16
|
+
zh: 9205aaea5a542517
|
|
17
|
+
/session-references/errors:
|
|
18
|
+
en: cc26522ead0db644
|
|
19
|
+
zh: 4feb52922782edbd
|
|
@@ -1,6 +1,22 @@
|
|
|
1
|
-
# Bilingual-pair consistency record (docs/i18n/README.md):
|
|
2
|
-
#
|
|
3
|
-
#
|
|
1
|
+
# Bilingual-pair consistency record for session-telemetry.md (docs/i18n/README.md): per heading
|
|
2
|
+
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
|
|
3
|
+
# After editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write docs/subsystems/session-telemetry.md
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
/sessiontelemetrybackend:
|
|
6
|
+
en: b82e4db22a4d58aa
|
|
7
|
+
zh: 439181fa2c27542d
|
|
8
|
+
/sessiontelemetrybackend/the-logical-record:
|
|
9
|
+
en: 9695489076496a76
|
|
10
|
+
zh: 457c54698bc38c2f
|
|
11
|
+
/sessiontelemetrybackend/the-sharing-disclosure:
|
|
12
|
+
en: d74b6cd7635d230a
|
|
13
|
+
zh: 3beb7dbf28d83aa6
|
|
14
|
+
/sessiontelemetrybackend/capture-policy:
|
|
15
|
+
en: 5a52371437ac4261
|
|
16
|
+
zh: 00fdd38d2e08346e
|
|
17
|
+
/sessiontelemetrybackend/the-backend-contract:
|
|
18
|
+
en: 6d4467aeab2822be
|
|
19
|
+
zh: 6a874e8014c34683
|
|
20
|
+
/sessiontelemetrybackend/the-redact-waterfall-session-telemetry-record:
|
|
21
|
+
en: 15bd0919a8d4cea0
|
|
22
|
+
zh: 1ddaa1e8d84db66b
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
English | [中文](session-telemetry.zh.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
The [capture service](../../packages/session/session-telemetry/README.md) owns canonical-event capture, redaction, and handoff cursors. The [feedback backend](../../packages/session/session-telemetry-otel/README.md) authorizes Session prefixes and owns their independent queue, per-request scheduling, and 4,000,000-byte ceiling. No reporting data reaches model requests.
|
|
6
6
|
|
|
7
7
|
Source: [`packages/session/session-telemetry/src/index.ts`](../../packages/session/session-telemetry/src/index.ts)
|
|
8
8
|
|
|
@@ -12,7 +12,7 @@ Source: [`packages/session/session-telemetry/src/index.ts`](../../packages/sessi
|
|
|
12
12
|
/**
|
|
13
13
|
* Severity of a telemetry record, pre-mapped at capture so a receiver can
|
|
14
14
|
* alert with zero configuration: `error` for events whose own outcome flag
|
|
15
|
-
* says so (the tool
|
|
15
|
+
* says so (the tool message's `isError`, `turn/end` error reasons) and for
|
|
16
16
|
* `agent-error` operational records. Captured events otherwise default to
|
|
17
17
|
* `info`; `warn` remains available to `session-telemetry/record` policies and
|
|
18
18
|
* backends.
|
|
@@ -29,6 +29,8 @@ type SessionTelemetrySeverity = 'info' | 'warn' | 'error'
|
|
|
29
29
|
* identity so they can never be mistaken for ledger rows.
|
|
30
30
|
*/
|
|
31
31
|
interface SessionTelemetryRecord {
|
|
32
|
+
/** Canonical envelope without data; body carries the separately redacted payload. Absent for operational records. */
|
|
33
|
+
sourceEvent?: { sessionId: SessionId; envelope: Omit<SessionEvent, 'data'> }
|
|
32
34
|
/** Ledger (session-log mirror) or ops (operational signal) channel; backends keep the two under separate instrumentation scopes. */
|
|
33
35
|
channel: 'ledger' | 'ops'
|
|
34
36
|
/** Unix epoch milliseconds — the source event's append time for ledger records, the emission time for ops records. */
|
|
@@ -55,7 +57,7 @@ interface SessionTelemetryRecord {
|
|
|
55
57
|
}
|
|
56
58
|
```
|
|
57
59
|
|
|
58
|
-
Every canonical [session event](session.md), including each `assistant/message` or `assistant/attempt` with its complete compact stream and every plugin-merged type the seam never heard of, passes through whole as one ordered ledger record. Process-local `agent/assistant-stream` frames do not enter this durable feed. A new
|
|
60
|
+
Every canonical [session event](session.md), including each `assistant/message` or `assistant/attempt` with its complete compact stream and every plugin-merged type the seam never heard of, passes through whole as one ordered ledger record. Process-local `agent/assistant-stream` frames do not enter this durable feed. A new fork starts at its child-owned suffix, including the inherited marker and fork closers; restored Sessions start after their stored prefix, including restored forks. The backend can select `includeHistory` to include the complete prefix; re-adopting the same object resumes after its handoff cursor. Delivery is best-effort: the cursor marks handed-off, not delivered, and records can be lost (crash, reload window) or duplicated (new-object replay, SDK retries), so receivers dedupe ledger records on `(session.id, session.format_version, event.seq)`; ops records deliberately omit that identity — they are signals to alert on, not entries to sum, and tolerate duplicates instead.
|
|
59
61
|
|
|
60
62
|
## The sharing disclosure
|
|
61
63
|
|
|
@@ -80,7 +82,7 @@ type SessionTelemetryCapture = 'live' | 'on-demand'
|
|
|
80
82
|
interface SessionTelemetryCaptureOptions {
|
|
81
83
|
/** Follow live events, or wait for explicit capture; defaults to live. */
|
|
82
84
|
capture?: SessionTelemetryCapture
|
|
83
|
-
/** Include stored history
|
|
85
|
+
/** Include inherited fork history and stored history from earlier lifecycles; defaults to false. */
|
|
84
86
|
includeHistory?: boolean
|
|
85
87
|
}
|
|
86
88
|
```
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](session-telemetry.md) | 中文
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[捕获服务](../../packages/session/session-telemetry/README.zh.md) 负责规范事件捕获、脱敏和交接游标。[反馈后端](../../packages/session/session-telemetry-otel/README.zh.md) 授权 Session 前缀,并负责独立队列、逐请求调度及 4,000,000 字节上限。上报数据不会进入模型请求。
|
|
6
6
|
|
|
7
7
|
源码:[`packages/session/session-telemetry/src/index.ts`](../../packages/session/session-telemetry/src/index.ts)
|
|
8
8
|
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
/**
|
|
13
13
|
* Severity of a telemetry record, pre-mapped at capture so a receiver can
|
|
14
14
|
* alert with zero configuration: `error` for events whose own outcome flag
|
|
15
|
-
* says so (the tool
|
|
15
|
+
* says so (the tool message's `isError`, `turn/end` error reasons) and for
|
|
16
16
|
* `agent-error` operational records. Captured events otherwise default to
|
|
17
17
|
* `info`; `warn` remains available to `session-telemetry/record` policies and
|
|
18
18
|
* backends.
|
|
@@ -29,6 +29,8 @@ type SessionTelemetrySeverity = 'info' | 'warn' | 'error'
|
|
|
29
29
|
* identity so they can never be mistaken for ledger rows.
|
|
30
30
|
*/
|
|
31
31
|
interface SessionTelemetryRecord {
|
|
32
|
+
/** Canonical envelope without data; body carries the separately redacted payload. Absent for operational records. */
|
|
33
|
+
sourceEvent?: { sessionId: SessionId; envelope: Omit<SessionEvent, 'data'> }
|
|
32
34
|
/** Ledger (session-log mirror) or ops (operational signal) channel; backends keep the two under separate instrumentation scopes. */
|
|
33
35
|
channel: 'ledger' | 'ops'
|
|
34
36
|
/** Unix epoch milliseconds — the source event's append time for ledger records, the emission time for ops records. */
|
|
@@ -55,7 +57,7 @@ interface SessionTelemetryRecord {
|
|
|
55
57
|
}
|
|
56
58
|
```
|
|
57
59
|
|
|
58
|
-
每条权威[会话事件](session.zh.md)都会完整透传为一条有序 ledger 记录,包括每个携带完整紧凑 stream 的 `assistant/message` 或 `assistant/attempt`,以及该 seam 从未听说过、由插件合并进来的类型。进程本地 `agent/assistant-stream` frame 不进入该持久 feed。新 Session
|
|
60
|
+
每条权威[会话事件](session.zh.md)都会完整透传为一条有序 ledger 记录,包括每个携带完整紧凑 stream 的 `assistant/message` 或 `assistant/attempt`,以及该 seam 从未听说过、由插件合并进来的类型。进程本地 `agent/assistant-stream` frame 不进入该持久 feed。新 fork 从子会话自有后缀开始,包括继承标记和 fork 结束事件;恢复的 Session 从已存储前缀之后开始,包括恢复的 fork。后端可以选择 `includeHistory` 来包含完整前缀;重新收养同一对象时会从 handoff 游标之后继续。投递是尽力而为的:游标标记的是「已交接」而非「已送达」,记录可能丢失(崩溃、重载窗口)也可能重复(新对象回放、SDK 重试),因此接收端对 ledger 记录基于 `(session.id, session.format_version, event.seq)` 去重;ops 记录刻意省略这类标识——它们是用于告警的信号,而非用于累加的条目,重复被容忍而非被去重。
|
|
59
61
|
|
|
60
62
|
## 共享披露
|
|
61
63
|
|
|
@@ -80,7 +82,7 @@ type SessionTelemetryCapture = 'live' | 'on-demand'
|
|
|
80
82
|
interface SessionTelemetryCaptureOptions {
|
|
81
83
|
/** Follow live events, or wait for explicit capture; defaults to live. */
|
|
82
84
|
capture?: SessionTelemetryCapture
|
|
83
|
-
/** Include stored history
|
|
85
|
+
/** Include inherited fork history and stored history from earlier lifecycles; defaults to false. */
|
|
84
86
|
includeHistory?: boolean
|
|
85
87
|
}
|
|
86
88
|
```
|
|
@@ -1,6 +1,16 @@
|
|
|
1
|
-
# Bilingual-pair consistency record (docs/i18n/README.md):
|
|
2
|
-
#
|
|
3
|
-
#
|
|
1
|
+
# Bilingual-pair consistency record for session-title.md (docs/i18n/README.md): per heading
|
|
2
|
+
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
|
|
3
|
+
# After editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write docs/subsystems/session-title.md
|
|
5
|
-
session-
|
|
6
|
-
|
|
5
|
+
/session-titles:
|
|
6
|
+
en: a0ad8d5f000e5258
|
|
7
|
+
zh: 9527bc25711342de
|
|
8
|
+
/session-titles/durable-title-state:
|
|
9
|
+
en: c6be2d86647daa6f
|
|
10
|
+
zh: fb259d9fb4738f39
|
|
11
|
+
/session-titles/auxiliary-request-record:
|
|
12
|
+
en: 4942bec7a7d1d9de
|
|
13
|
+
zh: 9edfc1c908577c37
|
|
14
|
+
/session-titles/provider-input-and-output:
|
|
15
|
+
en: 886e036e442ae06a
|
|
16
|
+
zh: 49f95782b8aa9bf3
|
|
@@ -1,6 +1,67 @@
|
|
|
1
|
-
# Bilingual-pair consistency record (docs/i18n/README.md):
|
|
2
|
-
#
|
|
3
|
-
#
|
|
1
|
+
# Bilingual-pair consistency record for session.md (docs/i18n/README.md): per heading
|
|
2
|
+
# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
|
|
3
|
+
# After editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write docs/subsystems/session.md
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
/sessions:
|
|
6
|
+
en: 28fb7eb8f758fdf0
|
|
7
|
+
zh: a36d6f03e331ad86
|
|
8
|
+
/sessions/sessioneventmap-the-event-vocabulary:
|
|
9
|
+
en: 541354f6468e117d
|
|
10
|
+
zh: 2d7a665bad828a02
|
|
11
|
+
/sessions/sessioneventmap-the-event-vocabulary/the-request-header-event-request-header:
|
|
12
|
+
en: 6eb931fcb2f4ab8d
|
|
13
|
+
zh: d822a83384cc1fee
|
|
14
|
+
/sessions/sessioneventmap-the-event-vocabulary/the-route-capacity-event-request-context:
|
|
15
|
+
en: 7e21ea8bcdb16b7a
|
|
16
|
+
zh: a377774d3596dbeb
|
|
17
|
+
/sessions/sessionevent-t-one-log-entry:
|
|
18
|
+
en: 622d333d9d903795
|
|
19
|
+
zh: fdc9ee663330f01e
|
|
20
|
+
/sessions/surface-types:
|
|
21
|
+
en: 55fa7be0643afc08
|
|
22
|
+
zh: 0bc544886c68cdb3
|
|
23
|
+
/sessions/surface-types/surfaceeventtype-the-message-producing-subset-of-event-types:
|
|
24
|
+
en: 2f1b6a16a4ee7cc1
|
|
25
|
+
zh: 7f16b568c4aa940f
|
|
26
|
+
/sessions/surface-types/surfaceop-how-an-event-entered-the-surface:
|
|
27
|
+
en: 8fcc967516a13692
|
|
28
|
+
zh: d3978d3b8d02c566
|
|
29
|
+
/sessions/surface-types/surfaceintent-the-parameter-to-session-append:
|
|
30
|
+
en: c65cc976acad9005
|
|
31
|
+
zh: 3efd10779881cba5
|
|
32
|
+
/sessions/surface-types/plugin-owned-message-projections:
|
|
33
|
+
en: f1f73607d650620f
|
|
34
|
+
zh: b3ef72f19fb5ee3d
|
|
35
|
+
/sessions/surface-types/sessionsurface-the-live-readonly-surface-projection:
|
|
36
|
+
en: 350259099d8d60c9
|
|
37
|
+
zh: 7b25db461748c04e
|
|
38
|
+
/sessions/surface-types/surfacefoldreplacement-and-surfacefoldresult-a-complete-surface-replay:
|
|
39
|
+
en: 13820e0611b2e141
|
|
40
|
+
zh: 2aafb1e5e3dc42f6
|
|
41
|
+
/sessions/session-public-api:
|
|
42
|
+
en: 04e9982948d9560d
|
|
43
|
+
zh: 221961cadebc6fb1
|
|
44
|
+
/sessions/derived-history-derivemessages-and-deriveeventmessage:
|
|
45
|
+
en: 45d1a9ee6d610ac5
|
|
46
|
+
zh: 79c061252fde4ceb
|
|
47
|
+
/sessions/live-session-fork-api:
|
|
48
|
+
en: c72c73ce4b4c697c
|
|
49
|
+
zh: 8a34785a92df0ad5
|
|
50
|
+
/sessions/why-a-turn-ended-turnendreasonmap:
|
|
51
|
+
en: 966cc60273fb3911
|
|
52
|
+
zh: de5123ea9dbb0df2
|
|
53
|
+
/sessions/execution-enclosure-and-standalone-events:
|
|
54
|
+
en: 9091c5446e8cb9a2
|
|
55
|
+
zh: 04c8c4fd5d0eaefc
|
|
56
|
+
/sessions/the-end-seed-boundary-session-end-seed:
|
|
57
|
+
en: 63b4059793255ca3
|
|
58
|
+
zh: 6bc7891c320249f4
|
|
59
|
+
/sessions/plugin-contributed-log-only-events:
|
|
60
|
+
en: 0a014a755b75449f
|
|
61
|
+
zh: 9d59d74490a1bcb2
|
|
62
|
+
/sessions/durability-contract:
|
|
63
|
+
en: 62e3e4fbcba292a3
|
|
64
|
+
zh: cb6dcaf531621e85
|
|
65
|
+
/sessions/remote-catalog-and-workspace-opening:
|
|
66
|
+
en: dd27307e0d7c893c
|
|
67
|
+
zh: b77d2a749b7b641c
|