@octopi-agent/engine 0.70.7 → 0.90.11
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 +81 -5
- package/dist/config-schema/context.d.ts +24 -5
- package/dist/config-schema/context.js +28 -1
- package/dist/config-schema/engine.d.ts +205 -13
- package/dist/config-schema/engine.js +31 -2
- package/dist/config-schema/governance.d.ts +95 -0
- package/dist/config-schema/governance.js +93 -1
- package/dist/config-schema/models.d.ts +3 -3
- 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 +13 -0
- package/dist/config-schema/shared.js +22 -0
- package/dist/config-schema/substrate.d.ts +2 -2
- package/dist/config-schema/subsystems.d.ts +1 -1
- package/dist/config-schema/subsystems.js +2 -1
- package/dist/config.d.ts +201 -8
- package/dist/config.js +105 -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 +50 -5
- package/dist/harness/agent/builder.js +189 -59
- package/dist/harness/agent/config-bridge.d.ts +33 -25
- package/dist/harness/agent/config-bridge.js +84 -291
- 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 +46 -0
- package/dist/harness/agent/tool-purpose.js +127 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
- package/dist/harness/agent/wire-agent-builder.js +370 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
- package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
- 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/registry.js +10 -0
- 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-snapshot.d.ts +4 -0
- package/dist/harness/context/layer-snapshot.js +30 -18
- package/dist/harness/context/layer-types.d.ts +85 -1
- package/dist/harness/context/layer-types.js +110 -4
- package/dist/harness/context/layers.d.ts +5 -2
- package/dist/harness/context/layers.js +11 -5
- 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 +30 -0
- package/dist/harness/context/system-prompt-assembler.js +73 -6
- 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 +258 -0
- package/dist/harness/extension/execution-environment/effect-policy.js +358 -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/isolation.js +5 -1
- 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 +521 -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 +1 -1
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -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 +51 -0
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -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 +277 -81
- 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 +241 -70
- package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -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 +6 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
- package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -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 +16 -12
- package/dist/harness/index.js +10 -6
- package/dist/harness/knowledge/file-identity.d.ts +8 -0
- package/dist/harness/knowledge/file-identity.js +26 -1
- 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 +8 -5
- package/dist/harness/knowledge/index-store.d.ts +31 -4
- package/dist/harness/knowledge/index-store.js +121 -39
- package/dist/harness/knowledge/index.d.ts +2 -2
- package/dist/harness/knowledge/index.js +1 -1
- package/dist/harness/knowledge/ingest.d.ts +115 -115
- package/dist/harness/knowledge/ingest.js +154 -151
- package/dist/harness/knowledge/job-control-state.js +4 -4
- package/dist/harness/knowledge/job-control.js +11 -11
- package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
- 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/purge.js +4 -1
- package/dist/harness/knowledge/query-service.js +3 -3
- package/dist/harness/knowledge/writer-service.d.ts +2 -0
- package/dist/harness/knowledge/writer-service.js +14 -13
- package/dist/harness/memory/backfill-coverage.js +3 -1
- package/dist/harness/memory/backfill-trigger.d.ts +2 -2
- package/dist/harness/memory/backfill-trigger.js +4 -4
- package/dist/harness/memory/index.d.ts +1 -0
- package/dist/harness/memory/index.js +1 -0
- package/dist/harness/memory/sqlite/agent-db.js +2 -0
- 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.js +9 -9
- 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 +12 -0
- package/dist/harness/observability/observer/hub.js +53 -2
- 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 +80 -0
- package/dist/harness/observability/observer/types.js +118 -9
- package/dist/harness/run/agent/agent.d.ts +18 -0
- package/dist/harness/run/agent/agent.js +26 -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 +110 -18
- 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 +117 -16
- package/dist/harness/run/runner.js +668 -157
- package/dist/harness/session/attachments/llm-intent.js +17 -17
- package/dist/harness/session/history/port.js +16 -5
- package/dist/harness/session/in-memory-store.d.ts +6 -0
- package/dist/harness/session/in-memory-store.js +55 -3
- 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.js +25 -9
- package/dist/harness/session/types.d.ts +35 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
- package/dist/harness/shared/events/agent-event-map.js +2 -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/observability/run-telemetry.d.ts +8 -0
- package/dist/integration/observability/run-telemetry.js +31 -8
- package/dist/integration/observability/trace-collector.js +26 -4
- package/dist/integration/observability/trace-events.d.ts +1 -0
- package/dist/integration/observability/trace-events.js +2 -0
- package/dist/integration/observability/trace-logger.js +27 -17
- 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 +29 -0
- package/dist/integration/storage/jsonl.js +243 -41
- package/dist/integration/storage/session-index.js +63 -8
- package/dist/paths.d.ts +19 -0
- package/dist/paths.js +38 -1
- package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
- package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
- package/dist/subsystems/safety-guard/config.yaml +3 -1
- package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
- package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
- package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
- 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
|
@@ -3,23 +3,23 @@
|
|
|
3
3
|
*
|
|
4
4
|
* 只决定注入形态;失败/超时由 resolveInjectPlan fail-open。
|
|
5
5
|
*/
|
|
6
|
-
const INTENT_SYSTEM = `You triage how to open uploaded attachments for an agent.
|
|
7
|
-
Return ONLY a compact JSON object, no prose.
|
|
8
|
-
|
|
9
|
-
Schema:
|
|
10
|
-
{
|
|
11
|
-
"mode": "structure_tools" | "recall_tools" | "overview_tools",
|
|
12
|
-
"focus": "<short retrieval phrase or empty>",
|
|
13
|
-
"targets": ["<attachment name>", ...] or empty,
|
|
14
|
-
"reason": "<one short sentence>"
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
Rules:
|
|
18
|
-
- structure_tools: task needs most of the document(s) (summarize/translate/review whole file).
|
|
19
|
-
- recall_tools: task is about a local topic; set focus to a short search phrase (keep entity names).
|
|
20
|
-
- overview_tools: intent is vague or multi-interpret.
|
|
21
|
-
- Do NOT classify as whole-doc just because a word like "翻译/translate" appears in a filename (e.g. "翻译稿" is a document title).
|
|
22
|
-
- Prefer recall/structure over injecting full text when documents are long.
|
|
6
|
+
const INTENT_SYSTEM = `You triage how to open uploaded attachments for an agent.
|
|
7
|
+
Return ONLY a compact JSON object, no prose.
|
|
8
|
+
|
|
9
|
+
Schema:
|
|
10
|
+
{
|
|
11
|
+
"mode": "structure_tools" | "recall_tools" | "overview_tools",
|
|
12
|
+
"focus": "<short retrieval phrase or empty>",
|
|
13
|
+
"targets": ["<attachment name>", ...] or empty,
|
|
14
|
+
"reason": "<one short sentence>"
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
Rules:
|
|
18
|
+
- structure_tools: task needs most of the document(s) (summarize/translate/review whole file).
|
|
19
|
+
- recall_tools: task is about a local topic; set focus to a short search phrase (keep entity names).
|
|
20
|
+
- overview_tools: intent is vague or multi-interpret.
|
|
21
|
+
- Do NOT classify as whole-doc just because a word like "翻译/translate" appears in a filename (e.g. "翻译稿" is a document title).
|
|
22
|
+
- Prefer recall/structure over injecting full text when documents are long.
|
|
23
23
|
- targets lists only attachment names involved when the user clearly means specific files.`;
|
|
24
24
|
/**
|
|
25
25
|
* 用 ModelProvider 做一次短 chat 的意图分流
|
|
@@ -11,6 +11,7 @@ import { join } from 'node:path';
|
|
|
11
11
|
import { computeEffectiveRights } from '../../governance/session-acl/rights.js';
|
|
12
12
|
import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
13
13
|
import { formatHistoryRef, parseHistoryRef, messageText } from './types.js';
|
|
14
|
+
import { isChatReplayHidden } from '../../context/layer-types.js';
|
|
14
15
|
import { applyRoleWeight, authorAllows, extractSearchableFields, makeSnippet, matchFields, sessionScore, } from './score.js';
|
|
15
16
|
const gunzipAsync = promisify(gunzip);
|
|
16
17
|
/**
|
|
@@ -55,6 +56,7 @@ export function resolveHistoryAccess(acl, session, agentId, agentMax) {
|
|
|
55
56
|
writeMemory: true,
|
|
56
57
|
canManageTasks: true,
|
|
57
58
|
canHandoff: false,
|
|
59
|
+
toolRights: { allow: undefined, deny: [], denyCapabilities: [] },
|
|
58
60
|
};
|
|
59
61
|
const rights = computeEffectiveRights({
|
|
60
62
|
role: { id: 'owner', defaults: ownerDefaults, max: ownerDefaults },
|
|
@@ -386,6 +388,15 @@ class DefaultSessionHistoryPort {
|
|
|
386
388
|
visibleMessages(session, agentId) {
|
|
387
389
|
const all = session.messages ?? [];
|
|
388
390
|
const indexed = all.map((message, index) => ({ index, message }));
|
|
391
|
+
// 聊天回放隐藏面(turn_end 载体 / 托管 systemPrompt…)不得作为 user/system 命中露出——
|
|
392
|
+
// 与 observer / ConversationAdapter 同一谓词(layer-types isChatReplayHidden)
|
|
393
|
+
const visible = indexed.filter(({ message }) => !isChatReplayHidden({
|
|
394
|
+
role: message.role,
|
|
395
|
+
source: typeof message.metadata?.source === 'string'
|
|
396
|
+
? String(message.metadata.source)
|
|
397
|
+
: undefined,
|
|
398
|
+
text: messageText(message),
|
|
399
|
+
}));
|
|
389
400
|
const scope = this.options.historyScope ?? 'participated';
|
|
390
401
|
if (scope === 'participated' && agentId) {
|
|
391
402
|
const pick = {
|
|
@@ -400,7 +411,7 @@ class DefaultSessionHistoryPort {
|
|
|
400
411
|
}
|
|
401
412
|
const acl = this.options.sessionAcl;
|
|
402
413
|
if (!acl || !agentId)
|
|
403
|
-
return
|
|
414
|
+
return visible;
|
|
404
415
|
const access = resolveHistoryAccess(acl, session, agentId, this.options.resolveAgentMax?.(agentId));
|
|
405
416
|
if (!access)
|
|
406
417
|
return [];
|
|
@@ -409,7 +420,7 @@ class DefaultSessionHistoryPort {
|
|
|
409
420
|
case 'none':
|
|
410
421
|
return [];
|
|
411
422
|
case 'full':
|
|
412
|
-
return
|
|
423
|
+
return visible;
|
|
413
424
|
case 'from_grant': {
|
|
414
425
|
const participant = access.participant;
|
|
415
426
|
// 缺 seq/at 一律 fail-closed(E6)
|
|
@@ -417,12 +428,12 @@ class DefaultSessionHistoryPort {
|
|
|
417
428
|
return [];
|
|
418
429
|
}
|
|
419
430
|
const at = participant.grantedAt;
|
|
420
|
-
return
|
|
431
|
+
return visible.filter(({ message }) => (message.timestamp ?? 0) >= at);
|
|
421
432
|
}
|
|
422
433
|
case 'summary_tail':
|
|
423
|
-
return
|
|
434
|
+
return visible.slice(-20);
|
|
424
435
|
default:
|
|
425
|
-
return
|
|
436
|
+
return visible;
|
|
426
437
|
}
|
|
427
438
|
}
|
|
428
439
|
renderMessage(m, format, includeToolIo) {
|
|
@@ -13,6 +13,12 @@ export declare class InMemorySessionStore implements SessionStore<SessionData> {
|
|
|
13
13
|
private sessions;
|
|
14
14
|
load(sessionId: string): Promise<SessionData | null>;
|
|
15
15
|
save(sessionId: string, data: SessionData): Promise<void>;
|
|
16
|
+
updateMetadata(sessionId: string, mutate: (meta: Record<string, unknown>) => void | Record<string, unknown>): Promise<void>;
|
|
17
|
+
/**
|
|
18
|
+
* 消息序列对齐。契约见 SessionStore.syncMessages;
|
|
19
|
+
* 内存后端直接替换消息数组(与 JsonlSessionStore 同口径:不存在则跳过)。
|
|
20
|
+
*/
|
|
21
|
+
syncMessages(sessionId: string, messages: readonly unknown[]): Promise<void>;
|
|
16
22
|
list(filter?: SessionListFilter): Promise<SessionMeta[]>;
|
|
17
23
|
delete(sessionId: string): Promise<void>;
|
|
18
24
|
exists(sessionId: string): Promise<boolean>;
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @layer harness/session — Session 域纯内存默认实现(非生产落盘后端)。
|
|
8
8
|
*/
|
|
9
|
-
import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
9
|
+
import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
10
10
|
function toIndexPick(s) {
|
|
11
11
|
return {
|
|
12
12
|
agentId: s.agentId ?? s.meta.agentId,
|
|
@@ -19,10 +19,56 @@ function toIndexPick(s) {
|
|
|
19
19
|
export class InMemorySessionStore {
|
|
20
20
|
sessions = new Map();
|
|
21
21
|
async load(sessionId) {
|
|
22
|
-
|
|
22
|
+
const prev = this.sessions.get(sessionId);
|
|
23
|
+
if (!prev)
|
|
24
|
+
return null;
|
|
25
|
+
// 与 JsonlSessionStore.load 同口径:meta 是投影(标题三键权威在 metadata,
|
|
26
|
+
// updateMetadata 写后 load().meta 立即新鲜,与索引后端行为一致)
|
|
27
|
+
return { ...prev, meta: { ...prev.meta, ...readTitleState(prev.metadata) } };
|
|
23
28
|
}
|
|
24
29
|
async save(sessionId, data) {
|
|
25
|
-
this.sessions.
|
|
30
|
+
const prev = this.sessions.get(sessionId);
|
|
31
|
+
// 与 JsonlSessionStore 对齐:已有会话的 metadata 浅合并,删键走 updateMetadata
|
|
32
|
+
const metadata = {
|
|
33
|
+
...(prev?.metadata ?? {}),
|
|
34
|
+
...(data.metadata ?? {}),
|
|
35
|
+
};
|
|
36
|
+
// 与 JsonlSessionStore 对齐:标题三键按 titleUpdatedAt 仲裁,陈旧值不回滚更新写入;
|
|
37
|
+
// incoming 缺时间戳视为陈旧(写端恒打三键),同样归磁盘胜
|
|
38
|
+
const freshTitle = readTitleState(prev?.metadata);
|
|
39
|
+
const incomingTitle = readTitleState(data.metadata);
|
|
40
|
+
if (freshTitle.titleUpdatedAt !== undefined &&
|
|
41
|
+
(incomingTitle.titleUpdatedAt === undefined ||
|
|
42
|
+
incomingTitle.titleUpdatedAt < freshTitle.titleUpdatedAt)) {
|
|
43
|
+
metadata.title = freshTitle.title;
|
|
44
|
+
metadata.titleSource = freshTitle.titleSource;
|
|
45
|
+
metadata.titleUpdatedAt = freshTitle.titleUpdatedAt;
|
|
46
|
+
}
|
|
47
|
+
this.sessions.set(sessionId, { ...data, id: sessionId, metadata });
|
|
48
|
+
}
|
|
49
|
+
async updateMetadata(sessionId, mutate) {
|
|
50
|
+
const prev = this.sessions.get(sessionId);
|
|
51
|
+
if (!prev)
|
|
52
|
+
return;
|
|
53
|
+
const meta = { ...prev.metadata };
|
|
54
|
+
const replaced = mutate(meta);
|
|
55
|
+
this.sessions.set(sessionId, {
|
|
56
|
+
...prev,
|
|
57
|
+
metadata: replaced === undefined ? meta : replaced,
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* 消息序列对齐。契约见 SessionStore.syncMessages;
|
|
62
|
+
* 内存后端直接替换消息数组(与 JsonlSessionStore 同口径:不存在则跳过)。
|
|
63
|
+
*/
|
|
64
|
+
async syncMessages(sessionId, messages) {
|
|
65
|
+
const prev = this.sessions.get(sessionId);
|
|
66
|
+
if (!prev)
|
|
67
|
+
return;
|
|
68
|
+
this.sessions.set(sessionId, {
|
|
69
|
+
...prev,
|
|
70
|
+
messages: messages.slice(),
|
|
71
|
+
});
|
|
26
72
|
}
|
|
27
73
|
async list(filter) {
|
|
28
74
|
const values = Array.from(this.sessions.values());
|
|
@@ -33,6 +79,12 @@ export class InMemorySessionStore {
|
|
|
33
79
|
primaryAgentId: s.primaryAgentId ?? s.meta.primaryAgentId,
|
|
34
80
|
preferredAgentId: s.preferredAgentId ?? s.meta.preferredAgentId,
|
|
35
81
|
participantAgentIds: toIndexPick(s).participantAgentIds,
|
|
82
|
+
// 与 JsonlSessionStore.buildIndexEntry 同规则:置顶权威在 metadata.pinnedAt
|
|
83
|
+
pinnedAt: typeof s.metadata?.pinnedAt === 'number' && Number.isFinite(s.metadata.pinnedAt)
|
|
84
|
+
? s.metadata.pinnedAt
|
|
85
|
+
: s.meta.pinnedAt,
|
|
86
|
+
// 与 JsonlSessionStore.buildIndexEntry 同规则:标题权威在 metadata 三键(无旧数据回退)
|
|
87
|
+
...readTitleState(s.metadata),
|
|
36
88
|
}));
|
|
37
89
|
}
|
|
38
90
|
async delete(sessionId) {
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session schedules — Agent 自发起定时(timer_* / schedule_*)
|
|
3
|
+
*
|
|
4
|
+
* 见 arch/session-schedules.md。
|
|
5
|
+
*/
|
|
6
|
+
export { ACTIVE_SCHEDULE_STATUSES, TERMINAL_SCHEDULE_STATUSES, SCHEDULE_TRANSITIONS, assertTransition, canTransition, isScheduleActiveish, parseDurationMs, type ScheduleCatchUp, type ScheduleDelivery, type SessionSchedule, type SessionScheduleCreateInput, type SessionScheduleKind, type SessionSchedulePayload, type SessionScheduleStatus, } from './types.js';
|
|
7
|
+
export { SessionScheduleStore, buildScheduleRecord, type SessionScheduleStoreOptions, } from './store.js';
|
|
8
|
+
export { SessionScheduleService, parseFireAt, scheduleIsOpen, type SessionScheduleServiceOptions, type SessionScheduleWakeup, type SessionScheduleNotify, type ScheduleTimeSpec, } from './service.js';
|
|
9
|
+
export { renderSessionSchedulesInjection } from './render.js';
|
|
10
|
+
export { createSessionScheduleTools, createTimerWaitTool, createTimerCancelTool, createScheduleSetTool, createScheduleUpdateTool, createScheduleListTool, createScheduleCancelTool, createSchedulePauseTool, createScheduleResumeTool, type TimerWaitToolOptions, } from './tools.js';
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session schedules — Agent 自发起定时(timer_* / schedule_*)
|
|
3
|
+
*
|
|
4
|
+
* 见 arch/session-schedules.md。
|
|
5
|
+
*/
|
|
6
|
+
export { ACTIVE_SCHEDULE_STATUSES, TERMINAL_SCHEDULE_STATUSES, SCHEDULE_TRANSITIONS, assertTransition, canTransition, isScheduleActiveish, parseDurationMs, } from './types.js';
|
|
7
|
+
export { SessionScheduleStore, buildScheduleRecord, } from './store.js';
|
|
8
|
+
export { SessionScheduleService, parseFireAt, scheduleIsOpen, } from './service.js';
|
|
9
|
+
export { renderSessionSchedulesInjection } from './render.js';
|
|
10
|
+
export { createSessionScheduleTools, createTimerWaitTool, createTimerCancelTool, createScheduleSetTool, createScheduleUpdateTool, createScheduleListTool, createScheduleCancelTool, createSchedulePauseTool, createScheduleResumeTool, } from './tools.js';
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SessionSchedule 注入渲染 — `<session_schedules>`
|
|
3
|
+
*
|
|
4
|
+
* 对齐 renderSessionTasksInjection;直接由 Service 查询结果渲染,不投影进 state.json。
|
|
5
|
+
*/
|
|
6
|
+
import type { SessionSchedule } from './types.js';
|
|
7
|
+
/**
|
|
8
|
+
* 渲染 `<session_schedules>` 注入块。
|
|
9
|
+
*
|
|
10
|
+
* @param schedules - 本会话作业(含 active / paused)
|
|
11
|
+
* @returns 注入字符串;无未闭合作业时返回空串
|
|
12
|
+
*/
|
|
13
|
+
export declare function renderSessionSchedulesInjection(schedules: SessionSchedule[]): string;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SessionSchedule 注入渲染 — `<session_schedules>`
|
|
3
|
+
*
|
|
4
|
+
* 对齐 renderSessionTasksInjection;直接由 Service 查询结果渲染,不投影进 state.json。
|
|
5
|
+
*/
|
|
6
|
+
function formatWhen(ts) {
|
|
7
|
+
try {
|
|
8
|
+
return new Date(ts).toISOString();
|
|
9
|
+
}
|
|
10
|
+
catch {
|
|
11
|
+
return String(ts);
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* 渲染 `<session_schedules>` 注入块。
|
|
16
|
+
*
|
|
17
|
+
* @param schedules - 本会话作业(含 active / paused)
|
|
18
|
+
* @returns 注入字符串;无未闭合作业时返回空串
|
|
19
|
+
*/
|
|
20
|
+
export function renderSessionSchedulesInjection(schedules) {
|
|
21
|
+
const open = schedules
|
|
22
|
+
.filter((s) => s.status === 'active' || s.status === 'paused')
|
|
23
|
+
.sort((a, b) => a.nextFireAt - b.nextFireAt || a.createdBy.at - b.createdBy.at);
|
|
24
|
+
if (open.length === 0)
|
|
25
|
+
return '';
|
|
26
|
+
const lines = [
|
|
27
|
+
'<session_schedules>',
|
|
28
|
+
'当前会话未闭合的定时作业:',
|
|
29
|
+
'',
|
|
30
|
+
];
|
|
31
|
+
for (const s of open) {
|
|
32
|
+
const title = s.payload.title
|
|
33
|
+
? `「${s.payload.title}」`
|
|
34
|
+
: `「${s.payload.text.slice(0, 40)}」`;
|
|
35
|
+
const rhythm = s.kind === 'once'
|
|
36
|
+
? `once @ ${formatWhen(s.fireAt ?? s.nextFireAt)}`
|
|
37
|
+
: s.kind === 'interval'
|
|
38
|
+
? `every ${s.intervalMs}ms`
|
|
39
|
+
: `cron ${s.cron ?? ''}`;
|
|
40
|
+
const runs = s.maxRuns !== undefined
|
|
41
|
+
? `run ${s.runCount}/${s.maxRuns}`
|
|
42
|
+
: `run ${s.runCount}`;
|
|
43
|
+
const whenNote = s.status === 'paused'
|
|
44
|
+
? 'paused,不会自动点火'
|
|
45
|
+
: `next ${formatWhen(s.nextFireAt)}`;
|
|
46
|
+
lines.push(`- [${s.id}] ${s.status} | ${rhythm} | ${runs} | ${whenNote} | ${title}`);
|
|
47
|
+
}
|
|
48
|
+
const hasActive = open.some((s) => s.status === 'active');
|
|
49
|
+
const hasPaused = open.some((s) => s.status === 'paused');
|
|
50
|
+
lines.push('');
|
|
51
|
+
lines.push('说明:');
|
|
52
|
+
if (hasActive) {
|
|
53
|
+
lines.push('- active 作业到点后系统会在本会话自动唤醒并执行事项正文。');
|
|
54
|
+
}
|
|
55
|
+
if (hasPaused) {
|
|
56
|
+
lines.push('- paused 作业**不会**自动点火;恢复请 schedule_resume,取消请 schedule_cancel。');
|
|
57
|
+
}
|
|
58
|
+
lines.push('- **禁止在当前回合执行上述事项**;现在只处理用户当前消息,或直接结束回合。');
|
|
59
|
+
lines.push('- 不必重复 schedule_set 同一事项,除非要改时间或内容。');
|
|
60
|
+
lines.push('- 事项已结束时请 schedule_cancel,避免继续点火。');
|
|
61
|
+
lines.push('</session_schedules>');
|
|
62
|
+
return lines.join('\n');
|
|
63
|
+
}
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SessionScheduleService — 会话日程唯一写入口
|
|
3
|
+
*
|
|
4
|
+
* 职责:
|
|
5
|
+
* - schedules.db 读写与状态机校验
|
|
6
|
+
* - 薄 timer 臂(own setTimeout;禁止 import orchestration TaskScheduler)
|
|
7
|
+
* - 到点先记账再 dispatch Trigger(at-most-once)
|
|
8
|
+
*
|
|
9
|
+
* 见 arch/session-schedules.md。
|
|
10
|
+
*/
|
|
11
|
+
import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
|
|
12
|
+
import type { Trigger } from '../../activation/types.js';
|
|
13
|
+
import { type ScheduleCatchUp, type SessionSchedule, type SessionScheduleCreateInput, type SessionScheduleStatus } from './types.js';
|
|
14
|
+
import { type SessionScheduleStoreOptions } from './store.js';
|
|
15
|
+
/** Node setTimeout 最大 delay(2^31-1);超过会钳成 ~1ms 立刻点火 */
|
|
16
|
+
export declare const MAX_TIMEOUT_MS = 2147483647;
|
|
17
|
+
/** 点火回调:宿主接 AgentRuntime.dispatch;emit 非阻塞 */
|
|
18
|
+
export type SessionScheduleWakeup = (trigger: Trigger, schedule: SessionSchedule) => void;
|
|
19
|
+
/** notify 投递:只落会话消息,不跑模型 */
|
|
20
|
+
export type SessionScheduleNotify = (input: {
|
|
21
|
+
schedule: SessionSchedule;
|
|
22
|
+
content: string;
|
|
23
|
+
}) => void | Promise<void>;
|
|
24
|
+
export interface SessionScheduleServiceOptions extends SessionScheduleStoreOptions {
|
|
25
|
+
events?: EventBus;
|
|
26
|
+
/** 默认 50;0 = 不限制 */
|
|
27
|
+
maxOpenPerSession?: number;
|
|
28
|
+
/** 每小时 wakeup 上限;0 = 不限(默认 120) */
|
|
29
|
+
maxWakesPerHour?: number;
|
|
30
|
+
/** 兜底扫描间隔;0 = 关闭(默认 60s) */
|
|
31
|
+
tickIntervalMs?: number;
|
|
32
|
+
/** 同 coalesceKey 合并窗口;默认 500ms */
|
|
33
|
+
coalesceWindowMs?: number;
|
|
34
|
+
/** 点火后由宿主 dispatch(gateway 挂 AgentRuntime) */
|
|
35
|
+
wakeup?: SessionScheduleWakeup;
|
|
36
|
+
/** delivery=notify 时由宿主写入会话消息 */
|
|
37
|
+
notify?: SessionScheduleNotify;
|
|
38
|
+
}
|
|
39
|
+
/** schedule_set 时间参数(四选一) */
|
|
40
|
+
export interface ScheduleTimeSpec {
|
|
41
|
+
/** 相对延后,如 "2h" / 秒数 */
|
|
42
|
+
delay?: string | number;
|
|
43
|
+
/** 绝对 ISO 时间戳或毫秒 */
|
|
44
|
+
at?: string | number;
|
|
45
|
+
/** 固定间隔,如 "30m" */
|
|
46
|
+
every?: string | number;
|
|
47
|
+
/** 五字段 cron */
|
|
48
|
+
cron?: string;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* 解析绝对时间
|
|
52
|
+
*
|
|
53
|
+
* @param at - ISO 字符串或毫秒时间戳;较小的数字按 Unix 秒解释
|
|
54
|
+
*/
|
|
55
|
+
export declare function parseFireAt(at: string | number): number;
|
|
56
|
+
/**
|
|
57
|
+
* SessionScheduleService
|
|
58
|
+
*/
|
|
59
|
+
export declare class SessionScheduleService {
|
|
60
|
+
private readonly options;
|
|
61
|
+
private timers;
|
|
62
|
+
private firing;
|
|
63
|
+
private opened;
|
|
64
|
+
private wakeup?;
|
|
65
|
+
private notify?;
|
|
66
|
+
private store?;
|
|
67
|
+
private tickTimer?;
|
|
68
|
+
/** 滑动窗口:近 1h wakeup 点火时间戳 */
|
|
69
|
+
private wakeStamps;
|
|
70
|
+
/** coalesceKey → 上次 dispatch 时间 */
|
|
71
|
+
private coalesceSeen;
|
|
72
|
+
constructor(options?: SessionScheduleServiceOptions);
|
|
73
|
+
/**
|
|
74
|
+
* 打开/建库并重臂 active 作业。幂等。
|
|
75
|
+
*/
|
|
76
|
+
open(): Promise<void>;
|
|
77
|
+
/** 兜底扫描:防 timer 丢失(P1) */
|
|
78
|
+
private startTick;
|
|
79
|
+
/**
|
|
80
|
+
* 注入点火宿主(gateway 绑 AgentRuntime.dispatch)
|
|
81
|
+
*
|
|
82
|
+
* @param fn - 非阻塞 dispatch
|
|
83
|
+
*/
|
|
84
|
+
setWakeup(fn: SessionScheduleWakeup): void;
|
|
85
|
+
/**
|
|
86
|
+
* 注入 notify 宿主(只写会话消息)
|
|
87
|
+
*
|
|
88
|
+
* @param fn - 写入回调
|
|
89
|
+
*/
|
|
90
|
+
setNotify(fn: SessionScheduleNotify): void;
|
|
91
|
+
/** 拆光 timer 并关库(gateway.stop) */
|
|
92
|
+
dispose(): void;
|
|
93
|
+
private requireStore;
|
|
94
|
+
private emitEvent;
|
|
95
|
+
private resolveSpec;
|
|
96
|
+
private computeNextFireAt;
|
|
97
|
+
/**
|
|
98
|
+
* 列出作业
|
|
99
|
+
*
|
|
100
|
+
* @param sessionId - 会话 id
|
|
101
|
+
* @param filter - status / activeOnly
|
|
102
|
+
*/
|
|
103
|
+
list(sessionId: string, filter?: {
|
|
104
|
+
status?: SessionScheduleStatus;
|
|
105
|
+
activeOnly?: boolean;
|
|
106
|
+
}): SessionSchedule[];
|
|
107
|
+
/**
|
|
108
|
+
* 按 id 取作业
|
|
109
|
+
*
|
|
110
|
+
* @param id - ScheduleId
|
|
111
|
+
*/
|
|
112
|
+
get(id: string): SessionSchedule | null;
|
|
113
|
+
/**
|
|
114
|
+
* 登记作业并 arm
|
|
115
|
+
*
|
|
116
|
+
* @param input - 创建入参 + 时间四选一
|
|
117
|
+
*/
|
|
118
|
+
set(input: {
|
|
119
|
+
sessionId: string;
|
|
120
|
+
agentId: string;
|
|
121
|
+
payload: SessionScheduleCreateInput['payload'];
|
|
122
|
+
maxRuns?: number;
|
|
123
|
+
coalesceKey?: string;
|
|
124
|
+
catchUp?: ScheduleCatchUp;
|
|
125
|
+
createdByRunId?: string;
|
|
126
|
+
} & ScheduleTimeSpec): Promise<SessionSchedule>;
|
|
127
|
+
/**
|
|
128
|
+
* 取消作业
|
|
129
|
+
*
|
|
130
|
+
* @param id - ScheduleId
|
|
131
|
+
*/
|
|
132
|
+
cancel(id: string, _reason?: string): SessionSchedule;
|
|
133
|
+
/**
|
|
134
|
+
* 暂停
|
|
135
|
+
*
|
|
136
|
+
* @param id - ScheduleId
|
|
137
|
+
*/
|
|
138
|
+
pause(id: string): SessionSchedule;
|
|
139
|
+
/**
|
|
140
|
+
* 恢复(re-arm 时套用 catchUp)
|
|
141
|
+
*
|
|
142
|
+
* @param id - ScheduleId
|
|
143
|
+
*/
|
|
144
|
+
resume(id: string): SessionSchedule;
|
|
145
|
+
/**
|
|
146
|
+
* 修改作业(prompt / title / max_runs / 时间 / catch_up)
|
|
147
|
+
* 仅 active|paused;改时间后重算 nextFireAt 并 re-arm。
|
|
148
|
+
*
|
|
149
|
+
* @param id - ScheduleId
|
|
150
|
+
* @param patch - 可选字段
|
|
151
|
+
*/
|
|
152
|
+
update(id: string, patch: {
|
|
153
|
+
prompt?: string;
|
|
154
|
+
title?: string;
|
|
155
|
+
maxRuns?: number | null;
|
|
156
|
+
catchUp?: ScheduleCatchUp;
|
|
157
|
+
time?: ScheduleTimeSpec;
|
|
158
|
+
}): SessionSchedule;
|
|
159
|
+
/**
|
|
160
|
+
* 会话删除清理
|
|
161
|
+
*
|
|
162
|
+
* @param sessionId - 会话 id
|
|
163
|
+
*/
|
|
164
|
+
purgeSession(sessionId: string): number;
|
|
165
|
+
private disarm;
|
|
166
|
+
private arm;
|
|
167
|
+
private rearmAll;
|
|
168
|
+
/** 测试/手动触发(穿冷却语义:仅 active) */
|
|
169
|
+
runNow(id: string): Promise<void>;
|
|
170
|
+
private onDue;
|
|
171
|
+
private shouldCoalesce;
|
|
172
|
+
private noteCoalesce;
|
|
173
|
+
private wakeLimitExceeded;
|
|
174
|
+
private noteWake;
|
|
175
|
+
private toTrigger;
|
|
176
|
+
}
|
|
177
|
+
/** 未闭合判断(list/注入用) */
|
|
178
|
+
export declare function scheduleIsOpen(status: SessionScheduleStatus): boolean;
|
|
179
|
+
export type { ScheduleCatchUp };
|