@todoforai/tfa-explore 0.1.0 → 0.1.1

package/dist/cli.js

@@ -2878,11 +2878,7 @@ var require_websocket_server = __commonJS((exports, module) => {
 
 // src/cli.ts
 import { parseArgs } from "node:util";
-
-// ../tfa-subagent/dist/index.js
-import { homedir, platform } from "os";
-import { readFileSync } from "fs";
-import { join } from "path";
+import { readFileSync } from "node:fs";
 
 // ../node_modules/ws/wrapper.mjs
 var import_stream = __toESM(require_stream(), 1);
@@ -2908,45 +2904,23 @@ function normalizeApiUrl(url) {
     return `https://${url}`;
   return url.replace(/\/+$/, "");
 }
-function credentialsPath() {
-  const home = homedir();
-  if (platform() === "win32")
-    return join(home, "AppData", "Roaming", "todoforai", "credentials.json");
-  if (platform() === "darwin")
-    return join(home, "Library", "Application Support", "todoforai", "credentials.json");
-  const xdg = process.env.XDG_CONFIG_HOME;
-  return xdg ? join(xdg, "todoforai", "credentials.json") : join(home, ".config", "todoforai", "credentials.json");
-}
-var _credsCache;
-function loadCredentials() {
-  if (_credsCache !== undefined)
-    return _credsCache;
-  try {
-    _credsCache = JSON.parse(readFileSync(credentialsPath(), "utf8"));
-  } catch {
-    _credsCache = null;
-  }
-  return _credsCache;
-}
 function resolveAuth(opts = {}) {
-  const creds = loadCredentials();
-  const credsApiUrl = creds?.backendHost ? normalizeApiUrl(creds.backendHost) : "";
-  const apiUrl = normalizeApiUrl(opts.apiUrl || getEnv("TODOFORAI_API_URL") || credsApiUrl || DEFAULT_API_URL);
-  const apiKey = opts.apiKey || getEnv("TODOFORAI_API_KEY") || getEnv("TODOFORAI_API_TOKEN") || creds?.apiKey || "";
+  const apiUrl = normalizeApiUrl(opts.apiUrl || getEnv("TODOFORAI_API_URL") || DEFAULT_API_URL);
+  const apiToken = opts.apiToken || getEnv("TODOFORAI_API_TOKEN");
   const agentSettingsId = opts.agentSettingsId || getEnv("TODOFORAI_AGENT_SETTINGS_ID");
-  if (!apiKey)
-    throw new Error("no API key (run `todoforai-bridge login`, or set TODOFORAI_API_KEY, or pass --api-key)");
+  if (!apiToken)
+    throw new Error("TODOFORAI_API_TOKEN not set (run `todoforai-bridge` to start the bridge, or pass --api-token)");
   if (!agentSettingsId)
     throw new Error("agent settings id required (set TODOFORAI_AGENT_SETTINGS_ID or pass --agent <id>)");
-  const apiBase = apiKey.startsWith("dst_") ? "/dst/v1" : "/api/v1";
-  return { apiUrl, apiKey, agentSettingsId, apiBase };
+  const apiBase = apiToken.startsWith("dst_") ? "/dst/v1" : "/api/v1";
+  return { apiUrl, apiToken, agentSettingsId, apiBase };
 }
-async function api(path, init = {}, apiUrl, apiKey, tabId) {
+async function api(path, init = {}, apiUrl, apiToken, tabId) {
   const res = await fetch(`${apiUrl}${path}`, {
     ...init,
     headers: {
       "content-type": "application/json",
-      "x-api-key": apiKey,
+      "x-api-key": apiToken,
       ...tabId ? { "x-tab-id": tabId } : {},
       ...init.headers ?? {}
     }
@@ -2998,7 +2972,7 @@ var TERMINAL = new Set([
 ]);
 async function openSocket(opts) {
   const wsUrl = opts.apiUrl.replace(/^http/, "ws") + "/ws/v1/frontend?tabId=" + encodeURIComponent(opts.tabId);
-  const ws = new wrapper_default(wsUrl, [opts.apiKey]);
+  const ws = new wrapper_default(wsUrl, [opts.apiToken]);
   ws.on("error", (err) => process.stderr.write(`[ws error] ${err.message}
 `));
   await new Promise((ok, fail) => {
@@ -3022,7 +2996,6 @@ async function streamToTerminal(ws, opts = {}) {
   return new Promise((resolve) => {
     let exitCode = 0;
     let result = "";
-    let inText = false;
     const finish = (code) => {
       exitCode = code;
       ws.close();
@@ -3039,18 +3012,14 @@ async function streamToTerminal(ws, opts = {}) {
       if (!t)
         return;
       if (t === "block:message" && typeof ev.payload?.content === "string") {
-        if (inText)
-          result += ev.payload.content;
+        result += ev.payload.content;
         if (streamStdout)
           process.stdout.write(ev.payload.content);
         return;
       }
       if (t === "block:start_universal" && ev.payload?.block_type) {
         const bt = ev.payload.block_type;
-        inText = bt === "TEXT";
-        if (inText)
-          result = "";
-        else if (streamStdout && bt !== "REASON")
+        if (bt !== "TEXT" && bt !== "REASON")
           process.stderr.write(`
 → ${bt}
 `);
@@ -3073,9 +3042,9 @@ async function streamToTerminal(ws, opts = {}) {
   });
 }
 async function runTfa(spec) {
-  const { apiUrl, apiKey, agentSettingsId, apiBase } = resolveAuth({
+  const { apiUrl, apiToken, agentSettingsId, apiBase } = resolveAuth({
     apiUrl: spec.apiUrl,
-    apiKey: spec.apiKey,
+    apiToken: spec.apiToken,
     agentSettingsId: spec.agentSettingsId
   });
   const allowed = new Set(spec.allowedTools);
@@ -3087,7 +3056,7 @@ async function runTfa(spec) {
   }
   const allowTools = requested.length ? requested : spec.allowedTools;
   const tabId = crypto.randomUUID();
-  const settings = await api(`${apiBase}/agents/${agentSettingsId}`, {}, apiUrl, apiKey);
+  const settings = await api(`${apiBase}/agents/${agentSettingsId}`, {}, apiUrl, apiToken);
   const patched = patchSettings(settings, {
     systemMessage: spec.systemMessage,
     allowTools,
@@ -3096,22 +3065,22 @@ async function runTfa(spec) {
   });
   let projectId = spec.projectId || "";
   if (!projectId) {
-    const projects = await api(`${apiBase}/projects`, {}, apiUrl, apiKey);
+    const projects = await api(`${apiBase}/projects`, {}, apiUrl, apiToken);
     if (!projects?.length)
       throw new Error("no project found. Pass --project <id>.");
     projectId = projects[0].project?.id ?? projects[0].id;
   }
-  const ws = await openSocket({ apiUrl, apiKey, tabId });
+  const ws = await openSocket({ apiUrl, apiToken, tabId });
   const visible = spec.visible === true;
   const todoRes = await api(`${apiBase}/projects/${projectId}/todos`, {
     method: "POST",
     body: JSON.stringify({ content: spec.content, agentSettings: patched, visible })
-  }, apiUrl, apiKey, tabId);
+  }, apiUrl, apiToken, tabId);
   const todoId = todoRes.id;
   await api(`${apiBase}/todos/${todoId}/subscribe`, {
     method: "POST",
     body: JSON.stringify({ todoId })
-  }, apiUrl, apiKey, tabId);
+  }, apiUrl, apiToken, tabId);
   process.stderr.write(`[${spec.binName}] todo=${todoId}${visible ? "" : " (hidden)"}
 `);
   const { exitCode, result } = await streamToTerminal(ws, { streamStdout: visible });
@@ -3119,6 +3088,15 @@ async function runTfa(spec) {
 }
 
 // src/cli.ts
+function readStdin() {
+  if (process.stdin.isTTY)
+    return "";
+  try {
+    return readFileSync(0, "utf-8");
+  } catch {
+    return "";
+  }
+}
 var EXPLORE_SYS_PROMPT = `You are a codebase exploration agent. Read files, run non-destructive shell commands (ls, grep, find, tree), and report findings.
 
 Goals:
@@ -3146,13 +3124,11 @@ Options:
   -a, --agent <id>       Agent settings ID (default: $TODOFORAI_AGENT_SETTINGS_ID)
   -p, --project <id>     Project ID (default: first project the user owns)
   --tools <a,b,c>        Restrict to a subset of ${ALLOWED_TOOLS.join(",")} (comma-separated)
-  --show                 Show this TODO in the project list and stream output to
-                         stdout as it arrives (default: hidden + final result only).
   -h, --help             Show this help
   -v, --version          Show version
 
 Env (auto-injected by edge shell):
-  TODOFORAI_API_URL, TODOFORAI_API_KEY, TODOFORAI_AGENT_SETTINGS_ID
+  TODOFORAI_API_URL, TODOFORAI_API_TOKEN, TODOFORAI_AGENT_SETTINGS_ID
 `);
 }
 async function main() {
@@ -3164,7 +3140,6 @@ async function main() {
       agent: { type: "string", short: "a" },
       project: { type: "string", short: "p" },
       tools: { type: "string" },
-      show: { type: "boolean", default: false },
       help: { type: "boolean", short: "h", default: false },
       version: { type: "boolean", short: "v", default: false }
     },
@@ -3179,30 +3154,32 @@ async function main() {
     console.log("tfa-explore 0.1.0");
     return;
   }
-  const question = positionals.join(" ").trim();
+  const requestedTools = values.tools ? String(values.tools).split(",").map((s) => s.trim()).filter(Boolean) : [];
+  const stdinText = readStdin().trim();
+  const ctx = stdinText ? `
+
+# Context (stdin)
+\`\`\`
+${stdinText}
+\`\`\`` : "";
+  const question = positionals.join(" ").trim() || (stdinText ? "Explore this codebase using the context above. Surface structure, conventions, and relevant files." : "");
   if (!question) {
     console.error("Error: missing question. Run `tfa-explore --help`.");
     process.exit(2);
   }
-  const requestedTools = values.tools ? String(values.tools).split(",").map((s) => s.trim()).filter(Boolean) : [];
-  const visible = Boolean(values.show);
-  const { exitCode, result } = await runTfa({
+  const { exitCode } = await runTfa({
     binName: "tfa-explore",
     systemMessage: EXPLORE_SYS_PROMPT,
     allowedTools: ALLOWED_TOOLS,
     content: `# Question
-${question}`,
+${question}${ctx}`,
     repo: values.repo,
     model: values.model,
     agentSettingsId: values.agent,
     projectId: values.project,
     requestedTools,
-    visible
+    visible: true
   });
-  if (!visible)
-    process.stdout.write(result.endsWith(`
-`) ? result : result + `
-`);
   process.exit(exitCode);
 }
 main().catch((e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/tfa-explore",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lightweight TODO for AI explore — creates a real TODO with patched permissions and streams blocks to your terminal.",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "dev": "bun run src/cli.ts"
   },
   "devDependencies": {
-    "@todoforai/tfa-subagent": "workspace:*",
+    "@todoforai/tfa-subagent": "^0.1.1",
     "@types/node": "^20.11.0"
   },
   "keywords": ["cli", "ai", "explore", "todoforai"],