dsh-plugin-lcu 0.2.9 → 0.3.0

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.0",
+  "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": {
@@ -37,6 +38,7 @@
   },
   "files": [
     "lib",
+    "helper",
     "cordis.patch.yml",
     "scripts",
     "dev-types",

package/scripts/gen-presets.mjs

@@ -21,7 +21,8 @@
  *   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                # emits daily and heavy
+ *   node scripts/gen-presets.mjs --daily-only   # refuses if the file already has heavy
  *   node scripts/gen-presets.mjs --asar PATH    # override the app.asar path
  *   node scripts/gen-presets.mjs --profile DIR  # override the profile directory
  */
@@ -205,7 +206,11 @@ function renderPreset(spec, basePlugins) {
 function parseArgs(argv) {
   const opts = {
     dryRun: false,
-    withHeavy: false,
+    // Default to the full set: this script ships with dsh-plugin-lcu, and
+    // `heavy` is the preset that attaches it. Defaulting to daily-only meant a
+    // routine re-run after a DSH upgrade silently deleted the preset computer
+    // use depends on.
+    withHeavy: true,
     out: undefined,
     asar: DEFAULT_ASAR,
     profile: DEFAULT_PROFILE,
@@ -214,6 +219,7 @@ function parseArgs(argv) {
     const arg = argv[i]
     if (arg === '--dry-run') opts.dryRun = true
     else if (arg === '--with-heavy') opts.withHeavy = true
+    else if (arg === '--daily-only') opts.withHeavy = false
     else if (arg === '--out') opts.out = argv[++i]
     else if (arg === '--asar') opts.asar = argv[++i]
     else if (arg === '--profile') opts.profile = argv[++i]
@@ -254,6 +260,19 @@ function main() {
   } else {
     const target = opts.out ?? join(opts.profile, 'cordis.patch.yml')
     const before = readFileSync(target, 'utf8')
+    // Never delete a preset this file already had. A re-run is the documented
+    // response to a DSH upgrade, and it must not be able to take away the mode a
+    // user relies on as a side effect of an argument they did not pass.
+    for (const preset of ['daily', 'heavy']) {
+      const had = before.includes(`- id: preset-${preset}`)
+      const keeps = block.includes(`- id: preset-${preset}`)
+      if (had && !keeps) {
+        throw new Error(
+          `${target} already defines preset-${preset} and this run would remove it. `
+          + 'Re-run without --daily-only to keep every preset the file has.',
+        )
+      }
+    }
     writeFileSync(target, spliceBlock(before, block), { mode: 0o600 })
     process.stderr.write(`${verb} ${target}\n`)
   }

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,