funolio-agent 0.5.14 → 0.10.2

package/dist/auto-organizer.d.ts

@@ -0,0 +1,16 @@
+export interface AutoOrganizeResult {
+    conversationId: string;
+    topicId: string | null;
+    topicTitle: string | null;
+    isNewTopic: boolean;
+    error?: string;
+}
+/**
+ * Check if auto-organize is enabled.
+ */
+export declare function isAutoOrganizeEnabled(): boolean;
+/**
+ * Organize a conversation into a broad topic.
+ */
+export declare function organizeConversation(conversationId: string): Promise<AutoOrganizeResult>;
+//# sourceMappingURL=auto-organizer.d.ts.map

package/dist/auto-organizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-organizer.d.ts","sourceRoot":"","sources":["../src/auto-organizer.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2H9F"}

package/dist/auto-organizer.js

@@ -0,0 +1,235 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAutoOrganizeEnabled = isAutoOrganizeEnabled;
+exports.organizeConversation = organizeConversation;
+/**
+ * Post-session auto-organization engine.
+ *
+ * After a session goes idle (no messages for N minutes), this module:
+ * 1. Classifies the session into an existing broad topic (or creates a new one)
+ * 2. Links the conversation to the topic via topic_segment
+ * 3. Updates the topic summary
+ *
+ * Design principle: topics are BROAD and GENERIC (~5-15 per project).
+ * Good: "Desktop App Creation", "Web Chat UI", "Database & Migrations"
+ * Bad: "Fix CLI Provider Bug", "Add Bot Colors"
+ *
+ * Uses the cheapest available LLM (clerk model or agent's own provider).
+ * Opt-in via `auto_organize` setting.
+ */
+const data = __importStar(require("./local-data"));
+const index_1 = require("./providers/index");
+const config_1 = require("./config");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Check if auto-organize is enabled.
+ */
+function isAutoOrganizeEnabled() {
+    return data.getSetting('auto_organize') === 'true';
+}
+/**
+ * Organize a conversation into a broad topic.
+ */
+async function organizeConversation(conversationId) {
+    const result = {
+        conversationId,
+        topicId: null,
+        topicTitle: null,
+        isNewTopic: false,
+    };
+    try {
+        if (!isAutoOrganizeEnabled())
+            return result;
+        const conv = data.getConversation(conversationId);
+        if (!conv)
+            return result;
+        // Get first few messages for classification
+        const messages = data.getMessages(conversationId, { limit: 10 });
+        if (messages.length < 2)
+            return result;
+        const llm = getOrganizerLlm(conv.agent_id);
+        if (!llm) {
+            result.error = 'No LLM available for auto-organize';
+            return result;
+        }
+        // Get existing topics for matching
+        const existingTopics = data.listTopics({ projectId: conv.project_id ?? undefined, limit: 50 });
+        // Build transcript preview (first ~500 tokens worth)
+        const preview = messages.slice(0, 6)
+            .map(m => `${m.role}: ${m.content.slice(0, 200)}`)
+            .join('\n');
+        // Step 1: Classify the session
+        const topicList = existingTopics.length > 0
+            ? existingTopics.map((t, i) => `${i + 1}. "${t.title}"`).join('\n')
+            : '(no existing topics)';
+        const classifyPrompt = `You are organizing a developer's conversations into broad topic folders.
+
+Existing topics:
+${topicList}
+
+This session starts with:
+"${preview.slice(0, 1500)}"
+
+Which existing topic does this session belong to?
+If none fit, suggest a new broad topic (2-5 words, like a folder name — e.g. "Desktop App Creation", not "Fix CLI Bug").
+
+Return JSON only: {"topic_index": 1} or {"topic_index": null, "new_topic": "Topic Name"}`;
+        const resp = await llm.chat({
+            messages: [{ role: 'user', content: classifyPrompt }],
+            system: 'You classify conversations into broad topic folders. Return ONLY valid JSON, no explanation.',
+        });
+        if (!resp.content)
+            return result;
+        const parsed = parseJson(resp.content);
+        if (!parsed) {
+            result.error = 'Failed to parse LLM classification response';
+            return result;
+        }
+        let topic;
+        if (parsed.topic_index != null && parsed.topic_index >= 1 && parsed.topic_index <= existingTopics.length) {
+            // Match existing topic
+            topic = existingTopics[parsed.topic_index - 1];
+            result.isNewTopic = false;
+        }
+        else if (parsed.new_topic) {
+            // Create new topic
+            topic = data.createTopic({
+                title: parsed.new_topic.slice(0, 100),
+                projectId: conv.project_id ?? undefined,
+                isAuto: true,
+            });
+            result.isNewTopic = true;
+        }
+        else {
+            result.error = 'LLM returned invalid classification';
+            return result;
+        }
+        result.topicId = topic.id;
+        result.topicTitle = topic.title;
+        // Step 2: Link the whole conversation as a segment
+        const maxSeq = messages.length > 0 ? messages[messages.length - 1].seq : 1;
+        data.createTopicSegment({
+            topicId: topic.id,
+            conversationId,
+            startSeq: 1,
+            endSeq: maxSeq,
+        });
+        // Update topic activity + message count
+        data.updateTopic(topic.id, {
+            messageCount: (topic.message_count || 0) + conv.message_count,
+            lastActivityAt: new Date().toISOString().replace('T', ' ').replace('Z', ''),
+        });
+        // Step 3: Update topic summary (only if we have enough messages)
+        if (conv.message_count >= 4) {
+            try {
+                const summaryResp = await llm.chat({
+                    messages: [{ role: 'user', content: `Write a 1-2 sentence summary of this developer topic: "${topic.title}". Latest session preview:\n${preview.slice(0, 800)}${topic.summary ? `\nPrevious summary: ${topic.summary}` : ''}` }],
+                    system: 'You write concise topic summaries. Return ONLY the summary text.',
+                });
+                if (summaryResp.content) {
+                    data.updateTopic(topic.id, { summary: summaryResp.content.trim().slice(0, 500) });
+                }
+            }
+            catch { /* best-effort */ }
+        }
+        console.log(chalk_1.default.gray(`  [auto-organize] Conv ${conversationId.slice(0, 8)} → topic "${topic.title}" (${result.isNewTopic ? 'new' : 'existing'})`));
+    }
+    catch (err) {
+        result.error = err.message;
+        console.error(chalk_1.default.red(`  [auto-organize] Error: ${err.message}`));
+    }
+    return result;
+}
+function getOrganizerLlm(agentId) {
+    try {
+        // Try clerk model first (cheapest)
+        const clerkProvider = data.getSetting('clerk_provider');
+        const clerkModel = data.getSetting('clerk_model');
+        const clerkKey = data.getSetting('clerk_api_key');
+        if (clerkProvider && clerkModel && clerkKey) {
+            return (0, index_1.createProvider)(clerkProvider, { apiKey: clerkKey, model: clerkModel });
+        }
+        // Fall back to agent's provider
+        if (agentId) {
+            const profile = data.getAgentProfile(agentId);
+            if (profile?.api_key_enc) {
+                const model = cheapModel(profile.provider, profile.model);
+                return (0, index_1.createProvider)(profile.provider, { apiKey: profile.api_key_enc, model });
+            }
+        }
+        // Fall back to config
+        const config = (0, config_1.loadConfig)();
+        const prov = (0, config_1.getProvider)(config);
+        if (prov) {
+            const apiKey = prov.apiKey || prov.oauthToken;
+            if (apiKey) {
+                const model = cheapModel(prov.id, prov.defaultModel);
+                return (0, index_1.createProvider)(prov.id, { apiKey, model });
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function cheapModel(provider, fallback) {
+    switch (provider) {
+        case 'anthropic': return 'claude-haiku-4-5-20251001';
+        case 'openai': return 'gpt-4o-mini';
+        case 'google': return 'gemini-2.0-flash';
+        default: return fallback;
+    }
+}
+function parseJson(content) {
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        const match = content.match(/\{[\s\S]*\}/);
+        if (match) {
+            try {
+                return JSON.parse(match[0]);
+            }
+            catch { /* fall through */ }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=auto-organizer.js.map

package/dist/auto-organizer.js.map

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

package/dist/clerk-model.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Clerk Model — Local-First Orchestration Layer
+ *
+ * The clerk is a user-configured LLM (cheapest from their provider) that handles:
+ * 1. Task routing — decides which agent/model handles a prompt
+ * 2. Prompt building — retrieves relevant context within token budget
+ * 3. Token budgeting — calculates available tokens, selects relevant memory
+ * 4. Memory extraction — after conversation turns, extracts facts locally
+ *
+ * The user configures the clerk during setup: provider + model.
+ * It runs locally inside the agent, never on the server.
+ */
+import * as data from './local-data';
+export interface ClerkModelConfig {
+    provider: string;
+    model: string;
+    apiKey: string;
+    /** Max tokens the clerk can use for context injection (default: 8000) */
+    maxContextTokens?: number;
+}
+export interface BuiltPrompt {
+    systemPrompt: string;
+    contextTokensUsed: number;
+    injectedFacts: number;
+    injectedDecisions: number;
+    injectedSummaries: number;
+    /** Budget remaining for conversation history */
+    historyBudget: number;
+}
+export interface TaskRoute {
+    agentId: string;
+    agentName: string;
+    provider: string;
+    model: string;
+    reasoning: string;
+}
+export interface ExtractionResult {
+    facts: Array<{
+        factType: string;
+        content: string;
+        entityName?: string;
+        entityType?: string;
+    }>;
+    decisions: Array<{
+        title: string;
+        reasoning?: string;
+        category?: string;
+    }>;
+    actionItems: Array<{
+        title: string;
+        priority?: string;
+        type?: string;
+    }>;
+    entities: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+export declare class ClerkModel {
+    private config;
+    private llm;
+    constructor(config: ClerkModelConfig);
+    /**
+     * Route a task to the best agent/model.
+     * Given a user prompt and available agents, the clerk decides which agent handles it.
+     * Falls back to the default agent if clerk call fails.
+     */
+    routeTask(prompt: string, agents: data.AgentProfileRow[]): Promise<TaskRoute>;
+    /**
+     * Build an optimized system prompt with relevant context, respecting token budget.
+     *
+     * Budget allocation:
+     * - System prompt base: ~500 tokens
+     * - Memory facts: up to 30% of budget
+     * - Decisions: up to 15% of budget
+     * - Summaries: up to 15% of budget
+     * - Remaining: reserved for conversation history
+     */
+    buildPrompt(userPrompt: string, agentId: string, profile: data.AgentProfileRow, opts?: {
+        targetModel?: string;
+        maxContextTokens?: number;
+    }): BuiltPrompt;
+    /**
+     * Extract memory facts, decisions, action items, and entities from conversation messages.
+     * Uses the user's own LLM (clerk model) — runs entirely locally.
+     */
+    extractMemory(conversationId: string, messages: data.MessageRow[]): Promise<ExtractionResult>;
+    /**
+     * Trim conversation history to fit within token budget.
+     * Keeps the most recent messages, with a summary of older ones.
+     */
+    trimHistory(messages: data.MessageRow[], maxTokens: number): data.MessageRow[];
+}
+/**
+ * Get or create the global clerk model instance.
+ * Resolves clerk config from: settings table → config.json providers → env vars.
+ */
+export declare function getClerk(): ClerkModel | null;
+/** Reset the clerk instance (e.g., after config change) */
+export declare function resetClerk(): void;
+//# sourceMappingURL=clerk-model.d.ts.map

package/dist/clerk-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clerk-model.d.ts","sourceRoot":"","sources":["../src/clerk-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AAKrC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AA8BD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,GAAG,CAAc;gBAEb,MAAM,EAAE,gBAAgB;IAQpC;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAyDnF;;;;;;;;;OASG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,CAAC,eAAe,EAC7B,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GACzD,WAAW;IA2Gd;;;OAGG;IACG,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IAwC5B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE;CAe/E;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,UAAU,GAAG,IAAI,CAsC5C;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}