@theokit/cli 3.0.2 → 4.0.1

package/dist/bin/theokit.js

@@ -358,7 +358,7 @@ function startRunner(opts) {
   args.push(opts.entry);
   const child = spawn(process.execPath, [tsxBin, ...args], {
     cwd: opts.cwd,
-    stdio: "inherit",
+    stdio: opts.stdio ?? "inherit",
     env: process.env
   });
   const exited = new Promise((resolve6) => {
@@ -489,7 +489,13 @@ function formatReport(result) {
 }
 function truncate(s, max) {
   if (s.length <= max) return s;
-  return `${s.slice(0, max - 1)}\u2026`;
+  const budget = max - 1;
+  let out = "";
+  for (const ch of s) {
+    if (out.length + ch.length > budget) break;
+    out += ch;
+  }
+  return `${out}\u2026`;
 }
 function escapeMd(s) {
   return s.replaceAll("|", "\\|").replaceAll("\n", " ");
@@ -619,8 +625,8 @@ ${pc5.green("\u2713")} ${result.aggregate.totalRows} rows \xB7 mean score ${resu
 }
 
 // src/version.ts
-var SDK_VERSION = "4.43.0";
-var CLI_VERSION = "3.0.2";
+var SDK_VERSION = "4.57.0";
+var CLI_VERSION = "4.0.1";
 
 // src/init/templates.ts
 var TEMPLATES = [
@@ -634,6 +640,26 @@ var TEMPLATES = [
     description: "100% local agent via Ollama (no remote API key required).",
     hint: "Requires `ollama serve` + `ollama pull llama3.2:3b`."
   },
+  {
+    name: "chatbot",
+    description: "Conversational agent that resumes its own thread across runs.",
+    hint: "SESSION_DIR=~/.claude writes sessions the Claude Code CLI can --continue."
+  },
+  {
+    name: "multi-agent",
+    description: "A classifier routes to specialists, all from one AgentFactory prefix.",
+    hint: 'Pass the input as an argument: `pnpm dev "Translate to French: hello"`.'
+  },
+  {
+    name: "rag-agent",
+    description: "Retrieval over your own files \u2014 Memory.openIndex behind a Tool.",
+    hint: "Put markdown under .theokit/memory/ first, or there is nothing to cite."
+  },
+  {
+    name: "workflow-automation",
+    description: "A committed Workflow (fn -> agentStep -> fn) handed to Cron.",
+    hint: "WORKFLOW_CRON overrides the schedule; default is every 5 minutes."
+  },
   {
     name: "telegram-bot",
     description: "Telegram bot via @theokit/gateway + grammy.",
@@ -695,6 +721,13 @@ function resolveTemplatesRoot() {
     `Could not locate bundled templates/ directory (searched up from ${here}). This usually means the published tarball was built without "files": ["templates"] (EC-C regression).`
   );
 }
+var SCAFFOLD_USER_ERROR_CODES = [
+  "invalid_project_name",
+  "unknown_template",
+  "invalid_dest",
+  "dest_is_symlink",
+  "dest_not_empty"
+];
 function scaffoldError(code, message) {
   const err = new Error(message);
   err.code = code;
@@ -830,12 +863,7 @@ async function resolveTemplate(optsTemplate, skipPrompts) {
   }
   return template;
 }
-var USER_ERROR_CODES = /* @__PURE__ */ new Set([
-  "invalid_project_name",
-  "dest_not_empty",
-  "invalid_dest",
-  "unknown_template"
-]);
+var USER_ERROR_CODES = new Set(SCAFFOLD_USER_ERROR_CODES);
 async function runScaffold(name, template, force) {
   try {
     const result = await scaffold({
@@ -1189,14 +1217,6 @@ ${pc5.dim("  shape: Desktop OAuth client (installed block present)")}
   }
   const interactiveCode = await runInteractiveSetup();
   if (interactiveCode !== 0) return interactiveCode;
-  if (typeof opts.writable === "string" && opts.writable.length > 0) {
-    process.stdout.write(
-      `
-${pc5.yellow("note:")} you passed --writable=${opts.writable}. The upstream MCP server does not narrow scopes \u2014 all scopes are granted at consent.
-Write tools are gated at runtime by ${pc5.bold("googleWorkspace({ writable: true })")} in your code.
-`
-    );
-  }
   process.stdout.write(
     `
 ${pc5.green("\u2713")} gworkspace setup complete.
@@ -1243,7 +1263,6 @@ function spawnUpstream(args, timeoutMs) {
 async function runSetup(domain, opts) {
   if (domain === "gworkspace") {
     const gworkspaceOpts = {
-      writable: opts.writable,
       probe: opts.probe === true,
       nonInteractive: opts.nonInteractive === true,
       ...opts.credentialsPath !== void 0 ? { credentialsPath: opts.credentialsPath } : {}
@@ -1374,7 +1393,7 @@ async function runTasksInspect(id, opts) {
   }
   return 0;
 }
-async function runTasksCancel(id, _opts) {
+async function runTasksCancel(id, opts) {
   if (!isValidTaskId(id)) {
     process.stderr.write(`tasks: invalid id grammar: ${id}
 `);
@@ -1399,12 +1418,21 @@ async function runTasksCancel(id, _opts) {
   }
   if (handle.state === "queued") {
     const cancelledAt = Date.now();
-    await store.update(id, (h) => ({ ...h, state: "cancelled", cancelledAt }));
+    await store.update(id, (h) => ({
+      ...h,
+      state: "cancelled",
+      cancelledAt,
+      ...opts.reason !== void 0 ? { cancelReason: opts.reason } : {}
+    }));
     process.stdout.write(`task ${id} cancelled (was queued)
 `);
     return 0;
   }
-  await store.update(id, (h) => ({ ...h, cancelRequested: true }));
+  await store.update(id, (h) => ({
+    ...h,
+    cancelRequested: true,
+    ...opts.reason !== void 0 ? { cancelReason: opts.reason } : {}
+  }));
   process.stdout.write(
     `cancel requested for task ${id}; the owning process will honor it at the next checkpoint
 `
@@ -1414,7 +1442,13 @@ async function runTasksCancel(id, _opts) {
 
 // src/main.ts
 function registerSubcommands(program, setExit) {
-  program.command("init [project-name]").description("Scaffold a new agent project from a bundled template.").option("-t, --template <name>", "Template name: minimal | ollama-local | telegram-bot").option("-f, --force", "Overwrite a non-empty destination directory").option("--here", "Scaffold into the current directory").option("-y, --yes", "Skip interactive prompts (CI mode)").action(async (projectName, opts) => {
+  program.command("init [project-name]").description("Scaffold a new agent project from a bundled template.").option(
+    "-t, --template <name>",
+    // Derived from the registry, not restated. This line named three templates while the
+    // registry held seven — a help text that lists options is a second copy of the list, and
+    // the copy is the one that goes stale.
+    `Template name: ${TEMPLATES.map((t) => t.name).join(" | ")}`
+  ).option("-f, --force", "Overwrite a non-empty destination directory").option("-y, --yes", "Skip interactive prompts (CI mode)").action(async (projectName, opts) => {
     setExit(await runInit(projectName, opts));
   });
   program.command("dev").description("Run the agent entry point under tsx --watch (hot-reload).").option("--entry <path>", "Entry file (default: src/index.ts or package.main)").option("--env <path>", "Env file to load (default: .env)").action(async (opts) => {
@@ -1430,15 +1464,12 @@ function registerSubcommands(program, setExit) {
     setExit(await runEval(opts));
   });
   program.command("acp").description(
-    "Launch a stdio Agent Client Protocol (ACP) server pointing at the entry file's default-exported agent. Used by Zed/Cursor/Claude Desktop. ADRs D349-D360."
+    "Launch a stdio Agent Client Protocol (ACP) server pointing at the entry file's default-exported agent. Used by ACP-compatible hosts. ADRs D349-D360."
   ).option("--entry <path>", "Entry file (default: src/index.ts or package.main)").option("--permission <mode>", "Tool permission mode: ask | auto | deny (default: ask)").option("--trusted-tools <list>", "Comma-separated tool names that bypass ask").option("--permission-timeout-ms <ms>", "Permission request timeout in ms (default: 60000)").action(async (opts) => {
     setExit(await runAcp(opts));
   });
   program.command("setup <domain>").description(
     "Stage credentials + connectivity probe for a third-party integration. Domains: gworkspace (Google Workspace)."
-  ).option(
-    "--writable <products>",
-    "Comma-separated products to grant write access (e.g., 'drive,calendar')"
   ).option("--probe", "Run upstream connectivity check after staging credentials").option(
     "--credentials-path <path>",
     "Override path to credentials.json (default: ~/.google-mcp/credentials.json)"
@@ -1476,7 +1507,7 @@ function registerSubcommands(program, setExit) {
     setExit(await runTasksInspect(id, opts));
   });
   tasks.command("cancel <id>").description("Cancel a task (best-effort cross-process via cancelRequested flag)").option("--reason <reason>", "Cancellation reason recorded in the registry").action(async (id, opts) => {
-    setExit(await runTasksCancel(id));
+    setExit(await runTasksCancel(id, opts));
   });
 }
 function mapCommanderExitCode(code, fallback) {