armature-agent-core 0.1.0

package/dist/capabilities.d.ts

@@ -0,0 +1,32 @@
+export type ProviderReasoningMode = 'none' | 'budget' | 'adaptive';
+export type RetryClassifier = 'rate_limit' | 'context_limit' | 'output_limit' | 'transient_network' | 'unsupported_feature';
+export interface UsageFieldSupport {
+    reasoningTokens: boolean;
+    cacheReadTokens: boolean;
+    cacheWriteTokens: boolean;
+    toolCallCount: boolean;
+    webSearchCount: boolean;
+}
+export interface ProviderCapabilities {
+    streaming: boolean;
+    toolCalls: boolean;
+    parallelToolCalls: boolean;
+    serverSideTools: boolean;
+    structuredOutput: boolean;
+    reasoningMode: ProviderReasoningMode;
+    imagesIn: boolean;
+    documentsIn: boolean;
+    webSearchNative: boolean;
+    maxContextTokens?: number;
+    maxOutputTokens?: number;
+    toolSchemaDialect: 'json-schema' | 'anthropic' | 'openai' | 'custom';
+    toolResultContentDialect: 'text' | 'content-blocks' | 'parts' | 'custom';
+    supportsPartialToolArgs: boolean;
+    supportsResume: boolean;
+    supportsPromptCaching: boolean;
+    usageFields: UsageFieldSupport;
+    retryClassifiers: RetryClassifier[];
+}
+export type BooleanCapabilityName = 'streaming' | 'toolCalls' | 'parallelToolCalls' | 'serverSideTools' | 'structuredOutput' | 'imagesIn' | 'documentsIn' | 'webSearchNative' | 'supportsPartialToolArgs' | 'supportsResume' | 'supportsPromptCaching';
+export declare function supportsCapability(capabilities: ProviderCapabilities, capability: BooleanCapabilityName): boolean;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;AAElE,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,qBAAqB,CAAA;AAEzB,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAA;IACxB,eAAe,EAAE,OAAO,CAAA;IACxB,gBAAgB,EAAE,OAAO,CAAA;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,EAAE,OAAO,CAAA;IACxB,gBAAgB,EAAE,OAAO,CAAA;IACzB,aAAa,EAAE,qBAAqB,CAAA;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpE,wBAAwB,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAA;IACxE,uBAAuB,EAAE,OAAO,CAAA;IAChC,cAAc,EAAE,OAAO,CAAA;IACvB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,gBAAgB,EAAE,eAAe,EAAE,CAAA;CACpC;AAED,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,yBAAyB,GACzB,gBAAgB,GAChB,uBAAuB,CAAA;AAE3B,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,oBAAoB,EAClC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAET"}

package/dist/capabilities.js

