@c0sc0s/orbit 0.5.0

package/README.md

@@ -0,0 +1,38 @@
+# Orbit
+
+An independently installed extension platform for Codex desktop on macOS, built on Node.js 22+. Orbit owns the launcher, versioned runtime, plugin installation, compatibility checks, configuration locking and activation recovery. It has no Tags or SQLite dependency.
+
+Orbit 0.5.0 is an unpublished npm candidate. Install the local tarball following [installation](../../docs/distribution.md). From a built checkout:
+
+```sh
+orbit install
+orbit plugin add ./packages/orbit-tags
+orbit start
+orbit plugin list
+orbit plugin disable orbit-tags
+orbit plugin enable orbit-tags
+orbit plugin uninstall orbit-tags
+```
+
+Use `~/Applications/Orbit.app` for subsequent launches. A zero-plugin platform is valid. `orbit plugin add /path/to/package` snapshots a built local package. The package must provide an explicit `files` allowlist and `orbit-plugin.json` with `schemaVersion`, `id`, `version`, `runtimeVersion`, `orbit: {min, maxExclusive}`, `renderer` and optional `service`/`codex` declarations. Runtime dependencies are copied into its private snapshot. Registry installs disable npm lifecycle scripts.
+
+Business modules import types from `@c0sc0s/orbit/sdk`; installation clients use `@c0sc0s/orbit/installation`. Platform data defaults to `~/Library/Application Support/Orbit`, configurable with `ORBIT_HOME`. Disable preserves files/data; uninstall removes only that plugin and preserves data by default. `--purge` never recursively removes external data. Registry `orbit update`, `orbit plugin update orbit-tags` and `orbit plugin install @c0sc0s/orbit-tags` require published compatible packages; `orbit rollback` selects a retained compatible runtime.
+
+## Advanced runtime entry
+
+Orbit also owns loopback CDP, isolated renderer globals, per-plugin service processes, RPC/events and cleanup. These explicit-config commands are available for unmanaged development manifests:
+
+```bash
+orbit start --config ./loader.json
+orbit status --config ./loader.json
+orbit remove --config ./loader.json --plugin hello
+orbit stop --config ./loader.json
+```
+
+A manifest has `apiVersion: 1` and `plugins: [{id, version, entry, service?, config?, enabled?}]`. `entry` is a local IIFE defining `CodexPlugin.activate(context)`; optional `service` is a Node ESM file exporting `activate(context)`. Paths must stay inside the manifest directory. `examples/loader.json` provides a renderer-only module; `examples/service-loader.json` adds RPC.
+
+Both contexts provide `id`, `config`, `signal` and `onDispose`. Renderer code uses `rpc.call(method, payload, options?)` and `events.subscribe(topic, handler)`. Services use `rpc.handle(method, handler)`, `events.publish(topic, payload, clientId?)`, `clients.onConnect/onDisconnect`, and a persistent `stateDirectory`. The implementation is strict TypeScript. Generated contracts ship in `dist/index.d.ts` alongside compiled ESM JavaScript; consumers do not need a TypeScript runtime. Low-level exports and `createLauncher` support custom infrastructure entry points.
+
+Use `--attach` to require an already debug-enabled app. `watch` runs in the foreground; `apply` injects renderer-only bundles once. Increment the module version after code changes. Cleanup runs in reverse registration order. RPC has timeouts, cancellation, payload and concurrency limits. Service crashes do not stop peer services. Fix and disable/re-enable a failed module; no automatic crash restart is performed.
+
+Plugins are trusted local code. Services run with Node privileges; renderers share the DOM/thread despite isolated globals. Renderer blocking code can block Codex. Do not put conversation bodies or secrets in diagnostics. Bundle all renderer assets locally. The official Codex bundle is never modified.

package/assets/README.md

