@vauban-org/agent-sdk 1.0.0 → 1.3.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/CONTRACT.md +6918 -742
- package/dist/adapters/llm/anthropic-direct.d.ts +1 -0
- package/dist/adapters/llm/anthropic-direct.d.ts.map +1 -1
- package/dist/adapters/llm/anthropic-direct.js +43 -0
- package/dist/adapters/llm/anthropic-direct.js.map +1 -1
- package/dist/adapters/llm/cascade.d.ts.map +1 -1
- package/dist/adapters/llm/cascade.js +57 -14
- package/dist/adapters/llm/cascade.js.map +1 -1
- package/dist/adapters/llm/litellm.d.ts +2 -0
- package/dist/adapters/llm/litellm.d.ts.map +1 -1
- package/dist/adapters/llm/litellm.js +44 -0
- package/dist/adapters/llm/litellm.js.map +1 -1
- package/dist/compute/difficulty-estimator.d.ts +53 -0
- package/dist/compute/difficulty-estimator.d.ts.map +1 -0
- package/dist/compute/difficulty-estimator.js +82 -0
- package/dist/compute/difficulty-estimator.js.map +1 -0
- package/dist/compute/strategies/mixture-of-agents.d.ts +40 -0
- package/dist/compute/strategies/mixture-of-agents.d.ts.map +1 -0
- package/dist/compute/strategies/mixture-of-agents.js +110 -0
- package/dist/compute/strategies/mixture-of-agents.js.map +1 -0
- package/dist/compute/strategies/tree-of-thoughts.d.ts +48 -0
- package/dist/compute/strategies/tree-of-thoughts.d.ts.map +1 -0
- package/dist/compute/strategies/tree-of-thoughts.js +242 -0
- package/dist/compute/strategies/tree-of-thoughts.js.map +1 -0
- package/dist/compute/strategies/two-phase-orient.d.ts +72 -0
- package/dist/compute/strategies/two-phase-orient.d.ts.map +1 -0
- package/dist/compute/strategies/two-phase-orient.js +85 -0
- package/dist/compute/strategies/two-phase-orient.js.map +1 -0
- package/dist/constitution/types.d.ts +10 -10
- package/dist/container/protocol.d.ts +134 -0
- package/dist/container/protocol.d.ts.map +1 -0
- package/dist/container/protocol.js +157 -0
- package/dist/container/protocol.js.map +1 -0
- package/dist/container/runtime.d.ts +140 -0
- package/dist/container/runtime.d.ts.map +1 -0
- package/dist/container/runtime.js +256 -0
- package/dist/container/runtime.js.map +1 -0
- package/dist/events/catalogue.d.ts +46 -46
- package/dist/events/schemas/agent.completed.v1.d.ts +4 -4
- package/dist/events/schemas/agent.failed.v1.d.ts +2 -2
- package/dist/events/schemas/agent.hitl_resolved.v1.d.ts +2 -2
- package/dist/events/schemas/agent.started.v1.d.ts +2 -2
- package/dist/events/schemas/brain.skill.extracted.v1.d.ts +4 -4
- package/dist/events/schemas/cc.cost.anomaly_detected.v1.d.ts +2 -2
- package/dist/events/schemas/cc.cost.recorded.v1.d.ts +4 -4
- package/dist/events/schemas/citadel.sprint.analyzed.v1.d.ts +6 -6
- package/dist/events/schemas/citadel.sprint.closed.v1.d.ts +2 -2
- package/dist/events/schemas/forge.inbox.reply_classified.v1.d.ts +6 -6
- package/dist/events/schemas/forge.lead.qualified.v1.d.ts +2 -2
- package/dist/events/schemas/forge.outreach.sent.v1.d.ts +4 -4
- package/dist/events/schemas/incident.detected.v1.d.ts +2 -2
- package/dist/events/schemas/vauban.goal.checked.v1.d.ts +2 -2
- package/dist/events/schemas/vauban.rebalancing.checked.v1.d.ts +2 -2
- package/dist/events/schemas/vauban.tax.checked.v1.d.ts +2 -2
- package/dist/events/schemas/vauban.vault.analyzed.v1.d.ts +6 -6
- package/dist/identity/agent-persona.d.ts +73 -0
- package/dist/identity/agent-persona.d.ts.map +1 -0
- package/dist/identity/agent-persona.js +165 -0
- package/dist/identity/agent-persona.js.map +1 -0
- package/dist/identity/persona-prompt.d.ts +25 -0
- package/dist/identity/persona-prompt.d.ts.map +1 -0
- package/dist/identity/persona-prompt.js +71 -0
- package/dist/identity/persona-prompt.js.map +1 -0
- package/dist/identity/persona-schema.d.ts +120 -0
- package/dist/identity/persona-schema.d.ts.map +1 -0
- package/dist/identity/persona-schema.js +103 -0
- package/dist/identity/persona-schema.js.map +1 -0
- package/dist/index.d.ts +41 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +31 -1
- package/dist/index.js.map +1 -1
- package/dist/loop/minimal-loop.js +293 -287
- package/dist/memory/episodic-rrf.d.ts +114 -0
- package/dist/memory/episodic-rrf.d.ts.map +1 -0
- package/dist/memory/episodic-rrf.js +148 -0
- package/dist/memory/episodic-rrf.js.map +1 -0
- package/dist/mesh/attenuation.d.ts +78 -0
- package/dist/mesh/attenuation.d.ts.map +1 -0
- package/dist/mesh/attenuation.js +141 -0
- package/dist/mesh/attenuation.js.map +1 -0
- package/dist/mesh/delegate.d.ts +96 -0
- package/dist/mesh/delegate.d.ts.map +1 -0
- package/dist/mesh/delegate.js +172 -0
- package/dist/mesh/delegate.js.map +1 -0
- package/dist/mesh/dispatcher.d.ts +119 -0
- package/dist/mesh/dispatcher.d.ts.map +1 -0
- package/dist/mesh/dispatcher.js +207 -0
- package/dist/mesh/dispatcher.js.map +1 -0
- package/dist/mesh/index.d.ts +12 -0
- package/dist/mesh/index.d.ts.map +1 -0
- package/dist/mesh/index.js +11 -0
- package/dist/mesh/index.js.map +1 -0
- package/dist/mesh/types.d.ts +30 -0
- package/dist/mesh/types.d.ts.map +1 -0
- package/dist/mesh/types.js +11 -0
- package/dist/mesh/types.js.map +1 -0
- package/dist/orchestration/ooda/agent.d.ts.map +1 -1
- package/dist/orchestration/ooda/agent.js +36 -0
- package/dist/orchestration/ooda/agent.js.map +1 -1
- package/dist/orchestration/ooda/skills.d.ts +104 -0
- package/dist/orchestration/ooda/skills.d.ts.map +1 -1
- package/dist/orchestration/ooda/skills.js +106 -0
- package/dist/orchestration/ooda/skills.js.map +1 -1
- package/dist/orchestration/ooda/types.d.ts +11 -0
- package/dist/orchestration/ooda/types.d.ts.map +1 -1
- package/dist/ports/bastion-action.contract.test.d.ts +11 -0
- package/dist/ports/bastion-action.contract.test.d.ts.map +1 -0
- package/dist/ports/bastion-action.contract.test.js +238 -0
- package/dist/ports/bastion-action.contract.test.js.map +1 -0
- package/dist/ports/bastion-action.d.ts +133 -0
- package/dist/ports/bastion-action.d.ts.map +1 -0
- package/dist/ports/bastion-action.js +73 -0
- package/dist/ports/bastion-action.js.map +1 -0
- package/dist/ports/brain.d.ts +31 -0
- package/dist/ports/brain.d.ts.map +1 -1
- package/dist/ports/brain.js +115 -1
- package/dist/ports/brain.js.map +1 -1
- package/dist/ports/citadel-action.contract.test.d.ts +11 -0
- package/dist/ports/citadel-action.contract.test.d.ts.map +1 -0
- package/dist/ports/citadel-action.contract.test.js +317 -0
- package/dist/ports/citadel-action.contract.test.js.map +1 -0
- package/dist/ports/citadel-action.d.ts +111 -0
- package/dist/ports/citadel-action.d.ts.map +1 -0
- package/dist/ports/citadel-action.js +62 -0
- package/dist/ports/citadel-action.js.map +1 -0
- package/dist/ports/compliance-contract.d.ts +123 -0
- package/dist/ports/compliance-contract.d.ts.map +1 -0
- package/dist/ports/compliance-contract.js +35 -0
- package/dist/ports/compliance-contract.js.map +1 -0
- package/dist/ports/db.d.ts +38 -0
- package/dist/ports/db.d.ts.map +1 -1
- package/dist/ports/db.js +88 -1
- package/dist/ports/db.js.map +1 -1
- package/dist/ports/delegation.contract.test.d.ts +9 -0
- package/dist/ports/delegation.contract.test.d.ts.map +1 -0
- package/dist/ports/delegation.contract.test.js +337 -0
- package/dist/ports/delegation.contract.test.js.map +1 -0
- package/dist/ports/delegation.d.ts +134 -0
- package/dist/ports/delegation.d.ts.map +1 -0
- package/dist/ports/delegation.js +105 -0
- package/dist/ports/delegation.js.map +1 -0
- package/dist/ports/event-bus.d.ts +29 -0
- package/dist/ports/event-bus.d.ts.map +1 -1
- package/dist/ports/event-bus.js +106 -1
- package/dist/ports/event-bus.js.map +1 -1
- package/dist/ports/federation.contract.test.d.ts +9 -0
- package/dist/ports/federation.contract.test.d.ts.map +1 -0
- package/dist/ports/federation.contract.test.js +279 -0
- package/dist/ports/federation.contract.test.js.map +1 -0
- package/dist/ports/federation.d.ts +140 -0
- package/dist/ports/federation.d.ts.map +1 -0
- package/dist/ports/federation.js +57 -0
- package/dist/ports/federation.js.map +1 -0
- package/dist/ports/index.d.ts +28 -2
- package/dist/ports/index.d.ts.map +1 -1
- package/dist/ports/index.js +17 -2
- package/dist/ports/index.js.map +1 -1
- package/dist/ports/llm-provider.d.ts +37 -0
- package/dist/ports/llm-provider.d.ts.map +1 -1
- package/dist/ports/llm-provider.js +99 -1
- package/dist/ports/llm-provider.js.map +1 -1
- package/dist/ports/logger.d.ts +27 -0
- package/dist/ports/logger.d.ts.map +1 -1
- package/dist/ports/logger.js +87 -0
- package/dist/ports/logger.js.map +1 -1
- package/dist/ports/manifest-registry.contract.test.d.ts +9 -0
- package/dist/ports/manifest-registry.contract.test.d.ts.map +1 -0
- package/dist/ports/manifest-registry.contract.test.js +246 -0
- package/dist/ports/manifest-registry.contract.test.js.map +1 -0
- package/dist/ports/manifest-registry.d.ts +116 -0
- package/dist/ports/manifest-registry.d.ts.map +1 -0
- package/dist/ports/manifest-registry.js +79 -0
- package/dist/ports/manifest-registry.js.map +1 -0
- package/dist/ports/observability.contract.test.d.ts +12 -0
- package/dist/ports/observability.contract.test.d.ts.map +1 -0
- package/dist/ports/observability.contract.test.js +260 -0
- package/dist/ports/observability.contract.test.js.map +1 -0
- package/dist/ports/observability.d.ts +98 -0
- package/dist/ports/observability.d.ts.map +1 -0
- package/dist/ports/observability.js +59 -0
- package/dist/ports/observability.js.map +1 -0
- package/dist/ports/outcome.d.ts +26 -0
- package/dist/ports/outcome.d.ts.map +1 -1
- package/dist/ports/outcome.js +62 -1
- package/dist/ports/outcome.js.map +1 -1
- package/dist/ports/privacy.contract.test.d.ts +12 -0
- package/dist/ports/privacy.contract.test.d.ts.map +1 -0
- package/dist/ports/privacy.contract.test.js +325 -0
- package/dist/ports/privacy.contract.test.js.map +1 -0
- package/dist/ports/privacy.d.ts +132 -0
- package/dist/ports/privacy.d.ts.map +1 -0
- package/dist/ports/privacy.js +83 -0
- package/dist/ports/privacy.js.map +1 -0
- package/dist/ports/tenant-context.contract.test.d.ts +14 -0
- package/dist/ports/tenant-context.contract.test.d.ts.map +1 -0
- package/dist/ports/tenant-context.contract.test.js +352 -0
- package/dist/ports/tenant-context.contract.test.js.map +1 -0
- package/dist/ports/tenant-context.d.ts +103 -0
- package/dist/ports/tenant-context.d.ts.map +1 -0
- package/dist/ports/tenant-context.js +48 -0
- package/dist/ports/tenant-context.js.map +1 -0
- package/dist/ports/vauban-finance-action.contract.test.d.ts +11 -0
- package/dist/ports/vauban-finance-action.contract.test.d.ts.map +1 -0
- package/dist/ports/vauban-finance-action.contract.test.js +260 -0
- package/dist/ports/vauban-finance-action.contract.test.js.map +1 -0
- package/dist/ports/vauban-finance-action.d.ts +106 -0
- package/dist/ports/vauban-finance-action.d.ts.map +1 -0
- package/dist/ports/vauban-finance-action.js +60 -0
- package/dist/ports/vauban-finance-action.js.map +1 -0
- package/dist/ports/workflow-runtime.d.ts +204 -0
- package/dist/ports/workflow-runtime.d.ts.map +1 -0
- package/dist/ports/workflow-runtime.js +72 -0
- package/dist/ports/workflow-runtime.js.map +1 -0
- package/dist/proof/cert-verify.d.ts +80 -0
- package/dist/proof/cert-verify.d.ts.map +1 -0
- package/dist/proof/cert-verify.js +178 -0
- package/dist/proof/cert-verify.js.map +1 -0
- package/dist/replay/replay.d.ts.map +1 -1
- package/dist/replay/replay.js +5 -1
- package/dist/replay/replay.js.map +1 -1
- package/dist/retry/index.d.ts +129 -0
- package/dist/retry/index.d.ts.map +1 -0
- package/dist/retry/index.js +156 -0
- package/dist/retry/index.js.map +1 -0
- package/dist/retry/presets.d.ts +39 -0
- package/dist/retry/presets.d.ts.map +1 -0
- package/dist/retry/presets.js +69 -0
- package/dist/retry/presets.js.map +1 -0
- package/dist/skill-loop/ab-runner.d.ts +67 -0
- package/dist/skill-loop/ab-runner.d.ts.map +1 -0
- package/dist/skill-loop/ab-runner.js +160 -0
- package/dist/skill-loop/ab-runner.js.map +1 -0
- package/dist/skill-loop/adoption.d.ts +67 -0
- package/dist/skill-loop/adoption.d.ts.map +1 -0
- package/dist/skill-loop/adoption.js +126 -0
- package/dist/skill-loop/adoption.js.map +1 -0
- package/dist/skill-loop/candidate.d.ts +45 -0
- package/dist/skill-loop/candidate.d.ts.map +1 -0
- package/dist/skill-loop/candidate.js +43 -0
- package/dist/skill-loop/candidate.js.map +1 -0
- package/dist/skill-loop/evaluator.d.ts +42 -0
- package/dist/skill-loop/evaluator.d.ts.map +1 -0
- package/dist/skill-loop/evaluator.js +184 -0
- package/dist/skill-loop/evaluator.js.map +1 -0
- package/dist/skill-loop/index.d.ts +27 -0
- package/dist/skill-loop/index.d.ts.map +1 -0
- package/dist/skill-loop/index.js +27 -0
- package/dist/skill-loop/index.js.map +1 -0
- package/dist/skill-loop/reflexion-replay.d.ts +87 -0
- package/dist/skill-loop/reflexion-replay.d.ts.map +1 -0
- package/dist/skill-loop/reflexion-replay.js +110 -0
- package/dist/skill-loop/reflexion-replay.js.map +1 -0
- package/dist/skill-loop/sign-off.d.ts +88 -0
- package/dist/skill-loop/sign-off.d.ts.map +1 -0
- package/dist/skill-loop/sign-off.js +146 -0
- package/dist/skill-loop/sign-off.js.map +1 -0
- package/dist/skill-loop/value-metric.d.ts +55 -0
- package/dist/skill-loop/value-metric.d.ts.map +1 -0
- package/dist/skill-loop/value-metric.js +69 -0
- package/dist/skill-loop/value-metric.js.map +1 -0
- package/dist/skill-loop/versioning.d.ts +36 -0
- package/dist/skill-loop/versioning.d.ts.map +1 -0
- package/dist/skill-loop/versioning.js +47 -0
- package/dist/skill-loop/versioning.js.map +1 -0
- package/dist/skill-manifest/anchor.d.ts +91 -0
- package/dist/skill-manifest/anchor.d.ts.map +1 -0
- package/dist/skill-manifest/anchor.js +331 -0
- package/dist/skill-manifest/anchor.js.map +1 -0
- package/dist/skill-manifest/builder.d.ts +47 -0
- package/dist/skill-manifest/builder.d.ts.map +1 -0
- package/dist/skill-manifest/builder.js +93 -0
- package/dist/skill-manifest/builder.js.map +1 -0
- package/dist/skill-manifest/index.d.ts +13 -0
- package/dist/skill-manifest/index.d.ts.map +1 -0
- package/dist/skill-manifest/index.js +9 -0
- package/dist/skill-manifest/index.js.map +1 -0
- package/dist/skill-manifest/types.d.ts +67 -0
- package/dist/skill-manifest/types.d.ts.map +1 -0
- package/dist/skill-manifest/types.js +16 -0
- package/dist/skill-manifest/types.js.map +1 -0
- package/dist/skill-manifest/verifier.d.ts +42 -0
- package/dist/skill-manifest/verifier.d.ts.map +1 -0
- package/dist/skill-manifest/verifier.js +136 -0
- package/dist/skill-manifest/verifier.js.map +1 -0
- package/dist/skills/_secrets.d.ts +16 -0
- package/dist/skills/_secrets.d.ts.map +1 -0
- package/dist/skills/_secrets.js +20 -0
- package/dist/skills/_secrets.js.map +1 -0
- package/dist/skills/alpaca-quote.d.ts +2 -2
- package/dist/skills/alpaca-quote.d.ts.map +1 -1
- package/dist/skills/alpaca-quote.js +51 -20
- package/dist/skills/alpaca-quote.js.map +1 -1
- package/dist/skills/brain-query.d.ts +4 -4
- package/dist/skills/brain-store.d.ts +6 -6
- package/dist/skills/errors.d.ts +15 -0
- package/dist/skills/errors.d.ts.map +1 -1
- package/dist/skills/errors.js +21 -0
- package/dist/skills/errors.js.map +1 -1
- package/dist/skills/hitl-request.d.ts +2 -2
- package/dist/skills/index.d.ts +3 -1
- package/dist/skills/index.d.ts.map +1 -1
- package/dist/skills/index.js +4 -1
- package/dist/skills/index.js.map +1 -1
- package/dist/skills/markdown/loader.d.ts +52 -0
- package/dist/skills/markdown/loader.d.ts.map +1 -0
- package/dist/skills/markdown/loader.js +93 -0
- package/dist/skills/markdown/loader.js.map +1 -0
- package/dist/skills/markdown/schema.d.ts +432 -0
- package/dist/skills/markdown/schema.d.ts.map +1 -0
- package/dist/skills/markdown/schema.js +121 -0
- package/dist/skills/markdown/schema.js.map +1 -0
- package/dist/skills/poc-md-loader/markdown-loader.d.ts +77 -0
- package/dist/skills/poc-md-loader/markdown-loader.d.ts.map +1 -0
- package/dist/skills/poc-md-loader/markdown-loader.js +125 -0
- package/dist/skills/poc-md-loader/markdown-loader.js.map +1 -0
- package/dist/skills/poc-md-loader/runner.d.ts +24 -0
- package/dist/skills/poc-md-loader/runner.d.ts.map +1 -0
- package/dist/skills/poc-md-loader/runner.js +57 -0
- package/dist/skills/poc-md-loader/runner.js.map +1 -0
- package/dist/skills/poc-md-loader/vitest.poc.config.d.ts +3 -0
- package/dist/skills/poc-md-loader/vitest.poc.config.d.ts.map +1 -0
- package/dist/skills/poc-md-loader/vitest.poc.config.js +13 -0
- package/dist/skills/poc-md-loader/vitest.poc.config.js.map +1 -0
- package/dist/skills/poc-md-loader/web-search/script.d.ts +33 -0
- package/dist/skills/poc-md-loader/web-search/script.d.ts.map +1 -0
- package/dist/skills/poc-md-loader/web-search/script.js +75 -0
- package/dist/skills/poc-md-loader/web-search/script.js.map +1 -0
- package/dist/skills/record-outcome.d.ts +4 -4
- package/dist/skills/send-email.d.ts +2 -2
- package/dist/skills/send-email.d.ts.map +1 -1
- package/dist/skills/send-email.js +4 -3
- package/dist/skills/send-email.js.map +1 -1
- package/dist/skills/slack-notify.d.ts +4 -4
- package/dist/skills/slack-notify.d.ts.map +1 -1
- package/dist/skills/slack-notify.js +52 -21
- package/dist/skills/slack-notify.js.map +1 -1
- package/dist/skills/starknet-balance.d.ts +1 -1
- package/dist/skills/telegram-notify.d.ts +4 -4
- package/dist/skills/telegram-notify.d.ts.map +1 -1
- package/dist/skills/telegram-notify.js +48 -19
- package/dist/skills/telegram-notify.js.map +1 -1
- package/dist/skills/web-search.d.ts +1 -1
- package/dist/skills/web-search.d.ts.map +1 -1
- package/dist/skills/web-search.js +85 -40
- package/dist/skills/web-search.js.map +1 -1
- package/dist/telemetry/bus.d.ts +54 -0
- package/dist/telemetry/bus.d.ts.map +1 -0
- package/dist/telemetry/bus.js +159 -0
- package/dist/telemetry/bus.js.map +1 -0
- package/dist/telemetry/index.d.ts +35 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +30 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/port.d.ts +121 -0
- package/dist/telemetry/port.d.ts.map +1 -0
- package/dist/telemetry/port.js +48 -0
- package/dist/telemetry/port.js.map +1 -0
- package/dist/telemetry/sinks/otlp.d.ts +45 -0
- package/dist/telemetry/sinks/otlp.d.ts.map +1 -0
- package/dist/telemetry/sinks/otlp.js +195 -0
- package/dist/telemetry/sinks/otlp.js.map +1 -0
- package/dist/telemetry/sinks/sqlite.d.ts +32 -0
- package/dist/telemetry/sinks/sqlite.d.ts.map +1 -0
- package/dist/telemetry/sinks/sqlite.js +170 -0
- package/dist/telemetry/sinks/sqlite.js.map +1 -0
- package/dist/telemetry/sinks/stdout.d.ts +22 -0
- package/dist/telemetry/sinks/stdout.d.ts.map +1 -0
- package/dist/telemetry/sinks/stdout.js +38 -0
- package/dist/telemetry/sinks/stdout.js.map +1 -0
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/test-brain-port.d.ts +4 -0
- package/dist/testing/test-brain-port.d.ts.map +1 -1
- package/dist/testing/test-brain-port.js +75 -20
- package/dist/testing/test-brain-port.js.map +1 -1
- package/dist/testing/test-event-bus.d.ts.map +1 -1
- package/dist/testing/test-event-bus.js +89 -36
- package/dist/testing/test-event-bus.js.map +1 -1
- package/dist/trace/schema.d.ts +1 -1
- package/dist/trace/schema.d.ts.map +1 -1
- package/dist/trace/schema.js +1 -1
- package/dist/trace/schema.js.map +1 -1
- package/dist/verify/formal/index.d.ts +44 -0
- package/dist/verify/formal/index.d.ts.map +1 -0
- package/dist/verify/formal/index.js +98 -0
- package/dist/verify/formal/index.js.map +1 -0
- package/dist/verify/formal/policy.d.ts +105 -0
- package/dist/verify/formal/policy.d.ts.map +1 -0
- package/dist/verify/formal/policy.js +159 -0
- package/dist/verify/formal/policy.js.map +1 -0
- package/dist/verify/formal/result.d.ts +50 -0
- package/dist/verify/formal/result.d.ts.map +1 -0
- package/dist/verify/formal/result.js +21 -0
- package/dist/verify/formal/result.js.map +1 -0
- package/dist/verify/formal/solver.d.ts +67 -0
- package/dist/verify/formal/solver.d.ts.map +1 -0
- package/dist/verify/formal/solver.js +184 -0
- package/dist/verify/formal/solver.js.map +1 -0
- package/dist/verify/formal/spec-language.d.ts +80 -0
- package/dist/verify/formal/spec-language.d.ts.map +1 -0
- package/dist/verify/formal/spec-language.js +219 -0
- package/dist/verify/formal/spec-language.js.map +1 -0
- package/docs/attestation.md +199 -0
- package/docs/identity.md +193 -0
- package/docs/telemetry/migration.md +155 -0
- package/docs/telemetry/overview.md +154 -0
- package/docs/telemetry/privacy.md +127 -0
- package/docs/telemetry/sinks/cc.md +155 -0
- package/docs/telemetry/sinks/otlp.md +146 -0
- package/docs/telemetry/sinks/sqlite.md +126 -0
- package/docs/telemetry/sinks/stdout.md +82 -0
- package/package.json +18 -2
- package/src/adapters/llm/anthropic-direct.ts +51 -0
- package/src/adapters/llm/cascade.ts +64 -19
- package/src/adapters/llm/litellm.ts +49 -0
- package/src/compute/difficulty-estimator.ts +111 -0
- package/src/compute/strategies/mixture-of-agents.ts +150 -0
- package/src/compute/strategies/tree-of-thoughts.ts +293 -0
- package/src/compute/strategies/two-phase-orient.ts +147 -0
- package/src/container/protocol.ts +243 -0
- package/src/container/runtime.ts +424 -0
- package/src/db/migrations/026_formal_verify_results.sql +30 -0
- package/src/identity/agent-persona.ts +203 -0
- package/src/identity/persona-prompt.ts +84 -0
- package/src/identity/persona-schema.ts +127 -0
- package/src/index.ts +368 -2
- package/src/memory/episodic-rrf.ts +224 -0
- package/src/mesh/attenuation.ts +190 -0
- package/src/mesh/delegate.ts +254 -0
- package/src/mesh/dispatcher.ts +301 -0
- package/src/mesh/index.ts +39 -0
- package/src/mesh/types.ts +31 -0
- package/src/orchestration/ooda/agent.ts +50 -0
- package/src/orchestration/ooda/skills.ts +177 -0
- package/src/orchestration/ooda/types.ts +12 -0
- package/src/ports/bastion-action.contract.test.ts +355 -0
- package/src/ports/bastion-action.ts +198 -0
- package/src/ports/brain.ts +177 -15
- package/src/ports/citadel-action.contract.test.ts +430 -0
- package/src/ports/citadel-action.ts +174 -0
- package/src/ports/compliance-contract.ts +191 -0
- package/src/ports/db.ts +98 -0
- package/src/ports/delegation.contract.test.ts +428 -0
- package/src/ports/delegation.ts +211 -0
- package/src/ports/event-bus.ts +133 -0
- package/src/ports/federation.contract.test.ts +355 -0
- package/src/ports/federation.ts +190 -0
- package/src/ports/index.ts +186 -1
- package/src/ports/llm-provider.ts +123 -0
- package/src/ports/logger.ts +104 -0
- package/src/ports/manifest-registry.contract.test.ts +324 -0
- package/src/ports/manifest-registry.ts +188 -0
- package/src/ports/observability.contract.test.ts +315 -0
- package/src/ports/observability.ts +150 -0
- package/src/ports/outcome.ts +69 -0
- package/src/ports/privacy.contract.test.ts +413 -0
- package/src/ports/privacy.ts +207 -0
- package/src/ports/tenant-context.contract.test.ts +454 -0
- package/src/ports/tenant-context.ts +150 -0
- package/src/ports/vauban-finance-action.contract.test.ts +335 -0
- package/src/ports/vauban-finance-action.ts +166 -0
- package/src/ports/workflow-runtime.ts +327 -0
- package/src/proof/cert-verify.ts +249 -0
- package/src/replay/replay.ts +11 -8
- package/src/retry/index.ts +227 -0
- package/src/retry/presets.ts +75 -0
- package/src/skill-loop/ab-runner.ts +196 -0
- package/src/skill-loop/adoption.ts +188 -0
- package/src/skill-loop/candidate.ts +75 -0
- package/src/skill-loop/evaluator.ts +238 -0
- package/src/skill-loop/index.ts +51 -0
- package/src/skill-loop/reflexion-replay.ts +173 -0
- package/src/skill-loop/sign-off.ts +247 -0
- package/src/skill-loop/value-metric.ts +120 -0
- package/src/skill-loop/versioning.ts +75 -0
- package/src/skill-manifest/anchor.ts +401 -0
- package/src/skill-manifest/builder.ts +129 -0
- package/src/skill-manifest/index.ts +18 -0
- package/src/skill-manifest/types.ts +72 -0
- package/src/skill-manifest/verifier.ts +198 -0
- package/src/skills/_secrets.ts +25 -0
- package/src/skills/alpaca-quote.ts +68 -23
- package/src/skills/errors.ts +30 -2
- package/src/skills/index.ts +19 -0
- package/src/skills/markdown/loader.ts +129 -0
- package/src/skills/markdown/schema.ts +144 -0
- package/src/skills/poc-md-loader/e2e-parity.test.ts +237 -0
- package/src/skills/poc-md-loader/markdown-loader.ts +161 -0
- package/src/skills/poc-md-loader/runner.ts +82 -0
- package/src/skills/poc-md-loader/vitest.poc.config.ts +13 -0
- package/src/skills/poc-md-loader/web-search/SKILL.md +42 -0
- package/src/skills/poc-md-loader/web-search/script.ts +109 -0
- package/src/skills/send-email.ts +4 -3
- package/src/skills/slack-notify.ts +73 -30
- package/src/skills/telegram-notify.ts +70 -24
- package/src/skills/web-search.ts +132 -50
- package/src/telemetry/bus.test.ts +231 -0
- package/src/telemetry/bus.ts +241 -0
- package/src/telemetry/index.ts +49 -0
- package/src/telemetry/port.ts +160 -0
- package/src/telemetry/sinks/otlp.test.ts +146 -0
- package/src/telemetry/sinks/otlp.ts +250 -0
- package/src/telemetry/sinks/sqlite.test.ts +121 -0
- package/src/telemetry/sinks/sqlite.ts +260 -0
- package/src/telemetry/sinks/stdout.test.ts +109 -0
- package/src/telemetry/sinks/stdout.ts +59 -0
- package/src/testing/test-brain-port.ts +98 -24
- package/src/testing/test-event-bus.ts +104 -43
- package/src/trace/schema.ts +1 -1
- package/src/verify/formal/index.ts +154 -0
- package/src/verify/formal/policy.ts +253 -0
- package/src/verify/formal/result.ts +52 -0
- package/src/verify/formal/solver.ts +235 -0
- package/src/verify/formal/spec-language.ts +274 -0
package/dist/ports/index.d.ts
CHANGED
|
@@ -6,15 +6,41 @@
|
|
|
6
6
|
* via each agent's setXxxDeps() setter.
|
|
7
7
|
*/
|
|
8
8
|
export type { LoggerPort } from "./logger.js";
|
|
9
|
-
export { noopLogger } from "./logger.js";
|
|
9
|
+
export { noopLogger, LoggerFlushError } from "./logger.js";
|
|
10
10
|
export type { BrainPort, BrainEntry, BrainEntryInput, BrainQueryFilters, WorkingMemoryPort, EpisodicMemoryPort, EpisodicMemoryEntry, SemanticMemoryPort, ProceduralMemoryPort, ProceduralSkill, } from "./brain.js";
|
|
11
|
-
export { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, } from "./brain.js";
|
|
11
|
+
export { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, BrainUnavailableError, BrainRateLimitError, } from "./brain.js";
|
|
12
12
|
export type { OutcomePort, AgentRunRef } from "./outcome.js";
|
|
13
|
+
export { OutcomeWriteError } from "./outcome.js";
|
|
13
14
|
export type { CloudEvent, EventBusPort } from "./event-bus.js";
|
|
15
|
+
export { EventPublishError } from "./event-bus.js";
|
|
14
16
|
export type { DbPort, DbClient } from "./db.js";
|
|
17
|
+
export { DbConnectionLostError, DbQueryTimeoutError } from "./db.js";
|
|
15
18
|
export type { AgentDescriptor, AgentRegistryPort } from "./agent-registry.js";
|
|
16
19
|
export type { MessagingChannelPort, AlertLevel } from "./messaging.js";
|
|
17
20
|
export { InvalidTargetError } from "./messaging.js";
|
|
18
21
|
export type { LLMProviderPort, ChatRequest, ChatMessage, ChatUsage, ChatResponse, StreamDelta, } from "./llm-provider.js";
|
|
22
|
+
export { LLMProviderError, LLMRateLimitError } from "./llm-provider.js";
|
|
19
23
|
export type { PricePort, PriceEntry } from "./price.js";
|
|
24
|
+
export type { ComplianceContractPort, ComplianceContract, ComplianceRule, ComplianceGate, ComplianceAuditResult, ComplianceViolation, ManifestValidationResult, PolicyConflict, CapabilityInvocation, TenantContext, LegalBasisRef, LegalBasisDecl, LegalBasisDomain, Jurisdiction, DataClass, ComplianceMode, EnforcementLevel, RuleSource, } from "./compliance-contract.js";
|
|
25
|
+
export { CompliancePolicyError, ComplianceEvaluationTimeoutError, SUPPORTED_JURISDICTIONS_V0, } from "./compliance-contract.js";
|
|
26
|
+
export type { WorkflowRuntimePort, WorkflowContext, WorkflowRun, WorkflowHandler, WorkflowStatus, JournalEntry, StepKind, StepStatus, StepOpts, EventFilter, ChildWorkflowOpts, StartWorkflowOpts, ResumeWorkflowOpts, SendSignalOpts, JournalMigrator, MigrationResult, } from "./workflow-runtime.js";
|
|
27
|
+
export { WorkflowNotFoundError, WorkflowNonDeterminismError, WorkflowSignalTimeoutError, WorkflowLeaseConflictError, WorkflowVersionMismatchError, } from "./workflow-runtime.js";
|
|
28
|
+
export type * from "./manifest-registry.js";
|
|
29
|
+
export { ManifestNotFoundError, ManifestSignatureInvalidError, ManifestVersionConflictError, ManifestComplianceConflictError, ManifestValidationError, } from "./manifest-registry.js";
|
|
30
|
+
export type * from "./tenant-context.js";
|
|
31
|
+
export { TenantNotFoundError, DegradedModeExhaustedError, InvalidGlacisAttestationError, } from "./tenant-context.js";
|
|
32
|
+
export type { FederationPort, FederationMessage, FederationMessageHeader, AgentRef, ContentClaim, TransportMeta, MessageId, ReceiveOpts, VerifyResult as FederationVerifyResult, } from "./federation.js";
|
|
33
|
+
export { FederationSignatureInvalidError, FederationRoutingError, FederationDelegationChainError, } from "./federation.js";
|
|
34
|
+
export type { DelegationPort, DelegationClaim, CapabilityScope, RootCapability, VerifyChainResult, } from "./delegation.js";
|
|
35
|
+
export { DelegationNotNarrowingError, DelegationExpiredError, DelegationRevokedError, DelegationChainTooDeepError, } from "./delegation.js";
|
|
36
|
+
export type { BastionActionPort, SwapParams, SwapResult, DepositParams, DepositResult, WithdrawParams, WithdrawResult, TransferParams, TransferResult, PolicyValidation, ClientPolicy, TokenAddress, VaultAddress, TenantId as BastionTenantId, ActionContext as BastionActionContext, } from "./bastion-action.js";
|
|
37
|
+
export { BastionPolicyViolationError, BastionInsufficientFundsError, BastionSlippageExceededError, BastionContractError, BastionTransferUnauthorizedError, } from "./bastion-action.js";
|
|
38
|
+
export type { VFinanceActionPort, MarketSignal, SolvencyClaim, TradeRecord, TradeClaim, StrategyRunInput, StrategyRunClaim, PortfolioId, ProofGrade, ActionContext as VFActionContext, } from "./vauban-finance-action.js";
|
|
39
|
+
export { VFOracleQuorumError, VFProofGradeMismatchError, VFAnchoringForbiddenError, VFProofGenerationError, } from "./vauban-finance-action.js";
|
|
40
|
+
export type { CitadelActionPort, AgentTier, SprintInput, SprintRef, TaskRef, TaskStatus, VerificationEvidence, SealedSprintClaim, DecisionInput, DecisionClaim, ActionContext as CitadelActionContext, } from "./citadel-action.js";
|
|
41
|
+
export { CitadelTierViolationError, CitadelTaskRefNotFoundError, CitadelSprintNotActiveError, CitadelInvalidStateTransitionError, } from "./citadel-action.js";
|
|
42
|
+
export type * from "./observability.js";
|
|
43
|
+
export { NoopObservabilityPort } from "./observability.js";
|
|
44
|
+
export type { RevelationMask, ZkProofInput, VerifyResult as PrivacyVerifyResult, Commitment, SmtResult, PrivacyContext, PrivacyPort, } from "./privacy.js";
|
|
45
|
+
export { NoopPrivacyAdapter, PrivacyNoopWarning } from "./privacy.js";
|
|
20
46
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"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"}
|
package/dist/ports/index.js
CHANGED
|
@@ -1,4 +1,19 @@
|
|
|
1
|
-
export { noopLogger } from "./logger.js";
|
|
2
|
-
export { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, } from "./brain.js";
|
|
1
|
+
export { noopLogger, LoggerFlushError } from "./logger.js";
|
|
2
|
+
export { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, BrainUnavailableError, BrainRateLimitError, } from "./brain.js";
|
|
3
|
+
export { OutcomeWriteError } from "./outcome.js";
|
|
4
|
+
export { EventPublishError } from "./event-bus.js";
|
|
5
|
+
export { DbConnectionLostError, DbQueryTimeoutError } from "./db.js";
|
|
3
6
|
export { InvalidTargetError } from "./messaging.js";
|
|
7
|
+
export { LLMProviderError, LLMRateLimitError } from "./llm-provider.js";
|
|
8
|
+
export { CompliancePolicyError, ComplianceEvaluationTimeoutError, SUPPORTED_JURISDICTIONS_V0, } from "./compliance-contract.js";
|
|
9
|
+
export { WorkflowNotFoundError, WorkflowNonDeterminismError, WorkflowSignalTimeoutError, WorkflowLeaseConflictError, WorkflowVersionMismatchError, } from "./workflow-runtime.js";
|
|
10
|
+
export { ManifestNotFoundError, ManifestSignatureInvalidError, ManifestVersionConflictError, ManifestComplianceConflictError, ManifestValidationError, } from "./manifest-registry.js";
|
|
11
|
+
export { TenantNotFoundError, DegradedModeExhaustedError, InvalidGlacisAttestationError, } from "./tenant-context.js";
|
|
12
|
+
export { FederationSignatureInvalidError, FederationRoutingError, FederationDelegationChainError, } from "./federation.js";
|
|
13
|
+
export { DelegationNotNarrowingError, DelegationExpiredError, DelegationRevokedError, DelegationChainTooDeepError, } from "./delegation.js";
|
|
14
|
+
export { BastionPolicyViolationError, BastionInsufficientFundsError, BastionSlippageExceededError, BastionContractError, BastionTransferUnauthorizedError, } from "./bastion-action.js";
|
|
15
|
+
export { VFOracleQuorumError, VFProofGradeMismatchError, VFAnchoringForbiddenError, VFProofGenerationError, } from "./vauban-finance-action.js";
|
|
16
|
+
export { CitadelTierViolationError, CitadelTaskRefNotFoundError, CitadelSprintNotActiveError, CitadelInvalidStateTransitionError, } from "./citadel-action.js";
|
|
17
|
+
export { NoopObservabilityPort } from "./observability.js";
|
|
18
|
+
export { NoopPrivacyAdapter, PrivacyNoopWarning } from "./privacy.js";
|
|
4
19
|
//# sourceMappingURL=index.js.map
|
package/dist/ports/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAc3D,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAKrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAUpD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwBxE,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAoBlC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAa7B,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AASzB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,oBAAoB,EACpB,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAepC,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAW3D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
|
|
@@ -7,6 +7,10 @@
|
|
|
7
7
|
*
|
|
8
8
|
* Plan v6 §3.2 — canonical interface.
|
|
9
9
|
*
|
|
10
|
+
* OTel instrumentation: import { createTracedLLMProviderPort } to wrap any
|
|
11
|
+
* LLMProviderPort implementation with OpenTelemetry spans per completion.
|
|
12
|
+
* Gracefully degrades to noop spans when no OTel SDK is installed.
|
|
13
|
+
*
|
|
10
14
|
* @public
|
|
11
15
|
*/
|
|
12
16
|
export interface ChatMessage {
|
|
@@ -60,4 +64,37 @@ export interface LLMProviderPort {
|
|
|
60
64
|
usd: number;
|
|
61
65
|
};
|
|
62
66
|
}
|
|
67
|
+
/**
|
|
68
|
+
* Base class for all LLM provider errors.
|
|
69
|
+
* Concrete implementations throw subclasses so callers can switch on error type.
|
|
70
|
+
*/
|
|
71
|
+
export declare class LLMProviderError extends Error {
|
|
72
|
+
readonly cause?: unknown | undefined;
|
|
73
|
+
/** The provider identifier (e.g. "groq", "litellm", "anthropic"). */
|
|
74
|
+
readonly provider: string;
|
|
75
|
+
/** The model that was being called (e.g. "llama-3.3-70b"). */
|
|
76
|
+
readonly model: string;
|
|
77
|
+
constructor(message: string, provider: string, model: string, cause?: unknown | undefined);
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Thrown when the LLM provider returns 429 (rate limit exceeded).
|
|
81
|
+
* Callers should retry after the delay indicated in `retryAfterMs`
|
|
82
|
+
* or switch to a fallback provider.
|
|
83
|
+
*/
|
|
84
|
+
export declare class LLMRateLimitError extends LLMProviderError {
|
|
85
|
+
/** Retry-After delay in milliseconds. */
|
|
86
|
+
readonly retryAfterMs: number;
|
|
87
|
+
constructor(message: string, provider: string, model: string, retryAfterMs: number, cause?: unknown);
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Wrap any LLMProviderPort implementation with OTel spans per complete() call.
|
|
91
|
+
* The span captures the model, provider, and token usage on success.
|
|
92
|
+
* Gracefully degrades to noop spans when no OTel SDK is installed.
|
|
93
|
+
*
|
|
94
|
+
* Usage:
|
|
95
|
+
* const raw: LLMProviderPort = buildAnthropicAdapter(...);
|
|
96
|
+
* const traced = createTracedLLMProviderPort(raw);
|
|
97
|
+
* const resp = await traced.complete(req) // emits "llm-provider.complete" span
|
|
98
|
+
*/
|
|
99
|
+
export declare function createTracedLLMProviderPort(impl: LLMProviderPort): LLMProviderPort;
|
|
63
100
|
//# sourceMappingURL=llm-provider.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../src/ports/llm-provider.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../src/ports/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACpD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElD;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEtD;;;OAGG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAID;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAUvB,KAAK,CAAC,EAAE,OAAO;IATjC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACG,KAAK,CAAC,EAAE,OAAO,YAAA;CAQlC;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,OAAO;CAOlB;AASD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,GACpB,eAAe,CAiDjB"}
|
|
@@ -7,7 +7,105 @@
|
|
|
7
7
|
*
|
|
8
8
|
* Plan v6 §3.2 — canonical interface.
|
|
9
9
|
*
|
|
10
|
+
* OTel instrumentation: import { createTracedLLMProviderPort } to wrap any
|
|
11
|
+
* LLMProviderPort implementation with OpenTelemetry spans per completion.
|
|
12
|
+
* Gracefully degrades to noop spans when no OTel SDK is installed.
|
|
13
|
+
*
|
|
10
14
|
* @public
|
|
11
15
|
*/
|
|
12
|
-
|
|
16
|
+
// ─── Typed errors ─────────────────────────────────────────────────────────────
|
|
17
|
+
/**
|
|
18
|
+
* Base class for all LLM provider errors.
|
|
19
|
+
* Concrete implementations throw subclasses so callers can switch on error type.
|
|
20
|
+
*/
|
|
21
|
+
export class LLMProviderError extends Error {
|
|
22
|
+
cause;
|
|
23
|
+
/** The provider identifier (e.g. "groq", "litellm", "anthropic"). */
|
|
24
|
+
provider;
|
|
25
|
+
/** The model that was being called (e.g. "llama-3.3-70b"). */
|
|
26
|
+
model;
|
|
27
|
+
constructor(message, provider, model, cause) {
|
|
28
|
+
super(message);
|
|
29
|
+
this.cause = cause;
|
|
30
|
+
this.name = "LLMProviderError";
|
|
31
|
+
this.provider = provider;
|
|
32
|
+
this.model = model;
|
|
33
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Thrown when the LLM provider returns 429 (rate limit exceeded).
|
|
38
|
+
* Callers should retry after the delay indicated in `retryAfterMs`
|
|
39
|
+
* or switch to a fallback provider.
|
|
40
|
+
*/
|
|
41
|
+
export class LLMRateLimitError extends LLMProviderError {
|
|
42
|
+
/** Retry-After delay in milliseconds. */
|
|
43
|
+
retryAfterMs;
|
|
44
|
+
constructor(message, provider, model, retryAfterMs, cause) {
|
|
45
|
+
super(message, provider, model, cause);
|
|
46
|
+
this.name = "LLMRateLimitError";
|
|
47
|
+
this.retryAfterMs = retryAfterMs;
|
|
48
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
import { SpanStatusCode, trace } from "@opentelemetry/api";
|
|
52
|
+
const PORT_TRACER = trace.getTracer("vauban-agent-sdk.ports", "0.1.0");
|
|
53
|
+
/**
|
|
54
|
+
* Wrap any LLMProviderPort implementation with OTel spans per complete() call.
|
|
55
|
+
* The span captures the model, provider, and token usage on success.
|
|
56
|
+
* Gracefully degrades to noop spans when no OTel SDK is installed.
|
|
57
|
+
*
|
|
58
|
+
* Usage:
|
|
59
|
+
* const raw: LLMProviderPort = buildAnthropicAdapter(...);
|
|
60
|
+
* const traced = createTracedLLMProviderPort(raw);
|
|
61
|
+
* const resp = await traced.complete(req) // emits "llm-provider.complete" span
|
|
62
|
+
*/
|
|
63
|
+
export function createTracedLLMProviderPort(impl) {
|
|
64
|
+
return {
|
|
65
|
+
async complete(req) {
|
|
66
|
+
return PORT_TRACER.startActiveSpan("llm-provider.complete", {
|
|
67
|
+
attributes: {
|
|
68
|
+
"gen_ai.request.model": req.model ?? "unknown",
|
|
69
|
+
"gen_ai.request.message_count": req.messages.length,
|
|
70
|
+
"vauban.port.name": "llm-provider",
|
|
71
|
+
},
|
|
72
|
+
}, async (span) => {
|
|
73
|
+
try {
|
|
74
|
+
const resp = await impl.complete(req);
|
|
75
|
+
span.setAttributes({
|
|
76
|
+
"gen_ai.usage.input_tokens": resp.usage.inputTokens,
|
|
77
|
+
"gen_ai.usage.output_tokens": resp.usage.outputTokens,
|
|
78
|
+
"gen_ai.response.model": resp.model,
|
|
79
|
+
"gen_ai.response.finish_reasons": [resp.finishReason],
|
|
80
|
+
});
|
|
81
|
+
if (resp.usage.costUsd !== undefined) {
|
|
82
|
+
span.setAttribute("gen_ai.usage.cost_usd", resp.usage.costUsd);
|
|
83
|
+
}
|
|
84
|
+
span.setStatus({ code: SpanStatusCode.OK });
|
|
85
|
+
return resp;
|
|
86
|
+
}
|
|
87
|
+
catch (err) {
|
|
88
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
89
|
+
span.setStatus({ code: SpanStatusCode.ERROR, message });
|
|
90
|
+
if (err instanceof Error)
|
|
91
|
+
span.recordException(err);
|
|
92
|
+
throw err;
|
|
93
|
+
}
|
|
94
|
+
finally {
|
|
95
|
+
span.end();
|
|
96
|
+
}
|
|
97
|
+
});
|
|
98
|
+
},
|
|
99
|
+
async *stream(req) {
|
|
100
|
+
if (!impl.stream)
|
|
101
|
+
return;
|
|
102
|
+
for await (const chunk of impl.stream(req)) {
|
|
103
|
+
yield chunk;
|
|
104
|
+
}
|
|
105
|
+
},
|
|
106
|
+
estimateCost(req) {
|
|
107
|
+
return impl.estimateCost?.(req) ?? { usd: 0 };
|
|
108
|
+
},
|
|
109
|
+
};
|
|
110
|
+
}
|
|
13
111
|
//# sourceMappingURL=llm-provider.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../../src/ports/llm-provider.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../../src/ports/llm-provider.ts"],"names":[],"mappings":"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"}
|
package/dist/ports/logger.d.ts
CHANGED
|
@@ -3,6 +3,10 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Shape matches Pino's child-logger subset. Host wires any concrete
|
|
5
5
|
* logger (pino, winston, console-shim) that implements these methods.
|
|
6
|
+
*
|
|
7
|
+
* OTel instrumentation: import { createTracedLoggerPort } to wrap any
|
|
8
|
+
* LoggerPort implementation with OpenTelemetry spans per log call.
|
|
9
|
+
* Gracefully degrades to noop spans when no OTel SDK is installed.
|
|
6
10
|
*/
|
|
7
11
|
export interface LoggerPort {
|
|
8
12
|
debug(objOrMsg: object | string, msg?: string): void;
|
|
@@ -11,8 +15,31 @@ export interface LoggerPort {
|
|
|
11
15
|
error(objOrMsg: object | string, msg?: string): void;
|
|
12
16
|
child?(bindings: Record<string, unknown>): LoggerPort;
|
|
13
17
|
}
|
|
18
|
+
/**
|
|
19
|
+
* Thrown when the log transport fails to flush pending buffers (disk full,
|
|
20
|
+
* network timeout on remote sink, or backend refused connection).
|
|
21
|
+
* Callers may retry flush or discard pending entries depending on criticality.
|
|
22
|
+
*/
|
|
23
|
+
export declare class LoggerFlushError extends Error {
|
|
24
|
+
readonly cause?: unknown | undefined;
|
|
25
|
+
/** Number of log entries that could not be flushed. */
|
|
26
|
+
readonly pendingCount: number;
|
|
27
|
+
constructor(message: string, pendingCount: number, cause?: unknown | undefined);
|
|
28
|
+
}
|
|
14
29
|
/**
|
|
15
30
|
* noopLogger — convenience for tests where logs are not asserted.
|
|
16
31
|
*/
|
|
17
32
|
export declare const noopLogger: LoggerPort;
|
|
33
|
+
/**
|
|
34
|
+
* Wrap any LoggerPort implementation with OTel spans per log call.
|
|
35
|
+
* Each log level emits a short-lived span capturing the level and
|
|
36
|
+
* optional metadata. Gracefully degrades to noop spans when no OTel
|
|
37
|
+
* SDK is installed.
|
|
38
|
+
*
|
|
39
|
+
* Usage:
|
|
40
|
+
* const raw: LoggerPort = pino();
|
|
41
|
+
* const traced = createTracedLoggerPort(raw);
|
|
42
|
+
* traced.info("boot") // emits "logger.info" span
|
|
43
|
+
*/
|
|
44
|
+
export declare function createTracedLoggerPort(impl: LoggerPort): LoggerPort;
|
|
18
45
|
//# sourceMappingURL=logger.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;CACvD;AAID;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAOvB,KAAK,CAAC,EAAE,OAAO;IANjC,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACJ,KAAK,CAAC,EAAE,OAAO,YAAA;CAOlC;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,UAKxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA0DnE"}
|
package/dist/ports/logger.js
CHANGED
|
@@ -1,3 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* LoggerPort — structured logger interface.
|
|
3
|
+
*
|
|
4
|
+
* Shape matches Pino's child-logger subset. Host wires any concrete
|
|
5
|
+
* logger (pino, winston, console-shim) that implements these methods.
|
|
6
|
+
*
|
|
7
|
+
* OTel instrumentation: import { createTracedLoggerPort } to wrap any
|
|
8
|
+
* LoggerPort implementation with OpenTelemetry spans per log call.
|
|
9
|
+
* Gracefully degrades to noop spans when no OTel SDK is installed.
|
|
10
|
+
*/
|
|
11
|
+
import { SpanStatusCode, trace } from "@opentelemetry/api";
|
|
12
|
+
const PORT_TRACER = trace.getTracer("vauban-agent-sdk.ports", "0.1.0");
|
|
13
|
+
// ─── Typed errors ─────────────────────────────────────────────────────────────
|
|
14
|
+
/**
|
|
15
|
+
* Thrown when the log transport fails to flush pending buffers (disk full,
|
|
16
|
+
* network timeout on remote sink, or backend refused connection).
|
|
17
|
+
* Callers may retry flush or discard pending entries depending on criticality.
|
|
18
|
+
*/
|
|
19
|
+
export class LoggerFlushError extends Error {
|
|
20
|
+
cause;
|
|
21
|
+
/** Number of log entries that could not be flushed. */
|
|
22
|
+
pendingCount;
|
|
23
|
+
constructor(message, pendingCount, cause) {
|
|
24
|
+
super(message);
|
|
25
|
+
this.cause = cause;
|
|
26
|
+
this.name = "LoggerFlushError";
|
|
27
|
+
this.pendingCount = pendingCount;
|
|
28
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
1
31
|
/**
|
|
2
32
|
* noopLogger — convenience for tests where logs are not asserted.
|
|
3
33
|
*/
|
|
@@ -7,4 +37,61 @@ export const noopLogger = {
|
|
|
7
37
|
warn: () => { },
|
|
8
38
|
error: () => { },
|
|
9
39
|
};
|
|
40
|
+
/**
|
|
41
|
+
* Wrap any LoggerPort implementation with OTel spans per log call.
|
|
42
|
+
* Each log level emits a short-lived span capturing the level and
|
|
43
|
+
* optional metadata. Gracefully degrades to noop spans when no OTel
|
|
44
|
+
* SDK is installed.
|
|
45
|
+
*
|
|
46
|
+
* Usage:
|
|
47
|
+
* const raw: LoggerPort = pino();
|
|
48
|
+
* const traced = createTracedLoggerPort(raw);
|
|
49
|
+
* traced.info("boot") // emits "logger.info" span
|
|
50
|
+
*/
|
|
51
|
+
export function createTracedLoggerPort(impl) {
|
|
52
|
+
function tracedLog(level, objOrMsg, msg) {
|
|
53
|
+
PORT_TRACER.startActiveSpan(`logger.${level}`, {
|
|
54
|
+
attributes: {
|
|
55
|
+
"log.level": level,
|
|
56
|
+
"vauban.port.name": "logger",
|
|
57
|
+
},
|
|
58
|
+
}, (span) => {
|
|
59
|
+
try {
|
|
60
|
+
const fn = impl[level];
|
|
61
|
+
if (typeof fn !== "function") {
|
|
62
|
+
span.setStatus({
|
|
63
|
+
code: SpanStatusCode.ERROR,
|
|
64
|
+
message: `LoggerPort missing method: ${level}`,
|
|
65
|
+
});
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
if (msg !== undefined) {
|
|
69
|
+
fn(objOrMsg, msg);
|
|
70
|
+
}
|
|
71
|
+
else {
|
|
72
|
+
fn(objOrMsg);
|
|
73
|
+
}
|
|
74
|
+
span.setStatus({ code: SpanStatusCode.OK });
|
|
75
|
+
}
|
|
76
|
+
catch (err) {
|
|
77
|
+
span.setStatus({
|
|
78
|
+
code: SpanStatusCode.ERROR,
|
|
79
|
+
message: err instanceof Error ? err.message : String(err),
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
finally {
|
|
83
|
+
span.end();
|
|
84
|
+
}
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
return {
|
|
88
|
+
debug: (objOrMsg, msg) => tracedLog("debug", objOrMsg, msg),
|
|
89
|
+
info: (objOrMsg, msg) => tracedLog("info", objOrMsg, msg),
|
|
90
|
+
warn: (objOrMsg, msg) => tracedLog("warn", objOrMsg, msg),
|
|
91
|
+
error: (objOrMsg, msg) => tracedLog("error", objOrMsg, msg),
|
|
92
|
+
child: impl.child
|
|
93
|
+
? (bindings) => createTracedLoggerPort(impl.child(bindings))
|
|
94
|
+
: undefined,
|
|
95
|
+
};
|
|
96
|
+
}
|
|
10
97
|
//# sourceMappingURL=logger.js.map
|
package/dist/ports/logger.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ManifestRegistryPort contract tests (T-S1-1..T-S1-12).
|
|
3
|
+
*
|
|
4
|
+
* Applied to in-memory reference impl. Any ManifestRegistryPort adapter must satisfy all tests.
|
|
5
|
+
* Tests cover: registration, lookup, versioning, signature validation, revocation, compliance gating.
|
|
6
|
+
*/
|
|
7
|
+
import { type ManifestRegistryPort } from "./manifest-registry.js";
|
|
8
|
+
export declare const manifestRegistryPortContract: (factory: () => ManifestRegistryPort) => void;
|
|
9
|
+
//# sourceMappingURL=manifest-registry.contract.test.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manifest-registry.contract.test.d.ts","sourceRoot":"","sources":["../../src/ports/manifest-registry.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,KAAK,oBAAoB,EAI1B,MAAM,wBAAwB,CAAC;AA2KhC,eAAO,MAAM,4BAA4B,GACvC,SAAS,MAAM,oBAAoB,SAqIpC,CAAC"}
|