@vauban-org/agent-sdk 0.16.0

package/dist/hitl/telegram.js

@@ -0,0 +1,227 @@
+/**
+ * HITL Telegram adapter — inline keyboard approval messages + HMAC-verified callback handler.
+ *
+ * Plan v6 §1.7: channels are transports; state lives in HITLPort (Postgres).
+ * Callback_data uses compact keys (a/v) to stay within Telegram's 64-byte limit.
+ *
+ * @public
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+const MAX_PAYLOAD_PREVIEW_BYTES = 1500;
+const TELEGRAM_API_BASE = "https://api.telegram.org";
+/**
+ * Record a new HITL approval request and send an inline-keyboard message via Telegram.
+ * Returns the approvalId (=request.id) and the Telegram message_id.
+ */
+export async function sendHITLApprovalRequestTelegram(opts) {
+    const { channel, hitlPort, request } = opts;
+    // Register in HITLPort state machine (pending)
+    const approvalId = await hitlPort.request(request);
+    const payloadSummary = summarizePayload(request.context);
+    const text = buildTelegramText({
+        agentSource: request.agentSource,
+        question: request.question,
+        approvalId,
+        payloadSummary,
+        deadline: request.deadline,
+    });
+    // Compact keys: "a" = approval_id, "v" = action (stays within 64 bytes for short UUIDs)
+    const makeButton = (label, action) => ({
+        text: label,
+        callback_data: JSON.stringify({ a: approvalId, v: action }),
+    });
+    const body = {
+        chat_id: channel.chatId,
+        text,
+        parse_mode: "MarkdownV2",
+        reply_markup: {
+            inline_keyboard: [
+                [
+                    makeButton("✅ Approve", "approve"),
+                    makeButton("❌ Reject", "reject"),
+                ],
+            ],
+        },
+    };
+    const url = `${TELEGRAM_API_BASE}/bot${channel.botToken}/sendMessage`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errBody = await response.text().catch(() => "<read error>");
+        throw new Error(`[hitl-telegram] Telegram API returned ${response.status}: ${errBody.slice(0, 300)}`);
+    }
+    const result = (await response.json());
+    if (!result.ok || !result.result) {
+        throw new Error(`[hitl-telegram] Telegram API error: ${result.description ?? "unknown"}`);
+    }
+    return { approvalId, messageId: result.result.message_id };
+}
+/**
+ * Build the MarkdownV2 message text for a HITL approval request.
+ * Exported for snapshot testing.
+ */
+export function buildTelegramText(opts) {
+    const { agentSource, question, approvalId, payloadSummary, deadline } = opts;
+    return [
+        `\u{1F6E1} *HITL Approval Required — ${escapeMd(agentSource)}*`,
+        "",
+        `*Agent:* ${escapeMd(agentSource)}`,
+        `*Question:* ${escapeMd(question)}`,
+        `*Deadline:* \`${escapeMd(deadline)}\``,
+        "",
+        `*Context:*`,
+        "```",
+        escapeCodeBlock(payloadSummary.slice(0, 3000)),
+        "```",
+        "",
+        `_${escapeMd(new Date().toISOString())} · ${escapeMd(approvalId.slice(0, 8))}_`,
+    ].join("\n");
+}
+/**
+ * Create a Telegram webhook callback handler.
+ *
+ * Validates optional HMAC signature, extracts callback_data (compact a/v format),
+ * calls hitlPort.resolve(), then answers the Telegram callback query.
+ * Idempotent: duplicate callbacks for an already-resolved request are silently ignored.
+ */
+export function createTelegramCallbackHandler(opts) {
+    const { hitlPort, botToken, callbackSecret } = opts;
+    return async (rawBody, headers) => {
+        let payload;
+        try {
+            payload = JSON.parse(rawBody);
+        }
+        catch {
+            return { status: 400, body: { ok: false, error: "invalid json" } };
+        }
+        // Optional HMAC signature check
+        if (callbackSecret) {
+            const sig = headers["x-telegram-hmac-sha256"];
+            if (!sig) {
+                return { status: 401, body: { ok: false, error: "missing signature" } };
+            }
+            if (!verifyTelegramSignature(rawBody, sig, callbackSecret)) {
+                return {
+                    status: 401,
+                    body: { ok: false, error: "invalid signature" },
+                };
+            }
+        }
+        // Only handle callback_query updates (button clicks)
+        const callbackQuery = payload["callback_query"];
+        if (!callbackQuery?.data) {
+            return { status: 200, body: { ok: true } };
+        }
+        let callbackData;
+        try {
+            callbackData = JSON.parse(callbackQuery.data);
+        }
+        catch {
+            return {
+                status: 400,
+                body: { ok: false, error: "invalid callback_data" },
+            };
+        }
+        // Support compact (a/v) and legacy (approval_id/action) formats
+        const approvalId = String(callbackData.a ?? callbackData.approval_id ?? "");
+        const actionRaw = String(callbackData.v ?? callbackData.action ?? "");
+        if (!approvalId || !actionRaw) {
+            return {
+                status: 400,
+                body: { ok: false, error: "missing approval_id or action" },
+            };
+        }
+        const decision = actionRaw === "approve" ? "approved" : "rejected";
+        let resolved = true;
+        try {
+            await hitlPort.resolve(approvalId, decision, "telegram");
+        }
+        catch (err) {
+            if (err instanceof Error &&
+                (err.name === "InvalidStateTransitionError" ||
+                    err.name === "HITLNotFoundError")) {
+                resolved = false;
+            }
+            else {
+                throw err;
+            }
+        }
+        // Answer the callback query (removes Telegram's loading spinner)
+        const callbackQueryId = String(callbackQuery.id ?? "");
+        if (callbackQueryId) {
+            const answerUrl = `${TELEGRAM_API_BASE}/bot${botToken}/answerCallbackQuery`;
+            await fetch(answerUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    callback_query_id: callbackQueryId,
+                    text: resolved
+                        ? `${decision === "approved" ? "✅" : "❌"} Action ${decision}`
+                        : "⚠️ Already resolved or not found",
+                    show_alert: true,
+                }),
+            }).catch(() => {
+                // Best-effort — don't fail the handler if Telegram API is slow
+            });
+        }
+        return { status: 200, body: { ok: true } };
+    };
+}
+// ─── HMAC verification ───────────────────────────────────────────────────────
+/**
+ * Verify the x-telegram-hmac-sha256 header using HMAC-SHA256 of the raw body.
+ *
+ * @public — exported for unit tests
+ */
+export function verifyTelegramSignature(rawBody, signature, secret) {
+    if (!signature || !secret)
+        return false;
+    const computed = createHmac("sha256", secret).update(rawBody).digest("hex");
+    try {
+        return timingSafeEqual(Buffer.from(computed, "hex"), Buffer.from(signature, "hex"));
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Plain message helper ─────────────────────────────────────────────────────
+/**
+ * Send a plain informational message to a Telegram chat (no buttons).
+ * Used for daily briefs and non-interactive notifications.
+ */
+export async function sendTelegramMessage(text, channel) {
+    if (!channel.botToken || !channel.chatId)
+        return;
+    const url = `${TELEGRAM_API_BASE}/bot${channel.botToken}/sendMessage`;
+    await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            chat_id: channel.chatId,
+            text: text.slice(0, 4096),
+            parse_mode: "Markdown",
+        }),
+        signal: AbortSignal.timeout(10_000),
+    }).catch((err) => {
+        // Best-effort non-interactive message — swallow errors
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[hitl-telegram] sendMessage failed: ${msg}\n`);
+    });
+}
+// ─── Private helpers ─────────────────────────────────────────────────────────
+function summarizePayload(payload) {
+    const raw = JSON.stringify(payload, null, 2);
+    if (Buffer.byteLength(raw, "utf-8") <= MAX_PAYLOAD_PREVIEW_BYTES)
+        return raw;
+    return `${raw.slice(0, MAX_PAYLOAD_PREVIEW_BYTES - 50)}\n... [truncated]`;
+}
+function escapeMd(text) {
+    return text.replace(/[_*[\]()~`>#+\-=|{}.!\\]/g, "\\$&");
+}
+function escapeCodeBlock(text) {
+    return text.replace(/[`\\]/g, "\\$&");
+}
+//# sourceMappingURL=telegram.js.map

package/dist/hitl/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/hitl/telegram.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,173 @@
+/**
+ * @vauban-org/agent-sdk — Public API v0.2.0
+ *
+ * MAX 8 top-level concepts. See CONTRACT.md for full signatures.
+ */
+export { AgentLoop } from "./loop/minimal-loop.js";
+export type { AgentLoopRunResult } from "./loop/minimal-loop.js";
+export { SdkAgentLoop } from "./loop/sdk-loop.js";
+export type { SdkAgentLoopConfig, SdkAgentLoopRunResult, SdkToolRegistry, } from "./loop/sdk-loop.js";
+export { ToolRegistryImpl, isValidToolName, zodToJsonSchema, } from "./tools/index.js";
+export type { AgentTool, MCPToolDefinition, ToolError, ToolErrorCode, ToolRegistry, ToolResult, } from "./tools/index.js";
+export { AgentRegistry, agentRegistry } from "./registry/agent-registry.js";
+export type { AgentDescriptor, AgentHandler, AgentContext, AgentResult, } from "./registry/agent-registry.js";
+export { createBudgetState, createCoherenceDetector, compactToolLog, emergencyContextSummary, } from "./budget/budget-state.js";
+export type { AgentBudgetState, CoherenceDetector, LogMessage, } from "./budget/budget-state.js";
+export { createProviderRouter, ProviderRouterError, } from "./router/provider-router.js";
+export type { ProviderRouter, ProviderRouterRequest, ProviderRouterResponse, } from "./router/provider-router.js";
+export { InMemoryApprovalStore } from "./hitl/approval-channel.js";
+export type { ApprovalChannel, ApprovalRequest, Approval, ApprovalStore, PendingApproval, } from "./hitl/approval-channel.js";
+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";
+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";
+export { mapScopesToSdkPermissions, permitsCapability, permitsMcpScopes, } from "./permissions/sdk-permissions.js";
+export type { SdkPermissions, SdkCapability, BashMode, FileIOMode, } from "./permissions/sdk-permissions.js";
+export { ALLOW_ALL_GATE } from "./permissions/capability-gate.js";
+export type { CapabilityGate, CapabilityGateCall, CapabilityGateVerdict, } from "./permissions/capability-gate.js";
+export { RenewalManager } from "./permissions/renewal-manager.js";
+export type { RenewalManagerOptions, RenewalRequest, RenewedToken, } from "./permissions/renewal-manager.js";
+export { scopeToSdkPermissions, capabilityToSdkPermissions, } from "./sdk-permission-mapping.js";
+export type { SdkPermissions as MappedSdkPermissions, BashMode as MappedBashMode, FileIoMode, CcScope, } from "./sdk-permission-mapping.js";
+export type { ApprovalStatus } from "./hitl/approval-channel.js";
+export type { LoggerPort, BrainPort, BrainEntry, BrainEntryInput, BrainQueryFilters, OutcomePort, AgentRunRef, DbPort, MessagingChannelPort, AlertLevel, LLMProviderPort, ChatRequest, ChatResponse, ChatMessage, ChatUsage, StreamDelta, } from "./ports/index.js";
+export { noopLogger, InvalidTargetError } from "./ports/index.js";
+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";
+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";
+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";
+export type { OODAAgentDeps } from "./orchestration/ooda/types.js";
+export { MissingDependencyError, DepsValidationError, } from "./orchestration/ooda/errors.js";
+export { deprecated } from "./deprecation.js";
+export type { DeprecationOptions } from "./deprecation.js";
+export { tracedPort } from "./tracing/traced-port.js";
+export type { TracedPortOptions } from "./tracing/traced-port.js";
+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";
+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";
+export { createAgentMetrics } from "./metrics/create-agent-metrics.js";
+export type { AgentMetrics, CreateAgentMetricsOptions, } from "./metrics/create-agent-metrics.js";
+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";
+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";
+export { createSimpleAgent, createComplexAgent, createReasoningAgent, } from "./templates/index.js";
+export type { ComplexAgentOptions } from "./templates/complex-agent.js";
+export type { EconomyRouterOpts, ProviderTier, CostEntry, } from "./economy/economy-router.js";
+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";
+export * from "./outcomes/index.js";
+export * from "./proof/index.js";
+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";
+export * from "./orchestration/index.js";
+export { withStructuredOutput, StructuredOutputError, } from "./orchestration/ooda/structured-output.js";
+export type { StructuredOutputOptions, StructuredOutputResult, } from "./orchestration/ooda/structured-output.js";
+export { runPreGuards, runPostGuards, guardrailViolationToEvent, PII_GUARD, createMaxInputLengthGuard, } from "./orchestration/ooda/guardrails.js";
+export type { GuardrailDef, GuardrailTiming, GuardrailResult, GuardrailViolation, } from "./orchestration/ooda/guardrails.js";
+export { handoff, HandoffCycleError, handoffToEvent, asAgentTool, } from "./orchestration/ooda/handoff.js";
+export type { HandoffOptions, HandoffResult, AgentHandoffClient, } from "./orchestration/ooda/handoff.js";
+export { resolveForPhase, getFallbackChain, } from "./orchestration/ooda/phase-routing.js";
+export type { ModelSpec, PhaseModelConfig, } from "./orchestration/ooda/phase-routing.js";
+export * from "./skills/index.js";
+export * from "./agents/index.js";
+export * from "./clients/index.js";
+export type { InjectBrainFailureOptions, ExhaustResourcesOptions, } from "./testing/chaos.js";
+export { PortError, BrainUnavailable, BrainRateLimit, BrainValidationError, BrainAuthError, DbConnectionLost, DbQueryError, OutcomeAttributionFailed, isPortError, isRetryablePortError, MissingDryRunFlagError, } from "./errors.js";
+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";
+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";
+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";
+export { shouldLearn, extractSkillFromTrace, GOLDEN_FIXTURES, } from "./orchestration/ooda/learn.js";
+export type { LearningTrigger, ExtractedSkill, LearnOptions, } from "./orchestration/ooda/learn.js";
+export { cosineSimilarity, StressLedger, validateGoldenFixtures, GOLDEN_ATTACK_EMBEDDINGS, } from "./safety/immune.js";
+export type { ImmuneMemoryEntry, ImmuneMatch } from "./safety/immune.js";
+export { exportTrajectory, serializeTrajectory, } from "./outcomes/trajectory.js";
+export type { TrajectoryFormat, TrajectoryOptions, TrajectoryStep, TrajectoryExport, } from "./outcomes/trajectory.js";
+export { AgentMeter, validateOutcome } from "./outcomes/meter.js";
+export type { MeterEntry, MeterBalance, MeterVerifyResult, OutcomeGateResult, OutcomeGateOptions, } from "./outcomes/meter.js";
+export { HttpVCR, UndeterministicSideEffectError } from "./replay/http-vcr.js";
+export type { VCRMode, VCRCassette, VCRStats } from "./replay/http-vcr.js";
+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";
+export { lruPolicy, importanceWeightedPolicy, agentControlledPolicy, } from "./ports/eviction-policy.js";
+export type { WorkingMemoryEntry, EvictionPolicy, } from "./ports/eviction-policy.js";
+export { AGENT_KINDS } from "./registry/agent-capability.js";
+export type { AgentKind, CostTier, LatencyTier, AgentCapabilityCard, } from "./registry/agent-capability.js";
+export type { ModelTier, TierPolicy, OutcomeHook, CycleCost, EconomyMode, EconomyRouterConfig, RouteDecision, CircuitBreakerConfig, } from "./economy/index.js";
+export { DefaultTierPolicy, lookupTier, OutcomeTracker, EconomyRouter, FleetCircuitBreaker, } from "./economy/index.js";
+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";
+export type { DomainEvent, EventSource, Subscription, } from "./ports/event-bus.js";
+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";
+export type { EscalationLevel, AgentAction, AgentDependencies, } from "./types/agent.js";
+export { toSdkEscalationLevel } from "./types/escalation-mapping.js";
+export type { SdkEscalationLevel } from "./types/escalation-mapping.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,147 @@
+/**
+ * @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";
+// 2. SdkAgentLoop (sdk-loop — Anthropic-direct with permissions)
+export { SdkAgentLoop } from "./loop/sdk-loop.js";
+// Unified ToolRegistry contract (consumed by both loops + CC host).
+export { ToolRegistryImpl, isValidToolName, zodToJsonSchema, } from "./tools/index.js";
+// 3. AgentRegistry + AgentDescriptor
+export { AgentRegistry, agentRegistry } from "./registry/agent-registry.js";
+// 4. BudgetState + CoherenceDetector
+export { createBudgetState, createCoherenceDetector, compactToolLog, emergencyContextSummary, } from "./budget/budget-state.js";
+// 5. ProviderRouter
+export { createProviderRouter, ProviderRouterError, } from "./router/provider-router.js";
+// 6. ApprovalChannel + InMemoryApprovalStore
+export { InMemoryApprovalStore } from "./hitl/approval-channel.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 { recordOutcome, getTracer, agentSpan, llmSpan, toolSpan, recordLlmUsage, recordToolResult, } from "./tracking/gen-ai.js";
+export { createAgentRunTracker } from "./tracking/agent-run-tracker.js";
+export { createBullMQRunner, BullMQRunner } from "./durable/bullmq-runner.js";
+export { AGENT_IDS, AGENT_ID_NAMESPACE, getAgentId, agentFromId, } from "./registry/agent-ids.js";
+// Permissions (consumed by SdkAgentLoop wiring)
+export { mapScopesToSdkPermissions, permitsCapability, permitsMcpScopes, } from "./permissions/sdk-permissions.js";
+// Capability gate (Biscuit pre-dispatch hook)
+export { ALLOW_ALL_GATE } from "./permissions/capability-gate.js";
+// Capability-token auto-renewal at 80% lifetime
+export { RenewalManager } from "./permissions/renewal-manager.js";
+// SDK permission mapping — pure projections (Biscuit ∩ cc:* scope)
+export { scopeToSdkPermissions, capabilityToSdkPermissions, } from "./sdk-permission-mapping.js";
+export { noopLogger, InvalidTargetError } from "./ports/index.js";
+// 8b. LLM adapters — BYOM concrete implementations
+export { LiteLLMAdapter } from "./adapters/llm/litellm.js";
+export { AnthropicDirectAdapter } from "./adapters/llm/anthropic-direct.js";
+export { CascadeAdapter } from "./adapters/llm/cascade.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 { TelegramChannel, TelegramRateLimitError, } from "./adapters/messaging/telegram.js";
+export { SlackChannel } from "./adapters/messaging/slack.js";
+export { DiscordChannel } from "./adapters/messaging/discord.js";
+export { MCPChannel } from "./adapters/messaging/mcp.js";
+export { MissingDependencyError, DepsValidationError, } from "./orchestration/ooda/errors.js";
+// 9. Deprecation helper (SDK v0.3.0 — Sprint-457)
+export { deprecated } from "./deprecation.js";
+// 11. Traced port wrapper (SDK v0.3.0 — Sprint-460)
+export { tracedPort } 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 { loadAgentContext } from "./boot/load-agent-context.js";
+export { loadRecentMemory } from "./boot/load-recent-memory.js";
+// 1.B.3 — SkillRegistryBuilder
+export { buildSkills, buildSkillRegistry, } from "./skills/skill-registry-builder.js";
+export { BASE_SKILL_NAMES } from "./skills/base-skills.js";
+// 1.B.4 — Metrics
+export { createAgentMetrics } from "./metrics/create-agent-metrics.js";
+// 1.B.5 — Prompt + parser helpers
+export { buildOrientPrompt } from "./prompts/build-orient-prompt.js";
+export { parseStructuredOutput, ParseStructuredOutputError, } from "./llm/parse-structured-output.js";
+// 1.B.6 — HITL infra (Slack + Telegram + API)
+export { sendHITLApprovalRequestSlack, buildBlockKit } from "./hitl/slack.js";
+export { sendHITLApprovalRequestTelegram, buildTelegramText, } from "./hitl/telegram.js";
+export { createNodeSlackCallbackHandler } from "./hitl/callback-handlers.js";
+// 1.B.7 — Tier templates
+export { createSimpleAgent, createComplexAgent, createReasoningAgent, } from "./templates/index.js";
+// 12. Resilience primitives (SDK v0.5.0 — Sprint-468)
+export { circuitBreaker, CircuitOpenError, idempotent, hashKey, BoundedTtlCache, bulkhead, BulkheadFullError, } 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";
+// 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";
+// 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";
+// 26. Multi-agent handoff (SDK v0.11.0 — sprint-563:B2)
+export { handoff, HandoffCycleError, handoffToEvent, asAgentTool, } 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";
+// 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";
+// 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";
+// 22. TRACE_V1 schema + canonical + PayloadPolicy + KeyProvider (SDK v0.10.0 — sprint-561:a2)
+export { TRACE_SCHEMA_VERSION } from "./trace/schema.js";
+export { canonicalize, NonSerializablePayloadError, } from "./trace/canonical.js";
+export { defaultPolicy, payloadHash } from "./trace/policy.js";
+export { STRICT_PII_DETECTOR } from "./trace/strict-pii-detector.js";
+export { EnvKeyProvider, ExternalKMSKeyProvider, } 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 { buildChain, computeStepHash, verifyChain, GENESIS_PREV_HASH, } from "./proof/chain.js";
+export { NullTimestampPort } from "./ports/timestamp.js";
+export { FallbackAdapter, AllAdaptersFailedError, } from "./proof/fallback-adapter.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";
+// 29. Immune detection MAAG (SDK v0.13.0 — sprint-564:C3)
+export { cosineSimilarity, StressLedger, validateGoldenFixtures, GOLDEN_ATTACK_EMBEDDINGS, } from "./safety/immune.js";
+// 30. Trajectory export (SDK v0.13.0 — sprint-563:B3)
+export { exportTrajectory, serializeTrajectory, } from "./outcomes/trajectory.js";
+// 31. AgentMeter + OutcomeGate (SDK v0.13.0 — sprint-563:B7)
+export { AgentMeter, validateOutcome } from "./outcomes/meter.js";
+// 32. HTTP VCR cassettes (SDK v0.13.0 — sprint-563:B9)
+export { HttpVCR, UndeterministicSideEffectError } 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 { singleShotStrategy } from "./compute/strategies/single-shot.js";
+export { bestOfNStrategy } from "./compute/strategies/best-of-n.js";
+export { bonMavStrategy } from "./compute/strategies/bon-mav.js";
+export { assertVerifierResult } from "./compute/verifier.js";
+// 34. BrainPort eviction policies (sprint-580 Sprint A)
+export { lruPolicy, importanceWeightedPolicy, agentControlledPolicy, } from "./ports/eviction-policy.js";
+// 35. AgentRegistry multi-kind capability cards (sprint-580 Sprint A)
+export { AGENT_KINDS } from "./registry/agent-capability.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 { InMemoryNonceStore, RedisNonceStore } from "./auth/nonce-store.js";
+export { InvalidSignatureError, ClockSkewError, ReplayDetectedError, UnknownSourceError, } from "./auth/errors.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";
+export { toSdkEscalationLevel } from "./types/escalation-mapping.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}