@@ -0,0 +1,9 @@
+# Orbit application assets
+
+- `logo.png`: cobalt-blue pixel planet, stepped white orbit and lime-green star.
+- `app-icon.png`: square application composition emphasizing the complete silhouette.
+- `icon.icns`: packaged macOS icon, including 16, 32, 128, 256 and 512-point representations at 1× and 2×.
+
+These assets belong to Orbit and ship without requiring Tags.
+
+Run `npm run build:icon -w @c0sc0s/orbit` on macOS to convert `app-icon.png` with `sips` and `iconutil`. Consumers use the prebuilt ICNS and need no conversion tools.

package/dist/cdp/client.d.ts

@@ -0,0 +1,33 @@
+import type { MaybePromise } from "../sdk/contracts.js";
+import type { Target, BindingCall } from "../protocol/types.js";
+interface PendingCommand {
+    resolve(value: unknown): void;
+    reject(error: unknown): void;
+    timer: ReturnType<typeof setTimeout>;
+    method: string;
+}
+export declare class CdpClient {
+    #private;
+    readonly target: Target;
+    readonly socket: WebSocket;
+    nextCommandId: number;
+    pendingCommands: Map<number, PendingCommand>;
+    bindingHandlers: Map<string, (params: BindingCall) => MaybePromise<unknown>>;
+    generation: number;
+    closed: boolean;
+    worldContextId?: number;
+    worldPending?: Promise<void> | null;
+    static connect(target: Target, { createSocket }?: {
+        createSocket?: ((url: string) => WebSocket) | undefined;
+    }): Promise<CdpClient>;
+    constructor(target: Target, socket: WebSocket);
+    get connected(): boolean;
+    command<T = unknown>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    useIsolatedWorld(): Promise<void>;
+    evaluate<T = unknown>(expression: string, executionContextId?: number | undefined): Promise<T>;
+    addBinding(name: string, handler: (params: BindingCall) => MaybePromise<unknown>): Promise<void>;
+    removeBinding(name: string): Promise<void>;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/cdp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAChE,UAAU,cAAc;IAAG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAI9I,qBAAa,SAAS;;IA6BR,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS;IA5B/D,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,OAAa,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,YAAkD,EAAE;8BAA/B,MAAM;KAA8B,sBAmB/F;IAED,YAAqB,MAAM,EAAE,MAAM,EAAW,MAAM,EAAE,SAAS,EAS9D;IAED,IAAI,SAAS,YAEZ;IAEK,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAa/G;IAEK,gBAAgB,kBAarB;IAEK,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,qBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CASpG;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,YAAY,CAAC,OAAO,CAAC,iBAIrF;IAEK,aAAa,CAAC,IAAI,EAAE,MAAM,iBAG/B;IAED,KAAK,SAKJ;CAsCF"}

package/dist/cdp/client.js

@@ -0,0 +1,159 @@
+export class CdpClient {
+    target;
+    socket;
+    nextCommandId;
+    pendingCommands;
+    bindingHandlers;
+    generation;
+    closed;
+    worldContextId;
+    worldPending;
+    static async connect(target, { createSocket = (url) => new WebSocket(url) } = {}) {
+        const socket = createSocket(target.webSocketDebuggerUrl);
+        await new Promise((resolve, reject) => {
+            const finish = (error) => {
+                clearTimeout(timer);
+                socket.removeEventListener("open", onOpen);
+                socket.removeEventListener("error", onError);
+                socket.removeEventListener("close", onClose);
+                if (error) {
+                    socket.close();
+                    reject(error);
+                }
+                else
+                    resolve();
+            };
+            const onOpen = () => finish();
+            const onError = () => finish(new Error(`CDP websocket open failed for target ${target.id}`));
+            const onClose = () => finish(new Error(`CDP websocket closed before opening for target ${target.id}`));
+            const timer = setTimeout(() => finish(new Error(`CDP websocket open timed out for target ${target.id}`)), 3000);
+            socket.addEventListener("open", onOpen);
+            socket.addEventListener("error", onError);
+            socket.addEventListener("close", onClose);
+        });
+        return new CdpClient(target, socket);
+    }
+    constructor(target, socket) {
+        this.target = target;
+        this.socket = socket;
+        this.nextCommandId = 1;
+        this.pendingCommands = new Map();
+        this.bindingHandlers = new Map();
+        this.generation = 0;
+        this.closed = false;
+        socket.addEventListener("message", (event) => this.#handleMessage(event.data));
+        socket.addEventListener("close", () => this.#rejectPending(new Error(`CDP target ${target.id} disconnected`)));
+        socket.addEventListener("error", () => this.#rejectPending(new Error(`CDP target ${target.id} failed`)));
+    }
+    get connected() {
+        return !this.closed && this.socket.readyState === 1;
+    }
+    async command(method, params = {}, timeoutMs = 15_000) {
+        if (!this.connected)
+            throw new Error(`CDP target ${this.target.id} is not connected`);
+        const id = this.nextCommandId;
+        this.nextCommandId += 1;
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingCommands.delete(id);
+                reject(new Error(`${method} timed out for target ${this.target.id}`));
+            }, timeoutMs);
+            this.pendingCommands.set(id, { resolve, reject, timer, method });
+            try {
+                this.socket.send(JSON.stringify({ id, method, params }));
+            }
+            catch (error) {
+                clearTimeout(timer);
+                this.pendingCommands.delete(id);
+                reject(error);
+            }
+        });
+    }
+    async useIsolatedWorld() {
+        if (this.worldContextId !== undefined)
+            return;
+        this.worldPending ??= (async () => {
+            const generation = this.generation;
+            await this.command("Runtime.enable");
+            const { frameTree } = await this.command("Page.getFrameTree");
+            const { executionContextId } = await this.command("Page.createIsolatedWorld", {
+                frameId: frameTree.frame.id, worldName: "codex-plugin-loader", grantUniveralAccess: false,
+            });
+            if (this.generation !== generation)
+                throw new Error("Renderer changed during world creation");
+            this.worldContextId = executionContextId;
+        })().finally(() => { this.worldPending = null; });
+        await this.worldPending;
+    }
+    async evaluate(expression, executionContextId = this.worldContextId) {
+        const params = { expression, awaitPromise: true, returnByValue: true };
+        if (Number.isSafeInteger(executionContextId))
+            params.contextId = executionContextId;
+        const response = await this.command("Runtime.evaluate", params);
+        if (response?.exceptionDetails) {
+            const description = response.exceptionDetails.exception?.description ?? response.exceptionDetails.text;
+            throw new Error(description ?? `Runtime.evaluate failed for target ${this.target.id}`);
+        }
+        return response?.result?.value;
+    }
+    async addBinding(name, handler) {
+        await this.command("Runtime.enable");
+        await this.command("Runtime.addBinding", { name, ...(this.worldContextId === undefined ? {} : { executionContextName: "codex-plugin-loader" }) });
+        this.bindingHandlers.set(name, handler);
+    }
+    async removeBinding(name) {
+        this.bindingHandlers.delete(name);
+        if (this.connected)
+            await this.command("Runtime.removeBinding", { name });
+    }
+    close() {
+        this.closed = true;
+        this.bindingHandlers.clear();
+        this.#rejectPending(new Error(`CDP target ${this.target.id} closed`));
+        this.socket.close();
+    }
+    #handleMessage(rawMessage) {
+        let message;
+        try {
+            message = JSON.parse(rawMessage);
+        }
+        catch {
+            return;
+        }
+        if (!message || typeof message !== "object")
+            return;
+        if (message.id !== undefined) {
+            const pending = this.pendingCommands.get(message.id);
+            if (!pending)
+                return;
+            this.pendingCommands.delete(message.id);
+            clearTimeout(pending.timer);
+            if (message.error)
+                pending.reject(new Error(`${pending.method} failed: ${message.error.message ?? "unknown CDP error"}`));
+            else
+                pending.resolve(message.result);
+            return;
+        }
+        if (message.method === "Runtime.executionContextsCleared" || (message.method === "Runtime.executionContextDestroyed" && message.params?.executionContextId === this.worldContextId)) {
+            this.generation += 1;
+            this.worldContextId = undefined;
+        }
+        if (message.method !== "Runtime.bindingCalled")
+            return;
+        const params = message.params;
+        if (!params)
+            return;
+        const handler = this.bindingHandlers.get(params.name);
+        if (!handler)
+            return;
+        Promise.resolve().then(() => handler(params)).catch(() => { });
+    }
+    #rejectPending(error) {
+        for (const { reject, timer } of this.pendingCommands.values()) {
+            clearTimeout(timer);
+            reject(error);
+        }
+        this.pendingCommands.clear();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/cdp/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"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"}

