@octopi-agent/engine 0.65.0 → 0.86.38
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/LICENSE +201 -201
- package/NOTICE +7 -7
- package/README.md +64 -26
- package/dist/config-schema/agent.d.ts +89 -1
- package/dist/config-schema/agent.js +69 -0
- package/dist/config-schema/context.d.ts +23 -4
- package/dist/config-schema/context.js +28 -1
- package/dist/config-schema/engine.d.ts +285 -9
- package/dist/config-schema/engine.js +35 -3
- package/dist/config-schema/governance.d.ts +95 -0
- package/dist/config-schema/governance.js +91 -0
- package/dist/config-schema/models.d.ts +1 -1
- package/dist/config-schema/observability.d.ts +6 -0
- package/dist/config-schema/observability.js +16 -0
- package/dist/config-schema/run.d.ts +10 -0
- package/dist/config-schema/run.js +18 -0
- package/dist/config-schema/shared.d.ts +10 -0
- package/dist/config-schema/shared.js +10 -0
- package/dist/config-schema/substrate.d.ts +87 -1
- package/dist/config-schema/substrate.js +114 -0
- package/dist/config-schema/subsystems.d.ts +1 -1
- package/dist/config-schema/subsystems.js +2 -1
- package/dist/config.d.ts +249 -7
- package/dist/config.js +113 -3
- package/dist/harness/activation/compiler.js +3 -0
- package/dist/harness/activation/runtime.d.ts +7 -0
- package/dist/harness/activation/runtime.js +60 -2
- package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
- package/dist/harness/activation/sources/agent-signal.js +33 -0
- package/dist/harness/activation/types.d.ts +6 -1
- package/dist/harness/agent/builder.d.ts +48 -4
- package/dist/harness/agent/builder.js +206 -55
- package/dist/harness/agent/config-bridge.d.ts +33 -25
- package/dist/harness/agent/config-bridge.js +83 -280
- package/dist/harness/agent/index.d.ts +3 -1
- package/dist/harness/agent/index.js +2 -1
- package/dist/harness/agent/tool-purpose.d.ts +38 -0
- package/dist/harness/agent/tool-purpose.js +118 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
- package/dist/harness/agent/wire-agent-builder.js +363 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
- package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
- package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
- package/dist/harness/collaboration/delegation/child-run.js +241 -0
- package/dist/harness/collaboration/delegation/index.d.ts +26 -0
- package/dist/harness/collaboration/delegation/index.js +25 -0
- package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
- package/dist/harness/collaboration/delegation/notifier.js +84 -0
- package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
- package/dist/harness/collaboration/delegation/registry-types.js +61 -0
- package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
- package/dist/harness/collaboration/delegation/registry.js +220 -0
- package/dist/harness/collaboration/delegation/service.d.ts +249 -0
- package/dist/harness/collaboration/delegation/service.js +499 -0
- package/dist/harness/collaboration/delegation/store.d.ts +155 -0
- package/dist/harness/collaboration/delegation/store.js +271 -0
- package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
- package/dist/harness/collaboration/delegation/transport.js +61 -0
- package/dist/harness/collaboration/delegation/types.d.ts +231 -0
- package/dist/harness/collaboration/delegation/types.js +70 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
- package/dist/harness/collaboration/delegation/wiring.js +145 -0
- package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
- package/dist/harness/collaboration/orchestration/index.js +11 -11
- package/dist/harness/context/assembler.d.ts +2 -2
- package/dist/harness/context/assembler.js +12 -7
- package/dist/harness/context/capabilities/compact/engine.js +80 -38
- package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
- package/dist/harness/context/capabilities/summary/gate.js +2 -2
- package/dist/harness/context/capabilities/summary/policies.js +5 -5
- package/dist/harness/context/capabilities/summary/registry.js +39 -24
- package/dist/harness/context/constitution/default-agents.md +230 -228
- package/dist/harness/context/default-context-engine.d.ts +101 -23
- package/dist/harness/context/default-context-engine.js +483 -172
- package/dist/harness/context/hybrid-compressor.d.ts +3 -3
- package/dist/harness/context/hybrid-compressor.js +18 -23
- package/dist/harness/context/index.d.ts +5 -1
- package/dist/harness/context/index.js +2 -0
- package/dist/harness/context/layer-health.js +3 -2
- package/dist/harness/context/layer-snapshot.d.ts +4 -0
- package/dist/harness/context/layer-snapshot.js +30 -18
- package/dist/harness/context/layer-types.d.ts +49 -1
- package/dist/harness/context/layer-types.js +72 -4
- package/dist/harness/context/layers.d.ts +32 -15
- package/dist/harness/context/layers.js +87 -71
- package/dist/harness/context/llm-summarizer.d.ts +15 -1
- package/dist/harness/context/llm-summarizer.js +107 -56
- package/dist/harness/context/message-selector.js +6 -2
- package/dist/harness/context/root-instructions.d.ts +72 -0
- package/dist/harness/context/root-instructions.js +227 -0
- package/dist/harness/context/runtime-datetime.d.ts +34 -7
- package/dist/harness/context/runtime-datetime.js +66 -10
- package/dist/harness/context/smart-router.d.ts +1 -1
- package/dist/harness/context/smart-router.js +1 -1
- package/dist/harness/context/system-prompt-assembler.d.ts +33 -0
- package/dist/harness/context/system-prompt-assembler.js +78 -7
- package/dist/harness/context/token-constants.d.ts +2 -2
- package/dist/harness/context/token-constants.js +2 -2
- package/dist/harness/context/token-estimate-fns.d.ts +1 -3
- package/dist/harness/context/token-estimate-fns.js +2 -4
- package/dist/harness/context/token-estimator.d.ts +1 -1
- package/dist/harness/context/token-estimator.js +14 -6
- package/dist/harness/context/tool-result-aging.d.ts +140 -0
- package/dist/harness/context/tool-result-aging.js +331 -0
- package/dist/harness/context/tool-result-body.d.ts +10 -0
- package/dist/harness/context/tool-result-body.js +27 -0
- package/dist/harness/context/turn-envelope.d.ts +123 -0
- package/dist/harness/context/turn-envelope.js +188 -0
- package/dist/harness/context/types.d.ts +35 -47
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
- package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
- package/dist/harness/extension/execution-environment/index.d.ts +18 -2
- package/dist/harness/extension/execution-environment/index.js +11 -2
- package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
- package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
- package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
- package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
- package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
- package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
- package/dist/harness/extension/execution-environment/sandbox.js +493 -51
- package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
- package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
- package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
- package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
- package/dist/harness/extension/execution-environment/types.d.ts +67 -39
- package/dist/harness/extension/execution-environment/types.js +2 -2
- package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
- package/dist/harness/extension/execution-environment/undo-log.js +627 -0
- package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
- package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
- package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
- package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
- package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
- package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
- package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
- package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
- package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
- package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
- package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
- package/dist/harness/governance/credentials/index.d.ts +1 -1
- package/dist/harness/governance/credentials/store.d.ts +16 -4
- package/dist/harness/governance/credentials/store.js +33 -6
- package/dist/harness/governance/credentials/types.d.ts +11 -0
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
- package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
- package/dist/harness/governance/human-in-the-loop/index.js +3 -3
- package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
- package/dist/harness/governance/human-in-the-loop/types.js +6 -2
- package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
- package/dist/harness/governance/security/capability-enforcer.js +31 -8
- package/dist/harness/governance/security/degradation.js +5 -7
- package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
- package/dist/harness/governance/security/risk-evaluator.js +4 -82
- package/dist/harness/governance/security/temp-path.d.ts +41 -0
- package/dist/harness/governance/security/temp-path.js +117 -0
- package/dist/harness/governance/session-acl/index.d.ts +1 -0
- package/dist/harness/governance/session-acl/index.js +1 -0
- package/dist/harness/governance/session-acl/rights.d.ts +12 -0
- package/dist/harness/governance/session-acl/rights.js +89 -7
- package/dist/harness/governance/session-acl/seed-roles.js +9 -1
- package/dist/harness/governance/session-acl/service.js +21 -29
- package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
- package/dist/harness/governance/session-acl/tool-rights.js +238 -0
- package/dist/harness/governance/session-acl/types.d.ts +22 -0
- package/dist/harness/index.d.ts +18 -15
- package/dist/harness/index.js +11 -7
- package/dist/harness/knowledge/file-index-store.js +11 -11
- package/dist/harness/knowledge/grounding.d.ts +2 -1
- package/dist/harness/knowledge/grounding.js +6 -3
- package/dist/harness/knowledge/index.d.ts +2 -2
- package/dist/harness/knowledge/index.js +1 -1
- package/dist/harness/knowledge/ingest.js +4 -1
- package/dist/harness/knowledge/job-control-state.js +4 -4
- package/dist/harness/knowledge/job-control.js +11 -11
- package/dist/harness/knowledge/membership-store.js +11 -11
- package/dist/harness/knowledge/network-guard.d.ts +61 -4
- package/dist/harness/knowledge/network-guard.js +390 -113
- package/dist/harness/knowledge/query-service.js +8 -8
- package/dist/harness/knowledge/retriever.js +1 -1
- package/dist/harness/knowledge/source-store.d.ts +17 -2
- package/dist/harness/knowledge/source-store.js +6 -5
- package/dist/harness/knowledge/writer-service.d.ts +2 -0
- package/dist/harness/knowledge/writer-service.js +14 -13
- package/dist/harness/memory/backfill-trigger.d.ts +2 -2
- package/dist/harness/memory/backfill-trigger.js +4 -4
- package/dist/harness/memory/cognition-decay.d.ts +36 -0
- package/dist/harness/memory/cognition-decay.js +55 -0
- package/dist/harness/memory/cognition-gates.d.ts +60 -0
- package/dist/harness/memory/cognition-gates.js +191 -0
- package/dist/harness/memory/cognition-trigger.d.ts +30 -0
- package/dist/harness/memory/cognition-trigger.js +41 -0
- package/dist/harness/memory/cognition-types.d.ts +1 -1
- package/dist/harness/memory/cognition.d.ts +40 -8
- package/dist/harness/memory/cognition.js +432 -79
- package/dist/harness/memory/conceptualizer.d.ts +66 -0
- package/dist/harness/memory/conceptualizer.js +246 -0
- package/dist/harness/memory/index.d.ts +17 -2
- package/dist/harness/memory/index.js +12 -1
- package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
- package/dist/harness/memory/sqlite/agent-db.js +120 -15
- package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
- package/dist/harness/memory/sqlite/cognition-store.js +591 -144
- package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
- package/dist/harness/memory/sqlite/memory-store.js +14 -4
- package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
- package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
- package/dist/harness/memory/store.d.ts +1 -0
- package/dist/harness/memory/store.js +3 -0
- package/dist/harness/memory/time-format.d.ts +28 -0
- package/dist/harness/memory/time-format.js +52 -0
- package/dist/harness/memory/types.d.ts +343 -16
- package/dist/harness/memory/types.js +49 -0
- package/dist/harness/memory/wisdom-formation.d.ts +101 -0
- package/dist/harness/memory/wisdom-formation.js +304 -0
- package/dist/harness/memory/wisdom-gates.d.ts +50 -0
- package/dist/harness/memory/wisdom-gates.js +204 -0
- package/dist/harness/memory/wisdom-policy.d.ts +107 -0
- package/dist/harness/memory/wisdom-policy.js +220 -0
- package/dist/harness/memory/wisdom-types.d.ts +3 -2
- package/dist/harness/memory/wisdom-types.js +2 -2
- package/dist/harness/memory/wisdom.d.ts +27 -0
- package/dist/harness/memory/wisdom.js +181 -0
- package/dist/harness/observability/observer/hub.js +23 -1
- package/dist/harness/observability/observer/index.d.ts +2 -2
- package/dist/harness/observability/observer/index.js +1 -1
- package/dist/harness/observability/observer/types.d.ts +57 -0
- package/dist/harness/observability/observer/types.js +118 -9
- package/dist/harness/run/agent/agent.d.ts +27 -0
- package/dist/harness/run/agent/agent.js +45 -0
- package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
- package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
- package/dist/harness/run/reliability/harness-events.d.ts +4 -0
- package/dist/harness/run/reliability/run-agent.js +116 -20
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
- package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
- package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
- package/dist/harness/run/run-guard/default-run-guard.js +104 -44
- package/dist/harness/run/run-scope.d.ts +52 -0
- package/dist/harness/run/runner.d.ts +101 -16
- package/dist/harness/run/runner.js +557 -158
- package/dist/harness/session/attachments/llm-intent.js +17 -17
- package/dist/harness/session/history/port.js +1 -0
- package/dist/harness/session/in-memory-store.d.ts +1 -0
- package/dist/harness/session/in-memory-store.js +22 -1
- package/dist/harness/session/index.d.ts +1 -0
- package/dist/harness/session/index.js +1 -0
- package/dist/harness/session/schedules/index.d.ts +10 -0
- package/dist/harness/session/schedules/index.js +10 -0
- package/dist/harness/session/schedules/render.d.ts +13 -0
- package/dist/harness/session/schedules/render.js +63 -0
- package/dist/harness/session/schedules/service.d.ts +179 -0
- package/dist/harness/session/schedules/service.js +695 -0
- package/dist/harness/session/schedules/store.d.ts +119 -0
- package/dist/harness/session/schedules/store.js +323 -0
- package/dist/harness/session/schedules/tools.d.ts +39 -0
- package/dist/harness/session/schedules/tools.js +442 -0
- package/dist/harness/session/schedules/types.d.ts +104 -0
- package/dist/harness/session/schedules/types.js +97 -0
- package/dist/harness/session/tasks/tools.js +22 -0
- package/dist/harness/session/title.d.ts +86 -0
- package/dist/harness/session/title.js +268 -0
- package/dist/harness/session/types.d.ts +35 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
- package/dist/harness/shared/events/agent-event-map.js +1 -0
- package/dist/harness/shared/types/agent-definition.d.ts +23 -0
- package/dist/index.d.ts +25 -9
- package/dist/index.js +11 -2
- package/dist/integration/providers/anthropic.d.ts +10 -0
- package/dist/integration/providers/anthropic.js +44 -1
- package/dist/integration/providers/openai.d.ts +10 -0
- package/dist/integration/providers/openai.js +58 -2
- package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
- package/dist/integration/providers/wire-dump-diff.js +351 -0
- package/dist/integration/providers/wire-dump.d.ts +178 -0
- package/dist/integration/providers/wire-dump.js +396 -0
- package/dist/integration/storage/jsonl.d.ts +11 -0
- package/dist/integration/storage/jsonl.js +148 -39
- package/dist/integration/storage/session-index.js +63 -8
- package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
- package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
- package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
- package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
- package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
- package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
- package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
- package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
- package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
- package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
- package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
- package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
- package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
- package/package.json +115 -115
- package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
- package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
- package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
- package/dist/harness/collaboration/multi-agent/index.js +0 -15
- package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
- package/dist/harness/collaboration/multi-agent/process.js +0 -256
- package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
- package/dist/harness/collaboration/multi-agent/registry.js +0 -137
- package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
- package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
- package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
- package/dist/harness/collaboration/multi-agent/types.js +0 -15
- package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
- package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
- package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
- package/dist/harness/collaboration/orchestration/async-task.js +0 -359
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
- package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
- package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
- package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
- package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
- package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
- package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
- package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
- package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
- package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
- package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
- package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
- package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
- package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
- package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
- package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
- package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
- package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
- package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
- package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
- package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
- package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
- package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
- package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
- package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
- package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
- package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
- package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
- package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
- package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
- /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
- /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
|
@@ -32,6 +32,7 @@ export function createTaskListTool(service) {
|
|
|
32
32
|
return {
|
|
33
33
|
definition: {
|
|
34
34
|
name: 'task_list',
|
|
35
|
+
capabilities: ['fs-read'],
|
|
35
36
|
description: 'List session tasks (goals and steps). Goals have no parent_id; steps have parent_id of their goal.',
|
|
36
37
|
parameters: {
|
|
37
38
|
status: {
|
|
@@ -71,6 +72,7 @@ export function createTaskCreateTool(service) {
|
|
|
71
72
|
return {
|
|
72
73
|
definition: {
|
|
73
74
|
name: 'task_create',
|
|
75
|
+
capabilities: ['fs-write'],
|
|
74
76
|
description: 'Create a session task. Without parent_id creates a user-level goal. With parent_id creates a step under an existing goal (depth 1 only).',
|
|
75
77
|
parameters: {
|
|
76
78
|
description: {
|
|
@@ -84,6 +86,8 @@ export function createTaskCreateTool(service) {
|
|
|
84
86
|
},
|
|
85
87
|
},
|
|
86
88
|
},
|
|
89
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
90
|
+
executionMode: 'sequential',
|
|
87
91
|
handler: async (args, context) => {
|
|
88
92
|
const description = String(args.description ?? '');
|
|
89
93
|
const parentId = args.parent_id ? String(args.parent_id) : undefined;
|
|
@@ -96,6 +100,7 @@ export function createTaskPlanTool(service) {
|
|
|
96
100
|
return {
|
|
97
101
|
definition: {
|
|
98
102
|
name: 'task_plan',
|
|
103
|
+
capabilities: ['fs-write'],
|
|
99
104
|
description: 'Create ordered steps for an existing goal in one call.',
|
|
100
105
|
parameters: {
|
|
101
106
|
goal_id: { type: 'string', description: 'Goal task id', required: true },
|
|
@@ -108,6 +113,8 @@ export function createTaskPlanTool(service) {
|
|
|
108
113
|
},
|
|
109
114
|
},
|
|
110
115
|
},
|
|
116
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
117
|
+
executionMode: 'sequential',
|
|
111
118
|
handler: async (args, context) => {
|
|
112
119
|
const goalId = String(args.goal_id ?? '');
|
|
113
120
|
const raw = args.steps;
|
|
@@ -124,12 +131,15 @@ export function createTaskCompleteTool(service) {
|
|
|
124
131
|
return {
|
|
125
132
|
definition: {
|
|
126
133
|
name: 'task_complete',
|
|
134
|
+
capabilities: ['fs-write'],
|
|
127
135
|
description: 'Mark a goal or step as done. Explicitly complete the goal when the whole job is finished.',
|
|
128
136
|
parameters: {
|
|
129
137
|
task_id: { type: 'string', description: 'Task id', required: true },
|
|
130
138
|
progress_note: { type: 'string', description: 'Optional short progress note' },
|
|
131
139
|
},
|
|
132
140
|
},
|
|
141
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
142
|
+
executionMode: 'sequential',
|
|
133
143
|
handler: async (args, context) => {
|
|
134
144
|
const taskId = String(args.task_id ?? '');
|
|
135
145
|
const progressNote = args.progress_note ? String(args.progress_note) : undefined;
|
|
@@ -142,12 +152,15 @@ export function createTaskPauseTool(service) {
|
|
|
142
152
|
return {
|
|
143
153
|
definition: {
|
|
144
154
|
name: 'task_pause',
|
|
155
|
+
capabilities: ['fs-write'],
|
|
145
156
|
description: 'Pause an open task (goal or step).',
|
|
146
157
|
parameters: {
|
|
147
158
|
task_id: { type: 'string', description: 'Task id', required: true },
|
|
148
159
|
reason: { type: 'string', description: 'Optional reason' },
|
|
149
160
|
},
|
|
150
161
|
},
|
|
162
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
163
|
+
executionMode: 'sequential',
|
|
151
164
|
handler: async (args, context) => {
|
|
152
165
|
const taskId = String(args.task_id ?? '');
|
|
153
166
|
const reason = args.reason ? String(args.reason) : undefined;
|
|
@@ -160,11 +173,14 @@ export function createTaskResumeTool(service) {
|
|
|
160
173
|
return {
|
|
161
174
|
definition: {
|
|
162
175
|
name: 'task_resume',
|
|
176
|
+
capabilities: ['fs-write'],
|
|
163
177
|
description: 'Resume a paused task.',
|
|
164
178
|
parameters: {
|
|
165
179
|
task_id: { type: 'string', description: 'Task id', required: true },
|
|
166
180
|
},
|
|
167
181
|
},
|
|
182
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
183
|
+
executionMode: 'sequential',
|
|
168
184
|
handler: async (args, context) => {
|
|
169
185
|
const taskId = String(args.task_id ?? '');
|
|
170
186
|
const task = await service.resume(context.agentId, context.sessionId, taskId);
|
|
@@ -176,12 +192,15 @@ export function createTaskDropTool(service) {
|
|
|
176
192
|
return {
|
|
177
193
|
definition: {
|
|
178
194
|
name: 'task_drop',
|
|
195
|
+
capabilities: ['fs-write'],
|
|
179
196
|
description: 'Drop/cancel a task. Dropping a goal also drops its open steps.',
|
|
180
197
|
parameters: {
|
|
181
198
|
task_id: { type: 'string', description: 'Task id', required: true },
|
|
182
199
|
reason: { type: 'string', description: 'Optional reason' },
|
|
183
200
|
},
|
|
184
201
|
},
|
|
202
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
203
|
+
executionMode: 'sequential',
|
|
185
204
|
handler: async (args, context) => {
|
|
186
205
|
const taskId = String(args.task_id ?? '');
|
|
187
206
|
const reason = args.reason ? String(args.reason) : undefined;
|
|
@@ -194,12 +213,15 @@ export function createTaskNoteTool(service) {
|
|
|
194
213
|
return {
|
|
195
214
|
definition: {
|
|
196
215
|
name: 'task_note',
|
|
216
|
+
capabilities: ['fs-write'],
|
|
197
217
|
description: 'Update the progress note on a task without changing status.',
|
|
198
218
|
parameters: {
|
|
199
219
|
task_id: { type: 'string', description: 'Task id', required: true },
|
|
200
220
|
progress_note: { type: 'string', description: 'Short progress note', required: true },
|
|
201
221
|
},
|
|
202
222
|
},
|
|
223
|
+
// 写共享 SessionData(读改写整包存回):所在 tool_call 批次整体串行,防并发丢更新
|
|
224
|
+
executionMode: 'sequential',
|
|
203
225
|
handler: async (args, context) => {
|
|
204
226
|
const taskId = String(args.task_id ?? '');
|
|
205
227
|
const progressNote = String(args.progress_note ?? '');
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 会话标题策略 — 临时截断 / 小模型摘要触发条件
|
|
3
|
+
*
|
|
4
|
+
* 目标:历史列表一眼可认;「你好」类碎消息不浪费 LLM 调用。
|
|
5
|
+
*/
|
|
6
|
+
import type { Message, SessionMeta } from '@octopi-agent/core/types.js';
|
|
7
|
+
import type { SessionData } from './types.js';
|
|
8
|
+
/** 首条有效用户消息达到该长度才可直接摘要 */
|
|
9
|
+
export declare const TITLE_MIN_FIRST_USER_CHARS = 16;
|
|
10
|
+
/** 累计有效用户内容达到该长度(且至少 1 轮完成)可摘要 */
|
|
11
|
+
export declare const TITLE_MIN_TOTAL_USER_CHARS = 40;
|
|
12
|
+
/** 临时截断标题最大长度 */
|
|
13
|
+
export declare const TITLE_SNIPPET_MAX_CHARS = 24;
|
|
14
|
+
/** 生成标题最大长度 */
|
|
15
|
+
export declare const TITLE_MAX_CHARS = 40;
|
|
16
|
+
/**
|
|
17
|
+
* 压缩 URL / 本地路径,避免路径噪声占满 snippet 与摘要 prompt。
|
|
18
|
+
*
|
|
19
|
+
* 长 percent-encoded file:// 路径会把 24 字 snippet 截成「帮我评估一下, file:///…」,
|
|
20
|
+
* 也会把送入小模型的前 400 字预算吃光,导致摘要失败或弱标题。
|
|
21
|
+
*
|
|
22
|
+
* @param text - 原始消息文本
|
|
23
|
+
* @returns 路径替换为文件名后的文本
|
|
24
|
+
*/
|
|
25
|
+
export declare function compactTitleText(text: string): string;
|
|
26
|
+
/** 收集标题相关的用户文本(按时间序,已压缩路径) */
|
|
27
|
+
export declare function collectTitleUserTexts(messages: Message[]): string[];
|
|
28
|
+
/**
|
|
29
|
+
* 是否已具备生成摘要标题的语义信号。
|
|
30
|
+
*
|
|
31
|
+
* @param session - 会话数据(用 messages 判断)
|
|
32
|
+
* @returns 首条/最新用户消息够长,或累计用户内容够长且已有助手回复
|
|
33
|
+
*/
|
|
34
|
+
export declare function isTitleSignalReady(session: Pick<SessionData, 'messages'>): boolean;
|
|
35
|
+
/**
|
|
36
|
+
* 是否应尝试更新标题(尊重手动重命名与已生成有效 auto)。
|
|
37
|
+
*
|
|
38
|
+
* @param meta - 会话元数据
|
|
39
|
+
* @returns true = 允许写入 snippet 或重新生成 auto
|
|
40
|
+
*/
|
|
41
|
+
export declare function shouldUpdateTitle(meta: Pick<SessionMeta, 'title' | 'titleSource'>): boolean;
|
|
42
|
+
/**
|
|
43
|
+
* 是否像代码 / 标记 / 工具载荷——不适合当会话标题。
|
|
44
|
+
*
|
|
45
|
+
* 只拦「本身就是载荷」的开头,不误伤「npm 依赖冲突」这类正常主题。
|
|
46
|
+
*
|
|
47
|
+
* @param text - 候选标题或消息正文
|
|
48
|
+
* @returns true = 应跳过或视为弱标题
|
|
49
|
+
*/
|
|
50
|
+
export declare function looksLikeCodeOrMarkup(text: string): boolean;
|
|
51
|
+
/**
|
|
52
|
+
* 构建临时标题:优先首条「有语义」的用户消息,否则取最长一条。
|
|
53
|
+
*
|
|
54
|
+
* 避免「你好」占位后复杂提问也一直显示「你好」;路径已压缩为文件名。
|
|
55
|
+
*
|
|
56
|
+
* @param messages - 会话消息
|
|
57
|
+
* @returns 截断后的 snippet;无有效用户消息时返回 null
|
|
58
|
+
*/
|
|
59
|
+
export declare function buildSnippetTitle(messages: Message[]): string | null;
|
|
60
|
+
/**
|
|
61
|
+
* 规范化模型输出的标题(去引号/换行、限长)。
|
|
62
|
+
*
|
|
63
|
+
* @param raw - 模型原始输出
|
|
64
|
+
* @returns 单行短标题;空输出返回 null
|
|
65
|
+
*/
|
|
66
|
+
export declare function normalizeGeneratedTitle(raw: string): string | null;
|
|
67
|
+
/**
|
|
68
|
+
* 弱标题(寒暄/过短/无信息量)——即使已标成 auto 也允许再升级。
|
|
69
|
+
*
|
|
70
|
+
* @param title - 当前标题
|
|
71
|
+
* @returns true = 不应视为最终摘要标题
|
|
72
|
+
*/
|
|
73
|
+
export declare function isWeakTitle(title: string | undefined): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* 构建摘要标题的 LLM 消息。
|
|
76
|
+
*
|
|
77
|
+
* 标题语义 = 「这段对话面向的是什么事」(主题标签),不是对话内容复述。
|
|
78
|
+
* 正文先压缩 URL/路径,避免 percent-encoded 路径吃光上下文预算。
|
|
79
|
+
*
|
|
80
|
+
* @param messages - 会话消息(跳过寒暄与命令留痕)
|
|
81
|
+
* @returns 送给 ModelProvider.chat 的 messages
|
|
82
|
+
*/
|
|
83
|
+
export declare function buildTitlePrompt(messages: Message[]): Array<{
|
|
84
|
+
role: 'system' | 'user';
|
|
85
|
+
content: string;
|
|
86
|
+
}>;
|
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 会话标题策略 — 临时截断 / 小模型摘要触发条件
|
|
3
|
+
*
|
|
4
|
+
* 目标:历史列表一眼可认;「你好」类碎消息不浪费 LLM 调用。
|
|
5
|
+
*/
|
|
6
|
+
import { getTextContent } from '@octopi-agent/core/types.js';
|
|
7
|
+
/** 首条有效用户消息达到该长度才可直接摘要 */
|
|
8
|
+
export const TITLE_MIN_FIRST_USER_CHARS = 16;
|
|
9
|
+
/** 累计有效用户内容达到该长度(且至少 1 轮完成)可摘要 */
|
|
10
|
+
export const TITLE_MIN_TOTAL_USER_CHARS = 40;
|
|
11
|
+
/** 临时截断标题最大长度 */
|
|
12
|
+
export const TITLE_SNIPPET_MAX_CHARS = 24;
|
|
13
|
+
/** 生成标题最大长度 */
|
|
14
|
+
export const TITLE_MAX_CHARS = 40;
|
|
15
|
+
/** 参与标题信号统计的用户消息(排除 slash 命令留痕) */
|
|
16
|
+
function isTitleRelevantUserMessage(msg) {
|
|
17
|
+
if (msg.role !== 'user')
|
|
18
|
+
return false;
|
|
19
|
+
const kind = msg.metadata?.kind;
|
|
20
|
+
if (kind === 'command' || kind === 'command_result')
|
|
21
|
+
return false;
|
|
22
|
+
return true;
|
|
23
|
+
}
|
|
24
|
+
/** 提取纯文本并压空白 */
|
|
25
|
+
function messageText(msg) {
|
|
26
|
+
return getTextContent(msg.content).replace(/\s+/g, ' ').trim();
|
|
27
|
+
}
|
|
28
|
+
function safeDecodeURIComponent(s) {
|
|
29
|
+
try {
|
|
30
|
+
return decodeURIComponent(s);
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
// 非法 percent-encoding 原样返回,不因个别字符丢掉整段
|
|
34
|
+
return s;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
/** 从 URL / 路径 token 取文件名(尽量解码 percent-encoding) */
|
|
38
|
+
function filenameFromUrlLike(token) {
|
|
39
|
+
const withoutScheme = token.replace(/^[a-z][a-z0-9+.-]*:\/\//i, '');
|
|
40
|
+
const withoutDrive = withoutScheme.replace(/^[A-Za-z]:[\\/]?/, '');
|
|
41
|
+
const last = withoutDrive.split(/[\\/]/).filter(Boolean).pop() ?? '';
|
|
42
|
+
const base = last.split(/[?#]/)[0] ?? '';
|
|
43
|
+
const decoded = safeDecodeURIComponent(base).trim();
|
|
44
|
+
if (!decoded)
|
|
45
|
+
return '路径';
|
|
46
|
+
return decoded.length > 40 ? `${decoded.slice(0, 39)}…` : decoded;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* 压缩 URL / 本地路径,避免路径噪声占满 snippet 与摘要 prompt。
|
|
50
|
+
*
|
|
51
|
+
* 长 percent-encoded file:// 路径会把 24 字 snippet 截成「帮我评估一下, file:///…」,
|
|
52
|
+
* 也会把送入小模型的前 400 字预算吃光,导致摘要失败或弱标题。
|
|
53
|
+
*
|
|
54
|
+
* @param text - 原始消息文本
|
|
55
|
+
* @returns 路径替换为文件名后的文本
|
|
56
|
+
*/
|
|
57
|
+
export function compactTitleText(text) {
|
|
58
|
+
return text
|
|
59
|
+
.replace(/\b(?:file|https?):\/\/[^\s<>"']+/gi, (m) => filenameFromUrlLike(m))
|
|
60
|
+
.replace(/\b[A-Za-z]:[\\/][^\s<>"']+/g, (m) => filenameFromUrlLike(m))
|
|
61
|
+
.replace(/(?:^|[\s((「『])((?:\/[\w.@-]+){2,})/g, (m, path) => {
|
|
62
|
+
const lead = m.slice(0, m.length - path.length);
|
|
63
|
+
return `${lead}${filenameFromUrlLike(path)}`;
|
|
64
|
+
})
|
|
65
|
+
.replace(/\s+/g, ' ')
|
|
66
|
+
.trim();
|
|
67
|
+
}
|
|
68
|
+
/** 标题用文本:纯文本 + 路径压缩 */
|
|
69
|
+
function titleText(msg) {
|
|
70
|
+
return compactTitleText(messageText(msg));
|
|
71
|
+
}
|
|
72
|
+
/** 收集标题相关的用户文本(按时间序,已压缩路径) */
|
|
73
|
+
export function collectTitleUserTexts(messages) {
|
|
74
|
+
return messages.filter(isTitleRelevantUserMessage).map(titleText).filter(Boolean);
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* 是否已具备生成摘要标题的语义信号。
|
|
78
|
+
*
|
|
79
|
+
* @param session - 会话数据(用 messages 判断)
|
|
80
|
+
* @returns 首条/最新用户消息够长,或累计用户内容够长且已有助手回复
|
|
81
|
+
*/
|
|
82
|
+
export function isTitleSignalReady(session) {
|
|
83
|
+
const userTexts = collectTitleUserTexts(session.messages);
|
|
84
|
+
if (userTexts.length === 0)
|
|
85
|
+
return false;
|
|
86
|
+
// 首条或「最新一条」够长即可(覆盖「你好」后接复杂问题的场景)
|
|
87
|
+
if (userTexts[0].length >= TITLE_MIN_FIRST_USER_CHARS ||
|
|
88
|
+
userTexts[userTexts.length - 1].length >= TITLE_MIN_FIRST_USER_CHARS) {
|
|
89
|
+
return true;
|
|
90
|
+
}
|
|
91
|
+
const totalUser = userTexts.reduce((n, t) => n + t.length, 0);
|
|
92
|
+
const hasAssistant = session.messages.some((m) => m.role === 'assistant' && messageText(m));
|
|
93
|
+
return hasAssistant && totalUser >= TITLE_MIN_TOTAL_USER_CHARS;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* 是否应尝试更新标题(尊重手动重命名与已生成有效 auto)。
|
|
97
|
+
*
|
|
98
|
+
* @param meta - 会话元数据
|
|
99
|
+
* @returns true = 允许写入 snippet 或重新生成 auto
|
|
100
|
+
*/
|
|
101
|
+
export function shouldUpdateTitle(meta) {
|
|
102
|
+
if (meta.titleSource === 'user')
|
|
103
|
+
return false;
|
|
104
|
+
// 有效 auto 不再覆盖;「你好」这类弱 auto/snippet 仍可升级
|
|
105
|
+
if (meta.titleSource === 'auto' && meta.title && !isWeakTitle(meta.title))
|
|
106
|
+
return false;
|
|
107
|
+
return true;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* 是否像代码 / 标记 / 工具载荷——不适合当会话标题。
|
|
111
|
+
*
|
|
112
|
+
* 只拦「本身就是载荷」的开头,不误伤「npm 依赖冲突」这类正常主题。
|
|
113
|
+
*
|
|
114
|
+
* @param text - 候选标题或消息正文
|
|
115
|
+
* @returns true = 应跳过或视为弱标题
|
|
116
|
+
*/
|
|
117
|
+
export function looksLikeCodeOrMarkup(text) {
|
|
118
|
+
const t = text.trim();
|
|
119
|
+
if (!t)
|
|
120
|
+
return true;
|
|
121
|
+
// XML/HTML/自定义标签开头(含 </…>、<!…>、<?…>)
|
|
122
|
+
if (/^<[a-zA-Z!?/]/.test(t))
|
|
123
|
+
return true;
|
|
124
|
+
// 被转义的尖括号标签
|
|
125
|
+
if (/^(?:<|<)/i.test(t))
|
|
126
|
+
return true;
|
|
127
|
+
// 完整 JSON / 配置块
|
|
128
|
+
if (t.length > 20 && /^[{[][\s\S]*[}\]]$/.test(t))
|
|
129
|
+
return true;
|
|
130
|
+
return false;
|
|
131
|
+
}
|
|
132
|
+
/** 是否几乎只是路径 / URL / percent-encoding 堆叠 */
|
|
133
|
+
function isPathDominated(text) {
|
|
134
|
+
const t = text.trim();
|
|
135
|
+
if (!t)
|
|
136
|
+
return true;
|
|
137
|
+
if (/^(?:file|https?):\/\//i.test(t))
|
|
138
|
+
return true;
|
|
139
|
+
if (/^[A-Za-z]:[\\/]/.test(t))
|
|
140
|
+
return true;
|
|
141
|
+
if (t.startsWith('/'))
|
|
142
|
+
return true;
|
|
143
|
+
// percent-encoding 占比过高:解码后语义信息量不足
|
|
144
|
+
const stripped = t.replace(/%[0-9A-Fa-f]{2}/g, '');
|
|
145
|
+
if (t.length >= 12 && stripped.length < t.length * 0.4)
|
|
146
|
+
return true;
|
|
147
|
+
// 纯 ASCII 文件名(无语义词),如 report.pdf / data.json
|
|
148
|
+
if (/^[\w.-]+\.[A-Za-z0-9]{1,8}$/.test(t))
|
|
149
|
+
return true;
|
|
150
|
+
return false;
|
|
151
|
+
}
|
|
152
|
+
/** 开场客套前缀——截断前去掉,让 snippet 落在事项上 */
|
|
153
|
+
const LEAD_IN_RE = /^(?:请|麻烦|帮我|给我|帮忙|能不能|可不可以|想请你|请问|你好[,,]?\s*)+/;
|
|
154
|
+
/**
|
|
155
|
+
* 构建临时标题:优先首条「有语义」的用户消息,否则取最长一条。
|
|
156
|
+
*
|
|
157
|
+
* 避免「你好」占位后复杂提问也一直显示「你好」;路径已压缩为文件名。
|
|
158
|
+
*
|
|
159
|
+
* @param messages - 会话消息
|
|
160
|
+
* @returns 截断后的 snippet;无有效用户消息时返回 null
|
|
161
|
+
*/
|
|
162
|
+
export function buildSnippetTitle(messages) {
|
|
163
|
+
const userTexts = collectTitleUserTexts(messages)
|
|
164
|
+
.map((t) => t.replace(LEAD_IN_RE, '').trim() || t)
|
|
165
|
+
.filter((t) => !looksLikeCodeOrMarkup(t) && !isPathDominated(t));
|
|
166
|
+
if (userTexts.length === 0)
|
|
167
|
+
return null;
|
|
168
|
+
const substantial = userTexts.find((t) => t.length >= TITLE_MIN_FIRST_USER_CHARS);
|
|
169
|
+
const preferred = substantial
|
|
170
|
+
?? userTexts.reduce((a, b) => (b.length > a.length ? b : a));
|
|
171
|
+
if (preferred.length <= TITLE_SNIPPET_MAX_CHARS)
|
|
172
|
+
return preferred;
|
|
173
|
+
return `${preferred.slice(0, TITLE_SNIPPET_MAX_CHARS - 1)}…`;
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* 规范化模型输出的标题(去引号/换行、限长)。
|
|
177
|
+
*
|
|
178
|
+
* @param raw - 模型原始输出
|
|
179
|
+
* @returns 单行短标题;空输出返回 null
|
|
180
|
+
*/
|
|
181
|
+
export function normalizeGeneratedTitle(raw) {
|
|
182
|
+
const firstLine = raw
|
|
183
|
+
.split('\n')
|
|
184
|
+
.map((line) => line.trim())
|
|
185
|
+
.filter(Boolean)[0] ?? '';
|
|
186
|
+
let t = firstLine
|
|
187
|
+
.replace(/^(?:["'「『]|")+/, '')
|
|
188
|
+
.replace(/(?:["'」』]|")+$/, '')
|
|
189
|
+
.replace(/\s+/g, ' ')
|
|
190
|
+
.trim();
|
|
191
|
+
// 去掉一层简单包裹标签,如 <title>xxx</title>
|
|
192
|
+
t = t.replace(/^<([a-zA-Z][\w:-]*)[^>]*>([\s\S]*)<\/\1>$/, '$2').trim();
|
|
193
|
+
if (!t)
|
|
194
|
+
return null;
|
|
195
|
+
if (looksLikeCodeOrMarkup(t))
|
|
196
|
+
return null;
|
|
197
|
+
if (t.length > TITLE_MAX_CHARS)
|
|
198
|
+
t = `${t.slice(0, TITLE_MAX_CHARS - 1)}…`;
|
|
199
|
+
return t;
|
|
200
|
+
}
|
|
201
|
+
/** 无信息量的寒暄(标题信号不足时仍可进 snippet,但不进摘要 prompt) */
|
|
202
|
+
const GREETING_ONLY_RE = /^(?:你好|您好|哈喽|hello|hi|hey|在吗|在么|早上好|中午好|下午好|晚上好|谢谢|感谢|好的|ok|okay|嗯|哦)[!!。~~.\s]*$/i;
|
|
203
|
+
/** 短问候回复,如「你好!有什么可以帮你?」 */
|
|
204
|
+
const PLEASANTRY_RE = /你好|您好|哈喽|hello|hi\b|帮你|有什么可以|请问需要|很高兴|欢迎/i;
|
|
205
|
+
function isNoiseForTitle(text) {
|
|
206
|
+
if (text.length < 4)
|
|
207
|
+
return true;
|
|
208
|
+
if (GREETING_ONLY_RE.test(text))
|
|
209
|
+
return true;
|
|
210
|
+
return text.length <= 20 && PLEASANTRY_RE.test(text);
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* 弱标题(寒暄/过短/无信息量)——即使已标成 auto 也允许再升级。
|
|
214
|
+
*
|
|
215
|
+
* @param title - 当前标题
|
|
216
|
+
* @returns true = 不应视为最终摘要标题
|
|
217
|
+
*/
|
|
218
|
+
export function isWeakTitle(title) {
|
|
219
|
+
if (!title)
|
|
220
|
+
return true;
|
|
221
|
+
const t = title.trim();
|
|
222
|
+
if (!t)
|
|
223
|
+
return true;
|
|
224
|
+
if (looksLikeCodeOrMarkup(t))
|
|
225
|
+
return true;
|
|
226
|
+
if (isPathDominated(t))
|
|
227
|
+
return true;
|
|
228
|
+
return isNoiseForTitle(t);
|
|
229
|
+
}
|
|
230
|
+
/**
|
|
231
|
+
* 构建摘要标题的 LLM 消息。
|
|
232
|
+
*
|
|
233
|
+
* 标题语义 = 「这段对话面向的是什么事」(主题标签),不是对话内容复述。
|
|
234
|
+
* 正文先压缩 URL/路径,避免 percent-encoded 路径吃光上下文预算。
|
|
235
|
+
*
|
|
236
|
+
* @param messages - 会话消息(跳过寒暄与命令留痕)
|
|
237
|
+
* @returns 送给 ModelProvider.chat 的 messages
|
|
238
|
+
*/
|
|
239
|
+
export function buildTitlePrompt(messages) {
|
|
240
|
+
const entries = [];
|
|
241
|
+
for (const msg of messages) {
|
|
242
|
+
if (msg.role !== 'user' && msg.role !== 'assistant')
|
|
243
|
+
continue;
|
|
244
|
+
const kind = msg.metadata?.kind;
|
|
245
|
+
if (kind === 'command' || kind === 'command_result')
|
|
246
|
+
continue;
|
|
247
|
+
const text = titleText(msg);
|
|
248
|
+
if (!text)
|
|
249
|
+
continue;
|
|
250
|
+
entries.push({ role: msg.role === 'user' ? 'user' : 'assistant', text });
|
|
251
|
+
}
|
|
252
|
+
// 有实质内容时丢掉纯寒暄,避免标题被「你好」带偏
|
|
253
|
+
const meaningful = entries.filter((e) => !isNoiseForTitle(e.text));
|
|
254
|
+
const picked = meaningful.length > 0 ? meaningful : entries;
|
|
255
|
+
const lines = picked.slice(0, 6).map((e) => `${e.role === 'user' ? '用户' : '助手'}: ${e.text.slice(0, 400)}`);
|
|
256
|
+
const dialogue = lines.join('\n');
|
|
257
|
+
return [
|
|
258
|
+
{
|
|
259
|
+
role: 'system',
|
|
260
|
+
content: '你是会话标题生成器。判断这段对话「面向的是什么事」,输出一个主题式短标题。\n' +
|
|
261
|
+
'写法:像文件名/标签,点明对象+事项,优先保留专名(项目名、系统名、模块名、文档名)。\n' +
|
|
262
|
+
'忽略路径、URL、命令行等载荷噪音,标题写实际要做的事。\n' +
|
|
263
|
+
'使用与对话相同的语言。6–16 个字为宜,不超过 20 字。\n' +
|
|
264
|
+
'不要引号、不要句号、不要解释,只输出标题本身。',
|
|
265
|
+
},
|
|
266
|
+
{ role: 'user', content: dialogue },
|
|
267
|
+
];
|
|
268
|
+
}
|
|
@@ -19,6 +19,27 @@ export interface SessionSwitchRecord extends PrincipalRef {
|
|
|
19
19
|
toPrimaryAgentId?: string;
|
|
20
20
|
reason?: string;
|
|
21
21
|
}
|
|
22
|
+
/**
|
|
23
|
+
* 委派产生的 Session 父子关联(I2 投影可重建)
|
|
24
|
+
*
|
|
25
|
+
* 子 agent 经委派(`arch/delegation.md`)起 Run 时落**独立 Session**,
|
|
26
|
+
* 并在此记录来源,使审计链不断(D7)。
|
|
27
|
+
*
|
|
28
|
+
* 刻意不塞 `metadata`:I2 要求 Discourse 权威可重建,
|
|
29
|
+
* 显式字段才好投影 / 检索 / 审计。
|
|
30
|
+
*/
|
|
31
|
+
export interface SessionSpawnLink {
|
|
32
|
+
/** 委派单 ID(`harness/collaboration/delegation`) */
|
|
33
|
+
delegationId: string;
|
|
34
|
+
/** 发起委派的 agentId */
|
|
35
|
+
parentAgentId: string;
|
|
36
|
+
/** 父 session ID */
|
|
37
|
+
parentSessionId: string;
|
|
38
|
+
/** 父 run ID */
|
|
39
|
+
parentRunId: string;
|
|
40
|
+
/** 委派链深度(根委派 = 1) */
|
|
41
|
+
depth?: number;
|
|
42
|
+
}
|
|
22
43
|
/** Session 生命周期状态(`extracted` 已废除:提炼进度归 memory.steward) */
|
|
23
44
|
export type SessionLifecycleStatus = 'active' | 'recent' | 'archived';
|
|
24
45
|
/**
|
|
@@ -60,11 +81,25 @@ export interface SessionData {
|
|
|
60
81
|
preferredAgentId?: string;
|
|
61
82
|
/** preferred / handoff 切换审计(I6 Principal 进审计) */
|
|
62
83
|
switchAudit?: SessionSwitchRecord[];
|
|
84
|
+
/**
|
|
85
|
+
* 委派来源(`arch/delegation.md` D7)。
|
|
86
|
+
*
|
|
87
|
+
* 本 Session 由父 agent 的委派产生时写入;用户直接创建的 Session 无此字段。
|
|
88
|
+
* 父 Run 结束后子 Session **继续存在**(决策 C1),故关联必须持久化。
|
|
89
|
+
*/
|
|
90
|
+
spawnBy?: SessionSpawnLink;
|
|
63
91
|
meta: SessionMeta;
|
|
64
92
|
messages: Message[];
|
|
65
93
|
turns: Turn[];
|
|
66
94
|
metadata: Record<string, unknown>;
|
|
67
95
|
lifecycle?: SessionLifecycleMeta;
|
|
96
|
+
/**
|
|
97
|
+
* 上下文租约截断点(messages 下标)。
|
|
98
|
+
*
|
|
99
|
+
* 仅影响 LLM 默认消息窗口;Discourse 全量仍在 `messages`。
|
|
100
|
+
* `undefined` / `0` = 不截断。由 Runner 在 `idleExpiryMs` 显式配置且闲置超时后写入。
|
|
101
|
+
*/
|
|
102
|
+
contextDetachIndex?: number;
|
|
68
103
|
/**
|
|
69
104
|
* 会话任务(goal/step 两级)。见 docs/task-system.md。
|
|
70
105
|
* 历史数据可能缺省;Service/Runner 会视作 []。
|
|
@@ -47,6 +47,19 @@ export interface AgentEventMap {
|
|
|
47
47
|
hasError?: boolean;
|
|
48
48
|
result?: unknown;
|
|
49
49
|
durationMs?: number;
|
|
50
|
+
/** 行动简述 */
|
|
51
|
+
purpose?: string;
|
|
52
|
+
};
|
|
53
|
+
/** ToolEffectPolicy §5.6 效应账本摘要(turn 级;Observer tool.effect) */
|
|
54
|
+
'tool.effect.ledger': {
|
|
55
|
+
entries: number;
|
|
56
|
+
truncated?: boolean;
|
|
57
|
+
notReversed?: {
|
|
58
|
+
reason: string;
|
|
59
|
+
created?: string[];
|
|
60
|
+
modified?: string[];
|
|
61
|
+
deleted?: string[];
|
|
62
|
+
};
|
|
50
63
|
};
|
|
51
64
|
'budget.exceeded': {
|
|
52
65
|
reason: 'wall_clock' | 'iteration' | 'tool_calls';
|
|
@@ -102,6 +115,13 @@ export interface AgentEventMap {
|
|
|
102
115
|
agentId?: string;
|
|
103
116
|
reason?: string;
|
|
104
117
|
};
|
|
118
|
+
/** 会话展示元数据变更(标题等;UI 列表刷新) */
|
|
119
|
+
'session.updated': {
|
|
120
|
+
sessionId: string;
|
|
121
|
+
title?: string;
|
|
122
|
+
titleSource?: 'snippet' | 'auto' | 'user';
|
|
123
|
+
updatedAt?: number;
|
|
124
|
+
};
|
|
105
125
|
/** Persona 磁盘解析失败(Runner) */
|
|
106
126
|
'persona.resolve.failed': {
|
|
107
127
|
error: string;
|
|
@@ -245,6 +265,7 @@ export declare const AgentEvents: {
|
|
|
245
265
|
readonly RUN_GUARD_RECOVERED: "run_guard.recovered";
|
|
246
266
|
readonly SESSION_LIFECYCLE_UPDATED: "session.lifecycle.updated";
|
|
247
267
|
readonly SESSION_ENDED: "session.ended";
|
|
268
|
+
readonly SESSION_UPDATED: "session.updated";
|
|
248
269
|
readonly PERSONA_RESOLVE_FAILED: "persona.resolve.failed";
|
|
249
270
|
readonly CONTEXT_COMPACT_START: "context.compact.start";
|
|
250
271
|
readonly CONTEXT_COMPACT_END: "context.compact.end";
|
|
@@ -32,6 +32,7 @@ export const AgentEvents = {
|
|
|
32
32
|
RUN_GUARD_RECOVERED: 'run_guard.recovered',
|
|
33
33
|
SESSION_LIFECYCLE_UPDATED: 'session.lifecycle.updated',
|
|
34
34
|
SESSION_ENDED: 'session.ended',
|
|
35
|
+
SESSION_UPDATED: 'session.updated',
|
|
35
36
|
PERSONA_RESOLVE_FAILED: 'persona.resolve.failed',
|
|
36
37
|
CONTEXT_COMPACT_START: 'context.compact.start',
|
|
37
38
|
CONTEXT_COMPACT_END: 'context.compact.end',
|
|
@@ -43,9 +43,32 @@ export interface AgentDefinition {
|
|
|
43
43
|
* handle authorize 时与角色 max / 绑定取交集。
|
|
44
44
|
*/
|
|
45
45
|
maxSessionRights?: SessionRights;
|
|
46
|
+
/** ToolEffectPolicy 运行模式(P3);agents[].effectPolicy 覆盖顶层 */
|
|
47
|
+
effectPolicy?: import('../../extension/execution-environment/effect-policy.js').EffectPolicyConfig;
|
|
46
48
|
/** Knowledge 召回姿态(覆盖全局 knowledge.recall) */
|
|
47
49
|
knowledge?: {
|
|
48
50
|
recall?: 'off' | 'hint' | 'hybrid' | 'inject';
|
|
49
51
|
};
|
|
52
|
+
/** 特质标签(arch/delegation.md §9.2:供父 agent 按特质发现委派目标);无权限语义 */
|
|
53
|
+
traits?: string[];
|
|
54
|
+
/** 委派策略(arch/delegation.md §9.2);整段可省略 = 用 DEFAULT_DELEGATION_POLICY(委派默认开启) */
|
|
55
|
+
delegation?: {
|
|
56
|
+
/** 能否被委派(默认 true;显式 false = 只能被用户直接对话) */
|
|
57
|
+
callable: boolean;
|
|
58
|
+
/** 允许哪些 agentId 调我(缺省 = 任意) */
|
|
59
|
+
callableBy?: string[];
|
|
60
|
+
/** 我能不能再委派、获得 delegate_* 工具(默认 true) */
|
|
61
|
+
canDelegate: boolean;
|
|
62
|
+
/** 递归上限(默认 1 = 我能派子,子不能再派;runaway 兜底) */
|
|
63
|
+
maxDepth?: number;
|
|
64
|
+
/** 被委派时的权利天花板(只能收紧不能放宽,D3) */
|
|
65
|
+
rightsCeiling?: SessionRights;
|
|
66
|
+
/** 委派预算上限(请求预算与此取交集) */
|
|
67
|
+
budget?: {
|
|
68
|
+
maxTurns?: number;
|
|
69
|
+
maxTokens?: number;
|
|
70
|
+
timeoutMs?: number;
|
|
71
|
+
};
|
|
72
|
+
};
|
|
50
73
|
}
|
|
51
74
|
export type { ModelInfo, ToolPolicy };
|