@centerseedwu/naru-agent 0.2.0

package/dist/orchestration/pending.js

@@ -0,0 +1,32 @@
+/**
+ * Pending state management — tracks confirmations awaiting user response.
+ */
+/**
+ * InMemoryPendingStateManager — simple in-memory Map implementation.
+ */
+export class InMemoryPendingStateManager {
+    store = new Map();
+    async getPending(sessionId) {
+        return this.store.get(sessionId) ?? null;
+    }
+    async setPending(sessionId, state) {
+        this.store.set(sessionId, state);
+    }
+    async clearPending(sessionId) {
+        this.store.delete(sessionId);
+    }
+}
+const CONFIRM_PATTERN = /^(好|確認|對|yes|y|ok|好的|是|沒問題|sure|confirm)$/i;
+const REJECT_PATTERN = /^(不要|取消|no|n|不|cancel|否|算了|不行|reject)$/i;
+/**
+ * Default implementation to classify a user message's disposition toward a pending confirmation.
+ */
+export function classifyConfirmationDisposition(message) {
+    const trimmed = message.trim();
+    if (CONFIRM_PATTERN.test(trimmed))
+        return "confirm";
+    if (REJECT_PATTERN.test(trimmed))
+        return "reject";
+    return "override";
+}
+//# sourceMappingURL=pending.js.map

package/dist/orchestration/pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.js","sourceRoot":"","sources":["../../src/orchestration/pending.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH;;GAEG;AACH,MAAM,OAAO,2BAA2B;IAC9B,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,KAAmB;QACrD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,eAAe,GAAG,4CAA4C,CAAC;AACrE,MAAM,cAAc,GAAG,yCAAyC,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAe;IAEf,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/orchestration/result.d.ts

@@ -0,0 +1,24 @@
+import type { NaruResult } from "../types.js";
+import type { AgentDecisionTrace } from "./trace.js";
+import type { OrchestratorIntent } from "./intent.js";
+export interface PendingConfirmation {
+    type: string;
+    payload: Record<string, unknown>;
+}
+/**
+ * OrchestrationResult extends NaruResult with orchestration-specific fields.
+ * All new fields are optional or have reasonable defaults.
+ *
+ * Note: `trace` from NaruResult (Trace | null) is preserved for backward compat.
+ * The orchestration decision trace is exposed via `decisionTrace`.
+ * The orchestration-resolved intent is exposed via `orchestrationIntent`.
+ */
+export interface OrchestrationResult extends NaruResult {
+    /** Full decision trace for this orchestration invocation */
+    decisionTrace: AgentDecisionTrace;
+    /** If set, agent is waiting for user confirmation */
+    pendingConfirmation: PendingConfirmation | null;
+    /** The orchestration-resolved intent (null if no resolver configured) */
+    orchestrationIntent: OrchestratorIntent<string> | null;
+}
+//# sourceMappingURL=result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/orchestration/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,4DAA4D;IAC5D,aAAa,EAAE,kBAAkB,CAAC;IAClC,qDAAqD;IACrD,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,yEAAyE;IACzE,mBAAmB,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACxD"}

package/dist/orchestration/result.js

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

package/dist/orchestration/result.js.map

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

