@centerseedwu/naru-agent 0.2.0

package/dist/memory/pgvector-store.js

@@ -0,0 +1,89 @@
+import { toVectorLiteral } from "../utils/math.js";
+/**
+ * PostgreSQL + pgvector backed memory store. Requires `pg` as optional dependency.
+ */
+export class PgVectorMemoryStore {
+    pool;
+    tableName;
+    dimensions;
+    initialized = false;
+    constructor(config) {
+        this.pool = config.pool;
+        this.tableName = config.tableName ?? "naru_memories";
+        this.dimensions = config.dimensions ?? 1536;
+    }
+    async ensureTable() {
+        if (this.initialized)
+            return;
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL,
+        content TEXT NOT NULL,
+        metadata JSONB DEFAULT '{}',
+        embedding vector(${this.dimensions}),
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        updated_at TIMESTAMPTZ DEFAULT NOW()
+      )
+    `);
+        await this.pool.query(`
+      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_user_id
+      ON ${this.tableName}(user_id)
+    `);
+        this.initialized = true;
+    }
+    async add(item, embedding) {
+        await this.ensureTable();
+        await this.pool.query(`INSERT INTO ${this.tableName} (id, user_id, content, metadata, embedding, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7)
+       ON CONFLICT (id) DO UPDATE SET content = $3, metadata = $4, embedding = $5, updated_at = $7`, [
+            item.id,
+            item.userId,
+            item.content,
+            JSON.stringify(item.metadata),
+            toVectorLiteral(embedding),
+            item.createdAt,
+            item.updatedAt,
+        ]);
+    }
+    async search(userId, embedding, topK = 5) {
+        await this.ensureTable();
+        const result = await this.pool.query(`SELECT id, user_id, content, metadata, created_at, updated_at,
+              1 - (embedding <=> $1::vector) AS score
+       FROM ${this.tableName}
+       WHERE user_id = $2
+       ORDER BY embedding <=> $1::vector
+       LIMIT $3`, [toVectorLiteral(embedding), userId, topK]);
+        return result.rows.map((r) => ({
+            id: r.id,
+            userId: r.user_id,
+            content: r.content,
+            metadata: (r.metadata ?? {}),
+            score: r.score,
+            createdAt: new Date(r.created_at),
+            updatedAt: new Date(r.updated_at),
+        }));
+    }
+    async update(itemId, content, embedding) {
+        await this.ensureTable();
+        await this.pool.query(`UPDATE ${this.tableName} SET content = $1, embedding = $2, updated_at = NOW() WHERE id = $3`, [content, toVectorLiteral(embedding), itemId]);
+    }
+    async delete(itemId) {
+        await this.ensureTable();
+        await this.pool.query(`DELETE FROM ${this.tableName} WHERE id = $1`, [itemId]);
+    }
+    async getAll(userId) {
+        await this.ensureTable();
+        const result = await this.pool.query(`SELECT id, user_id, content, metadata, created_at, updated_at
+       FROM ${this.tableName} WHERE user_id = $1 ORDER BY created_at`, [userId]);
+        return result.rows.map((r) => ({
+            id: r.id,
+            userId: r.user_id,
+            content: r.content,
+            metadata: (r.metadata ?? {}),
+            createdAt: new Date(r.created_at),
+            updatedAt: new Date(r.updated_at),
+        }));
+    }
+}
+//# sourceMappingURL=pgvector-store.js.map

package/dist/memory/pgvector-store.js.map

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

package/dist/orchestration/channel.d.ts

@@ -0,0 +1,18 @@
+import type { ChatOptions } from "../types.js";
+import type { OrchestrationResult } from "./result.js";
+/**
+ * ChannelMessage — normalized input from any channel.
+ */
+export interface ChannelMessage {
+    text: string;
+    options?: ChatOptions;
+    raw?: unknown;
+}
+/**
+ * ChannelAdapter<TIn, TOut> — abstracts channel-specific I/O transformation.
+ */
+export interface ChannelAdapter<TIn = unknown, TOut = unknown> {
+    parseIncoming(input: TIn): ChannelMessage;
+    formatOutgoing(result: OrchestrationResult): TOut;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/orchestration/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/orchestration/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IAC3D,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,cAAc,CAAC;IAC1C,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnD"}

package/dist/orchestration/channel.js

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

package/dist/orchestration/channel.js.map

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

package/dist/orchestration/executor.d.ts

@@ -0,0 +1,19 @@
+import type { OrchestratorIntent } from "./intent.js";
+import type { OrchestrationResult } from "./result.js";
+/**
+ * BaseDirectExecutor — handles intents without calling the delegate LLM agent.
+ * Return null to fallthrough to the next executor or delegate.
+ */
+export interface BaseDirectExecutor<T extends string = string> {
+    /** Human-readable name for this executor (used in trace) */
+    readonly name: string;
+    /** Return true if this executor can handle the given intent */
+    canHandle(intent: OrchestratorIntent<T>): boolean;
+    /** Execute and return a result, or null to fallthrough */
+    execute(input: {
+        message: string;
+        intent: OrchestratorIntent<T>;
+        options?: Record<string, unknown>;
+    }): Promise<OrchestrationResult | null>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/orchestration/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/orchestration/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3D,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAClD,0DAA0D;IAC1D,OAAO,CAAC,KAAK,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CACzC"}

package/dist/orchestration/executor.js

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

package/dist/orchestration/executor.js.map

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

package/dist/orchestration/index.d.ts

@@ -0,0 +1,13 @@
+export { AgentOrchestrator } from "./orchestrator.js";
+export type { AgentChatDelegate, AgentOrchestratorConfig, LifecycleHooks } from "./orchestrator.js";
+export { DeterministicIntentResolver, LLMFallbackIntentResolver, } from "./intent.js";
+export type { GenericIntentObject, OrchestratorIntent, BaseIntentResolver, DeterministicPattern, IntentResolveInput, } from "./intent.js";
+export type { BaseDirectExecutor } from "./executor.js";
+export type { ChannelAdapter, ChannelMessage } from "./channel.js";
+export { InMemoryPendingStateManager, classifyConfirmationDisposition, } from "./pending.js";
+export type { PendingState, ConfirmationDisposition, BasePendingStateManager, } from "./pending.js";
+export { InMemorySessionStateStore, } from "./session-state.js";
+export type { AgentSessionState, BaseSessionStateStore, } from "./session-state.js";
+export type { AgentDecisionTrace, OrchestrationPhase, OrchestrationTimings, } from "./trace.js";
+export type { OrchestrationResult, PendingConfirmation } from "./result.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGpG,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/orchestration/index.js

@@ -0,0 +1,9 @@
+// Orchestrator
+export { AgentOrchestrator } from "./orchestrator.js";
+// Intent
+export { DeterministicIntentResolver, LLMFallbackIntentResolver, } from "./intent.js";
+// Pending state
+export { InMemoryPendingStateManager, classifyConfirmationDisposition, } from "./pending.js";
+// Session state
+export { InMemorySessionStateStore, } from "./session-state.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,SAAS;AACT,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAerB,gBAAgB;AAChB,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAOtB,gBAAgB;AAChB,OAAO,EACL,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/orchestration/intent.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Generic intent types and resolvers for the orchestration layer.
+ */
+export type GenericIntentObject = "greeting" | "query" | "action" | "confirmation" | "unknown";
+export interface OrchestratorIntent<T extends string = GenericIntentObject> {
+    object: T;
+    confidence: number;
+    requiresConfirmation?: boolean;
+}
+export interface IntentResolveInput {
+    message: string;
+    history?: unknown[];
+    sessionState?: unknown;
+}
+export interface BaseIntentResolver<T extends string = GenericIntentObject> {
+    resolve(input: IntentResolveInput): Promise<OrchestratorIntent<T>>;
+}
+export interface DeterministicPattern<T extends string = GenericIntentObject> {
+    pattern: RegExp;
+    intent: OrchestratorIntent<T>;
+}
+/**
+ * DeterministicIntentResolver — fast pattern matching, no LLM calls.
+ * Returns first matching pattern or unknown with confidence 0.
+ */
+export declare class DeterministicIntentResolver<T extends string = GenericIntentObject> implements BaseIntentResolver<T> {
+    private patterns;
+    constructor(patterns: DeterministicPattern<T>[]);
+    resolve(input: IntentResolveInput): Promise<OrchestratorIntent<T>>;
+}
+/**
+ * LLMFallbackIntentResolver — tries deterministic first, falls back to LLM classifier.
+ */
+export declare class LLMFallbackIntentResolver<T extends string = GenericIntentObject> implements BaseIntentResolver<T> {
+    private primary;
+    private fallbackAgent;
+    private parseResponse?;
+    constructor(config: {
+        primary: BaseIntentResolver<T>;
+        fallbackAgent: {
+            chat(message: string): Promise<{
+                content: string;
+            }>;
+        };
+        parseResponse?: (content: string) => OrchestratorIntent<T>;
+    });
+    resolve(input: IntentResolveInput): Promise<OrchestratorIntent<T>>;
+}
+//# sourceMappingURL=intent.d.ts.map

package/dist/orchestration/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/orchestration/intent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,OAAO,GACP,QAAQ,GACR,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,mBAAmB;IACxE,MAAM,EAAE,CAAC,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,mBAAmB;IACxE,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,mBAAmB;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,2BAA2B,CAAC,CAAC,SAAS,MAAM,GAAG,mBAAmB,CAC7E,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,QAAQ,CAA4B;gBAEhC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE;IAIzC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAQzE;AAED;;GAEG;AACH,qBAAa,yBAAyB,CAAC,CAAC,SAAS,MAAM,GAAG,mBAAmB,CAC3E,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,aAAa,CAA0D;IAC/E,OAAO,CAAC,aAAa,CAAC,CAA6C;gBAEvD,MAAM,EAAE;QAClB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC/B,aAAa,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACvE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAAC;KAC5D;IAMK,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CA2BzE"}

package/dist/orchestration/intent.js

@@ -0,0 +1,57 @@
+/**
+ * Generic intent types and resolvers for the orchestration layer.
+ */
+/**
+ * DeterministicIntentResolver — fast pattern matching, no LLM calls.
+ * Returns first matching pattern or unknown with confidence 0.
+ */
+export class DeterministicIntentResolver {
+    patterns;
+    constructor(patterns) {
+        this.patterns = patterns;
+    }
+    async resolve(input) {
+        for (const entry of this.patterns) {
+            if (entry.pattern.test(input.message)) {
+                return entry.intent;
+            }
+        }
+        return { object: "unknown", confidence: 0 };
+    }
+}
+/**
+ * LLMFallbackIntentResolver — tries deterministic first, falls back to LLM classifier.
+ */
+export class LLMFallbackIntentResolver {
+    primary;
+    fallbackAgent;
+    parseResponse;
+    constructor(config) {
+        this.primary = config.primary;
+        this.fallbackAgent = config.fallbackAgent;
+        this.parseResponse = config.parseResponse;
+    }
+    async resolve(input) {
+        const primaryResult = await this.primary.resolve(input);
+        if (primaryResult.object !== "unknown") {
+            return primaryResult;
+        }
+        // Fallback to LLM
+        const llmResponse = await this.fallbackAgent.chat(`Classify the intent of this message: "${input.message}". Return a JSON object with "object" (string) and "confidence" (number 0-1).`);
+        if (this.parseResponse) {
+            return this.parseResponse(llmResponse.content);
+        }
+        // Default parsing
+        try {
+            const parsed = JSON.parse(llmResponse.content);
+            return {
+                object: (parsed.object ?? "unknown"),
+                confidence: parsed.confidence ?? 0.5,
+            };
+        }
+        catch {
+            return { object: "unknown", confidence: 0 };
+        }
+    }
+}
+//# sourceMappingURL=intent.js.map

package/dist/orchestration/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/orchestration/intent.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH;;;GAGG;AACH,MAAM,OAAO,2BAA2B;IAE9B,QAAQ,CAA4B;IAE5C,YAAY,QAAmC;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAyB;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC,MAAM,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAc,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAE5B,OAAO,CAAwB;IAC/B,aAAa,CAA0D;IACvE,aAAa,CAA8C;IAEnE,YAAY,MAIX;QACC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAyB;QACrC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAExD,IAAI,aAAa,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvC,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,kBAAkB;QAClB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAC/C,yCAAyC,KAAK,CAAC,OAAO,+EAA+E,CACtI,CAAC;QAEF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QAED,kBAAkB;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO;gBACL,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAM;gBACzC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;aACrC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,SAAc,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;CACF"}

package/dist/orchestration/orchestrator.d.ts

@@ -0,0 +1,59 @@
+import type { NaruResult, ChatOptions } from "../types.js";
+import type { OrchestrationResult } from "./result.js";
+import type { BaseIntentResolver } from "./intent.js";
+import type { BaseDirectExecutor } from "./executor.js";
+import type { BasePendingStateManager } from "./pending.js";
+import type { BaseSessionStateStore } from "./session-state.js";
+import type { ChannelAdapter } from "./channel.js";
+/**
+ * AgentChatDelegate — any object with a chat() method.
+ * NaruAgent satisfies this structurally (duck typing).
+ */
+export interface AgentChatDelegate {
+    chat(message: string, options?: ChatOptions): Promise<NaruResult>;
+}
+export interface LifecycleHooks {
+    beforeMessage?: (message: string, options?: ChatOptions) => Promise<void> | void;
+    afterMessage?: (result: OrchestrationResult) => Promise<void> | void;
+    onError?: (error: unknown) => Promise<void> | void;
+}
+export interface AgentOrchestratorConfig<T extends string = string> {
+    /** Default delegate (fallback) */
+    delegate: AgentChatDelegate;
+    /** Named delegates — keys are intent.object values */
+    delegates?: Map<T, AgentChatDelegate>;
+    /** Intent resolver (optional) */
+    intentResolver?: BaseIntentResolver<T>;
+    /** Direct executors (optional, tried in order) */
+    directExecutors?: BaseDirectExecutor<T>[];
+    /** Pending state manager for confirmation flows */
+    pendingStateManager?: BasePendingStateManager;
+    /** Session state store for entity tracking */
+    sessionStateStore?: BaseSessionStateStore;
+    /** Channel adapter for channel-specific I/O */
+    channelAdapter?: ChannelAdapter;
+    /** Lifecycle hooks */
+    lifecycleHooks?: LifecycleHooks;
+    /** Custom confirmation classifier */
+    confirmationClassifier?: (message: string) => "confirm" | "reject" | "override";
+}
+/**
+ * AgentOrchestrator — wraps one or more AgentChatDelegate instances with:
+ *   Phase 0: Pending confirmation handling
+ *   Phase 1: Intent resolution
+ *   Phase 2: Direct execution (bypass LLM)
+ *   Phase 3: Delegate routing
+ *
+ * AgentOrchestrator itself satisfies AgentChatDelegate, enabling nesting.
+ */
+export declare class AgentOrchestrator<T extends string = string> implements AgentChatDelegate {
+    private config;
+    constructor(config: AgentOrchestratorConfig<T>);
+    private fireHook;
+    chat(message: string, options?: ChatOptions): Promise<OrchestrationResult>;
+    /**
+     * Process a channel-specific raw input through the channel adapter.
+     */
+    processChannel<TIn, TOut>(rawInput: TIn): Promise<TOut>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestration/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestration/orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAC;AAGnE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAChE,kCAAkC;IAClC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,sDAAsD;IACtD,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACtC,iCAAiC;IACjC,cAAc,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACvC,kDAAkD;IAClD,eAAe,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,+CAA+C;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qCAAqC;IACrC,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;CACjF;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CACtD,YAAW,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;YAIhC,QAAQ;IAUhB,IAAI,CACR,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,CAAC;IA4O/B;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAe9D"}

package/dist/orchestration/orchestrator.js

@@ -0,0 +1,216 @@
+import { v4 as uuidv4 } from "uuid";
+import { classifyConfirmationDisposition } from "./pending.js";
+/**
+ * AgentOrchestrator — wraps one or more AgentChatDelegate instances with:
+ *   Phase 0: Pending confirmation handling
+ *   Phase 1: Intent resolution
+ *   Phase 2: Direct execution (bypass LLM)
+ *   Phase 3: Delegate routing
+ *
+ * AgentOrchestrator itself satisfies AgentChatDelegate, enabling nesting.
+ */
+export class AgentOrchestrator {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async fireHook(fn) {
+        if (fn) {
+            try {
+                await fn();
+            }
+            catch {
+                // hooks do not affect main flow
+            }
+        }
+    }
+    async chat(message, options) {
+        const startTime = Date.now();
+        const traceId = uuidv4();
+        const sessionId = options?.sessionId ?? null;
+        const timings = { total: 0 };
+        let phaseReached = "delegate";
+        let orchestrationIntent = null;
+        let directExecutorUsed = null;
+        let delegateUsed = null;
+        // Fire beforeMessage hook
+        await this.fireHook(this.config.lifecycleHooks?.beforeMessage
+            ? () => this.config.lifecycleHooks.beforeMessage(message, options)
+            : undefined);
+        const buildDecisionTrace = (overrides) => ({
+            traceId,
+            phaseReached: overrides.phaseReached,
+            intentResolved: overrides.orchestrationIntent,
+            timings: overrides.timings,
+            directExecutorUsed: overrides.directExecutorUsed,
+            delegateUsed: overrides.delegateUsed,
+        });
+        const buildFinalResult = (baseResult, overrides) => {
+            const decisionTrace = buildDecisionTrace(overrides);
+            return {
+                ...baseResult,
+                content: overrides.content ?? baseResult.content,
+                orchestrationIntent: overrides.orchestrationIntent,
+                decisionTrace,
+                pendingConfirmation: overrides.pendingConfirmation ?? null,
+                sessionId: overrides.sessionId !== undefined ? overrides.sessionId : (sessionId ?? baseResult.sessionId),
+            };
+        };
+        // Cache session state to avoid triple fetch within the same chat() call
+        let cachedSessionState;
+        try {
+            // === Phase 0: Pending Confirmation ===
+            if (this.config.pendingStateManager && sessionId) {
+                const pending = await this.config.pendingStateManager.getPending(sessionId);
+                if (pending) {
+                    const classifier = this.config.confirmationClassifier ?? classifyConfirmationDisposition;
+                    const disposition = classifier(message);
+                    if (disposition === "confirm" || disposition === "reject") {
+                        // Handle confirmation/rejection
+                        await this.config.pendingStateManager.clearPending(sessionId);
+                        phaseReached = "pending_confirmation";
+                        timings.total = Date.now() - startTime;
+                        const confirmContent = disposition === "confirm"
+                            ? `Confirmed: ${pending.type}`
+                            : `Rejected: ${pending.type}`;
+                        const baseResult = {
+                            content: confirmContent,
+                            blocked: false,
+                            usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+                            intent: null,
+                            toolCalls: [],
+                            timings: { total: timings.total },
+                            sessionId,
+                            traceId,
+                            trace: null,
+                        };
+                        const result = buildFinalResult(baseResult, {
+                            phaseReached,
+                            orchestrationIntent: null,
+                            timings,
+                            directExecutorUsed: null,
+                            delegateUsed: null,
+                            pendingConfirmation: null,
+                        });
+                        await this.fireHook(this.config.lifecycleHooks?.afterMessage
+                            ? () => this.config.lifecycleHooks.afterMessage(result)
+                            : undefined);
+                        return result;
+                    }
+                    // override — clear pending, continue normal flow
+                    await this.config.pendingStateManager.clearPending(sessionId);
+                }
+            }
+            // === Phase 1: Intent Resolution ===
+            if (this.config.intentResolver) {
+                const intentStart = Date.now();
+                if (this.config.sessionStateStore && sessionId && cachedSessionState === undefined) {
+                    cachedSessionState = await this.config.sessionStateStore.get(sessionId);
+                }
+                orchestrationIntent = await this.config.intentResolver.resolve({
+                    message,
+                    sessionState: cachedSessionState ?? undefined,
+                });
+                timings.intentResolution = Date.now() - intentStart;
+            }
+            // === Phase 2: Direct Execution ===
+            if (this.config.directExecutors && orchestrationIntent) {
+                const execStart = Date.now();
+                for (const executor of this.config.directExecutors) {
+                    if (executor.canHandle(orchestrationIntent)) {
+                        const execResult = await executor.execute({
+                            message,
+                            intent: orchestrationIntent,
+                            options: options,
+                        });
+                        if (execResult !== null) {
+                            phaseReached = "direct_execution";
+                            directExecutorUsed = executor.name;
+                            timings.directExecution = Date.now() - execStart;
+                            timings.total = Date.now() - startTime;
+                            const result = buildFinalResult(execResult, {
+                                phaseReached,
+                                orchestrationIntent,
+                                timings,
+                                directExecutorUsed,
+                                delegateUsed: null,
+                            });
+                            await this.fireHook(this.config.lifecycleHooks?.afterMessage
+                                ? () => this.config.lifecycleHooks.afterMessage(result)
+                                : undefined);
+                            return result;
+                        }
+                    }
+                }
+            }
+            // === Phase 3: Delegate Routing ===
+            const delegateStart = Date.now();
+            let selectedDelegate = this.config.delegate;
+            let selectedDelegateName = "default";
+            if (orchestrationIntent && this.config.delegates) {
+                const mapped = this.config.delegates.get(orchestrationIntent.object);
+                if (mapped) {
+                    selectedDelegate = mapped;
+                    selectedDelegateName = orchestrationIntent.object;
+                }
+            }
+            // Enrich options with session state if available (use cached fetch)
+            let enrichedOptions = options;
+            if (this.config.sessionStateStore && sessionId) {
+                if (cachedSessionState === undefined) {
+                    cachedSessionState = await this.config.sessionStateStore.get(sessionId);
+                }
+                if (cachedSessionState) {
+                    enrichedOptions = { ...options, sessionState: cachedSessionState };
+                }
+            }
+            const delegateResult = await selectedDelegate.chat(message, enrichedOptions);
+            timings.delegate = Date.now() - delegateStart;
+            timings.total = Date.now() - startTime;
+            phaseReached = "delegate";
+            delegateUsed = selectedDelegateName;
+            // Update session state if applicable (reuse cached session state)
+            if (this.config.sessionStateStore && sessionId && delegateResult.sessionId) {
+                const newState = {
+                    sessionId,
+                    lastPresentedEntities: cachedSessionState?.lastPresentedEntities ?? [],
+                    metadata: cachedSessionState?.metadata ?? {},
+                    updatedAt: Date.now(),
+                };
+                await this.config.sessionStateStore.save(sessionId, newState);
+            }
+            const result = buildFinalResult(delegateResult, {
+                phaseReached,
+                orchestrationIntent,
+                timings,
+                directExecutorUsed,
+                delegateUsed,
+                sessionId: sessionId ?? delegateResult.sessionId,
+            });
+            await this.fireHook(this.config.lifecycleHooks?.afterMessage
+                ? () => this.config.lifecycleHooks.afterMessage(result)
+                : undefined);
+            return result;
+        }
+        catch (error) {
+            // Fire onError hook
+            await this.fireHook(this.config.lifecycleHooks?.onError
+                ? () => this.config.lifecycleHooks.onError(error)
+                : undefined);
+            // Re-throw after hook
+            throw error;
+        }
+    }
+    /**
+     * Process a channel-specific raw input through the channel adapter.
+     */
+    async processChannel(rawInput) {
+        if (!this.config.channelAdapter) {
+            throw new Error("No channelAdapter configured");
+        }
+        const channelMessage = this.config.channelAdapter.parseIncoming(rawInput);
+        const result = await this.chat(channelMessage.text, channelMessage.options);
+        return this.config.channelAdapter.formatOutgoing(result);
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestration/orchestrator.js.map

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

package/dist/orchestration/pending.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pending state management — tracks confirmations awaiting user response.
+ */
+export interface PendingState {
+    type: string;
+    payload: Record<string, unknown>;
+    createdAt: number;
+}
+export type ConfirmationDisposition = "confirm" | "reject" | "override";
+export interface BasePendingStateManager {
+    getPending(sessionId: string): Promise<PendingState | null>;
+    setPending(sessionId: string, state: PendingState): Promise<void>;
+    clearPending(sessionId: string): Promise<void>;
+}
+/**
+ * InMemoryPendingStateManager — simple in-memory Map implementation.
+ */
+export declare class InMemoryPendingStateManager implements BasePendingStateManager {
+    private store;
+    getPending(sessionId: string): Promise<PendingState | null>;
+    setPending(sessionId: string, state: PendingState): Promise<void>;
+    clearPending(sessionId: string): Promise<void>;
+}
+/**
+ * Default implementation to classify a user message's disposition toward a pending confirmation.
+ */
+export declare function classifyConfirmationDisposition(message: string): ConfirmationDisposition;
+//# sourceMappingURL=pending.d.ts.map

package/dist/orchestration/pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../src/orchestration/pending.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC5D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,qBAAa,2BAA4B,YAAW,uBAAuB;IACzE,OAAO,CAAC,KAAK,CAAmC;IAE1C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI3D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD;AAKD;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,GACd,uBAAuB,CAKzB"}