@nyssance/codex-acp-v2 0.3.5 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.4.0 — 2026-09-10
+
+### Added
+
+- Skills and plugins extension surface: `_codex/skills_list`, `_codex/skills_config_write`,
+  `_codex/plugin_list`, `_codex/plugin_installed`, `_codex/plugin_install`,
+  `_codex/plugin_uninstall`, `_codex/plugin_read`, `_codex/marketplace_add`,
+  `_codex/marketplace_remove`, `_codex/marketplace_upgrade` pass the Codex v2 shapes
+  through verbatim; advertised as `capabilities._meta.codex.skills` / `.plugins`.
+- `_codex/skills_changed` notification: forwarded from Codex `skills/changed` and sent
+  after every catalog mutation made through the adapter.
+
 ## 0.3.5 — 2026-09-07
 
 ### Fixed

package/README.md

@@ -21,6 +21,12 @@ compatibility layer: everything is written against `@agentclientprotocol/sdk/exp
   hiding is the `_codex/session_archive` / `_codex/session_unarchive` extension pair
   (declared as `capabilities._meta.codex.archive`), and `session/list` pages the archive
   when called with `_meta: {codex: {archived: true}}`.
+- **Skills and plugins**: `_codex/skills_list`, `_codex/skills_config_write`,
+  `_codex/plugin_list` / `_codex/plugin_installed` / `_codex/plugin_install` /
+  `_codex/plugin_uninstall` / `_codex/plugin_read` and `_codex/marketplace_add` /
+  `_codex/marketplace_remove` / `_codex/marketplace_upgrade` pass Codex's own request
+  and response shapes through (declared as `capabilities._meta.codex.skills` / `.plugins`);
+  `_codex/skills_changed` tells the client to refetch either catalog.
 - **Asynchronous prompts**: `session/prompt` returns immediately; the turn is
   reported through `state_update` frames (`running`, `requires_action` while a
   permission or form is open, `idle` with `stopReason` and token `usage`).

package/dist/index.js

@@ -21721,7 +21721,7 @@ var package_default = {
   publishConfig: {
     access: "public"
   },
-  version: "0.3.5",
+  version: "0.4.0",
   description: "Native ACP v2 agent for the OpenAI Codex app-server",
   packageManager: "bun@1.4.0",
   engines: {
@@ -26283,6 +26283,7 @@ class CodexAgent {
         if (!this.changingSkillRoots)
           for (const runtime of this.sessions.values())
             this.refreshAvailableCommands(runtime);
+        this.notifySkillsChanged();
       }
       if (notification.method === "account/updated")
         this.refreshAccounts().catch((error40) => logger.error("refreshing account failed", error40));
@@ -26322,7 +26323,7 @@ class CodexAgent {
           additionalDirectories: {}
         },
         providers: {},
-        _meta: { codex: { archive: true, seedHistory: true } }
+        _meta: { codex: { archive: true, seedHistory: true, skills: true, plugins: true } }
       },
       authMethods: authMethods(this.capabilities, this.env)
     };
@@ -26841,6 +26842,61 @@ class CodexAgent {
     await this.withCodex(() => this.codex.threadUnarchive({ threadId: params.sessionId }));
     return {};
   }
+  async skillsList(params) {
+    this.requireInitialized("_codex/skills_list");
+    return await this.withCodex(() => this.codex.skillsList(params));
+  }
+  async skillsConfigWrite(params) {
+    this.requireInitialized("_codex/skills_config_write");
+    const response = await this.withCodex(() => this.codex.skillsConfigWrite(params));
+    this.notifySkillsChanged();
+    return response;
+  }
+  async pluginList(params) {
+    this.requireInitialized("_codex/plugin_list");
+    return await this.withCodex(() => this.codex.pluginList(params));
+  }
+  async pluginInstalled(params) {
+    this.requireInitialized("_codex/plugin_installed");
+    return await this.withCodex(() => this.codex.pluginInstalled(params));
+  }
+  async pluginInstall(params) {
+    this.requireInitialized("_codex/plugin_install");
+    const response = await this.withCodex(() => this.codex.pluginInstall(params));
+    this.notifySkillsChanged();
+    return response;
+  }
+  async pluginUninstall(params) {
+    this.requireInitialized("_codex/plugin_uninstall");
+    await this.withCodex(() => this.codex.pluginUninstall(params));
+    this.notifySkillsChanged();
+    return {};
+  }
+  async pluginRead(params) {
+    this.requireInitialized("_codex/plugin_read");
+    return await this.withCodex(() => this.codex.pluginRead(params));
+  }
+  async marketplaceAdd(params) {
+    this.requireInitialized("_codex/marketplace_add");
+    const response = await this.withCodex(() => this.codex.marketplaceAdd(params));
+    this.notifySkillsChanged();
+    return response;
+  }
+  async marketplaceRemove(params) {
+    this.requireInitialized("_codex/marketplace_remove");
+    await this.withCodex(() => this.codex.marketplaceRemove(params));
+    this.notifySkillsChanged();
+    return {};
+  }
+  async marketplaceUpgrade(params) {
+    this.requireInitialized("_codex/marketplace_upgrade");
+    const response = await this.withCodex(() => this.codex.marketplaceUpgrade(params));
+    this.notifySkillsChanged();
+    return response;
+  }
+  notifySkillsChanged() {
+    this.link.notify("_codex/skills_changed", {}).catch((error40) => logger.error("skills change notification failed", error40));
+  }
   async closeRuntime(sessionId) {
     const deadline = performance.now() + this.closeGraceMs;
     const runtime = this.sessions.get(sessionId);
@@ -26909,16 +26965,19 @@ class CodexAgent {
     return runtime;
   }
   async prompt(params) {
+    return await this.promptInternal(params);
+  }
+  async promptInternal(params, allowReentry = false) {
     this.assertRoutingAvailable();
-    if (this.sessionMutations.has(params.sessionId))
+    if (!allowReentry && this.sessionMutations.has(params.sessionId))
       throw RequestError.invalidRequest({ sessionId: params.sessionId }, "Session lifecycle or configuration work is in progress; retry when it finishes");
     const runtime = this.runtime(params.sessionId, "session/prompt");
     if (runtime.stale)
       throw RequestError.invalidRequest({ sessionId: params.sessionId, _meta: { codex: { routing: { stale: true } } } }, "Session routing is stale; resume the session or successfully change providers before prompting");
-    const { session } = runtime;
     if (!Array.isArray(params.prompt) || params.prompt.length === 0) {
       throw RequestError.invalidParams(undefined, "prompt must contain at least one content block");
     }
+    const { session } = runtime;
     const model = findModel(session.catalog, session.model.model);
     if (!modelSupportsImages(model) && params.prompt.some((block) => block.type === "image")) {
       throw RequestError.invalidParams({ model: session.model.model }, "The current model does not support image input");
@@ -26943,7 +27002,7 @@ class CodexAgent {
     } catch (error40) {
       if (this.completedTurns.get(turn) === turnId || runtime.session.activeTurn !== turn) {
         await turn.finished;
-        return await this.prompt(params);
+        return await this.promptInternal(params, true);
       }
       throw RequestError.invalidRequest({ sessionId: params.sessionId, turnId }, `Could not steer the running turn: ${errorMessage(error40)}`);
     }
@@ -27348,6 +27407,16 @@ function interruptedTurn(threadId) {
     turn: { id: "", items: [], itemsView: "notLoaded", status: "interrupted", error: null, startedAt: null, completedAt: null, durationMs: null }
   };
 }
+function objectParams() {
+  return (raw) => {
+    if (raw === undefined || raw === null)
+      return {};
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+      throw RequestError.invalidParams({ params: raw }, "expected a params object");
+    }
+    return raw;
+  };
+}
 function parseSessionIdParams(raw) {
   const sessionId = raw?.sessionId;
   if (typeof sessionId !== "string" || sessionId.length === 0) {
@@ -27405,7 +27474,7 @@ function createAgentApp(options) {
   };
   return agent({ name: options.info.name }).onConnect((connection) => {
     agent2 = new CodexAgent(connection.client, options);
-  }).onRequest(methods.agent.initialize, (ctx) => current().initialize(ctx.params)).onRequest(methods.agent.auth.login, (ctx) => current().login(ctx.params, ctx.requestId)).onRequest(methods.agent.auth.logout, (ctx) => current().logout(ctx.params)).onRequest(methods.agent.providers.list, (ctx) => current().listProviders(ctx.params)).onRequest(methods.agent.providers.set, (ctx) => current().setProvider(ctx.params)).onRequest(methods.agent.providers.disable, (ctx) => current().disableProvider(ctx.params)).onRequest(methods.agent.session.new, (ctx) => current().newSession(ctx.params, ctx.signal)).onRequest(methods.agent.session.resume, (ctx) => current().resumeSession(ctx.params, ctx.signal)).onRequest(methods.agent.session.fork, (ctx) => current().forkSession(ctx.params, ctx.signal)).onRequest(methods.agent.session.list, (ctx) => current().listSessions(ctx.params)).onRequest(methods.agent.session.close, (ctx) => current().closeSession(ctx.params)).onRequest(methods.agent.session.delete, (ctx) => current().deleteSession(ctx.params)).onRequest("_codex/session_archive", { parse: parseSessionIdParams }, (ctx) => current().archiveSession(ctx.params)).onRequest("_codex/session_unarchive", { parse: parseSessionIdParams }, (ctx) => current().unarchiveSession(ctx.params)).onRequest(methods.agent.session.setConfigOption, (ctx) => current().setSessionConfigOption(ctx.params)).onRequest(methods.agent.session.prompt, (ctx) => current().prompt(ctx.params)).onNotification(methods.agent.session.cancel, (ctx) => current().cancel(ctx.params));
+  }).onRequest(methods.agent.initialize, (ctx) => current().initialize(ctx.params)).onRequest(methods.agent.auth.login, (ctx) => current().login(ctx.params, ctx.requestId)).onRequest(methods.agent.auth.logout, (ctx) => current().logout(ctx.params)).onRequest(methods.agent.providers.list, (ctx) => current().listProviders(ctx.params)).onRequest(methods.agent.providers.set, (ctx) => current().setProvider(ctx.params)).onRequest(methods.agent.providers.disable, (ctx) => current().disableProvider(ctx.params)).onRequest(methods.agent.session.new, (ctx) => current().newSession(ctx.params, ctx.signal)).onRequest(methods.agent.session.resume, (ctx) => current().resumeSession(ctx.params, ctx.signal)).onRequest(methods.agent.session.fork, (ctx) => current().forkSession(ctx.params, ctx.signal)).onRequest(methods.agent.session.list, (ctx) => current().listSessions(ctx.params)).onRequest(methods.agent.session.close, (ctx) => current().closeSession(ctx.params)).onRequest(methods.agent.session.delete, (ctx) => current().deleteSession(ctx.params)).onRequest("_codex/session_archive", { parse: parseSessionIdParams }, (ctx) => current().archiveSession(ctx.params)).onRequest("_codex/session_unarchive", { parse: parseSessionIdParams }, (ctx) => current().unarchiveSession(ctx.params)).onRequest("_codex/skills_list", { parse: objectParams() }, (ctx) => current().skillsList(ctx.params)).onRequest("_codex/skills_config_write", { parse: objectParams() }, (ctx) => current().skillsConfigWrite(ctx.params)).onRequest("_codex/plugin_list", { parse: objectParams() }, (ctx) => current().pluginList(ctx.params)).onRequest("_codex/plugin_installed", { parse: objectParams() }, (ctx) => current().pluginInstalled(ctx.params)).onRequest("_codex/plugin_install", { parse: objectParams() }, (ctx) => current().pluginInstall(ctx.params)).onRequest("_codex/plugin_uninstall", { parse: objectParams() }, (ctx) => current().pluginUninstall(ctx.params)).onRequest("_codex/plugin_read", { parse: objectParams() }, (ctx) => current().pluginRead(ctx.params)).onRequest("_codex/marketplace_add", { parse: objectParams() }, (ctx) => current().marketplaceAdd(ctx.params)).onRequest("_codex/marketplace_remove", { parse: objectParams() }, (ctx) => current().marketplaceRemove(ctx.params)).onRequest("_codex/marketplace_upgrade", { parse: objectParams() }, (ctx) => current().marketplaceUpgrade(ctx.params)).onRequest(methods.agent.session.setConfigOption, (ctx) => current().setSessionConfigOption(ctx.params)).onRequest(methods.agent.session.prompt, (ctx) => current().prompt(ctx.params)).onNotification(methods.agent.session.cancel, (ctx) => current().cancel(ctx.params));
 }
 
 // src/codex/AppServerClient.ts
@@ -27788,6 +27857,33 @@ class AppServerClient {
   skillsExtraRootsSet(params) {
     return this.send({ method: "skills/extraRoots/set", params });
   }
+  skillsConfigWrite(params) {
+    return this.send({ method: "skills/config/write", params });
+  }
+  pluginList(params) {
+    return this.send({ method: "plugin/list", params });
+  }
+  pluginInstalled(params) {
+    return this.send({ method: "plugin/installed", params });
+  }
+  pluginInstall(params) {
+    return this.send({ method: "plugin/install", params });
+  }
+  pluginUninstall(params) {
+    return this.send({ method: "plugin/uninstall", params });
+  }
+  pluginRead(params) {
+    return this.send({ method: "plugin/read", params });
+  }
+  marketplaceAdd(params) {
+    return this.send({ method: "marketplace/add", params });
+  }
+  marketplaceRemove(params) {
+    return this.send({ method: "marketplace/remove", params });
+  }
+  marketplaceUpgrade(params) {
+    return this.send({ method: "marketplace/upgrade", params });
+  }
   accountRead(params) {
     return this.send({ method: "account/read", params });
   }

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "Native ACP v2 agent for the OpenAI Codex app-server",
   "packageManager": "bun@1.4.0",
   "engines": {