@c0sc0s/orbit 0.5.0

package/dist/protocol/ipc.d.ts

@@ -0,0 +1,38 @@
+export type ServiceRequest = {
+    type: "activate";
+    id: number;
+    entry: string;
+    pluginId: string;
+    config: Record<string, unknown>;
+    stateDirectory: string;
+} | {
+    type: "cancel";
+    requestId: number;
+} | {
+    type: "dispose";
+    id: number;
+} | {
+    type: "connect" | "disconnect";
+    id: number;
+    clientId: string;
+} | {
+    type: "call";
+    id: number;
+    method: string;
+    payload?: unknown;
+    clientId: string;
+};
+export type ServiceEvent = {
+    type: "event";
+    topic: string;
+    payload: unknown;
+    clientId?: string;
+};
+export type ServiceReply = {
+    type?: "reply";
+    id: number;
+    error?: string;
+    value?: unknown;
+};
+export declare function assertMessageSize(value: unknown): void;
+//# sourceMappingURL=ipc.d.ts.map

package/dist/protocol/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/protocol/ipc.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC1H;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACtF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACjG,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,QAE/C"}

package/dist/protocol/ipc.js

@@ -0,0 +1,5 @@
+export function assertMessageSize(value) {
+    if (Buffer.byteLength(JSON.stringify(value) ?? "null") > 1024 * 1024)
+        throw new Error("Service message exceeds 1 MiB");
+}
+//# sourceMappingURL=ipc.js.map

package/dist/protocol/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../src/protocol/ipc.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACzH,CAAC"}

package/dist/protocol/types.d.ts

