@vauban-org/agent-sdk 0.16.0

package/src/index.ts

@@ -0,0 +1,710 @@
+/**
+ * @vauban-org/agent-sdk — Public API v0.2.0
+ *
+ * MAX 8 top-level concepts. See CONTRACT.md for full signatures.
+ */
+
+// 1. AgentLoop (minimal-loop — multi-provider Anthropic+Groq cascade)
+export { AgentLoop } from "./loop/minimal-loop.js";
+export type { AgentLoopRunResult } from "./loop/minimal-loop.js";
+
+// 2. SdkAgentLoop (sdk-loop — Anthropic-direct with permissions)
+export { SdkAgentLoop } from "./loop/sdk-loop.js";
+export type {
+  SdkAgentLoopConfig,
+  SdkAgentLoopRunResult,
+  SdkToolRegistry,
+} from "./loop/sdk-loop.js";
+
+// Unified ToolRegistry contract (consumed by both loops + CC host).
+export {
+  ToolRegistryImpl,
+  isValidToolName,
+  zodToJsonSchema,
+} from "./tools/index.js";
+export type {
+  AgentTool,
+  MCPToolDefinition,
+  ToolError,
+  ToolErrorCode,
+  ToolRegistry,
+  ToolResult,
+} from "./tools/index.js";
+
+// 3. AgentRegistry + AgentDescriptor
+export { AgentRegistry, agentRegistry } from "./registry/agent-registry.js";
+export type {
+  AgentDescriptor,
+  AgentHandler,
+  AgentContext,
+  AgentResult,
+} from "./registry/agent-registry.js";
+
+// 4. BudgetState + CoherenceDetector
+export {
+  createBudgetState,
+  createCoherenceDetector,
+  compactToolLog,
+  emergencyContextSummary,
+} from "./budget/budget-state.js";
+export type {
+  AgentBudgetState,
+  CoherenceDetector,
+  LogMessage,
+} from "./budget/budget-state.js";
+
+// 5. ProviderRouter
+export {
+  createProviderRouter,
+  ProviderRouterError,
+} from "./router/provider-router.js";
+export type {
+  ProviderRouter,
+  ProviderRouterRequest,
+  ProviderRouterResponse,
+} from "./router/provider-router.js";
+
+// 6. ApprovalChannel + InMemoryApprovalStore
+export { InMemoryApprovalStore } from "./hitl/approval-channel.js";
+export type {
+  ApprovalChannel,
+  ApprovalRequest,
+  Approval,
+  ApprovalStore,
+  PendingApproval,
+} from "./hitl/approval-channel.js";
+
+// 6b. HITLPort — stateful HITL state machine (plan v6 §1.7)
+export type { HITLPort, HITLRequest, HITLState } from "./ports/hitl.js";
+export {
+  InvalidStateTransitionError,
+  HITLNotFoundError,
+  validateTransition,
+  runExpireJob,
+} from "./ports/hitl.js";
+export { MemoryHITLStateStore } from "./adapters/hitl/memory-state-store.js";
+export { PostgresHITLStateStore } from "./adapters/hitl/postgres-state-store.js";
+
+// 7. Utility helpers
+export {
+  sanitizeExternalInput,
+  keepSafeOnly,
+  DEFAULT_INSTRUCTION_PATTERNS,
+} from "./safety/sanitize.js";
+export type { SanitizedItem } from "./safety/sanitize.js";
+export {
+  recordOutcome,
+  getTracer,
+  agentSpan,
+  llmSpan,
+  toolSpan,
+  recordLlmUsage,
+  recordToolResult,
+} from "./tracking/gen-ai.js";
+export { createAgentRunTracker } from "./tracking/agent-run-tracker.js";
+export type {
+  AgentRunTracker,
+  AgentRunStartInput,
+  AgentRunStepDelta,
+  AgentRunFinish,
+  DbClient,
+} from "./tracking/agent-run-tracker.js";
+export { createBullMQRunner, BullMQRunner } from "./durable/bullmq-runner.js";
+export type {
+  BullMQRunnerConfig,
+  QueueArchetype,
+  DlqJobPayload,
+} from "./durable/bullmq-runner.js";
+export {
+  AGENT_IDS,
+  AGENT_ID_NAMESPACE,
+  getAgentId,
+  agentFromId,
+} from "./registry/agent-ids.js";
+export type { AgentType } from "./registry/agent-ids.js";
+
+// Permissions (consumed by SdkAgentLoop wiring)
+export {
+  mapScopesToSdkPermissions,
+  permitsCapability,
+  permitsMcpScopes,
+} from "./permissions/sdk-permissions.js";
+export type {
+  SdkPermissions,
+  SdkCapability,
+  BashMode,
+  FileIOMode,
+} from "./permissions/sdk-permissions.js";
+// Capability gate (Biscuit pre-dispatch hook)
+export { ALLOW_ALL_GATE } from "./permissions/capability-gate.js";
+export type {
+  CapabilityGate,
+  CapabilityGateCall,
+  CapabilityGateVerdict,
+} from "./permissions/capability-gate.js";
+// Capability-token auto-renewal at 80% lifetime
+export { RenewalManager } from "./permissions/renewal-manager.js";
+export type {
+  RenewalManagerOptions,
+  RenewalRequest,
+  RenewedToken,
+} from "./permissions/renewal-manager.js";
+// SDK permission mapping — pure projections (Biscuit ∩ cc:* scope)
+export {
+  scopeToSdkPermissions,
+  capabilityToSdkPermissions,
+} from "./sdk-permission-mapping.js";
+export type {
+  SdkPermissions as MappedSdkPermissions,
+  BashMode as MappedBashMode,
+  FileIoMode,
+  CcScope,
+} from "./sdk-permission-mapping.js";
+
+// HITL extras
+export type { ApprovalStatus } from "./hitl/approval-channel.js";
+
+// 8. Ports — host-injected dependency contracts (SDK v0.2.0)
+export type {
+  LoggerPort,
+  BrainPort,
+  BrainEntry,
+  BrainEntryInput,
+  BrainQueryFilters,
+  OutcomePort,
+  AgentRunRef,
+  DbPort,
+  MessagingChannelPort,
+  AlertLevel,
+  // LLM BYOM contracts (plan v6 §3.2)
+  LLMProviderPort,
+  ChatRequest,
+  ChatResponse,
+  ChatMessage,
+  ChatUsage,
+  StreamDelta,
+} from "./ports/index.js";
+export { noopLogger, InvalidTargetError } from "./ports/index.js";
+
+// 8b. LLM adapters — BYOM concrete implementations
+export { LiteLLMAdapter } from "./adapters/llm/litellm.js";
+export type { LiteLLMAdapterConfig } from "./adapters/llm/litellm.js";
+export { AnthropicDirectAdapter } from "./adapters/llm/anthropic-direct.js";
+export type { AnthropicDirectAdapterConfig } from "./adapters/llm/anthropic-direct.js";
+export { CascadeAdapter } from "./adapters/llm/cascade.js";
+export type { CascadeAdapterConfig } from "./adapters/llm/cascade.js";
+
+// 8c. AgentRegistryPort — port interface + adapters (sprint-615:quick-5)
+export type {
+  AgentDescriptor as AgentRegistryDescriptor,
+  AgentRegistryPort,
+} from "./ports/agent-registry.js";
+export { MemoryAgentRegistry } from "./adapters/registry/memory.js";
+export { PostgresAgentRegistry } from "./adapters/registry/postgres.js";
+
+// 8d. Messaging channel adapters (sprint-615:quick-2)
+export { ConsoleChannel } from "./adapters/messaging/console.js";
+export type { ConsoleChannelConfig } from "./adapters/messaging/console.js";
+export {
+  TelegramChannel,
+  TelegramRateLimitError,
+} from "./adapters/messaging/telegram.js";
+export type { TelegramChannelConfig } from "./adapters/messaging/telegram.js";
+export { SlackChannel } from "./adapters/messaging/slack.js";
+export type { SlackChannelConfig } from "./adapters/messaging/slack.js";
+export { DiscordChannel } from "./adapters/messaging/discord.js";
+export type { DiscordChannelConfig } from "./adapters/messaging/discord.js";
+export { MCPChannel } from "./adapters/messaging/mcp.js";
+export type {
+  MCPChannelConfig,
+  MCPClientLike,
+} from "./adapters/messaging/mcp.js";
+
+// 8e. OODA deps injection (sprint-615:quick-3 — plan v6 §3.7)
+export type { OODAAgentDeps } from "./orchestration/ooda/types.js";
+export {
+  MissingDependencyError,
+  DepsValidationError,
+} from "./orchestration/ooda/errors.js";
+
+// 9. Deprecation helper (SDK v0.3.0 — Sprint-457)
+export { deprecated } from "./deprecation.js";
+export type { DeprecationOptions } from "./deprecation.js";
+
+// 11. Traced port wrapper (SDK v0.3.0 — Sprint-460)
+export { tracedPort } from "./tracing/traced-port.js";
+export type { TracedPortOptions } from "./tracing/traced-port.js";
+
+// ── Vague 1.B promotions (sprint-616) ────────────────────────────────────────
+
+// 1.B.1 — Shared types (re-exported at bottom of file as §39)
+
+// 1.B.2 — AgentFactory + boot patterns
+export { createAgentFromConfig } from "./factory/agent-factory.js";
+export type {
+  AgentFactoryConfig,
+  AgentFactoryDeps,
+} from "./factory/agent-factory.js";
+export { loadAgentContext } from "./boot/load-agent-context.js";
+export type {
+  AgentContext as AgentBootContext,
+  LoadAgentContextOptions,
+} from "./boot/load-agent-context.js";
+export { loadRecentMemory } from "./boot/load-recent-memory.js";
+export type { LoadRecentMemoryOptions } from "./boot/load-recent-memory.js";
+
+// 1.B.3 — SkillRegistryBuilder
+export {
+  buildSkills,
+  buildSkillRegistry,
+} from "./skills/skill-registry-builder.js";
+export type {
+  BuildSkillsOptions,
+  SkillBuilderDeps,
+  SkillRegistryBundle,
+  DomainSkillEntry,
+} from "./skills/skill-registry-builder.js";
+export { BASE_SKILL_NAMES } from "./skills/base-skills.js";
+export type { BaseSkillName } from "./skills/base-skills.js";
+
+// 1.B.4 — Metrics
+export { createAgentMetrics } from "./metrics/create-agent-metrics.js";
+export type {
+  AgentMetrics,
+  CreateAgentMetricsOptions,
+} from "./metrics/create-agent-metrics.js";
+
+// 1.B.5 — Prompt + parser helpers
+export { buildOrientPrompt } from "./prompts/build-orient-prompt.js";
+export type { BuildOrientPromptOpts } from "./prompts/build-orient-prompt.js";
+export {
+  parseStructuredOutput,
+  ParseStructuredOutputError,
+} from "./llm/parse-structured-output.js";
+export type { ParseStructuredOutputOpts } from "./llm/parse-structured-output.js";
+
+// 1.B.6 — HITL infra (Slack + Telegram + API)
+export { sendHITLApprovalRequestSlack, buildBlockKit } from "./hitl/slack.js";
+export type { SendHITLSlackOpts, SlackApprovalResult } from "./hitl/slack.js";
+export {
+  sendHITLApprovalRequestTelegram,
+  buildTelegramText,
+} from "./hitl/telegram.js";
+export type {
+  SendHITLTelegramOpts,
+  TelegramApprovalResult,
+} from "./hitl/telegram.js";
+export { createNodeSlackCallbackHandler } from "./hitl/callback-handlers.js";
+export type { HITLHandlerResult, HITLCallbackData } from "./hitl/api.js";
+
+// 1.B.7 — Tier templates
+export {
+  createSimpleAgent,
+  createComplexAgent,
+  createReasoningAgent,
+} from "./templates/index.js";
+export type { ComplexAgentOptions } from "./templates/complex-agent.js";
+
+// 1.B.8 — EconomyRouter (new EconomyRouter from sprint-616 — existing re-exported at §37)
+export type {
+  EconomyRouterOpts,
+  ProviderTier,
+  CostEntry,
+} from "./economy/economy-router.js";
+
+// 12. Resilience primitives (SDK v0.5.0 — Sprint-468)
+export {
+  circuitBreaker,
+  CircuitOpenError,
+  idempotent,
+  hashKey,
+  BoundedTtlCache,
+  bulkhead,
+  BulkheadFullError,
+} from "./resilience/index.js";
+export type {
+  CircuitBreaker,
+  CircuitBreakerOptions,
+  CircuitState,
+  IdempotencyCache,
+  IdempotentOptions,
+  Bulkhead,
+  BulkheadOptions,
+  BulkheadStats,
+} from "./resilience/index.js";
+
+// 13. Outcomes module (SDK v0.5.1 — Sprint-522)
+export * from "./outcomes/index.js";
+
+// 14. Proof module (SDK v0.5.2 — Sprint-521 Bloc 1)
+export * from "./proof/index.js";
+
+// 15. Runs streaming + health (SDK v0.5.3 — sprint-523)
+export * from "./runs/index.js";
+export {
+  initVaubanSDK,
+  getSDKProvider,
+  getSDKProvider as getSDKConfig,
+  reportRunStart,
+  reportRunFinish,
+  createOtelClient,
+} from "./otel/ingest.js";
+export type {
+  VaubanSDKOptions,
+  IngestSpansResult,
+  OtelClient,
+} from "./otel/ingest.js";
+export type {
+  OtlpSpan,
+  OtlpAttribute,
+  OtlpAttributeValue,
+} from "./otel/types.js";
+
+// 16. OODA orchestration primitive (SDK v0.7.0 — sprint-525 Bloc 5a)
+//     + idempotency keys + bulkhead worker pool (SDK v0.8.3 — sprint-468)
+//     + withStructuredOutput Zod retry (SDK v0.11.0 — sprint-562:A5)
+export * from "./orchestration/index.js";
+export {
+  withStructuredOutput,
+  StructuredOutputError,
+} from "./orchestration/ooda/structured-output.js";
+export type {
+  StructuredOutputOptions,
+  StructuredOutputResult,
+} from "./orchestration/ooda/structured-output.js";
+
+// 25. Guardrails — pre/post phase enforcement + Poseidon proof hash (SDK v0.11.0 — sprint-563:B1)
+export {
+  runPreGuards,
+  runPostGuards,
+  guardrailViolationToEvent,
+  PII_GUARD,
+  createMaxInputLengthGuard,
+} from "./orchestration/ooda/guardrails.js";
+export type {
+  GuardrailDef,
+  GuardrailTiming,
+  GuardrailResult,
+  GuardrailViolation,
+} from "./orchestration/ooda/guardrails.js";
+
+// 26. Multi-agent handoff (SDK v0.11.0 — sprint-563:B2)
+export {
+  handoff,
+  HandoffCycleError,
+  handoffToEvent,
+  asAgentTool,
+} from "./orchestration/ooda/handoff.js";
+export type {
+  HandoffOptions,
+  HandoffResult,
+  AgentHandoffClient,
+} from "./orchestration/ooda/handoff.js";
+
+// 27. Phase-level model routing (SDK v0.11.0 — sprint-563:B4)
+export {
+  resolveForPhase,
+  getFallbackChain,
+} from "./orchestration/ooda/phase-routing.js";
+export type {
+  ModelSpec,
+  PhaseModelConfig,
+} from "./orchestration/ooda/phase-routing.js";
+
+// 17. Skill Catalog — 13 builtin skills + record_outcome (SDK v0.7.0 — sprint-525 quick-5)
+// 19. Skill Ledger types + resolveSkillsForAgent (SDK v0.8.0 — sprint-530:quick-4) — re-exported via skills/index.js
+export * from "./skills/index.js";
+
+// 18. Agent-specific types (SDK v0.7.1 — sprint-526 Bloc 5b)
+export * from "./agents/index.js";
+
+// 20. REST clients (SDK v0.8.2 — sprint-524:quick-9)
+export * from "./clients/index.js";
+
+// 21. Chaos testing helpers — type exports only (SDK v0.8.4 — sprint-477)
+// Runtime functions (Proxy-based) available via subpath:
+//   import { injectBrainFailure, networkJitter, wholeCircuit, exhaustResources }
+//     from "@vauban-org/agent-sdk/testing/chaos";
+export type {
+  InjectBrainFailureOptions,
+  ExhaustResourcesOptions,
+} from "./testing/chaos.js";
+
+// 10. Typed port errors (SDK v0.3.0 — Sprint-459) + OODA audit errors (A1 — sprint-561)
+export {
+  PortError,
+  BrainUnavailable,
+  BrainRateLimit,
+  BrainValidationError,
+  BrainAuthError,
+  DbConnectionLost,
+  DbQueryError,
+  OutcomeAttributionFailed,
+  isPortError,
+  isRetryablePortError,
+  MissingDryRunFlagError,
+} from "./errors.js";
+
+// 23. Replay module — ClockPort + RandomPort + LLMResponseCache + replayFrom (SDK v0.10.0 — sprint-561:a3)
+export {
+  RealClock,
+  RecordedClock,
+  ClockExhaustedError,
+  RealRandom,
+  RecordedRandom,
+  CryptoRandomDuringReplayError,
+  InMemoryLLMResponseCache,
+  hashLLMCacheKey,
+  replayFrom,
+  NonDeterministicReplayError,
+} from "./replay/index.js";
+export type {
+  ClockPort,
+  RandomPort,
+  LLMCacheKey,
+  LLMCacheEntry,
+  LLMResponseCache,
+  ReplayMode,
+  ReplayContext,
+  ReplayResult,
+  ReplayLoader,
+  ReplayRunner,
+} from "./replay/index.js";
+
+// 22. TRACE_V1 schema + canonical + PayloadPolicy + KeyProvider (SDK v0.10.0 — sprint-561:a2)
+export { TRACE_SCHEMA_VERSION } from "./trace/schema.js";
+export type {
+  Trace,
+  TraceStep,
+  SignedReceipt,
+  ReceiptStatus,
+} from "./trace/schema.js";
+export {
+  canonicalize,
+  NonSerializablePayloadError,
+} from "./trace/canonical.js";
+export { defaultPolicy, payloadHash } from "./trace/policy.js";
+export type {
+  PayloadPolicy,
+  PIIDetector,
+  PayloadHashResult,
+} from "./trace/policy.js";
+export { STRICT_PII_DETECTOR } from "./trace/strict-pii-detector.js";
+export {
+  EnvKeyProvider,
+  ExternalKMSKeyProvider,
+} from "./ports/key-provider.js";
+export type {
+  KeyProvider,
+  ExternalKMSKeyProviderOptions,
+} from "./ports/key-provider.js";
+
+// 24. ProofChain SHA-256 + verifyChain + TimestampPort + ReceiptQueue (SDK v0.10.0 — sprint-561:a4)
+export { sha256, hmacSha256 } from "./proof/sha256.js";
+export type {
+  ProofChain,
+  ProofChainEntry,
+  VerifyChainResult,
+} from "./proof/chain.js";
+export {
+  buildChain,
+  computeStepHash,
+  verifyChain,
+  GENESIS_PREV_HASH,
+} from "./proof/chain.js";
+export { NullTimestampPort } from "./ports/timestamp.js";
+export type { TimestampPort } from "./ports/timestamp.js";
+export {
+  FallbackAdapter,
+  AllAdaptersFailedError,
+} from "./proof/fallback-adapter.js";
+export type { ReceiptQueue, ReceiptQueueEntry } from "./proof/receipt-queue.js";
+export {
+  InMemoryReceiptQueue,
+  DEFAULT_BACKOFF_MS,
+  HmacInvalidError,
+} from "./proof/receipt-queue.js";
+
+// 28. Learning loop shadow mode (SDK v0.13.0 — sprint-564:C2)
+export {
+  shouldLearn,
+  extractSkillFromTrace,
+  GOLDEN_FIXTURES,
+} from "./orchestration/ooda/learn.js";
+export type {
+  LearningTrigger,
+  ExtractedSkill,
+  LearnOptions,
+} from "./orchestration/ooda/learn.js";
+
+// 29. Immune detection MAAG (SDK v0.13.0 — sprint-564:C3)
+export {
+  cosineSimilarity,
+  StressLedger,
+  validateGoldenFixtures,
+  GOLDEN_ATTACK_EMBEDDINGS,
+} from "./safety/immune.js";
+export type { ImmuneMemoryEntry, ImmuneMatch } from "./safety/immune.js";
+
+// 30. Trajectory export (SDK v0.13.0 — sprint-563:B3)
+export {
+  exportTrajectory,
+  serializeTrajectory,
+} from "./outcomes/trajectory.js";
+export type {
+  TrajectoryFormat,
+  TrajectoryOptions,
+  TrajectoryStep,
+  TrajectoryExport,
+} from "./outcomes/trajectory.js";
+
+// 31. AgentMeter + OutcomeGate (SDK v0.13.0 — sprint-563:B7)
+export { AgentMeter, validateOutcome } from "./outcomes/meter.js";
+export type {
+  MeterEntry,
+  MeterBalance,
+  MeterVerifyResult,
+  OutcomeGateResult,
+  OutcomeGateOptions,
+} from "./outcomes/meter.js";
+
+// 32. HTTP VCR cassettes (SDK v0.13.0 — sprint-563:B9)
+export { HttpVCR, UndeterministicSideEffectError } from "./replay/http-vcr.js";
+export type { VCRMode, VCRCassette, VCRStats } from "./replay/http-vcr.js";
+
+// 33. Compute primitive — withCompute + strategies (SDK v0.16.0 — sprint-580 Sprint A)
+export { withCompute } from "./compute/with-compute.js";
+export {
+  BudgetExhaustedError,
+  DeadlineExceededError,
+  InvalidStrategyError,
+} from "./compute/with-compute.js";
+export type {
+  WithComputeOptions,
+  WithComputeResult,
+} from "./compute/with-compute.js";
+export type {
+  ComputeContext,
+  Strategy,
+  StrategyResult,
+} from "./compute/types.js";
+export { singleShotStrategy } from "./compute/strategies/single-shot.js";
+export { bestOfNStrategy } from "./compute/strategies/best-of-n.js";
+export type {
+  BestOfNRewardModel,
+  BestOfNOptions,
+} from "./compute/strategies/best-of-n.js";
+export { bonMavStrategy } from "./compute/strategies/bon-mav.js";
+export type {
+  MAVAggregation,
+  BonMavOptions,
+} from "./compute/strategies/bon-mav.js";
+export { assertVerifierResult } from "./compute/verifier.js";
+export type { Verifier, VerifierResult } from "./compute/verifier.js";
+
+// 34. BrainPort eviction policies (sprint-580 Sprint A)
+export {
+  lruPolicy,
+  importanceWeightedPolicy,
+  agentControlledPolicy,
+} from "./ports/eviction-policy.js";
+export type {
+  WorkingMemoryEntry,
+  EvictionPolicy,
+} from "./ports/eviction-policy.js";
+
+// 35. AgentRegistry multi-kind capability cards (sprint-580 Sprint A)
+export { AGENT_KINDS } from "./registry/agent-capability.js";
+export type {
+  AgentKind,
+  CostTier,
+  LatencyTier,
+  AgentCapabilityCard,
+} from "./registry/agent-capability.js";
+
+// 37. Economy module — TierPolicy + OutcomeTracker + FleetCircuitBreaker + EconomyRouter (sprint-584 Sprint D)
+export type {
+  ModelTier,
+  TierPolicy,
+  OutcomeHook,
+  CycleCost,
+  EconomyMode,
+  EconomyRouterConfig,
+  RouteDecision,
+  CircuitBreakerConfig,
+} from "./economy/index.js";
+export {
+  DefaultTierPolicy,
+  lookupTier,
+  OutcomeTracker,
+  EconomyRouter,
+  FleetCircuitBreaker,
+} from "./economy/index.js";
+
+// 38. Event auth helpers — HMAC signing + verification (ADR-ECO-017 — sprint-615:quick-7)
+export { signEvent, canonicalEventString } from "./auth/sign-event.js";
+export { verifyEvent } from "./auth/verify-event.js";
+export type { VerifyEventOptions } from "./auth/verify-event.js";
+export { InMemoryNonceStore, RedisNonceStore } from "./auth/nonce-store.js";
+export type { NonceStore, RedisClientLike } from "./auth/nonce-store.js";
+export {
+  InvalidSignatureError,
+  ClockSkewError,
+  ReplayDetectedError,
+  UnknownSourceError,
+} from "./auth/errors.js";
+
+// Updated EventBus types (DomainEvent + EventSource + Subscription)
+export type {
+  DomainEvent,
+  EventSource,
+  Subscription,
+} from "./ports/event-bus.js";
+
+// 36. Constitution module — 5-axiom scorer + hard gate (sprint-581 Sprint B)
+export type {
+  AxiomId,
+  GateSeverity,
+  GateViolation,
+  SignalPoint,
+  CycleStep,
+  CycleMetadata,
+  CycleSnapshot,
+  ScoringResult,
+  ScoringFunction,
+  RegisteredScorer,
+  ParentCycleContext,
+  GateResult,
+  SignalBrainPort,
+  AxiomScoreEntry,
+} from "./constitution/index.js";
+export {
+  cycleSnapshotSchema,
+  INSTITUTIONNEL,
+  SOTA,
+  ROBUSTE,
+  ANTI_FRAGILE,
+  PROFITABLE,
+  BUILT_IN_AXIOMS,
+  SECRET_PATTERN,
+  institutionnelScorer,
+  sotaScorer,
+  robusteScorer,
+  antiFragileScorer,
+  profitableScorer,
+  ScorerRegistry,
+  defaultScorerRegistry,
+  HardGate,
+  hardGate,
+  publishSignal,
+  publishAllSignals,
+} from "./constitution/index.js";
+
+// 39. Shared agent types — promoted from Forge (Vague 1.B.1)
+export type {
+  EscalationLevel,
+  AgentAction,
+  AgentDependencies,
+} from "./types/agent.js";
+export { toSdkEscalationLevel } from "./types/escalation-mapping.js";
+export type { SdkEscalationLevel } from "./types/escalation-mapping.js";