@zetaloop/chappie 1.0.0 → 1.1.0

package/dist/{codex-plugin-NSKWB3WS.js → codex-plugin-BFH2DWSA.js}

@@ -1,21 +1,21 @@
 import { createRequire } from "node:module"; const require = createRequire(import.meta.url);
 import {
   definitions
-} from "./chunk-DM523QRR.js";
+} from "./chunk-3MLW5U2C.js";
 import {
   McpServer,
   ResourceTemplate,
   serveStdio
-} from "./chunk-K2VE2MDU.js";
-import "./chunk-GX4JWLHH.js";
+} from "./chunk-QNDFCQ66.js";
+import "./chunk-RQKWETGT.js";
 import {
   package_default
-} from "./chunk-DN7OHZK6.js";
+} from "./chunk-DDBZIUBF.js";
 import {
   getDirectory,
   readConfig,
   resourceDescriptors
-} from "./chunk-GWYP7B66.js";
+} from "./chunk-ASDHNBR2.js";
 import {
   __callDispose,
   __using
@@ -23,13 +23,37 @@ import {
 
 // src/codex-plugin.ts
 import { fork } from "node:child_process";
-import { mkdir, open } from "node:fs/promises";
+import {
+  copyFile,
+  mkdir,
+  mkdtempDisposable,
+  open,
+  rename
+} from "node:fs/promises";
 import { get } from "node:http";
 import { join } from "node:path";
-async function startProvider() {
+async function setupCodex() {
   var _stack = [];
   try {
     await mkdir(getDirectory(), { recursive: true });
+    const temporary = __using(_stack, await mkdtempDisposable(
+      join(getDirectory(), ".chappie-")
+    ), true);
+    const staged = join(temporary.path, "codex.json");
+    await copyFile(new URL("./codex.json", import.meta.url), staged);
+    const path = join(getDirectory(), "codex.json");
+    await rename(staged, path);
+    return path;
+  } catch (_) {
+    var _error = _, _hasError = true;
+  } finally {
+    var _promise = __callDispose(_stack, _error, _hasError);
+    _promise && await _promise;
+  }
+}
+async function startProvider() {
+  var _stack = [];
+  try {
     const log = __using(_stack, await open(join(getDirectory(), "codex.log"), "a"), true);
     const child = fork(
       new URL("./cli.js", import.meta.url),
@@ -64,7 +88,8 @@ async function startProvider() {
     _promise && await _promise;
   }
 }
-async function serveCodexPlugin(chatgpt = false) {
+async function serveCodexPlugin() {
+  await setupCodex();
   const config = await readConfig();
   await startProvider();
   const base = `http://127.0.0.1:${config.codex?.port ?? 24275}`;
@@ -91,8 +116,10 @@ async function serveCodexPlugin(chatgpt = false) {
     name: "chappie",
     version: package_default.version
   });
-  for (const definition of definitions) {
-    const tool = server.registerTool(
+  for (const definition of definitions.filter(
+    (tool) => config.localTools || tool.name === "transfer"
+  )) {
+    server.registerTool(
       definition.name,
       {
         description: definition.description,
@@ -127,12 +154,10 @@ async function serveCodexPlugin(chatgpt = false) {
               };
             })
           ],
-          ...result.details && typeof result.details === "object" ? { structuredContent: { details: result.details } } : {}
+          ...result.details && typeof result.details === "object" ? { _meta: { details: result.details } } : {}
         };
       }
     );
-    if (chatgpt ? definition.name !== "transfer" : !config.localTools)
-      tool.disable();
   }
   server.registerResource(
     "Session resource",
@@ -175,5 +200,6 @@ async function serveCodexPlugin(chatgpt = false) {
   }
 }
 export {
-  serveCodexPlugin
+  serveCodexPlugin,
+  setupCodex
 };

package/dist/index.js

@@ -1,24 +1,24 @@
 import { createRequire } from "node:module"; const require = createRequire(import.meta.url);
 import {
   journalHistory
-} from "./chunk-OWAAWZNT.js";
+} from "./chunk-QTALHBOI.js";
 import {
   ProviderOutput,
   Session,
   createMessage
-} from "./chunk-5CKVVDZ2.js";
+} from "./chunk-G4LG7HH2.js";
 import {
   localDeliveries,
   localTools
-} from "./chunk-DM523QRR.js";
+} from "./chunk-3MLW5U2C.js";
+import "./chunk-RQKWETGT.js";
 import "./chunk-EIPDEA3I.js";
-import "./chunk-GX4JWLHH.js";
 import {
   readConfig,
   toJSONSchema,
   transferDescription,
   transferInput
-} from "./chunk-GWYP7B66.js";
+} from "./chunk-ASDHNBR2.js";
 import {
   __export
 } from "./chunk-UOFCCHBS.js";