package/dist/cdp/expressions.d.ts

@@ -0,0 +1,8 @@
+import type { PluginSource } from "../protocol/types.js";
+export declare const LOADER_VERSION = "0.5.0";
+/** Bootstrap only infrastructure; it never loads a product module. */
+export declare function buildLoaderExpression(): string;
+export declare function buildPluginExpression({ id, version, apiVersion, source, config, owner, endpoint }: PluginSource): string;
+export declare function buildPluginRemovalExpression(id: string): string;
+export declare function buildPluginMessageExpression(id: string, message: unknown): string;
+//# sourceMappingURL=expressions.d.ts.map

package/dist/cdp/expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../src/cdp/expressions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKzD,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,sEAAsE;AACtE,wBAAgB,qBAAqB,WAEpC;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,UAAc,EAAE,MAAM,EAAE,MAAW,EAAE,KAAY,EAAE,QAAoB,EAAE,EAAE,YAAY,UAU3I;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,UAEtD;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,UAExE"}

package/dist/cdp/expressions.js

@@ -0,0 +1,27 @@
+import { createRendererTransport } from "../renderer/transport.js";
+import { installLoader } from "../renderer/loader.js";
+import { createResourceScope } from "../lifecycle/resource-scope.js";
+export const LOADER_VERSION = "0.5.0";
+/** Bootstrap only infrastructure; it never loads a product module. */
+export function buildLoaderExpression() {
+    return `(${installLoader.toString()})(${createResourceScope.toString()}, ${JSON.stringify(LOADER_VERSION)}, ${createRendererTransport.toString()})`;
+}
+export function buildPluginExpression({ id, version, apiVersion = 1, source, config = {}, owner = null, endpoint = undefined }) {
+    if (apiVersion !== 1 || typeof id !== "string" || !/^[a-z][a-z0-9.-]{0,63}$/.test(id)
+        || typeof version !== "string" || !version || typeof source !== "string")
+        throw new Error("Invalid plugin descriptor");
+    return `(async () => {
+    const loader = ${buildLoaderExpression()};
+    return loader.load(${JSON.stringify({ id, version, apiVersion, owner, endpoint, instanceId: endpoint?.token })}, async (context) => {
+      ${source}\n;
+      return CodexPlugin.activate(context);
+    }, ${JSON.stringify(config)});
+  })()`;
+}
+export function buildPluginRemovalExpression(id) {
+    return `window.__codexPluginLoader?.unload(${JSON.stringify(id)}) ?? false`;
+}
+export function buildPluginMessageExpression(id, message) {
+    return `window.__codexPluginLoader?.dispatch(${JSON.stringify(id)}, ${JSON.stringify(message)}) ?? false`;
+}
+//# sourceMappingURL=expressions.js.map

