agentx-sdk 0.1.0

package/dist/skills/skill-manager.js

@@ -0,0 +1,338 @@
+import { scanSkillFiles } from './skill-loader.js';
+import { substituteArgs } from './skill-args.js';
+import { matchAnyGlob } from './skill-glob.js';
+const MAX_LISTING_DESC_CHARS = 250;
+/**
+ * Registers skills, matches them against user input, manages conditional
+ * activation, and provides budget-aware skill listings for model discovery.
+ *
+ * Matching hierarchy: prefix > alias > custom match() > semantic similarity.
+ */
+export class SkillManager {
+    /** All registered skills (unconditional — always eligible for matching) */
+    skills = new Map();
+    /** Skills with `paths` — waiting for file touch to activate */
+    conditionalSkills = new Map();
+    /** Skills activated via path matching (moved from conditionalSkills) */
+    activatedSkills = new Map();
+    /** Tracks which skills have been invoked in this session */
+    invokedSkills = new Set();
+    /** Sticky skill sessions per thread — outer key: threadId, inner key: skillName */
+    stickySessions = new Map();
+    embeddingService;
+    maxActiveSkills;
+    constructor(options) {
+        this.embeddingService = options?.embeddingService;
+        this.maxActiveSkills = options?.maxActiveSkills ?? 3;
+    }
+    // ---------------------------------------------------------------------------
+    // Registration
+    // ---------------------------------------------------------------------------
+    register(skill) {
+        if (skill.paths && skill.paths.length > 0) {
+            this.conditionalSkills.set(skill.name, skill);
+        }
+        else {
+            this.skills.set(skill.name, skill);
+        }
+    }
+    unregister(name) {
+        return this.skills.delete(name)
+            || this.conditionalSkills.delete(name)
+            || this.activatedSkills.delete(name);
+    }
+    /** All skills (unconditional + activated conditional) */
+    listSkills() {
+        return [...this.skills.values(), ...this.activatedSkills.values()];
+    }
+    /** All skills including pending conditional ones */
+    listAllSkills() {
+        return [
+            ...this.skills.values(),
+            ...this.activatedSkills.values(),
+            ...this.conditionalSkills.values(),
+        ];
+    }
+    // ---------------------------------------------------------------------------
+    // File-based loading
+    // ---------------------------------------------------------------------------
+    /**
+     * Load skills from a directory containing SKILL.md files.
+     * Returns the number of skills loaded.
+     */
+    async loadFromDirectory(dir) {
+        const skills = await scanSkillFiles(dir);
+        for (const skill of skills) {
+            this.register(skill);
+        }
+        return skills.length;
+    }
+    // ---------------------------------------------------------------------------
+    // Conditional path activation
+    // ---------------------------------------------------------------------------
+    /**
+     * Activate conditional skills whose `paths` match any of the given file paths.
+     * Returns the names of newly activated skills.
+     */
+    activateForPaths(filePaths) {
+        const activated = [];
+        for (const [name, skill] of this.conditionalSkills) {
+            if (!skill.paths)
+                continue;
+            const matched = filePaths.some(fp => matchAnyGlob(skill.paths, fp));
+            if (matched) {
+                this.activatedSkills.set(name, skill);
+                this.conditionalSkills.delete(name);
+                activated.push(name);
+            }
+        }
+        return activated;
+    }
+    // ---------------------------------------------------------------------------
+    // Matching
+    // ---------------------------------------------------------------------------
+    /**
+     * Matches skills against input. Returns top skills sorted by priority.
+     */
+    async match(input, context) {
+        const matches = [];
+        const matchedNames = new Set();
+        const eligible = this.getEligibleSkills();
+        // 0. Sticky sessions — re-inject skills that are active for this thread
+        const threadSessions = this.stickySessions.get(context.threadId);
+        if (threadSessions) {
+            for (const [skillName, session] of threadSessions) {
+                if (session.turnsRemaining <= 0) {
+                    threadSessions.delete(skillName);
+                    continue;
+                }
+                const skill = this.skills.get(skillName) ?? this.activatedSkills.get(skillName);
+                if (skill) {
+                    matches.push({ skill, matchType: 'sticky', score: 0.9 });
+                    matchedNames.add(skillName);
+                }
+            }
+            // Clean up empty thread entry
+            if (threadSessions.size === 0) {
+                this.stickySessions.delete(context.threadId);
+            }
+        }
+        for (const skill of eligible) {
+            if (matchedNames.has(skill.name))
+                continue;
+            // 1. Prefix match (highest priority)
+            if (skill.triggerPrefix && input.startsWith(skill.triggerPrefix)) {
+                matches.push({ skill, matchType: 'prefix', score: 1.0 });
+                matchedNames.add(skill.name);
+                continue;
+            }
+            // 2. Alias match
+            if (skill.aliases) {
+                const matched = skill.aliases.some(alias => {
+                    const prefix = alias.startsWith('/') ? alias : `/${alias}`;
+                    return input.startsWith(prefix);
+                });
+                if (matched) {
+                    matches.push({ skill, matchType: 'alias', score: 0.95 });
+                    matchedNames.add(skill.name);
+                    continue;
+                }
+            }
+            // 3. Custom match function
+            if (skill.match && skill.match(input, { threadId: context.threadId, recentMessages: 0 })) {
+                matches.push({ skill, matchType: 'custom', score: 0.8 });
+                matchedNames.add(skill.name);
+                continue;
+            }
+        }
+        // 4. Semantic match — only if no prefix/alias/custom/sticky matches found
+        //    and there are skills that lack explicit matchers
+        if (this.embeddingService && matches.length === 0 && this.hasSkillsNeedingSemantic(eligible)) {
+            const semanticMatches = await this.semanticMatch(input, eligible);
+            matches.push(...semanticMatches);
+        }
+        // Sort: exclusive first, then by match type priority, then by skill.priority
+        const sorted = matches.sort((a, b) => {
+            if (a.skill.exclusive && !b.skill.exclusive)
+                return -1;
+            if (!a.skill.exclusive && b.skill.exclusive)
+                return 1;
+            const typeOrder = { prefix: 4, sticky: 3.5, alias: 3, custom: 2, semantic: 1 };
+            const typeDiff = (typeOrder[b.matchType] ?? 0) - (typeOrder[a.matchType] ?? 0);
+            if (typeDiff !== 0)
+                return typeDiff;
+            return (b.skill.priority ?? 0) - (a.skill.priority ?? 0);
+        });
+        // Activate sticky sessions for newly matched skills and decrement turn counters
+        for (const match of sorted) {
+            if (match.skill.sticky) {
+                this.activateStickySession(context.threadId, match.skill);
+            }
+        }
+        this.decrementStickySessions(context.threadId);
+        // If exclusive skill matched, return only it
+        if (sorted[0]?.skill.exclusive) {
+            return [sorted[0].skill];
+        }
+        return sorted.slice(0, this.maxActiveSkills).map(m => m.skill);
+    }
+    // ---------------------------------------------------------------------------
+    // Dynamic prompt resolution
+    // ---------------------------------------------------------------------------
+    /**
+     * Resolve the final instructions for a matched skill.
+     * If `getPrompt` exists, calls it with args and context.
+     * Otherwise uses static `instructions` with argument substitution.
+     */
+    async resolveInstructions(skill, args, context) {
+        if (skill.getPrompt) {
+            return skill.getPrompt(args, context);
+        }
+        // Static instructions with optional substitution
+        if (skill.argNames && skill.argNames.length > 0) {
+            return substituteArgs(skill.instructions, args, skill.argNames, {
+                SKILL_DIR: context.skillDir ?? skill.skillDir ?? '',
+                THREAD_ID: context.threadId,
+                TRACE_ID: context.traceId,
+            });
+        }
+        return skill.instructions;
+    }
+    // ---------------------------------------------------------------------------
+    // Budget-aware listing for model discovery
+    // ---------------------------------------------------------------------------
+    /**
+     * Build a formatted listing of available skills for model context.
+     * Truncates to fit within the given character budget.
+     */
+    buildSkillListing(budgetChars) {
+        const eligible = this.getEligibleSkills()
+            .filter(s => s.modelInvocable !== false);
+        if (eligible.length === 0)
+            return '';
+        const lines = [];
+        let usedChars = 0;
+        for (const skill of eligible) {
+            const prefix = skill.triggerPrefix
+                ? skill.triggerPrefix
+                : `/${skill.name}`;
+            let line = `- ${prefix}: ${skill.description}`;
+            if (skill.whenToUse) {
+                line += ` — ${skill.whenToUse}`;
+            }
+            // Truncate individual entry
+            if (line.length > MAX_LISTING_DESC_CHARS) {
+                line = line.slice(0, MAX_LISTING_DESC_CHARS - 3) + '...';
+            }
+            if (usedChars + line.length > budgetChars)
+                break;
+            lines.push(line);
+            usedChars += line.length + 1; // +1 for newline
+        }
+        return lines.join('\n');
+    }
+    // ---------------------------------------------------------------------------
+    // Invocation tracking
+    // ---------------------------------------------------------------------------
+    markInvoked(name) {
+        this.invokedSkills.add(name);
+    }
+    getInvokedSkills() {
+        return [...this.invokedSkills];
+    }
+    // ---------------------------------------------------------------------------
+    // Sticky session management
+    // ---------------------------------------------------------------------------
+    /** Remove a single sticky skill from a thread */
+    clearStickySkill(threadId, skillName) {
+        this.stickySessions.get(threadId)?.delete(skillName);
+    }
+    /** Remove all sticky skills for a thread (e.g. on clearHistory) */
+    clearStickySkills(threadId) {
+        this.stickySessions.delete(threadId);
+    }
+    /** Remove all sticky sessions across all threads (e.g. on destroy) */
+    clearAllStickySessions() {
+        this.stickySessions.clear();
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    activateStickySession(threadId, skill) {
+        if (!this.stickySessions.has(threadId)) {
+            this.stickySessions.set(threadId, new Map());
+        }
+        const sessions = this.stickySessions.get(threadId);
+        // Don't reset an existing session (first activation wins)
+        if (!sessions.has(skill.name)) {
+            sessions.set(skill.name, {
+                skillName: skill.name,
+                activatedAt: Date.now(),
+                turnsRemaining: skill.sticky === true ? Infinity : skill.sticky,
+            });
+        }
+    }
+    decrementStickySessions(threadId) {
+        const sessions = this.stickySessions.get(threadId);
+        if (!sessions)
+            return;
+        for (const session of sessions.values()) {
+            if (session.turnsRemaining !== Infinity) {
+                session.turnsRemaining--;
+            }
+        }
+    }
+    /** Get all skills eligible for matching (unconditional + activated) */
+    getEligibleSkills() {
+        const eligible = [];
+        for (const skill of this.skills.values()) {
+            if (skill.isEnabled && !skill.isEnabled())
+                continue;
+            eligible.push(skill);
+        }
+        for (const skill of this.activatedSkills.values()) {
+            if (skill.isEnabled && !skill.isEnabled())
+                continue;
+            eligible.push(skill);
+        }
+        return eligible;
+    }
+    /**
+     * Returns true if any eligible skill lacks both triggerPrefix, aliases, and match(),
+     * meaning it can only be activated via semantic matching.
+     */
+    hasSkillsNeedingSemantic(eligible) {
+        return eligible.some(s => !s.triggerPrefix && !s.aliases?.length && !s.match);
+    }
+    async semanticMatch(input, eligible) {
+        if (!this.embeddingService)
+            return [];
+        const inputEmbedding = await this.embeddingService.embedSingle(input);
+        const results = [];
+        for (const skill of eligible) {
+            // Only semantic-match skills that lack explicit matchers
+            if (skill.triggerPrefix || skill.aliases?.length || skill.match)
+                continue;
+            const text = skill.whenToUse
+                ? `${skill.description}. ${skill.whenToUse}`
+                : skill.description;
+            const skillEmbedding = await this.embeddingService.embedSingle(text);
+            const score = cosineSimilarity(inputEmbedding, skillEmbedding);
+            if (score > 0.7) {
+                results.push({ skill, matchType: 'semantic', score });
+            }
+        }
+        return results;
+    }
+}
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=skill-manager.js.map

package/dist/skills/skill-manager.js.map

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

package/dist/storage/sqlite-conversation-store.d.ts

@@ -0,0 +1,15 @@
+import type { ConversationStore } from '../contracts/entities/stores.js';
+import type { ChatMessage } from '../contracts/entities/chat-message.js';
+import type { SQLiteDatabase } from './sqlite-database.js';
+/**
+ * SQLite implementation of ConversationStore.
+ */
+export declare class SQLiteConversationStore implements ConversationStore {
+    private readonly database;
+    constructor(database: SQLiteDatabase);
+    appendMessage(message: ChatMessage, threadId: string): void;
+    listThread(threadId: string): ChatMessage[];
+    listPinned(threadId: string): ChatMessage[];
+    clearThread(threadId: string): void;
+}
+//# sourceMappingURL=sqlite-conversation-store.d.ts.map

package/dist/storage/sqlite-conversation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-conversation-store.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-conversation-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,QAAQ,EAAE,cAAc;IAIpC,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAe3D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAO3C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAO3C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGpC"}

package/dist/storage/sqlite-conversation-store.js

@@ -0,0 +1,45 @@
+/**
+ * SQLite implementation of ConversationStore.
+ */
+export class SQLiteConversationStore {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    appendMessage(message, threadId) {
+        this.database.db.prepare(`
+      INSERT INTO conversations (thread_id, role, content, tool_calls, tool_call_id, pinned, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(threadId, message.role, typeof message.content === 'string' ? message.content : JSON.stringify(message.content), message.toolCalls ? JSON.stringify(message.toolCalls) : null, message.toolCallId ?? null, message.pinned ? 1 : 0, message.createdAt);
+    }
+    listThread(threadId) {
+        const rows = this.database.db.prepare('SELECT * FROM conversations WHERE thread_id = ? ORDER BY created_at ASC').all(threadId);
+        return rows.map(rowToMessage);
+    }
+    listPinned(threadId) {
+        const rows = this.database.db.prepare('SELECT * FROM conversations WHERE thread_id = ? AND pinned = 1 ORDER BY created_at ASC').all(threadId);
+        return rows.map(rowToMessage);
+    }
+    clearThread(threadId) {
+        this.database.db.prepare('DELETE FROM conversations WHERE thread_id = ?').run(threadId);
+    }
+}
+function rowToMessage(row) {
+    let content;
+    try {
+        const parsed = JSON.parse(row.content);
+        content = Array.isArray(parsed) ? parsed : row.content;
+    }
+    catch {
+        content = row.content;
+    }
+    return {
+        role: row.role,
+        content: content,
+        toolCalls: row.tool_calls ? JSON.parse(row.tool_calls) : undefined,
+        toolCallId: row.tool_call_id ?? undefined,
+        pinned: row.pinned === 1,
+        createdAt: row.created_at,
+    };
+}
+//# sourceMappingURL=sqlite-conversation-store.js.map

package/dist/storage/sqlite-conversation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-conversation-store.js","sourceRoot":"","sources":["../../src/storage/sqlite-conversation-store.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,uBAAuB;IACjB,QAAQ,CAAiB;IAE1C,YAAY,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,OAAoB,EAAE,QAAgB;QAClD,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAGxB,CAAC,CAAC,GAAG,CACJ,QAAQ,EACR,OAAO,CAAC,IAAI,EACZ,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EACvF,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAC5D,OAAO,CAAC,UAAU,IAAI,IAAI,EAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,SAAS,CAClB,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CACnC,yEAAyE,CAC1E,CAAC,GAAG,CAAC,QAAQ,CAAsB,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CACnC,wFAAwF,CACzF,CAAC,GAAG,CAAC,QAAQ,CAAsB,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1F,CAAC;CACF;AAED,SAAS,YAAY,CAAC,GAAoB;IACxC,IAAI,OAAqF,CAAC;IAC1F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAA2B;QACrC,OAAO,EAAE,OAAiC;QAC1C,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;QAClE,UAAU,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QACzC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC;QACxB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC"}

package/dist/storage/sqlite-database.d.ts

@@ -0,0 +1,14 @@
+import type BetterSqlite3 from 'better-sqlite3';
+/**
+ * Centralized SQLite wrapper with auto-create tables, migrations, and WAL mode.
+ */
+export declare class SQLiteDatabase {
+    private _db;
+    private readonly path;
+    constructor(path: string);
+    get db(): BetterSqlite3.Database;
+    initialize(): void;
+    close(): void;
+    private migrateV1;
+}
+//# sourceMappingURL=sqlite-database.d.ts.map

package/dist/storage/sqlite-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-database.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-database.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAIxB,IAAI,EAAE,IAAI,aAAa,CAAC,QAAQ,CAG/B;IAED,UAAU,IAAI,IAAI;IAiBlB,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,SAAS;CA+DlB"}

package/dist/storage/sqlite-database.js

@@ -0,0 +1,95 @@
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import Database from 'better-sqlite3';
+/**
+ * Centralized SQLite wrapper with auto-create tables, migrations, and WAL mode.
+ */
+export class SQLiteDatabase {
+    _db = null;
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    get db() {
+        if (!this._db)
+            throw new Error('Database not initialized. Call initialize() first.');
+        return this._db;
+    }
+    initialize() {
+        if (this._db)
+            return;
+        // Auto-create parent directory for file-based databases
+        if (this.path !== ':memory:') {
+            mkdirSync(dirname(this.path), { recursive: true });
+        }
+        this._db = new Database(this.path);
+        // Enable WAL mode for concurrent reads
+        this._db.pragma('journal_mode = WAL');
+        this._db.pragma('synchronous = NORMAL');
+        this.migrateV1();
+    }
+    close() {
+        if (this._db) {
+            this._db.close();
+            this._db = null;
+        }
+    }
+    migrateV1() {
+        const db = this.db;
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        content TEXT NOT NULL,
+        scope TEXT NOT NULL,
+        category TEXT NOT NULL,
+        confidence REAL NOT NULL DEFAULT 0.8,
+        access_count INTEGER NOT NULL DEFAULT 0,
+        source TEXT NOT NULL DEFAULT 'extracted',
+        thread_id TEXT,
+        embedding BLOB,
+        created_at INTEGER NOT NULL,
+        last_accessed_at INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_memories_scope ON memories(scope);
+      CREATE INDEX IF NOT EXISTS idx_memories_thread ON memories(thread_id);
+      CREATE INDEX IF NOT EXISTS idx_memories_confidence ON memories(confidence);
+    `);
+        // FTS5 virtual table for full-text search
+        // Check if already exists (FTS5 tables don't support IF NOT EXISTS in all versions)
+        const ftsExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='memories_fts'").get();
+        if (!ftsExists) {
+            db.exec(`
+        CREATE VIRTUAL TABLE memories_fts USING fts5(
+          content,
+          content=memories,
+          content_rowid=rowid
+        );
+      `);
+        }
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS vectors (
+        id TEXT PRIMARY KEY,
+        content TEXT NOT NULL,
+        embedding BLOB NOT NULL,
+        metadata TEXT,
+        created_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS conversations (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        thread_id TEXT NOT NULL,
+        role TEXT NOT NULL,
+        content TEXT NOT NULL,
+        tool_calls TEXT,
+        tool_call_id TEXT,
+        pinned INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_conversations_thread ON conversations(thread_id, created_at);
+      CREATE INDEX IF NOT EXISTS idx_conversations_pinned ON conversations(thread_id, pinned);
+    `);
+    }
+}
+//# sourceMappingURL=sqlite-database.js.map

package/dist/storage/sqlite-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-database.js","sourceRoot":"","sources":["../../src/storage/sqlite-database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,GAAG,GAAkC,IAAI,CAAC;IACjC,IAAI,CAAS;IAE9B,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,EAAE;QACJ,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACrF,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO;QAErB,wDAAwD;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnC,uCAAuC;QACvC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,SAAS;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAEnB,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;KAkBP,CAAC,CAAC;QAEH,0CAA0C;QAC1C,oFAAoF;QACpF,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAC1B,2EAA2E,CAC5E,CAAC,GAAG,EAAE,CAAC;QAER,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,EAAE,CAAC,IAAI,CAAC;;;;;;OAMP,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;KAsBP,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tools/builtin/ask-user.d.ts

@@ -0,0 +1,7 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export interface AskUserOptions {
+    /** Callback invoked when the model asks a question. Consumer implements this. */
+    onAsk: (question: string, options?: string[]) => Promise<string>;
+}
+export declare function createAskUserTool(opts: AskUserOptions): AgentTool;
+//# sourceMappingURL=ask-user.d.ts.map

package/dist/tools/builtin/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/ask-user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAOxE,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAiBjE"}

package/dist/tools/builtin/ask-user.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+const AskUserParams = z.object({
+    question: z.string().describe('Question to ask the user'),
+    options: z.array(z.string()).optional().describe('Optional multiple-choice options'),
+});
+export function createAskUserTool(opts) {
+    return {
+        name: 'AskUser',
+        description: 'Ask the user a question and wait for their response. Use when you need clarification or confirmation.',
+        parameters: AskUserParams,
+        async execute(rawArgs) {
+            const { question, options } = rawArgs;
+            try {
+                const answer = await opts.onAsk(question, options);
+                return `User responded: ${answer}`;
+            }
+            catch (error) {
+                return { content: `Failed to get user response: ${error.message}`, isError: true };
+            }
+        },
+    };
+}
+//# sourceMappingURL=ask-user.js.map

package/dist/tools/builtin/ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../../src/tools/builtin/ask-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACrF,CAAC,CAAC;AAOH,MAAM,UAAU,iBAAiB,CAAC,IAAoB;IACpD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uGAAuG;QACpH,UAAU,EAAE,aAAa;QAEzB,KAAK,CAAC,OAAO,CAAC,OAAgB;YAC5B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAwC,CAAC;YAEvE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,OAAO,mBAAmB,MAAM,EAAE,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,gCAAiC,KAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAChG,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/bash.d.ts

@@ -0,0 +1,3 @@
+import type { AgentTool } from '../../contracts/entities/agent-tool.js';
+export declare function createBashTool(): AgentTool;
+//# sourceMappingURL=bash.d.ts.map

package/dist/tools/builtin/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/bash.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAUxE,wBAAgB,cAAc,IAAI,SAAS,CA4C1C"}

package/dist/tools/builtin/bash.js

@@ -0,0 +1,54 @@
+import { exec } from 'node:child_process';
+import { z } from 'zod';
+const DEFAULT_TIMEOUT = 120_000;
+const MAX_OUTPUT = 500_000; // 500KB
+const BashParams = z.object({
+    command: z.string().describe('Shell command to execute'),
+    timeout: z.number().optional().describe('Timeout in milliseconds. Default: 120000 (2 minutes).'),
+});
+export function createBashTool() {
+    return {
+        name: 'Bash',
+        description: 'Execute a shell command and return stdout/stderr.',
+        parameters: BashParams,
+        isDestructive: true, // conservative — commands can have side effects
+        timeoutMs: DEFAULT_TIMEOUT,
+        async execute(rawArgs, signal) {
+            const { command, timeout } = rawArgs;
+            const effectiveTimeout = timeout ?? DEFAULT_TIMEOUT;
+            return new Promise((resolve) => {
+                exec(command, {
+                    timeout: effectiveTimeout,
+                    maxBuffer: MAX_OUTPUT,
+                    shell: process.env.SHELL || '/bin/sh',
+                    signal,
+                }, (error, stdout, stderr) => {
+                    const out = stdout?.slice(0, MAX_OUTPUT) ?? '';
+                    const err = stderr?.slice(0, MAX_OUTPUT) ?? '';
+                    if (error) {
+                        const exitCode = error.code ?? 'unknown';
+                        const parts = [];
+                        if (out)
+                            parts.push(out);
+                        if (err)
+                            parts.push(err);
+                        if (!out && !err)
+                            parts.push(error.message);
+                        parts.push(`\nExit code: ${exitCode}`);
+                        resolve({ content: parts.join('\n'), isError: true });
+                        return;
+                    }
+                    const parts = [];
+                    if (out)
+                        parts.push(out);
+                    if (err)
+                        parts.push(`[stderr]\n${err}`);
+                    if (!out && !err)
+                        parts.push('(no output)');
+                    resolve(parts.join('\n'));
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=bash.js.map