dsh-plugin-lcu 0.2.9 → 0.3.4

package/lib/types/index.d.ts

@@ -2,7 +2,7 @@
  * `dsh-plugin-lcu` — drive the desktop and Chrome from DeepSeek Harness.
  *
  * The plugin is one root-scoped row. It does not open anything at load time:
- * LCU (and the CUA runtime behind it) starts only for an Agent whose preset is
+ * The runtime starts only for an Agent whose preset is
  * listed in `presets`, and stops when that Agent is disposed. That keeps a
  * heavy, permission-bearing capability off every session that does not need it.
  *
@@ -19,11 +19,23 @@ export declare const name = "lcu";
 export declare const inject: string[];
 /** Plugin configuration. */
 export interface Config {
-    /** LCU launcher; defaults to the installed path, overridable for a custom prefix. */
+    /**
+     * The ChatGPT application whose runtime provides computer use.
+     *
+     * Defaults to the standard installation. The plugin launches the runtime from
+     * inside this application directly — it does not go through a wrapper.
+     */
+    app?: string;
+    /**
+     * An explicit executable replacing the computed launch, for an unusual install.
+     *
+     * Set this only when the application is somewhere the built-in resolution
+     * cannot reach; it bypasses the runtime's own environment setup.
+     */
     command?: string;
-    /** Enable the Chrome surface (`lcu --chrome`); needs the extension and site approvals. */
+    /** Enable the runtime's browser surface; needs the official browser extension and site approvals. */
     chrome?: boolean;
-    /** Enable the original computer-audio recording API (`lcu --audio`). */
+    /** Enable the runtime's computer-audio recording API. */
     audio?: boolean;
     /**
      * Agent preset ids whose sessions get the tools.
@@ -35,11 +47,19 @@ export interface Config {
     presets?: string[];
     /** Exact HTTP(S) origins pre-approved for browser access, never widened. */
     allowedOrigins?: string[];
-    /** Prompt section order for the injected LCU instructions. */
+    /**
+     * Bundle identifiers computer use may use without asking.
+     *
+     * The runtime asks before it first uses each application, and an unanswered
+     * question is a refusal, so an unattended run needs its targets listed here.
+     * The application hosting the agent can never be admitted this way.
+     */
+    allowedApps?: string[];
+    /** Prompt section order for the injected runtime instructions. */
     sectionOrder?: number;
 }
 /**
- * Mount the LCU capability.
+ * Mount the computer-use capability.
  *
  * @param ctx - the host context this row mounts into.
  * @param config - the row's configuration.

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EAC+C,kBAAkB,EAEvE,MAAM,iBAAiB,CAAA;AAOxB,eAAO,MAAM,IAAI,QAAQ,CAAA;AACzB,eAAO,MAAM,MAAM,UAA4B,CAAA;AA2B/C,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA2BD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgSxD;AAYD,OAAO,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAQlD,OAAO,EAC+C,kBAAkB,EAEvE,MAAM,iBAAiB,CAAA;AAUxB,eAAO,MAAM,IAAI,QAAQ,CAAA;AACzB,eAAO,MAAM,MAAM,UAA4B,CAAA;AAyB/C,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA8BD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAyWxD;AAYD,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/lib/types/session.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The connection an Agent's tools talk to.
+ *
+ * The runtime is executed from files inside the ChatGPT application, and the
+ * application replaces those files when it updates. A session that stays
+ * connected across an update therefore runs a mix of two generations — the
+ * runtime it started with and the modules a later `import` resolves from the new
+ * bundle — and the failure that follows is not obvious from the outside.
+ *
+ * This is a thin facade rather than a fix inside the connection: the tools close
+ * over one object for the life of the Agent, so that object has to be able to
+ * become a different connection. Before every call it compares the application's
+ * fingerprint, and when it changed it opens a new connection and retires the old
+ * one, so all later calls come from a single generation.
+ *
+ * @module dsh-plugin-lcu/session
+ */
+import type { LcuConnection } from './connection.ts';
+/**
+ * What the tools need from a connection.
+ *
+ * Written as indexed access types rather than restated signatures, so a change to
+ * the connection cannot leave this out of date.
+ */
+export interface RuntimeConnection {
+    sessionId: string | undefined;
+    modelTools: LcuConnection['modelTools'];
+    readonly hasHostControl: boolean;
+    callTool: LcuConnection['callTool'];
+    turnEnded: LcuConnection['turnEnded'];
+    controlStatus: LcuConnection['controlStatus'];
+    controlStop: LcuConnection['controlStop'];
+    close: LcuConnection['close'];
+}
+/** How the session opens a connection, and how it notices the application moved. */
+export interface ManagedSessionOptions {
+    /**
+     * Open a fresh connection.
+     *
+     * @param reason - whether this is the first connection or a replacement.
+     */
+    connect: (reason: 'initial' | 'regenerated') => Promise<LcuConnection>;
+    /**
+     * The application's current fingerprint.
+     *
+     * Called before every call, so it must stay cheap: it reads two file
+     * timestamps. It may throw, which is treated as "the application moved" and
+     * lets the reconnect report the real error.
+     */
+    generation: () => string;
+    /** Called after a successful replacement, for the diagnostic log. */
+    onRegenerated?: (transition: {
+        readonly from: string;
+        readonly to: string;
+    }) => void;
+    /** Called when a replacement fails. The previous connection stays in use. */
+    onRegenerateFailed?: (error: unknown) => void;
+    /**
+     * Called when the fingerprint cannot be read at all.
+     *
+     * A fingerprint that cannot be read is **not** evidence that anything changed,
+     * and opening a second runtime because of a transient read failure is worse
+     * than waiting: the next call checks again.
+     */
+    onGenerationUnreadable?: (error: unknown) => void;
+}
+/** A connection that follows the application across an update. */
+export declare class ManagedSession implements RuntimeConnection {
+    #private;
+    private constructor();
+    /**
+     * Open the first connection.
+     *
+     * @param options - how to connect and how to notice a change.
+     * @returns the session, already connected.
+     */
+    static open(options: ManagedSessionOptions): Promise<ManagedSession>;
+    get sessionId(): string | undefined;
+    set sessionId(value: string | undefined);
+    get hasHostControl(): boolean;
+    modelTools(): ReturnType<LcuConnection['modelTools']>;
+    callTool(...args: Parameters<LcuConnection['callTool']>): ReturnType<LcuConnection['callTool']>;
+    turnEnded(...args: Parameters<LcuConnection['turnEnded']>): ReturnType<LcuConnection['turnEnded']>;
+    controlStatus(...args: Parameters<LcuConnection['controlStatus']>): ReturnType<LcuConnection['controlStatus']>;
+    controlStop(...args: Parameters<LcuConnection['controlStop']>): ReturnType<LcuConnection['controlStop']>;
+    /** Retire the connection. Later calls fail rather than opening a new runtime. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/lib/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IACnC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;IACrC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC7C,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACzC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IACtE;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,MAAM,CAAA;IACxB,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACpF,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAClD;AAED,kEAAkE;AAClE,qBAAa,cAAe,YAAW,iBAAiB;;IAgBtD,OAAO;IAMP;;;;;OAKG;WACU,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAc1E,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAGtC;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,UAAU,IAAI,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IA2C/C,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAK/F,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,GAAG,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAKlG,aAAa,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,GAAG,UAAU,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IAK9G,WAAW,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAK9G,iFAAiF;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/lib/types/tool.d.ts

@@ -12,7 +12,8 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
-import type { LcuConnection, LcuContentBlock, LcuTool } from './connection.ts';
+import type { LcuContentBlock, LcuTool } from './connection.ts';
+import type { RuntimeConnection } from './session.ts';
 interface ImageBlock {
     readonly type: 'image';
     readonly data: string;
@@ -96,7 +97,7 @@ export declare function stuckStopHint(text: string): string | undefined;
  * @param options - host hooks around the call.
  * @returns a registrable tool definition.
  */
-export declare function createLcuTool(descriptor: LcuTool, connection: LcuConnection, ctx: Context, options?: LcuToolOptions): ToolDefinition;
+export declare function createLcuTool(descriptor: LcuTool, connection: RuntimeConnection, ctx: Context, options?: LcuToolOptions): ToolDefinition;
 /**
  * Build every model-facing tool for one agent's connection.
  *
@@ -105,7 +106,7 @@ export declare function createLcuTool(descriptor: LcuTool, connection: LcuConnec
  * @returns tool definitions for `js` and `js_reset`, in server order.
  * @throws {LcuError} when the server does not expose the model tools.
  */
-export declare function buildLcuTools(connection: LcuConnection, ctx: Context, options?: LcuToolOptions): ToolDefinition[];
+export declare function buildLcuTools(connection: RuntimeConnection, ctx: Context, options?: LcuToolOptions): ToolDefinition[];
 /**
  * The explicit per-app release, which LCU exposes to a host rather than to the
  * model.
@@ -119,7 +120,7 @@ export declare function buildLcuTools(connection: LcuConnection, ctx: Context, o
  * @param currentTurn - resolves the agent's active turn, or `undefined` outside one.
  * @returns a registrable tool definition.
  */
-export declare function createComputerUseStopTool(connection: LcuConnection, currentTurn: () => string | undefined): ToolDefinition;
+export declare function createComputerUseStopTool(connection: RuntimeConnection, currentTurn: () => string | undefined): ToolDefinition;
 /**
  * Register the model-facing tools in one agent's scope.
  *
@@ -132,6 +133,6 @@ export declare function createComputerUseStopTool(connection: LcuConnection, cur
  * @param ctx - the plugin context.
  * @returns a disposer that unregisters every tool.
  */
-export declare function registerLcuTools(agentCtx: Context, connection: LcuConnection, ctx: Context, options?: LcuToolOptions): () => void;
+export declare function registerLcuTools(agentCtx: Context, connection: RuntimeConnection, ctx: Context, options?: LcuToolOptions): () => void;
 export {};
 //# sourceMappingURL=tool.d.ts.map

package/lib/types/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,cAAc,EAAsD,MAAM,wBAAwB,CAAA;AAEhH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAU9E,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQlF;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AA2GD,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO5E;AAWD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtE;AAcD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,aAAa,EACzB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B,cAAc,CA+DhB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,aAAa,EACzB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B,cAAc,EAAE,CAOlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,aAAa,EACzB,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,GACpC,cAAc,CAiEhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,aAAa,EACzB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B,MAAM,IAAI,CASZ"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,cAAc,EAAsD,MAAM,wBAAwB,CAAA;AAEhH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAUrD,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQlF;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AA2GD,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO5E;AAWD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtE;AAcD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,iBAAiB,EAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B,cAAc,CA+DhB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,iBAAiB,EAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B,cAAc,EAAE,CAOlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,GACpC,cAAc,CAsEhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,iBAAiB,EAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B,MAAM,IAAI,CASZ"}

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "dsh-plugin-lcu",
-  "version": "0.2.9",
-  "description": "Drive the desktop and Chrome from DeepSeek Harness through LCU (Codex computer use, decoupled from the app).",
+  "version": "0.3.4",
+  "description": "Drive the desktop and Chrome from DeepSeek Harness using the computer-use runtime inside the ChatGPT desktop application.",
   "keywords": [
     "dsh-plugin",
     "deepseek-harness",
     "dsh",
     "computer-use",
     "browser-use",
-    "lcu",
-    "codex",
-    "cua"
+    "cua",
+    "chatgpt",
+    "desktop-automation",
+    "macos"
   ],
   "license": "MIT",
   "author": {
@@ -36,7 +37,9 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "CHANGELOG.md",
     "lib",
+    "helper",
     "cordis.patch.yml",
     "scripts",
     "dev-types",
@@ -58,7 +61,6 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "node --test \"tests/*.spec.ts\"",
     "prepare": "npm run build",
-    "presets": "node scripts/gen-presets.mjs",
     "probe": "node scripts/probe-lcu.mjs",
     "update-codex": "node scripts/update-codex.mjs"
   },

