crewly 1.20.122 → 1.20.124

package/dist/backend/backend/src/services/harness/harness-exec.utils.js

@@ -0,0 +1,183 @@
+/**
+ * Process helpers for harness onboarding: the PATH every harness process gets
+ * and a shell-free command runner.
+ *
+ * PATH: when `npm install -g` hits EACCES, Crewly installs the harness under a
+ * user-owned prefix (`<crewlyHome>/npm-global`). Its `bin` dir is prepended to
+ * PATH for everything Crewly spawns — status probes, the login broker and agent
+ * sessions — so a harness installed there is found without touching the
+ * user's shell profile. Claude Code's native installer dir (`~/.local/bin`) is
+ * appended when missing, because a backend started by launchd/systemd often
+ * lacks it.
+ *
+ * @module services/harness/harness-exec.utils
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { HARNESS_CONSTANTS } from '../../constants.js';
+import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
+/**
+ * The user-owned npm prefix used when a global install is not permitted.
+ *
+ * @returns Absolute path, e.g. `~/.crewly/npm-global`
+ */
+export function getUserNpmPrefix() {
+    return path.join(getCrewlyHomePath(), HARNESS_CONSTANTS.USER_NPM_PREFIX_DIR);
+}
+/**
+ * The bin directory of the user-owned npm prefix.
+ *
+ * @returns Absolute path, e.g. `~/.crewly/npm-global/bin`
+ */
+export function getUserNpmBinDir() {
+    return path.join(getUserNpmPrefix(), 'bin');
+}
+/**
+ * Build the PATH value harness processes run with.
+ *
+ * Prepends the user npm prefix bin dir and appends `~/.local/bin`, each only
+ * when not already present. Order of the existing entries is preserved.
+ *
+ * @param currentPath - Existing PATH (may be undefined)
+ * @param homeDir - Home directory (injectable for tests)
+ * @returns The PATH string
+ *
+ * @example
+ * ```ts
+ * buildHarnessPath('/usr/bin', '/home/me');
+ * // '/home/me/.crewly/npm-global/bin:/usr/bin:/home/me/.local/bin'
+ * ```
+ */
+export function buildHarnessPath(currentPath, homeDir = os.homedir()) {
+    const entries = (currentPath ?? '').split(path.delimiter).filter((entry) => entry.length > 0);
+    const npmBin = getUserNpmBinDir();
+    const nativeBin = path.join(homeDir, HARNESS_CONSTANTS.NATIVE_INSTALLER_BIN_DIR);
+    const result = entries.includes(npmBin) ? [...entries] : [npmBin, ...entries];
+    if (!result.includes(nativeBin))
+        result.push(nativeBin);
+    return result.join(path.delimiter);
+}
+/**
+ * PATH for running `npm`: the harness PATH plus the directory of the running
+ * Node binary, where npm lives in nvm / installer layouts. A backend started
+ * by launchd or systemd often has neither on its PATH.
+ *
+ * @param currentPath - Existing PATH
+ * @param homeDir - Home directory (injectable for tests)
+ * @param nodeBinDir - Directory of the Node binary (injectable for tests)
+ * @returns The PATH string
+ */
+export function buildNpmPath(currentPath, homeDir = os.homedir(), nodeBinDir = path.dirname(process.execPath)) {
+    const harnessPath = buildHarnessPath(currentPath, homeDir);
+    return harnessPath.split(path.delimiter).includes(nodeBinDir) ? harnessPath : `${harnessPath}${path.delimiter}${nodeBinDir}`;
+}
+/**
+ * Copy an environment with PATH set to {@link buildHarnessPath}.
+ *
+ * @param env - Source environment (defaults to process.env)
+ * @returns A new environment object
+ */
+export function withHarnessPath(env = process.env) {
+    return { ...env, PATH: buildHarnessPath(env.PATH) };
+}
+/**
+ * Find an executable on a PATH, like `which`.
+ *
+ * @param command - Bare command name (or an absolute path, returned when executable)
+ * @param envPath - PATH to search
+ * @param isExecutable - Executable check (injectable for tests)
+ * @returns Absolute path, or null when not found
+ */
+export function resolveExecutable(command, envPath, isExecutable = defaultIsExecutable) {
+    if (command.includes(path.sep)) {
+        return isExecutable(command) ? command : null;
+    }
+    for (const dir of (envPath ?? '').split(path.delimiter)) {
+        if (!dir)
+            continue;
+        const candidate = path.join(dir, command);
+        if (isExecutable(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Whether a file exists and is executable by this user.
+ *
+ * @param file - Absolute path
+ * @returns True when executable
+ */
+function defaultIsExecutable(file) {
+    try {
+        fs.accessSync(file, fs.constants.X_OK);
+        return fs.statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run a command without a shell and collect its output.
+ *
+ * Never rejects: a spawn failure (ENOENT) or timeout comes back as
+ * `{ code: null, error }`. Secrets must go through `options.stdin`, never
+ * through `args`, so they cannot appear in `ps` output.
+ *
+ * @param command - Executable
+ * @param args - Arguments
+ * @param options - env, timeout, stdin, streaming output callback
+ * @returns Exit code and output
+ */
+export const runCommand = (command, args, options = {}) => new Promise((resolve) => {
+    let stdout = '';
+    let stderr = '';
+    let settled = false;
+    let timer = null;
+    const finish = (result) => {
+        if (settled)
+            return;
+        settled = true;
+        if (timer)
+            clearTimeout(timer);
+        resolve(result);
+    };
+    let child;
+    try {
+        child = spawn(command, [...args], {
+            env: options.env ?? process.env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (error) {
+        resolve({ code: null, stdout: '', stderr: '', error: error instanceof Error ? error.message : String(error) });
+        return;
+    }
+    if (options.timeoutMs) {
+        timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            finish({ code: null, stdout, stderr, error: `timed out after ${options.timeoutMs} ms` });
+        }, options.timeoutMs);
+    }
+    child.stdout?.on('data', (chunk) => {
+        const text = chunk.toString();
+        stdout += text;
+        options.onOutput?.(text);
+    });
+    child.stderr?.on('data', (chunk) => {
+        const text = chunk.toString();
+        stderr += text;
+        options.onOutput?.(text);
+    });
+    child.on('error', (error) => finish({ code: null, stdout, stderr, error: error.message }));
+    child.on('close', (code) => finish({ code, stdout, stderr }));
+    child.stdin?.on('error', () => undefined);
+    if (options.stdin !== undefined) {
+        child.stdin?.end(options.stdin);
+    }
+    else {
+        child.stdin?.end();
+    }
+});
+//# sourceMappingURL=harness-exec.utils.js.map

package/dist/backend/backend/src/services/harness/harness-exec.utils.js.map

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

package/dist/backend/backend/src/services/harness/harness-install.service.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Harness install — `npm install -g <pkg>@latest` as an async job.
+ *
+ * When the global prefix is not writable (EACCES / EPERM), the install is
+ * retried once under the user-owned prefix `<crewlyHome>/npm-global`
+ * (`npm install -g --prefix …`); its `bin` dir is on the PATH of everything
+ * Crewly spawns (harness-exec.utils). No sudo, no shell profile edits.
+ *
+ * One install runs per harness at a time: starting a second one while the
+ * first is running returns the running job.
+ *
+ * @module services/harness/harness-install.service
+ */
+import { type HarnessId, type HarnessLogger, type InstallJob, type RunCommand } from './harness.types.js';
+/** Injectable dependencies. */
+export interface HarnessInstallDeps {
+    run?: RunCommand;
+    env?: NodeJS.ProcessEnv;
+    /** Creates the user prefix dir */
+    mkdirp?: (dir: string) => void;
+    now?: () => number;
+    idFactory?: () => string;
+    logger?: HarnessLogger;
+    /** Called after a successful install (e.g. to refresh status caches) */
+    onInstalled?: (harnessId: HarnessId) => void;
+}
+/** Error with a machine-readable code, for the REST layer. */
+export declare class HarnessInstallError extends Error {
+    readonly code: 'unknown_harness' | 'job_not_found';
+    /**
+     * @param code - `unknown_harness` or `job_not_found`
+     * @param message - Human-readable message
+     */
+    constructor(code: 'unknown_harness' | 'job_not_found', message: string);
+}
+/**
+ * Whether npm output says the global prefix is not writable.
+ *
+ * @param output - npm stdout + stderr
+ * @returns True for EACCES / EPERM / permission denied
+ */
+export declare function isPermissionError(output: string): boolean;
+/** Runs and tracks harness install jobs. */
+export declare class HarnessInstallService {
+    private readonly run;
+    private readonly env;
+    private readonly mkdirp;
+    private readonly now;
+    private readonly idFactory;
+    private readonly logger;
+    private readonly onInstalled?;
+    private readonly jobs;
+    /**
+     * @param deps - Injectable dependencies (all optional)
+     */
+    constructor(deps?: HarnessInstallDeps);
+    /**
+     * Start installing (or updating) a harness.
+     *
+     * @param harnessId - Harness id
+     * @returns The new job, or the job already running for this harness
+     * @throws HarnessInstallError `unknown_harness`
+     */
+    startInstall(harnessId: string): InstallJob;
+    /**
+     * Look up a job.
+     *
+     * @param jobId - Job id
+     * @returns The job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    getJob(jobId: string): InstallJob;
+    /**
+     * Wait for a job to finish (CLI).
+     *
+     * @param jobId - Job id
+     * @returns The finished job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    waitForJob(jobId: string): Promise<InstallJob>;
+    /**
+     * Run npm, falling back to the user prefix on a permission error.
+     *
+     * @param record - Job record (mutated)
+     * @param npmPackage - Package to install
+     * @returns The finished job
+     */
+    private execute;
+    /**
+     * Append to a job log, keeping only the tail.
+     *
+     * @param record - Job record
+     * @param text - Text to append
+     */
+    private append;
+    /** Forget finished jobs older than the retention window. */
+    private pruneFinished;
+    /**
+     * Public view of a job.
+     *
+     * @param record - Job record
+     * @returns Contract shape
+     */
+    private toPublic;
+}
+//# sourceMappingURL=harness-install.service.d.ts.map

package/dist/backend/backend/src/services/harness/harness-install.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-install.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness-install.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAyB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEjI,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IAClC,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kCAAkC;IAClC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CAC7C;AAED,8DAA8D;AAC9D,qBAAa,mBAAoB,SAAQ,KAAK;aAM5B,IAAI,EAAE,iBAAiB,GAAG,eAAe;IAL1D;;;OAGG;gBAEc,IAAI,EAAE,iBAAiB,GAAG,eAAe,EACzD,OAAO,EAAE,MAAM;CAKhB;AASD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,4CAA4C;AAC5C,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAErD;;OAEG;gBACS,IAAI,GAAE,kBAAuB;IAUzC;;;;;;OAMG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAqB3C;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAMjC;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAOpD;;;;;;OAMG;YACW,OAAO;IAuCrB;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IAMd,4DAA4D;IAC5D,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAShB"}

package/dist/backend/backend/src/services/harness/harness-install.service.js

@@ -0,0 +1,205 @@
+/**
+ * Harness install — `npm install -g <pkg>@latest` as an async job.
+ *
+ * When the global prefix is not writable (EACCES / EPERM), the install is
+ * retried once under the user-owned prefix `<crewlyHome>/npm-global`
+ * (`npm install -g --prefix …`); its `bin` dir is on the PATH of everything
+ * Crewly spawns (harness-exec.utils). No sudo, no shell profile edits.
+ *
+ * One install runs per harness at a time: starting a second one while the
+ * first is running returns the running job.
+ *
+ * @module services/harness/harness-install.service
+ */
+import { randomUUID } from 'crypto';
+import * as fs from 'fs';
+import { HARNESS_CONSTANTS } from '../../constants.js';
+import { buildNpmPath, getUserNpmPrefix, runCommand } from './harness-exec.utils.js';
+import { getHarnessDefinition } from './harness-registry.js';
+import { SILENT_HARNESS_LOGGER } from './harness.types.js';
+/** Error with a machine-readable code, for the REST layer. */
+export class HarnessInstallError extends Error {
+    code;
+    /**
+     * @param code - `unknown_harness` or `job_not_found`
+     * @param message - Human-readable message
+     */
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'HarnessInstallError';
+    }
+}
+/**
+ * Whether npm output says the global prefix is not writable.
+ *
+ * @param output - npm stdout + stderr
+ * @returns True for EACCES / EPERM / permission denied
+ */
+export function isPermissionError(output) {
+    const lower = output.toLowerCase();
+    return HARNESS_CONSTANTS.PERMISSION_ERROR_PATTERNS.some((pattern) => lower.includes(pattern.toLowerCase()));
+}
+/** Runs and tracks harness install jobs. */
+export class HarnessInstallService {
+    run;
+    env;
+    mkdirp;
+    now;
+    idFactory;
+    logger;
+    onInstalled;
+    jobs = new Map();
+    /**
+     * @param deps - Injectable dependencies (all optional)
+     */
+    constructor(deps = {}) {
+        this.run = deps.run ?? runCommand;
+        this.env = deps.env ?? process.env;
+        this.mkdirp = deps.mkdirp ?? ((dir) => fs.mkdirSync(dir, { recursive: true }));
+        this.now = deps.now ?? Date.now;
+        this.idFactory = deps.idFactory ?? randomUUID;
+        this.logger = deps.logger ?? SILENT_HARNESS_LOGGER;
+        this.onInstalled = deps.onInstalled;
+    }
+    /**
+     * Start installing (or updating) a harness.
+     *
+     * @param harnessId - Harness id
+     * @returns The new job, or the job already running for this harness
+     * @throws HarnessInstallError `unknown_harness`
+     */
+    startInstall(harnessId) {
+        const def = getHarnessDefinition(harnessId);
+        if (!def)
+            throw new HarnessInstallError('unknown_harness', `Unknown harness: ${harnessId}`);
+        this.pruneFinished();
+        const running = [...this.jobs.values()].find((job) => job.harnessId === def.id && job.state === 'running');
+        if (running)
+            return this.toPublic(running);
+        const record = {
+            jobId: this.idFactory(),
+            harnessId: def.id,
+            state: 'running',
+            log: '',
+            usedUserPrefix: false,
+            finishedAt: null,
+            done: null,
+        };
+        this.jobs.set(record.jobId, record);
+        record.done = this.execute(record, def.npmPackage);
+        return this.toPublic(record);
+    }
+    /**
+     * Look up a job.
+     *
+     * @param jobId - Job id
+     * @returns The job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    getJob(jobId) {
+        const record = this.jobs.get(jobId);
+        if (!record)
+            throw new HarnessInstallError('job_not_found', `Install job not found: ${jobId}`);
+        return this.toPublic(record);
+    }
+    /**
+     * Wait for a job to finish (CLI).
+     *
+     * @param jobId - Job id
+     * @returns The finished job
+     * @throws HarnessInstallError `job_not_found`
+     */
+    async waitForJob(jobId) {
+        const record = this.jobs.get(jobId);
+        if (!record)
+            throw new HarnessInstallError('job_not_found', `Install job not found: ${jobId}`);
+        if (record.done)
+            await record.done;
+        return this.toPublic(record);
+    }
+    /**
+     * Run npm, falling back to the user prefix on a permission error.
+     *
+     * @param record - Job record (mutated)
+     * @param npmPackage - Package to install
+     * @returns The finished job
+     */
+    async execute(record, npmPackage) {
+        const spec = `${npmPackage}@latest`;
+        const env = { ...this.env, PATH: buildNpmPath(this.env.PATH) };
+        try {
+            this.append(record, `$ npm install -g ${spec}\n`);
+            const first = await this.run('npm', ['install', '-g', spec], {
+                env,
+                timeoutMs: HARNESS_CONSTANTS.INSTALL_TIMEOUT_MS,
+                onOutput: (chunk) => this.append(record, chunk),
+            });
+            let ok = first.code === 0;
+            if (!ok && isPermissionError(`${first.stdout}\n${first.stderr}\n${first.error ?? ''}`)) {
+                const prefix = getUserNpmPrefix();
+                this.mkdirp(prefix);
+                record.usedUserPrefix = true;
+                this.append(record, `\nNo permission to write the global npm prefix; installing under ${prefix} instead.\n`);
+                this.append(record, `$ npm install -g --prefix ${prefix} ${spec}\n`);
+                const second = await this.run('npm', ['install', '-g', '--prefix', prefix, spec], {
+                    env,
+                    timeoutMs: HARNESS_CONSTANTS.INSTALL_TIMEOUT_MS,
+                    onOutput: (chunk) => this.append(record, chunk),
+                });
+                ok = second.code === 0;
+                if (!ok && second.error)
+                    this.append(record, `\n${second.error}\n`);
+            }
+            else if (!ok && first.error) {
+                this.append(record, `\n${first.error}\n`);
+            }
+            record.state = ok ? 'succeeded' : 'failed';
+            this.append(record, ok ? '\nInstalled.\n' : '\nInstall failed.\n');
+            if (ok)
+                this.onInstalled?.(record.harnessId);
+        }
+        catch (error) {
+            record.state = 'failed';
+            this.append(record, `\n${error instanceof Error ? error.message : String(error)}\n`);
+        }
+        record.finishedAt = this.now();
+        this.logger.info('Harness install finished', { harnessId: record.harnessId, state: record.state, usedUserPrefix: record.usedUserPrefix });
+        return this.toPublic(record);
+    }
+    /**
+     * Append to a job log, keeping only the tail.
+     *
+     * @param record - Job record
+     * @param text - Text to append
+     */
+    append(record, text) {
+        const next = record.log + text;
+        const max = HARNESS_CONSTANTS.INSTALL_LOG_MAX_CHARS;
+        record.log = next.length > max ? next.slice(next.length - max) : next;
+    }
+    /** Forget finished jobs older than the retention window. */
+    pruneFinished() {
+        const cutoff = this.now() - HARNESS_CONSTANTS.INSTALL_JOB_RETENTION_MS;
+        for (const [id, job] of this.jobs) {
+            if (job.finishedAt !== null && job.finishedAt < cutoff)
+                this.jobs.delete(id);
+        }
+    }
+    /**
+     * Public view of a job.
+     *
+     * @param record - Job record
+     * @returns Contract shape
+     */
+    toPublic(record) {
+        return {
+            jobId: record.jobId,
+            harnessId: record.harnessId,
+            state: record.state,
+            log: record.log,
+            usedUserPrefix: record.usedUserPrefix,
+        };
+    }
+}
+//# sourceMappingURL=harness-install.service.js.map

package/dist/backend/backend/src/services/harness/harness-install.service.js.map

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

package/dist/backend/backend/src/services/harness/harness-registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Harness registry — static definitions of the agent CLIs Crewly can set up.
+ *
+ * One entry per harness: display name, binary, npm package, how to print the
+ * version, and the login methods Crewly offers. A `broker` method names the
+ * harness's own login command, which the login broker runs in a PTY; an
+ * `api_key` method is a pasted key. Gemini CLI is detect-only (no methods).
+ *
+ * @module services/harness/harness-registry
+ */
+import type { HarnessId, HarnessLoginMethod, LoginMethodId, LoginMethodKind } from './harness.types.js';
+/** The command a broker login method runs. */
+export interface BrokerCommand {
+    /** Binary (resolved on the harness PATH) */
+    command: string;
+    args: readonly string[];
+}
+/** A login method definition (internal: includes the broker command). */
+export interface LoginMethodDefinition {
+    id: LoginMethodId;
+    label: string;
+    kind: LoginMethodKind;
+    /** Command run by the login broker (kind `broker` only) */
+    broker?: BrokerCommand;
+}
+/** Static facts about one harness. */
+export interface HarnessDefinition {
+    id: HarnessId;
+    displayName: string;
+    /** Binary name on PATH */
+    command: string;
+    npmPackage: string;
+    /** Arguments that print the version */
+    versionArgs: readonly string[];
+    loginMethods: readonly LoginMethodDefinition[];
+}
+/** Every harness Crewly knows, in display order (default first). */
+export declare const HARNESS_DEFINITIONS: readonly HarnessDefinition[];
+/**
+ * All harness definitions.
+ *
+ * @returns The registry, in display order
+ */
+export declare function listHarnessDefinitions(): readonly HarnessDefinition[];
+/**
+ * Look up a harness definition.
+ *
+ * @param id - Harness id
+ * @returns The definition, or undefined for an unknown id
+ */
+export declare function getHarnessDefinition(id: string): HarnessDefinition | undefined;
+/**
+ * Look up one login method of a harness.
+ *
+ * @param harnessId - Harness id
+ * @param methodId - Login method id
+ * @returns The method, or undefined when the harness does not offer it
+ */
+export declare function getLoginMethod(harnessId: string, methodId: string): LoginMethodDefinition | undefined;
+/**
+ * The broker login method of a harness (the first one), if any.
+ *
+ * @param harnessId - Harness id
+ * @returns The method, or undefined when the harness has no broker login
+ */
+export declare function getBrokerLoginMethod(harnessId: string): LoginMethodDefinition | undefined;
+/**
+ * Public view of a harness's login methods (no commands).
+ *
+ * @param def - Harness definition
+ * @returns `{ id, label, kind }` per method
+ */
+export declare function toPublicLoginMethods(def: HarnessDefinition): HarnessLoginMethod[];
+/**
+ * Resolve a harness id from a full id or a short CLI alias.
+ *
+ * @param value - `claude-code`, `claude`, `codex-cli`, `codex`, `gemini-cli` or `gemini` (case-insensitive)
+ * @returns The harness id, or null when unknown
+ *
+ * @example
+ * ```ts
+ * resolveHarnessAlias('codex'); // 'codex-cli'
+ * ```
+ */
+export declare function resolveHarnessAlias(value: string | undefined | null): HarnessId | null;
+//# sourceMappingURL=harness-registry.d.ts.map

package/dist/backend/backend/src/services/harness/harness-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-registry.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxG,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAED,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAyC3D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,iBAAiB,EAAE,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAErG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB,EAAE,CAEjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAMtF"}