@@ -4591,22 +4591,10 @@ async function chappie(pi) {
   };
   const session = new Session(host, config);
   const tools = localTools(session);
-  const names = new Set(tools.map((tool) => tool.name));
-  function updateTools() {
-    const desired = session.active ? ["transfer"] : session.localTools ? [...names] : [];
-    const active = pi.getActiveTools();
-    const enabled = active.filter((name) => names.has(name));
-    if (enabled.length === desired.length && enabled.every((name) => desired.includes(name)))
-      return;
-    pi.setActiveTools([
-      ...active.filter((name) => !names.has(name)),
-      ...desired
-    ]);
-  }
   const update = (ctx, selected = ctx.model) => {
     context = ctx;
     model = selected;
-    if (session.update()) updateTools();
+    session.update();
   };
   pi.registerEntryRenderer(
     "chappie.notice",

package/dist/omp.js

@@ -1,24 +1,24 @@
 import { createRequire } from "node:module"; const require = createRequire(import.meta.url);
 import {
   journalHistory
-} from "./chunk-OWAAWZNT.js";
+} from "./chunk-QTALHBOI.js";
 import {
   ProviderOutput,
   Session,
   createMessage
-} from "./chunk-5CKVVDZ2.js";
+} from "./chunk-G4LG7HH2.js";
 import {
   localTools
-} from "./chunk-DM523QRR.js";
+} from "./chunk-3MLW5U2C.js";
+import "./chunk-RQKWETGT.js";
 import {
   ipcEndpoint
 } from "./chunk-EIPDEA3I.js";
-import "./chunk-GX4JWLHH.js";
 import {
   getDirectory,
   readConfig,
   toJSONSchema
-} from "./chunk-GWYP7B66.js";
+} from "./chunk-ASDHNBR2.js";
 import "./chunk-UOFCCHBS.js";
 
 // src/omp.ts
@@ -118,19 +118,7 @@ async function chappie(omp) {
   };
   const session = new Session(host, config);
   const tools = localTools(session);
