@superatomai/sdk-node 0.0.60-dsp → 0.0.61-dsp

package/dist/index.d.mts

@@ -5506,6 +5506,14 @@ interface CodingAgentsConfig {
     sharedTools?: Record<string, McpServerSpec>;
     /** Keep this many run directories per agent; older ones are pruned. 0 keeps everything. */
     keepRuns?: number;
+    /**
+     * Keep this many THREAD workspaces per thread-scoped agent; the least
+     * recently used are deleted. A persistent workspace is never pruned by
+     * keepRuns, so without this one directory per UI thread accumulates forever
+     * (~3.4 MB each for the answer agent). 0 keeps everything.
+     * Env: CODING_AGENT_KEEP_THREADS.
+     */
+    keepThreads?: number;
 }
 /**
  * Register this deployment's agents. Call once at startup.
@@ -5521,7 +5529,7 @@ declare function listCodingAgents(): Array<{
     description?: string;
     mode: 'task' | 'chat';
 }>;
-declare function getCodingAgentsConfig(): Required<Pick<CodingAgentsConfig, "harness" | "promptRoot" | "runtimeDir" | "keepRuns">> & CodingAgentsConfig;
+declare function getCodingAgentsConfig(): Required<Pick<CodingAgentsConfig, "harness" | "promptRoot" | "runtimeDir" | "keepRuns" | "keepThreads">> & CodingAgentsConfig;
 
 interface RunAgentOptions<TInput> extends AgentRunContext {
     input?: TInput;

package/dist/index.d.ts

@@ -5506,6 +5506,14 @@ interface CodingAgentsConfig {
     sharedTools?: Record<string, McpServerSpec>;
     /** Keep this many run directories per agent; older ones are pruned. 0 keeps everything. */
     keepRuns?: number;
