@dcyfr/ai 1.0.4 → 2.1.0
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/CHANGELOG.md +106 -0
- package/README.md +381 -9
- package/dist/ai/agents/agent-loader.d.ts +12 -0
- package/dist/ai/agents/agent-loader.d.ts.map +1 -1
- package/dist/ai/agents/agent-loader.js +74 -65
- package/dist/ai/agents/agent-loader.js.map +1 -1
- package/dist/ai/agents/agent-registry.d.ts +2 -0
- package/dist/ai/agents/agent-registry.d.ts.map +1 -1
- package/dist/ai/agents/agent-registry.js +15 -14
- package/dist/ai/agents/agent-registry.js.map +1 -1
- package/dist/ai/agents/agent-router.d.ts +20 -5
- package/dist/ai/agents/agent-router.d.ts.map +1 -1
- package/dist/ai/agents/agent-router.js +89 -43
- package/dist/ai/agents/agent-router.js.map +1 -1
- package/dist/ai/agents/index.d.ts +6 -1
- package/dist/ai/agents/index.d.ts.map +1 -1
- package/dist/ai/agents/index.js +9 -3
- package/dist/ai/agents/index.js.map +1 -1
- package/dist/ai/agents/instruction-template.d.ts +45 -0
- package/dist/ai/agents/instruction-template.d.ts.map +1 -0
- package/dist/ai/agents/instruction-template.js +197 -0
- package/dist/ai/agents/instruction-template.js.map +1 -0
- package/dist/ai/agents/persona-resolver.d.ts +90 -0
- package/dist/ai/agents/persona-resolver.d.ts.map +1 -0
- package/dist/ai/agents/persona-resolver.js +121 -0
- package/dist/ai/agents/persona-resolver.js.map +1 -0
- package/dist/ai/agents/schema.d.ts +166 -0
- package/dist/ai/agents/schema.d.ts.map +1 -0
- package/dist/ai/agents/schema.js +94 -0
- package/dist/ai/agents/schema.js.map +1 -0
- package/dist/ai/agents/types.d.ts +102 -0
- package/dist/ai/agents/types.d.ts.map +1 -1
- package/dist/ai/agents-builtin/architecture/index.js +3 -3
- package/dist/ai/agents-builtin/content/index.js +1 -1
- package/dist/ai/agents-builtin/data/index.js +1 -1
- package/dist/ai/agents-builtin/development/index.js +4 -4
- package/dist/ai/agents-builtin/devops/index.js +1 -1
- package/dist/ai/agents-builtin/index.js +33 -33
- package/dist/ai/agents-builtin/performance/index.js +1 -1
- package/dist/ai/agents-builtin/research/index.js +1 -1
- package/dist/ai/agents-builtin/security/index.js +1 -1
- package/dist/ai/agents-builtin/testing/index.js +2 -2
- package/dist/ai/config/loader.d.ts.map +1 -1
- package/dist/ai/config/loader.js +6 -3
- package/dist/ai/config/loader.js.map +1 -1
- package/dist/ai/config/schema.d.ts +242 -1156
- package/dist/ai/config/schema.d.ts.map +1 -1
- package/dist/ai/config/schema.js +69 -20
- package/dist/ai/config/schema.js.map +1 -1
- package/dist/ai/core/provider-registry.d.ts +32 -0
- package/dist/ai/core/provider-registry.d.ts.map +1 -1
- package/dist/ai/core/provider-registry.js +189 -14
- package/dist/ai/core/provider-registry.js.map +1 -1
- package/dist/ai/core/telemetry-engine.d.ts +26 -0
- package/dist/ai/core/telemetry-engine.d.ts.map +1 -1
- package/dist/ai/core/telemetry-engine.js +81 -1
- package/dist/ai/core/telemetry-engine.js.map +1 -1
- package/dist/ai/delegation/agent-registry.d.ts +143 -0
- package/dist/ai/delegation/agent-registry.d.ts.map +1 -0
- package/dist/ai/delegation/agent-registry.js +231 -0
- package/dist/ai/delegation/agent-registry.js.map +1 -0
- package/dist/ai/delegation/blast-radius-tracker.d.ts +65 -0
- package/dist/ai/delegation/blast-radius-tracker.d.ts.map +1 -0
- package/dist/ai/delegation/blast-radius-tracker.js +81 -0
- package/dist/ai/delegation/blast-radius-tracker.js.map +1 -0
- package/dist/ai/delegation/capability-bootstrap.d.ts +40 -0
- package/dist/ai/delegation/capability-bootstrap.d.ts.map +1 -0
- package/dist/ai/delegation/capability-bootstrap.js +431 -0
- package/dist/ai/delegation/capability-bootstrap.js.map +1 -0
- package/dist/ai/delegation/capability-registry.d.ts +81 -0
- package/dist/ai/delegation/capability-registry.d.ts.map +1 -0
- package/dist/ai/delegation/capability-registry.js +339 -0
- package/dist/ai/delegation/capability-registry.js.map +1 -0
- package/dist/ai/delegation/chain-tracker.d.ts +152 -0
- package/dist/ai/delegation/chain-tracker.d.ts.map +1 -0
- package/dist/ai/delegation/chain-tracker.js +336 -0
- package/dist/ai/delegation/chain-tracker.js.map +1 -0
- package/dist/ai/delegation/circuit-breaker.d.ts +59 -0
- package/dist/ai/delegation/circuit-breaker.d.ts.map +1 -0
- package/dist/ai/delegation/circuit-breaker.js +153 -0
- package/dist/ai/delegation/circuit-breaker.js.map +1 -0
- package/dist/ai/delegation/contract-manager.d.ts +415 -0
- package/dist/ai/delegation/contract-manager.d.ts.map +1 -0
- package/dist/ai/delegation/contract-manager.js +1258 -0
- package/dist/ai/delegation/contract-manager.js.map +1 -0
- package/dist/ai/delegation/delegation-manager.d.ts +505 -0
- package/dist/ai/delegation/delegation-manager.d.ts.map +1 -0
- package/dist/ai/delegation/delegation-manager.js +773 -0
- package/dist/ai/delegation/delegation-manager.js.map +1 -0
- package/dist/ai/delegation/event-schemas.d.ts +101 -0
- package/dist/ai/delegation/event-schemas.d.ts.map +1 -0
- package/dist/ai/delegation/event-schemas.js +59 -0
- package/dist/ai/delegation/event-schemas.js.map +1 -0
- package/dist/ai/delegation/execution-mode-dashboard.d.ts +109 -0
- package/dist/ai/delegation/execution-mode-dashboard.d.ts.map +1 -0
- package/dist/ai/delegation/execution-mode-dashboard.js +167 -0
- package/dist/ai/delegation/execution-mode-dashboard.js.map +1 -0
- package/dist/ai/delegation/feature-flags.d.ts +191 -0
- package/dist/ai/delegation/feature-flags.d.ts.map +1 -0
- package/dist/ai/delegation/feature-flags.js +332 -0
- package/dist/ai/delegation/feature-flags.js.map +1 -0
- package/dist/ai/delegation/index.d.ts +51 -0
- package/dist/ai/delegation/index.d.ts.map +1 -0
- package/dist/ai/delegation/index.js +39 -0
- package/dist/ai/delegation/index.js.map +1 -0
- package/dist/ai/delegation/middleware/chain-depth-middleware.d.ts +39 -0
- package/dist/ai/delegation/middleware/chain-depth-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/chain-depth-middleware.js +77 -0
- package/dist/ai/delegation/middleware/chain-depth-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/chain-tracker-middleware.d.ts +46 -0
- package/dist/ai/delegation/middleware/chain-tracker-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/chain-tracker-middleware.js +89 -0
- package/dist/ai/delegation/middleware/chain-tracker-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/content-policy-middleware.d.ts +31 -0
- package/dist/ai/delegation/middleware/content-policy-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/content-policy-middleware.js +82 -0
- package/dist/ai/delegation/middleware/content-policy-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/feature-flag-middleware.d.ts +46 -0
- package/dist/ai/delegation/middleware/feature-flag-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/feature-flag-middleware.js +59 -0
- package/dist/ai/delegation/middleware/feature-flag-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/identity-middleware.d.ts +23 -0
- package/dist/ai/delegation/middleware/identity-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/identity-middleware.js +64 -0
- package/dist/ai/delegation/middleware/identity-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/permissions-middleware.d.ts +48 -0
- package/dist/ai/delegation/middleware/permissions-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/permissions-middleware.js +107 -0
- package/dist/ai/delegation/middleware/permissions-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/rate-limiter-middleware.d.ts +38 -0
- package/dist/ai/delegation/middleware/rate-limiter-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/rate-limiter-middleware.js +65 -0
- package/dist/ai/delegation/middleware/rate-limiter-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/reputation-middleware.d.ts +39 -0
- package/dist/ai/delegation/middleware/reputation-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/reputation-middleware.js +75 -0
- package/dist/ai/delegation/middleware/reputation-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/resource-limiter-middleware.d.ts +52 -0
- package/dist/ai/delegation/middleware/resource-limiter-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/resource-limiter-middleware.js +112 -0
- package/dist/ai/delegation/middleware/resource-limiter-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/threat-validator-middleware.d.ts +23 -0
- package/dist/ai/delegation/middleware/threat-validator-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/threat-validator-middleware.js +83 -0
- package/dist/ai/delegation/middleware/threat-validator-middleware.js.map +1 -0
- package/dist/ai/delegation/middleware/tlp-middleware.d.ts +23 -0
- package/dist/ai/delegation/middleware/tlp-middleware.d.ts.map +1 -0
- package/dist/ai/delegation/middleware/tlp-middleware.js +59 -0
- package/dist/ai/delegation/middleware/tlp-middleware.js.map +1 -0
- package/dist/ai/delegation/monitoring.d.ts +298 -0
- package/dist/ai/delegation/monitoring.d.ts.map +1 -0
- package/dist/ai/delegation/monitoring.js +584 -0
- package/dist/ai/delegation/monitoring.js.map +1 -0
- package/dist/ai/delegation/security-middleware-chain.d.ts +71 -0
- package/dist/ai/delegation/security-middleware-chain.d.ts.map +1 -0
- package/dist/ai/delegation/security-middleware-chain.js +163 -0
- package/dist/ai/delegation/security-middleware-chain.js.map +1 -0
- package/dist/ai/delegation/session-checkpoint.d.ts +77 -0
- package/dist/ai/delegation/session-checkpoint.d.ts.map +1 -0
- package/dist/ai/delegation/session-checkpoint.js +131 -0
- package/dist/ai/delegation/session-checkpoint.js.map +1 -0
- package/dist/ai/delegation/session-manager.d.ts +131 -0
- package/dist/ai/delegation/session-manager.d.ts.map +1 -0
- package/dist/ai/delegation/session-manager.js +243 -0
- package/dist/ai/delegation/session-manager.js.map +1 -0
- package/dist/ai/delegation/session-queue.d.ts +95 -0
- package/dist/ai/delegation/session-queue.d.ts.map +1 -0
- package/dist/ai/delegation/session-queue.js +136 -0
- package/dist/ai/delegation/session-queue.js.map +1 -0
- package/dist/ai/delegation/timeout-watchdog.d.ts +60 -0
- package/dist/ai/delegation/timeout-watchdog.d.ts.map +1 -0
- package/dist/ai/delegation/timeout-watchdog.js +100 -0
- package/dist/ai/delegation/timeout-watchdog.js.map +1 -0
- package/dist/ai/examples/integration-demo.d.ts +27 -0
- package/dist/ai/examples/integration-demo.d.ts.map +1 -0
- package/dist/ai/examples/integration-demo.js +536 -0
- package/dist/ai/examples/integration-demo.js.map +1 -0
- package/dist/ai/index.d.ts +25 -0
- package/dist/ai/index.d.ts.map +1 -1
- package/dist/ai/index.js +31 -11
- package/dist/ai/index.js.map +1 -1
- package/dist/ai/mcp/servers/analytics/index.js +67 -11
- package/dist/ai/mcp/servers/analytics/index.js.map +1 -1
- package/dist/ai/mcp/servers/content-manager/index.d.ts.map +1 -1
- package/dist/ai/mcp/servers/content-manager/index.js +50 -4
- package/dist/ai/mcp/servers/content-manager/index.js.map +1 -1
- package/dist/ai/mcp/servers/delegation-monitor/index.d.ts +36 -0
- package/dist/ai/mcp/servers/delegation-monitor/index.d.ts.map +1 -0
- package/dist/ai/mcp/servers/delegation-monitor/index.js +757 -0
- package/dist/ai/mcp/servers/delegation-monitor/index.js.map +1 -0
- package/dist/ai/mcp/servers/design-tokens/index.d.ts.map +1 -1
- package/dist/ai/mcp/servers/design-tokens/index.js +62 -39
- package/dist/ai/mcp/servers/design-tokens/index.js.map +1 -1
- package/dist/ai/mcp/servers/promptintel/index.js +15 -3
- package/dist/ai/mcp/servers/promptintel/index.js.map +1 -1
- package/dist/ai/mcp/servers/shared/rate-limiter.d.ts.map +1 -1
- package/dist/ai/mcp/servers/shared/rate-limiter.js +3 -1
- package/dist/ai/mcp/servers/shared/rate-limiter.js.map +1 -1
- package/dist/ai/mcp/servers/shared/redis-client.d.ts.map +1 -1
- package/dist/ai/mcp/servers/shared/redis-client.js +54 -47
- package/dist/ai/mcp/servers/shared/redis-client.js.map +1 -1
- package/dist/ai/mcp/servers/shared/types.d.ts +9 -0
- package/dist/ai/mcp/servers/shared/types.d.ts.map +1 -1
- package/dist/ai/mcp/servers/shared/utils.d.ts +9 -1
- package/dist/ai/mcp/servers/shared/utils.d.ts.map +1 -1
- package/dist/ai/mcp/servers/shared/utils.js +52 -2
- package/dist/ai/mcp/servers/shared/utils.js.map +1 -1
- package/dist/ai/memory/config.d.ts +18 -3
- package/dist/ai/memory/config.d.ts.map +1 -1
- package/dist/ai/memory/config.js +61 -15
- package/dist/ai/memory/config.js.map +1 -1
- package/dist/ai/memory/dcyfr-memory.d.ts +4 -0
- package/dist/ai/memory/dcyfr-memory.d.ts.map +1 -1
- package/dist/ai/memory/dcyfr-memory.js +44 -6
- package/dist/ai/memory/dcyfr-memory.js.map +1 -1
- package/dist/ai/memory/mem0-client.d.ts.map +1 -1
- package/dist/ai/memory/mem0-client.js +53 -14
- package/dist/ai/memory/mem0-client.js.map +1 -1
- package/dist/ai/permissions/attenuation-engine.d.ts +159 -0
- package/dist/ai/permissions/attenuation-engine.d.ts.map +1 -0
- package/dist/ai/permissions/attenuation-engine.js +511 -0
- package/dist/ai/permissions/attenuation-engine.js.map +1 -0
- package/dist/ai/plugins/plugin-loader.d.ts +4 -0
- package/dist/ai/plugins/plugin-loader.d.ts.map +1 -1
- package/dist/ai/plugins/plugin-loader.js +28 -28
- package/dist/ai/plugins/plugin-loader.js.map +1 -1
- package/dist/ai/reputation/execution-mode-reputation.d.ts +104 -0
- package/dist/ai/reputation/execution-mode-reputation.d.ts.map +1 -0
- package/dist/ai/reputation/execution-mode-reputation.js +142 -0
- package/dist/ai/reputation/execution-mode-reputation.js.map +1 -0
- package/dist/ai/reputation/reputation-engine.d.ts +204 -0
- package/dist/ai/reputation/reputation-engine.d.ts.map +1 -0
- package/dist/ai/reputation/reputation-engine.js +426 -0
- package/dist/ai/reputation/reputation-engine.js.map +1 -0
- package/dist/ai/runtime/agent-runtime.d.ts +193 -0
- package/dist/ai/runtime/agent-runtime.d.ts.map +1 -0
- package/dist/ai/runtime/agent-runtime.js +1009 -0
- package/dist/ai/runtime/agent-runtime.js.map +1 -0
- package/dist/ai/runtime/index.d.ts +11 -0
- package/dist/ai/runtime/index.d.ts.map +1 -0
- package/dist/ai/runtime/index.js +9 -0
- package/dist/ai/runtime/index.js.map +1 -0
- package/dist/ai/runtime/telemetry-schema.d.ts +192 -0
- package/dist/ai/runtime/telemetry-schema.d.ts.map +1 -0
- package/dist/ai/runtime/telemetry-schema.js +200 -0
- package/dist/ai/runtime/telemetry-schema.js.map +1 -0
- package/dist/ai/runtime/types.d.ts +236 -0
- package/dist/ai/runtime/types.d.ts.map +1 -0
- package/dist/ai/runtime/types.js +10 -0
- package/dist/ai/runtime/types.js.map +1 -0
- package/dist/ai/src/batch-processor.d.ts +298 -0
- package/dist/ai/src/batch-processor.d.ts.map +1 -0
- package/dist/ai/src/batch-processor.js +520 -0
- package/dist/ai/src/batch-processor.js.map +1 -0
- package/dist/ai/src/capability-bootstrap.d.ts +222 -0
- package/dist/ai/src/capability-bootstrap.d.ts.map +1 -0
- package/dist/ai/src/capability-bootstrap.js +421 -0
- package/dist/ai/src/capability-bootstrap.js.map +1 -0
- package/dist/ai/src/capability-manifest-generator.d.ts +52 -0
- package/dist/ai/src/capability-manifest-generator.d.ts.map +1 -0
- package/dist/ai/src/capability-manifest-generator.js +691 -0
- package/dist/ai/src/capability-manifest-generator.js.map +1 -0
- package/dist/ai/src/capability-registry.d.ts +157 -0
- package/dist/ai/src/capability-registry.d.ts.map +1 -0
- package/dist/ai/src/capability-registry.js +577 -0
- package/dist/ai/src/capability-registry.js.map +1 -0
- package/dist/ai/src/cli/telemetry-dashboard.d.ts +132 -0
- package/dist/ai/src/cli/telemetry-dashboard.d.ts.map +1 -0
- package/dist/ai/src/cli/telemetry-dashboard.js +565 -0
- package/dist/ai/src/cli/telemetry-dashboard.js.map +1 -0
- package/dist/ai/src/delegation/feature-flags.d.ts +213 -0
- package/dist/ai/src/delegation/feature-flags.d.ts.map +1 -0
- package/dist/ai/src/delegation/feature-flags.js +395 -0
- package/dist/ai/src/delegation/feature-flags.js.map +1 -0
- package/dist/ai/src/delegation/liability-firebreak.d.ts +303 -0
- package/dist/ai/src/delegation/liability-firebreak.d.ts.map +1 -0
- package/dist/ai/src/delegation/liability-firebreak.js +643 -0
- package/dist/ai/src/delegation/liability-firebreak.js.map +1 -0
- package/dist/ai/src/delegation/security-threat-model.d.ts +171 -0
- package/dist/ai/src/delegation/security-threat-model.d.ts.map +1 -0
- package/dist/ai/src/delegation/security-threat-model.js +723 -0
- package/dist/ai/src/delegation/security-threat-model.js.map +1 -0
- package/dist/ai/src/delegation/tlp-enforcement.d.ts +146 -0
- package/dist/ai/src/delegation/tlp-enforcement.d.ts.map +1 -0
- package/dist/ai/src/delegation/tlp-enforcement.js +382 -0
- package/dist/ai/src/delegation/tlp-enforcement.js.map +1 -0
- package/dist/ai/src/delegation-capability-integration.d.ts +154 -0
- package/dist/ai/src/delegation-capability-integration.d.ts.map +1 -0
- package/dist/ai/src/delegation-capability-integration.js +351 -0
- package/dist/ai/src/delegation-capability-integration.js.map +1 -0
- package/dist/ai/src/end-to-end-workflow-orchestrator.d.ts +325 -0
- package/dist/ai/src/end-to-end-workflow-orchestrator.d.ts.map +1 -0
- package/dist/ai/src/end-to-end-workflow-orchestrator.js +801 -0
- package/dist/ai/src/end-to-end-workflow-orchestrator.js.map +1 -0
- package/dist/ai/src/enhanced-capability-detection.d.ts +237 -0
- package/dist/ai/src/enhanced-capability-detection.d.ts.map +1 -0
- package/dist/ai/src/enhanced-capability-detection.js +448 -0
- package/dist/ai/src/enhanced-capability-detection.js.map +1 -0
- package/dist/ai/src/intelligent-cache-manager.d.ts +327 -0
- package/dist/ai/src/intelligent-cache-manager.d.ts.map +1 -0
- package/dist/ai/src/intelligent-cache-manager.js +634 -0
- package/dist/ai/src/intelligent-cache-manager.js.map +1 -0
- package/dist/ai/src/mcp-auto-configuration.d.ts +232 -0
- package/dist/ai/src/mcp-auto-configuration.d.ts.map +1 -0
- package/dist/ai/src/mcp-auto-configuration.js +445 -0
- package/dist/ai/src/mcp-auto-configuration.js.map +1 -0
- package/dist/ai/src/performance-profiler.d.ts +351 -0
- package/dist/ai/src/performance-profiler.d.ts.map +1 -0
- package/dist/ai/src/performance-profiler.js +475 -0
- package/dist/ai/src/performance-profiler.js.map +1 -0
- package/dist/ai/src/personas/hooks/before-llm-call.d.ts +96 -0
- package/dist/ai/src/personas/hooks/before-llm-call.d.ts.map +1 -0
- package/dist/ai/src/personas/hooks/before-llm-call.js +83 -0
- package/dist/ai/src/personas/hooks/before-llm-call.js.map +1 -0
- package/dist/ai/src/personas/index.d.ts +10 -0
- package/dist/ai/src/personas/index.d.ts.map +1 -0
- package/dist/ai/src/personas/index.js +10 -0
- package/dist/ai/src/personas/index.js.map +1 -0
- package/dist/ai/src/personas/persona-loader.d.ts +42 -0
- package/dist/ai/src/personas/persona-loader.d.ts.map +1 -0
- package/dist/ai/src/personas/persona-loader.js +162 -0
- package/dist/ai/src/personas/persona-loader.js.map +1 -0
- package/dist/ai/src/personas/types.d.ts +199 -0
- package/dist/ai/src/personas/types.d.ts.map +1 -0
- package/dist/ai/src/personas/types.js +7 -0
- package/dist/ai/src/personas/types.js.map +1 -0
- package/dist/ai/src/personas/voice-resolver.d.ts +40 -0
- package/dist/ai/src/personas/voice-resolver.d.ts.map +1 -0
- package/dist/ai/src/personas/voice-resolver.js +201 -0
- package/dist/ai/src/personas/voice-resolver.js.map +1 -0
- package/dist/ai/src/resource-monitor.d.ts +311 -0
- package/dist/ai/src/resource-monitor.d.ts.map +1 -0
- package/dist/ai/src/resource-monitor.js +475 -0
- package/dist/ai/src/resource-monitor.js.map +1 -0
- package/dist/ai/src/runtime/agent-runtime.d.ts +340 -0
- package/dist/ai/src/runtime/agent-runtime.d.ts.map +1 -0
- package/dist/ai/src/runtime/agent-runtime.js +1084 -0
- package/dist/ai/src/runtime/agent-runtime.js.map +1 -0
- package/dist/ai/src/telemetry/delegation-telemetry.d.ts +287 -0
- package/dist/ai/src/telemetry/delegation-telemetry.d.ts.map +1 -0
- package/dist/ai/src/telemetry/delegation-telemetry.js +389 -0
- package/dist/ai/src/telemetry/delegation-telemetry.js.map +1 -0
- package/dist/ai/src/telemetry/index.d.ts +48 -0
- package/dist/ai/src/telemetry/index.d.ts.map +1 -0
- package/dist/ai/src/telemetry/index.js +48 -0
- package/dist/ai/src/telemetry/index.js.map +1 -0
- package/dist/ai/src/telemetry/runtime-telemetry-integration.d.ts +67 -0
- package/dist/ai/src/telemetry/runtime-telemetry-integration.d.ts.map +1 -0
- package/dist/ai/src/telemetry/runtime-telemetry-integration.js +415 -0
- package/dist/ai/src/telemetry/runtime-telemetry-integration.js.map +1 -0
- package/dist/ai/src/telemetry/telemetry-utils.d.ts +119 -0
- package/dist/ai/src/telemetry/telemetry-utils.d.ts.map +1 -0
- package/dist/ai/src/telemetry/telemetry-utils.js +250 -0
- package/dist/ai/src/telemetry/telemetry-utils.js.map +1 -0
- package/dist/ai/src/types/agent-capabilities.d.ts +227 -0
- package/dist/ai/src/types/agent-capabilities.d.ts.map +1 -0
- package/dist/ai/src/types/agent-capabilities.js +11 -0
- package/dist/ai/src/types/agent-capabilities.js.map +1 -0
- package/dist/ai/src/types/context-verification.d.ts +158 -0
- package/dist/ai/src/types/context-verification.d.ts.map +1 -0
- package/dist/ai/src/types/context-verification.js +73 -0
- package/dist/ai/src/types/context-verification.js.map +1 -0
- package/dist/ai/src/types/delegation-contracts.d.ts +296 -0
- package/dist/ai/src/types/delegation-contracts.d.ts.map +1 -0
- package/dist/ai/src/types/delegation-contracts.js +17 -0
- package/dist/ai/src/types/delegation-contracts.js.map +1 -0
- package/dist/ai/src/validation-pipeline-integration.d.ts +266 -0
- package/dist/ai/src/validation-pipeline-integration.d.ts.map +1 -0
- package/dist/ai/src/validation-pipeline-integration.js +695 -0
- package/dist/ai/src/validation-pipeline-integration.js.map +1 -0
- package/dist/ai/src/verification/multi-modal-formatters.d.ts +57 -0
- package/dist/ai/src/verification/multi-modal-formatters.d.ts.map +1 -0
- package/dist/ai/src/verification/multi-modal-formatters.js +655 -0
- package/dist/ai/src/verification/multi-modal-formatters.js.map +1 -0
- package/dist/ai/src/verification/output-formatter.d.ts +186 -0
- package/dist/ai/src/verification/output-formatter.d.ts.map +1 -0
- package/dist/ai/src/verification/output-formatter.js +296 -0
- package/dist/ai/src/verification/output-formatter.js.map +1 -0
- package/dist/ai/src/verification/parser-integration.d.ts +137 -0
- package/dist/ai/src/verification/parser-integration.d.ts.map +1 -0
- package/dist/ai/src/verification/parser-integration.js +273 -0
- package/dist/ai/src/verification/parser-integration.js.map +1 -0
- package/dist/ai/types/agent-capabilities.d.ts +387 -0
- package/dist/ai/types/agent-capabilities.d.ts.map +1 -0
- package/dist/ai/types/agent-capabilities.js +32 -0
- package/dist/ai/types/agent-capabilities.js.map +1 -0
- package/dist/ai/types/delegation-contracts.d.ts +291 -0
- package/dist/ai/types/delegation-contracts.d.ts.map +1 -0
- package/dist/ai/types/delegation-contracts.js +14 -0
- package/dist/ai/types/delegation-contracts.js.map +1 -0
- package/dist/ai/types/index.d.ts +4 -1
- package/dist/ai/types/index.d.ts.map +1 -1
- package/dist/ai/types/index.js +4 -1
- package/dist/ai/types/index.js.map +1 -1
- package/dist/ai/types/permission-tokens.d.ts +365 -0
- package/dist/ai/types/permission-tokens.d.ts.map +1 -0
- package/dist/ai/types/permission-tokens.js +13 -0
- package/dist/ai/types/permission-tokens.js.map +1 -0
- package/dist/ai/types/security-middleware.d.ts +130 -0
- package/dist/ai/types/security-middleware.d.ts.map +1 -0
- package/dist/ai/types/security-middleware.js +13 -0
- package/dist/ai/types/security-middleware.js.map +1 -0
- package/dist/ai/utils/storage.d.ts.map +1 -1
- package/dist/ai/utils/storage.js +6 -3
- package/dist/ai/utils/storage.js.map +1 -1
- package/dist/ai/validation/validation-framework.js +1 -1
- package/dist/ai/verification/policy-framework.d.ts +161 -0
- package/dist/ai/verification/policy-framework.d.ts.map +1 -0
- package/dist/ai/verification/policy-framework.js +436 -0
- package/dist/ai/verification/policy-framework.js.map +1 -0
- package/package.json +35 -7
|
@@ -0,0 +1,415 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DCYFR Delegation Contract Manager
|
|
3
|
+
* TLP:CLEAR
|
|
4
|
+
*
|
|
5
|
+
* Manages delegation contracts with database persistence, event emission,
|
|
6
|
+
* and lifecycle tracking.
|
|
7
|
+
*
|
|
8
|
+
* @module delegation/contract-manager
|
|
9
|
+
* @version 1.1.0
|
|
10
|
+
* @date 2026-02-15
|
|
11
|
+
*/
|
|
12
|
+
import { EventEmitter } from 'events';
|
|
13
|
+
import type { DelegationContract, DelegationAgent, VerificationResult, DelegationContractStatus, SuccessCriteria } from '../types/delegation-contracts.js';
|
|
14
|
+
import { ExecutionMode } from '../types/agent-capabilities.js';
|
|
15
|
+
import type { AgentCapabilityManifest, SessionHandoffRequest } from '../types/agent-capabilities.js';
|
|
16
|
+
import { SessionCheckpoint } from './session-checkpoint.js';
|
|
17
|
+
import { SessionManager } from './session-manager.js';
|
|
18
|
+
import type { CapabilityRegistry } from './capability-registry.js';
|
|
19
|
+
import { type RateLimiterOptions } from './middleware/rate-limiter-middleware.js';
|
|
20
|
+
import { AgentRegistry } from './agent-registry.js';
|
|
21
|
+
import type { AgentClearance } from '../src/delegation/tlp-enforcement.js';
|
|
22
|
+
import { ReputationEngine } from '../reputation/reputation-engine.js';
|
|
23
|
+
import { DelegationHealthMonitor } from './monitoring.js';
|
|
24
|
+
import { FeatureFlagManager } from './feature-flags.js';
|
|
25
|
+
/**
|
|
26
|
+
* Contract creation request
|
|
27
|
+
*/
|
|
28
|
+
export interface CreateDelegationContractRequest {
|
|
29
|
+
contract_id?: string;
|
|
30
|
+
delegator: DelegationAgent;
|
|
31
|
+
delegatee: DelegationAgent;
|
|
32
|
+
task_id: string;
|
|
33
|
+
task_description: string;
|
|
34
|
+
verification_policy: string;
|
|
35
|
+
success_criteria: SuccessCriteria;
|
|
36
|
+
timeout_ms: number;
|
|
37
|
+
priority?: number;
|
|
38
|
+
permission_tokens?: Array<{
|
|
39
|
+
token_id: string;
|
|
40
|
+
scopes: string[];
|
|
41
|
+
delegatable?: boolean;
|
|
42
|
+
max_delegation_depth?: number;
|
|
43
|
+
}>;
|
|
44
|
+
parent_contract_id?: string;
|
|
45
|
+
tlp_classification?: string;
|
|
46
|
+
status?: DelegationContractStatus;
|
|
47
|
+
created_at?: string;
|
|
48
|
+
/**
|
|
49
|
+
* Execution mode for this contract.
|
|
50
|
+
* Defaults to `ExecutionMode.INTERACTIVE` when omitted.
|
|
51
|
+
* @since 1.1.0
|
|
52
|
+
*/
|
|
53
|
+
execution_mode?: ExecutionMode;
|
|
54
|
+
/**
|
|
55
|
+
* Session identifier to associate with an existing session.
|
|
56
|
+
* Populated automatically for BACKGROUND / ASYNC modes when absent.
|
|
57
|
+
* @since 1.1.0
|
|
58
|
+
*/
|
|
59
|
+
session_id?: string;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Contract query options - supports both full and short field aliases
|
|
63
|
+
*/
|
|
64
|
+
export interface ContractQueryOptions {
|
|
65
|
+
delegator_agent_id?: string;
|
|
66
|
+
delegatee_agent_id?: string;
|
|
67
|
+
/** Alias for delegator_agent_id */
|
|
68
|
+
delegator_id?: string;
|
|
69
|
+
/** Alias for delegatee_agent_id */
|
|
70
|
+
delegatee_id?: string;
|
|
71
|
+
task_id?: string;
|
|
72
|
+
status?: DelegationContractStatus | DelegationContractStatus[];
|
|
73
|
+
priority?: number;
|
|
74
|
+
delegation_depth?: number;
|
|
75
|
+
parent_contract_id?: string;
|
|
76
|
+
limit?: number;
|
|
77
|
+
offset?: number;
|
|
78
|
+
sort_by?: 'created_at' | 'updated_at' | 'completed_at' | 'timeout_ms' | 'priority';
|
|
79
|
+
sort_order?: 'asc' | 'desc';
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Contract update options - single object with contract_id
|
|
83
|
+
*/
|
|
84
|
+
export interface ContractUpdateOptions {
|
|
85
|
+
contract_id: string;
|
|
86
|
+
/** Optional caller agent ID — when set, ownership is verified before applying the update. */
|
|
87
|
+
caller_id?: string;
|
|
88
|
+
status?: DelegationContractStatus;
|
|
89
|
+
activated_at?: string;
|
|
90
|
+
completed_at?: string;
|
|
91
|
+
verification_result?: VerificationResult;
|
|
92
|
+
metadata?: Record<string, any>;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Contract statistics
|
|
96
|
+
*/
|
|
97
|
+
export interface ContractStatistics {
|
|
98
|
+
total: number;
|
|
99
|
+
active: number;
|
|
100
|
+
completed: number;
|
|
101
|
+
failed: number;
|
|
102
|
+
average_completion_time_ms?: number;
|
|
103
|
+
success_rate: number;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Configuration for DelegationContractManager
|
|
107
|
+
*/
|
|
108
|
+
export interface DelegationContractManagerConfig {
|
|
109
|
+
databasePath?: string;
|
|
110
|
+
maxDelegationDepth?: number;
|
|
111
|
+
debug?: boolean;
|
|
112
|
+
/** Optional registry used by selectExecutionMode() for manifest lookups. */
|
|
113
|
+
capabilityRegistry?: CapabilityRegistry;
|
|
114
|
+
/** Override base directory for session archives (defaults to logs/delegation/sessions). */
|
|
115
|
+
sessionArchiveDir?: string;
|
|
116
|
+
/** Override checkpoint directory (defaults to logs/delegation/checkpoints). */
|
|
117
|
+
checkpointDir?: string;
|
|
118
|
+
/** Maximum concurrent background sessions (defaults to MAX_BACKGROUND_SESSIONS = 10). */
|
|
119
|
+
maxBackgroundSessions?: number;
|
|
120
|
+
/**
|
|
121
|
+
* Optional agent identity registry. When provided, enables IdentityMiddleware
|
|
122
|
+
* which enforces HMAC-token verification for delegator/delegatee on every createContract.
|
|
123
|
+
*/
|
|
124
|
+
agentRegistry?: AgentRegistry;
|
|
125
|
+
/**
|
|
126
|
+
* Additional TLP clearances to seed into the TLPEnforcementEngine at startup.
|
|
127
|
+
* Useful in tests and custom deployments where agents not in DEFAULT_AGENT_CLEARANCES
|
|
128
|
+
* require access to AMBER/GREEN/RED classified contracts.
|
|
129
|
+
*/
|
|
130
|
+
additionalTLPClearances?: AgentClearance[];
|
|
131
|
+
/**
|
|
132
|
+
* Optional ReputationEngine instance. When provided, enables:
|
|
133
|
+
* - ReputationMiddleware (7.1): blocks low-reputation agents on TLP:AMBER+ tasks
|
|
134
|
+
* - Security violation penalty (7.2): reduces security_score when a threat is detected
|
|
135
|
+
*/
|
|
136
|
+
reputationEngine?: ReputationEngine;
|
|
137
|
+
/**
|
|
138
|
+
* Optional DelegationHealthMonitor instance. When provided, the manager wires
|
|
139
|
+
* a live contract data provider so that collectMetrics() returns real counts (8.1).
|
|
140
|
+
*/
|
|
141
|
+
healthMonitor?: DelegationHealthMonitor;
|
|
142
|
+
/**
|
|
143
|
+
* Optional rate-limiter overrides. Useful in tests to set a lower `maxOps`
|
|
144
|
+
* and shorter `windowMs` to verify rate-limiting without hitting 50 ops/hour.
|
|
145
|
+
*/
|
|
146
|
+
rateLimiterOptions?: RateLimiterOptions;
|
|
147
|
+
/**
|
|
148
|
+
* Optional FeatureFlagManager instance. When provided, the FeatureFlagMiddleware
|
|
149
|
+
* uses this instance to check `delegation_enabled` kill-switch. Defaults to the
|
|
150
|
+
* global singleton from getFeatureFlagManager().
|
|
151
|
+
*/
|
|
152
|
+
featureFlagManager?: FeatureFlagManager;
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* DelegationContractManager - Core delegation contract lifecycle management
|
|
156
|
+
*/
|
|
157
|
+
export declare class DelegationContractManager extends EventEmitter {
|
|
158
|
+
private db;
|
|
159
|
+
private maxDelegationDepth;
|
|
160
|
+
private debug;
|
|
161
|
+
/** In-memory agent name cache (DB may not store names) */
|
|
162
|
+
private agentNames;
|
|
163
|
+
private securityThreatEvents;
|
|
164
|
+
private securityValidationCount;
|
|
165
|
+
private securityThreatCount;
|
|
166
|
+
/** Optional registry for manifest-based mode selection. */
|
|
167
|
+
private readonly capabilityRegistry?;
|
|
168
|
+
/** Background session slot management. */
|
|
169
|
+
private readonly backgroundQueue;
|
|
170
|
+
/** Session lifecycle tracking. */
|
|
171
|
+
private readonly sessionManager;
|
|
172
|
+
/** Checkpoint persistence. */
|
|
173
|
+
private readonly checkpoint;
|
|
174
|
+
/** Pluggable security middleware chain — evaluated on every createContract. */
|
|
175
|
+
private readonly securityChain;
|
|
176
|
+
/** Chain depth + fan-out middleware (also manages fan-out counters). */
|
|
177
|
+
private readonly chainDepthMiddleware;
|
|
178
|
+
/** Circuit breaker state machine for per-agent failure tracking. */
|
|
179
|
+
private readonly circuitBreaker;
|
|
180
|
+
/** Periodic contract timeout watchdog. */
|
|
181
|
+
private readonly watchdog;
|
|
182
|
+
/** Optional agent identity registry (enables IdentityMiddleware). */
|
|
183
|
+
private readonly agentRegistry?;
|
|
184
|
+
/** Blast-radius limiter — caps contract-creation rate per root delegator tree. */
|
|
185
|
+
private readonly blastRadiusTracker;
|
|
186
|
+
/** Optional reputation engine (enables ReputationMiddleware + security penalties). */
|
|
187
|
+
private readonly reputationEngine?;
|
|
188
|
+
/** Optional health monitor wired to live contract stats (8.1). */
|
|
189
|
+
private readonly healthMonitor?;
|
|
190
|
+
constructor(config?: DelegationContractManagerConfig);
|
|
191
|
+
/**
|
|
192
|
+
* Initialize database schema
|
|
193
|
+
*/
|
|
194
|
+
private initializeSchema;
|
|
195
|
+
/** Normalize agents from legacy or current request shapes */
|
|
196
|
+
private normalizeContractAgents;
|
|
197
|
+
/** Normalize verification policy from legacy/current values */
|
|
198
|
+
private normalizeVerificationPolicy;
|
|
199
|
+
/**
|
|
200
|
+
* 5.3 Sanitize task description text — strip null bytes and Unicode direction
|
|
201
|
+
* override characters while preserving legitimate Unicode (emoji, CJK, etc.).
|
|
202
|
+
*/
|
|
203
|
+
private sanitizeTaskDescription;
|
|
204
|
+
/**
|
|
205
|
+
* 6.2: Walk the parent chain to find the root delegator agent_id.
|
|
206
|
+
* Falls back to the provided delegator ID if no traceable parent exists.
|
|
207
|
+
*/
|
|
208
|
+
private getRootDelegatorId;
|
|
209
|
+
/** Run security validation, emit threat event and throw if a threat is detected */
|
|
210
|
+
private validateContractSecurity;
|
|
211
|
+
/**
|
|
212
|
+
* Create a new delegation contract
|
|
213
|
+
*/
|
|
214
|
+
createContract(request: CreateDelegationContractRequest): Promise<DelegationContract>;
|
|
215
|
+
/**
|
|
216
|
+
* Query contracts with filters
|
|
217
|
+
*/
|
|
218
|
+
/** Add status condition (array or single value) */
|
|
219
|
+
private addStatusCondition;
|
|
220
|
+
/** Append ORDER BY / LIMIT / OFFSET clauses */
|
|
221
|
+
private appendQueryTail;
|
|
222
|
+
/** Build WHERE clause and params from query options */
|
|
223
|
+
private buildQueryFromOptions;
|
|
224
|
+
queryContracts(options?: ContractQueryOptions): DelegationContract[];
|
|
225
|
+
/** Build SQL fields/params for an updateContract call */
|
|
226
|
+
private buildUpdateFields;
|
|
227
|
+
/**
|
|
228
|
+
* Update contract status and metadata.
|
|
229
|
+
* Accepts a single object with contract_id and fields to update.
|
|
230
|
+
* Automatically sets activated_at when status='active' and completed_at when status='completed'.
|
|
231
|
+
*/
|
|
232
|
+
updateContract(updates: ContractUpdateOptions): Promise<DelegationContract>;
|
|
233
|
+
/**
|
|
234
|
+
* Soft delete (revoke) a contract
|
|
235
|
+
*/
|
|
236
|
+
deleteContract(contract_id: string, reason?: string): Promise<void>;
|
|
237
|
+
/**
|
|
238
|
+
* Update contract status (convenience method)
|
|
239
|
+
*/
|
|
240
|
+
updateContractStatus(contract_id: string, status: DelegationContractStatus, options?: {
|
|
241
|
+
metadata?: Record<string, any>;
|
|
242
|
+
verification_result?: VerificationResult;
|
|
243
|
+
}): Promise<DelegationContract>;
|
|
244
|
+
/**
|
|
245
|
+
* Cancel a contract (convenience method for cancellation)
|
|
246
|
+
*/
|
|
247
|
+
cancelContract(contract_id: string, reason?: string): Promise<void>;
|
|
248
|
+
/**
|
|
249
|
+
* Send a heartbeat for a long-running active contract.
|
|
250
|
+
* Extends the timeout watchdog deadline by `heartbeatGraceMs` (default 30 s).
|
|
251
|
+
* The contract's `last_heartbeat_at` is recorded in metadata.
|
|
252
|
+
*
|
|
253
|
+
* @param contract_id - The active contract to keep alive.
|
|
254
|
+
*/
|
|
255
|
+
heartbeat(contract_id: string): Promise<void>;
|
|
256
|
+
/**
|
|
257
|
+
* Get a single contract by ID
|
|
258
|
+
*/
|
|
259
|
+
getContract(contract_id: string): DelegationContract | null;
|
|
260
|
+
/**
|
|
261
|
+
* Get contract by ID (alias for getContract)
|
|
262
|
+
*/
|
|
263
|
+
getContractById(contract_id: string): DelegationContract | null;
|
|
264
|
+
/**
|
|
265
|
+
* Get active contracts for an agent
|
|
266
|
+
*/
|
|
267
|
+
getActiveContracts(agent_id: string): DelegationContract[];
|
|
268
|
+
/**
|
|
269
|
+
* Get contract statistics
|
|
270
|
+
*/
|
|
271
|
+
getStatistics(agent_id?: string): ContractStatistics;
|
|
272
|
+
/**
|
|
273
|
+
* Close database connection
|
|
274
|
+
*/
|
|
275
|
+
close(): void;
|
|
276
|
+
/**
|
|
277
|
+
* Clear all contracts (for testing)
|
|
278
|
+
*/
|
|
279
|
+
clearAll(): void;
|
|
280
|
+
/**
|
|
281
|
+
* Get total contract count (legacy compatibility helper)
|
|
282
|
+
*/
|
|
283
|
+
getContractCount(): number;
|
|
284
|
+
/**
|
|
285
|
+
* Get security threat statistics (legacy compatibility helper)
|
|
286
|
+
*/
|
|
287
|
+
getSecurityThreatStatistics(): {
|
|
288
|
+
total_validations: number;
|
|
289
|
+
threats_detected: number;
|
|
290
|
+
threat_types: Record<string, number>;
|
|
291
|
+
severity_distribution: Record<string, number>;
|
|
292
|
+
action_distribution: Record<string, number>;
|
|
293
|
+
};
|
|
294
|
+
/**
|
|
295
|
+
* Get recent security threats (legacy compatibility helper)
|
|
296
|
+
*/
|
|
297
|
+
getRecentSecurityThreats(limit?: number): Array<Record<string, any>>;
|
|
298
|
+
/** Build security recommendations based on threat statistics */
|
|
299
|
+
private buildSecurityRecommendations;
|
|
300
|
+
/**
|
|
301
|
+
* Get security status summary (legacy compatibility helper)
|
|
302
|
+
*/
|
|
303
|
+
getSecurityStatus(): {
|
|
304
|
+
tlp_enforcement_enabled: boolean;
|
|
305
|
+
security_threat_validation_enabled: boolean;
|
|
306
|
+
contract_security_summary: Record<string, any>;
|
|
307
|
+
recent_security_events: Array<Record<string, any>>;
|
|
308
|
+
security_recommendations: string[];
|
|
309
|
+
};
|
|
310
|
+
/**
|
|
311
|
+
* Select the execution mode for a delegation request using a 4-tier priority:
|
|
312
|
+
*
|
|
313
|
+
* 1. **Explicit** — `request.execution_mode` field (highest priority)
|
|
314
|
+
* 2. **OpenSpec hint** — `request.metadata?.openspec_execution_mode`
|
|
315
|
+
* 3. **Agent manifest preference** — `delegateeManifest.preferred_execution_mode`
|
|
316
|
+
* 4. **Default** — `ExecutionMode.INTERACTIVE`
|
|
317
|
+
*
|
|
318
|
+
* In addition, the selected mode must be in the agent's `supported_execution_modes`
|
|
319
|
+
* (when declared), and background mode requires available queue capacity.
|
|
320
|
+
*
|
|
321
|
+
* @returns The resolved `ExecutionMode`.
|
|
322
|
+
*/
|
|
323
|
+
selectExecutionMode(request: CreateDelegationContractRequest & {
|
|
324
|
+
metadata?: Record<string, unknown>;
|
|
325
|
+
}, delegateeManifest?: AgentCapabilityManifest): ExecutionMode;
|
|
326
|
+
/**
|
|
327
|
+
* Degrade BACKGROUND → INTERACTIVE when the queue is at capacity.
|
|
328
|
+
* @private
|
|
329
|
+
*/
|
|
330
|
+
private _applyQueueGuard;
|
|
331
|
+
/**
|
|
332
|
+
* 7.3 — Rank a list of candidate agent IDs by their reputation reliability_score,
|
|
333
|
+
* highest first. Falls back to the original order when the reputation engine is
|
|
334
|
+
* unavailable or when `featureFlags.reputation_tracking === false`.
|
|
335
|
+
*/
|
|
336
|
+
rankCandidatesByReputation(agentIds: string[], featureFlags?: Record<string, boolean>): Promise<string[]>;
|
|
337
|
+
/**
|
|
338
|
+
* Get the current background session queue status.
|
|
339
|
+
*/
|
|
340
|
+
getBackgroundQueueStatus(): import("./session-queue.js").BackgroundQueueStatus;
|
|
341
|
+
/**
|
|
342
|
+
* Expose the session manager for external lifecycle queries.
|
|
343
|
+
*/
|
|
344
|
+
getSessionManager(): SessionManager;
|
|
345
|
+
/**
|
|
346
|
+
* Expose the session checkpoint manager.
|
|
347
|
+
*/
|
|
348
|
+
getCheckpoint(): SessionCheckpoint;
|
|
349
|
+
/**
|
|
350
|
+
* 8.1 — Expose the optional health monitor so callers can start/stop monitoring
|
|
351
|
+
* and retrieve live metrics.
|
|
352
|
+
*/
|
|
353
|
+
getHealthMonitor(): DelegationHealthMonitor | undefined;
|
|
354
|
+
/**
|
|
355
|
+
* **Phase 3.2 / 3.4** — Must be called after creating a BACKGROUND contract.
|
|
356
|
+
* - Acquires a background queue slot (waits if at capacity)
|
|
357
|
+
* - Registers the session in the session manager
|
|
358
|
+
* - Optionally records the worktree path returned by `worktree-coordinator`
|
|
359
|
+
*
|
|
360
|
+
* Emits: `session.created`
|
|
361
|
+
*/
|
|
362
|
+
beforeBackgroundExecution(contractId: string, sessionId: string, worktreePath?: string): Promise<void>;
|
|
363
|
+
/**
|
|
364
|
+
* **Phase 3.2 / 3.4** — Must be called when a BACKGROUND contract completes.
|
|
365
|
+
* - Releases the background queue slot
|
|
366
|
+
* - Archives the session
|
|
367
|
+
*
|
|
368
|
+
* Emits: `session.archived`
|
|
369
|
+
*/
|
|
370
|
+
afterBackgroundExecution(contractId: string, sessionId: string): void;
|
|
371
|
+
/**
|
|
372
|
+
* **Phase 3.5** — Must be called after creating an ASYNC contract.
|
|
373
|
+
* - Registers the session in the session manager
|
|
374
|
+
* - Optionally records the feature branch name
|
|
375
|
+
*
|
|
376
|
+
* Emits: `session.created`
|
|
377
|
+
*/
|
|
378
|
+
beforeAsyncExecution(contractId: string, sessionId: string, branchName?: string): void;
|
|
379
|
+
/**
|
|
380
|
+
* **Phase 3.5** — Must be called when an ASYNC contract completes.
|
|
381
|
+
* - Archives the session
|
|
382
|
+
* - Optionally records the PR number in session metadata before archiving
|
|
383
|
+
*
|
|
384
|
+
* Emits: `session.archived`
|
|
385
|
+
*/
|
|
386
|
+
afterAsyncExecution(contractId: string, sessionId: string, prNumber?: number): void;
|
|
387
|
+
/**
|
|
388
|
+
* **Phase 3.6** — Perform an atomic session handoff between execution modes.
|
|
389
|
+
*
|
|
390
|
+
* Steps (all-or-nothing; rolls back on failure):
|
|
391
|
+
* 1. Create a `pre-handoff` checkpoint of the current session state
|
|
392
|
+
* 2. Create a new contract in the target execution mode
|
|
393
|
+
* 3. Archive the original session
|
|
394
|
+
* 4. Emit `session.handoff`
|
|
395
|
+
*
|
|
396
|
+
* @param request - Source contract ID, target mode, context snapshot, and reason
|
|
397
|
+
* @returns The newly created contract (in the target mode)
|
|
398
|
+
* @throws If the source contract does not exist or the new contract cannot be created
|
|
399
|
+
*/
|
|
400
|
+
handoffSession(request: SessionHandoffRequest & {
|
|
401
|
+
/** Optional: extra fields forwarded to the new contract. */
|
|
402
|
+
newContractOverrides?: Partial<CreateDelegationContractRequest>;
|
|
403
|
+
/** Optional caller agent ID — when set, only the delegatee of the source contract may initiate the handoff. */
|
|
404
|
+
caller_id?: string;
|
|
405
|
+
}): Promise<DelegationContract>;
|
|
406
|
+
/**
|
|
407
|
+
* Convert database row to DelegationContract
|
|
408
|
+
*/
|
|
409
|
+
private rowToContract;
|
|
410
|
+
}
|
|
411
|
+
export { DelegationContractManager as ContractManager };
|
|
412
|
+
export type { DelegationContractManagerConfig as ContractManagerConfig };
|
|
413
|
+
export type { CreateDelegationContractRequest as ContractUpdate };
|
|
414
|
+
export type { ContractQueryOptions as ContractQuery };
|
|
415
|
+
//# sourceMappingURL=contract-manager.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contract-manager.d.ts","sourceRoot":"","sources":["../../../packages/ai/delegation/contract-manager.ts"],"names":[],"mappings":"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"}
|