@locusai/telegram 0.14.2 → 0.14.4

package/bin/telegram.js

@@ -38909,7 +38909,7 @@ var init_src2 = __esm(() => {
 });
 
 // ../sdk/src/core/config.ts
-import { join } from "node:path";
+import { join as join2 } from "node:path";
 function isValidModelForProvider(provider, model) {
   return PROVIDER_MODELS[provider].includes(model);
 }
@@ -38917,7 +38917,7 @@ function getModelsForProvider(provider) {
   return PROVIDER_MODELS[provider];
 }
 function getLocusPath(projectPath, fileName) {
-  return join(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG[fileName]);
+  return join2(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG[fileName]);
 }
 var PROVIDER, CLAUDE_MODELS, CODEX_MODELS, PROVIDER_MODELS, DEFAULT_MODEL, LOCUS_SCHEMA_BASE_URL = "https://locusai.dev/schemas", LOCUS_SCHEMAS, LOCUS_CONFIG;
 var init_config = __esm(() => {
@@ -39373,35 +39373,35 @@ var init_colors = __esm(() => {
 });
 
 // ../sdk/src/utils/resolve-bin.ts
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "node:fs";
 import { homedir } from "node:os";
-import { delimiter, join as join2 } from "node:path";
+import { delimiter, join as join3 } from "node:path";
 function getNvmNodeBinDir() {
-  const nvmDir = process.env.NVM_DIR || join2(homedir(), ".nvm");
-  const versionsDir = join2(nvmDir, "versions", "node");
-  if (!existsSync(versionsDir))
+  const nvmDir = process.env.NVM_DIR || join3(homedir(), ".nvm");
+  const versionsDir = join3(nvmDir, "versions", "node");
+  if (!existsSync2(versionsDir))
     return null;
   let versions2;
   try {
-    versions2 = readdirSync(versionsDir).filter((d) => d.startsWith("v"));
+    versions2 = readdirSync2(versionsDir).filter((d) => d.startsWith("v"));
   } catch {
     return null;
   }
   if (versions2.length === 0)
     return null;
   const currentNodeVersion = `v${process.versions.node}`;
-  const currentBin = join2(versionsDir, currentNodeVersion, "bin");
-  if (versions2.includes(currentNodeVersion) && existsSync(currentBin)) {
+  const currentBin = join3(versionsDir, currentNodeVersion, "bin");
+  if (versions2.includes(currentNodeVersion) && existsSync2(currentBin)) {
     return currentBin;
   }
-  const aliasPath = join2(nvmDir, "alias", "default");
-  if (existsSync(aliasPath)) {
+  const aliasPath = join3(nvmDir, "alias", "default");
+  if (existsSync2(aliasPath)) {
     try {
-      const alias = readFileSync(aliasPath, "utf-8").trim();
+      const alias = readFileSync2(aliasPath, "utf-8").trim();
       const match = versions2.find((v) => v === `v${alias}` || v.startsWith(`v${alias}.`));
       if (match) {
-        const bin2 = join2(versionsDir, match, "bin");
-        if (existsSync(bin2))
+        const bin2 = join3(versionsDir, match, "bin");
+        if (existsSync2(bin2))
           return bin2;
       }
     } catch {}
@@ -39415,18 +39415,18 @@ function getNvmNodeBinDir() {
     }
     return 0;
   });
-  const bin = join2(versionsDir, sorted[0], "bin");
-  return existsSync(bin) ? bin : null;
+  const bin = join3(versionsDir, sorted[0], "bin");
+  return existsSync2(bin) ? bin : null;
 }
 function getFnmNodeBinDir() {
-  const fnmDir = process.env.FNM_DIR || join2(homedir(), ".fnm");
-  const currentBin = join2(fnmDir, "current", "bin");
-  if (existsSync(currentBin))
+  const fnmDir = process.env.FNM_DIR || join3(homedir(), ".fnm");
+  const currentBin = join3(fnmDir, "current", "bin");
+  if (existsSync2(currentBin))
     return currentBin;
-  const aliasDir = join2(fnmDir, "aliases", "default");
-  if (existsSync(aliasDir)) {
-    const bin = join2(aliasDir, "bin");
-    if (existsSync(bin))
+  const aliasDir = join3(fnmDir, "aliases", "default");
+  if (existsSync2(aliasDir)) {
+    const bin = join3(aliasDir, "bin");
+    if (existsSync2(bin))
       return bin;
   }
   return null;
@@ -39436,7 +39436,7 @@ function getAugmentedPath() {
   const currentDirs = new Set(currentPath.split(delimiter));
   const extra = [];
   for (const dir of EXTRA_BIN_DIRS) {
-    if (!currentDirs.has(dir) && existsSync(dir)) {
+    if (!currentDirs.has(dir) && existsSync2(dir)) {
       extra.push(dir);
     }
   }
@@ -39466,12 +39466,12 @@ function getAugmentedEnv(overrides = {}) {
 var EXTRA_BIN_DIRS, ENV_VARS_TO_STRIP;
 var init_resolve_bin = __esm(() => {
   EXTRA_BIN_DIRS = [
-    join2(homedir(), ".local", "bin"),
-    join2(homedir(), ".npm", "bin"),
-    join2(homedir(), ".npm-global", "bin"),
-    join2(homedir(), ".yarn", "bin"),
-    join2(homedir(), ".bun", "bin"),
-    join2(homedir(), "Library", "pnpm"),
+    join3(homedir(), ".local", "bin"),
+    join3(homedir(), ".npm", "bin"),
+    join3(homedir(), ".npm-global", "bin"),
+    join3(homedir(), ".yarn", "bin"),
+    join3(homedir(), ".bun", "bin"),
+    join3(homedir(), "Library", "pnpm"),
     "/usr/local/bin",
     "/opt/homebrew/bin",
     "/opt/homebrew/sbin"
@@ -39913,9 +39913,9 @@ var init_claude_runner = __esm(() => {
 // ../sdk/src/ai/codex-runner.ts
 import { spawn as spawn2 } from "node:child_process";
 import { randomUUID } from "node:crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2, unlinkSync } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, unlinkSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 
 class CodexRunner {
   projectPath;
@@ -39980,7 +39980,7 @@ class CodexRunner {
     });
   }
   async* runStream(prompt) {
-    const outputPath = join3(tmpdir(), `locus-codex-${randomUUID()}.txt`);
+    const outputPath = join4(tmpdir(), `locus-codex-${randomUUID()}.txt`);
     const args = this.buildArgs(outputPath);
     this.eventEmitter?.emitSessionStarted({
       model: this.model,
@@ -40144,7 +40144,7 @@ class CodexRunner {
   }
   executeRun(prompt) {
     return new Promise((resolve2, reject) => {
-      const outputPath = join3(tmpdir(), `locus-codex-${randomUUID()}.txt`);
+      const outputPath = join4(tmpdir(), `locus-codex-${randomUUID()}.txt`);
       const args = this.buildArgs(outputPath);
       const codex = spawn2("codex", args, {
         cwd: this.projectPath,
@@ -40215,9 +40215,9 @@ class CodexRunner {
     return /^Plan update\b/.test(line);
   }
   readOutput(outputPath, fallback) {
-    if (existsSync2(outputPath)) {
+    if (existsSync3(outputPath)) {
       try {
-        const text = readFileSync2(outputPath, "utf-8").trim();
+        const text = readFileSync3(outputPath, "utf-8").trim();
         if (text)
           return text;
       } catch {}
@@ -40231,7 +40231,7 @@ class CodexRunner {
   }
   cleanupTempFile(path) {
     try {
-      if (existsSync2(path))
+      if (existsSync3(path))
         unlinkSync(path);
     } catch {}
   }
@@ -40269,14 +40269,14 @@ var init_factory = __esm(() => {
 
 // ../sdk/src/discussion/discussion-manager.ts
 import {
-  existsSync as existsSync3,
+  existsSync as existsSync4,
   mkdirSync,
-  readdirSync as readdirSync2,
-  readFileSync as readFileSync3,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync4,
   unlinkSync as unlinkSync2,
   writeFileSync
 } from "node:fs";
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 
 class DiscussionManager {
   discussionsDir;
@@ -40303,30 +40303,30 @@ class DiscussionManager {
   }
   save(discussion) {
     this.ensureDir();
-    const jsonPath = join4(this.discussionsDir, `${discussion.id}.json`);
-    const mdPath = join4(this.discussionsDir, `summary-${discussion.id}.md`);
+    const jsonPath = join5(this.discussionsDir, `${discussion.id}.json`);
+    const mdPath = join5(this.discussionsDir, `summary-${discussion.id}.md`);
     writeFileSync(jsonPath, JSON.stringify(discussion, null, 2), "utf-8");
     writeFileSync(mdPath, this.toMarkdown(discussion), "utf-8");
   }
   load(id) {
     this.ensureDir();
-    const filePath = join4(this.discussionsDir, `${id}.json`);
-    if (!existsSync3(filePath)) {
+    const filePath = join5(this.discussionsDir, `${id}.json`);
+    if (!existsSync4(filePath)) {
       return null;
     }
     try {
-      return JSON.parse(readFileSync3(filePath, "utf-8"));
+      return JSON.parse(readFileSync4(filePath, "utf-8"));
     } catch {
       return null;
     }
   }
   list(status) {
     this.ensureDir();
-    const files = readdirSync2(this.discussionsDir).filter((f) => f.endsWith(".json"));
+    const files = readdirSync3(this.discussionsDir).filter((f) => f.endsWith(".json"));
     const discussions = [];
     for (const file2 of files) {
       try {
-        const discussion = JSON.parse(readFileSync3(join4(this.discussionsDir, file2), "utf-8"));
+        const discussion = JSON.parse(readFileSync4(join5(this.discussionsDir, file2), "utf-8"));
         if (!status || discussion.status === status) {
           discussions.push(discussion);
         }
@@ -40356,12 +40356,12 @@ class DiscussionManager {
   }
   delete(id) {
     this.ensureDir();
-    const jsonPath = join4(this.discussionsDir, `${id}.json`);
-    const mdPath = join4(this.discussionsDir, `summary-${id}.md`);
-    if (existsSync3(jsonPath)) {
+    const jsonPath = join5(this.discussionsDir, `${id}.json`);
+    const mdPath = join5(this.discussionsDir, `summary-${id}.md`);
+    if (existsSync4(jsonPath)) {
       unlinkSync2(jsonPath);
     }
-    if (existsSync3(mdPath)) {
+    if (existsSync4(mdPath)) {
       unlinkSync2(mdPath);
     }
   }
@@ -40446,7 +40446,7 @@ class DiscussionManager {
 `);
   }
   ensureDir() {
-    if (!existsSync3(this.discussionsDir)) {
+    if (!existsSync4(this.discussionsDir)) {
       mkdirSync(this.discussionsDir, { recursive: true });
     }
   }
@@ -40456,8 +40456,8 @@ var init_discussion_manager = __esm(() => {
 });
 
 // ../sdk/src/core/prompt-builder.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
-import { join as join5 } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+import { join as join6 } from "node:path";
 
 class PromptBuilder {
   projectPath;
@@ -40616,9 +40616,9 @@ ${sections}
   }
   getProjectContext() {
     const contextPath = getLocusPath(this.projectPath, "contextFile");
-    if (existsSync4(contextPath)) {
+    if (existsSync5(contextPath)) {
       try {
-        const context2 = readFileSync4(contextPath, "utf-8");
+        const context2 = readFileSync5(contextPath, "utf-8");
         if (context2.trim().length > 20) {
           return context2;
         }
@@ -40629,10 +40629,10 @@ ${sections}
     return this.getFallbackContext() || null;
   }
   getFallbackContext() {
-    const readmePath = join5(this.projectPath, "README.md");
-    if (existsSync4(readmePath)) {
+    const readmePath = join6(this.projectPath, "README.md");
+    if (existsSync5(readmePath)) {
       try {
-        const content = readFileSync4(readmePath, "utf-8");
+        const content = readFileSync5(readmePath, "utf-8");
         const limit = 1000;
         return content.slice(0, limit) + (content.length > limit ? `
 ...(truncated)...` : "");
@@ -40651,11 +40651,11 @@ If you need more information about the project strategies, plans, or architectur
   }
   getLearningsContent() {
     const learningsPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync4(learningsPath)) {
+    if (!existsSync5(learningsPath)) {
       return null;
     }
     try {
-      const content = readFileSync4(learningsPath, "utf-8");
+      const content = readFileSync5(learningsPath, "utf-8");
       const lines = content.split(`
 `).filter((l) => l.startsWith("- "));
       if (lines.length === 0) {
@@ -41099,7 +41099,7 @@ var init_worker = __esm(() => {
 var import_config16 = __toESM(require_config(), 1);
 
 // src/bot.ts
-var import_telegraf4 = __toESM(require_lib3(), 1);
+var import_telegraf5 = __toESM(require_lib3(), 1);
 
 // src/callbacks.ts
 init_src();
@@ -41220,6 +41220,173 @@ async function requireApiKey(ctx, config2, command) {
   await ctx.reply(formatError2(`API key is required for /${command}. Run: locus config setup --api-key <KEY>`), { parse_mode: "HTML" });
   return false;
 }
+
+// src/commands/artifacts.ts
+var import_telegraf = __toESM(require_lib3(), 1);
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+var ARTIFACTS_DIR = ".locus/artifacts";
+function listArtifacts(projectPath) {
+  const artifactsDir = join(projectPath, ARTIFACTS_DIR);
+  if (!existsSync(artifactsDir)) {
+    return [];
+  }
+  const files = readdirSync(artifactsDir).filter((f) => f.endsWith(".md"));
+  return files.map((fileName) => {
+    const filePath = join(artifactsDir, fileName);
+    const stat = statSync(filePath);
+    const name = fileName.replace(/\.md$/, "");
+    return {
+      name,
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    };
+  }).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+}
+function formatSize(bytes) {
+  if (bytes < 1024)
+    return `${bytes}B`;
+  const kb = bytes / 1024;
+  if (kb < 1024)
+    return `${kb.toFixed(1)}KB`;
+  const mb = kb / 1024;
+  return `${mb.toFixed(1)}MB`;
+}
+async function artifactsCommand(ctx, config2) {
+  const text = (ctx.message && "text" in ctx.message ? ctx.message.text : "") || "";
+  const args = text.replace(/^\/artifacts\s*/, "").trim();
+  console.log(`[artifacts] Received: ${args || "(list)"}`);
+  if (args) {
+    await showArtifact(ctx, config2, args);
+    return;
+  }
+  const artifacts = listArtifacts(config2.projectPath);
+  if (artifacts.length === 0) {
+    await ctx.reply(formatInfo("No artifacts found."), {
+      parse_mode: "HTML"
+    });
+    return;
+  }
+  let msg = `<b>\uD83D\uDCC4 Artifacts</b> (${artifacts.length} total)
+
+`;
+  for (let i = 0;i < artifacts.length; i++) {
+    const artifact = artifacts[i];
+    const age = formatRelativeTime(artifact.createdAt);
+    const size = formatSize(artifact.size);
+    const index = String(i + 1).padStart(2, " ");
+    msg += `${index}. <b>${escapeHtml(artifact.name)}</b>
+`;
+    msg += `     <i>${age} • ${size}</i>
+`;
+  }
+  msg += `
+Tap an artifact below to view or convert to plan.`;
+  const buttons = artifacts.slice(0, 10).map((artifact) => [
+    import_telegraf.Markup.button.callback(`\uD83D\uDC41 ${artifact.name.slice(0, 30)}`, `view:artifact:${artifact.name.slice(0, 40)}`),
+    import_telegraf.Markup.button.callback("\uD83D\uDCCB Plan", `plan:artifact:${artifact.name.slice(0, 40)}`)
+  ]);
+  const parts = splitMessage(msg);
+  for (let i = 0;i < parts.length; i++) {
+    const isLast = i === parts.length - 1;
+    await ctx.reply(parts[i], {
+      parse_mode: "HTML",
+      ...isLast ? import_telegraf.Markup.inlineKeyboard(buttons) : {}
+    });
+  }
+}
+async function showArtifact(ctx, config2, name) {
+  const artifactsDir = join(config2.projectPath, ARTIFACTS_DIR);
+  const fileName = name.endsWith(".md") ? name : `${name}.md`;
+  const filePath = join(artifactsDir, fileName);
+  let content;
+  let artifactName = name.replace(/\.md$/, "");
+  if (existsSync(filePath)) {
+    content = readFileSync(filePath, "utf-8");
+  } else {
+    const artifacts = listArtifacts(config2.projectPath);
+    const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (matches.length === 1) {
+      const matchPath = join(artifactsDir, matches[0].fileName);
+      content = readFileSync(matchPath, "utf-8");
+      artifactName = matches[0].name;
+    } else if (matches.length > 1) {
+      let msg2 = `<b>Multiple artifacts match "${escapeHtml(name)}":</b>
+
+`;
+      for (const m of matches) {
+        msg2 += `• <b>${escapeHtml(m.name)}</b>
+`;
+      }
+      await ctx.reply(msg2, { parse_mode: "HTML" });
+      return;
+    } else {
+      await ctx.reply(formatError2(`Artifact "${escapeHtml(name)}" not found.`), { parse_mode: "HTML" });
+      return;
+    }
+  }
+  const truncated = truncateOutput(escapeHtml(content), 3500);
+  let msg = `<b>\uD83D\uDCC4 ${escapeHtml(artifactName)}</b>
+
+`;
+  msg += `<pre>${truncated}</pre>`;
+  const buttons = import_telegraf.Markup.inlineKeyboard([
+    [
+      import_telegraf.Markup.button.callback("\uD83D\uDCCB Convert to Plan", `plan:artifact:${artifactName.slice(0, 40)}`)
+    ]
+  ]);
+  const parts = splitMessage(msg);
+  for (let i = 0;i < parts.length; i++) {
+    const isLast = i === parts.length - 1;
+    await ctx.reply(parts[i], {
+      parse_mode: "HTML",
+      ...isLast ? buttons : {}
+    });
+  }
+}
+async function convertArtifactToPlan(ctx, config2, executor, name) {
+  const artifactName = name.replace(/\.md$/, "");
+  const artifactsDir = join(config2.projectPath, ARTIFACTS_DIR);
+  const filePath = join(artifactsDir, `${artifactName}.md`);
+  if (!existsSync(filePath)) {
+    const artifacts = listArtifacts(config2.projectPath);
+    const match = artifacts.find((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (!match) {
+      await ctx.reply(formatError2(`Artifact "${escapeHtml(name)}" not found.`), { parse_mode: "HTML" });
+      return;
+    }
+  }
+  await ctx.reply(formatInfo(`Converting <b>${escapeHtml(artifactName)}</b> to a plan...`), { parse_mode: "HTML" });
+  const directive = `Prepare a plan according to the artifact: ${artifactName}`;
+  const args = executor.buildArgs(["plan", directive, "--no-stream"]);
+  executor.execute(args).then(async (result) => {
+    const output = (result.stdout + result.stderr).trim();
+    try {
+      if (!output && result.exitCode !== 0) {
+        await ctx.reply(formatError2("Plan conversion failed with no output."), { parse_mode: "HTML" });
+        return;
+      }
+      const cleanOutput = truncateOutput(escapeHtml(output), 3500);
+      let msg = `<b>\uD83D\uDCCB Plan from: ${escapeHtml(artifactName)}</b>
+
+`;
+      msg += `<pre>${cleanOutput}</pre>`;
+      const parts = splitMessage(msg);
+      for (const part of parts) {
+        await ctx.reply(part, { parse_mode: "HTML" });
+      }
+    } catch (err) {
+      console.error("[artifacts:plan] Failed to send result:", err);
+    }
+  }, async (err) => {
+    try {
+      await ctx.reply(formatError2(`Plan conversion failed: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    } catch {
+      console.error("[artifacts:plan] Failed to send error:", err);
+    }
+  });
+}
 // ../sdk/src/agent/document-fetcher.ts
 init_config();
 
@@ -41832,7 +41999,7 @@ ${insightsText.trimEnd()}
 }
 // ../sdk/src/discussion/discussion-facilitator.ts
 init_config();
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "node:fs";
 class DiscussionFacilitator {
   projectPath;
   aiRunner;
@@ -41979,9 +42146,9 @@ class DiscussionFacilitator {
   }
   getProjectContext() {
     const contextPath = getLocusPath(this.projectPath, "contextFile");
-    if (existsSync5(contextPath)) {
+    if (existsSync6(contextPath)) {
       try {
-        const context2 = readFileSync5(contextPath, "utf-8");
+        const context2 = readFileSync6(contextPath, "utf-8");
         if (context2.trim().length > 20) {
           return context2;
         }
@@ -41993,11 +42160,11 @@ class DiscussionFacilitator {
   }
   getLearningsContent() {
     const learningsPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync5(learningsPath)) {
+    if (!existsSync6(learningsPath)) {
       return null;
     }
     try {
-      const content = readFileSync5(learningsPath, "utf-8");
+      const content = readFileSync6(learningsPath, "utf-8");
       const lines = content.split(`
 `).filter((l) => l.startsWith("- "));
       if (lines.length === 0) {
@@ -42417,14 +42584,14 @@ class ExecEventEmitter {
 // ../sdk/src/exec/history-manager.ts
 init_config();
 import {
-  existsSync as existsSync6,
+  existsSync as existsSync7,
   mkdirSync as mkdirSync2,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync6,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync7,
   rmSync,
   writeFileSync as writeFileSync2
 } from "node:fs";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 var DEFAULT_MAX_SESSIONS = 30;
 function generateSessionId2() {
   const timestamp = Date.now().toString(36);
@@ -42436,17 +42603,17 @@ class HistoryManager {
   historyDir;
   maxSessions;
   constructor(projectPath, options) {
-    this.historyDir = options?.historyDir ?? join6(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
+    this.historyDir = options?.historyDir ?? join7(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.sessionsDir);
     this.maxSessions = options?.maxSessions ?? DEFAULT_MAX_SESSIONS;
     this.ensureHistoryDir();
   }
   ensureHistoryDir() {
-    if (!existsSync6(this.historyDir)) {
+    if (!existsSync7(this.historyDir)) {
       mkdirSync2(this.historyDir, { recursive: true });
     }
   }
   getSessionPath(sessionId) {
-    return join6(this.historyDir, `${sessionId}.json`);
+    return join7(this.historyDir, `${sessionId}.json`);
   }
   saveSession(session2) {
     const filePath = this.getSessionPath(session2.id);
@@ -42455,11 +42622,11 @@ class HistoryManager {
   }
   loadSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!existsSync6(filePath)) {
+    if (!existsSync7(filePath)) {
       return null;
     }
     try {
-      const content = readFileSync6(filePath, "utf-8");
+      const content = readFileSync7(filePath, "utf-8");
       return JSON.parse(content);
     } catch {
       return null;
@@ -42467,7 +42634,7 @@ class HistoryManager {
   }
   deleteSession(sessionId) {
     const filePath = this.getSessionPath(sessionId);
-    if (!existsSync6(filePath)) {
+    if (!existsSync7(filePath)) {
       return false;
     }
     try {
@@ -42478,7 +42645,7 @@ class HistoryManager {
     }
   }
   listSessions(options) {
-    const files = readdirSync3(this.historyDir);
+    const files = readdirSync4(this.historyDir);
     let sessions = [];
     for (const file2 of files) {
       if (file2.endsWith(".json")) {
@@ -42551,11 +42718,11 @@ class HistoryManager {
     return deleted;
   }
   getSessionCount() {
-    const files = readdirSync3(this.historyDir);
+    const files = readdirSync4(this.historyDir);
     return files.filter((f) => f.endsWith(".json")).length;
   }
   sessionExists(sessionId) {
-    return existsSync6(this.getSessionPath(sessionId));
+    return existsSync7(this.getSessionPath(sessionId));
   }
   findSessionByPartialId(partialId) {
     const sessions = this.listSessions();
@@ -42569,12 +42736,12 @@ class HistoryManager {
     return this.historyDir;
   }
   clearAllSessions() {
-    const files = readdirSync3(this.historyDir);
+    const files = readdirSync4(this.historyDir);
     let deleted = 0;
     for (const file2 of files) {
       if (file2.endsWith(".json")) {
         try {
-          rmSync(join6(this.historyDir, file2));
+          rmSync(join7(this.historyDir, file2));
           deleted++;
         } catch {}
       }
@@ -42851,8 +43018,8 @@ init_src2();
 init_colors();
 init_resolve_bin();
 import { spawn as spawn3 } from "node:child_process";
-import { existsSync as existsSync7 } from "node:fs";
-import { dirname, join as join7 } from "node:path";
+import { existsSync as existsSync8 } from "node:fs";
+import { dirname, join as join8 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { EventEmitter as EventEmitter4 } from "events";
 
@@ -43121,12 +43288,12 @@ ${agentId} finished (exit code: ${code})`);
     const currentModulePath = fileURLToPath(import.meta.url);
     const currentModuleDir = dirname(currentModulePath);
     const potentialPaths = [
-      join7(currentModuleDir, "..", "agent", "worker.js"),
-      join7(currentModuleDir, "agent", "worker.js"),
-      join7(currentModuleDir, "worker.js"),
-      join7(currentModuleDir, "..", "agent", "worker.ts")
+      join8(currentModuleDir, "..", "agent", "worker.js"),
+      join8(currentModuleDir, "agent", "worker.js"),
+      join8(currentModuleDir, "worker.js"),
+      join8(currentModuleDir, "..", "agent", "worker.ts")
     ];
-    return potentialPaths.find((p) => existsSync7(p));
+    return potentialPaths.find((p) => existsSync8(p));
   }
 }
 function killProcessTree(proc) {
@@ -43176,7 +43343,7 @@ init_config();
 init_colors();
 
 // src/commands/discuss.ts
-var import_telegraf = __toESM(require_lib3(), 1);
+var import_telegraf2 = __toESM(require_lib3(), 1);
 var activeDiscussions = new Map;
 var facilitatorCache = new Map;
 function getFacilitator(config2) {
@@ -43241,8 +43408,8 @@ ${escapeHtml(result.message)}`;
       await ctx.reply(parts[i], {
         parse_mode: "HTML",
         ...isLast ? {
-          reply_markup: import_telegraf.Markup.inlineKeyboard([
-            import_telegraf.Markup.button.callback("End Discussion", `end:discuss:${result.discussion.id}`)
+          reply_markup: import_telegraf2.Markup.inlineKeyboard([
+            import_telegraf2.Markup.button.callback("End Discussion", `end:discuss:${result.discussion.id}`)
           ]).reply_markup
         } : {}
       });
@@ -43269,8 +43436,8 @@ async function continueDiscussionHandler(ctx, config2, message) {
       await ctx.reply(responseParts[i], {
         parse_mode: "HTML",
         ...isLast ? {
-          reply_markup: import_telegraf.Markup.inlineKeyboard([
-            import_telegraf.Markup.button.callback("End Discussion", `end:discuss:${discussionId}`)
+          reply_markup: import_telegraf2.Markup.inlineKeyboard([
+            import_telegraf2.Markup.button.callback("End Discussion", `end:discuss:${discussionId}`)
           ]).reply_markup
         } : {}
       });
@@ -43335,9 +43502,9 @@ async function discussionsCommand(ctx, config2) {
     for (let i = 0;i < parts.length; i++) {
       const isLast = i === parts.length - 1;
       const buttons = discussions.slice(0, 5).flatMap((d) => [
-        import_telegraf.Markup.button.callback(`View ${d.id.slice(-6)}`, `view:discuss:${d.id}`),
+        import_telegraf2.Markup.button.callback(`View ${d.id.slice(-6)}`, `view:discuss:${d.id}`),
         ...d.status !== "archived" ? [
-          import_telegraf.Markup.button.callback(`Archive ${d.id.slice(-6)}`, `archive:discuss:${d.id}`)
+          import_telegraf2.Markup.button.callback(`Archive ${d.id.slice(-6)}`, `archive:discuss:${d.id}`)
         ] : []
       ]);
       const rows = [];
@@ -43346,7 +43513,7 @@ async function discussionsCommand(ctx, config2) {
       }
       await ctx.reply(parts[i], {
         parse_mode: "HTML",
-        ...isLast && rows.length > 0 ? { reply_markup: import_telegraf.Markup.inlineKeyboard(rows).reply_markup } : {}
+        ...isLast && rows.length > 0 ? { reply_markup: import_telegraf2.Markup.inlineKeyboard(rows).reply_markup } : {}
       });
     }
   } catch (err) {
@@ -43380,8 +43547,8 @@ ${escapeHtml(summary)}`;
       await ctx.reply(parts[i], {
         parse_mode: "HTML",
         ...isLast ? {
-          reply_markup: import_telegraf.Markup.inlineKeyboard([
-            import_telegraf.Markup.button.callback("View Full Discussion", `view:discuss:${discussionId}`)
+          reply_markup: import_telegraf2.Markup.inlineKeyboard([
+            import_telegraf2.Markup.button.callback("View Full Discussion", `view:discuss:${discussionId}`)
           ]).reply_markup
         } : {}
       });
@@ -43411,8 +43578,8 @@ ${escapeHtml(summary)}`;
       await ctx.reply(parts[i], {
         parse_mode: "HTML",
         ...isLast ? {
-          reply_markup: import_telegraf.Markup.inlineKeyboard([
-            import_telegraf.Markup.button.callback("View Full Discussion", `view:discuss:${discussionId}`)
+          reply_markup: import_telegraf2.Markup.inlineKeyboard([
+            import_telegraf2.Markup.button.callback("View Full Discussion", `view:discuss:${discussionId}`)
           ]).reply_markup
         } : {}
       });
@@ -43625,6 +43792,16 @@ ${escapeHtml(desc)}
     const discussionId = ctx.match[1];
     await archiveDiscussion(ctx, config2, discussionId);
   });
+  bot.action(/^view:artifact:(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery();
+    const artifactName = ctx.match[1];
+    await showArtifact(ctx, config2, artifactName);
+  });
+  bot.action(/^plan:artifact:(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery("Converting to plan…");
+    const artifactName = ctx.match[1];
+    await convertArtifactToPlan(ctx, config2, executor, artifactName);
+  });
 }
 
 // src/commands/activity.ts
@@ -43784,8 +43961,8 @@ Total: ${agents.length} active agent(s)`;
   }
 }
 // src/commands/config.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join8 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join9 } from "node:path";
 
 // src/command-whitelist.ts
 var SAFE_BRANCH = /^[a-zA-Z0-9_\-./]+$/;
@@ -44153,13 +44330,13 @@ var USAGE = `<b>Usage:</b>
 ${Object.entries(ALLOWED_KEYS).map(([k, v]) => `  \`${k}\` — ${v.description}`).join(`
 `)}`;
 function getSettingsPath(config2) {
-  return join8(config2.projectPath, CONFIG_DIR, SETTINGS_FILE);
+  return join9(config2.projectPath, CONFIG_DIR, SETTINGS_FILE);
 }
 function loadSettings(config2) {
   const path = getSettingsPath(config2);
-  if (!existsSync8(path))
+  if (!existsSync9(path))
     return null;
-  const raw = readFileSync7(path, "utf-8");
+  const raw = readFileSync8(path, "utf-8");
   return JSON.parse(raw);
 }
 function saveSettings(config2, settings) {
@@ -44483,13 +44660,13 @@ import { spawn as spawn4 } from "node:child_process";
 
 // src/env.ts
 import { homedir as homedir2 } from "node:os";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 function extraPathDirs() {
   const home = homedir2();
   return [
-    join9(home, ".bun", "bin"),
-    join9(home, ".nvm", "current", "bin"),
-    join9(home, ".local", "bin"),
+    join10(home, ".bun", "bin"),
+    join10(home, ".nvm", "current", "bin"),
+    join10(home, ".local", "bin"),
     "/usr/local/bin"
   ];
 }
@@ -44727,6 +44904,8 @@ var HELP_TEXT = `<b>Locus Bot — Command Center</b>
 
 \uD83D\uDD27 <b>Dev &amp; Git:</b>
 /exec &lt;prompt&gt; — One-shot AI execution
+/artifacts — List knowledge artifacts
+/artifacts &lt;name&gt; — View an artifact
 /review [pr-number] — AI review of PR or changes
 /git &lt;command&gt; — Run whitelisted git/gh commands
 /dev &lt;command&gt; — Run lint, typecheck, build, test
@@ -44754,7 +44933,7 @@ async function helpCommand(ctx) {
   await ctx.reply(HELP_TEXT, { parse_mode: "HTML" });
 }
 // src/commands/plan.ts
-var import_telegraf2 = __toESM(require_lib3(), 1);
+var import_telegraf3 = __toESM(require_lib3(), 1);
 async function planCommand(ctx, executor) {
   const text = (ctx.message && "text" in ctx.message ? ctx.message.text : "") || "";
   const directive = text.replace(/^\/plan\s*/, "").trim();
@@ -44792,12 +44971,12 @@ async function plansCommand(ctx, executor) {
   const planIds = extractPendingPlanIds(cleanOutput);
   if (planIds.length > 0) {
     const buttons = planIds.slice(0, 5).map((planId) => [
-      import_telegraf2.Markup.button.callback("✅ Approve", `approve:plan:${planId}`),
-      import_telegraf2.Markup.button.callback("❌ Cancel", `cancel:plan:${planId}`)
+      import_telegraf3.Markup.button.callback("✅ Approve", `approve:plan:${planId}`),
+      import_telegraf3.Markup.button.callback("❌ Cancel", `cancel:plan:${planId}`)
     ]);
     await ctx.reply(formattedOutput, {
       parse_mode: "HTML",
-      ...import_telegraf2.Markup.inlineKeyboard(buttons)
+      ...import_telegraf3.Markup.inlineKeyboard(buttons)
     });
   } else {
     await ctx.reply(formattedOutput, { parse_mode: "HTML" });
@@ -45135,7 +45314,7 @@ async function statusCommand(ctx, executor) {
 }
 // src/commands/tasks.ts
 init_src();
-var import_telegraf3 = __toESM(require_lib3(), 1);
+var import_telegraf4 = __toESM(require_lib3(), 1);
 var VALID_STATUSES = Object.values(TaskStatus);
 var priorityIcon = {
   CRITICAL: "\uD83D\uDD34",
@@ -45191,13 +45370,13 @@ async function tasksCommand(ctx, config2) {
     const inReviewTasks = tasks2.filter((t) => t.status === "IN_REVIEW" /* IN_REVIEW */);
     if (inReviewTasks.length > 0) {
       const buttons = inReviewTasks.slice(0, 5).map((t) => [
-        import_telegraf3.Markup.button.callback("✅ Approve", `approve:task:${t.id}`),
-        import_telegraf3.Markup.button.callback("\uD83D\uDC41 View", `view:task:${t.id}`)
+        import_telegraf4.Markup.button.callback("✅ Approve", `approve:task:${t.id}`),
+        import_telegraf4.Markup.button.callback("\uD83D\uDC41 View", `view:task:${t.id}`)
       ]);
       await ctx.reply(msg.trim(), {
         parse_mode: "HTML",
         link_preview_options: { is_disabled: true },
-        ...import_telegraf3.Markup.inlineKeyboard(buttons)
+        ...import_telegraf4.Markup.inlineKeyboard(buttons)
       });
     } else {
       await ctx.reply(msg.trim(), {
@@ -45410,7 +45589,7 @@ async function approveTaskCommand(ctx, config2) {
 // src/commands/upgrade.ts
 import { spawn as spawn5 } from "node:child_process";
 import { homedir as homedir3 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 function runCommand2(cmd, args, timeout) {
   return new Promise((resolve2) => {
     const proc = spawn5(cmd, args, {
@@ -45455,7 +45634,7 @@ function getRestartInfo() {
     };
   }
   if (platform === "darwin") {
-    const plistPath = join10(homedir3(), "Library/LaunchAgents/com.locus.telegram.plist");
+    const plistPath = join11(homedir3(), "Library/LaunchAgents/com.locus.telegram.plist");
     return {
       label: "launchctl (macOS)",
       commands: [
@@ -45571,7 +45750,7 @@ async function workspaceCommand(ctx, config2) {
 }
 // src/executor.ts
 import { spawn as spawn6 } from "node:child_process";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function timestamp2() {
   return new Date().toLocaleTimeString("en-GB", { hour12: false });
 }
@@ -45587,7 +45766,7 @@ class CliExecutor {
   }
   resolveCommand(args) {
     if (this.config.testMode) {
-      const cliPath = join11(this.config.projectPath, "packages/cli/src/cli.ts");
+      const cliPath = join12(this.config.projectPath, "packages/cli/src/cli.ts");
       return { cmd: "bun", cmdArgs: ["run", cliPath, ...args] };
     }
     return { cmd: "locus", cmdArgs: args };
@@ -45748,7 +45927,7 @@ class CliExecutor {
 
 // src/bot.ts
 function createBot(config2) {
-  const bot = new import_telegraf4.Telegraf(config2.botToken, {
+  const bot = new import_telegraf5.Telegraf(config2.botToken, {
     handlerTimeout: HANDLER_TIMEOUT
   });
   const executor = new CliExecutor(config2);
@@ -45793,6 +45972,7 @@ function createBot(config2) {
   bot.command("enddiscuss", (ctx) => endDiscussCommand(ctx, config2));
   bot.command("config", (ctx) => configCommand(ctx, config2));
   bot.command("model", (ctx) => modelCommand(ctx, config2));
+  bot.command("artifacts", (ctx) => artifactsCommand(ctx, config2));
   bot.command("activity", (ctx) => activityCommand(ctx, config2));
   bot.command("workspace", (ctx) => workspaceCommand(ctx, config2));
   bot.command("status", (ctx) => statusCommand(ctx, executor));
@@ -45829,6 +46009,10 @@ function createBot(config2) {
     { command: "run", description: "Start agent on sprint tasks" },
     { command: "stop", description: "Stop all running processes" },
     { command: "exec", description: "One-shot AI execution" },
+    {
+      command: "artifacts",
+      description: "List & manage knowledge artifacts"
+    },
     { command: "review", description: "AI review of PR or changes" },
     { command: "activity", description: "Recent workspace activity" },
     { command: "workspace", description: "Workspace info & stats" },
@@ -45851,17 +46035,17 @@ function createBot(config2) {
 
 // src/config.ts
 var import_dotenv = __toESM(require_main(), 1);
-import { existsSync as existsSync9, readFileSync as readFileSync8 } from "node:fs";
-import { join as join12 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
+import { join as join13 } from "node:path";
 import_dotenv.default.config();
 var SETTINGS_FILE2 = "settings.json";
 var CONFIG_DIR2 = ".locus";
 function loadSettings2(projectPath) {
-  const settingsPath = join12(projectPath, CONFIG_DIR2, SETTINGS_FILE2);
-  if (!existsSync9(settingsPath)) {
+  const settingsPath = join13(projectPath, CONFIG_DIR2, SETTINGS_FILE2);
+  if (!existsSync10(settingsPath)) {
     return null;
   }
-  const raw = readFileSync8(settingsPath, "utf-8");
+  const raw = readFileSync9(settingsPath, "utf-8");
   return JSON.parse(raw);
 }
 function resolveConfig() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/telegram",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "description": "Telegram bot for Locus - remote control your AI agents from Telegram",
   "type": "module",
   "bin": {
@@ -31,8 +31,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@locusai/sdk": "^0.14.2",
-    "@locusai/shared": "^0.14.2",
+    "@locusai/sdk": "^0.14.4",
+    "@locusai/shared": "^0.14.4",
     "dotenv": "^16.4.7",
     "telegraf": "^4.16.3"
   },