+    /**
+     * Keep this many THREAD workspaces per thread-scoped agent; the least
+     * recently used are deleted. A persistent workspace is never pruned by
+     * keepRuns, so without this one directory per UI thread accumulates forever
+     * (~3.4 MB each for the answer agent). 0 keeps everything.
+     * Env: CODING_AGENT_KEEP_THREADS.
+     */
+    keepThreads?: number;
 }
 /**
  * Register this deployment's agents. Call once at startup.
@@ -5521,7 +5529,7 @@ declare function listCodingAgents(): Array<{
     description?: string;
     mode: 'task' | 'chat';
 }>;
-declare function getCodingAgentsConfig(): Required<Pick<CodingAgentsConfig, "harness" | "promptRoot" | "runtimeDir" | "keepRuns">> & CodingAgentsConfig;
+declare function getCodingAgentsConfig(): Required<Pick<CodingAgentsConfig, "harness" | "promptRoot" | "runtimeDir" | "keepRuns" | "keepThreads">> & CodingAgentsConfig;
 
 interface RunAgentOptions<TInput> extends AgentRunContext {
     input?: TInput;

package/dist/index.js

@@ -24364,7 +24364,8 @@ var config = {
   promptRoot: path8.join(process.cwd(), ".prompts", "coding-agents"),
   runtimeDir: path8.join(process.cwd(), ".coding-agent-runtime"),
   harness: "codex",
-  keepRuns: 20
+  keepRuns: 20,
+  keepThreads: 200
 };
 function registerCodingAgents(definitions, options = {}) {
   config = {
@@ -24373,7 +24374,8 @@ function registerCodingAgents(definitions, options = {}) {
     promptRoot: options.promptRoot || process.env.CODING_AGENT_PROMPT_DIR || config.promptRoot,
     runtimeDir: options.runtimeDir || process.env.CODING_AGENT_RUNTIME_DIR || config.runtimeDir,
     harness: options.harness || process.env.CODING_AGENT_HARNESS || config.harness,
-    keepRuns: options.keepRuns ?? config.keepRuns
+    keepRuns: options.keepRuns ?? config.keepRuns,
+    keepThreads: options.keepThreads ?? (process.env.CODING_AGENT_KEEP_THREADS !== void 0 && Number.isFinite(Number(process.env.CODING_AGENT_KEEP_THREADS)) ? Number(process.env.CODING_AGENT_KEEP_THREADS) : config.keepThreads)
   };
   for (const def of definitions) {
     if (!def.id) throw new Error("A coding agent definition must have an id.");
@@ -24487,6 +24489,27 @@ async function installInstructions(def, ws) {
   }
 }
 var REPAIR_TIMEOUT_MS = 3 * 6e4;
+async function pruneThreads(agentId, threadsDir, keep) {
+  if (keep <= 0) return;
+  try {
+    const dirs = (await fsp.readdir(threadsDir, { withFileTypes: true })).filter((e) => e.isDirectory());
+    if (dirs.length <= keep) return;
+    const aged = await Promise.all(dirs.map(async (e) => {
+      const dir = path9.join(threadsDir, e.name);
+      const stat2 = await fsp.stat(statePath(dir)).catch(() => fsp.stat(dir));
+      return { name: e.name, dir, used: stat2.mtimeMs };
+    }));
+    aged.sort((a, b) => b.used - a.used);
+    let removed = 0;
+    for (const t of aged.slice(keep)) {
+      if (inFlight.has(`${agentId}:thread:${t.name}`)) continue;
+      await fsp.rm(t.dir, { recursive: true, force: true });
+      removed++;
+    }
+    if (removed) logger.info(`[CodingAgent:${agentId}] pruned ${removed} least-recently-used thread workspace(s), keeping ${keep}`);
+  } catch {
+  }
+}
 async function pruneRuns(agentDir, keep) {
   if (keep <= 0) return;
   try {
@@ -24718,6 +24741,9 @@ Fix ONLY that, and rewrite the same file at the same path. Do not re-run any que
       `[CodingAgent:${def.id}] ${runAsJob ? "run" : "chat"}=${runId} status=${record.status} ms=${record.ms} tokens=${record.usage.inputTokens}/${record.usage.outputTokens} tools=${record.usage.toolCalls}` + (record.applied ? ` applied="${record.applied.summary}"` : "") + (record.error ? ` error="${record.error}"` : "")
     );
     if (!options.workspaceDir && !persistentWorkspace) await pruneRuns(path9.join(scopeDir, "runs"), cfg.keepRuns);
+    if (!options.workspaceDir && dirName.startsWith(`threads${path9.sep}`)) {
+      await pruneThreads(def.id, path9.join(agentDir, "threads"), cfg.keepThreads);
+    }
   }
 }
 

package/dist/index.mjs

@@ -24258,7 +24258,8 @@ var config = {
   promptRoot: path8.join(process.cwd(), ".prompts", "coding-agents"),
   runtimeDir: path8.join(process.cwd(), ".coding-agent-runtime"),
   harness: "codex",
-  keepRuns: 20
+  keepRuns: 20,
+  keepThreads: 200
 };
 function registerCodingAgents(definitions, options = {}) {
   config = {
@@ -24267,7 +24268,8 @@ function registerCodingAgents(definitions, options = {}) {
     promptRoot: options.promptRoot || process.env.CODING_AGENT_PROMPT_DIR || config.promptRoot,
     runtimeDir: options.runtimeDir || process.env.CODING_AGENT_RUNTIME_DIR || config.runtimeDir,
     harness: options.harness || process.env.CODING_AGENT_HARNESS || config.harness,
-    keepRuns: options.keepRuns ?? config.keepRuns
+    keepRuns: options.keepRuns ?? config.keepRuns,
+    keepThreads: options.keepThreads ?? (process.env.CODING_AGENT_KEEP_THREADS !== void 0 && Number.isFinite(Number(process.env.CODING_AGENT_KEEP_THREADS)) ? Number(process.env.CODING_AGENT_KEEP_THREADS) : config.keepThreads)
   };
   for (const def of definitions) {
     if (!def.id) throw new Error("A coding agent definition must have an id.");
@@ -24381,6 +24383,27 @@ async function installInstructions(def, ws) {
   }
 }
 var REPAIR_TIMEOUT_MS = 3 * 6e4;
+async function pruneThreads(agentId, threadsDir, keep) {
+  if (keep <= 0) return;
+  try {
+    const dirs = (await fsp.readdir(threadsDir, { withFileTypes: true })).filter((e) => e.isDirectory());
+    if (dirs.length <= keep) return;
+    const aged = await Promise.all(dirs.map(async (e) => {
+      const dir = path9.join(threadsDir, e.name);
+      const stat2 = await fsp.stat(statePath(dir)).catch(() => fsp.stat(dir));
+      return { name: e.name, dir, used: stat2.mtimeMs };
+    }));
+    aged.sort((a, b) => b.used - a.used);
+    let removed = 0;
+    for (const t of aged.slice(keep)) {
+      if (inFlight.has(`${agentId}:thread:${t.name}`)) continue;
+      await fsp.rm(t.dir, { recursive: true, force: true });
+      removed++;
+    }
+    if (removed) logger.info(`[CodingAgent:${agentId}] pruned ${removed} least-recently-used thread workspace(s), keeping ${keep}`);
+  } catch {
+  }
+}
 async function pruneRuns(agentDir, keep) {
   if (keep <= 0) return;
   try {
@@ -24612,6 +24635,9 @@ Fix ONLY that, and rewrite the same file at the same path. Do not re-run any que
       `[CodingAgent:${def.id}] ${runAsJob ? "run" : "chat"}=${runId} status=${record.status} ms=${record.ms} tokens=${record.usage.inputTokens}/${record.usage.outputTokens} tools=${record.usage.toolCalls}` + (record.applied ? ` applied="${record.applied.summary}"` : "") + (record.error ? ` error="${record.error}"` : "")
     );
     if (!options.workspaceDir && !persistentWorkspace) await pruneRuns(path9.join(scopeDir, "runs"), cfg.keepRuns);
+    if (!options.workspaceDir && dirName.startsWith(`threads${path9.sep}`)) {
+      await pruneThreads(def.id, path9.join(agentDir, "threads"), cfg.keepThreads);
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superatomai/sdk-node",
-  "version": "0.0.60-dsp",
+  "version": "0.0.61-dsp",
   "description": "Node.js TypeScript SDK for Superatom",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",