armature-agent-core 0.1.0

package/dist/mcpServer.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Memory entry types, aligned with common agent memory taxonomies.
+ */
+export type MemoryType = 'user' | 'feedback' | 'project' | 'reference' | 'episodic' | 'procedural' | 'fact';
+export interface MemoryEntry {
+    /** Unique entry ID */
+    id: string;
+    /** Memory type */
+    type: MemoryType;
+    /** Human-readable title or key */
+    title: string;
+    /** The memory content */
+    content: string;
+    /** Searchable tags */
+    tags?: string[];
+    /** ISO 8601 creation timestamp */
+    createdAt: string;
+    /** ISO 8601 last-updated timestamp */
+    updatedAt: string;
+    /** Session ID that created this memory */
+    sessionId?: string;
+    /** Relevance score (0-1), set by retrieval */
+    score?: number;
+    /** Arbitrary metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * How to search memories.
+ */
+export type MemorySearchMode = 
+/** Most recently updated first */
+'recency'
+/** Match by tags (exact) */
+ | 'tag'
+/** Substring match in title + content */
+ | 'text';
+export interface MemoryQuery {
+    /** Search mode */
+    mode: MemorySearchMode;
+    /** Text query (for 'text' mode) */
+    text?: string;
+    /** Tags to match (for 'tag' mode) */
+    tags?: string[];
+    /** Filter by memory type */
+    type?: MemoryType;
+    /** Maximum results to return */
+    limit?: number;
+}
+export interface MemoryStore {
+    /** Save or update a memory entry. */
+    save(entry: MemoryEntry): Promise<void>;
+    /** Load a single memory by ID. */
+    load(id: string): Promise<MemoryEntry | undefined>;
+    /** Search memories. */
+    search(query: MemoryQuery): Promise<MemoryEntry[]>;
+    /** Delete a memory by ID. */
+    delete(id: string): Promise<void>;
+    /** List all memories (optionally filtered by type). */
+    list(type?: MemoryType, limit?: number): Promise<MemoryEntry[]>;
+}
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private store;
+    save(entry: MemoryEntry): Promise<void>;
+    load(id: string): Promise<MemoryEntry | undefined>;
+    search(query: MemoryQuery): Promise<MemoryEntry[]>;
+    delete(id: string): Promise<void>;
+    list(type?: MemoryType, limit?: number): Promise<MemoryEntry[]>;
+    get size(): number;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,GACX,UAAU,GACV,YAAY,GACZ,MAAM,CAAA;AAEV,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,kBAAkB;IAClB,IAAI,EAAE,UAAU,CAAA;IAChB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB;AAC1B,kCAAkC;AAChC,SAAS;AACX,4BAA4B;GAC1B,KAAK;AACP,yCAAyC;GACvC,MAAM,CAAA;AAEV,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,IAAI,EAAE,gBAAgB,CAAA;IACtB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,4BAA4B;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,kCAAkC;IAClC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAA;IAClD,uBAAuB;IACvB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAClD,6BAA6B;IAC7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,uDAAuD;IACvD,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;CAChE;AAMD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,KAAK,CAAiC;IAExC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAKlD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6ClD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASrE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/memory.js

@@ -0,0 +1,65 @@
+// ---------------------------------------------------------------------------
+// Memory: provider-neutral persistent knowledge store for agents
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// InMemoryMemoryStore: reference implementation
+// ---------------------------------------------------------------------------
+export class InMemoryMemoryStore {
+    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 search(query) {
+        let entries = [...this.store.values()];
+        // Filter by type
+        if (query.type) {
+            entries = entries.filter(e => e.type === query.type);
+        }
+        // Apply search mode
+        switch (query.mode) {
+            case 'recency':
+                entries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+                break;
+            case 'tag':
+                if (query.tags && query.tags.length > 0) {
+                    const queryTags = new Set(query.tags);
+                    entries = entries.filter(e => e.tags?.some(t => queryTags.has(t)) ?? false);
+                    // Sort by number of matching tags (descending)
+                    entries.sort((a, b) => {
+                        const aMatches = a.tags?.filter(t => queryTags.has(t)).length ?? 0;
+                        const bMatches = b.tags?.filter(t => queryTags.has(t)).length ?? 0;
+                        return bMatches - aMatches;
+                    });
+                }
+                break;
+            case 'text':
+                if (query.text) {
+                    const lower = query.text.toLowerCase();
+                    entries = entries.filter(e => e.title.toLowerCase().includes(lower) ||
+                        e.content.toLowerCase().includes(lower));
+                }
+                break;
+        }
+        const limit = query.limit ?? 50;
+        return entries.slice(0, limit).map(e => structuredClone(e));
+    }
+    async delete(id) {
+        this.store.delete(id);
+    }
+    async list(type, limit) {
+        let entries = [...this.store.values()];
+        if (type) {
+            entries = entries.filter(e => e.type === type);
+        }
+        entries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        return entries.slice(0, limit ?? 100).map(e => structuredClone(e));
+    }
+    get size() {
+        return this.store.size;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/messages.d.ts

@@ -0,0 +1,54 @@
+import type { ToolCall, ToolResult } from './tools.js';
+export interface AgentAttachmentPart {
+    type: 'attachment';
+    mediaType: string;
+    fileId?: string;
+    name?: string;
+    text?: string;
+    data?: string;
+    url?: string;
+}
+export interface AgentTextPart {
+    type: 'text';
+    text: string;
+}
+export interface AgentReasoningPart {
+    type: 'reasoning';
+    text: string;
+    redacted?: boolean;
+}
+export interface AgentToolCallPart {
+    type: 'tool_call';
+    toolCall: ToolCall;
+}
+export interface AgentToolResultPart {
+    type: 'tool_result';
+    toolResult: ToolResult;
+}
+export type AgentContentPart = AgentAttachmentPart | AgentReasoningPart | AgentTextPart | AgentToolCallPart | AgentToolResultPart;
+export interface AgentMessageBase {
+    id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SystemMessage extends AgentMessageBase {
+    role: 'system';
+    parts: AgentTextPart[];
+}
+export interface UserMessage extends AgentMessageBase {
+    role: 'user';
+    parts: AgentContentPart[];
+}
+export interface AssistantMessage extends AgentMessageBase {
+    role: 'assistant';
+    parts: AgentContentPart[];
+}
+export interface EventMessage extends AgentMessageBase {
+    role: 'event';
+    name: string;
+    data?: Record<string, unknown>;
+    parts?: AgentContentPart[];
+}
+export type AgentMessage = AssistantMessage | EventMessage | SystemMessage | UserMessage;
+export declare function collectToolCalls(message: AgentMessage): ToolCall[];
+export declare function collectToolResults(message: AgentMessage): ToolResult[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,GACb,iBAAiB,GACjB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,YAAY,GACZ,aAAa,GACb,WAAW,CAAA;AAEf,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,EAAE,CAMlE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,EAAE,CAMtE"}

package/dist/messages.js

@@ -0,0 +1,13 @@
+export function collectToolCalls(message) {
+    const parts = 'parts' in message ? (message.parts ?? []) : [];
+    return parts
+        .filter((part) => part.type === 'tool_call')
+        .map(part => part.toolCall);
+}
+export function collectToolResults(message) {
+    const parts = 'parts' in message ? (message.parts ?? []) : [];
+    return parts
+        .filter((part) => part.type === 'tool_result')
+        .map(part => part.toolResult);
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAyEA,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,MAAM,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE7D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAA6B,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;SACtE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE7D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAA+B,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;SAC1E,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;AACjC,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,53 @@
+import type { ProviderCapabilities } from './capabilities.js';
+import type { AgentMessage } from './messages.js';
+import type { AgentToolDefinition, ToolCall } from './tools.js';
+export interface ProviderUsage {
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    toolCallCount?: number;
+    webSearchCount?: number;
+    providerMetrics?: Record<string, number | string | boolean>;
+}
+export interface ProviderRequest {
+    model: string;
+    messages: AgentMessage[];
+    tools?: AgentToolDefinition[];
+    maxOutputTokens?: number;
+    temperature?: number;
+    metadata?: Record<string, unknown>;
+}
+export type ProviderEvent = {
+    type: 'message_start';
+} | {
+    type: 'assistant_text_delta';
+    text: string;
+} | {
+    type: 'reasoning_delta';
+    text: string;
+} | {
+    type: 'tool_call';
+    toolCall: ToolCall;
+} | {
+    type: 'usage';
+    usage: ProviderUsage;
+} | {
+    type: 'done';
+    finishReason?: string;
+    usage?: ProviderUsage;
+} | {
+    type: 'error';
+    error: string;
+};
+export interface ProviderAdapter<PreparedRequest = unknown, RawEvent = unknown, WireMessage = unknown, WireTool = unknown> {
+    readonly id: string;
+    readonly capabilities: ProviderCapabilities;
+    prepare(request: ProviderRequest): PreparedRequest;
+    translateMessages(messages: AgentMessage[]): WireMessage[];
+    translateTools(tools: AgentToolDefinition[]): WireTool[];
+    parseEvent(event: RawEvent): ProviderEvent[];
+    normalizeUsage(rawUsage: unknown): ProviderUsage;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpC,MAAM,WAAW,eAAe,CAC9B,eAAe,GAAG,OAAO,EACzB,QAAQ,GAAG,OAAO,EAClB,WAAW,GAAG,OAAO,EACrB,QAAQ,GAAG,OAAO;IAElB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAA;IAClD,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAA;IAC1D,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,QAAQ,EAAE,CAAA;IACxD,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,EAAE,CAAA;IAC5C,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,aAAa,CAAA;CACjD"}

package/dist/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/runManifest.d.ts

@@ -0,0 +1,25 @@
+export type AgentStyle = 'coding' | 'research' | 'ops' | 'support' | 'workflow' | 'realtime_voice';
+export type RuntimeTopology = 'planner_executor_reviewer' | 'planner_parallel_synthesizer' | 'deterministic_runbook_with_approvals' | 'retrieval_first_single_agent' | 'graph_queue_state_machine' | 'interruptible_realtime_loop';
+export type StyleRouteSource = 'explicit' | 'query_source' | 'tool_bias' | 'default';
+export type StyleProfile = {
+    style: AgentStyle;
+    topology: RuntimeTopology;
+    toolBias: readonly string[];
+    memoryBias: string;
+    providerBias: string;
+};
+export type RunManifest = StyleProfile & {
+    routeSource: StyleRouteSource;
+    querySource: string;
+    foundationProviderId: string;
+    transportProvider: string;
+};
+export declare function getStyleProfile(style: AgentStyle): StyleProfile;
+export declare function createRunManifest(params: {
+    style: AgentStyle;
+    routeSource: StyleRouteSource;
+    querySource: string;
+    foundationProviderId: string;
+    transportProvider: string;
+}): RunManifest;
+//# sourceMappingURL=runManifest.d.ts.map

package/dist/runManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runManifest.d.ts","sourceRoot":"","sources":["../src/runManifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,UAAU,GACV,KAAK,GACL,SAAS,GACT,UAAU,GACV,gBAAgB,CAAA;AAEpB,MAAM,MAAM,eAAe,GACvB,2BAA2B,GAC3B,8BAA8B,GAC9B,sCAAsC,GACtC,8BAA8B,GAC9B,2BAA2B,GAC3B,6BAA6B,CAAA;AAEjC,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,CAAA;AAEpF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG;IACvC,WAAW,EAAE,gBAAgB,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AA+CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,KAAK,EAAE,UAAU,CAAA;IACjB,WAAW,EAAE,gBAAgB,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,iBAAiB,EAAE,MAAM,CAAA;CAC1B,GAAG,WAAW,CAQd"}

package/dist/runManifest.js

@@ -0,0 +1,57 @@
+const STYLE_PROFILES = {
+    coding: {
+        style: 'coding',
+        topology: 'planner_executor_reviewer',
+        toolBias: ['filesystem', 'shell', 'git', 'tests', 'search'],
+        memoryBias: 'working-memory-with-artifact-store',
+        providerBias: 'premium-reasoning-with-fast-patch-fallback',
+    },
+    research: {
+        style: 'research',
+        topology: 'planner_parallel_synthesizer',
+        toolBias: ['web', 'search', 'docs', 'notebooks'],
+        memoryBias: 'source-grounded-memory',
+        providerBias: 'long-context-reasoning',
+    },
+    ops: {
+        style: 'ops',
+        topology: 'deterministic_runbook_with_approvals',
+        toolBias: ['shell', 'infra', 'logs', 'dashboards'],
+        memoryBias: 'short-operational-memory',
+        providerBias: 'conservative-model-with-strict-policy',
+    },
+    support: {
+        style: 'support',
+        topology: 'retrieval_first_single_agent',
+        toolBias: ['knowledge-base', 'crm', 'ticketing'],
+        memoryBias: 'retrieval-centric-memory',
+        providerBias: 'balanced-low-latency',
+    },
+    workflow: {
+        style: 'workflow',
+        topology: 'graph_queue_state_machine',
+        toolBias: ['forms', 'apis', 'queues', 'schedulers'],
+        memoryBias: 'durable-workflow-state',
+        providerBias: 'balanced-tool-use',
+    },
+    realtime_voice: {
+        style: 'realtime_voice',
+        topology: 'interruptible_realtime_loop',
+        toolBias: ['audio', 'lightweight-tools', 'summaries'],
+        memoryBias: 'ephemeral-memory-with-summaries',
+        providerBias: 'realtime-low-latency',
+    },
+};
+export function getStyleProfile(style) {
+    return STYLE_PROFILES[style];
+}
+export function createRunManifest(params) {
+    return {
+        ...getStyleProfile(params.style),
+        routeSource: params.routeSource,
+        querySource: params.querySource,
+        foundationProviderId: params.foundationProviderId,
+        transportProvider: params.transportProvider,
+    };
+}
+//# sourceMappingURL=runManifest.js.map

package/dist/runManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runManifest.js","sourceRoot":"","sources":["../src/runManifest.ts"],"names":[],"mappings":"AAiCA,MAAM,cAAc,GAAqC;IACvD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;QAC3D,UAAU,EAAE,oCAAoC;QAChD,YAAY,EAAE,4CAA4C;KAC3D;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,8BAA8B;QACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC;QAChD,UAAU,EAAE,wBAAwB;QACpC,YAAY,EAAE,wBAAwB;KACvC;IACD,GAAG,EAAE;QACH,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,sCAAsC;QAChD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QAClD,UAAU,EAAE,0BAA0B;QACtC,YAAY,EAAE,uCAAuC;KACtD;IACD,OAAO,EAAE;QACP,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,8BAA8B;QACxC,QAAQ,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,WAAW,CAAC;QAChD,UAAU,EAAE,0BAA0B;QACtC,YAAY,EAAE,sBAAsB;KACrC;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC;QACnD,UAAU,EAAE,wBAAwB;QACpC,YAAY,EAAE,mBAAmB;KAClC;IACD,cAAc,EAAE;QACd,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,6BAA6B;QACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,WAAW,CAAC;QACrD,UAAU,EAAE,iCAAiC;QAC7C,YAAY,EAAE,sBAAsB;KACrC;CACF,CAAA;AAED,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,cAAc,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAMjC;IACC,OAAO;QACL,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAA;AACH,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,24 @@
+export interface AgentToolAnnotations {
+    readOnly?: boolean;
+    destructive?: boolean;
+    openWorld?: boolean;
+}
+export interface AgentToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations?: AgentToolAnnotations;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface ToolResult {
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,WAAW,CAAC,EAAE,oBAAoB,CAAA;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}

package/dist/tools.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":""}

package/dist/trace.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Span types that the agent runtime emits.
+ */
+export type AgentSpanType = 'session' | 'turn' | 'llm_request' | 'tool_call' | 'guardrail' | 'checkpoint' | 'handoff' | 'custom';
+export interface AgentSpan {
+    /** Unique span ID */
+    id: string;
+    /** Parent span ID (undefined for root spans) */
+    parentId?: string;
+    /** What kind of operation this span represents */
+    type: AgentSpanType;
+    /** Human-readable name */
+    name: string;
+    /** Start time (ISO 8601) */
+    startTime: string;
+    /** End time (ISO 8601); undefined if still open */
+    endTime?: string;
+    /** Arbitrary key-value attributes */
+    attributes: Record<string, string | number | boolean>;
+    /** Status: ok, error, or unset */
+    status: 'ok' | 'error' | 'unset';
+    /** Error message if status is 'error' */
+    error?: string;
+}
+/**
+ * Events emitted by the agent runtime for observability.
+ */
+export type AgentTraceEvent = {
+    type: 'span_start';
+    span: AgentSpan;
+} | {
+    type: 'span_end';
+    span: AgentSpan;
+} | {
+    type: 'span_error';
+    spanId: string;
+    error: string;
+} | {
+    type: 'metric';
+    name: string;
+    value: number;
+    unit?: string;
+    attributes?: Record<string, string | number | boolean>;
+} | {
+    type: 'log';
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+    attributes?: Record<string, unknown>;
+};
+/**
+ * Tracer: pluggable sink for agent trace events.
+ * Consumers implement this to connect to OTel, Datadog, console, etc.
+ */
+export interface AgentTracer {
+    /** Receive a trace event from the agent runtime */
+    emit(event: AgentTraceEvent): void;
+    /** Flush any buffered events (called at session end) */
+    flush?(): Promise<void>;
+}
+export declare const noopTracer: AgentTracer;
+export declare class ConsoleTracer implements AgentTracer {
+    emit(event: AgentTraceEvent): void;
+    flush(): Promise<void>;
+}
+export declare class BufferTracer implements AgentTracer {
+    readonly events: AgentTraceEvent[];
+    emit(event: AgentTraceEvent): void;
+    flush(): Promise<void>;
+    /** Get all spans that have ended */
+    getCompletedSpans(): AgentSpan[];
+    /** Get all metrics */
+    getMetrics(): Array<Extract<AgentTraceEvent, {
+        type: 'metric';
+    }>>;
+    clear(): void;
+}
+export declare function createSpanId(): string;
+export declare function startSpan(tracer: AgentTracer, type: AgentSpanType, name: string, attributes?: Record<string, string | number | boolean>, parentId?: string): AgentSpan;
+export declare function endSpan(tracer: AgentTracer, span: AgentSpan, status?: 'ok' | 'error', error?: string): AgentSpan;
+export declare function emitMetric(tracer: AgentTracer, name: string, value: number, unit?: string, attributes?: Record<string, string | number | boolean>): void;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,MAAM,GACN,aAAa,GACb,WAAW,GACX,WAAW,GACX,YAAY,GACZ,SAAS,GACT,QAAQ,CAAA;AAEZ,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,IAAI,EAAE,aAAa,CAAA;IACnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACrD,kCAAkC;IAClC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,CAAA;IAChC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;CAAE,GACtH;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAEtH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IAClC,wDAAwD;IACxD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAMD,eAAO,MAAM,UAAU,EAAE,WAGxB,CAAA;AAMD,qBAAa,aAAc,YAAW,WAAW;IAC/C,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAoB5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B;AAMD,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAK;IAEvC,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,oCAAoC;IACpC,iBAAiB,IAAI,SAAS,EAAE;IAMhC,sBAAsB;IACtB,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IAMjE,KAAK,IAAI,IAAI;CAGd;AAQD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAM,EAC1D,QAAQ,CAAC,EAAE,MAAM,GAChB,SAAS,CAYX;AAED,wBAAgB,OAAO,CACrB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,GAAE,IAAI,GAAG,OAAc,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,CASX;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI,CAEN"}

package/dist/trace.js

@@ -0,0 +1,92 @@
+// ---------------------------------------------------------------------------
+// Trace: provider-neutral observability contract for the agent kernel
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// NoopTracer: default when no tracer is configured
+// ---------------------------------------------------------------------------
+export const noopTracer = {
+    emit() { },
+    async flush() { },
+};
+// ---------------------------------------------------------------------------
+// ConsoleTracer: simple reference implementation for debugging
+// ---------------------------------------------------------------------------
+export class ConsoleTracer {
+    emit(event) {
+        switch (event.type) {
+            case 'span_start':
+                console.log(`[TRACE] START ${event.span.type}:${event.span.name} (${event.span.id})`);
+                break;
+            case 'span_end':
+                console.log(`[TRACE] END   ${event.span.type}:${event.span.name} (${event.span.id}) status=${event.span.status}`);
+                break;
+            case 'span_error':
+                console.error(`[TRACE] ERROR span=${event.spanId}: ${event.error}`);
+                break;
+            case 'metric':
+                console.log(`[METRIC] ${event.name}=${event.value}${event.unit ? ' ' + event.unit : ''}`);
+                break;
+            case 'log':
+                console.log(`[${event.level.toUpperCase()}] ${event.message}`);
+                break;
+        }
+    }
+    async flush() { }
+}
+// ---------------------------------------------------------------------------
+// BufferTracer: collects events for testing and replay
+// ---------------------------------------------------------------------------
+export class BufferTracer {
+    events = [];
+    emit(event) {
+        this.events.push(event);
+    }
+    async flush() { }
+    /** Get all spans that have ended */
+    getCompletedSpans() {
+        return this.events
+            .filter((e) => e.type === 'span_end')
+            .map(e => e.span);
+    }
+    /** Get all metrics */
+    getMetrics() {
+        return this.events.filter((e) => e.type === 'metric');
+    }
+    clear() {
+        this.events.length = 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers: span lifecycle
+// ---------------------------------------------------------------------------
+let spanCounter = 0;
+export function createSpanId() {
+    return `span-${Date.now()}-${++spanCounter}`;
+}
+export function startSpan(tracer, type, name, attributes = {}, parentId) {
+    const span = {
+        id: createSpanId(),
+        parentId,
+        type,
+        name,
+        startTime: new Date().toISOString(),
+        attributes,
+        status: 'unset',
+    };
+    tracer.emit({ type: 'span_start', span });
+    return span;
+}
+export function endSpan(tracer, span, status = 'ok', error) {
+    const ended = {
+        ...span,
+        endTime: new Date().toISOString(),
+        status,
+        ...(error ? { error } : {}),
+    };
+    tracer.emit({ type: 'span_end', span: ended });
+    return ended;
+}
+export function emitMetric(tracer, name, value, unit, attributes) {
+    tracer.emit({ type: 'metric', name, value, unit, attributes });
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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