@uxnan/shared 0.0.16-alpha.20260919 → 0.0.18-alpha.20260926

package/README.md

@@ -3,7 +3,7 @@
 ![TypeScript](https://img.shields.io/badge/TypeScript-ESM-3178C6?style=for-the-badge&logo=typescript&logoColor=white)
 ![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)
 ![JSON Schema](https://img.shields.io/badge/validation-Ajv-000000?style=for-the-badge&logo=json&logoColor=white)
-![Contracts](https://img.shields.io/badge/70_methods_%7C_12_notifications-blue?style=for-the-badge)
+![Contracts](https://img.shields.io/badge/81_methods_%7C_21_notifications-blue?style=for-the-badge)
 
 Shared JSON-RPC and E2EE contracts for the [Uxnan](../README.md) ecosystem — the
 single source of truth every component agrees on. Consumed as a local workspace
@@ -13,7 +13,7 @@ equivalents (see
 [`architecture/02b-contracts-and-requirements.md`](../architecture/02b-contracts-and-requirements.md)
 §1 for the canonical contract list).
 
-> **Status:** implemented and stable — **70 JSON-RPC methods** + **12 streaming
+> **Status:** implemented and stable — **81 JSON-RPC methods** + **21 streaming
 > notifications**, kept lock-step at build time with the `METHOD_NAMES` array and
 > the `StreamNotification` enum (a compile-time assertion in
 > `src/jsonrpc/method-registry.ts` fails the build on any drift). Changes are
@@ -50,7 +50,10 @@ flowchart TB
 | Area | Exports |
 |---|---|
 | JSON-RPC | envelope types + constructors (`makeRequest`, `makeNotification`, `makeResponse`, `makeErrorResponse`), error codes (`JsonRpcErrorCode` + Uxnan-specific `-32000..-32009`), `RpcError`, typed method registry (`JsonRpcMethodRegistry` + `METHOD_NAMES`), `isKnownMethod` |
-| Streaming | `StreamNotification` enum + param types (`TurnStartedParams`, `MessageDeltaParams`, `ThinkingDeltaParams`, `ContentBlockParams`, `TurnCompletedParams`, `TurnUsage`, `TurnErrorParams`, `TurnAbortedParams`, `ModelResolvedParams`) |
+| Streaming | `StreamNotification` enum + param types (`TurnStartedParams`, `MessageDeltaParams`, `ThinkingDeltaParams`, `ContentBlockParams`, `TurnCompletedParams`, `TurnUsage`, `TurnErrorParams`, `TurnAbortedParams`, `ModelResolvedParams`, and the multi-client set: `ThreadUpdatedParams`, `ThreadDeletedParams`, `TurnCreatedParams`, `ApprovalResolvedParams`, `QuestionResolvedParams`) |
+| Local control | the loopback channel Uxnan Desktop uses on the bridge's machine: `LOCAL_CONTROL_FILE` / `LOCAL_CONTROL_PATH`, `LocalControlDiscovery`, the `LocalControlFrame` union (`hello` + `message`), `isValidLocalClientId`, `localReceiverId` (architecture/02a §5.8.15) |
+| Replica sync | `sync/changes` (`SyncChanges`: revisioned threads, projects, settings, deletions, presence), `BridgeSettings { home }`, `ClientPresence`, `Project` registry fields, `Turn.seq`, `Thread.origin` (`src/models/sync.ts`, architecture/02a §5.8.17) |
+| Agent locations | `agent-locations.json` (package root) + `locateAgent` / `agentLocation`: where every agent CLI installs — the one table the bridge and Uxnan Desktop resolve from |
 | E2EE | handshake messages (`clientHello` / `serverHello` / `clientAuth` / `ready`), `buildHandshakeTranscript`, `SecureEnvelope`, `PairingPayload` v2 (`relay` optional + `hosts: string[]`) with `Base64(utf8(JSON))` QR encoding |
 | Models | thread / turn / message (with `MessageContent` polymorphic blocks), durable `CompactionContentBlock` and `AssistantResponseBoundaryBlock`, git, workspace (incl. `browseDirs` + `exists`), project, auth, session/trust (`BridgeStatus` incl. `latestVersion?`/`updateAvailable?`), bridge-owned profile metrics (complete-ledger export/import), approval, question (interactive multiple-choice) |
 | Agents | `IAgentAdapter` (with `respondApproval`, `listModels`, `nativeSessionId`, `SendTurnOptions { threadId, turnId, text, service?, effort?, options?, attachments?, cwd?, accessMode? }`), `AgentModel` (incl. `version?`, `isDefault?`, `options?`, `contextWindow?`, `isLatestAlias?`), `AgentCapabilities` (incl. `images`, `approvals`, `reportsContextUsage`, `reportsCompaction`), `AgentDescriptor.deprecated`, `AgentConfig` (cwd, agentId, model, plus optional `binaryPath`/`extraArgs`) |

package/agent-locations.json

@@ -0,0 +1,82 @@
+{
+  "$comment": "Where each coding-agent CLI Uxnan drives is installed — the ONE table the bridge (shared/src/agents/agent-locations.ts) and Uxnan Desktop (uxnandesktop/src-tauri/src/agentcli.rs, include_str!) both resolve from, so the phone, the desktop's chat and its terminals agree on what is installed. Tokens: '~' = the user's home, '%APPDATA%' / '%LOCALAPPDATA%' / '%PROGRAMFILES%' = those Windows folders, '$NODE_PREFIX' = the install prefix of the node running the resolver (covers nvm, fnm, volta, Homebrew and any custom npm prefix: global packages live under it). Resolution order per agent: native candidates, then the npm entry under each npm root (run as 'node <entry>'), then the command on PATH (POSIX; on Windows only a real executable counts). architecture/02a §5.8.17.",
+  "npmRoots": {
+    "posix": [
+      "$NODE_PREFIX/lib/node_modules",
+      "/usr/local/lib/node_modules",
+      "/opt/homebrew/lib/node_modules",
+      "~/.npm-global/lib/node_modules"
+    ],
+    "win32": ["$NODE_PREFIX/node_modules", "%APPDATA%/npm/node_modules"]
+  },
+  "pathDirs": {
+    "posix": [
+      "/opt/homebrew/bin",
+      "/opt/homebrew/sbin",
+      "/usr/local/bin",
+      "/usr/local/sbin",
+      "~/.local/bin",
+      "~/.npm-global/bin",
+      "~/.cargo/bin",
+      "~/.bun/bin",
+      "~/.deno/bin",
+      "~/.grok/bin"
+    ],
+    "win32": []
+  },
+  "agents": [
+    {
+      "bridgeId": "claude-code",
+      "desktopId": "claude",
+      "command": "claude",
+      "native": { "posix": ["~/.local/bin/claude"], "win32": ["~/.local/bin/claude.exe"] },
+      "npmEntry": "@anthropic-ai/claude-code/cli.js"
+    },
+    {
+      "bridgeId": "codex",
+      "desktopId": "codex",
+      "command": "codex",
+      "npmEntry": "@openai/codex/bin/codex.js"
+    },
+    {
+      "bridgeId": "opencode",
+      "desktopId": "opencode",
+      "command": "opencode",
+      "native": {
+        "posix": [],
+        "win32": [
+          "%APPDATA%/npm/node_modules/opencode-ai/bin/opencode.exe",
+          "%PROGRAMFILES%/opencode/opencode.exe",
+          "%LOCALAPPDATA%/opencode/opencode.exe"
+        ]
+      }
+    },
+    {
+      "bridgeId": "pi-agent",
+      "desktopId": "pi",
+      "command": "pi",
+      "npmEntry": "@earendil-works/pi-coding-agent/dist/cli.js"
+    },
+    {
+      "bridgeId": "antigravity-cli",
+      "desktopId": "agy",
+      "command": "agy",
+      "native": {
+        "posix": ["~/.local/bin/agy", "~/agy/bin/agy", "/usr/local/bin/agy", "/opt/homebrew/bin/agy"],
+        "win32": ["%LOCALAPPDATA%/agy/bin/agy.exe"]
+      }
+    },
+    {
+      "bridgeId": "grok",
+      "desktopId": "grok",
+      "command": "grok",
+      "native": { "posix": ["~/.grok/bin/grok"], "win32": ["~/.grok/bin/grok.exe"] }
+    },
+    {
+      "bridgeId": "zero",
+      "desktopId": "zero",
+      "command": "zero",
+      "npmEntry": "@gitlawb/zero/bin/zero.js"
+    }
+  ]
+}

package/dist/src/agents/agent-adapter.d.ts

@@ -61,6 +61,20 @@ export interface SendTurnOptions {
      * per-command handling. Absent for an ordinary text turn.
      */
     command?: AgentCommandInvocation;
+    /**
+     * Uxnan Desktop's tools, when the desktop attached them (`desktop/attach`):
+     * its MCP endpoint and the bearer token for bridge-run agents. An adapter that
+     * can register an MCP server for one run does so under
+     * {@link DESKTOP_MCP_SERVER_NAME}, passing the token only through the
+     * environment and the conversation's `cwd` in {@link DESKTOP_CWD_HEADER}.
+     * Absent when no desktop is attached.
+     */
+    desktopTools?: DesktopTools;
+}
+/** What `desktop/attach` gave the bridge (see {@link SendTurnOptions.desktopTools}). */
+export interface DesktopTools {
+    mcpUrl: string;
+    token: string;
 }
 /** Input for {@link IAgentAdapter.generateTitle}. */
 export interface GenerateTitleOptions {
@@ -110,7 +124,8 @@ export interface IAgentAdapter {
      * `activeTurnId` is the bridge turn currently in flight on the thread, so the
      * adapter can address the right run (and refuse if it has already moved on).
      * `turnId` is the queued turn the text came from — it does NOT start a run of
-     * its own; it exists so the bridge can mark it `delivered`.
+     * its own: the bridge makes it the turn that carries the rest of this run,
+     * and keeps naming the run by `activeTurnId` in every call to the adapter.
      *
      * Returns **true only when the agent actually took the message**. Return
      * `false` (don't throw) for an ordinary "too late / not applicable" — the

package/dist/src/agents/agent-capabilities.d.ts

@@ -56,7 +56,8 @@ export interface AgentCapabilities {
      * making it wait for the next one — what a CLI does when you type while it
      * works and it picks the message up at the next tool boundary. The bridge
      * hands such a turn straight to the adapter (`IAgentAdapter.steerTurn`)
-     * rather than holding it, and marks it `delivered` (see `TurnStatus`).
+     * rather than holding it; the turn that was answering ends there and the new
+     * one carries the rest of the agent's run (architecture/02a §5.8.13).
      *
      * Optional; absent/false means the agent has no input channel mid-turn (a
      * one-shot CLI, or a protocol that serializes prompts per session), and its
@@ -83,6 +84,18 @@ export interface AgentDescriptor {
     /** Default model the bridge will use when the phone does not pick one. */
     defaultModel?: string;
 }
+/**
+ * How the bridge found — or failed to find — one agent's CLI, so a client can
+ * say *why* an installed agent shows as unavailable instead of guessing.
+ */
+export interface AgentDiagnosis {
+    agentId: AgentId;
+    available: boolean;
+    /** The command the bridge runs for it (the executable, then any fixed args). */
+    command?: string[];
+    /** Every location checked, in order (files, and `PATH:<dir>` for PATH entries). */
+    checked: string[];
+}
 /** One selectable value of an {@link AgentModelOption} of kind `enum`. */
 export interface AgentModelOptionValue {
     /** Value sent back in `turn/send` `options` when chosen. */
@@ -185,10 +198,12 @@ export interface AgentCommand {
     argumentHint?: string;
     /**
      * Where the command comes from: `acp` (advertised by an ACP agent),
-     * `builtin` (a CLI control command reachable headless), or `custom` (a
-     * user-defined prompt-template file the bridge expands).
+     * `builtin` (one of the CLI's own commands, reachable headless), `custom` (a
+     * user-defined command or prompt template), or `skill` (an agent skill the
+     * CLI invokes by name). A client may group by it; an unknown value is to be
+     * shown as `custom`.
      */
-    source: 'acp' | 'builtin' | 'custom';
+    source: 'acp' | 'builtin' | 'custom' | 'skill';
     /**
      * Whether the command actually runs in the agent's headless/programmatic mode.
      * Absent/true means yes; `false` marks a command that only works in the CLI's

package/dist/src/agents/agent-locations.d.ts

@@ -0,0 +1,61 @@
+export interface AgentLocation {
+    /** The bridge's `AgentId`. */
+    bridgeId: string;
+    /** Uxnan Desktop's backend id (`agentcli::SUPPORTED`). */
+    desktopId: string;
+    /** The launcher name on PATH. */
+    command: string;
+    /** Native executables, checked first, by platform family. */
+    native?: {
+        posix: string[];
+        win32: string[];
+    };
+    /** The npm package's JS entry, relative to an npm root (run as `node <entry>`). */
+    npmEntry?: string;
+}
+export interface AgentLocationTable {
+    npmRoots: {
+        posix: string[];
+        win32: string[];
+    };
+    /** Folders a login PATH normally has that a service's PATH lacks. */
+    pathDirs: {
+        posix: string[];
+        win32: string[];
+    };
+    agents: AgentLocation[];
+}
+/** The shared table (read once from `agent-locations.json`). */
+export declare function agentLocationTable(): AgentLocationTable;
+/** The table entry for a bridge agent id, if Uxnan knows where it installs. */
+export declare function agentLocation(bridgeId: string): AgentLocation | undefined;
+export interface LocateEnvironment {
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    home: string;
+    /** The node executable that would run an npm entry. */
+    nodePath: string;
+    /** Replaces the table's npm roots (tests, which must not see this machine's). */
+    npmRoots?: string[];
+}
+export declare function currentLocateEnvironment(): LocateEnvironment;
+/**
+ * Expand the table's tokens for this machine; `undefined` when a token names
+ * a folder this machine does not have (e.g. `%APPDATA%` off Windows).
+ */
+export declare function expandLocation(path: string, where: LocateEnvironment): string | undefined;
+export interface LocatedAgent {
+    /** What to spawn: the native binary, node (for an npm entry), or the launcher. */
+    binaryPath: string;
+    /** Args before the agent's own (`[entry.js]` for an npm entry). */
+    prependArgs: string[];
+    available: boolean;
+    /** Every location checked, in order (`PATH:<dir>` for PATH entries). */
+    checked: string[];
+}
+/**
+ * Find [location]'s CLI on this machine. [configured] (a user's explicit path)
+ * always wins. On Windows a PATH hit counts only when it is a real executable
+ * (`.exe`/`.com`): an npm `.cmd` shim cannot be spawned without a shell.
+ */
+export declare function locateAgent(location: AgentLocation, configured?: string, where?: LocateEnvironment): LocatedAgent;

package/dist/src/agents/agent-locations.js

@@ -0,0 +1,124 @@
+/**
+ * Where the coding-agent CLIs are installed, and how to find one — the single
+ * rule the bridge and Uxnan Desktop share (architecture/02a §5.8.17).
+ *
+ * The table itself is `agent-locations.json` at this package's root: the
+ * desktop compiles the same file into its Rust resolver (`include_str!`), so
+ * the phone, the desktop's chat and the desktop's terminals can never disagree
+ * about which agents are installed — the disagreement the maintainer hit when
+ * the chat offered agents the desktop knew were missing, and missed ones it
+ * knew were there.
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, dirname, join } from 'node:path';
+let table;
+/** The shared table (read once from `agent-locations.json`). */
+export function agentLocationTable() {
+    // dist/src/agents/agent-locations.js → the package root holds the JSON.
+    table ??= JSON.parse(readFileSync(new URL('../../../agent-locations.json', import.meta.url), 'utf-8'));
+    return table;
+}
+/** The table entry for a bridge agent id, if Uxnan knows where it installs. */
+export function agentLocation(bridgeId) {
+    return agentLocationTable().agents.find((a) => a.bridgeId === bridgeId);
+}
+export function currentLocateEnvironment() {
+    return {
+        platform: process.platform,
+        env: process.env,
+        home: homedir(),
+        nodePath: process.execPath,
+    };
+}
+/**
+ * Expand the table's tokens for this machine; `undefined` when a token names
+ * a folder this machine does not have (e.g. `%APPDATA%` off Windows).
+ */
+export function expandLocation(path, where) {
+    let out = path;
+    if (out === '~' || out.startsWith('~/'))
+        out = join(where.home, out.slice(1));
+    const prefix = nodePrefix(where);
+    out = out.replace('$NODE_PREFIX', prefix);
+    const winVars = {
+        '%APPDATA%': where.env['APPDATA'],
+        '%LOCALAPPDATA%': where.env['LOCALAPPDATA'],
+        '%PROGRAMFILES%': where.env['ProgramFiles'],
+    };
+    for (const [token, value] of Object.entries(winVars)) {
+        if (!out.includes(token))
+            continue;
+        if (!value)
+            return undefined;
+        out = out.replace(token, value);
+    }
+    return join(out);
+}
+/**
+ * The prefix global npm packages of [where.nodePath] live under: `<prefix>/lib/
+ * node_modules` on POSIX (`<prefix>/bin/node`), `<prefix>/node_modules` on
+ * Windows (`<prefix>\node.exe`).
+ */
+function nodePrefix(where) {
+    const bin = dirname(where.nodePath);
+    return where.platform === 'win32' ? bin : dirname(bin);
+}
+function isFile(path) {
+    try {
+        return existsSync(path) && statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find [location]'s CLI on this machine. [configured] (a user's explicit path)
+ * always wins. On Windows a PATH hit counts only when it is a real executable
+ * (`.exe`/`.com`): an npm `.cmd` shim cannot be spawned without a shell.
+ */
+export function locateAgent(location, configured, where = currentLocateEnvironment()) {
+    const checked = [];
+    if (configured && configured.length > 0) {
+        checked.push(configured);
+        return { binaryPath: configured, prependArgs: [], available: isFile(configured), checked };
+    }
+    const family = where.platform === 'win32' ? 'win32' : 'posix';
+    for (const raw of location.native?.[family] ?? []) {
+        const path = expandLocation(raw, where);
+        if (!path)
+            continue;
+        checked.push(path);
+        if (isFile(path))
+            return { binaryPath: path, prependArgs: [], available: true, checked };
+    }
+    if (location.npmEntry) {
+        for (const raw of where.npmRoots ?? agentLocationTable().npmRoots[family]) {
+            const root = expandLocation(raw, where);
+            if (!root)
+                continue;
+            const entry = join(root, location.npmEntry);
+            checked.push(entry);
+            if (isFile(entry)) {
+                return { binaryPath: where.nodePath, prependArgs: [entry], available: true, checked };
+            }
+        }
+    }
+    const names = where.platform === 'win32'
+        ? [`${location.command}.exe`, `${location.command}.com`]
+        : [location.command];
+    const rawPath = where.env['PATH'] ?? where.env['Path'] ?? '';
+    for (const dir of rawPath.split(where.platform === 'win32' ? ';' : delimiter)) {
+        if (!dir)
+            continue;
+        checked.push(`PATH:${dir}`);
+        for (const name of names) {
+            const candidate = join(dir, name);
+            if (isFile(candidate)) {
+                return { binaryPath: candidate, prependArgs: [], available: true, checked };
+            }
+        }
+    }
+    return { binaryPath: location.command, prependArgs: [], available: false, checked };
+}
+//# sourceMappingURL=agent-locations.js.map

package/dist/src/agents/agent-locations.js.map

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

package/dist/src/index.d.ts

@@ -14,17 +14,21 @@ export * from './e2ee/pairing-payload.js';
 export * from './agents/agent-capabilities.js';
 export * from './agents/agent-config.js';
 export * from './agents/agent-adapter.js';
+export * from './agents/agent-locations.js';
+export * from './local-control/local-control.js';
 export * from './version/compare.js';
 export * from './notifications/push-payload.js';
 export * from './models/thread.js';
 export * from './models/git.js';
 export * from './models/workspace.js';
 export * from './models/project.js';
+export * from './models/sync.js';
 export * from './models/session.js';
 export * from './models/approval.js';
 export * from './models/question.js';
 export * from './models/compaction.js';
 export * from './models/assistant-response.js';
+export * from './models/tool.js';
 export * from './models/usage.js';
 export * from './models/metrics.js';
 export * from './validators/validate.js';

package/dist/src/index.js

@@ -17,6 +17,9 @@ export * from './e2ee/pairing-payload.js';
 export * from './agents/agent-capabilities.js';
 export * from './agents/agent-config.js';
 export * from './agents/agent-adapter.js';
+export * from './agents/agent-locations.js';
+// Local control channel (desktop ↔ bridge on the same machine)
+export * from './local-control/local-control.js';
 // Version
 export * from './version/compare.js';
 // Notifications
@@ -26,11 +29,13 @@ export * from './models/thread.js';
 export * from './models/git.js';
 export * from './models/workspace.js';
 export * from './models/project.js';
+export * from './models/sync.js';
 export * from './models/session.js';
 export * from './models/approval.js';
 export * from './models/question.js';
 export * from './models/compaction.js';
 export * from './models/assistant-response.js';
+export * from './models/tool.js';
 export * from './models/usage.js';
 export * from './models/metrics.js';
 // Validators

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAC;AAE/B,WAAW;AACX,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAE3C,OAAO;AACP,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAE1C,SAAS;AACT,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAE1C,UAAU;AACV,cAAc,sBAAsB,CAAC;AAErC,gBAAgB;AAChB,cAAc,iCAAiC,CAAC;AAEhD,SAAS;AACT,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AAEpC,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAC;AAE/B,WAAW;AACX,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAE3C,OAAO;AACP,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAE1C,SAAS;AACT,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAE5C,+DAA+D;AAC/D,cAAc,kCAAkC,CAAC;AAEjD,UAAU;AACV,cAAc,sBAAsB,CAAC;AAErC,gBAAgB;AAChB,cAAc,iCAAiC,CAAC;AAEhD,SAAS;AACT,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AAEpC,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,qCAAqC,CAAC"}

package/dist/src/jsonrpc/method-registry.d.ts

@@ -3,5 +3,5 @@
  * compile-time {@link JsonRpcMethodRegistry} via the assertion below.
  */
 import type { JsonRpcMethodName } from './methods.js';
-export declare const METHOD_NAMES: readonly ["thread/list", "thread/read", "thread/start", "thread/resume", "thread/fork", "thread/setModel", "thread/rename", "thread/setAccessMode", "thread/archive", "thread/unarchive", "thread/delete", "turn/list", "turn/read", "turn/send", "turn/cancel", "queue/resume", "queue/clear", "git/status", "git/diff", "git/commit", "git/push", "git/pull", "git/checkout", "git/createBranch", "git/createWorktree", "git/stage", "git/unstage", "git/discard", "git/createPr", "git/undoCommit", "git/branches", "git/switchBranch", "git/revert", "git/deleteBranch", "git/removeWorktree", "git/worktrees", "git/log", "git/commitShow", "workspace/readFile", "workspace/readImage", "workspace/list", "workspace/searchFiles", "workspace/resolveFileLink", "workspace/browseDirs", "workspace/checkpoint", "workspace/diffCheckpoint", "workspace/applyCheckpoint", "workspace/applyPatch", "workspace/exists", "project/list", "project/resolve", "agent/list", "agent/models", "agent/commands", "agent/usageStats", "metrics/get", "metrics/export", "metrics/import", "auth/status", "auth/login", "auth/logout", "notifications/register", "notifications/update", "notifications/unregister", "bridge/status", "bridge/generatePairingQr", "bridge/connectedPhones", "bridge/disconnectPhone", "bridge/trustedDevices", "bridge/removeTrustedDevice"];
+export declare const METHOD_NAMES: readonly ["thread/list", "thread/read", "thread/start", "thread/resume", "thread/fork", "thread/setModel", "thread/rename", "thread/setAccessMode", "thread/archive", "thread/unarchive", "thread/delete", "turn/list", "turn/read", "turn/send", "turn/cancel", "queue/resume", "queue/clear", "git/status", "git/diff", "git/commit", "git/push", "git/pull", "git/checkout", "git/createBranch", "git/createWorktree", "git/stage", "git/unstage", "git/discard", "git/createPr", "git/undoCommit", "git/branches", "git/switchBranch", "git/revert", "git/deleteBranch", "git/removeWorktree", "git/worktrees", "git/log", "git/commitShow", "workspace/readFile", "workspace/readImage", "workspace/list", "workspace/searchFiles", "workspace/resolveFileLink", "workspace/browseDirs", "workspace/checkpoint", "workspace/diffCheckpoint", "workspace/applyCheckpoint", "workspace/applyPatch", "workspace/exists", "project/list", "project/resolve", "project/add", "project/remove", "project/rename", "sync/changes", "settings/get", "settings/set", "device/describe", "device/rename", "agent/list", "agent/models", "agent/commands", "agent/usageStats", "agent/doctor", "metrics/get", "metrics/export", "metrics/import", "auth/status", "auth/login", "auth/logout", "notifications/register", "notifications/update", "notifications/unregister", "bridge/status", "bridge/generatePairingQr", "bridge/connectedPhones", "bridge/disconnectPhone", "bridge/trustedDevices", "bridge/removeTrustedDevice", "desktop/attach", "desktop/detach"];
 export declare function isKnownMethod(method: string): method is JsonRpcMethodName;

package/dist/src/jsonrpc/method-registry.js

@@ -55,11 +55,21 @@ export const METHOD_NAMES = [
     // Projects
     'project/list',
     'project/resolve',
+    'project/add',
+    'project/remove',
+    'project/rename',
+    // Replica sync and shared settings
+    'sync/changes',
+    'settings/get',
+    'settings/set',
+    'device/describe',
+    'device/rename',
     // Agents
     'agent/list',
     'agent/models',
     'agent/commands',
     'agent/usageStats',
+    'agent/doctor',
     // Metrics (bridge-owned, survivable profile stats + tamper-proof backup)
     'metrics/get',
     'metrics/export',
@@ -79,6 +89,9 @@ export const METHOD_NAMES = [
     'bridge/disconnectPhone',
     'bridge/trustedDevices',
     'bridge/removeTrustedDevice',
+    // Desktop tools for bridge-run agents (local control channel only)
+    'desktop/attach',
+    'desktop/detach',
 ];
 const _assertNamesAreMethods = true;
 const _assertMethodsAreNames = true;

package/dist/src/jsonrpc/method-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"method-registry.js","sourceRoot":"","sources":["../../../src/jsonrpc/method-registry.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,cAAc;IACd,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,sBAAsB;IACtB,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;IACf,WAAW;IACX,WAAW;IACX,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,MAAM;IACN,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,UAAU;IACV,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,oBAAoB;IACpB,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,kBAAkB;IAClB,oBAAoB;IACpB,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,gBAAgB;IAChB,uBAAuB;IACvB,2BAA2B;IAC3B,sBAAsB;IACtB,sBAAsB;IACtB,0BAA0B;IAC1B,2BAA2B;IAC3B,sBAAsB;IACtB,kBAAkB;IAClB,WAAW;IACX,cAAc;IACd,iBAAiB;IACjB,SAAS;IACT,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,yEAAyE;IACzE,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,OAAO;IACP,aAAa;IACb,YAAY;IACZ,aAAa;IACb,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,0BAA0B;IAC1B,iBAAiB;IACjB,eAAe;IACf,0BAA0B;IAC1B,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,4BAA4B;CACpB,CAAC;AAQX,MAAM,sBAAsB,GAAqB,IAAI,CAAC;AACtD,MAAM,sBAAsB,GAAqB,IAAI,CAAC;AACtD,KAAK,sBAAsB,CAAC;AAC5B,KAAK,sBAAsB,CAAC;AAE5B,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;AAEnE,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"method-registry.js","sourceRoot":"","sources":["../../../src/jsonrpc/method-registry.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,cAAc;IACd,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,sBAAsB;IACtB,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;IACf,WAAW;IACX,WAAW;IACX,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,MAAM;IACN,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,UAAU;IACV,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,oBAAoB;IACpB,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,kBAAkB;IAClB,oBAAoB;IACpB,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,gBAAgB;IAChB,uBAAuB;IACvB,2BAA2B;IAC3B,sBAAsB;IACtB,sBAAsB;IACtB,0BAA0B;IAC1B,2BAA2B;IAC3B,sBAAsB;IACtB,kBAAkB;IAClB,WAAW;IACX,cAAc;IACd,iBAAiB;IACjB,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,mCAAmC;IACnC,cAAc;IACd,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,cAAc;IACd,yEAAyE;IACzE,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,OAAO;IACP,aAAa;IACb,YAAY;IACZ,aAAa;IACb,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,0BAA0B;IAC1B,iBAAiB;IACjB,eAAe;IACf,0BAA0B;IAC1B,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;IACvB,4BAA4B;IAC5B,mEAAmE;IACnE,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAQX,MAAM,sBAAsB,GAAqB,IAAI,CAAC;AACtD,MAAM,sBAAsB,GAAqB,IAAI,CAAC;AACtD,KAAK,sBAAsB,CAAC;AAC5B,KAAK,sBAAsB,CAAC;AAE5B,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;AAEnE,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}