crewly 1.20.123 → 1.20.124

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

@@ -0,0 +1,146 @@
+/**
+ * Harness service — the one engine behind both setup front ends.
+ *
+ * The REST API (`/api/harness`, used by the web setup page) and the `crewly`
+ * CLI (`crewly onboard`, `crewly login`, `crewly harness`) both call this
+ * facade, so detection, install, orc choice and login behave identically.
+ * The backend uses the process-wide {@link getHarnessService}; the CLI builds
+ * its own instance with {@link createHarnessService} (silent logger, no
+ * backend running required).
+ *
+ * @module services/harness/harness.service
+ */
+import { HarnessApiKeyService } from './harness-api-key.service.js';
+import { HarnessInstallService } from './harness-install.service.js';
+import { HarnessStatusService } from './harness-status.service.js';
+import { type HarnessId, type HarnessLogger, type HarnessOverview, type HarnessStatus, type InstallJob, type LoginSession } from './harness.types.js';
+import { LoginBrokerService } from './login-broker.service.js';
+import { OrcHarnessStore, type DefaultRuntimeUpdater } from './orc-harness.store.js';
+/** Error for an id that is not a harness (REST: 404). */
+export declare class UnknownHarnessError extends Error {
+    readonly id: string;
+    /**
+     * @param id - The id that was asked for
+     */
+    constructor(id: string);
+}
+/** Parts of the service (each injectable for tests). */
+export interface HarnessServiceParts {
+    status: HarnessStatusService;
+    install: HarnessInstallService;
+    broker: LoginBrokerService;
+    apiKeys: HarnessApiKeyService;
+    orc: OrcHarnessStore;
+}
+/** Facade over status, install, orc choice, broker login and API-key login. */
+export declare class HarnessService {
+    readonly status: HarnessStatusService;
+    readonly install: HarnessInstallService;
+    readonly broker: LoginBrokerService;
+    readonly apiKeys: HarnessApiKeyService;
+    readonly orc: OrcHarnessStore;
+    /**
+     * @param parts - Service parts
+     */
+    constructor(parts: HarnessServiceParts);
+    /**
+     * Validate a harness id.
+     *
+     * @param id - Candidate
+     * @returns The id, typed
+     * @throws UnknownHarnessError for an unknown id
+     */
+    requireHarnessId(id: string): HarnessId;
+    /**
+     * Everything the setup screen needs.
+     *
+     * @returns Harness statuses, the orc harness and system tools
+     */
+    getOverview(): Promise<HarnessOverview>;
+    /**
+     * Status of one harness.
+     *
+     * @param id - Harness id
+     * @returns The status
+     * @throws UnknownHarnessError for an unknown id
+     */
+    getStatus(id: string): Promise<HarnessStatus>;
+    /**
+     * Start installing (or updating) a harness.
+     *
+     * @param id - Harness id
+     * @returns The install job
+     * @throws UnknownHarnessError for an unknown id
+     */
+    startInstall(id: string): InstallJob;
+    /**
+     * Read an install job.
+     *
+     * @param jobId - Job id
+     * @returns The job
+     * @throws HarnessInstallError job_not_found
+     */
+    getInstallJob(jobId: string): InstallJob;
+    /**
+     * Set the orchestrator's harness.
+     *
+     * @param id - Harness id
+     * @returns The recorded harness id
+     * @throws UnknownHarnessError for an unknown id
+     */
+    setOrcHarness(id: string): Promise<string>;
+    /**
+     * Start a broker login.
+     *
+     * @param id - Harness id
+     * @param method - Broker login method
+     * @returns The login session
+     * @throws UnknownHarnessError | LoginBrokerError
+     */
+    startLogin(id: string, method: string): LoginSession;
+    /**
+     * Store an API key for a harness and return its fresh status.
+     *
+     * @param id - Harness id
+     * @param key - The key (never echoed)
+     * @returns The harness status after login
+     * @throws UnknownHarnessError | HarnessApiKeyError
+     */
+    submitApiKey(id: string, key: unknown): Promise<HarnessStatus>;
+}
+/** Options for {@link createHarnessService}. */
+export interface CreateHarnessServiceOptions {
+    logger?: HarnessLogger;
+    /** How `settings.general.defaultRuntime` is updated (the CLI passes a fresh SettingsService) */
+    updateDefaultRuntime?: DefaultRuntimeUpdater;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Build a harness service with real dependencies.
+ *
+ * Codex broker logins are confirmed with `codex login status` through the
+ * status service.
+ *
+ * @param options - Logger, settings updater, env
+ * @returns A new service
+ *
+ * @example
+ * ```ts
+ * const harness = createHarnessService({ logger: SILENT_HARNESS_LOGGER });
+ * const overview = await harness.getOverview();
+ * ```
+ */
+export declare function createHarnessService(options?: CreateHarnessServiceOptions): HarnessService;
+/**
+ * The backend's harness service (logs through LoggerService).
+ *
+ * @returns The singleton
+ */
+export declare function getHarnessService(): HarnessService;
+/**
+ * Replace or clear the backend singleton (tests).
+ *
+ * @param service - Service to use, or null to clear
+ */
+export declare function setHarnessServiceForTesting(service: HarnessService | null): void;
+//# sourceMappingURL=harness.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAGN,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAErF,yDAAyD;AACzD,qBAAa,mBAAoB,SAAQ,KAAK;aAIjB,EAAE,EAAE,MAAM;IAHtC;;OAEG;gBACyB,EAAE,EAAE,MAAM;CAItC;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,GAAG,EAAE,eAAe,CAAC;CACrB;AAED,+EAA+E;AAC/E,qBAAa,cAAc;IAC1B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAE9B;;OAEG;gBACS,KAAK,EAAE,mBAAmB;IAQtC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAKvC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAK7C;;;;;;OAMG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU;IAIpC;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAIxC;;;;;;OAMG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAIpD;;;;;;;OAOG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;CAKpE;AAED,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,qBAAqB,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,cAAc,CAmB9F;AAKD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEhF"}

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

@@ -0,0 +1,193 @@
+/**
+ * Harness service — the one engine behind both setup front ends.
+ *
+ * The REST API (`/api/harness`, used by the web setup page) and the `crewly`
+ * CLI (`crewly onboard`, `crewly login`, `crewly harness`) both call this
+ * facade, so detection, install, orc choice and login behave identically.
+ * The backend uses the process-wide {@link getHarnessService}; the CLI builds
+ * its own instance with {@link createHarnessService} (silent logger, no
+ * backend running required).
+ *
+ * @module services/harness/harness.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { HarnessApiKeyService } from './harness-api-key.service.js';
+import { HarnessInstallService } from './harness-install.service.js';
+import { getHarnessDefinition } from './harness-registry.js';
+import { HarnessStatusService } from './harness-status.service.js';
+import { SILENT_HARNESS_LOGGER, isHarnessId, } from './harness.types.js';
+import { LoginBrokerService } from './login-broker.service.js';
+import { OrcHarnessStore } from './orc-harness.store.js';
+/** Error for an id that is not a harness (REST: 404). */
+export class UnknownHarnessError extends Error {
+    id;
+    /**
+     * @param id - The id that was asked for
+     */
+    constructor(id) {
+        super(`Unknown harness: ${id}`);
+        this.id = id;
+        this.name = 'UnknownHarnessError';
+    }
+}
+/** Facade over status, install, orc choice, broker login and API-key login. */
+export class HarnessService {
+    status;
+    install;
+    broker;
+    apiKeys;
+    orc;
+    /**
+     * @param parts - Service parts
+     */
+    constructor(parts) {
+        this.status = parts.status;
+        this.install = parts.install;
+        this.broker = parts.broker;
+        this.apiKeys = parts.apiKeys;
+        this.orc = parts.orc;
+    }
+    /**
+     * Validate a harness id.
+     *
+     * @param id - Candidate
+     * @returns The id, typed
+     * @throws UnknownHarnessError for an unknown id
+     */
+    requireHarnessId(id) {
+        if (!isHarnessId(id))
+            throw new UnknownHarnessError(id);
+        return id;
+    }
+    /**
+     * Everything the setup screen needs.
+     *
+     * @returns Harness statuses, the orc harness and system tools
+     */
+    async getOverview() {
+        const [harnesses, orcHarness] = await Promise.all([this.status.listStatuses(), this.orc.get()]);
+        return { harnesses, orcHarness, systemTools: this.status.getSystemTools() };
+    }
+    /**
+     * Status of one harness.
+     *
+     * @param id - Harness id
+     * @returns The status
+     * @throws UnknownHarnessError for an unknown id
+     */
+    async getStatus(id) {
+        return this.status.getStatus(this.requireHarnessId(id));
+    }
+    /**
+     * Start installing (or updating) a harness.
+     *
+     * @param id - Harness id
+     * @returns The install job
+     * @throws UnknownHarnessError for an unknown id
+     */
+    startInstall(id) {
+        return this.install.startInstall(this.requireHarnessId(id));
+    }
+    /**
+     * Read an install job.
+     *
+     * @param jobId - Job id
+     * @returns The job
+     * @throws HarnessInstallError job_not_found
+     */
+    getInstallJob(jobId) {
+        return this.install.getJob(jobId);
+    }
+    /**
+     * Set the orchestrator's harness.
+     *
+     * @param id - Harness id
+     * @returns The recorded harness id
+     * @throws UnknownHarnessError for an unknown id
+     */
+    async setOrcHarness(id) {
+        return this.orc.set(this.requireHarnessId(id));
+    }
+    /**
+     * Start a broker login.
+     *
+     * @param id - Harness id
+     * @param method - Broker login method
+     * @returns The login session
+     * @throws UnknownHarnessError | LoginBrokerError
+     */
+    startLogin(id, method) {
+        return this.broker.start(this.requireHarnessId(id), method);
+    }
+    /**
+     * Store an API key for a harness and return its fresh status.
+     *
+     * @param id - Harness id
+     * @param key - The key (never echoed)
+     * @returns The harness status after login
+     * @throws UnknownHarnessError | HarnessApiKeyError
+     */
+    async submitApiKey(id, key) {
+        const harnessId = this.requireHarnessId(id);
+        await this.apiKeys.submit(harnessId, key);
+        return this.status.getStatus(harnessId);
+    }
+}
+/**
+ * Build a harness service with real dependencies.
+ *
+ * Codex broker logins are confirmed with `codex login status` through the
+ * status service.
+ *
+ * @param options - Logger, settings updater, env
+ * @returns A new service
+ *
+ * @example
+ * ```ts
+ * const harness = createHarnessService({ logger: SILENT_HARNESS_LOGGER });
+ * const overview = await harness.getOverview();
+ * ```
+ */
+export function createHarnessService(options = {}) {
+    const logger = options.logger ?? SILENT_HARNESS_LOGGER;
+    const env = options.env ?? process.env;
+    const status = new HarnessStatusService({ logger, env });
+    const install = new HarnessInstallService({ logger, env });
+    const broker = new LoginBrokerService({
+        logger,
+        env,
+        verify: async (harnessId) => {
+            const def = getHarnessDefinition(harnessId);
+            if (!def)
+                return false;
+            const installed = await status.getInstalledInfo(def);
+            const login = await status.getLoginInfo(def, installed.path);
+            return login.loginState === 'logged_in';
+        },
+    });
+    const apiKeys = new HarnessApiKeyService({ logger, env });
+    const orc = new OrcHarnessStore(options.updateDefaultRuntime ? { updateDefaultRuntime: options.updateDefaultRuntime } : {});
+    return new HarnessService({ status, install, broker, apiKeys, orc });
+}
+/** Backend singleton. */
+let backendInstance = null;
+/**
+ * The backend's harness service (logs through LoggerService).
+ *
+ * @returns The singleton
+ */
+export function getHarnessService() {
+    if (!backendInstance) {
+        backendInstance = createHarnessService({ logger: LoggerService.getInstance().createComponentLogger('Harness') });
+    }
+    return backendInstance;
+}
+/**
+ * Replace or clear the backend singleton (tests).
+ *
+ * @param service - Service to use, or null to clear
+ */
+export function setHarnessServiceForTesting(service) {
+    backendInstance = service;
+}
+//# sourceMappingURL=harness.service.js.map

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

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

package/dist/backend/backend/src/services/harness/harness.types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Harness onboarding types — the shapes shared by the backend REST API
+ * (`/api/harness`), the `crewly` CLI and the web setup page.
+ *
+ * A "harness" is an agent CLI Crewly drives in a PTY: Claude Code, Codex or
+ * Gemini CLI. See specs/onboarding-harness-login.md for the contract.
+ *
+ * @module services/harness/harness.types
+ */
+import { HARNESS_CONSTANTS } from '../../constants.js';
+/** Harness id — equal to the matching `RuntimeType` value. */
+export type HarnessId = (typeof HARNESS_CONSTANTS.IDS)[keyof typeof HARNESS_CONSTANTS.IDS];
+/** Every harness id, in display order. */
+export declare const HARNESS_IDS: readonly HarnessId[];
+/** How the owner can log in to a harness. */
+export type LoginMethodId = 'subscription' | 'api_key' | 'device';
+/** Every login method id. */
+export declare const LOGIN_METHOD_IDS: readonly LoginMethodId[];
+/**
+ * How a front end drives a login method.
+ * - `broker`: Crewly runs the harness's login command in a PTY (login broker)
+ * - `api_key`: the owner pastes a key
+ */
+export type LoginMethodKind = 'broker' | 'api_key';
+/** A login method as exposed over the API. */
+export interface HarnessLoginMethod {
+    id: LoginMethodId;
+    label: string;
+    kind: LoginMethodKind;
+}
+/** Login state reported for a harness. */
+export type LoginState = 'logged_in' | 'logged_out' | 'unknown';
+/** Status of one harness (`GET /api/harness`). */
+export interface HarnessStatus {
+    id: HarnessId;
+    displayName: string;
+    installed: boolean;
+    version: string | null;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    loginState: LoginState;
+    /** Where the login was found (never a secret), e.g. `crewly-subscription`, `macos-keychain` */
+    loginSource: string | null;
+    loginMethods: HarnessLoginMethod[];
+}
+/** A required system tool (only jq today). */
+export interface SystemToolStatus {
+    id: string;
+    installed: boolean;
+    installHint: string;
+}
+/** Body of `GET /api/harness`. */
+export interface HarnessOverview {
+    harnesses: HarnessStatus[];
+    orcHarness: string | null;
+    systemTools: SystemToolStatus[];
+}
+/** State of an install job. */
+export type InstallJobState = 'running' | 'succeeded' | 'failed';
+/** An install job (`GET /api/harness/install/:jobId`). */
+export interface InstallJob {
+    jobId: string;
+    harnessId: HarnessId;
+    state: InstallJobState;
+    log: string;
+    usedUserPrefix: boolean;
+}
+/** State of a login broker session. */
+export type LoginSessionState = 'starting' | 'awaiting_user' | 'verifying' | 'succeeded' | 'failed' | 'timed_out' | 'cancelled';
+/** Terminal login states: the PTY is gone and the session no longer changes. */
+export declare const TERMINAL_LOGIN_STATES: readonly LoginSessionState[];
+/** A login broker session as exposed to front ends. Never contains a secret. */
+export interface LoginSession {
+    id: string;
+    harnessId: HarnessId;
+    method: LoginMethodId;
+    state: LoginSessionState;
+    url: string | null;
+    userCode: string | null;
+    /** True when the harness waits for the user to type/paste something (e.g. Claude's code) */
+    needsInput: boolean;
+    message: string | null;
+    /** Tail of the normalized terminal text, secrets redacted */
+    screen: string;
+    startedAt: string;
+    updatedAt: string;
+}
+/**
+ * Whether a value is a known harness id.
+ *
+ * @param value - Candidate
+ * @returns True for `claude-code`, `codex-cli` or `gemini-cli`
+ */
+export declare function isHarnessId(value: unknown): value is HarnessId;
+/**
+ * Whether a value is a known login method id.
+ *
+ * @param value - Candidate
+ * @returns True for `subscription`, `api_key` or `device`
+ */
+export declare function isLoginMethodId(value: unknown): value is LoginMethodId;
+/**
+ * Whether a login state is terminal (the session will not change again).
+ *
+ * @param state - Login session state
+ * @returns True for succeeded / failed / timed_out / cancelled
+ */
+export declare function isTerminalLoginState(state: LoginSessionState): boolean;
+/** Minimal logger the harness services accept (the CLI passes a silent one). */
+export interface HarnessLogger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+/** A logger that drops everything (CLI default, tests). */
+export declare const SILENT_HARNESS_LOGGER: HarnessLogger;
+/** Result of running a command to completion. */
+export interface CommandResult {
+    /** Exit code; null when the process could not be started or was killed */
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    /** Spawn error message (ENOENT, timeout), when there was one */
+    error?: string;
+}
+/** Options for {@link RunCommand}. */
+export interface RunCommandOptions {
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    /** Written to the child's stdin, then stdin is closed (used for API keys; never argv) */
+    stdin?: string;
+    /** Streaming output callback (install log) */
+    onOutput?: (chunk: string) => void;
+}
+/** Runs a command without a shell and resolves when it exits. Never rejects. */
+export type RunCommand = (command: string, args: readonly string[], options?: RunCommandOptions) => Promise<CommandResult>;
+//# sourceMappingURL=harness.types.d.ts.map

package/dist/backend/backend/src/services/harness/harness.types.d.ts.map

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

package/dist/backend/backend/src/services/harness/harness.types.js

@@ -0,0 +1,51 @@
+/**
+ * Harness onboarding types — the shapes shared by the backend REST API
+ * (`/api/harness`), the `crewly` CLI and the web setup page.
+ *
+ * A "harness" is an agent CLI Crewly drives in a PTY: Claude Code, Codex or
+ * Gemini CLI. See specs/onboarding-harness-login.md for the contract.
+ *
+ * @module services/harness/harness.types
+ */
+import { HARNESS_CONSTANTS } from '../../constants.js';
+/** Every harness id, in display order. */
+export const HARNESS_IDS = Object.values(HARNESS_CONSTANTS.IDS);
+/** Every login method id. */
+export const LOGIN_METHOD_IDS = ['subscription', 'api_key', 'device'];
+/** Terminal login states: the PTY is gone and the session no longer changes. */
+export const TERMINAL_LOGIN_STATES = ['succeeded', 'failed', 'timed_out', 'cancelled'];
+/**
+ * Whether a value is a known harness id.
+ *
+ * @param value - Candidate
+ * @returns True for `claude-code`, `codex-cli` or `gemini-cli`
+ */
+export function isHarnessId(value) {
+    return typeof value === 'string' && HARNESS_IDS.includes(value);
+}
+/**
+ * Whether a value is a known login method id.
+ *
+ * @param value - Candidate
+ * @returns True for `subscription`, `api_key` or `device`
+ */
+export function isLoginMethodId(value) {
+    return typeof value === 'string' && LOGIN_METHOD_IDS.includes(value);
+}
+/**
+ * Whether a login state is terminal (the session will not change again).
+ *
+ * @param state - Login session state
+ * @returns True for succeeded / failed / timed_out / cancelled
+ */
+export function isTerminalLoginState(state) {
+    return TERMINAL_LOGIN_STATES.includes(state);
+}
+/** A logger that drops everything (CLI default, tests). */
+export const SILENT_HARNESS_LOGGER = {
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+    debug: () => undefined,
+};
+//# sourceMappingURL=harness.types.js.map

package/dist/backend/backend/src/services/harness/harness.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/harness/harness.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAKvD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAyB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAKtF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,gBAAgB,GAA6B,CAAC,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAqEhG,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAiC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAmBrH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAwB;IAC5D,OAAO,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAUD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IACnD,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACtB,CAAC"}