@@ -0,0 +1,4 @@
+export function supportsCapability(capabilities, capability) {
+    return capabilities[capability];
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAmDA,MAAM,UAAU,kBAAkB,CAChC,YAAkC,EAClC,UAAiC;IAEjC,OAAO,YAAY,CAAC,UAAU,CAAC,CAAA;AACjC,CAAC"}

package/dist/checkpoint.d.ts

@@ -0,0 +1,48 @@
+import type { AgentMessage } from './messages.js';
+export interface CheckpointEntry {
+    /** Unique checkpoint ID */
+    id: string;
+    /** Session ID this checkpoint belongs to */
+    sessionId: string;
+    /** ISO 8601 timestamp */
+    createdAt: string;
+    /** The conversation history at this point */
+    messages: AgentMessage[];
+    /** Opaque agent state (tool permissions, pending tasks, etc.) */
+    agentState?: Record<string, unknown>;
+    /** Provider-specific metadata (model, usage, etc.) */
+    metadata?: Record<string, unknown>;
+    /** Optional human-readable label */
+    label?: string;
+}
+export interface CheckpointQuery {
+    sessionId?: string;
+    label?: string;
+    /** Return at most N entries */
+    limit?: number;
+    /** Sort order by createdAt */
+    order?: 'asc' | 'desc';
+}
+export interface CheckpointStore {
+    /** Save a checkpoint. Overwrites if same ID exists. */
+    save(entry: CheckpointEntry): Promise<void>;
+    /** Load a single checkpoint by ID. Returns undefined if not found. */
+    load(id: string): Promise<CheckpointEntry | undefined>;
+    /** List checkpoints matching a query. */
+    list(query?: CheckpointQuery): Promise<CheckpointEntry[]>;
+    /** Delete a checkpoint by ID. No-op if not found. */
+    delete(id: string): Promise<void>;
+    /** Delete all checkpoints for a session. */
+    deleteSession(sessionId: string): Promise<void>;
+}
+export declare class InMemoryCheckpointStore implements CheckpointStore {
+    private store;
+    save(entry: CheckpointEntry): Promise<void>;
+    load(id: string): Promise<CheckpointEntry | undefined>;
+    list(query?: CheckpointQuery): Promise<CheckpointEntry[]>;
+    delete(id: string): Promise<void>;
+    deleteSession(sessionId: string): Promise<void>;
+    /** Test helper: returns the current count of stored checkpoints */
+    get size(): number;
+}
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAMjD,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACvB;AAMD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,sEAAsE;IACtE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAA;IACtD,yCAAyC;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACzD,qDAAqD;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,4CAA4C;IAC5C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAMD,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,KAAK,CAAqC;IAE5C,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAKtD,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAuBzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD,mEAAmE;IACnE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/checkpoint.js

@@ -0,0 +1,46 @@
+// ---------------------------------------------------------------------------
+// InMemoryCheckpointStore: reference implementation for testing
+// ---------------------------------------------------------------------------
+export class InMemoryCheckpointStore {
+    store = new Map();
+    async save(entry) {
+        this.store.set(entry.id, structuredClone(entry));
+    }
+    async load(id) {
+        const entry = this.store.get(id);
+        return entry ? structuredClone(entry) : undefined;
+    }
+    async list(query) {
+        let entries = [...this.store.values()];
+        if (query?.sessionId) {
+            entries = entries.filter(e => e.sessionId === query.sessionId);
+        }
+        if (query?.label) {
+            entries = entries.filter(e => e.label === query.label);
+        }
+        const order = query?.order ?? 'desc';
+        entries.sort((a, b) => {
+            const cmp = a.createdAt.localeCompare(b.createdAt);
+            return order === 'asc' ? cmp : -cmp;
+        });
+        if (query?.limit !== undefined && query.limit > 0) {
+            entries = entries.slice(0, query.limit);
+        }
+        return entries.map(e => structuredClone(e));
+    }
+    async delete(id) {
+        this.store.delete(id);
+    }
+    async deleteSession(sessionId) {
+        for (const [id, entry] of this.store) {
+            if (entry.sessionId === sessionId) {
+                this.store.delete(id);
+            }
+        }
+    }
+    /** Test helper: returns the current count of stored checkpoints */
+    get size() {
+        return this.store.size;
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAiDA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,OAAO,uBAAuB;IAC1B,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAA;IAElD,KAAK,CAAC,IAAI,CAAC,KAAsB;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChC,OAAO,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAuB;QAChC,IAAI,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QAEtC,IAAI,KAAK,EAAE,SAAS,EAAE,CAAC;YACrB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAA;QACxD,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,MAAM,CAAA;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;YAClD,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QACrC,CAAC,CAAC,CAAA;QAEF,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;QACzC,CAAC;QAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/guardrails.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Guardrail verdict:
+ * - 'pass': content is safe, continue
+ * - 'warn': content is suspicious but not blocked; advisory only
+ * - 'block': content must be rejected; agent loop should halt or retry
+ */
+export type GuardrailVerdict = 'pass' | 'warn' | 'block';
+export interface GuardrailResult {
+    verdict: GuardrailVerdict;
+    /** Human-readable reason when verdict is not 'pass' */
+    reason?: string;
+    /** Structured metadata for logging/tracing */
+    metadata?: Record<string, unknown>;
+}
+export interface InputGuardrail {
+    /** Unique name for this guardrail (used in traces and logs) */
+    name: string;
+    /** Evaluate user input text. Return a GuardrailResult. */
+    evaluate(input: string): GuardrailResult | Promise<GuardrailResult>;
+}
+export interface OutputGuardrail {
+    name: string;
+    /** Evaluate agent output text. Return a GuardrailResult. */
+    evaluate(output: string): GuardrailResult | Promise<GuardrailResult>;
+}
+export interface ToolGuardrailContext {
+    toolName: string;
+    input: unknown;
+    /** Whether the tool is read-only */
+    isReadOnly: boolean;
+}
+export interface ToolGuardrail {
+    name: string;
+    /** Evaluate a tool invocation. Return a GuardrailResult. */
+    evaluate(context: ToolGuardrailContext): GuardrailResult | Promise<GuardrailResult>;
+}
+export interface GuardrailPipelineResult {
+    /** Overall verdict: 'block' if any blocked, 'warn' if any warned, 'pass' otherwise */
+    verdict: GuardrailVerdict;
+    results: Array<{
+        name: string;
+    } & GuardrailResult>;
+}
+export declare function runInputGuardrails(guardrails: InputGuardrail[], input: string): Promise<GuardrailPipelineResult>;
+export declare function runOutputGuardrails(guardrails: OutputGuardrail[], output: string): Promise<GuardrailPipelineResult>;
+export declare function runToolGuardrails(guardrails: ToolGuardrail[], context: ToolGuardrailContext): Promise<GuardrailPipelineResult>;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../src/guardrails.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAA;IACzB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAMD,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACpE;AAMD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACrE;AAMD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACpF;AAMD,MAAM,WAAW,uBAAuB;IACtC,sFAAsF;IACtF,OAAO,EAAE,gBAAgB,CAAA;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC,CAAA;CACnD;AA0BD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,cAAc,EAAE,EAC5B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,eAAe,EAAE,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,aAAa,EAAE,EAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAElC"}

package/dist/guardrails.js

@@ -0,0 +1,30 @@
+// ---------------------------------------------------------------------------
+// Guardrails: typed input/output/tool validators for agent safety
+// ---------------------------------------------------------------------------
+async function runGuardrails(guardrails, input) {
+    const results = [];
+    let overallVerdict = 'pass';
+    for (const guardrail of guardrails) {
+        const result = await guardrail.evaluate(input);
+        results.push({ name: guardrail.name, ...result });
+        if (result.verdict === 'block') {
+            overallVerdict = 'block';
+            // Short-circuit on block: no need to evaluate remaining guardrails
+            break;
+        }
+        if (result.verdict === 'warn' && overallVerdict === 'pass') {
+            overallVerdict = 'warn';
+        }
+    }
+    return { verdict: overallVerdict, results };
+}
+export async function runInputGuardrails(guardrails, input) {
+    return runGuardrails(guardrails, input);
+}
+export async function runOutputGuardrails(guardrails, output) {
+    return runGuardrails(guardrails, output);
+}
+export async function runToolGuardrails(guardrails, context) {
+    return runGuardrails(guardrails, context);
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../src/guardrails.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAkE9E,KAAK,UAAU,aAAa,CAC1B,UAAuG,EACvG,KAAQ;IAER,MAAM,OAAO,GAA8C,EAAE,CAAA;IAC7D,IAAI,cAAc,GAAqB,MAAM,CAAA;IAE7C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QAEjD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,cAAc,GAAG,OAAO,CAAA;YACxB,mEAAmE;YACnE,MAAK;QACP,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;YAC3D,cAAc,GAAG,MAAM,CAAA;QACzB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA4B,EAC5B,KAAa;IAEb,OAAO,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAA6B,EAC7B,MAAc;IAEd,OAAO,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAA2B,EAC3B,OAA6B;IAE7B,OAAO,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;AAC3C,CAAC"}

package/dist/handoff.d.ts

@@ -0,0 +1,112 @@
+import type { AgentMessage } from './messages.js';
+import type { AgentToolDefinition } from './tools.js';
+/**
+ * Who is involved in a handoff.
+ */
+export interface HandoffParticipant {
+    /** Agent identifier (e.g., 'code-reviewer', 'data-analyst') */
+    agentId: string;
+    /** Human-readable description of this agent's role */
+    role?: string;
+}
+/**
+ * What context is transferred during a handoff.
+ */
+export interface HandoffContext {
+    /** Conversation history to pass (may be filtered/summarized) */
+    messages?: AgentMessage[];
+    /** Tools the target agent is allowed to use */
+    allowedTools?: string[];
+    /** Tool definitions to inject (custom tools from the source) */
+    toolDefinitions?: AgentToolDefinition[];
+    /** Working directory or scope */
+    cwd?: string;
+    /** Arbitrary structured context */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * How the handoff should be executed.
+ */
+export type HandoffMode = 
+/** Target runs to completion, result returned to source */
+'delegate'
+/** Source transfers full control; does not expect a return */
+ | 'transfer'
+/** Target runs in parallel; source continues independently */
+ | 'parallel';
+/**
+ * Permission policy for the handoff target.
+ */
+export type HandoffPermissionPolicy = 
+/** Target inherits source's permissions */
+'inherit'
+/** Target gets read-only subset */
+ | 'read_only'
+/** Target gets explicit tool allowlist from context */
+ | 'allowlist'
+/** Target runs with no tool permissions (analysis only) */
+ | 'none';
+/**
+ * A request to hand off work to another agent.
+ */
+export interface HandoffRequest {
+    /** Who is initiating the handoff */
+    source: HandoffParticipant;
+    /** Who should receive the work */
+    target: HandoffParticipant;
+    /** The task description / prompt for the target */
+    prompt: string;
+    /** Execution mode */
+    mode: HandoffMode;
+    /** Permission policy for the target */
+    permissionPolicy: HandoffPermissionPolicy;
+    /** Context to transfer */
+    context?: HandoffContext;
+    /** Maximum turns the target may execute (for 'delegate' mode) */
+    maxTurns?: number;
+    /** Timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * The result of a completed handoff.
+ */
+export type HandoffStatus = 'completed' | 'failed' | 'timeout' | 'cancelled';
+export interface HandoffResult {
+    /** The original request */
+    request: HandoffRequest;
+    /** Completion status */
+    status: HandoffStatus;
+    /** The target agent's final text output */
+    output?: string;
+    /** Messages produced by the target during execution */
+    messages?: AgentMessage[];
+    /** Error message if status is 'failed' */
+    error?: string;
+    /** Execution metadata (duration, token usage, etc.) */
+    metadata?: Record<string, unknown>;
+}
+export interface HandoffRouter {
+    /** Resolve which agent should handle a handoff request. Returns undefined if no match. */
+    resolve(request: HandoffRequest): HandoffParticipant | undefined;
+    /** List all available agents that can be handed off to. */
+    listAgents(): HandoffParticipant[];
+}
+export declare class InMemoryHandoffRouter implements HandoffRouter {
+    private agents;
+    register(agent: HandoffParticipant): void;
+    unregister(agentId: string): void;
+    resolve(request: HandoffRequest): HandoffParticipant | undefined;
+    listAgents(): HandoffParticipant[];
+}
+export declare function createHandoffRequest(params: {
+    sourceId: string;
+    targetId: string;
+    prompt: string;
+    mode?: HandoffMode;
+    permissionPolicy?: HandoffPermissionPolicy;
+    context?: HandoffContext;
+    maxTurns?: number;
+    timeoutMs?: number;
+}): HandoffRequest;
+export declare function createHandoffResult(request: HandoffRequest, status: HandoffStatus, output?: string, error?: string): HandoffResult;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

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

package/dist/handoff.js

@@ -0,0 +1,42 @@
+// ---------------------------------------------------------------------------
+// InMemoryHandoffRouter: simple registry-based implementation
+// ---------------------------------------------------------------------------
+export class InMemoryHandoffRouter {
+    agents = new Map();
+    register(agent) {
+        this.agents.set(agent.agentId, agent);
+    }
+    unregister(agentId) {
+        this.agents.delete(agentId);
+    }
+    resolve(request) {
+        return this.agents.get(request.target.agentId);
+    }
+    listAgents() {
+        return [...this.agents.values()];
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function createHandoffRequest(params) {
+    return {
+        source: { agentId: params.sourceId },
+        target: { agentId: params.targetId },
+        prompt: params.prompt,
+        mode: params.mode ?? 'delegate',
+        permissionPolicy: params.permissionPolicy ?? 'inherit',
+        context: params.context,
+        maxTurns: params.maxTurns,
+        timeoutMs: params.timeoutMs,
+    };
+}
+export function createHandoffResult(request, status, output, error) {
+    return {
+        request,
+        status,
+        ...(output !== undefined ? { output } : {}),
+        ...(error !== undefined ? { error } : {}),
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AA8GA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,MAAM,OAAO,qBAAqB;IACxB,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAA;IAEtD,QAAQ,CAAC,KAAyB;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,CAAC,OAAuB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAClC,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAU,oBAAoB,CAAC,MASpC;IACC,OAAO;QACL,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE;QACpC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,UAAU;QAC/B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,SAAS;QACtD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,MAAqB,EACrB,MAAe,EACf,KAAc;IAEd,OAAO;QACL,OAAO;QACP,MAAM;QACN,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './capabilities.js';
+export * from './checkpoint.js';
+export * from './guardrails.js';
+export * from './handoff.js';
+export * from './mcpServer.js';
+export * from './memory.js';
+export * from './messages.js';
+export * from './provider.js';
+export * from './runManifest.js';
+export * from './tools.js';
+export * from './trace.js';
+export * from './workflow.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":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './capabilities.js';
+export * from './checkpoint.js';
+export * from './guardrails.js';
+export * from './handoff.js';
+export * from './mcpServer.js';
+export * from './memory.js';
+export * from './messages.js';
+export * from './provider.js';
+export * from './runManifest.js';
+export * from './tools.js';
+export * from './trace.js';
+export * from './workflow.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":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA"}

package/dist/mcpServer.d.ts

@@ -0,0 +1,142 @@
+/**
+ * A tool that the MCP server exposes to clients.
+ */
+export interface MCPServerTool {
+    /** Unique tool name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for the tool's input */
+    inputSchema: Record<string, unknown>;
+    /** Execute the tool with validated input. Returns string content. */
+    execute(input: unknown): Promise<MCPToolResponse>;
+}
+export interface MCPToolResponse {
+    content: string;
+    isError?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A resource the MCP server exposes to clients (files, data, context).
+ */
+export interface MCPServerResource {
+    /** URI identifying this resource (e.g., "file:///workspace/README.md") */
+    uri: string;
+    /** Human-readable name */
+    name: string;
+    /** MIME type */
+    mimeType: string;
+    /** Description of what this resource contains */
+    description?: string;
+    /** Read the resource content. */
+    read(): Promise<MCPResourceContent>;
+}
+export interface MCPResourceContent {
+    uri: string;
+    mimeType: string;
+    text?: string;
+    blob?: string;
+}
+/**
+ * A prompt template the MCP server exposes to clients.
+ */
+export interface MCPServerPrompt {
+    /** Unique prompt name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Parameters this prompt accepts */
+    arguments?: MCPPromptArgument[];
+    /** Generate the prompt messages from arguments. */
+    generate(args: Record<string, string>): Promise<MCPPromptMessage[]>;
+}
+export interface MCPPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+export interface MCPPromptMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Sampling: allow the MCP client to request a completion from the server's model.
+ */
+export interface MCPSamplingRequest {
+    messages: MCPPromptMessage[];
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface MCPSamplingResponse {
+    role: 'assistant';
+    content: string;
+    model: string;
+    stopReason?: string;
+}
+export type MCPSamplingHandler = (request: MCPSamplingRequest) => Promise<MCPSamplingResponse>;
+export interface MCPServerCapabilities {
+    tools: boolean;
+    resources: boolean;
+    prompts: boolean;
+    sampling: boolean;
+}
+export interface MCPServer {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Declared capabilities */
+    capabilities: MCPServerCapabilities;
+    /** Register a tool */
+    addTool(tool: MCPServerTool): void;
+    /** Remove a tool by name */
+    removeTool(name: string): void;
+    /** List all registered tools */
+    listTools(): MCPServerTool[];
+    /** Execute a tool by name */
+    callTool(name: string, input: unknown): Promise<MCPToolResponse>;
+    /** Register a resource */
+    addResource(resource: MCPServerResource): void;
+    /** Remove a resource by URI */
+    removeResource(uri: string): void;
+    /** List all registered resources */
+    listResources(): MCPServerResource[];
+    /** Read a resource by URI */
+    readResource(uri: string): Promise<MCPResourceContent>;
+    /** Register a prompt */
+    addPrompt(prompt: MCPServerPrompt): void;
+    /** Remove a prompt by name */
+    removePrompt(name: string): void;
+    /** List all registered prompts */
+    listPrompts(): MCPServerPrompt[];
+    /** Generate a prompt by name */
+    getPrompt(name: string, args: Record<string, string>): Promise<MCPPromptMessage[]>;
+    /** Set the sampling handler */
+    setSamplingHandler(handler: MCPSamplingHandler): void;
+}
+export declare class InMemoryMCPServer implements MCPServer {
+    readonly name: string;
+    readonly version: string;
+    readonly capabilities: MCPServerCapabilities;
+    private tools;
+    private resources;
+    private prompts;
+    private samplingHandler?;
+    constructor(name: string, version: string);
+    addTool(tool: MCPServerTool): void;
+    removeTool(name: string): void;
+    listTools(): MCPServerTool[];
+    callTool(name: string, input: unknown): Promise<MCPToolResponse>;
+    addResource(resource: MCPServerResource): void;
+    removeResource(uri: string): void;
+    listResources(): MCPServerResource[];
+    readResource(uri: string): Promise<MCPResourceContent>;
+    addPrompt(prompt: MCPServerPrompt): void;
+    removePrompt(name: string): void;
+    listPrompts(): MCPServerPrompt[];
+    getPrompt(name: string, args: Record<string, string>): Promise<MCPPromptMessage[]>;
+    setSamplingHandler(handler: MCPSamplingHandler): void;
+    createSampling(request: MCPSamplingRequest): Promise<MCPSamplingResponse>;
+}
+//# sourceMappingURL=mcpServer.d.ts.map

package/dist/mcpServer.d.ts.map

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

package/dist/mcpServer.js

@@ -0,0 +1,57 @@
+// ---------------------------------------------------------------------------
+// MCP Server: contract for exposing agent capabilities to external consumers
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// InMemoryMCPServer: reference implementation
+// ---------------------------------------------------------------------------
+export class InMemoryMCPServer {
+    name;
+    version;
+    capabilities;
+    tools = new Map();
+    resources = new Map();
+    prompts = new Map();
+    samplingHandler;
+    constructor(name, version) {
+        this.name = name;
+        this.version = version;
+        this.capabilities = { tools: true, resources: true, prompts: true, sampling: false };
+    }
+    addTool(tool) { this.tools.set(tool.name, tool); }
+    removeTool(name) { this.tools.delete(name); }
+    listTools() { return [...this.tools.values()]; }
+    async callTool(name, input) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            return { content: `Tool "${name}" not found`, isError: true };
+        return tool.execute(input);
+    }
+    addResource(resource) { this.resources.set(resource.uri, resource); }
+    removeResource(uri) { this.resources.delete(uri); }
+    listResources() { return [...this.resources.values()]; }
+    async readResource(uri) {
+        const resource = this.resources.get(uri);
+        if (!resource)
+            throw new Error(`Resource "${uri}" not found`);
+        return resource.read();
+    }
+    addPrompt(prompt) { this.prompts.set(prompt.name, prompt); }
+    removePrompt(name) { this.prompts.delete(name); }
+    listPrompts() { return [...this.prompts.values()]; }
+    async getPrompt(name, args) {
+        const prompt = this.prompts.get(name);
+        if (!prompt)
+            throw new Error(`Prompt "${name}" not found`);
+        return prompt.generate(args);
+    }
+    setSamplingHandler(handler) {
+        this.samplingHandler = handler;
+        this.capabilities.sampling = true;
+    }
+    async createSampling(request) {
+        if (!this.samplingHandler)
+            throw new Error('Sampling not configured');
+        return this.samplingHandler(request);
+    }
+}
+//# sourceMappingURL=mcpServer.js.map