package/scripts/probe-lcu.mjs

@@ -1,37 +1,45 @@
 #!/usr/bin/env node
 /**
- * probe-lcu.mjs — talk to the installed `lcu` MCP server directly.
+ * probe-lcu.mjs — talk to the computer-use runtime directly.
  *
- * A diagnostic for `dsh-plugin-lcu` development: it connects the way the plugin
- * will (newline-delimited JSON-RPC over stdio, `capabilities.elicitation`
- * declared), prints what the server advertises, and optionally calls one tool.
+ * A diagnostic for `dsh-plugin-lcu` development: it builds the same launch plan
+ * the plugin builds, connects the way the plugin does (newline-delimited
+ * JSON-RPC over stdio, `capabilities.elicitation` declared), prints what the
+ * server advertises, and optionally calls one tool. No harness is involved, so
+ * this separates a plugin problem from a runtime problem.
  *
  * Usage
  * -----
- *   node scripts/probe-lcu.mjs                    # initialize + tools/list
- *   node scripts/probe-lcu.mjs --instructions      # also dump server instructions
- *   node scripts/probe-lcu.mjs --call js --code 'return await cua.listApps()'
- *   node scripts/probe-lcu.mjs --command /path/to/lcu   # override the binary
+ *   node scripts/probe-lcu.mjs                          # initialize + tools/list
+ *   node scripts/probe-lcu.mjs --instructions           # also dump server instructions
+ *   node scripts/probe-lcu.mjs --call js --code 'await cua.getState();'
+ *   node scripts/probe-lcu.mjs --chrome                 # enable the browser surface
+ *   node scripts/probe-lcu.mjs --app /path/ChatGPT.app  # a different installation
+ *   node scripts/probe-lcu.mjs --command /path/binary   # bypass the computed launch
  *
  * It never answers elicitations, so any call that needs an approval fails closed
  * exactly like a host that cannot present the request.
  */
 
 import { spawn } from 'node:child_process'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
 import { createInterface } from 'node:readline'
 
