toc-ocra 0.2.0

package/dist/src/shared/node-cli-command-resolution.js

@@ -0,0 +1,173 @@
+import { accessSync, constants, existsSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, dirname, join } from 'node:path';
+function getExecutableNames(platform, commandName) {
+    if (platform === 'win32') {
+        return [`${commandName}.cmd`, `${commandName}.exe`, `${commandName}.bat`, commandName];
+    }
+    return [commandName];
+}
+function splitPath(pathEnv) {
+    if (!pathEnv) {
+        return [];
+    }
+    return pathEnv
+        .split(delimiter)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+function parseVersionSegment(raw) {
+    return raw
+        .replace(/^v/i, '')
+        .split('.')
+        .map((segment) => Number.parseInt(segment, 10))
+        .map((segment) => (Number.isFinite(segment) ? segment : 0));
+}
+function compareVersionDesc(left, right) {
+    const leftParts = parseVersionSegment(left);
+    const rightParts = parseVersionSegment(right);
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let index = 0; index < length; index += 1) {
+        const delta = (rightParts[index] ?? 0) - (leftParts[index] ?? 0);
+        if (delta !== 0) {
+            return delta;
+        }
+    }
+    return right.localeCompare(left);
+}
+function findFirstExecutable(platform, directories, executableNames) {
+    for (const directory of directories) {
+        for (const executableName of executableNames) {
+            const candidate = join(directory, executableName);
+            if (isRunnableCommand(platform, candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+function isRunnableCommand(platform, candidate) {
+    try {
+        const stats = statSync(candidate);
+        if (!stats.isFile()) {
+            return false;
+        }
+        if (platform === 'win32') {
+            return true;
+        }
+        // Why: GUI fallback probing should skip placeholders/directories so spawn
+        // can continue to a runnable CLI instead of failing later with EACCES/EISDIR.
+        accessSync(candidate, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getBaseVersionManagerDirectories(platform, homePath) {
+    const directories = [
+        join(homePath, '.volta', 'bin'),
+        join(homePath, '.asdf', 'shims'),
+        join(homePath, '.fnm', 'aliases', 'default', 'bin'),
+        // Why: mise (formerly rtx) exposes managed tool binaries via a shims
+        // directory, similar to asdf.
+        join(homePath, '.local', 'share', 'mise', 'shims')
+    ];
+    if (platform === 'win32') {
+        // Why: Anthropic's native Windows installer places claude.exe here, and
+        // GUI-launched Orca may not inherit the user's PATH entry for it.
+        directories.push(join(homePath, '.local', 'bin'));
+        directories.push(join(homePath, 'AppData', 'Roaming', 'npm'));
+        directories.push(join(homePath, 'AppData', 'Local', 'pnpm'));
+        directories.push(join(homePath, 'AppData', 'Local', 'Yarn', 'bin'));
+    }
+    else {
+        directories.push(join(homePath, '.local', 'bin'));
+        // Why: pnpm uses platform-specific global bin directories that differ from
+        // npm's ~/.local/bin.
+        if (platform === 'darwin') {
+            directories.push(join(homePath, 'Library', 'pnpm'));
+        }
+        else {
+            directories.push(join(homePath, '.local', 'share', 'pnpm'));
+        }
+        directories.push(join(homePath, '.yarn', 'bin'));
+    }
+    directories.push(join(homePath, '.bun', 'bin'));
+    return directories;
+}
+function getNvmVersionDirectories(homePath) {
+    const nvmVersionsDir = join(homePath, '.nvm', 'versions', 'node');
+    if (!existsSync(nvmVersionsDir)) {
+        return [];
+    }
+    return readdirSync(nvmVersionsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort(compareVersionDesc)
+        .map((entry) => join(nvmVersionsDir, entry, 'bin'));
+}
+function getVersionManagerDirectories(platform, homePath, executableNames) {
+    const directories = getBaseVersionManagerDirectories(platform, homePath);
+    const firstNvmMatch = findFirstExecutable(platform, getNvmVersionDirectories(homePath), executableNames);
+    if (firstNvmMatch) {
+        directories.unshift(dirname(firstNvmMatch));
+    }
+    return directories;
+}
+export function resolveCliCommand(commandName, options = {}) {
+    return findCliCommand(commandName, options) ?? commandName;
+}
+export function findCliCommand(commandName, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const executableNames = getExecutableNames(platform, commandName);
+    const pathEnv = options.pathEnv ?? process.env.PATH ?? process.env.Path ?? null;
+    const pathCandidate = findFirstExecutable(platform, splitPath(pathEnv), executableNames);
+    if (pathCandidate) {
+        return pathCandidate;
+    }
+    const homePath = options.homePath ?? homedir();
+    const nvmCandidate = findFirstExecutable(platform, getNvmVersionDirectories(homePath), executableNames);
+    const versionManagerCandidate = nvmCandidate ??
+        findFirstExecutable(platform, getBaseVersionManagerDirectories(platform, homePath), executableNames);
+    return versionManagerCandidate;
+}
+/** Resolve without conflating a launch fallback with an installed executable. */
+export function resolveCliCommandDetailed(commandName, options = {}) {
+    const resolved = findCliCommand(commandName, options);
+    return resolved
+        ? { command: resolved, found: true, path: resolved }
+        : { command: commandName, found: false };
+}
+export function resolveCliCommands(commandNames, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const pathEnv = options.pathEnv ?? process.env.PATH ?? process.env.Path ?? null;
+    const pathDirectories = splitPath(pathEnv);
+    const homePath = options.homePath ?? homedir();
+    const installDirectories = [
+        ...getNvmVersionDirectories(homePath),
+        ...getBaseVersionManagerDirectories(platform, homePath)
+    ];
+    const resolved = new Map();
+    for (const commandName of new Set(commandNames)) {
+        const executableNames = getExecutableNames(platform, commandName);
+        const pathCandidate = findFirstExecutable(platform, pathDirectories, executableNames);
+        const installCandidate = pathCandidate ?? findFirstExecutable(platform, installDirectories, executableNames);
+        resolved.set(commandName, installCandidate ?? commandName);
+    }
+    return resolved;
+}
+export function resolveCodexCommand(options = {}) {
+    return resolveCliCommand('codex', options);
+}
+export function resolveClaudeCommand(options = {}) {
+    return resolveCliCommand('claude', options);
+}
+// Why: Node-script CLIs need their version-manager sibling `node` on PATH.
+export function getVersionManagerBinPaths(options = {}) {
+    const platform = options.platform ?? process.platform;
+    const homePath = options.homePath ?? homedir();
+    const nodeNames = getExecutableNames(platform, 'node');
+    return getVersionManagerDirectories(platform, homePath, nodeNames);
+}
+//# sourceMappingURL=node-cli-command-resolution.js.map

package/dist/src/shared/node-cli-command-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-cli-command-resolution.js","sourceRoot":"","sources":["../../../src/shared/node-cli-command-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAcpD,SAAS,kBAAkB,CAAC,QAAyB,EAAE,WAAmB;IACxE,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,WAAW,MAAM,EAAE,GAAG,WAAW,MAAM,EAAE,GAAG,WAAW,MAAM,EAAE,WAAW,CAAC,CAAA;IACxF,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,CAAA;AACtB,CAAC;AAED,SAAS,SAAS,CAAC,OAAkC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,OAAO;SACX,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAA;AACpB,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;SAC9C,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAa;IACrD,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IAE5D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QAChE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAyB,EACzB,WAAqB,EACrB,eAAyB;IAEzB,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;YACjD,IAAI,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC3C,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAyB,EAAE,SAAiB;IACrE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;QACjC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,0EAA0E;QAC1E,8EAA8E;QAC9E,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QACrC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,gCAAgC,CAAC,QAAyB,EAAE,QAAgB;IACnF,MAAM,WAAW,GAAG;QAClB,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;QAC/B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;QACnD,qEAAqE;QACrE,8BAA8B;QAC9B,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;KACnD,CAAA;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,wEAAwE;QACxE,kEAAkE;QAClE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;QACjD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;QAC7D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;QAC5D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IACrE,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;QACjD,2EAA2E;QAC3E,sBAAsB;QACtB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;QACrD,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;QAC7D,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC/C,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAgB;IAChD,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAA;IACjE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,WAAW,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACxD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,kBAAkB,CAAC;SACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,4BAA4B,CACnC,QAAyB,EACzB,QAAgB,EAChB,eAAyB;IAEzB,MAAM,WAAW,GAAG,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACxE,MAAM,aAAa,GAAG,mBAAmB,CACvC,QAAQ,EACR,wBAAwB,CAAC,QAAQ,CAAC,EAClC,eAAe,CAChB,CAAA;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,UAAiC,EAAE;IAEnC,OAAO,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,WAAW,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IACrD,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAA;IAC/E,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAA;IACxF,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAA;IAC9C,MAAM,YAAY,GAAG,mBAAmB,CACtC,QAAQ,EACR,wBAAwB,CAAC,QAAQ,CAAC,EAClC,eAAe,CAChB,CAAA;IACD,MAAM,uBAAuB,GAC3B,YAAY;QACZ,mBAAmB,CACjB,QAAQ,EACR,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACpD,eAAe,CAChB,CAAA;IACH,OAAO,uBAAuB,CAAA;AAChC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACrD,OAAO,QAAQ;QACb,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QACpD,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,YAA+B,EAC/B,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAA;IAC/E,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAA;IAC9C,MAAM,kBAAkB,GAAG;QACzB,GAAG,wBAAwB,CAAC,QAAQ,CAAC;QACrC,GAAG,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACxD,CAAA;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE1C,KAAK,MAAM,WAAW,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;QACjE,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,eAAe,CAAC,CAAA;QACrF,MAAM,gBAAgB,GACpB,aAAa,IAAI,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAA;QACrF,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,IAAI,WAAW,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAiC,EAAE;IACrE,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAiC,EAAE;IACtE,OAAO,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AAC7C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,yBAAyB,CAAC,UAAiC,EAAE;IAC3E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAA;IAC9C,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACtD,OAAO,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;AACpE,CAAC"}

package/dist/src/transport/gateway-client.d.ts

@@ -0,0 +1,38 @@
+import type { AgentConfig } from '../config.js';
+import type { DeviceCommand, HeartbeatResponse, ModelCatalogReport, RunFinishedReport, RunStartedReport } from '../types/protocol.js';
+/**
+ * Plain HTTPS client for the echo_admin agent gateway. There is no
+ * long-lived connection: heartbeats and a long-poll for commands, plus one
+ * request per report. Every call has a timeout.
+ */
+export declare class GatewayError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+    /** The device token was revoked or the device was deleted. */
+    get unauthorized(): boolean;
+}
+export declare class GatewayClient {
+    private readonly config;
+    constructor(config: AgentConfig);
+    private request;
+    heartbeat(body: {
+        agent_version: string;
+        hostname: string;
+        capabilities: unknown;
+        active_runs: string[];
+        model_catalogs?: ModelCatalogReport;
+    }): Promise<HeartbeatResponse>;
+    /** Long-poll: resolves when a command arrives or after `waitSeconds`. */
+    poll(waitSeconds: number, signal?: AbortSignal): Promise<DeviceCommand[]>;
+    commandResult(commandId: string, body: {
+        success: boolean;
+        result?: unknown;
+        error?: string;
+        session_key?: string;
+        agent_session_id?: string;
+    }): Promise<unknown>;
+    runStarted(runId: string, body: RunStartedReport): Promise<unknown>;
+    runFinished(runId: string, body: RunFinishedReport): Promise<{
+        accepted: boolean;
+    }>;
+}

package/dist/src/transport/gateway-client.js

@@ -0,0 +1,73 @@
+/**
+ * Plain HTTPS client for the echo_admin agent gateway. There is no
+ * long-lived connection: heartbeats and a long-poll for commands, plus one
+ * request per report. Every call has a timeout.
+ */
+export class GatewayError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+    /** The device token was revoked or the device was deleted. */
+    get unauthorized() {
+        return this.status === 401;
+    }
+}
+export class GatewayClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async request(method, path, body, timeoutMs, signal) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const onAbort = () => controller.abort();
+        signal?.addEventListener('abort', onAbort, { once: true });
+        try {
+            const response = await fetch(`${this.config.serverUrl}/api/agent${path}`, {
+                method,
+                headers: {
+                    authorization: `Bearer ${this.config.token}`,
+                    ...(body === undefined ? {} : { 'content-type': 'application/json' })
+                },
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+                signal: controller.signal
+            });
+            const envelope = await response.json().catch(() => null);
+            if (!response.ok || !envelope?.success) {
+                throw new GatewayError(envelope?.message || `HTTP ${response.status}`, response.status);
+            }
+            return envelope.data;
+        }
+        catch (error) {
+            if (error instanceof GatewayError)
+                throw error;
+            if (controller.signal.aborted && !signal?.aborted)
+                throw new GatewayError(`请求超时：${path}`, 0);
+            throw new GatewayError(error instanceof Error ? error.message : String(error), 0);
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    heartbeat(body) {
+        return this.request('POST', '/heartbeat', body, 15_000);
+    }
+    /** Long-poll: resolves when a command arrives or after `waitSeconds`. */
+    async poll(waitSeconds, signal) {
+        const data = await this.request('GET', `/commands?wait=${waitSeconds}`, undefined, (waitSeconds + 15) * 1_000, signal);
+        return data.items ?? [];
+    }
+    commandResult(commandId, body) {
+        return this.request('POST', `/commands/${encodeURIComponent(commandId)}/result`, body, 15_000);
+    }
+    runStarted(runId, body) {
+        return this.request('POST', `/runs/${encodeURIComponent(runId)}/started`, body, 15_000);
+    }
+    runFinished(runId, body) {
+        return this.request('POST', `/runs/${encodeURIComponent(runId)}/finished`, body, 15_000);
+    }
+}
+//# sourceMappingURL=gateway-client.js.map

package/dist/src/transport/gateway-client.js.map

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

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

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+export type ApiEnvelope<T> = {
+    success: boolean;
+    message?: string;
+    data?: T;
+};
+export type EnrollResponse = {
+    device_id: string;
+    device_name: string;
+    token: string;
+    heartbeat_interval: number;
+    poll_wait: number;
+};
+export type ExecPolicy = {
+    enabled: boolean;
+};
+export type DevicePolicy = {
+    script: ExecPolicy;
+    sql: ExecPolicy;
+};
+export declare const DEFAULT_POLICY: DevicePolicy;
+export type HeartbeatResponse = {
+    device_id: string;
+    device_name: string;
+    policy: DevicePolicy;
+    server_time: number;
+    heartbeat_interval: number;
+    poll_wait: number;
+    /** Hash of the model catalogs the server stores for this device. */
+    model_catalog_hash?: string;
+};
+/** A command queued by the server (device_commands row). */
+export type DeviceCommand = {
+    id: string;
+    device_id: string;
+    type: string;
+    payload: unknown;
+    workstation_id: string;
+    created_at: number;
+};
+export declare const RunStartPayloadSchema: z.ZodObject<{
+    run_id: z.ZodString;
+    workstation_id: z.ZodString;
+    workstation_name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    agent_type: z.ZodString;
+    task_chain_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    message_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    prompt: z.ZodString;
+    session_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    model: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    reasoning_effort: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    workdir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type RunStartPayload = z.infer<typeof RunStartPayloadSchema>;
+export declare const RunCancelPayloadSchema: z.ZodObject<{
+    run_id: z.ZodString;
+}, z.core.$strip>;
+export declare const RunTailPayloadSchema: z.ZodObject<{
+    run_id: z.ZodOptional<z.ZodString>;
+    workstation_id: z.ZodOptional<z.ZodString>;
+    lines: z.ZodOptional<z.ZodNumber>;
+    before_cursor: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ScriptRunPayloadSchema: z.ZodObject<{
+    cmd: z.ZodString;
+    workdir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    timeout_s: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        script: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>;
+        sql: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SqlRunPayloadSchema: z.ZodObject<{
+    database_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    sql: z.ZodString;
+    timeout_s: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        script: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>;
+        sql: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunFinishStatus = 'succeeded' | 'failed' | 'cancelled';
+export type RunFinishedReport = {
+    status: RunFinishStatus;
+    exit_code?: number;
+    session_id?: string;
+    error?: string;
+    final_message?: string;
+    duration_ms: number;
+};
+export type RunStartedReport = {
+    pid?: number;
+    session_id?: string;
+};
+export type AgentCliModelCatalogEntry = {
+    id: string;
+    name: string;
+    description?: string;
+    default_reasoning_effort?: string;
+    supported_reasoning_efforts: string[];
+};
+export type AgentCliModelCatalog = {
+    agent_type: string;
+    default_model?: string;
+    default_reasoning_effort?: string;
+    fetched_at: string;
+    models: AgentCliModelCatalogEntry[];
+};
+/** One CLI's catalog, or why it could not be read. */
+export type ModelCatalogReportItem = {
+    agent_type: string;
+    catalog?: AgentCliModelCatalog;
+    error?: string;
+};
+/** Every installed CLI's catalog, with a content hash for change detection. */
+export type ModelCatalogReport = {
+    hash: string;
+    items: ModelCatalogReportItem[];
+};
+export declare const CliModelsPayloadSchema: z.ZodObject<{
+    agent_type: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const FsListPayloadSchema: z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const WorkspaceScanPayloadSchema: z.ZodObject<{
+    root_path: z.ZodString;
+    max_depth: z.ZodOptional<z.ZodNumber>;
+    scan_roots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        relative_path: z.ZodString;
+        max_depth: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type WorkspaceScanPayload = z.infer<typeof WorkspaceScanPayloadSchema>;
+export declare const WorkspaceSyncPayloadSchema: z.ZodObject<{
+    root_path: z.ZodString;
+    directories: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    repos: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        relative_path: z.ZodString;
+        git_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    timeout_s: z.ZodOptional<z.ZodNumber>;
+    git_auth: z.ZodOptional<z.ZodObject<{
+        username: z.ZodString;
+        password: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkspaceSyncPayload = z.infer<typeof WorkspaceSyncPayloadSchema>;
+export type WorkspaceNode = {
+    relative_path: string;
+    node_type: 'folder' | 'repo';
+    git_url?: string | null;
+    branch?: string | null;
+    commit_hash?: string | null;
+};
+export type WorkspaceOperationResult = {
+    relative_path: string;
+    status: 'created' | 'updated' | 'skipped' | 'failed';
+    kind?: 'directory' | 'repo';
+    action?: 'mkdir' | 'clone' | 'pull' | 'skip' | 'sync';
+    message?: string;
+    error?: string;
+};

package/dist/src/types/protocol.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export const DEFAULT_POLICY = { script: { enabled: false }, sql: { enabled: false } };
+export const RunStartPayloadSchema = z.object({
+    run_id: z.string().min(1).max(64),
+    workstation_id: z.string().min(1).max(64),
+    workstation_name: z.string().optional().default(''),
+    agent_type: z.string().min(1).max(40),
+    task_chain_id: z.string().optional().default(''),
+    message_id: z.string().optional().default(''),
+    prompt: z.string().min(1).max(512 * 1024),
+    session_id: z.string().max(200).optional().default(''),
+    model: z.string().max(100).optional().default(''),
+    reasoning_effort: z.string().max(40).optional().default(''),
+    workdir: z.string().max(4096).optional().default('')
+});
+export const RunCancelPayloadSchema = z.object({ run_id: z.string().min(1).max(64) });
+export const RunTailPayloadSchema = z.object({
+    run_id: z.string().max(64).optional(),
+    workstation_id: z.string().max(64).optional(),
+    lines: z.number().int().positive().max(2_000).optional(),
+    before_cursor: z.number().int().min(0).optional()
+});
+export const ScriptRunPayloadSchema = z.object({
+    cmd: z.string().min(1).max(256 * 1024),
+    workdir: z.string().max(4096).optional().default(''),
+    timeout_s: z.number().int().positive().max(3_600).optional().default(60),
+    policy: z.object({ script: z.object({ enabled: z.boolean() }), sql: z.object({ enabled: z.boolean() }) }).optional()
+});
+export const SqlRunPayloadSchema = z.object({
+    database_id: z.string().max(64).optional().default(''),
+    sql: z.string().min(1).max(1024 * 1024),
+    timeout_s: z.number().int().positive().max(3_600).optional().default(60),
+    policy: z.object({ script: z.object({ enabled: z.boolean() }), sql: z.object({ enabled: z.boolean() }) }).optional()
+});
+export const CliModelsPayloadSchema = z.object({ agent_type: z.string().max(40).optional().default('') });
+// ---- Device directories ----
+const RelativePathSchema = z.string().min(1).max(500);
+export const FsListPayloadSchema = z.object({ path: z.string().max(4096).optional().default('') });
+export const WorkspaceScanPayloadSchema = z.object({
+    root_path: z.string().min(1).max(4096),
+    max_depth: z.number().int().positive().max(20).optional(),
+    scan_roots: z.array(z.object({ relative_path: RelativePathSchema, max_depth: z.number().int().positive().max(20) })).max(2_000).optional()
+});
+export const WorkspaceSyncPayloadSchema = z.object({
+    root_path: z.string().min(1).max(4096),
+    directories: z.array(RelativePathSchema).max(2_000).default([]),
+    repos: z.array(z.object({
+        relative_path: RelativePathSchema,
+        git_url: z.string().max(2_000).nullable().optional(),
+        branch: z.string().max(200).nullable().optional()
+    })).max(2_000).default([]),
+    timeout_s: z.number().int().positive().max(3_600).optional(),
+    git_auth: z.object({ username: z.string().min(1).max(500), password: z.string().min(1).max(4_096) }).optional()
+});
+//# sourceMappingURL=protocol.js.map

package/dist/src/types/protocol.js.map

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

package/dist/src/workspace/directory-browser.d.ts

@@ -0,0 +1,17 @@
+export type DirectoryEntry = {
+    name: string;
+    path: string;
+    hidden: boolean;
+};
+export type DirectoryListing = {
+    path: string;
+    parent_path: string | null;
+    directories: DirectoryEntry[];
+    files: DirectoryEntry[];
+    truncated: boolean;
+    places: Array<{
+        label: string;
+        path: string;
+    }>;
+};
+export declare function listDirectory(requested: string, allowedRoots: readonly string[]): Promise<DirectoryListing>;

package/dist/src/workspace/directory-browser.js

@@ -0,0 +1,47 @@
+import { readdir, realpath, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, parse, resolve } from 'node:path';
+/**
+ * Read-only, one-level directory listing for the remote folder picker.
+ * Only names and paths leave the device, never file contents. Without a
+ * path it opens the home directory; `places` offers quick jumps.
+ */
+const MAX_ENTRIES = 1_000;
+export async function listDirectory(requested, allowedRoots) {
+    const raw = requested.trim().replace(/^~(?=$|[\\/])/, homedir()) || homedir();
+    const directory = await realpath(resolve(raw)).catch(() => {
+        throw new Error(`目录不存在：${requested}`);
+    });
+    if (!(await stat(directory)).isDirectory())
+        throw new Error('这不是一个目录');
+    const entries = await readdir(directory, { withFileTypes: true }).catch((error) => {
+        throw new Error(error.code === 'EACCES' || error.code === 'EPERM' ? '没有权限读取这个目录' : error.message);
+    });
+    const byName = (a, b) => a.name.localeCompare(b.name, undefined, { sensitivity: 'base', numeric: true });
+    const directories = [];
+    const files = [];
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        const item = { name: entry.name, path: resolve(directory, entry.name), hidden: entry.name.startsWith('.') };
+        if (entry.isDirectory())
+            directories.push(item);
+        else if (entry.isFile())
+            files.push(item);
+    }
+    const parent = dirname(directory);
+    const places = [{ label: '主目录', path: homedir() }];
+    for (const root of allowedRoots)
+        if (root !== homedir())
+            places.push({ label: '允许的目录', path: root });
+    places.push({ label: '根目录', path: process.platform === 'win32' ? parse(directory).root : '/' });
+    return {
+        path: directory,
+        parent_path: parent === directory ? null : parent,
+        directories: directories.sort(byName).slice(0, MAX_ENTRIES),
+        files: files.sort(byName).slice(0, MAX_ENTRIES),
+        truncated: directories.length > MAX_ENTRIES || files.length > MAX_ENTRIES,
+        places
+    };
+}
+//# sourceMappingURL=directory-browser.js.map

package/dist/src/workspace/directory-browser.js.map

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

package/dist/src/workspace/workspace-manager.d.ts

@@ -0,0 +1,41 @@
+import { type AgentConfig } from '../config.js';
+import type { DiagnosticLogger } from '../logging/diagnostic-log.js';
+import type { WorkspaceNode, WorkspaceOperationResult, WorkspaceScanPayload, WorkspaceSyncPayload } from '../types/protocol.js';
+export type WorkspaceScanResult = {
+    root_path: string;
+    nodes: WorkspaceNode[];
+    truncated: boolean;
+    duration_ms: number;
+};
+export type WorkspaceSyncResult = {
+    root_path: string;
+    results: WorkspaceOperationResult[];
+    error?: string;
+    duration_ms: number;
+};
+export declare class WorkspaceManager {
+    private readonly config;
+    private readonly logger;
+    constructor(config: AgentConfig, logger: DiagnosticLogger);
+    /**
+     * Reads folders and Git repositories below the root. The root becomes an
+     * allowed CLI work directory: the user chose it for this device.
+     */
+    scan(request: WorkspaceScanPayload): Promise<WorkspaceScanResult>;
+    /** Creates missing folders, clones missing repos, fast-forwards clean ones. */
+    sync(request: WorkspaceSyncPayload): Promise<WorkspaceSyncResult>;
+    private validateRootPath;
+    private syncTree;
+    private syncRepository;
+    private scanTree;
+    private readGitMetadata;
+    private isGitRepository;
+    private cleanRelativePath;
+    private isSafeRelativePath;
+    private resolveWithinRoot;
+    private runGit;
+    private createGitAuthEnvironment;
+    private message;
+}
+/** Keeps the lines that explain a git failure, dropping progress noise. */
+export declare function gitErrorSummary(stderr: string): string;