package/dist/orchestration/session-state.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AgentSessionState — tracks entities presented in the last response for coreference resolution.
+ */
+export interface AgentSessionState {
+    sessionId: string;
+    lastPresentedEntities: unknown[];
+    metadata: Record<string, unknown>;
+    updatedAt: number;
+}
+export interface BaseSessionStateStore {
+    get(sessionId: string): Promise<AgentSessionState | null>;
+    save(sessionId: string, state: AgentSessionState): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+}
+/**
+ * InMemorySessionStateStore — simple in-memory Map implementation.
+ */
+export declare class InMemorySessionStateStore implements BaseSessionStateStore {
+    private store;
+    get(sessionId: string): Promise<AgentSessionState | null>;
+    save(sessionId: string, state: AgentSessionState): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=session-state.d.ts.map

package/dist/orchestration/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/orchestration/session-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,OAAO,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,OAAO,CAAC,KAAK,CAAwC;IAE/C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAIzD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/orchestration/session-state.js

@@ -0,0 +1,19 @@
+/**
+ * AgentSessionState — tracks entities presented in the last response for coreference resolution.
+ */
+/**
+ * InMemorySessionStateStore — simple in-memory Map implementation.
+ */
+export class InMemorySessionStateStore {
+    store = new Map();
+    async get(sessionId) {
+        return this.store.get(sessionId) ?? null;
+    }
+    async save(sessionId, state) {
+        this.store.set(sessionId, state);
+    }
+    async clear(sessionId) {
+        this.store.delete(sessionId);
+    }
+}
+//# sourceMappingURL=session-state.js.map

package/dist/orchestration/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../src/orchestration/session-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAC5B,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;IAErD,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,KAAwB;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/orchestration/trace.d.ts

@@ -0,0 +1,20 @@
+import type { OrchestratorIntent } from "./intent.js";
+/**
+ * AgentDecisionTrace — records the decision path and timings for each orchestrator invocation.
+ */
+export type OrchestrationPhase = "pending_confirmation" | "direct_execution" | "delegate" | "blocked";
+export interface OrchestrationTimings {
+    total: number;
+    intentResolution?: number;
+    directExecution?: number;
+    delegate?: number;
+}
+export interface AgentDecisionTrace {
+    traceId: string;
+    phaseReached: OrchestrationPhase;
+    intentResolved: OrchestratorIntent<string> | null;
+    timings: OrchestrationTimings;
+    directExecutorUsed: string | null;
+    delegateUsed: string | null;
+}
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/orchestration/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,kBAAkB,GAClB,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAClD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/dist/orchestration/trace.js

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

package/dist/orchestration/trace.js.map

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

package/dist/session/base.d.ts

@@ -0,0 +1,7 @@
+import type { ModelMessage } from "ai";
+export interface BaseSessionStore {
+    get(sessionId: string): Promise<ModelMessage[] | null>;
+    save(sessionId: string, history: ModelMessage[]): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/session/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/session/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/session/base.js

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

package/dist/session/base.js.map

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

package/dist/session/in-memory-store.d.ts

@@ -0,0 +1,9 @@
+import type { ModelMessage } from "ai";
+import type { BaseSessionStore } from "./base.js";
+export declare class InMemorySessionStore implements BaseSessionStore {
+    private store;
+    get(sessionId: string): Promise<ModelMessage[] | null>;
+    save(sessionId: string, history: ModelMessage[]): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/session/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../src/session/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,KAAK,CAAqC;IAE5C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IAItD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/session/in-memory-store.js

@@ -0,0 +1,13 @@
+export class InMemorySessionStore {
+    store = new Map();
+    async get(sessionId) {
+        return this.store.get(sessionId) ?? null;
+    }
+    async save(sessionId, history) {
+        this.store.set(sessionId, history);
+    }
+    async delete(sessionId) {
+        this.store.delete(sessionId);
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

package/dist/session/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../src/session/in-memory-store.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,oBAAoB;IACvB,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAAuB;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/session/redis-store.d.ts

@@ -0,0 +1,16 @@
+import type { ModelMessage } from "ai";
+import type { BaseSessionStore } from "./base.js";
+/**
+ * Redis-backed session store. Requires `ioredis` as optional dependency.
+ */
+export declare class RedisSessionStore implements BaseSessionStore {
+    private redis;
+    private prefix;
+    private ttlSeconds;
+    constructor(redis: import("ioredis").default, prefix?: string, ttlSeconds?: number);
+    private key;
+    get(sessionId: string): Promise<ModelMessage[] | null>;
+    save(sessionId: string, history: ModelMessage[]): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=redis-store.d.ts.map

package/dist/session/redis-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../src/session/redis-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAGzB,KAAK,EAAE,OAAO,SAAS,EAAE,OAAO,EAChC,MAAM,SAAkB,EACxB,UAAU,SAAQ;IAOpB,OAAO,CAAC,GAAG;IAIL,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IAMtD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/session/redis-store.js

@@ -0,0 +1,29 @@
+/**
+ * Redis-backed session store. Requires `ioredis` as optional dependency.
+ */
+export class RedisSessionStore {
+    redis;
+    prefix;
+    ttlSeconds;
+    constructor(redis, prefix = "naru:session:", ttlSeconds = 86400) {
+        this.redis = redis;
+        this.prefix = prefix;
+        this.ttlSeconds = ttlSeconds;
+    }
+    key(sessionId) {
+        return `${this.prefix}${sessionId}`;
+    }
+    async get(sessionId) {
+        const data = await this.redis.get(this.key(sessionId));
+        if (!data)
+            return null;
+        return JSON.parse(data);
+    }
+    async save(sessionId, history) {
+        await this.redis.set(this.key(sessionId), JSON.stringify(history), "EX", this.ttlSeconds);
+    }
+    async delete(sessionId) {
+        await this.redis.del(this.key(sessionId));
+    }
+}
+//# sourceMappingURL=redis-store.js.map

package/dist/session/redis-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.js","sourceRoot":"","sources":["../../src/session/redis-store.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,KAAK,CAA4B;IACjC,MAAM,CAAS;IACf,UAAU,CAAS;IAE3B,YACE,KAAgC,EAChC,MAAM,GAAG,eAAe,EACxB,UAAU,GAAG,KAAK;QAElB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEO,GAAG,CAAC,SAAiB;QAC3B,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAAuB;QACnD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAClB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EACnB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EACvB,IAAI,EACJ,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/skills/base.d.ts

@@ -0,0 +1,38 @@
+import type { BaseTool } from "../tools/base.js";
+import type { BaseKnowledgeStore } from "../knowledge/base.js";
+export interface SkillContext {
+    message: string;
+    userId?: string;
+    sessionId?: string;
+    memoryContext: string;
+    knowledgeStore?: BaseKnowledgeStore;
+}
+export interface SkillResult {
+    promptInjection: string;
+    extraTools: BaseTool[];
+    overrideSystemPrompt: string | null;
+    skillName: string;
+    skipped: boolean;
+}
+export interface BaseSkill {
+    name: string;
+    description: string;
+    triggers: string[];
+    priority: number;
+    alwaysActive: boolean;
+    run: (message: string, context: SkillContext) => Promise<SkillResult>;
+}
+export interface SkillConfig {
+    name: string;
+    description?: string;
+    triggers?: string[];
+    priority?: number;
+    alwaysActive?: boolean;
+    run: (message: string, context: SkillContext) => Promise<SkillResult>;
+}
+/**
+ * Factory function to create a skill (equivalent to Python @skill decorator).
+ */
+export declare function skill(config: SkillConfig): BaseSkill;
+export declare function makeSkillResult(partial?: Partial<SkillResult>): SkillResult;
+//# sourceMappingURL=base.d.ts.map

package/dist/skills/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/skills/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CASpD;AAED,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC7B,WAAW,CASb"}

package/dist/skills/base.js

@@ -0,0 +1,24 @@
+/**
+ * Factory function to create a skill (equivalent to Python @skill decorator).
+ */
+export function skill(config) {
+    return {
+        name: config.name,
+        description: config.description ?? "",
+        triggers: config.triggers ?? [],
+        priority: config.priority ?? 0,
+        alwaysActive: config.alwaysActive ?? false,
+        run: config.run,
+    };
+}
+export function makeSkillResult(partial) {
+    return {
+        promptInjection: "",
+        extraTools: [],
+        overrideSystemPrompt: null,
+        skillName: "",
+        skipped: false,
+        ...partial,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/skills/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/skills/base.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,MAAmB;IACvC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,KAAK;QAC1C,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAA8B;IAE9B,OAAO;QACL,eAAe,EAAE,EAAE;QACnB,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,IAAI;QAC1B,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,KAAK;QACd,GAAG,OAAO;KACX,CAAC;AACJ,CAAC"}

package/dist/skills/registry.d.ts

@@ -0,0 +1,11 @@
+import type { BaseSkill, SkillContext, SkillResult } from "./base.js";
+import type { BaseSkillSelector } from "./selectors.js";
+export declare class SkillRegistry {
+    private skills;
+    private selector;
+    private maxActiveSkills;
+    constructor(skills: BaseSkill[], selector?: BaseSkillSelector, maxActiveSkills?: number);
+    selectSkills(message: string): Promise<BaseSkill[]>;
+    runSkills(message: string, context: SkillContext): Promise<SkillResult[]>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/skills/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,eAAe,CAAS;gBAG9B,MAAM,EAAE,SAAS,EAAE,EACnB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,eAAe,SAAI;IAOf,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOnD,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;CAuB1B"}

package/dist/skills/registry.js

@@ -0,0 +1,37 @@
+import { KeywordSkillSelector } from "./selectors.js";
+import { makeSkillResult } from "./base.js";
+export class SkillRegistry {
+    skills;
+    selector;
+    maxActiveSkills;
+    constructor(skills, selector, maxActiveSkills = 3) {
+        this.skills = skills;
+        this.selector = selector ?? new KeywordSkillSelector();
+        this.maxActiveSkills = maxActiveSkills;
+    }
+    async selectSkills(message) {
+        const selected = await this.selector.select(this.skills, message);
+        return selected
+            .sort((a, b) => b.priority - a.priority)
+            .slice(0, this.maxActiveSkills);
+    }
+    async runSkills(message, context) {
+        const selected = await this.selectSkills(message);
+        if (selected.length === 0)
+            return [];
+        const results = await Promise.allSettled(selected.map(async (s) => {
+            try {
+                const result = await s.run(message, context);
+                return { ...result, skillName: s.name };
+            }
+            catch {
+                return makeSkillResult({ skillName: s.name, skipped: true });
+            }
+        }));
+        return results
+            .filter((r) => r.status === "fulfilled")
+            .map((r) => r.value)
+            .filter((r) => !r.skipped);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,OAAO,aAAa;IAChB,MAAM,CAAc;IACpB,QAAQ,CAAoB;IAC5B,eAAe,CAAS;IAEhC,YACE,MAAmB,EACnB,QAA4B,EAC5B,eAAe,GAAG,CAAC;QAEnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACvD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClE,OAAO,QAAQ;aACZ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAe,EACf,OAAqB;QAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,OAAO;aACX,MAAM,CACL,CAAC,CAAC,EAA4C,EAAE,CAC9C,CAAC,CAAC,MAAM,KAAK,WAAW,CAC3B;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/skills/selectors.d.ts

@@ -0,0 +1,23 @@
+import type { BaseSkill } from "./base.js";
+import type { EmbedFn } from "../types.js";
+export interface BaseSkillSelector {
+    select(skills: BaseSkill[], message: string): Promise<BaseSkill[]>;
+}
+/**
+ * Case-insensitive keyword matching on skill triggers.
+ */
+export declare class KeywordSkillSelector implements BaseSkillSelector {
+    select(skills: BaseSkill[], message: string): Promise<BaseSkill[]>;
+}
+/**
+ * Embedding-based similarity matching for skill selection.
+ */
+export declare class EmbeddingSkillSelector implements BaseSkillSelector {
+    private embedFn;
+    private topK;
+    private similarityThreshold;
+    private cachedEmbeddings;
+    constructor(embedFn: EmbedFn, topK?: number, similarityThreshold?: number);
+    select(skills: BaseSkill[], message: string): Promise<BaseSkill[]>;
+}
+//# sourceMappingURL=selectors.d.ts.map

package/dist/skills/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/skills/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IACtD,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAQzE;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAAsC;gBAG5D,OAAO,EAAE,OAAO,EAChB,IAAI,SAAI,EACR,mBAAmB,SAAO;IAOtB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CA+BzE"}

package/dist/skills/selectors.js

@@ -0,0 +1,52 @@
+import { cosineSimilarity } from "../utils/math.js";
+/**
+ * Case-insensitive keyword matching on skill triggers.
+ */
+export class KeywordSkillSelector {
+    async select(skills, message) {
+        const lower = message.toLowerCase();
+        return skills.filter((s) => s.alwaysActive ||
+            s.triggers.some((t) => lower.includes(t.toLowerCase())));
+    }
+}
+/**
+ * Embedding-based similarity matching for skill selection.
+ */
+export class EmbeddingSkillSelector {
+    embedFn;
+    topK;
+    similarityThreshold;
+    cachedEmbeddings = null;
+    constructor(embedFn, topK = 2, similarityThreshold = 0.45) {
+        this.embedFn = embedFn;
+        this.topK = topK;
+        this.similarityThreshold = similarityThreshold;
+    }
+    async select(skills, message) {
+        const alwaysActive = skills.filter((s) => s.alwaysActive);
+        const candidates = skills.filter((s) => !s.alwaysActive);
+        if (candidates.length === 0)
+            return alwaysActive;
+        // Build skill description embeddings (cached)
+        if (!this.cachedEmbeddings) {
+            const descriptions = candidates.map((s) => `${s.name}: ${s.description} ${s.triggers.join(" ")}`);
+            const embeddings = await this.embedFn(descriptions);
+            this.cachedEmbeddings = new Map();
+            for (let i = 0; i < candidates.length; i++) {
+                this.cachedEmbeddings.set(candidates[i].name, embeddings[i]);
+            }
+        }
+        const [queryEmbed] = await this.embedFn([message]);
+        const scored = candidates
+            .map((s) => ({
+            skill: s,
+            score: cosineSimilarity(queryEmbed, this.cachedEmbeddings.get(s.name)),
+        }))
+            .filter((x) => x.score >= this.similarityThreshold)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, this.topK)
+            .map((x) => x.skill);
+        return [...alwaysActive, ...scored];
+    }
+}
+//# sourceMappingURL=selectors.js.map

package/dist/skills/selectors.js.map

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

package/dist/tools/base.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export interface BaseTool<TParams extends z.ZodType = z.ZodType> {
+    name: string;
+    description: string;
+    parameters: TParams;
+    execute: (params: z.infer<TParams>) => Promise<string>;
+    /** Execution timeout in milliseconds. */
+    timeout?: number;
+    /** Number of retries on failure (0 = no retry). */
+    retries?: number;
+}
+export interface ToolConfig<TParams extends z.ZodType = z.ZodType> {
+    name: string;
+    description: string;
+    parameters: TParams;
+    execute: (params: z.infer<TParams>) => Promise<string>;
+    /** Execution timeout in milliseconds. */
+    timeout?: number;
+    /** Number of retries on failure (0 = no retry). */
+    retries?: number;
+}
+/**
+ * Factory function to create a tool (equivalent to Python @tool decorator).
+ *
+ * @example
+ * const weatherTool = tool({
+ *   name: "get_weather",
+ *   description: "Get weather for a city",
+ *   parameters: z.object({ city: z.string() }),
+ *   execute: async ({ city }) => `Weather in ${city}: sunny`,
+ * });
+ */
+export declare function tool<TParams extends z.ZodType>(config: ToolConfig<TParams>): BaseTool<TParams>;
+//# sourceMappingURL=base.d.ts.map

package/dist/tools/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAC5C,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAC1B,QAAQ,CAAC,OAAO,CAAC,CASnB"}

package/dist/tools/base.js

@@ -0,0 +1,22 @@
+/**
+ * Factory function to create a tool (equivalent to Python @tool decorator).
+ *
+ * @example
+ * const weatherTool = tool({
+ *   name: "get_weather",
+ *   description: "Get weather for a city",
+ *   parameters: z.object({ city: z.string() }),
+ *   execute: async ({ city }) => `Weather in ${city}: sunny`,
+ * });
+ */
+export function tool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        parameters: config.parameters,
+        execute: config.execute,
+        timeout: config.timeout,
+        retries: config.retries,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/tools/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,IAAI,CAClB,MAA2B;IAE3B,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/tools/vercel-adapter.d.ts

@@ -0,0 +1,17 @@
+import { type ToolSet } from "ai";
+import type { BaseTool } from "./base.js";
+/**
+ * Convert naru BaseTool[] to Vercel AI SDK ToolSet record.
+ *
+ * @example
+ * const tools = toVercelTools([weatherTool, searchTool]);
+ * const result = await generateText({ model, tools, prompt: "..." });
+ */
+export declare function toVercelTools(tools: BaseTool[]): ToolSet;
+/**
+ * Same as toVercelTools but with a no-op execute.
+ * Useful for tool planning where you need LLM tool selection
+ * without actually executing tools.
+ */
+export declare function toVercelToolsNoop(tools: BaseTool[]): ToolSet;
+//# sourceMappingURL=vercel-adapter.d.ts.map

package/dist/tools/vercel-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/vercel-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAwCT;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAW5D"}