@theokit/sdk-tools 0.13.0 → 0.14.0

package/dist/index.cjs

@@ -8,6 +8,7 @@ var fs = require('fs');
 var pathSafety = require('@theokit/sdk/path-safety');
 var persistence = require('@theokit/sdk/persistence');
 var child_process = require('child_process');
+var interactive = require('@theokit/sdk/interactive');
 var promises$1 = require('dns/promises');
 var net = require('net');
 var filesystem = require('@theokit/sdk/filesystem');
@@ -691,6 +692,60 @@ function globToRegex(pattern) {
   }
   return new RegExp(`^${regexStr}$`);
 }
+function toErrorJson(err) {
+  if (err instanceof interactive.InteractiveUnavailableError) {
+    return JSON.stringify({ ok: false, error: "interactive_unavailable" });
+  }
+  if (err instanceof interactive.NoSuchSessionError) {
+    return JSON.stringify({ ok: false, error: "no_such_session" });
+  }
+  throw err;
+}
+function createInteractiveShellTool(opts) {
+  const { interactive: interactive$1 } = opts;
+  return sdk.Tool.create({
+    name: "interactive_shell",
+    description: "Start an interactive shell session for a command that PROMPTS for input or is a REPL (python, node, `git rebase -i`, a `read` prompt) \u2014 NOT for one-shot commands (use shell_exec). Returns a session_id; drive it with write_stdin, reading the incremental output each step. Returns { ok, session_id, output } or { ok: false, error }.",
+    inputSchema: zod.z.object({
+      command: zod.z.string().min(1).describe("Command to run interactively, e.g. 'python3' or 'bash -i'."),
+      yield_time_ms: zod.z.number().int().positive().optional().describe("How long to wait for startup output before returning (clamped by the backend).")
+    }),
+    handler: async ({ command, yield_time_ms }, ctx) => {
+      try {
+        const backend = await interactive.resolveInteractive(interactive$1, ctx ?? {});
+        const { sessionId, output } = await backend.startInteractive(command, {
+          yieldMs: yield_time_ms
+        });
+        return JSON.stringify({ ok: true, session_id: sessionId, output });
+      } catch (err) {
+        return toErrorJson(err);
+      }
+    }
+  });
+}
+function createWriteStdinTool(opts) {
+  const { interactive: interactive$1 } = opts;
+  return sdk.Tool.create({
+    name: "write_stdin",
+    description: "Write input to a live interactive session (from interactive_shell) and read the output it produces during the wait window. Include a trailing newline to submit a line. Returns { ok, output, alive } (alive:false means the session exited) or { ok: false, error }.",
+    inputSchema: zod.z.object({
+      session_id: zod.z.string().min(1).describe("The session_id returned by interactive_shell."),
+      input: zod.z.string().describe("Text to write to stdin (add a trailing '\\n' to submit a line)."),
+      yield_time_ms: zod.z.number().int().positive().optional().describe("How long to wait for output before returning (clamped by the backend).")
+    }),
+    handler: async ({ session_id, input, yield_time_ms }, ctx) => {
+      try {
+        const backend = await interactive.resolveInteractive(interactive$1, ctx ?? {});
+        const { output, alive } = await backend.writeStdin(session_id, input, {
+          yieldMs: yield_time_ms
+        });
+        return JSON.stringify({ ok: true, output, alive });
+      } catch (err) {
+        return toErrorJson(err);
+      }
+    }
+  });
+}
 var CatastrophicCommandError = class extends sdk.ConfigurationError {
   name = "CatastrophicCommandError";
   constructor(reason) {
@@ -2360,6 +2415,7 @@ exports.createEditFileTool = createEditFileTool;
 exports.createGenericHttpSearchAdapter = createGenericHttpSearchAdapter;
 exports.createGitDiffTool = createGitDiffTool;
 exports.createGlobTool = createGlobTool;
+exports.createInteractiveShellTool = createInteractiveShellTool;
 exports.createListDirTool = createListDirTool;
 exports.createPlanModeTool = createPlanModeTool;
 exports.createQuestionTool = createQuestionTool;
@@ -2372,6 +2428,7 @@ exports.createTodolistTool = createTodolistTool;
 exports.createWebFetchTool = createWebFetchTool;
 exports.createWebSearchTool = createWebSearchTool;
 exports.createWriteFileTool = createWriteFileTool;
+exports.createWriteStdinTool = createWriteStdinTool;
 exports.denyCatastrophicCommands = denyCatastrophicCommands;
 exports.formatCode = formatCode;
 exports.formatDiff = formatDiff;