-const DEFAULT_COMMAND = join(homedir(), '.local/share/lcu/current/bin/lcu')
+import { planLaunch } from '../lib/app.js'
 
 /** Newest protocol revision the MCP SDK pair here is expected to negotiate. */
 const PROTOCOL_VERSION = '2025-06-18'
 
 function parseArgs(argv) {
-  const opts = { command: DEFAULT_COMMAND, instructions: false, call: undefined, code: undefined, limit: 2000 }
+  const opts = {
+    app: undefined, command: undefined, chrome: false, audio: false,
+    instructions: false, call: undefined, code: undefined, limit: 2000,
+  }
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i]
-    if (arg === '--command') opts.command = argv[++i]
+    if (arg === '--app') opts.app = argv[++i]
+    else if (arg === '--command') opts.command = argv[++i]
+    else if (arg === '--chrome') opts.chrome = true
+    else if (arg === '--audio') opts.audio = true
     else if (arg === '--instructions') opts.instructions = true
     else if (arg === '--call') opts.call = argv[++i]
     else if (arg === '--code') opts.code = argv[++i]
@@ -41,17 +49,17 @@ function parseArgs(argv) {
   return opts
 }
 
-/** One request/response session with the LCU MCP server. */
+/** One request/response session with the computer-use runtime. */
 class LcuSession {
-  constructor(command) {
+  constructor(plan) {
     this.nextId = 1
     this.pending = new Map()
     this.notifications = []
     this.stderr = ''
-    this.child = spawn(command, [], { stdio: ['pipe', 'pipe', 'pipe'], env: process.env })
+    this.child = spawn(plan.command, [...plan.args], { stdio: ['pipe', 'pipe', 'pipe'], env: plan.env })
     this.child.stderr.on('data', (chunk) => { this.stderr += chunk.toString() })
     this.child.on('exit', (code) => {
-      for (const { reject } of this.pending.values()) reject(new Error(`lcu exited (${code})\n${this.stderr.slice(-800)}`))
+      for (const { reject } of this.pending.values()) reject(new Error(`the runtime exited (${code})\n${this.stderr.slice(-800)}`))
       this.pending.clear()
     })
     createInterface({ input: this.child.stdout }).on('line', (line) => this.#onLine(line))
@@ -96,7 +104,21 @@ class LcuSession {
 
 async function main() {
   const opts = parseArgs(process.argv.slice(2))
-  const session = new LcuSession(opts.command)
+  const plan = planLaunch({
+    ...(opts.app === undefined ? {} : { appPath: opts.app }),
+    ...(opts.command === undefined ? {} : { command: opts.command }),
+    chrome: opts.chrome,
+    audio: opts.audio,
+    identity: 'dsh-plugin-lcu-probe',
+  })
+  console.log('=== launch plan ===')
+  console.log(`  app:      ${plan.paths.app}`)
+  console.log(`  version:  ${plan.paths.version}`)
+  console.log(`  runtime:  ${plan.paths.runtimeVersion}`)
+  console.log(`  command:  ${plan.command}`)
+  console.log(`  args:     ${JSON.stringify(plan.args)}`)
+  console.log(`  surfaces: ${String(plan.env.CUA_REPL_ENABLED_SURFACES)}`)
+  const session = new LcuSession(plan)
   try {
     const initialized = await session.request('initialize', {
       protocolVersion: PROTOCOL_VERSION,

package/scripts/gen-presets.mjs

@@ -1,266 +0,0 @@
-#!/usr/bin/env node
-/**
- * gen-presets.mjs — derive DSH agent presets from the installed `ptc` preset.
- *
- * Why this exists
- * ---------------
- * DSH agent presets have **no inheritance** (`config.plugins` is a complete
- * child-plugin list) and `cordis.patch.yml` patches **replace** a whole entry's
- * config rather than deep-merging it. So a custom preset has to restate the full
- * plugin list of whatever it is based on. This script reads that base list
- * straight out of the *installed* app and regenerates our preset rows, so a DSH
- * upgrade is one re-run instead of a hand merge.
- *
- * It is deliberately dependency-free (plain Node, no YAML library): the base
- * file is copied line-for-line and only surgically edited, and every expected
- * edit is asserted — if a DSH upgrade changes the shape, this script fails loudly
- * instead of emitting a subtly wrong preset.
- *
- * Usage
- * -----
- *   node scripts/gen-presets.mjs                # write into the desktop profile patch
- *   node scripts/gen-presets.mjs --dry-run      # print, write nothing
- *   node scripts/gen-presets.mjs --out FILE     # write to FILE instead
- *   node scripts/gen-presets.mjs --with-heavy   # also emit preset-heavy (needs dsh-plugin-lcu)
- *   node scripts/gen-presets.mjs --asar PATH    # override the app.asar path
- *   node scripts/gen-presets.mjs --profile DIR  # override the profile directory
- */
-
-import { closeSync, openSync, readFileSync, readSync, writeFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
-
-// ---------------------------------------------------------------------------
-// Defaults
-// ---------------------------------------------------------------------------
-
-const DEFAULT_ASAR =
-  '/Applications/DeepSeek Harness.app/Contents/Resources/app.asar'
-const BASE_PRESET = 'dsh/node_modules/@deepseek-ai/dsh-web-app/presets/ptc.patch.yml'
-const DEFAULT_PROFILE = join(homedir(), '.dsh', 'profiles', 'desktop')
-
-const BEGIN = '# >>> BEGIN generated presets (scripts/gen-presets.mjs) >>>'
-const END = '# <<< END generated presets <<<'
-
-/** The two presets this script owns. `daily` is a faithful PTC + Codex; `heavy`
- * flips the tool presentation to `both` so LCU's `js` is callable natively
- * instead of being nested inside a `run_code` program. */
-const PRESETS = {
-  daily: {
-    id: 'daily',
-    name: '日常',
-    description: '日常编码：PTC 程序化工具调用 + Codex 委派',
-    order: 5,
-    presentation: null, // keep the base's `ptc`
-    enable: ['tool-subagent-codex'],
-    append: [],
-  },
-  heavy: {
-    id: 'heavy',
-    name: '重活',
-    description: '超前/困难的重活：需要 Computer 或 Browser 时用',
-    order: 6,
-    // `both` so LCU's `js` stays callable natively: in pure `ptc` presentation
-    // the model would have to nest a whole CUA program inside a run_code string.
-    // No tool row is added here — `dsh-plugin-lcu` is mounted at the root and
-    // registers its tools per Agent by checking this preset's id.
-    presentation: 'both',
-    enable: ['tool-subagent-codex'],
-    append: [],
-  },
-}
-
-// ---------------------------------------------------------------------------
-// Minimal asar reader (Electron's asar is a simple header + flat blob)
-// ---------------------------------------------------------------------------
-
-/**
- * Read one file out of an asar archive without Electron.
- * @param asarPath - absolute path to the `.asar` file
- * @param innerPath - slash-separated path inside the archive
- * @returns the file contents
- */
-function readAsarFile(asarPath, innerPath) {
-  const fd = openSync(asarPath, 'r')
-  try {
-    const head = Buffer.alloc(16)
-    readSync(fd, head, 0, 16, 0)
-    const baseOffset = 8 + head.readUInt32LE(4)
-    const jsonSize = head.readUInt32LE(12)
-    const json = Buffer.alloc(jsonSize)
-    readSync(fd, json, 0, jsonSize, 16)
-    let node = JSON.parse(json.toString('utf8'))
-    for (const segment of innerPath.split('/').filter(Boolean)) {
-      node = node.files?.[segment]
-      if (node === undefined) throw new Error(`not in archive: ${innerPath}`)
-    }
-    if (node.files !== undefined) throw new Error(`is a directory: ${innerPath}`)
-    const buf = Buffer.alloc(node.size)
-    readSync(fd, buf, 0, node.size, baseOffset + Number(node.offset))
-    return buf
-  } finally {
-    closeSync(fd)
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Line surgery
-// ---------------------------------------------------------------------------
-
-/** Indentation (0-based column of the first non-space char); -1 for blank lines. */
-const indentOf = (line) => (line.trim() === '' ? -1 : line.search(/\S/))
-
-/** Index of the child row `- id: <rowId>` inside a plugin list. */
-function findRow(lines, rowId) {
-  const index = lines.findIndex((line) => line.trim().startsWith(`- id: ${rowId}`))
-  if (index < 0) throw new Error(`plugin row not found: ${rowId}`)
-  return index
-}
-
-/**
- * Iterate the direct/indirect body lines of the row starting at `start`,
- * stopping at the next row or any line dedented to the row's own level.
- */
-function* body(lines, start) {
-  const base = indentOf(lines[start])
-  for (let i = start + 1; i < lines.length; i += 1) {
-    const ind = indentOf(lines[i])
-    if (ind === -1) continue
-    if (ind <= base) return
-    yield i
-  }
-}
-
-/**
- * Remove `disabled: true` from one row, turning it on.
- * @returns a new line array
- */
-function enableRow(lines, rowId) {
-  const start = findRow(lines, rowId)
-  for (const i of body(lines, start)) {
-    if (lines[i].trim().startsWith('disabled:')) {
-      return lines.filter((_, k) => k !== i)
-    }
-  }
-  return lines // already enabled — idempotent
-}
-
-/** Rewrite `mode:` inside the `tool-presentation` row. */
-function setPresentationMode(lines, mode) {
-  const start = findRow(lines, 'tool-presentation')
-  for (const i of body(lines, start)) {
-    if (/^\s*mode:\s*\S+\s*$/.test(lines[i])) {
-      const next = [...lines]
-      next[i] = lines[i].replace(/mode:\s*\S+\s*$/, `mode: ${mode}`)
-      return next
-    }
-  }
-  throw new Error('tool-presentation row has no `mode:` field')
-}
-
-/** Extract the `plugins:` sub-tree (the row list) from a preset patch file. */
-function extractPlugins(lines) {
-  const index = lines.findIndex((line) => /^\s*plugins:\s*$/.test(line))
-  if (index < 0) throw new Error('base preset has no `plugins:` key')
-  const base = indentOf(lines[index])
-  const out = []
-  for (let i = index + 1; i < lines.length; i += 1) {
-    const ind = indentOf(lines[i])
-    if (ind !== -1 && ind <= base) break
-    out.push(lines[i])
-  }
-  if (out.every((line) => line.trim() === '')) throw new Error('base `plugins:` is empty')
-  while (out.length > 0 && out[out.length - 1].trim() === '') out.pop()
-  return out
-}
-
-// ---------------------------------------------------------------------------
-// Preset rendering
-// ---------------------------------------------------------------------------
-
-function renderPreset(spec, basePlugins) {
-  const plugins = spec.enable.reduce(enableRow, [...basePlugins])
-  const withMode = spec.presentation === null
-    ? plugins
-    : setPresentationMode(plugins, spec.presentation)
-  const out = [
-    `    - id: preset-${spec.id}`,
-    "      name: '@deepseek-ai/dsh-agent-preset'",
-    '      config:',
-    `        id: ${spec.id}`,
-    `        name: '${spec.name}'`,
-    `        description: '${spec.description}'`,
-    `        order: ${spec.order}`,
-    '        plugins:',
-    ...withMode,
-    ...spec.append,
-  ]
-  return out
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-function parseArgs(argv) {
-  const opts = {
-    dryRun: false,
-    withHeavy: false,
-    out: undefined,
-    asar: DEFAULT_ASAR,
-    profile: DEFAULT_PROFILE,
-  }
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i]
-    if (arg === '--dry-run') opts.dryRun = true
-    else if (arg === '--with-heavy') opts.withHeavy = true
-    else if (arg === '--out') opts.out = argv[++i]
-    else if (arg === '--asar') opts.asar = argv[++i]
-    else if (arg === '--profile') opts.profile = argv[++i]
-    else throw new Error(`unknown argument: ${arg}`)
-  }
-  return opts
-}
-
-function buildBlock(baseLines, { withHeavy }) {
-  const basePlugins = extractPlugins(baseLines)
-  const specs = withHeavy ? [PRESETS.daily, PRESETS.heavy] : [PRESETS.daily]
-  const lines = [BEGIN, '- insert:']
-  for (const spec of specs) lines.push(...renderPreset(spec, basePlugins))
-  lines.push(END)
-  return { block: lines.join('\n'), basePlugins, specs }
-}
-
-/** Replace the marked block in place, or append one. */
-function spliceBlock(text, block) {
-  const begin = text.indexOf(BEGIN)
-  const end = text.indexOf(END)
-  if (begin >= 0 && end > begin) {
-    return text.slice(0, begin) + block + text.slice(end + END.length)
-  }
-  const separator = text.endsWith('\n') ? '\n' : '\n\n'
-  return `${text}${separator}${block}\n`
-}
-
-function main() {
-  const opts = parseArgs(process.argv.slice(2))
-  const baseLines = readAsarFile(opts.asar, BASE_PRESET).toString('utf8').split('\n')
-  const { block, basePlugins, specs } = buildBlock(baseLines, opts)
-  const verb = opts.dryRun ? 'would write' : 'wrote'
-  const rowCount = basePlugins.filter((line) => /^\s*- id: /.test(line)).length
-
-  if (opts.dryRun) {
-    process.stdout.write(`${block}\n`)
-  } else {
-    const target = opts.out ?? join(opts.profile, 'cordis.patch.yml')
-    const before = readFileSync(target, 'utf8')
-    writeFileSync(target, spliceBlock(before, block), { mode: 0o600 })
-    process.stderr.write(`${verb} ${target}\n`)
-  }
-  process.stderr.write(
-    `base: ${BASE_PRESET} (${rowCount} top-level rows)\n`
-    + `presets: ${specs.map((s) => s.id).join(', ')}\n`,
-  )
-}
-
-main()