-  const names = new Set(tools.map((tool) => tool.name));
-  async function updateTools() {
-    const desired = session.active ? ["transfer"] : session.localTools ? [...names] : [];
-    const active = omp.getActiveTools();
-    const enabled = active.filter((name) => names.has(name));
-    if (enabled.length === desired.length && enabled.every((name) => desired.includes(name)))
-      return;
-    await omp.setActiveTools([
-      ...active.filter((name) => !names.has(name)),
-      ...desired
-    ]);
-  }
-  async function update(ctx) {
+  function update(ctx) {
     context = ctx;
     if (manager !== ctx.sessionManager) {
       unsubscribe?.();
@@ -139,7 +127,7 @@ async function chappie(omp) {
       const append = store.appendModelChange;
       const record = function(...args) {
         const result = append.apply(this, args);
-        if (session.update()) void updateTools();
+        session.update();
         return result;
       };
       store.appendModelChange = record;
@@ -150,13 +138,13 @@ async function chappie(omp) {
           store.appendModelChange = append;
       };
     }
-    if (session.update()) await updateTools();
+    session.update();
   }
   omp.on("session_start", (_event, ctx) => update(ctx));
   omp.on("session_switch", (_event, ctx) => update(ctx));
   omp.on("session_branch", (_event, ctx) => update(ctx));
-  omp.on("session_tree", async (_event, ctx) => {
-    await update(ctx);
+  omp.on("session_tree", (_event, ctx) => {
+    update(ctx);
     session.resetInputs();
     session.historyChanged();
   });

package/dist/opencode.js

@@ -3,20 +3,20 @@ import {
   ProviderOutput,
   Session,
   createMessage
-} from "./chunk-5CKVVDZ2.js";
+} from "./chunk-G4LG7HH2.js";
 import {
   definitions,
   localTools
-} from "./chunk-DM523QRR.js";
+} from "./chunk-3MLW5U2C.js";
+import "./chunk-RQKWETGT.js";
 import "./chunk-EIPDEA3I.js";
-import "./chunk-GX4JWLHH.js";
 import {
   historyPage,
   historyResult,
   readConfig,
   resourceDescriptors,
   toJSONSchema
-} from "./chunk-GWYP7B66.js";
+} from "./chunk-ASDHNBR2.js";
 import {
   __export,
   exports_client3
@@ -564,7 +564,9 @@ var opencode_default = {
       })
     );
     await context.tool.transform((editor) => {
-      for (const definition of definitions)
+      for (const definition of definitions.filter(
+        (tool) => config.localTools || tool.name === "transfer"
+      ))
         editor.add({
           name: definition.name,
           description: definition.description,
@@ -599,9 +601,6 @@ var opencode_default = {
       };
       state.busy = true;
       state.session.update();
-      for (const tool of definitions)
-        if (state.active() ? tool.name !== "transfer" : !state.session.localTools)
-          delete event.tools[tool.name];
       if (state.active()) {
         event.messages = [];
         event.system = [];

package/dist/{stdio-KJVCYPXJ.js → stdio-OC7FLZCL.js}

@@ -1,19 +1,19 @@
 import { createRequire } from "node:module"; const require = createRequire(import.meta.url);
-import {
-  IpcServer,
-  source,
-  sourceLabel
-} from "./chunk-EIPDEA3I.js";
 import {
   McpServer,
   ResourceTemplate,
   StdioServerTransport,
   serveStdio
-} from "./chunk-K2VE2MDU.js";
-import "./chunk-GX4JWLHH.js";
+} from "./chunk-QNDFCQ66.js";
+import "./chunk-RQKWETGT.js";
+import {
+  IpcServer,
+  source,
+  sourceLabel
+} from "./chunk-EIPDEA3I.js";
 import {
   package_default
-} from "./chunk-DN7OHZK6.js";
+} from "./chunk-DDBZIUBF.js";
 import {
   array,
   boolean,
@@ -35,7 +35,7 @@ import {
   toolResult,
   transferDescription,
   transferInput
-} from "./chunk-GWYP7B66.js";
+} from "./chunk-ASDHNBR2.js";
 import "./chunk-UOFCCHBS.js";
 
 // src/broker.ts

package/docs/setup.md

@@ -1,12 +1,14 @@
 # Setup and configuration
 
-The broker is available as `chappie` after global installation, or through `pnpx -y @zetaloop/chappie`. Agent plugins connect to it from their own devices.
+The broker is available as `chappie` after global installation. Agent plugins connect to it from their own devices.
 
 ## Codex
 
-Install the plugin from this repository's marketplace:
+On the Codex device, install Chappie, create its model catalog, and add the plugin:
 
 ```sh
+pnpm add -g @zetaloop/chappie@1
+chappie codex setup
 codex plugin marketplace add zetaloop/chappie
 codex plugin add chappie@chappie
 ```
@@ -17,38 +19,37 @@ Enable `localTools` in Chappie's configuration. The installed plugin provides to
 
 ### Using the Chappie model
 
-To receive work in Codex, save the [model catalog](https://raw.githubusercontent.com/zetaloop/chappie/main/src/codex.json) locally and reference its absolute path in Codex's user configuration, `~/.codex/config.toml` or `$CODEX_HOME/config.toml`:
+To receive work in Codex, select Chappie in Codex's user configuration, `~/.codex/config.toml` or `$CODEX_HOME/config.toml`:
 
 ```toml
 model_provider = "chappie"
 model = "chatgpt"
-model_catalog_json = "/absolute/path/to/codex.json"
+model_catalog_json = "~/.chappie/codex.json"
 
 [model_providers.chappie]
 name = "Chappie"
 base_url = "http://127.0.0.1:24275/v1"
-
-[mcp_servers.chappie]
-command = "pnpx"
-args = ["-y", "@zetaloop/chappie", "codex", "--chatgpt"]
-env_vars = ["CODEX_HOME"]
 ```
 
-Restart the Codex app after changing its provider configuration. The plugin starts the local provider service.
+Restart the Codex app after changing its provider configuration. The plugin starts the local provider service and refreshes the model catalog.
+
+Start a new conversation or open an existing Chappie conversation to make it available to connected assistants. Existing conversations use their saved provider.
 
-To return to an ordinary model, restore its model, provider, and catalog settings and remove the `[mcp_servers.chappie]` override shown above, then restart the app. The installed plugin supplies the local tools.
+To start new conversations with an ordinary model, restore its model, provider, and catalog settings, then restart the app.
 
 ## Configuration
 
 Settings live in `~/.chappie/config.json`. The broker and agent plugins read this file at startup; an absent file uses the defaults.
 
-| Setting | Default | Used by | Purpose |
-|---|---|---|---|
-| `ask` | `true` | Broker | Enable question widgets in ChatGPT. |
-| `cooldown` | `20` | Broker | Participation window, in seconds. |
-| `listen` | `false` | Broker | Accept TCP connections; `true` uses port `24274`, or supply a port number. |
-| `connect` | Local socket | Agent plugins | Broker hostname, optionally followed by `:port`. |
-| `localTools` | `false` | Agent plugins | Provide collaboration tools to ordinary models. |
+Agent plugins provide `transfer` in every session. Enable `localTools` for the complete [local tool set](tools.md#local-tools).
+
+| Setting      | Default      | Used by       | Purpose                                                                    |
+| ------------ | ------------ | ------------- | -------------------------------------------------------------------------- |
+| `ask`        | `true`       | Broker        | Enable question widgets in ChatGPT.                                        |
+| `cooldown`   | `20`         | Broker        | Participation window, in seconds.                                          |
+| `listen`     | `false`      | Broker        | Accept TCP connections; `true` uses port `24274`, or supply a port number. |
+| `connect`    | Local socket | Agent plugins | Broker hostname, optionally followed by `:port`.                           |
+| `localTools` | `false`      | Agent plugins | Enable collaboration tools.                            |
 
 `cooldown` applies to each ChatGPT conversation and target session. Repeated initialization within the window returns [observation instructions](tools.md#participation). The window refreshes when a question widget first loads or a resource is accessed; `0` disables it.
 
@@ -74,9 +75,9 @@ Chappie discovers OpenCode's local background service automatically. For a stand
 
 ### Codex service
 
-| Setting | Default | Purpose |
-|---|---|---|
-| `codex.port` | `24275` | Local provider HTTP port. |
-| `codex.appServer` | Default control socket | Codex app-server endpoint: `unix://<path>` or a WebSocket URL. |
+| Setting           | Default                    | Purpose                                                      |
+| ----------------- | -------------------------- | ------------------------------------------------------------ |
+| `codex.port`      | `24275`                    | Local provider HTTP port.                                    |
+| `codex.appServer` | Default CLI control socket | CLI app-server endpoint: `unix://<path>` or a WebSocket URL. |
 
 When changing `codex.port`, update `model_providers.chappie.base_url` in Codex's configuration to match.

package/docs/tools.md

@@ -1,18 +1,18 @@
 # Tools
 
-ChatGPT uses the tools below. Agent sessions using ordinary models have a [local tool set](#local-models).
-
-| Tool | Purpose |
-|---|---|
-| `sessions` | Find sessions by agent, device, directory, or name. |
-| `init` | Select this ChatGPT conversation's default session and read its environment. |
-| `tools` | Read the selected session's native tool definitions. |
-| `call` | Execute a native tool batch. |
-| `chat` | Send an assistant message or answer a model request. |
-| `history` | Read the agent's transcript with entry IDs and timestamps. |
-| `transfer` | Exchange files and images with ChatGPT or another session. |
-| `ask` | Create a persistent question in ChatGPT. |
-| `ask_assert` | Confirm that its widget loaded. |
+ChatGPT uses the tools below. Agent sessions also provide [local tools](#local-tools).
+
+| Tool         | Purpose                                                                      |
+| ------------ | ---------------------------------------------------------------------------- |
+| `sessions`   | Find sessions by agent, device, directory, or name.                          |
+| `init`       | Select this ChatGPT conversation's default session and read its environment. |
+| `tools`      | Read the selected session's native tool definitions.                         |
+| `call`       | Execute a native tool batch.                                                 |
+| `chat`       | Send an assistant message or answer a model request.                         |
+| `history`    | Read the agent's transcript with entry IDs and timestamps.                   |
+| `transfer`   | Exchange files and images with ChatGPT or another session.                   |
+| `ask`        | Create a persistent question in ChatGPT.                                     |
+| `ask_assert` | Confirm that its widget loaded.                                              |
 
 ## Sessions
 
@@ -145,20 +145,20 @@ Retrieve files using `from`:
 
 Both sides use their existing broker connections and resolve paths on their own devices. Different agents use the same transfer operations. Completed files remain available when another file in the batch fails or is cancelled.
 
-## Local models
+## Local tools
 
-Enable `localTools` in Chappie's configuration to provide these tools to ordinary models:
+Every agent session provides `transfer`. Enable `localTools` in Chappie's configuration for the complete tool set:
 
-| Tool | Target |
-|---|---|
-| `sessions` | Online Chappie sessions, with the current local ID reported as `self`. |
-| `remote_tools` | Tool definitions from the required `sessionId`. |
-| `remote_call` | One native tool batch in the required `sessionId`. |
-| `remote_chat` | An assistant message or model-request reply in the required `sessionId`. |
-| `history` | The current local transcript, or a Chappie session named by `sessionId`. |
-| `transfer` | Local files and resources exchanged with Chappie sessions. |
+| Tool           | Target                                                                   |
+| -------------- | ------------------------------------------------------------------------ |
+| `sessions`     | Online Chappie sessions, with the current local ID reported as `self`.   |
+| `remote_tools` | Tool definitions from the required `sessionId`.                          |
+| `remote_call`  | One native tool batch in the required `sessionId`.                       |
+| `remote_chat`  | An assistant message or model-request reply in the required `sessionId`. |
+| `history`      | The current local transcript, or a Chappie session named by `sessionId`. |
+| `transfer`     | Local files and resources exchanged with Chappie sessions.               |
 
-Use an ordinary model in the controlling session and the Chappie model in each target. This supports agent-to-agent collaboration, such as building a project on another operating system.
+Select the Chappie model in each target session. This supports agent-to-agent collaboration, such as building a project on another operating system.
 
 Local `history` reads the controlling session; pass `sessionId` for a target's transcript. `transfer` uses local paths and exchanges files with targets through `from` and `to`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zetaloop/chappie",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Connect ChatGPT and coding agents across devices",
   "devDependencies": {
     "@ai-sdk/provider": "^3.0.8",