@superatomai/sdk-node 0.0.66-dsp → 0.0.67-dsp

package/dist/index.d.mts

@@ -5113,6 +5113,11 @@ interface CodingAgentSessionOptions {
     env?: Record<string, string>;
     /** Opt out of env scrubbing. Only for local debugging. */
     inheritEnv?: boolean;
+    /**
+     * Workspace file holding the standing instructions. The driver must make its
+     * harness read it: codex only finds AGENTS.md by itself.
+     */
+    instructionsFile?: string;
 }
 interface CodingAgentSession {
     readonly harness: string;
@@ -5409,10 +5414,9 @@ interface CodingAgentDefinition<TInput = unknown, TOutput = unknown> {
     mode: 'task' | 'chat';
     /**
      * Directory holding this agent's system.md. Defaults to
-     * `<promptRoot>/<id>`. The runner copies system.md into the workspace as
-     * AGENTS.md, which is the filename the harness actually reads from its
-     * working directory — that indirection is what lets the instructions stay
-     * version-controlled while the workspace stays disposable.
+     * `<promptRoot>/<id>`. The runner copies it into the workspace under the
+     * same name, which is what the harness reads from its working directory —
+     * the source stays version-controlled, the workspace stays disposable.
      */
     promptDir?: string;
     /** Override the deployment default for this agent alone. */
@@ -5591,6 +5595,15 @@ declare function listCodingAgents(): Array<{
 }>;
 declare function getCodingAgentsConfig(): Required<Pick<CodingAgentsConfig, "harness" | "promptRoot" | "runtimeDir" | "keepRuns" | "keepThreads">> & CodingAgentsConfig;
 
+/**
+ * The workspace file the harness reads as its standing instructions.
+ *
+ * Codex discovers its project doc BY NAME and only knows AGENTS.md, so every
+ * session is given this as `instructionsFile` and the driver registers it.
+ * Keeping the workspace copy called system.md, like the version-controlled
+ * source, removes the one-name-two-meanings indirection.
+ */
+declare const INSTRUCTIONS_FILE = "system.md";
 interface RunAgentOptions<TInput> extends AgentRunContext {
     input?: TInput;
     /** Scopes a 'thread' agent. Ignored by a project-scoped one. */
@@ -6140,4 +6153,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type Harness, type HybridSearchOptions, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type Principal, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, openaiLLM, policiesFromConfig, projectForDatasetBinding, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims };
+export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type Principal, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, openaiLLM, policiesFromConfig, projectForDatasetBinding, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims };

package/dist/index.d.ts

@@ -5113,6 +5113,11 @@ interface CodingAgentSessionOptions {
     env?: Record<string, string>;
     /** Opt out of env scrubbing. Only for local debugging. */
     inheritEnv?: boolean;
+    /**
+     * Workspace file holding the standing instructions. The driver must make its
+     * harness read it: codex only finds AGENTS.md by itself.
+     */
+    instructionsFile?: string;
 }
 interface CodingAgentSession {
     readonly harness: string;
@@ -5409,10 +5414,9 @@ interface CodingAgentDefinition<TInput = unknown, TOutput = unknown> {
     mode: 'task' | 'chat';
     /**
      * Directory holding this agent's system.md. Defaults to
-     * `<promptRoot>/<id>`. The runner copies system.md into the workspace as
-     * AGENTS.md, which is the filename the harness actually reads from its
-     * working directory — that indirection is what lets the instructions stay
-     * version-controlled while the workspace stays disposable.
+     * `<promptRoot>/<id>`. The runner copies it into the workspace under the
+     * same name, which is what the harness reads from its working directory —
+     * the source stays version-controlled, the workspace stays disposable.
      */
     promptDir?: string;
     /** Override the deployment default for this agent alone. */
@@ -5591,6 +5595,15 @@ declare function listCodingAgents(): Array<{
 }>;
 declare function getCodingAgentsConfig(): Required<Pick<CodingAgentsConfig, "harness" | "promptRoot" | "runtimeDir" | "keepRuns" | "keepThreads">> & CodingAgentsConfig;
 
+/**
+ * The workspace file the harness reads as its standing instructions.
+ *
+ * Codex discovers its project doc BY NAME and only knows AGENTS.md, so every
+ * session is given this as `instructionsFile` and the driver registers it.
+ * Keeping the workspace copy called system.md, like the version-controlled
+ * source, removes the one-name-two-meanings indirection.
+ */
+declare const INSTRUCTIONS_FILE = "system.md";
 interface RunAgentOptions<TInput> extends AgentRunContext {
     input?: TInput;
     /** Scopes a 'thread' agent. Ignored by a project-scoped one. */
@@ -6140,4 +6153,4 @@ declare class SuperatomSDK {
     getConversationSimilarityThreshold(): number;
 }
 
-export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type Harness, type HybridSearchOptions, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type Principal, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, openaiLLM, policiesFromConfig, projectForDatasetBinding, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims };
+export { ALL_COLUMN_KEYS, ANSWER_COMPONENT_NAMES, type AgentConfig, type AgentEvent, type AgentResponse, type AgentRunContext, type AgentRunHandlers, type AgentRunRecord, type AgentRunResult, type AgentTrigger, type AgentUsage, type AnswerProvider, type AnswerProviderContext, type ApplySummary, BM25L, type BM25LOptions, type BaseLLMConfig, type BuildTriggerInput, CATEGORY_KEYS, CONTEXT_CONFIG, type CapturedLog, CleanupService, type CodexSessionOptions, type CodingAgentCollectionConfig, type CodingAgentDefinition, type CodingAgentSession, type CodingAgentSessionOptions, type CodingAgentsConfig, type ColInfo, type ColType, type CollectionHandler, type CollectionOperation, type Component, type DBUIBlock, DEFAULT_AGENT_CONFIG, DEFAULT_FMT_CONFIG, type DashboardAgentCollectionConfig, type DatabaseType, type FindingCode, type Fmt, type FmtConfig, type Harness, type HybridSearchOptions, INSTRUCTIONS_FILE, type IncomingMessage, type KbNodesQueryFilters, type KbNodesRequestPayload, LLM, type LLMUsageEntry, type LogLevel, MainAgent, type McpServerSpec, type Message, MissingRequestContextError, type ModelStrategy, NUMERIC_KEYS, type NarrationUpdate, type OutputContract, type OutputField, type OutputValidator, type Principal, type RequestContext, type RerankedResult, type RowFilter, type RunAgentOptions, STORAGE_CONFIG, type ScriptComponentSpec, ScriptMatcher, type ScriptParameter, type ScriptRecipe, type ScriptRecipeMetaRow, type ScriptRecipeStore, type ScriptResult, ScriptStore, type ScriptStoreOptions, type SelectedWorkflow, type SourcePolicy, type SpecToValidate, SuperatomSDK, type SuperatomSDKConfig, type T_RESPONSE, type TaskType, Thread, ThreadManager, type Tool$1 as Tool, type ToolOutputSchema, type TriggerEvent, type TriggerFireInfo, UIBlock, UILogCollector, type User, UserManager, type UsersData, type ValidationContext, type ValidationFinding, type WorkflowDescriptor, type Workspace, answerCatalogForBinding, answerComponents, anthropicLLM, assertReadOnlySql, bindContext, captureContext, clearContextTokens, contextTokenCount, createCodexSession, createCodingAgentSession, dashboardConversationHistory, dataFingerprint, describeContext, describeTriggers, emitAgentEvent, extractNamedExport, formatFindingsForAgent, geminiLLM, getCodingAgent, getCodingAgentsConfig, getRequestContext, groqLLM, hybridRerank, inferColumns, isUserContext, listCodingAgents, llmUsageLogger, logger, makeFmt, mintContextToken, normalizeScriptBody, onAgentRun, openaiLLM, policiesFromConfig, projectForDatasetBinding, queryCache, registerCodingAgentCollection, registerCodingAgents, registerDashboardAgentCollection, requireRequestContext, rerankChromaResults, rerankConversationResults, resolveContextToken, resolveScriptRecipeStore, revokeContextToken, runAsSystem, runAsUser, runCodingAgent, runScript, runWithContext, runWithMessageIdentity, startAgentTriggers, stopAgentTriggers, userPromptErrorLogger, validateComponentSpec, withCapturedContext, writeBridgeShims };

package/dist/index.js

@@ -38,6 +38,7 @@ __export(index_exports, {
   CleanupService: () => CleanupService,
   DEFAULT_AGENT_CONFIG: () => DEFAULT_AGENT_CONFIG,
   DEFAULT_FMT_CONFIG: () => DEFAULT_FMT_CONFIG,
+  INSTRUCTIONS_FILE: () => INSTRUCTIONS_FILE,
   LLM: () => LLM,
   MainAgent: () => MainAgent,
   MissingRequestContextError: () => MissingRequestContextError,
@@ -24245,17 +24246,21 @@ function createCodexSession(opts) {
   async function ensureThread() {
     if (thread) return thread;
     const { Codex } = await loadCodex();
+    const config2 = {
+      // Tools reach codex as MCP servers; each server's name shows up on
+      // every tool event, so the runner can tell ours from codex's own.
+      ...opts.mcpServers && Object.keys(opts.mcpServers).length ? { mcp_servers: opts.mcpServers } : {},
+      // Per run, not ~/.codex/config.toml: a host without that line would run
+      // the agent with no instructions at all. AGENTS.md still wins if present.
+      ...opts.instructionsFile && opts.instructionsFile !== "AGENTS.md" ? { project_doc_fallback_filenames: [opts.instructionsFile] } : {},
+      ...opts.extraConfig ?? {}
+    };
     const codex = new Codex({
       ...opts.apiKey ? { apiKey: opts.apiKey } : {},
       ...opts.baseUrl ? { baseUrl: opts.baseUrl } : {},
       env: buildEnv(opts),
-      // Tools reach codex as MCP servers; each server's name shows up on
-      // every tool event, so the runner can tell ours from codex's own.
-      // Only send a config override when there is something in it. An empty
-      // object is truthy, so the naive check sent config:{mcp_servers:{}} on
-      // every run — a pointless CLI override on a path that is otherwise
-      // completely default.
-      ...opts.mcpServers && Object.keys(opts.mcpServers).length || opts.extraConfig ? { config: { ...opts.mcpServers && Object.keys(opts.mcpServers).length ? { mcp_servers: opts.mcpServers } : {}, ...opts.extraConfig ?? {} } } : {}
+      // Only when non-empty: an empty override is pointless CLI noise.
+      ...Object.keys(config2).length ? { config: config2 } : {}
     });
     thread = resumeId ? codex.resumeThread(resumeId, threadOptions()) : codex.startThread(threadOptions());
     return thread;
@@ -24547,10 +24552,11 @@ function createWorkspace(dir, runId) {
     }
   };
 }
+var INSTRUCTIONS_FILE = "system.md";
 async function installInstructions(def, ws) {
   const src = path9.join(resolvePromptDir(def), "system.md");
   try {
-    await ws.write("AGENTS.md", await fsp.readFile(src, "utf-8"));
+    await ws.write(INSTRUCTIONS_FILE, await fsp.readFile(src, "utf-8"));
   } catch {
     logger.warn(`[CodingAgent:${def.id}] no system.md at ${src} \u2014 running without standing instructions`);
   }
@@ -24669,13 +24675,14 @@ async function runCodingAgent(agentId, options = {}) {
     if (outputPath) await fsp.rm(outputPath, { force: true });
     const prompt = options.prompt ?? // buildPrompt may read what prepare() wrote, so it is only asked when
     // prepare() actually ran.
-    (runAsJob && def.buildPrompt ? await def.buildPrompt(ws, input, ctx) : outputPath ? `Carry out the task described in AGENTS.md. Write your finished result to this exact absolute path: ${outputPath}` : "Carry out the task described in AGENTS.md.");
+    (runAsJob && def.buildPrompt ? await def.buildPrompt(ws, input, ctx) : outputPath ? `Carry out the task described in ${INSTRUCTIONS_FILE}. Write your finished result to this exact absolute path: ${outputPath}` : `Carry out the task described in ${INSTRUCTIONS_FILE}.`);
     const tools = { ...cfg.sharedTools ?? {}, ...def.tools ?? {} };
     const sessionEnv = def.env ? await def.env(input, ctx) : void 0;
     const session = createCodingAgentSession(def.harness || cfg.harness, {
       cwd: dir,
       model: def.model || cfg.model,
       resumeId,
+      instructionsFile: INSTRUCTIONS_FILE,
       // undefined, not {}, when this agent has no tools — see the driver.
       mcpServers: tools && Object.keys(tools).length ? tools : void 0,
       ...sessionEnv ? { env: sessionEnv } : {},
@@ -24761,6 +24768,7 @@ async function runCodingAgent(agentId, options = {}) {
           cwd: dir,
           model: def.model || cfg.model,
           resumeId: result.sessionId,
+          instructionsFile: INSTRUCTIONS_FILE,
           mcpServers: tools && Object.keys(tools).length ? tools : void 0,
           ...sessionEnv ? { env: sessionEnv } : {},
           ...def.networkAccessEnabled !== void 0 ? { networkAccessEnabled: def.networkAccessEnabled } : {},
@@ -28902,6 +28910,7 @@ var SuperatomSDK = class {
   CleanupService,
   DEFAULT_AGENT_CONFIG,
   DEFAULT_FMT_CONFIG,
+  INSTRUCTIONS_FILE,
   LLM,
   MainAgent,
   MissingRequestContextError,

package/dist/index.mjs

@@ -24139,17 +24139,21 @@ function createCodexSession(opts) {
   async function ensureThread() {
     if (thread) return thread;
     const { Codex } = await loadCodex();
+    const config2 = {
+      // Tools reach codex as MCP servers; each server's name shows up on
+      // every tool event, so the runner can tell ours from codex's own.
+      ...opts.mcpServers && Object.keys(opts.mcpServers).length ? { mcp_servers: opts.mcpServers } : {},
+      // Per run, not ~/.codex/config.toml: a host without that line would run
+      // the agent with no instructions at all. AGENTS.md still wins if present.
+      ...opts.instructionsFile && opts.instructionsFile !== "AGENTS.md" ? { project_doc_fallback_filenames: [opts.instructionsFile] } : {},
+      ...opts.extraConfig ?? {}
+    };
     const codex = new Codex({
       ...opts.apiKey ? { apiKey: opts.apiKey } : {},
       ...opts.baseUrl ? { baseUrl: opts.baseUrl } : {},
       env: buildEnv(opts),
-      // Tools reach codex as MCP servers; each server's name shows up on
-      // every tool event, so the runner can tell ours from codex's own.
-      // Only send a config override when there is something in it. An empty
-      // object is truthy, so the naive check sent config:{mcp_servers:{}} on
-      // every run — a pointless CLI override on a path that is otherwise
-      // completely default.
-      ...opts.mcpServers && Object.keys(opts.mcpServers).length || opts.extraConfig ? { config: { ...opts.mcpServers && Object.keys(opts.mcpServers).length ? { mcp_servers: opts.mcpServers } : {}, ...opts.extraConfig ?? {} } } : {}
+      // Only when non-empty: an empty override is pointless CLI noise.
+      ...Object.keys(config2).length ? { config: config2 } : {}
     });
     thread = resumeId ? codex.resumeThread(resumeId, threadOptions()) : codex.startThread(threadOptions());
     return thread;
@@ -24441,10 +24445,11 @@ function createWorkspace(dir, runId) {
     }
   };
 }
+var INSTRUCTIONS_FILE = "system.md";
 async function installInstructions(def, ws) {
   const src = path9.join(resolvePromptDir(def), "system.md");
   try {
-    await ws.write("AGENTS.md", await fsp.readFile(src, "utf-8"));
+    await ws.write(INSTRUCTIONS_FILE, await fsp.readFile(src, "utf-8"));
   } catch {
     logger.warn(`[CodingAgent:${def.id}] no system.md at ${src} \u2014 running without standing instructions`);
   }
@@ -24563,13 +24568,14 @@ async function runCodingAgent(agentId, options = {}) {
     if (outputPath) await fsp.rm(outputPath, { force: true });
     const prompt = options.prompt ?? // buildPrompt may read what prepare() wrote, so it is only asked when
     // prepare() actually ran.
-    (runAsJob && def.buildPrompt ? await def.buildPrompt(ws, input, ctx) : outputPath ? `Carry out the task described in AGENTS.md. Write your finished result to this exact absolute path: ${outputPath}` : "Carry out the task described in AGENTS.md.");
+    (runAsJob && def.buildPrompt ? await def.buildPrompt(ws, input, ctx) : outputPath ? `Carry out the task described in ${INSTRUCTIONS_FILE}. Write your finished result to this exact absolute path: ${outputPath}` : `Carry out the task described in ${INSTRUCTIONS_FILE}.`);
     const tools = { ...cfg.sharedTools ?? {}, ...def.tools ?? {} };
     const sessionEnv = def.env ? await def.env(input, ctx) : void 0;
     const session = createCodingAgentSession(def.harness || cfg.harness, {
       cwd: dir,
       model: def.model || cfg.model,
       resumeId,
+      instructionsFile: INSTRUCTIONS_FILE,
       // undefined, not {}, when this agent has no tools — see the driver.
       mcpServers: tools && Object.keys(tools).length ? tools : void 0,
       ...sessionEnv ? { env: sessionEnv } : {},
@@ -24655,6 +24661,7 @@ async function runCodingAgent(agentId, options = {}) {
           cwd: dir,
           model: def.model || cfg.model,
           resumeId: result.sessionId,
+          instructionsFile: INSTRUCTIONS_FILE,
           mcpServers: tools && Object.keys(tools).length ? tools : void 0,
           ...sessionEnv ? { env: sessionEnv } : {},
           ...def.networkAccessEnabled !== void 0 ? { networkAccessEnabled: def.networkAccessEnabled } : {},
@@ -28795,6 +28802,7 @@ export {
   CleanupService,
   DEFAULT_AGENT_CONFIG,
   DEFAULT_FMT_CONFIG,
+  INSTRUCTIONS_FILE,
   LLM,
   MainAgent,
   MissingRequestContextError,

package/package.json

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