@askexenow/exe-os 0.9.292 → 0.9.293

package/dist/chunk-ZNY54QWW.js

@@ -0,0 +1,377 @@
+import {
+  extractMemoryGraph
+} from "./chunk-MJ2MCLZH.js";
+import {
+  flushBatch,
+  writeMemory
+} from "./chunk-NXCJWGAF.js";
+import {
+  extractKeywords
+} from "./chunk-CHCA3ZM2.js";
+import {
+  getActiveAgent
+} from "./chunk-ZXNQ7GRU.js";
+
+// src/mcp/tools/import-conversations.ts
+import { z } from "zod";
+import crypto from "crypto";
+import { readdir, readFile, stat } from "fs/promises";
+import path, { resolve, normalize } from "path";
+import os from "os";
+
+// src/lib/conversation-parser.ts
+function detectFormat(content, filePath) {
+  const lower = filePath.toLowerCase();
+  if (lower.endsWith(".md") || lower.endsWith(".markdown")) return "markdown";
+  const trimmed = content.trimStart();
+  if (!trimmed.startsWith("[") && !trimmed.startsWith("{")) return "markdown";
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (Array.isArray(parsed) && parsed.length > 0) {
+      const first = parsed[0];
+      if (first && typeof first === "object") {
+        if ("mapping" in first && typeof first.mapping === "object") return "chatgpt";
+        if ("chat_messages" in first) return "claude";
+        if ("uuid" in first && "name" in first) return "claude";
+      }
+    }
+    return "generic";
+  } catch {
+    return "markdown";
+  }
+}
+function extractChatGPTContent(node) {
+  const parts = node.message?.content?.parts;
+  if (!Array.isArray(parts)) return "";
+  return parts.filter((p) => typeof p === "string").join("\n").trim();
+}
+function parseChatGPT(content, sourceFile = "conversations.json") {
+  const data = JSON.parse(content);
+  if (!Array.isArray(data)) return [];
+  return data.map((conv) => {
+    const title = conv.title ?? "Untitled";
+    const messages = [];
+    if (conv.mapping) {
+      const nodes = Object.values(conv.mapping).filter((n) => n.message?.content?.parts && extractChatGPTContent(n).length > 0).sort((a, b) => (a.message?.create_time ?? 0) - (b.message?.create_time ?? 0));
+      for (const node of nodes) {
+        const role = node.message?.author?.role ?? "unknown";
+        const text = extractChatGPTContent(node);
+        if (!text) continue;
+        const createTime = node.message?.create_time;
+        messages.push({
+          role,
+          content: text,
+          timestamp: createTime ? new Date(createTime * 1e3).toISOString() : void 0
+        });
+      }
+    }
+    return { title, messages, sourceFile };
+  }).filter((c) => c.messages.length > 0);
+}
+function parseClaude(content, sourceFile = "conversations.json") {
+  const data = JSON.parse(content);
+  if (!Array.isArray(data)) return [];
+  return data.map((conv) => {
+    const title = conv.name ?? conv.uuid ?? "Untitled";
+    const messages = [];
+    if (conv.chat_messages) {
+      for (const msg of conv.chat_messages) {
+        let text = msg.text ?? "";
+        if (!text && Array.isArray(msg.content)) {
+          text = msg.content.filter((c) => c.type === "text" && c.text).map((c) => c.text).join("\n");
+        }
+        if (!text.trim()) continue;
+        messages.push({
+          role: msg.sender ?? "unknown",
+          content: text.trim(),
+          timestamp: msg.created_at
+        });
+      }
+    }
+    return { title, messages, sourceFile };
+  }).filter((c) => c.messages.length > 0);
+}
+function parseGeneric(content, sourceFile = "conversations.json") {
+  const trimmed = content.trimStart();
+  try {
+    const data = JSON.parse(trimmed);
+    if (Array.isArray(data)) {
+      if (data.length > 0 && typeof data[0] === "object" && ("role" in data[0] || "content" in data[0])) {
+        const messages = data.map((msg) => ({
+          role: msg.role ?? "unknown",
+          content: (msg.content ?? msg.text ?? "").trim(),
+          timestamp: msg.timestamp ?? msg.created_at
+        })).filter((m) => m.content.length > 0);
+        if (messages.length > 0) {
+          return [{ title: sourceFile, messages, sourceFile }];
+        }
+      }
+    }
+  } catch {
+  }
+  return parseMarkdown(content, sourceFile);
+}
+function parseMarkdown(content, sourceFile = "conversation.md") {
+  const lines = content.split("\n");
+  const conversations = [];
+  let currentTitle = sourceFile;
+  let currentMessages = [];
+  let currentRole = "user";
+  let currentContent = [];
+  function flushMessage() {
+    const text = currentContent.join("\n").trim();
+    if (text) {
+      currentMessages.push({ role: currentRole, content: text });
+    }
+    currentContent = [];
+  }
+  function flushConversation() {
+    flushMessage();
+    if (currentMessages.length > 0) {
+      conversations.push({ title: currentTitle, messages: [...currentMessages], sourceFile });
+    }
+    currentMessages = [];
+  }
+  for (const line of lines) {
+    const h1Match = line.match(/^# (.+)$/);
+    if (h1Match) {
+      flushConversation();
+      currentTitle = h1Match[1];
+      continue;
+    }
+    const roleMatch = line.match(/^(?:##\s+|\*\*)(user|assistant|human|system|ai|claude|gpt)(?:\*\*)?:?\s*/i);
+    if (roleMatch) {
+      flushMessage();
+      const raw = roleMatch[1].toLowerCase();
+      currentRole = raw === "human" || raw === "user" ? "user" : raw === "assistant" || raw === "ai" || raw === "claude" || raw === "gpt" ? "assistant" : raw;
+      continue;
+    }
+    currentContent.push(line);
+  }
+  flushConversation();
+  return conversations;
+}
+function conversationsToMemories(convos, format = "generic") {
+  const memories = [];
+  for (const convo of convos) {
+    for (const msg of convo.messages) {
+      if (msg.content.length < 10) continue;
+      memories.push({
+        text: msg.content,
+        kind: "conversation",
+        metadata: {
+          source_type: "import",
+          source_format: format,
+          source_path: convo.sourceFile,
+          conversation_title: convo.title,
+          role: msg.role,
+          original_timestamp: msg.timestamp
+        }
+      });
+    }
+  }
+  return memories;
+}
+
+// src/mcp/tools/import-conversations.ts
+var DEFAULT_CAP = 5e4;
+var YIELD_INTERVAL = 50;
+async function readInputFiles(inputPath) {
+  const files = [];
+  const info = await stat(inputPath);
+  if (info.isDirectory()) {
+    const entries = await readdir(inputPath);
+    for (const entry of entries) {
+      const fullPath = path.join(inputPath, entry);
+      const entryStat = await stat(fullPath);
+      if (entryStat.isFile() && (entry.endsWith(".json") || entry.endsWith(".md") || entry.endsWith(".txt"))) {
+        files.push({ path: fullPath, content: await readFile(fullPath, "utf-8") });
+      }
+    }
+  } else {
+    files.push({ path: inputPath, content: await readFile(inputPath, "utf-8") });
+  }
+  return files;
+}
+function parseFile(content, filePath, requestedFormat) {
+  const format = requestedFormat && requestedFormat !== "auto" ? requestedFormat : detectFormat(content, filePath);
+  let conversations;
+  switch (format) {
+    case "chatgpt":
+      conversations = parseChatGPT(content, filePath);
+      break;
+    case "claude":
+      conversations = parseClaude(content, filePath);
+      break;
+    case "markdown":
+      conversations = parseMarkdown(content, filePath);
+      break;
+    case "generic":
+    default:
+      conversations = parseGeneric(content, filePath);
+      break;
+  }
+  return { format, conversations };
+}
+function registerImportConversations(server) {
+  server.registerTool(
+    "import_conversations",
+    {
+      title: "Import Conversations",
+      description: "Import ChatGPT, Claude, or generic conversation exports into memory. Parses, extracts keywords + graph entities, stores with proper metadata. Deduplicates via content_hash. Supports JSON, markdown, and directory input.",
+      inputSchema: {
+        path: z.string().describe("File or directory path to import"),
+        format: z.enum(["chatgpt", "claude", "generic", "markdown", "auto"]).default("auto").describe("Source format (default: auto-detect)"),
+        project_name: z.string().optional().describe("Project name for imported memories"),
+        dry_run: z.boolean().default(false).describe("Parse and report counts without storing"),
+        force: z.boolean().default(false).describe("Override 50K memory cap"),
+        agent_id: z.string().optional().describe("Agent to attribute memories to (default: current agent)")
+      }
+    },
+    async ({ path: inputPath, format: requestedFormat, project_name, dry_run, force, agent_id: overrideAgentId }) => {
+      const { agentId: currentAgentId, agentRole } = getActiveAgent();
+      const agentId = overrideAgentId ?? currentAgentId;
+      const projectName = project_name ?? "imported";
+      const resolvedPath = resolve(normalize(inputPath));
+      const home = process.env.HOME || os.homedir();
+      const blocked = ["/etc", "/root", "/var", "/usr", "/sys", "/proc"];
+      const sensitiveHome = [".ssh", ".gnupg", ".aws", ".config/gcloud"];
+      for (const dir of blocked) {
+        if (resolvedPath.startsWith(dir + "/") || resolvedPath === dir) {
+          return {
+            content: [{ type: "text", text: `Access denied: cannot read files from ${dir}` }],
+            isError: true
+          };
+        }
+      }
+      for (const rel of sensitiveHome) {
+        const full = resolve(home, rel);
+        if (resolvedPath.startsWith(full + "/") || resolvedPath === full) {
+          return {
+            content: [{ type: "text", text: `Access denied: cannot read files from ~/${rel}` }],
+            isError: true
+          };
+        }
+      }
+      let files;
+      try {
+        files = await readInputFiles(inputPath);
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error reading ${inputPath}: ${err instanceof Error ? err.message : String(err)}` }],
+          isError: true
+        };
+      }
+      if (files.length === 0) {
+        return {
+          content: [{ type: "text", text: `No importable files found at ${inputPath}` }],
+          isError: true
+        };
+      }
+      const allMemories = [];
+      let conversationCount = 0;
+      const formatCounts = {};
+      for (const file of files) {
+        const { format, conversations } = parseFile(file.content, file.path, requestedFormat);
+        formatCounts[format] = (formatCounts[format] ?? 0) + conversations.length;
+        conversationCount += conversations.length;
+        const memories = conversationsToMemories(conversations, format);
+        allMemories.push(...memories);
+      }
+      if (allMemories.length > DEFAULT_CAP && !force) {
+        return {
+          content: [{
+            type: "text",
+            text: `Import would create ${allMemories.length} memories (cap: ${DEFAULT_CAP}). Use force=true to override. Files: ${files.length}, Conversations: ${conversationCount}`
+          }],
+          isError: true
+        };
+      }
+      if (dry_run) {
+        const formatSummary2 = Object.entries(formatCounts).map(([f, c]) => `${f}: ${c}`).join(", ");
+        return {
+          content: [{
+            type: "text",
+            text: `[DRY RUN] Would import:
+  Files: ${files.length}
+  Conversations: ${conversationCount} (${formatSummary2})
+  Memories: ${allMemories.length}
+  Agent: ${agentId}
+  Project: ${projectName}`
+          }]
+        };
+      }
+      let stored = 0;
+      let skipped = 0;
+      for (let i = 0; i < allMemories.length; i++) {
+        const memory = allMemories[i];
+        try {
+          const keywords = extractKeywords(memory.text);
+          const keywordsStr = keywords.length > 0 ? keywords.join(" ") : null;
+          let entities = null;
+          try {
+            const graph = extractMemoryGraph(memory.text, agentId, projectName, "import_conversations");
+            if (graph.entities.length > 0) {
+              entities = JSON.stringify(graph.entities.map((e) => e.name));
+            }
+          } catch {
+          }
+          const id = crypto.randomUUID();
+          await writeMemory({
+            id,
+            agent_id: agentId,
+            agent_role: agentRole,
+            session_id: process.env.SESSION_ID ?? "import",
+            timestamp: memory.metadata.original_timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+            tool_name: "import_conversations",
+            project_name: projectName,
+            has_error: false,
+            raw_text: memory.text,
+            vector: null,
+            // Backfill later
+            source_path: memory.metadata.source_path,
+            source_type: "import",
+            memory_type: "conversation",
+            tier: 3,
+            // Passive ingestion
+            importance: memory.metadata.role === "assistant" ? 5 : 4,
+            intent: "observation",
+            domain: projectName,
+            referenced_entities: entities,
+            keywords: keywordsStr,
+            valid_from: memory.metadata.original_timestamp ?? void 0
+          });
+          stored++;
+        } catch {
+          skipped++;
+        }
+        if ((i + 1) % YIELD_INTERVAL === 0) {
+          await flushBatch();
+          await new Promise((r) => setTimeout(r, 0));
+          if ((i + 1) % (YIELD_INTERVAL * 10) === 0) {
+            process.stderr.write(`[import] ${i + 1}/${allMemories.length} memories processed, ${stored} stored
+`);
+          }
+        }
+      }
+      await flushBatch();
+      const formatSummary = Object.entries(formatCounts).map(([f, c]) => `${f}: ${c}`).join(", ");
+      return {
+        content: [{
+          type: "text",
+          text: `Import complete.
+  Files: ${files.length}
+  Conversations: ${conversationCount} (${formatSummary})
+  Memories stored: ${stored}
+  Duplicates skipped: ${skipped}
+  Agent: ${agentId}
+  Project: ${projectName}`
+        }]
+      };
+    }
+  );
+}
+
+export {
+  registerImportConversations
+};

package/dist/chunk-ZVABYVSP.js

@@ -0,0 +1,122 @@
+import {
+  getActiveAgent
+} from "./chunk-ZXNQ7GRU.js";
+import {
+  listTasks
+} from "./chunk-TWFTSIAI.js";
+import {
+  getAgentContext
+} from "./chunk-GJV3WDWM.js";
+import {
+  isCoordinatorName
+} from "./chunk-IDJCLLJF.js";
+
+// src/mcp/tools/list-tasks.ts
+import { z } from "zod";
+function registerListTasks(server) {
+  server.registerTool(
+    "list_tasks",
+    {
+      title: "List Tasks",
+      description: "Query tasks by assignee, status, project, or priority. Defaults to current project. Pass project_name='all' for all projects. When querying your own tasks, project filter is skipped automatically.",
+      inputSchema: {
+        assigned_to: z.string().optional().describe("Filter by employee name"),
+        status: z.enum(["open", "in_progress", "done", "needs_review", "blocked", "cancelled", "closed"]).optional().describe("Filter by status. Default: active tasks only (excludes closed/cancelled)"),
+        project_name: z.string().optional().describe("Project name. Defaults to current project. Pass 'all' for all projects."),
+        priority: z.enum(["p0", "p1", "p2"]).optional().describe("Filter by priority"),
+        cross_session: z.boolean().optional().describe("When true, return tasks from ALL coordinator sessions (read-only). Default: false.")
+      }
+    },
+    async ({ assigned_to, status, project_name, priority, cross_session }) => {
+      try {
+        const { agentId } = getActiveAgent();
+        const isReviewQueue = status === "needs_review";
+        const shouldDefaultToOwnQueue = !assigned_to && !isReviewQueue && !isCoordinatorName(agentId);
+        const effectiveAssignedTo = assigned_to ?? (shouldDefaultToOwnQueue ? agentId : void 0);
+        const effectiveReviewer = !assigned_to && isReviewQueue ? agentId : void 0;
+        const isOwnQuery = effectiveAssignedTo === agentId;
+        const callerSession = getAgentContext()?.sessionHint || process.env.EXE_SESSION_NAME || process.env.EXE_SESSION || null;
+        const resolvedProject = project_name && project_name !== "all" ? project_name : null;
+        const effectiveCrossSession = cross_session === true;
+        const identityAmbiguous = !callerSession && (agentId === "default" || !agentId);
+        let tasks = await listTasks({
+          assignedTo: effectiveAssignedTo,
+          reviewer: effectiveReviewer,
+          status,
+          projectName: resolvedProject,
+          priority,
+          crossSession: effectiveCrossSession,
+          isOwnQuery: !!isOwnQuery,
+          callerSession
+        });
+        let recoveredCrossSession = false;
+        if (tasks.length === 0 && identityAmbiguous && !effectiveCrossSession) {
+          const crossTasks = await listTasks({
+            // Drop the own-queue assignee default — identity is unreliable here.
+            assignedTo: assigned_to,
+            reviewer: effectiveReviewer,
+            status,
+            projectName: resolvedProject,
+            priority,
+            crossSession: true,
+            isOwnQuery: false,
+            callerSession: null
+          });
+          if (crossTasks.length > 0) {
+            tasks = crossTasks;
+            recoveredCrossSession = true;
+          }
+        }
+        if (tasks.length === 0) {
+          if (identityAmbiguous) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: "Could not resolve your session identity (multiple coordinator sessions are live and no per-session MCP header was provided). Task scoping is unreliable, and a cross-session read also returned no rows. If you expect tasks to exist, retry with cross_session=true and an explicit project_name='all', or configure a per-session MCP header (X-Exe-Session). Treat this as 'unknown', NOT 'empty'."
+                }
+              ],
+              isError: true
+            };
+          }
+          return {
+            content: [{ type: "text", text: "No tasks found." }]
+          };
+        }
+        const lines = tasks.map((t) => {
+          const cpIndicator = t.checkpointCount && t.checkpointCount > 0 ? ` [cp:${t.checkpointCount}]` : "";
+          let budgetNote = "";
+          if (t.budgetTokens !== null) {
+            const pct = Math.round(t.tokensUsed / t.budgetTokens * 100);
+            budgetNote = ` [${t.tokensUsed}/${t.budgetTokens} tokens, ${pct}%]`;
+          }
+          const shortId = t.id.slice(0, 8);
+          const showSession = cross_session || recoveredCrossSession;
+          const sessionNote = showSession && t.sessionScope ? ` [session:${t.sessionScope}]` : "";
+          return `- [${t.priority.toUpperCase()}] ${t.title} (${t.projectName}) \u2014 ${t.status}${cpIndicator}${budgetNote}${sessionNote} \u2192 ${t.assignedTo} [id:${shortId}]`;
+        });
+        const header = recoveredCrossSession ? `WARNING: session identity was ambiguous (multiple coordinator sessions, no per-session MCP header) \u2014 showing tasks ACROSS ALL sessions. Configure a per-session X-Exe-Session header for scoped results.
+${tasks.length} task(s) (cross-session):` : `${tasks.length} task(s):`;
+        return {
+          content: [
+            {
+              type: "text",
+              text: `${header}
+${lines.join("\n")}`
+            }
+          ]
+        };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          content: [{ type: "text", text: `Failed to list tasks: ${msg}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+export {
+  registerListTasks
+};

package/dist/chunk-ZVDYPSJH.js

@@ -0,0 +1,94 @@
+import {
+  connectEmbedDaemon,
+  disconnectClient,
+  embedViaClient
+} from "./chunk-4HDMB2M5.js";
+import {
+  EMBEDDING_DIM
+} from "./chunk-FXU7JOXK.js";
+import {
+  MODELS_DIR,
+  loadConfigSync
+} from "./chunk-R36FAN53.js";
+
+// src/lib/embedder.ts
+var MAX_EMBED_CHARS = 24e3;
+var DOMAIN_PREFIXES = {
+  memory: { query: "search_query: agent memory: ", passage: "search_document: agent memory: " },
+  decision: { query: "search_query: decision record: ", passage: "search_document: decision: " },
+  code: { query: "search_query: source code: ", passage: "search_document: code: " },
+  document: { query: "search_query: document: ", passage: "search_document: document: " },
+  general: { query: "", passage: "" }
+};
+function prepareEmbeddingText(text, kind, domain) {
+  const cfg = loadConfigSync();
+  const truncated = text.length > MAX_EMBED_CHARS ? text.slice(0, MAX_EMBED_CHARS) : text;
+  if (domain && domain !== "general") {
+    const domainPrefix = DOMAIN_PREFIXES[domain];
+    const prefix2 = kind === "passage" ? domainPrefix.passage : domainPrefix.query;
+    return prefix2 ? `${prefix2}${truncated}` : truncated;
+  }
+  if (!kind || !cfg.embeddingPrefixes.enabled) return truncated;
+  const prefix = kind === "query" ? cfg.embeddingPrefixes.query : cfg.embeddingPrefixes.passage;
+  return prefix ? `${prefix}${truncated}` : truncated;
+}
+async function getEmbedder() {
+  const ok = await connectEmbedDaemon();
+  if (!ok) {
+    throw new Error(
+      "Could not connect to embedding daemon. Embeddings may be disabled or the daemon may be unreachable."
+    );
+  }
+}
+async function embed(text) {
+  const priority = process.env.EXE_EMBED_PRIORITY === "low" ? "low" : "high";
+  const vector = await embedViaClient(prepareEmbeddingText(text), priority);
+  if (!vector) {
+    throw new Error(
+      "Embedding failed: daemon unavailable or no embedding model is loaded."
+    );
+  }
+  const expectedDim = loadConfigSync().embeddingDim || EMBEDDING_DIM;
+  if (vector.length !== expectedDim) {
+    throw new Error(
+      `Embedding dimension mismatch: expected ${expectedDim}, got ${vector.length}. Ensure the configured embedding model matches config.embeddingDim.`
+    );
+  }
+  return vector;
+}
+async function disposeEmbedder() {
+  disconnectClient();
+}
+async function embedDirect(text) {
+  const llamaCpp = await import("node-llama-cpp");
+  const { existsSync } = await import("fs");
+  const path = await import("path");
+  const cfg = loadConfigSync();
+  const modelPath = path.join(MODELS_DIR, cfg.modelFile);
+  if (!existsSync(modelPath)) {
+    throw new Error(`Embedding model not found at ${modelPath}. Install or configure an embedding model to validate it.`);
+  }
+  const llama = await llamaCpp.getLlama();
+  const model = await llama.loadModel({ modelPath });
+  const context = await model.createEmbeddingContext();
+  try {
+    const embedding = await context.getEmbeddingFor(prepareEmbeddingText(text));
+    const vector = Array.from(embedding.vector);
+    const expectedDim = cfg.embeddingDim || EMBEDDING_DIM;
+    if (vector.length !== expectedDim) {
+      throw new Error(
+        `Embedding dimension mismatch: expected ${expectedDim}, got ${vector.length}.`
+      );
+    }
+    return vector;
+  } finally {
+  }
+}
+
+export {
+  prepareEmbeddingText,
+  getEmbedder,
+  embed,
+  disposeEmbedder,
+  embedDirect
+};