@alas-ide/codex-acp 2.2.2-alas.1 → 2.2.2-alas.2

package/README.md

@@ -21,6 +21,7 @@ Use [OpenAI Codex](https://github.com/openai/codex) from [Agent Client Protocol]
 - Typed warnings and errors through the opt-in [AIR session failure extension](docs/air-extensions.md#session-failure).
 - All AIR extensions, capabilities, and `_meta` keys: [AIR extensions](docs/air-extensions.md).
 - A per-turn [agent file-change report](docs/air-extensions.md#agent-file-change-report) after capability negotiation.
+- Client-provided, session-scoped [system prompt append](docs/system-prompt-extension.md), preserving configured developer instructions.
 - Client-provided MCP servers over command-based stdio config and HTTP transport.
 - Slash commands: `/status`, `/mcp` (with `/mcp reconnect`), `/skills`, `/goal`, `/review`, `/review-branch`, `/review-commit`, `/compact`, and `/logout`, as well as configured skills.
 

package/dist/index.js

@@ -27893,6 +27893,20 @@ function attachLogs(proc) {
   });
 }
 
+// src/SessionInstructions.ts
+var SYSTEM_PROMPT_CAPABILITY = { version: 1, append: true, clear: true, maxBytes: 256 * 1024 };
+function readSessionInstructionAppend(meta3) {
+  const prompt = meta3?.["systemPrompt"];
+  if (prompt === void 0) return void 0;
+  if (prompt === null || typeof prompt !== "object" || Array.isArray(prompt) || Object.keys(prompt).some((key) => key !== "append") || !("append" in prompt) || typeof prompt.append !== "string") {
+    throw RequestError.invalidParams(void 0, "systemPrompt must contain only an append string");
+  }
+  if (Buffer.byteLength(prompt.append, "utf8") > SYSTEM_PROMPT_CAPABILITY.maxBytes) {
+    throw RequestError.invalidParams(void 0, `systemPrompt.append exceeds ${SYSTEM_PROMPT_CAPABILITY.maxBytes} UTF-8 bytes`);
+  }
+  return prompt.append;
+}
+
 // src/AcpSessionExtensions.ts
 function asSdkSessionNotification(notification) {
   return notification;
@@ -34378,7 +34392,7 @@ var package_default = {
   publishConfig: {
     access: "public"
   },
-  version: "2.2.2-alas.1",
+  version: "2.2.2-alas.2",
   description: "",
   main: "dist/index.js",
   bin: {
@@ -34455,7 +34469,7 @@ var package_default = {
   alasDownstream: {
     upstreamVersion: "2.2.2",
     upstreamCommit: "202e66e63343ec4f5a5e35ab590251d813d129ca",
-    sourceCommit: "066895c1361ae7a82d1e0216a87b32f9be657b2c"
+    sourceCommit: "f431e5cac0d2972bcb8295f8967d6f27f6633eea"
   }
 };
 
@@ -34659,6 +34673,8 @@ var CodexSubagentSubscriptions = class {
 // src/SessionFork.ts
 import { createHash } from "node:crypto";
 async function forkSession(request, additionalDirectories, dependencies) {
+  const append = readSessionInstructionAppend(request._meta);
+  const instructionOverride = await dependencies.sessionInstructionOverride(append, request.cwd);
   await dependencies.refreshSkills(request.cwd, additionalDirectories);
   const lastTurnId = await resolveForkTurnId(request, dependencies.codexClient);
   const sessionConfig = await dependencies.createSessionConfig(
@@ -34667,6 +34683,7 @@ async function forkSession(request, additionalDirectories, dependencies) {
     request.mcpServers ?? []
   );
   const response = await dependencies.codexClient.threadFork({
+    ...instructionOverride,
     excludeTurns: true,
     config: sessionConfig.config,
     cwd: request.cwd,
@@ -34767,6 +34784,13 @@ var CodexAcpClient = class _CodexAcpClient {
   pendingLoginCompleted = null;
   pendingAccountUpdated = null;
   sessionNotificationQueues = /* @__PURE__ */ new Map();
+  /**
+   * The `systemPrompt.append` each thread was opened with in this process. A
+   * client that reconnects to a live adapter sends `session/load` or
+   * `session/resume` again with the same text; Codex already holds those
+   * instructions, so a matching repeat is accepted without an override.
+   */
+  appliedInstructionAppends = /* @__PURE__ */ new Map();
   subagents;
   skillExtraRoots = [];
   configPath = null;
@@ -35232,16 +35256,20 @@ var CodexAcpClient = class _CodexAcpClient {
     }
   }
   async resumeSession(request, onSubscribed) {
+    const append = readSessionInstructionAppend(request._meta);
+    const instructionOverride = await this.sessionInstructionOverride(append, request.cwd, request.sessionId);
     const additionalDirectories = readAdditionalDirectories(request.cwd, request.additionalDirectories, request._meta);
     await this.refreshSkills(request.cwd, additionalDirectories);
     const sessionConfig = await this.createSessionConfig(request.cwd, additionalDirectories, request.mcpServers ?? []);
     const response = await this.resumeThread({
       excludeTurns: true,
+      ...instructionOverride,
       config: sessionConfig.config,
       cwd: request.cwd,
       modelProvider: await this.getResumeModelProvider(),
       threadId: request.sessionId
     });
+    this.recordInstructionAppend(request.sessionId, append);
     onSubscribed?.();
     const codexModels = await this.fetchAvailableModels();
     const currentModelId = this.createModelId(codexModels, response.model, response.reasoningEffort).toString();
@@ -35259,8 +35287,9 @@ var CodexAcpClient = class _CodexAcpClient {
   }
   async forkSession(request, releaseFailedFork = (threadId) => this.closeSession(threadId)) {
     const additionalDirectories = readAdditionalDirectories(request.cwd, request.additionalDirectories, request._meta);
-    return await forkSession(request, additionalDirectories, {
+    const metadata = await forkSession(request, additionalDirectories, {
       codexClient: this.codexClient,
+      sessionInstructionOverride: (append, cwd) => this.sessionInstructionOverride(append, cwd),
       refreshSkills: (cwd, directories) => this.refreshSkills(cwd, directories),
       createSessionConfig: (cwd, directories, mcpServers) => this.createSessionConfig(cwd, directories, mcpServers),
       getResumeModelProvider: () => this.getResumeModelProvider(),
@@ -35269,18 +35298,24 @@ var CodexAcpClient = class _CodexAcpClient {
       getCollaborationMode: (sessionId) => this.getCollaborationMode(sessionId),
       releaseFailedFork
     });
+    this.recordInstructionAppend(metadata.sessionId, readSessionInstructionAppend(request._meta));
+    return metadata;
   }
   async loadSession(request, onSubscribed) {
+    const append = readSessionInstructionAppend(request._meta);
+    const instructionOverride = await this.sessionInstructionOverride(append, request.cwd, request.sessionId);
     const additionalDirectories = readAdditionalDirectories(request.cwd, request.additionalDirectories, request._meta);
     await this.refreshSkills(request.cwd, additionalDirectories);
     const sessionConfig = await this.createSessionConfig(request.cwd, additionalDirectories, request.mcpServers ?? []);
     const response = await this.resumeThread({
       excludeTurns: true,
+      ...instructionOverride,
       config: sessionConfig.config,
       cwd: request.cwd,
       modelProvider: await this.getResumeModelProvider(),
       threadId: request.sessionId
     });
+    this.recordInstructionAppend(request.sessionId, append);
     onSubscribed?.();
     let thread = { ...response.thread, turns: [] };
     let history = noItems();
@@ -35335,16 +35370,24 @@ var CodexAcpClient = class _CodexAcpClient {
     return null;
   }
   async newSession(request) {
+    const append = readSessionInstructionAppend(request._meta);
+    const custom2 = airCustomInstructions(request._meta);
+    if (append !== void 0 && custom2 !== void 0) {
+      throw RequestError.invalidParams(void 0, "systemPrompt.append and AIR customInstructions cannot be combined");
+    }
+    const instructionOverride = await this.sessionInstructionOverride(append, request.cwd);
     const additionalDirectories = readAdditionalDirectories(request.cwd, request.additionalDirectories, request._meta);
     const developerInstructions = airCustomInstructions(request._meta);
     await this.refreshSkills(request.cwd, additionalDirectories);
     const sessionConfig = await this.createSessionConfig(request.cwd, additionalDirectories, request.mcpServers);
     const response = await this.codexClient.threadStart({
+      ...instructionOverride,
       config: sessionConfig.config,
       modelProvider: this.getModelProvider(),
       cwd: request.cwd,
       ...developerInstructions !== void 0 && { developerInstructions }
     });
+    this.recordInstructionAppend(response.thread.id, append);
     const codexModels = await this.fetchAvailableModels();
     if (codexModels.length === 0) {
       throw new Error("Codex did not return any models");
@@ -35441,6 +35484,32 @@ var CodexAcpClient = class _CodexAcpClient {
   getMcpServerStartupVersion() {
     return this.codexClient.mcpStartup.version();
   }
+  recordInstructionAppend(sessionId, append) {
+    if (append === void 0) return;
+    this.appliedInstructionAppends.set(sessionId, append);
+  }
+  async sessionInstructionOverride(append, cwd, sessionId) {
+    if (append === void 0) return {};
+    if (sessionId !== void 0) {
+      let cursor;
+      do {
+        const page = await this.codexClient.threadLoadedList({ ...cursor !== void 0 && { cursor } });
+        if (page.data.includes(sessionId)) {
+          if (this.appliedInstructionAppends.get(sessionId) === append) return {};
+          throw RequestError.invalidParams(void 0, "Cannot append instructions to a loaded thread; close it before loading or resuming with instructions");
+        }
+        cursor = page.nextCursor ?? void 0;
+      } while (cursor !== void 0);
+    }
+    const effective = await this.codexClient.configRead({ cwd, includeLayers: false });
+    const configured = this.config["developer_instructions"] !== void 0 ? this.config["developer_instructions"] : effective.config.developer_instructions;
+    if (configured != null && typeof configured !== "string") {
+      throw RequestError.invalidParams(void 0, "Configured developer_instructions must be a string");
+    }
+    return { developerInstructions: configured ? append ? `${configured}
+
+${append}` : configured : append };
+  }
   async createSessionConfig(projectPath, additionalDirectories, mcpServers) {
     const sessionRoots = [projectPath, ...additionalDirectories];
     const activeProvider = this.gatewayConfig ? {
@@ -39236,7 +39305,7 @@ var JsonText = class {
   }
   text;
 };
-var MAX_DEPTH = 256;
+var MAX_DEPTH = 64;
 var apply = Reflect.apply;
 var getPrototypeOf = Object.getPrototypeOf;
 var isRawJson = JSON.isRawJSON ?? (() => false);
@@ -42504,6 +42573,7 @@ var CodexAcpServer = class {
       },
       authMethods: getCodexAuthMethods(_params.clientCapabilities),
       _meta: {
+        systemPrompt: SYSTEM_PROMPT_CAPABILITY,
         steering: {
           supported: true
         },
@@ -43087,6 +43157,7 @@ Check ${configPath} and project .codex directories, especially their config.toml
     return null;
   }
   async loadSession(params) {
+    readSessionInstructionAppend(params._meta);
     return this.recovery === null ? await this.loadSessionOnce(params) : await this.recovery.trackOpen(params.sessionId, () => this.loadSessionOnce(params));
   }
   async loadSessionOnce(params) {
@@ -43129,6 +43200,7 @@ Check ${configPath} and project .codex directories, especially their config.toml
     };
   }
   async resumeSession(params) {
+    readSessionInstructionAppend(params._meta);
     return this.recovery === null ? await this.resumeSessionOnce(params) : await this.recovery.trackOpen(params.sessionId, () => this.resumeSessionOnce(params));
   }
   async resumeSessionOnce(params) {
@@ -43151,6 +43223,7 @@ Check ${configPath} and project .codex directories, especially their config.toml
     };
   }
   async forkSession(params) {
+    readSessionInstructionAppend(params._meta);
     if (this.providerUpdate !== null) {
       await this.waitForProviderUpdate();
     }
@@ -43262,6 +43335,7 @@ Check ${configPath} and project .codex directories, especially their config.toml
     return this.sessionOpenGenerations.get(sessionId) === this.getSessionGeneration(sessionId);
   }
   async newSession(params) {
+    readSessionInstructionAppend(params._meta);
     if (this.providerUpdate !== null) {
       await this.waitForProviderUpdate();
     }

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.2.2-alas.1",
+  "version": "2.2.2-alas.2",
   "description": "",
   "main": "dist/index.js",
   "bin": {
@@ -80,6 +80,6 @@
   "alasDownstream": {
     "upstreamVersion": "2.2.2",
     "upstreamCommit": "202e66e63343ec4f5a5e35ab590251d813d129ca",
-    "sourceCommit": "066895c1361ae7a82d1e0216a87b32f9be657b2c"
+    "sourceCommit": "f431e5cac0d2972bcb8295f8967d6f27f6633eea"
   }
 }