@vauban-org/agent-sdk 0.16.0

package/dist/ports/hitl.js

@@ -0,0 +1,76 @@
+/**
+ * HITLPort — Human-In-The-Loop state machine port.
+ *
+ * Plan v6 §1.7 + §3.4: State lives in Postgres (CC), NOT in MessagingChannel.
+ * Channels = transports; state = HITLPort + Postgres.
+ *
+ * State machine (legal transitions):
+ *   pending → approved | rejected | expired   ✅
+ *   approved | rejected → executed             ✅
+ *   expired → *                                ❌ terminal
+ *   approved → rejected (or inverse)           ❌ forbidden
+ *
+ * @public
+ */
+// Legal transition table: from → set of valid to states
+const LEGAL_TRANSITIONS = {
+    pending: new Set(["approved", "rejected", "expired"]),
+    approved: new Set(["executed"]),
+    rejected: new Set(["executed"]),
+    expired: new Set(),
+    executed: new Set(),
+};
+/**
+ * Thrown when a state-machine transition is attempted that violates the HITL
+ * state diagram (e.g. expired → approved, approved → rejected).
+ */
+export class InvalidStateTransitionError extends Error {
+    from;
+    to;
+    constructor(from, to) {
+        super(`Invalid HITL state transition: ${from} → ${to}`);
+        this.name = "InvalidStateTransitionError";
+        this.from = from;
+        this.to = to;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when a HITL request id is not found in the state store.
+ */
+export class HITLNotFoundError extends Error {
+    id;
+    constructor(id) {
+        super(`HITL request not found: ${id}`);
+        this.name = "HITLNotFoundError";
+        this.id = id;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Validate that a transition from → to is legal per the HITL state machine.
+ * Throws `InvalidStateTransitionError` if illegal.
+ */
+export function validateTransition(from, to) {
+    if (!LEGAL_TRANSITIONS[from].has(to)) {
+        throw new InvalidStateTransitionError(from, to);
+    }
+}
+// ─── Background expiry helper ────────────────────────────────────────────────
+/**
+ * Start a background interval that expires overdue pending requests.
+ *
+ * @param store    HITLPort implementation (must support internal expiry logic)
+ * @param intervalMs  Polling interval (default 60 000 ms)
+ * @returns NodeJS.Timeout — call clearInterval() to stop the job
+ */
+export function runExpireJob(store, intervalMs = 60_000) {
+    return setInterval(async () => {
+        if (typeof store._expireOverdue === "function") {
+            await store._expireOverdue().catch(() => {
+                // Background job: swallow errors to prevent process crash
+            });
+        }
+    }, intervalMs);
+}
+//# sourceMappingURL=hitl.js.map

package/dist/ports/hitl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl.js","sourceRoot":"","sources":["../../src/ports/hitl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,wDAAwD;AACxD,MAAM,iBAAiB,GAA8C;IACnE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACrD,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/B,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/B,OAAO,EAAE,IAAI,GAAG,EAAE;IAClB,QAAQ,EAAE,IAAI,GAAG,EAAE;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,CAAY;IAChB,EAAE,CAAY;IAEvB,YAAY,IAAe,EAAE,EAAa;QACxC,KAAK,CAAC,kCAAkC,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,EAAE,CAAS;IAEpB,YAAY,EAAU;QACpB,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAE,EAAa;IAC/D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,2BAA2B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AA4DD,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA0D,EAC1D,UAAU,GAAG,MAAM;IAEnB,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;QAC5B,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAC/C,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtC,0DAA0D;YAC5D,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC"}

package/dist/ports/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Ports — host-injected dependency interfaces consumed by agent plugins.
+ *
+ * The contract: agent packages depend ONLY on @vauban-org/agent-sdk and
+ * never on the host application. Host concrete wiring happens at boot
+ * via each agent's setXxxDeps() setter.
+ */
+export type { LoggerPort } from "./logger.js";
+export { noopLogger } from "./logger.js";
+export type { BrainPort, BrainEntry, BrainEntryInput, BrainQueryFilters, WorkingMemoryPort, EpisodicMemoryPort, EpisodicMemoryEntry, SemanticMemoryPort, ProceduralMemoryPort, ProceduralSkill, } from "./brain.js";
+export { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, } from "./brain.js";
+export type { OutcomePort, AgentRunRef } from "./outcome.js";
+export type { CloudEvent, EventBusPort } from "./event-bus.js";
+export type { DbPort, DbClient } from "./db.js";
+export type { AgentDescriptor, AgentRegistryPort } from "./agent-registry.js";
+export type { MessagingChannelPort, AlertLevel } from "./messaging.js";
+export { InvalidTargetError } from "./messaging.js";
+export type { LLMProviderPort, ChatRequest, ChatMessage, ChatUsage, ChatResponse, StreamDelta, } from "./llm-provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ports/index.d.ts.map

@@ -0,0 +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;AAEzC,YAAY,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEhD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/dist/ports/index.js

@@ -0,0 +1,4 @@
+export { noopLogger } from "./logger.js";
+export { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, } from "./brain.js";
+export { InvalidTargetError } from "./messaging.js";
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAWpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ports/key-provider.d.ts

@@ -0,0 +1,113 @@
+/**
+ * KeyProvider port — cryptographic key access for HMAC signing.
+ *
+ * Design intent:
+ *   - The host injects a concrete KeyProvider at boot.
+ *   - Agents and trace builders depend ONLY on the KeyProvider interface.
+ *   - No key material ever appears in trace files — only the keyId is stored.
+ *
+ * Implementations provided:
+ *   - EnvKeyProvider: reads keys from process.env[keyId] (hex-encoded).
+ *     hasColocationRisk() = true when TRACE_DB_URL is also in env
+ *     (key and DB on same host — forward secrecy concern).
+ *   - ExternalKMSKeyProvider: placeholder for Vault/AWS KMS/Azure Key Vault.
+ *     hasColocationRisk() = false (key material never touches the app host).
+ *
+ * Production notes:
+ *   - EnvKeyProvider is acceptable for dev/staging.
+ *   - For production audits, use ExternalKMSKeyProvider to satisfy
+ *     "key not co-located with data" compliance requirements.
+ *   - Both constructors throw in production-like environments when no
+ *     config is provided — fail-closed, never silently degrade.
+ *
+ * @module ports/key-provider
+ */
+/**
+ * Abstract key access port.
+ * Implementations are injected by the host at boot time.
+ */
+export interface KeyProvider {
+    /**
+     * Retrieve the raw key bytes for `keyId`.
+     * @throws Error if the key is not found or cannot be decoded.
+     */
+    getKey(keyId: string): Promise<Uint8Array>;
+    /**
+     * Returns true if the key material is co-located with the traced data
+     * (e.g. both in process.env on the same host).
+     *
+     * A true result does NOT block operation — it is a risk signal
+     * that should be surfaced in audit reports and monitoring.
+     * Callers may log a warning or increment a metric.
+     */
+    hasColocationRisk(): boolean;
+}
+/**
+ * KeyProvider that reads hex-encoded key bytes from process.env.
+ *
+ * Key format: hex string, e.g. `export TRACE_HMAC_KEY="deadbeef..."`
+ * Minimum recommended key length: 32 bytes (256 bits) for HMAC-SHA-256.
+ *
+ * Colocation risk:
+ *   hasColocationRisk() returns true when `TRACE_DB_URL` is set in the same
+ *   environment, indicating that the HMAC key and the database connection
+ *   string are both accessible to the same process — a forward-secrecy
+ *   concern noted in audit frameworks.
+ *   A warning is logged to stderr at construction time when this is detected.
+ *
+ * Production usage note:
+ *   Acceptable for dev and staging. For production compliance requirements
+ *   that mandate physical key separation, use ExternalKMSKeyProvider instead.
+ */
+export declare class EnvKeyProvider implements KeyProvider {
+    private readonly _hasColocationRisk;
+    constructor();
+    getKey(keyId: string): Promise<Uint8Array>;
+    hasColocationRisk(): boolean;
+}
+/**
+ * Options for ExternalKMSKeyProvider.
+ */
+export interface ExternalKMSKeyProviderOptions {
+    /**
+     * KMS endpoint URL (e.g. Vault transit engine, AWS KMS, Azure Key Vault).
+     * Required — no default to avoid silent misconfiguration.
+     */
+    endpoint: string;
+    /**
+     * Optional authentication token (injected via sealed secrets or Workload
+     * Identity). When absent, the implementation is expected to use
+     * environment-level ambient credentials (e.g. AWS Instance Role).
+     */
+    authToken?: string;
+}
+/**
+ * Placeholder KeyProvider for external KMS (HashiCorp Vault, AWS KMS, Azure Key Vault, …).
+ *
+ * This implementation is a STUB — it provides the correct interface and
+ * colocation risk semantics but does NOT make actual KMS calls.
+ * Replace the `getKey` body with your KMS client SDK call.
+ *
+ * hasColocationRisk() always returns false: key material is never present
+ * in the application process; it is fetched on demand from an external system.
+ */
+export declare class ExternalKMSKeyProvider implements KeyProvider {
+    private readonly endpoint;
+    private readonly authToken?;
+    constructor(options: ExternalKMSKeyProviderOptions);
+    /**
+     * Fetch the key from the external KMS.
+     *
+     * STUB: Replace this with your KMS client SDK call.
+     * Example (Vault transit):
+     *   const res = await fetch(`${this.endpoint}/v1/transit/keys/${keyId}`, { … });
+     *   return hexToUint8Array(await res.json().key_bytes);
+     */
+    getKey(keyId: string): Promise<Uint8Array>;
+    /**
+     * Always false: key material never resides in the application process.
+     * The key is fetched on demand from the external KMS endpoint.
+     */
+    hasColocationRisk(): boolean;
+}
+//# sourceMappingURL=key-provider.d.ts.map

package/dist/ports/key-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-provider.d.ts","sourceRoot":"","sources":["../../src/ports/key-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,iBAAiB,IAAI,OAAO,CAAC;CAC9B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;;IAevC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBhD,iBAAiB,IAAI,OAAO;CAG7B;AAID;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,YAAW,WAAW;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAExB,OAAO,EAAE,6BAA6B;IAWlD;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAUhD;;;OAGG;IACH,iBAAiB,IAAI,OAAO;CAG7B"}

package/dist/ports/key-provider.js

@@ -0,0 +1,119 @@
+/**
+ * KeyProvider port — cryptographic key access for HMAC signing.
+ *
+ * Design intent:
+ *   - The host injects a concrete KeyProvider at boot.
+ *   - Agents and trace builders depend ONLY on the KeyProvider interface.
+ *   - No key material ever appears in trace files — only the keyId is stored.
+ *
+ * Implementations provided:
+ *   - EnvKeyProvider: reads keys from process.env[keyId] (hex-encoded).
+ *     hasColocationRisk() = true when TRACE_DB_URL is also in env
+ *     (key and DB on same host — forward secrecy concern).
+ *   - ExternalKMSKeyProvider: placeholder for Vault/AWS KMS/Azure Key Vault.
+ *     hasColocationRisk() = false (key material never touches the app host).
+ *
+ * Production notes:
+ *   - EnvKeyProvider is acceptable for dev/staging.
+ *   - For production audits, use ExternalKMSKeyProvider to satisfy
+ *     "key not co-located with data" compliance requirements.
+ *   - Both constructors throw in production-like environments when no
+ *     config is provided — fail-closed, never silently degrade.
+ *
+ * @module ports/key-provider
+ */
+// ─── EnvKeyProvider ───────────────────────────────────────────────────────────
+/**
+ * KeyProvider that reads hex-encoded key bytes from process.env.
+ *
+ * Key format: hex string, e.g. `export TRACE_HMAC_KEY="deadbeef..."`
+ * Minimum recommended key length: 32 bytes (256 bits) for HMAC-SHA-256.
+ *
+ * Colocation risk:
+ *   hasColocationRisk() returns true when `TRACE_DB_URL` is set in the same
+ *   environment, indicating that the HMAC key and the database connection
+ *   string are both accessible to the same process — a forward-secrecy
+ *   concern noted in audit frameworks.
+ *   A warning is logged to stderr at construction time when this is detected.
+ *
+ * Production usage note:
+ *   Acceptable for dev and staging. For production compliance requirements
+ *   that mandate physical key separation, use ExternalKMSKeyProvider instead.
+ */
+export class EnvKeyProvider {
+    _hasColocationRisk;
+    constructor() {
+        // Detect colocation risk at construction time and warn once.
+        this._hasColocationRisk = typeof process.env["TRACE_DB_URL"] === "string";
+        if (this._hasColocationRisk) {
+            // Use stderr to avoid polluting structured log pipelines.
+            process.stderr.write("[WARN] EnvKeyProvider: TRACE_DB_URL detected in process.env — " +
+                "HMAC key and database URL are co-located on the same host. " +
+                "For production audit compliance, migrate to ExternalKMSKeyProvider.\n");
+        }
+    }
+    async getKey(keyId) {
+        const raw = process.env[keyId];
+        if (raw === undefined || raw.trim() === "") {
+            throw new Error(`EnvKeyProvider: key "${keyId}" not found in process.env. ` +
+                "Set the environment variable to a hex-encoded key (min 32 bytes).");
+        }
+        const hex = raw.trim();
+        if (!/^[0-9a-fA-F]+$/.test(hex) || hex.length % 2 !== 0) {
+            throw new Error(`EnvKeyProvider: key "${keyId}" is not a valid even-length hex string.`);
+        }
+        const bytes = new Uint8Array(hex.length / 2);
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+        }
+        return bytes;
+    }
+    hasColocationRisk() {
+        return this._hasColocationRisk;
+    }
+}
+/**
+ * Placeholder KeyProvider for external KMS (HashiCorp Vault, AWS KMS, Azure Key Vault, …).
+ *
+ * This implementation is a STUB — it provides the correct interface and
+ * colocation risk semantics but does NOT make actual KMS calls.
+ * Replace the `getKey` body with your KMS client SDK call.
+ *
+ * hasColocationRisk() always returns false: key material is never present
+ * in the application process; it is fetched on demand from an external system.
+ */
+export class ExternalKMSKeyProvider {
+    endpoint;
+    authToken;
+    constructor(options) {
+        if (!options.endpoint || options.endpoint.trim() === "") {
+            throw new Error("ExternalKMSKeyProvider: options.endpoint is required. " +
+                "Provide the KMS endpoint URL to prevent silent misconfiguration.");
+        }
+        this.endpoint = options.endpoint.trim();
+        this.authToken = options.authToken;
+    }
+    /**
+     * Fetch the key from the external KMS.
+     *
+     * STUB: Replace this with your KMS client SDK call.
+     * Example (Vault transit):
+     *   const res = await fetch(`${this.endpoint}/v1/transit/keys/${keyId}`, { … });
+     *   return hexToUint8Array(await res.json().key_bytes);
+     */
+    async getKey(keyId) {
+        // Suppress unused-variable warnings in stub
+        void this.endpoint;
+        void this.authToken;
+        throw new Error(`ExternalKMSKeyProvider.getKey("${keyId}"): stub not implemented. ` +
+            "Replace this method body with your KMS client SDK call.");
+    }
+    /**
+     * Always false: key material never resides in the application process.
+     * The key is fetched on demand from the external KMS endpoint.
+     */
+    hasColocationRisk() {
+        return false;
+    }
+}
+//# sourceMappingURL=key-provider.js.map

package/dist/ports/key-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-provider.js","sourceRoot":"","sources":["../../src/ports/key-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAwBH,iFAAiF;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACR,kBAAkB,CAAU;IAE7C;QACE,6DAA6D;QAC7D,IAAI,CAAC,kBAAkB,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC;QAC1E,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,0DAA0D;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gEAAgE;gBAC9D,6DAA6D;gBAC7D,uEAAuE,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,8BAA8B;gBACzD,mEAAmE,CACtE,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,0CAA0C,CACxE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;CACF;AAsBD;;;;;;;;;GASG;AACH,MAAM,OAAO,sBAAsB;IAChB,QAAQ,CAAS;IACjB,SAAS,CAAU;IAEpC,YAAY,OAAsC;QAChD,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,wDAAwD;gBACtD,kEAAkE,CACrE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,4CAA4C;QAC5C,KAAK,IAAI,CAAC,QAAQ,CAAC;QACnB,KAAK,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,4BAA4B;YACjE,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/ports/llm-provider.contract.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LLMProviderPort contract test suite.
+ *
+ * Reusable helper: any concrete adapter runs this suite to prove
+ * it satisfies the LLMProviderPort behavioral contract.
+ *
+ * Usage (vitest):
+ * ```typescript
+ * import { describe, it, expect, vi } from "vitest";
+ * import { llmProviderContract } from "@vauban-org/agent-sdk/ports/llm-provider.contract";
+ * import { MyAdapter } from "./my-adapter.js";
+ *
+ * llmProviderContract(() => new MyAdapter({ ... }));
+ * ```
+ *
+ * Tests use mocks — no real API calls.
+ *
+ * @public
+ */
+import { vi } from "vitest";
+import type { LLMProviderPort } from "./llm-provider.js";
+export declare function llmProviderContract(factory: () => LLMProviderPort): void;
+export { vi };
+//# sourceMappingURL=llm-provider.contract.d.ts.map

package/dist/ports/llm-provider.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.contract.d.ts","sourceRoot":"","sources":["../../src/ports/llm-provider.contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAA0B,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,mBAAmB,CAAC;AAmBtE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,eAAe,GAAG,IAAI,CAwFxE;AAGD,OAAO,EAAE,EAAE,EAAE,CAAC"}

package/dist/ports/llm-provider.contract.js

@@ -0,0 +1,111 @@
+/**
+ * LLMProviderPort contract test suite.
+ *
+ * Reusable helper: any concrete adapter runs this suite to prove
+ * it satisfies the LLMProviderPort behavioral contract.
+ *
+ * Usage (vitest):
+ * ```typescript
+ * import { describe, it, expect, vi } from "vitest";
+ * import { llmProviderContract } from "@vauban-org/agent-sdk/ports/llm-provider.contract";
+ * import { MyAdapter } from "./my-adapter.js";
+ *
+ * llmProviderContract(() => new MyAdapter({ ... }));
+ * ```
+ *
+ * Tests use mocks — no real API calls.
+ *
+ * @public
+ */
+import { describe, test, expect, vi } from "vitest";
+const MINIMAL_REQUEST = {
+    messages: [{ role: "user", content: "Hello" }],
+};
+const LONG_REQUEST = {
+    messages: [
+        {
+            role: "user",
+            content: "This is a much longer message with more content to estimate higher cost. ".repeat(20),
+        },
+    ],
+    maxTokens: 2048,
+};
+export function llmProviderContract(factory) {
+    describe("LLMProviderPort contract", () => {
+        test("complete() returns ChatResponse with content + usage", async () => {
+            const provider = factory();
+            const response = await provider.complete(MINIMAL_REQUEST);
+            expect(typeof response.content).toBe("string");
+            expect(typeof response.usage.inputTokens).toBe("number");
+            expect(typeof response.usage.outputTokens).toBe("number");
+            expect(response.usage.inputTokens).toBeGreaterThanOrEqual(0);
+            expect(response.usage.outputTokens).toBeGreaterThanOrEqual(0);
+            expect(typeof response.model).toBe("string");
+            expect(["stop", "length", "tool", "error"]).toContain(response.finishReason);
+        });
+        test("estimateCost() monotonic with token count", () => {
+            const provider = factory();
+            if (!provider.estimateCost)
+                return; // optional method
+            const shortCost = provider.estimateCost(MINIMAL_REQUEST);
+            const longCost = provider.estimateCost(LONG_REQUEST);
+            expect(typeof shortCost.usd).toBe("number");
+            expect(typeof longCost.usd).toBe("number");
+            expect(shortCost.usd).toBeGreaterThanOrEqual(0);
+            // Longer request must have higher or equal cost (monotonic)
+            expect(longCost.usd).toBeGreaterThanOrEqual(shortCost.usd);
+        });
+        test("handles 429 with retry or returns error finishReason", async () => {
+            const provider = factory();
+            // Even if the provider encounters 429, complete() must NOT throw.
+            // It should return finishReason: "error" or succeed via retry.
+            let threw = false;
+            let response = null;
+            try {
+                response = await provider.complete(MINIMAL_REQUEST);
+            }
+            catch {
+                threw = true;
+            }
+            expect(threw).toBe(false);
+            if (response) {
+                expect(["stop", "length", "tool", "error"]).toContain(response.finishReason);
+            }
+        });
+        test("respects abortSignal", async () => {
+            const provider = factory();
+            const controller = new AbortController();
+            controller.abort();
+            let threw = false;
+            let response = null;
+            try {
+                response = await provider.complete({
+                    ...MINIMAL_REQUEST,
+                    abortSignal: controller.signal,
+                });
+            }
+            catch {
+                threw = true;
+            }
+            // Must not throw. May return error finishReason.
+            expect(threw).toBe(false);
+            if (response) {
+                expect(["stop", "length", "tool", "error"]).toContain(response.finishReason);
+            }
+        });
+        test("propagates metadata.tenantId in usage", async () => {
+            const provider = factory();
+            // The adapter may use tenantId for routing/billing; the contract
+            // only requires complete() does not throw with metadata present.
+            const response = await provider.complete({
+                ...MINIMAL_REQUEST,
+                metadata: { tenantId: "tenant-abc", agentId: "agent-1" },
+            });
+            expect(response).toBeDefined();
+            expect(typeof response.usage.inputTokens).toBe("number");
+        });
+    });
+}
+// Re-export vi for consumers who need to create mocks inline
+export { vi };
+//# sourceMappingURL=llm-provider.contract.js.map

package/dist/ports/llm-provider.contract.js.map

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

package/dist/ports/llm-provider.d.ts

@@ -0,0 +1,63 @@
+/**
+ * LLMProviderPort — BYOM (Bring Your Own Model) abstraction.
+ *
+ * BYOM axiom (Brain entry 4fa36aad): the SDK ships ZERO default provider.
+ * Callers inject the concrete adapter at boot. No model name is hardcoded
+ * in this port file or any file that re-exports it.
+ *
+ * Plan v6 §3.2 — canonical interface.
+ *
+ * @public
+ */
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface ChatRequest {
+    messages: ChatMessage[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    abortSignal?: AbortSignal;
+    metadata?: {
+        tenantId?: string;
+        agentId?: string;
+        correlationId?: string;
+    };
+}
+export interface ChatUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /** Cost in USD. Optional — adapters that cannot compute it omit this field. */
+    costUsd?: number;
+}
+export interface ChatResponse {
+    content: string;
+    usage: ChatUsage;
+    model: string;
+    finishReason: "stop" | "length" | "tool" | "error";
+}
+export interface StreamDelta {
+    delta: string;
+    usage?: ChatUsage;
+}
+export interface LLMProviderPort {
+    /**
+     * Blocking completion — resolves when the full response is available.
+     * Never rejects on model error: return `finishReason: "error"` instead.
+     */
+    complete(req: ChatRequest): Promise<ChatResponse>;
+    /**
+     * Optional streaming completion.
+     * Each yielded chunk carries at minimum `delta`; final chunk may carry `usage`.
+     */
+    stream?(req: ChatRequest): AsyncIterable<StreamDelta>;
+    /**
+     * Optional cost estimation before a real call.
+     * Must be monotonically non-decreasing with token count.
+     */
+    estimateCost?(req: ChatRequest): {
+        usd: number;
+    };
+}
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/ports/llm-provider.d.ts.map

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

package/dist/ports/llm-provider.js

@@ -0,0 +1,13 @@
+/**
+ * LLMProviderPort — BYOM (Bring Your Own Model) abstraction.
+ *
+ * BYOM axiom (Brain entry 4fa36aad): the SDK ships ZERO default provider.
+ * Callers inject the concrete adapter at boot. No model name is hardcoded
+ * in this port file or any file that re-exports it.
+ *
+ * Plan v6 §3.2 — canonical interface.
+ *
+ * @public
+ */
+export {};
+//# sourceMappingURL=llm-provider.js.map

package/dist/ports/llm-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../../src/ports/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/ports/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LoggerPort — structured logger interface.
+ *
+ * Shape matches Pino's child-logger subset. Host wires any concrete
+ * logger (pino, winston, console-shim) that implements these methods.
+ */
+export interface LoggerPort {
+    debug(objOrMsg: object | string, msg?: string): void;
+    info(objOrMsg: object | string, msg?: string): void;
+    warn(objOrMsg: object | string, msg?: string): void;
+    error(objOrMsg: object | string, msg?: string): void;
+    child?(bindings: Record<string, unknown>): LoggerPort;
+}
+/**
+ * noopLogger — convenience for tests where logs are not asserted.
+ */
+export declare const noopLogger: LoggerPort;
+//# sourceMappingURL=logger.d.ts.map

package/dist/ports/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,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;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,UAKxB,CAAC"}

package/dist/ports/logger.js

@@ -0,0 +1,10 @@
+/**
+ * noopLogger — convenience for tests where logs are not asserted.
+ */
+export const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+//# sourceMappingURL=logger.js.map

package/dist/ports/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAe;IACpC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC"}

package/dist/ports/messaging.contract.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MessagingChannelPort contract test suite.
+ *
+ * Applied to all 5 adapters: Telegram, Slack, Discord, Console, MCP.
+ * HTTP adapters use vitest mock fetch — no real API calls.
+ *
+ * sprint-615:quick-2
+ */
+import type { MessagingChannelPort } from "./messaging.js";
+/**
+ * Shared contract applied to every MessagingChannelPort implementation.
+ *
+ * @param factory - Returns a fresh adapter instance for each test.
+ * @param opts    - Per-adapter overrides for special cases.
+ */
+export declare function messagingChannelContract(factory: () => MessagingChannelPort, opts?: {
+    /** Skip rate-limit test if the adapter cannot simulate 429 via fetch mock */
+    skipRateLimit?: boolean;
+    /** Adapter name for describe label */
+    name?: string;
+}): void;
+//# sourceMappingURL=messaging.contract.test.d.ts.map