package/dist/cdp/expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../src/cdp/expressions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,sEAAsE;AACtE,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,aAAa,CAAC,QAAQ,EAAE,KAAK,mBAAmB,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC;AACtJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAgB;IAC1I,IAAI,UAAU,KAAK,CAAC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;WAChF,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACzH,OAAO;qBACY,qBAAqB,EAAE;yBACnB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC1G,MAAM;;SAEL,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;OACxB,CAAC;AACR,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,EAAU;IACrD,OAAO,sCAAsC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,EAAU,EAAE,OAAgB;IACvE,OAAO,wCAAwC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;AAC5G,CAAC"}

package/dist/cdp/target-registry.d.ts

@@ -0,0 +1,33 @@
+import type { Target, PluginDescriptor, PluginResult } from "../protocol/types.js";
+type RegistryOptions = {
+    port?: number;
+    owner?: string | null;
+    ownsEndpoint(): Promise<boolean>;
+    connect?: typeof CdpClient.connect;
+};
+import { CdpClient } from "./client.js";
+export declare function isCodexRendererTarget(value: unknown): value is Target;
+/** Owns reusable CDP connections and rejects unowned/non-loopback targets. */
+export declare class PluginTargetRegistry {
+    port: number;
+    owner: string | null;
+    ownsEndpoint: RegistryOptions["ownsEndpoint"];
+    connect: typeof CdpClient.connect;
+    clients: Map<string, CdpClient>;
+    constructor({ port, ownsEndpoint, connect, owner }: RegistryOptions);
+    assertOwnership(): Promise<void>;
+    discover(): Promise<Target[]>;
+    client(target: Target): Promise<CdpClient>;
+    evaluate<T = unknown>(target: Target, expression: string): Promise<T>;
+    prune(targets: Target[]): void;
+    close(): void;
+    claimPlugin(target: Target, id: string): Promise<void>;
+    ensurePlugins(plugins: PluginDescriptor[], targets?: Target[]): Promise<{
+        targets: Target[];
+        results: PluginResult[];
+        injectedTargetIds: Set<string>;
+    }>;
+    removePlugins(ids: string[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=target-registry.d.ts.map

package/dist/cdp/target-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.d.ts","sourceRoot":"","sources":["../../src/cdp/target-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAiB,MAAM,sBAAsB,CAAC;AAClG,KAAK,eAAe,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,SAAS,CAAC,OAAO,CAAA;CAAE,CAAC;AACtI,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKrE;AAED,8EAA8E;AAC9E,qBAAa,oBAAoB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,SAAS,CAAC,OAAO,CAAC;IAClC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,YAAY,EAAE,IAAW,EAAE,YAAY,EAAE,OAA2B,EAAE,KAAY,EAAE,EAAE,eAAe,EAOpG;IAEK,eAAe,kBAKpB;IAEK,QAAQ,sBASb;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,sBAY1B;IAEK,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1E;IAED,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAKtB;IAED,KAAK,SAGJ;IAEK,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,iBAG3C;IAEK,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE;;;;OA8BlE;IAEK,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,iBAUhC;CACF"}

package/dist/cdp/target-registry.js

@@ -0,0 +1,139 @@
+import { CdpClient } from "./client.js";
+import { buildLoaderExpression, buildPluginRemovalExpression } from "./expressions.js";
+export function isCodexRendererTarget(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const target = value;
+    return target?.type === "page" && typeof target.url === "string" && target.url.startsWith("app://-")
+        && typeof target.webSocketDebuggerUrl === "string";
+}
+/** Owns reusable CDP connections and rejects unowned/non-loopback targets. */
+export class PluginTargetRegistry {
+    port;
+    owner;
+    ownsEndpoint;
+    connect;
+    clients;
+    constructor({ port = 9341, ownsEndpoint, connect = CdpClient.connect, owner = null }) {
+        if (!Number.isSafeInteger(port) || port < 1024 || port > 65535 || typeof ownsEndpoint !== "function")
+            throw new Error("Invalid CDP endpoint configuration");
+        this.port = port;
+        this.owner = owner;
+        this.ownsEndpoint = ownsEndpoint;
+        this.connect = connect;
+        this.clients = new Map();
+    }
+    async assertOwnership() {
+        if (!(await this.ownsEndpoint())) {
+            this.close();
+            throw new Error(`CDP endpoint 127.0.0.1:${this.port} is not owned by Codex`);
+        }
+    }
+    async discover() {
+        await this.assertOwnership();
+        const response = await fetch(`http://127.0.0.1:${this.port}/json/list`, {
+            redirect: "error", signal: AbortSignal.timeout(800),
+        });
+        if (!response.ok)
+            throw new Error(`CDP discovery failed: HTTP ${response.status}`);
+        const targets = await response.json();
+        if (!Array.isArray(targets))
+            throw new Error("Invalid CDP target list");
+        return targets.filter(isCodexRendererTarget);
+    }
+    async client(target) {
+        const url = new URL(target.webSocketDebuggerUrl);
+        if (url.protocol !== "ws:" || url.hostname !== "127.0.0.1" || Number(url.port) !== this.port
+            || url.username || url.password)
+            throw new Error("CDP target must use the owned loopback endpoint");
+        await this.assertOwnership();
+        const previous = this.clients.get(target.id);
+        if (previous?.connected && previous.target.webSocketDebuggerUrl === target.webSocketDebuggerUrl) {
+            await previous.useIsolatedWorld?.();
+            return previous;
+        }
+        previous?.close();
+        const client = await this.connect(target);
+        this.clients.set(target.id, client);
+        await client.useIsolatedWorld?.();
+        return client;
+    }
+    async evaluate(target, expression) {
+        return (await this.client(target)).evaluate(expression);
+    }
+    prune(targets) {
+        const ids = new Set(targets.map(({ id }) => id));
+        for (const [id, client] of this.clients) {
+            if (!ids.has(id)) {
+                client.close();
+                this.clients.delete(id);
+            }
+        }
+    }
+    close() {
+        for (const client of this.clients.values())
+            client.close();
+        this.clients.clear();
+    }
+    async claimPlugin(target, id) {
+        await this.evaluate(target, `${buildLoaderExpression()}; true`);
+        if (this.owner && !(await this.evaluate(target, `window.__codexPluginLoader.claim(${JSON.stringify(id)}, ${JSON.stringify(this.owner)})`)))
+            throw new Error("Plugin owner conflict");
+    }
+    async ensurePlugins(plugins, targets) {
+        await this.assertOwnership();
+        targets ??= await this.discover();
+        if (!targets.length)
+            throw new Error("No Codex renderer found");
+        const results = [];
+        const injectedTargetIds = new Set();
+        await Promise.all(targets.map(async (target) => {
+            try {
+                await this.evaluate(target, `${buildLoaderExpression()}; true`);
+            }
+            catch {
+                results.push({ targetId: target.id, pluginId: null, stage: "bootstrap", error: "Loader bootstrap failed" });
+                return;
+            }
+            for (const plugin of plugins) {
+                let stage = "inspect";
+                try {
+                    if (this.owner && !(await this.evaluate(target, `window.__codexPluginLoader.claim(${JSON.stringify(plugin.id)}, ${JSON.stringify(this.owner)})`)))
+                        throw new Error("Plugin owner conflict");
+                    const state = await this.evaluate(target, `window.__codexPluginLoader.status(${JSON.stringify(plugin.id)})`);
+                    let injected = false;
+                    if (state?.state !== "active" || state.version !== plugin.version || (plugin.instanceId && state.instanceId !== plugin.instanceId)) {
+                        stage = "activate";
+                        await this.evaluate(target, plugin.expression);
+                        injectedTargetIds.add(target.id);
+                        injected = true;
+                    }
+                    stage = "status";
+                    const status = await this.evaluate(target, `window.__codexPluginLoader.inspect(${JSON.stringify(plugin.id)})`);
+                    results.push({ targetId: target.id, pluginId: plugin.id, status, injected });
+                }
+                catch {
+                    results.push({ targetId: target.id, pluginId: plugin.id, error: `Plugin ${stage} failed`, stage });
+                }
+            }
+        }));
+        return { targets, results, injectedTargetIds };
+    }
+    async removePlugins(ids) {
+        const targets = await this.discover();
+        const failures = [];
+        await Promise.all(targets.map(async (target) => {
+            for (const id of ids) {
+                try {
+                    await this.evaluate(target, this.owner ? `window.__codexPluginLoader?.release ? window.__codexPluginLoader.release(${JSON.stringify(id)}, ${JSON.stringify(this.owner)}) : (${buildPluginRemovalExpression(id)})` : buildPluginRemovalExpression(id));
+                }
+                catch {
+                    failures.push(`${target.id}/${id}`);
+                }
+            }
+        }));
+        if (failures.length)
+            throw new Error(`Plugin removal failed: ${failures.join(", ")}`);
+    }
+}
+//# sourceMappingURL=target-registry.js.map

package/dist/cdp/target-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.js","sourceRoot":"","sources":["../../src/cdp/target-registry.ts"],"names":[],"mappings":"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"}

package/dist/cli/arguments.d.ts

@@ -0,0 +1,13 @@
+declare const commands: readonly ["start", "apply", "watch", "status", "remove", "stop"];
+type Command = typeof commands[number] | "--help";
+export declare function parseArguments(argv: string[]): {
+    readonly command: "--help";
+    readonly options: Record<string, string | undefined>;
+} | {
+    command: Exclude<Command, "--help">;
+    options: Record<string, string | undefined> & {
+        "--config": string;
+    };
+};
+export {};
+//# sourceMappingURL=arguments.d.ts.map

package/dist/cli/arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,QAAQ,YAAI,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAClF,KAAK,OAAO,GAAG,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;AAElD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE;;;;aAkBd,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;;oBADa,MAAM;;EAE3E"}

package/dist/cli/arguments.js

@@ -0,0 +1,29 @@
+const commands = ["start", "apply", "watch", "status", "remove", "stop"];
+export function parseArguments(argv) {
+    const [command = "--help", ...args] = argv;
+    const options = {};
+    if (command === "--help")
+        return { command, options };
+    if (!commands.some(value => value === command))
+        throw new Error("Unknown loader command");
+    for (let i = 0; i < args.length; i += 1) {
+        const key = args[i];
+        if (!["--config", "--port", "--token", "--attach", "--plugin"].includes(key) || options[key] !== undefined)
+            throw new Error("Invalid loader options");
+        if (key === "--attach")
+            options[key] = "true";
+        else {
+            if (!args[i + 1] || args[i + 1].startsWith("--"))
+                throw new Error(`Missing ${key} value`);
+            options[key] = args[++i];
+        }
+    }
+    if (!options["--config"] || (options["--token"] && command !== "watch") || (options["--attach"] && command !== "start") || (options["--plugin"] && command !== "remove"))
+        throw new Error("Invalid options for Loader command; --config is required");
+    const port = Number(options["--port"] ?? 9341);
+    if (!Number.isInteger(port) || port < 1 || port > 65535)
+        throw new Error("Port must be an integer between 1 and 65535");
+    const validated = { ...options, "--config": options["--config"] };
+    return { command: command, options: validated };
+}
+//# sourceMappingURL=arguments.js.map

package/dist/cli/arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.js","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAGlF,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,CAAC,OAAO,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACtJ,IAAI,GAAG,KAAK,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;aACzC,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC;YAC1F,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,KAAK,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACtP,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACxH,MAAM,SAAS,GAAgE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;IAC/H,OAAO,EAAE,OAAO,EAAE,OAAqC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChF,CAAC"}

package/dist/cli/platform.d.ts

@@ -0,0 +1,2 @@
+export declare function runPlatformCli(argv: string[]): Promise<boolean>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/cli/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/cli/platform.ts"],"names":[],"mappings":"AAEA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,oBAgElD"}