@@ -0,0 +1,55 @@
+import type { PluginEntry } from "../sdk/contracts.js";
+export interface PluginDescriptor {
+    id: string;
+    version: string;
+    expression: string;
+    instanceId?: string;
+}
+export interface PluginEndpoint {
+    binding: string | null;
+    token: string | null;
+}
+export interface PluginSource {
+    id: string;
+    version: string;
+    source: string;
+    apiVersion?: 1;
+    config?: Record<string, unknown>;
+    owner?: string | null;
+    endpoint?: PluginEndpoint;
+}
+export interface LoaderManifest {
+    path: string;
+    root: string;
+    plugins: PluginEntry[];
+}
+export interface Target {
+    id: string;
+    type?: string;
+    url?: string;
+    webSocketDebuggerUrl: string;
+}
+export interface BindingCall {
+    name: string;
+    payload: string;
+    executionContextId: number;
+}
+export interface PluginResult {
+    targetId?: string;
+    pluginId: string | null;
+    status?: unknown;
+    injected?: boolean;
+    stage?: string;
+    error?: string;
+}
+export interface CleanupFailure {
+    pluginId: string;
+    stage: string;
+}
+export interface PluginSummary {
+    id: string;
+    version: string;
+    instanceId?: string;
+    state: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAC1G,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAChF,MAAM,WAAW,YAAY;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;CAAE;AACjL,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE;AACtF,MAAM,WAAW,MAAM;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE;AACjG,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE;AAC1F,MAAM,WAAW,YAAY;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAClJ,MAAM,WAAW,cAAc;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACnE,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE"}

package/dist/protocol/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":""}

package/dist/renderer/loader.d.ts

@@ -0,0 +1,32 @@
+import type { RendererContext, RendererPlugin, MaybePromise } from "../sdk/contracts.js";
+import type { PluginEndpoint, PluginSummary } from "../protocol/types.js";
+import type { createResourceScope as scopeFactory } from "../lifecycle/resource-scope.js";
+import type { createRendererTransport as transportFactory, TransportMessage } from "./transport.js";
+interface RendererManifest {
+    apiVersion: number;
+    id: string;
+    version: string;
+    instanceId?: string;
+    owner?: string | null;
+    endpoint?: PluginEndpoint;
+}
+interface RendererLoader {
+    apiVersion: number;
+    version: string;
+    claim(id: string, owner: string): boolean;
+    release(id: string, owner: string): Promise<boolean>;
+    status(id?: string): PluginSummary[] | PluginSummary | null;
+    load(manifest: RendererManifest, activate: (context: RendererContext) => MaybePromise<RendererPlugin | void>, config?: Record<string, unknown>): Promise<PluginSummary | null>;
+    unload(id: string): Promise<boolean>;
+    deliver(id: string, message: TransportMessage): boolean;
+    dispatch(id: string, message: unknown): MaybePromise<unknown>;
+    inspect(id: string): unknown;
+}
+declare global {
+    interface Window {
+        __codexPluginLoader?: RendererLoader;
+    }
+}
+export declare function installLoader(createResourceScope: typeof scopeFactory, version: string, createRendererTransport: typeof transportFactory): RendererLoader;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/renderer/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/renderer/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,IAAI,YAAY,EAAiB,MAAM,gCAAgC,CAAC;AACzG,OAAO,KAAK,EAAE,uBAAuB,IAAI,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpG,UAAU,gBAAgB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;CAAE;AAErJ,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,aAAa,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,YAAY,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC/K,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AACD,OAAO,CAAC,MAAM,CAAC;IAAE,UAAU,MAAM;QAAG,mBAAmB,CAAC,EAAE,cAAc,CAAA;KAAE;CAAE;AAE5E,wBAAgB,aAAa,CAAC,mBAAmB,EAAE,OAAO,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,OAAO,gBAAgB,GAAG,cAAc,CAqGzJ"}

package/dist/renderer/loader.js

@@ -0,0 +1,130 @@
+// This function is serialized into the renderer; keep it independent of module scope.
+export function installLoader(createResourceScope, version, createRendererTransport) {
+    const existing = window.__codexPluginLoader;
+    if (existing) {
+        if (existing.apiVersion === 1 && existing.version === version)
+            return existing;
+        if (existing.apiVersion !== 1 || existing.status().length)
+            throw new Error("Incompatible Codex Plugin Loader is active; unload its plugins before upgrading");
+    }
+    const plugins = new Map();
+    const owners = new Map();
+    const queues = new Map();
+    const serialize = (id, operation) => {
+        const next = (queues.get(id) ?? Promise.resolve()).catch(() => { }).then(operation);
+        queues.set(id, next);
+        next.finally(() => { if (queues.get(id) === next)
+            queues.delete(id); }).catch(() => { });
+        return next;
+    };
+    const isActive = (record) => {
+        try {
+            return record.instance?.isActive?.() !== false;
+        }
+        catch {
+            return false;
+        }
+    };
+    const summary = (record) => record ? {
+        id: record.id, version: record.version,
+        ...(record.instanceId ? { instanceId: record.instanceId } : {}),
+        state: record.state === "active" && !isActive(record) ? "inactive" : record.state,
+    } : null;
+    const clean = async (record) => {
+        record.state = "unloading";
+        try {
+            await record.scope.close();
+        }
+        catch {
+            record.state = "cleanup-failed";
+            throw new Error(`Plugin ${record.id} cleanup failed`);
+        }
+    };
+    const loader = {
+        apiVersion: 1,
+        version,
+        claim(id, owner) {
+            if (owners.has(id) && owners.get(id) !== owner)
+                return false;
+            owners.set(id, owner);
+            return true;
+        },
+        async release(id, owner) {
+            if (owners.has(id) && owners.get(id) !== owner)
+                throw new Error("Plugin belongs to another Loader configuration");
+            const result = await loader.unload(id);
+            owners.delete(id);
+            return result;
+        },
+        status: (id) => id === undefined ? [...plugins.values()].map(record => summary(record)) : summary(plugins.get(id)),
+        load: (manifest, activate, config = {}) => {
+            if (!manifest || manifest.apiVersion !== 1 || typeof manifest.id !== "string" || !/^[a-z][a-z0-9.-]{0,63}$/.test(manifest.id)
+                || typeof manifest.version !== "string" || !manifest.version || typeof activate !== "function") {
+                return Promise.reject(new Error("Invalid plugin contract"));
+            }
+            return serialize(manifest.id, async () => {
+                if (manifest.owner && owners.get(manifest.id) !== manifest.owner)
+                    throw new Error("Plugin ownership changed");
+                const previous = plugins.get(manifest.id);
+                if (summary(previous)?.state === "active" && previous?.version === manifest.version && previous.instanceId === manifest.instanceId)
+                    return summary(previous);
+                if (previous?.state === "cleanup-failed")
+                    throw new Error(`Plugin ${manifest.id} requires a renderer reload after failed cleanup`);
+                if (previous) {
+                    await clean(previous);
+                    plugins.delete(manifest.id);
+                }
+                const record = { id: manifest.id, version: manifest.version, instanceId: manifest.instanceId, state: "loading", scope: createResourceScope(), instance: null };
+                plugins.set(manifest.id, record);
+                record.transport = createRendererTransport(manifest.endpoint ?? { binding: null, token: null }, record.scope);
+                try {
+                    const activation = Promise.resolve().then(() => activate(Object.freeze({
+                        id: manifest.id, config, signal: record.scope.signal, onDispose: record.scope.onDispose,
+                        rpc: record.transport.rpc, events: record.transport.events,
+                    }))).then((instance) => {
+                        if (typeof instance?.dispose === "function")
+                            record.scope.onDispose(() => instance.dispose?.());
+                        return instance;
+                    });
+                    record.instance = await record.scope.bounded(() => activation, "Activation");
+                    if (record.scope.signal.aborted)
+                        throw new Error("Activation cancelled");
+                    record.state = "active";
+                    return summary(record);
+                }
+                catch (error) {
+                    await clean(record);
+                    record.state = error instanceof Error && error.message === "Activation timed out" ? "cleanup-failed" : "failed";
+                    throw new Error(`Plugin ${manifest.id} activation failed`);
+                }
+            });
+        },
+        unload: (id) => {
+            plugins.get(id)?.scope.abort();
+            return serialize(id, async () => {
+                const record = plugins.get(id);
+                if (!record)
+                    return false;
+                if (record.state === "cleanup-failed")
+                    throw new Error(`Plugin ${id} requires a renderer reload after failed cleanup`);
+                await clean(record);
+                plugins.delete(id);
+                return true;
+            });
+        },
+        deliver: (id, message) => plugins.get(id)?.transport?.deliver(message) ?? false,
+        dispatch: (id, message) => {
+            const record = plugins.get(id);
+            if (summary(record)?.state !== "active")
+                return false;
+            return record?.instance?.handleMessage?.(message) ?? false;
+        },
+        inspect: (id) => {
+            const record = plugins.get(id);
+            return record?.state === "active" ? record.instance?.status?.() ?? summary(record) : summary(record);
+        },
+    };
+    window.__codexPluginLoader = Object.freeze(loader);
+    return loader;
+}
+//# sourceMappingURL=loader.js.map

package/dist/renderer/loader.js.map

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

package/dist/renderer/transport.d.ts

@@ -0,0 +1,28 @@
+import type { MaybePromise, RpcOptions } from "../sdk/contracts.js";
+import type { PluginEndpoint } from "../protocol/types.js";
+import type { ResourceScope } from "../lifecycle/resource-scope.js";
+type Reply = {
+    type: "reply";
+    token?: string;
+    id: number;
+    error?: string;
+    value?: unknown;
+};
+type EventMessage = {
+    type: "event";
+    token?: string;
+    topic: string;
+    payload?: unknown;
+};
+export type TransportMessage = Reply | EventMessage;
+export declare function createRendererTransport(endpoint: PluginEndpoint, scope: ResourceScope): {
+    rpc: Readonly<{
+        call<T = unknown>(method: string, payload?: unknown, options?: RpcOptions): Promise<T>;
+    }>;
+    events: Readonly<{
+        subscribe(topic: string, handler: (payload: unknown) => MaybePromise<unknown>): () => void;
+    }>;
+    deliver(message: TransportMessage): boolean;
+};
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/renderer/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/renderer/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAC5F,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,YAAY,CAAC;AAEpD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa;;aAYxD,CAAC,oBAAoB,MAAM,YAAW,OAAO,YAAkB,UAAU,GAAQ,OAAO,CAAC,CAAC,CAAC;;;yBAyB5E,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC;;qBAQpF,gBAAgB;EAmBpC"}

package/dist/renderer/transport.js

@@ -0,0 +1,89 @@
+// Serialized with the Loader; no module-scope dependencies are available in the renderer.
+export function createRendererTransport(endpoint, scope) {
+    const pending = new Map();
+    const subscribers = new Map();
+    let sequence = 0;
+    const send = (message) => {
+        const encoded = JSON.stringify({ ...message, token: endpoint.token });
+        if (new TextEncoder().encode(encoded).byteLength > 65_536)
+            throw new Error("RPC request exceeds 64 KiB");
+        const binding = window[endpoint.binding ?? ""];
+        if (typeof binding !== "function")
+            throw new Error("Plugin service is unavailable");
+        binding(encoded);
+    };
+    const transport = {
+        rpc: Object.freeze({ call(method, payload = null, options = {}) {
+                if (scope.signal.aborted || options.signal?.aborted)
+                    return Promise.reject(new Error("RPC cancelled"));
+                if (typeof method !== "string" || !method || method.length > 128)
+                    return Promise.reject(new Error("Invalid RPC method"));
+                if (pending.size >= 128)
+                    return Promise.reject(new Error("Too many pending RPC requests"));
+                const timeoutMs = options.timeoutMs ?? 10_000;
+                if (!Number.isFinite(timeoutMs) || timeoutMs < 1 || timeoutMs > 30_000)
+                    return Promise.reject(new Error("RPC timeout must be between 1 and 30000 ms"));
+                const id = ++sequence;
+                return new Promise((resolve, reject) => {
+                    const finish = (error, value) => {
+                        if (!pending.delete(id))
+                            return;
+                        clearTimeout(timer);
+                        options.signal?.removeEventListener("abort", abort);
+                        error ? reject(error) : resolve(value);
+                    };
+                    const cancel = (reason) => {
+                        try {
+                            send({ type: "cancel", id });
+                        }
+                        catch { }
+                        finish(new Error(reason));
+                    };
+                    const abort = () => cancel("RPC cancelled");
+                    const timer = setTimeout(() => cancel("RPC timed out"), timeoutMs);
+                    pending.set(id, { finish, cancel });
+                    options.signal?.addEventListener("abort", abort, { once: true });
+                    try {
+                        send({ type: "call", id, method, payload, timeoutMs });
+                    }
+                    catch (error) {
+                        finish(error);
+                    }
+                });
+            } }),
+        events: Object.freeze({ subscribe(topic, handler) {
+                if (scope.signal.aborted)
+                    throw new Error("Plugin is closing");
+                if (typeof topic !== "string" || !topic || typeof handler !== "function")
+                    throw new Error("Invalid event subscription");
+                const handlers = subscribers.get(topic) ?? new Set();
+                subscribers.set(topic, handlers);
+                handlers.add(handler);
+                return () => { handlers.delete(handler); if (!handlers.size)
+                    subscribers.delete(topic); };
+            } }),
+        deliver(message) {
+            if (scope.signal.aborted || message?.token !== endpoint.token)
+                return false;
+            if (message.type === "reply") {
+                const request = pending.get(message.id);
+                request?.finish(message.error ? new Error(message.error) : null, message.value);
+                return Boolean(request);
+            }
+            if (message.type === "event") {
+                for (const handler of subscribers.get(message.topic) ?? [])
+                    Promise.resolve().then(() => { if (!scope.signal.aborted)
+                        return handler(message.payload); }).catch(() => { });
+                return true;
+            }
+            return false;
+        },
+    };
+    scope.onDispose(() => {
+        for (const request of [...pending.values()])
+            request.cancel("Plugin unloaded");
+        subscribers.clear();
+    });
+    return transport;
+}
+//# sourceMappingURL=transport.js.map

package/dist/renderer/transport.js.map

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

package/dist/sdk/contracts.d.ts

@@ -0,0 +1,50 @@
+export type MaybePromise<T> = T | Promise<T>;
+export interface PluginEntry {
+    id: string;
+    version: string;
+    entry: string;
+    service?: string;
+    enabled?: boolean;
+    config?: Record<string, unknown>;
+}
+export interface ResourceContext {
+    id: string;
+    config: Record<string, unknown>;
+    signal: AbortSignal;
+    onDispose(dispose: () => MaybePromise<unknown>): void;
+}
+export interface RpcOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface RendererContext extends ResourceContext {
+    rpc: {
+        call<T = unknown>(method: string, payload?: unknown, options?: RpcOptions): Promise<T>;
+    };
+    events: {
+        subscribe(topic: string, handler: (payload: unknown) => MaybePromise<unknown>): () => void;
+    };
+}
+export interface RendererPlugin {
+    dispose?(): MaybePromise<unknown>;
+    isActive?(): boolean;
+    status?(): unknown;
+    handleMessage?(message: unknown): MaybePromise<unknown>;
+}
+export interface ServiceContext extends ResourceContext {
+    stateDirectory: string;
+    rpc: {
+        handle(method: string, handler: (payload: unknown, request: {
+            clientId: string;
+            signal: AbortSignal;
+        }) => MaybePromise<unknown>): void;
+    };
+    events: {
+        publish(topic: string, payload: unknown, clientId?: string): void;
+    };
+    clients: {
+        onConnect(handler: (clientId: string) => MaybePromise<unknown>): () => void;
+        onDisconnect(handler: (clientId: string) => MaybePromise<unknown>): () => void;
+    };
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/sdk/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/sdk/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7C,MAAM,WAAW,WAAW;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAClJ,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IACjE,SAAS,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACvD;AACD,MAAM,WAAW,UAAU;IAAG,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AACxE,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,GAAG,EAAE;QAAE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IAChG,MAAM,EAAE;QAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,CAAA;KAAE,CAAC;CACxG;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,IAAI,OAAO,CAAC;IACrB,MAAM,CAAC,IAAI,OAAO,CAAC;IACnB,aAAa,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;CACzD;AACD,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE;QAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,WAAW,CAAA;SAAE,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAChJ,MAAM,EAAE;QAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9E,OAAO,EAAE;QACP,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC;QAC5E,YAAY,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC;KAChF,CAAC;CACH"}

package/dist/sdk/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/sdk/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/sdk/contracts.ts"],"names":[],"mappings":""}

package/dist/service/module.d.ts

@@ -0,0 +1,24 @@
+import type { CdpClient } from "../cdp/client.js";
+import type { PluginEntry, MaybePromise } from "../sdk/contracts.js";
+import type { PluginDescriptor, BindingCall } from "../protocol/types.js";
+import type { ResourceScope } from "../lifecycle/resource-scope.js";
+export interface HostModule {
+    renderer(client: CdpClient): MaybePromise<PluginDescriptor>;
+    bindings?: Array<{
+        name: string;
+        handle(client: CdpClient, params: BindingCall): MaybePromise<unknown>;
+    }>;
+    cancelPending?(): void;
+    tick?(): MaybePromise<void>;
+    onReady?(client: CdpClient): MaybePromise<unknown>;
+    onTargetRemoved?(id: string): MaybePromise<void>;
+    dispose?(): MaybePromise<void>;
+}
+/** Adapts the business SDK to the host's private target lifecycle. */
+export declare function createServiceModule(entry: PluginEntry, { root, stateDirectory, owner, onDispose }: {
+    root: string;
+    stateDirectory: string;
+    owner: string | null;
+    onDispose: ResourceScope["onDispose"];
+}): Promise<HostModule>;
+//# sourceMappingURL=module.d.ts.map

package/dist/service/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/service/module.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAiB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC1G,aAAa,CAAC,IAAI,IAAI,CAAC;IACvB,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnD,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,sEAAsE;AACtE,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CA4DpO"}

package/dist/service/module.js

@@ -0,0 +1,97 @@
+import { randomBytes } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { buildPluginExpression } from "../cdp/expressions.js";
+import { resolvePluginEntry } from "../config/manifest.js";
+import { ServiceProcess } from "./process.js";
+/** Adapts the business SDK to the host's private target lifecycle. */
+export async function createServiceModule(entry, { root, stateDirectory, owner, onDispose }) {
+    const source = await readFile(await resolvePluginEntry(root, entry.entry), "utf8");
+    const clients = new Map();
+    const binding = `__codexPlugin_${entry.id.replaceAll(/[^a-z0-9]/g, "_")}_${randomBytes(6).toString("hex")}`;
+    const deliver = async (state, message) => {
+        if (!state.client.connected || state.client.generation !== state.generation || clients.get(state.client.target.id) !== state)
+            return;
+        return state.client.evaluate(`window.__codexPluginLoader?.deliver(${JSON.stringify(entry.id)}, ${JSON.stringify({ ...message, token: state.token })})`, state.contextId);
+    };
+    const service = entry.service ? new ServiceProcess({
+        entry: await resolvePluginEntry(root, entry.service), id: entry.id, config: entry.config ?? {}, stateDirectory,
+        onEvent: (message) => Promise.allSettled([...clients.values()].filter((state) => message.clientId === undefined || state.token === message.clientId).map((state) => deliver(state, message))),
+    }) : null;
+    onDispose(() => service?.close());
+    await service?.ready;
+    const disconnect = async (id) => {
+        const state = clients.get(id);
+        if (!state)
+            return;
+        clients.delete(id);
+        for (const request of state.pending.values())
+            request.abort();
+        await service?.request("disconnect", { clientId: state.token }, { timeoutMs: 1000 }).catch(() => { });
+    };
+    return {
+        cancelPending() { for (const state of clients.values())
+            for (const controller of state.pending.values())
+                controller.abort(); },
+        tick() { if (service?.closed)
+            throw new Error("Plugin service exited"); },
+        async renderer(client) {
+            if (service?.closed)
+                throw new Error("Plugin service exited; restart the module");
+            const status = await client.evaluate(`window.__codexPluginLoader?.status(${JSON.stringify(entry.id)})`);
+            if (clients.has(client.target.id) && status?.state !== "active")
+                await disconnect(client.target.id);
+            let state = clients.get(client.target.id);
+            if (!state) {
+                state = { client, token: randomBytes(24).toString("hex"), generation: client.generation, contextId: client.worldContextId, pending: new Map() };
+                clients.set(client.target.id, state);
+            }
+            return state.descriptor ??= { id: entry.id, version: entry.version, instanceId: state.token, expression: buildPluginExpression({
+                    ...entry, source, owner, endpoint: { binding, token: state.token },
+                }) };
+        },
+        bindings: service ? [{ name: binding, async handle(client, params) {
+                    const state = clients.get(client.target.id);
+                    if (!state || state.client !== client || state.generation !== client.generation || typeof params.payload !== "string" || Buffer.byteLength(params.payload) > 65_536)
+                        return;
+                    let request;
+                    try {
+                        request = JSON.parse(params.payload);
+                    }
+                    catch {
+                        return;
+                    }
+                    if (request?.token !== state.token || !Number.isSafeInteger(request.id) || request.id < 1)
+                        return;
+                    if (state.contextId !== undefined && state.contextId !== params.executionContextId)
+                        return;
+                    state.contextId = params.executionContextId;
+                    if (request.type === "cancel") {
+                        state.pending.get(request.id)?.abort();
+                        return;
+                    }
+                    if (request.type !== "call" || !Number.isFinite(request.timeoutMs) || request.timeoutMs < 1 || request.timeoutMs > 30_000 || typeof request.method !== "string" || request.method.length > 128 || state.pending.has(request.id))
+                        return;
+                    if (state.pending.size >= 128) {
+                        await deliver(state, { type: "reply", id: request.id, error: "Too many pending RPC requests" });
+                        return;
+                    }
+                    const controller = new AbortController();
+                    state.pending.set(request.id, controller);
+                    try {
+                        const value = await service.request("call", { method: request.method, payload: request.payload, clientId: state.token }, { signal: controller.signal, timeoutMs: request.timeoutMs });
+                        await deliver(state, { type: "reply", id: request.id, value });
+                    }
+                    catch {
+                        await deliver(state, { type: "reply", id: request.id, error: "Plugin service request failed" });
+                    }
+                    finally {
+                        state.pending.delete(request.id);
+                    }
+                } }] : [],
+        onReady: (client) => service?.request("connect", { clientId: clients.get(client.target.id).token }),
+        onTargetRemoved: disconnect,
+        async dispose() { for (const id of [...clients.keys()])
+            await disconnect(id); },
+    };
+}
+//# sourceMappingURL=module.js.map