@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/harness/modeSelector.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * GAP-UX-014: Operator Mode Selection
+ *
+ * In-session mode switching between orchestration modes without
+ * restarting the run. Affects prompt personality, breakpoint
+ * frequency, and parallelism configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveMode = getActiveMode;
+exports.getActiveModeConfig = getActiveModeConfig;
+exports.switchMode = switchMode;
+exports.getModeConfig = getModeConfig;
+exports.getAvailableModes = getAvailableModes;
+exports.resetMode = resetMode;
+exports.shouldAutoApprove = shouldAutoApprove;
+exports.shouldShowPlan = shouldShowPlan;
+exports.isParallelEnabled = isParallelEnabled;
+exports.formatModeInfo = formatModeInfo;
+// ---------------------------------------------------------------------------
+// Mode definitions
+// ---------------------------------------------------------------------------
+const MODE_CONFIGS = {
+    interactive: {
+        mode: "interactive",
+        label: "Interactive",
+        description: "Full human-in-the-loop. All breakpoints prompt for approval. Shows plan before execution.",
+        breakpointApproval: "always",
+        showPlan: true,
+        parallelism: false,
+        verbosity: "verbose",
+    },
+    autonomous: {
+        mode: "autonomous",
+        label: "Autonomous",
+        description: "Minimal human intervention. Auto-approves most breakpoints. Maximum parallelism.",
+        breakpointApproval: "auto",
+        showPlan: false,
+        parallelism: true,
+        verbosity: "minimal",
+    },
+    plan: {
+        mode: "plan",
+        label: "Plan Only",
+        description: "Generates and presents a plan, then stops. No execution until explicitly approved.",
+        breakpointApproval: "always",
+        showPlan: true,
+        parallelism: false,
+        verbosity: "normal",
+    },
+    fast: {
+        mode: "fast",
+        label: "Fast",
+        description: "Prioritizes speed. Auto-approves safe breakpoints. Parallel execution. Minimal output.",
+        breakpointApproval: "auto",
+        showPlan: false,
+        parallelism: true,
+        verbosity: "minimal",
+    },
+};
+// ---------------------------------------------------------------------------
+// Mode state
+// ---------------------------------------------------------------------------
+/**
+ * Active mode state — module-level mutable singleton for in-session switching.
+ *
+ * This is intentionally module-scoped rather than instance-based because the
+ * babysitter CLI runs as a single-session process. Not safe for concurrent
+ * multi-session use within a single process. Use {@link resetMode} for test
+ * isolation between test cases.
+ */
+let _activeMode = "interactive";
+/** Get the current active mode. */
+function getActiveMode() {
+    return _activeMode;
+}
+/** Get the configuration for the active mode. */
+function getActiveModeConfig() {
+    return MODE_CONFIGS[_activeMode];
+}
+/** Switch to a different orchestration mode. Returns the new mode config. */
+function switchMode(mode) {
+    _activeMode = mode;
+    return MODE_CONFIGS[mode];
+}
+/** Get the configuration for a specific mode. */
+function getModeConfig(mode) {
+    return MODE_CONFIGS[mode];
+}
+/** Get all available modes. */
+function getAvailableModes() {
+    return Object.values(MODE_CONFIGS);
+}
+/** Reset mode to default (interactive). Exported for test isolation. */
+function resetMode() {
+    _activeMode = "interactive";
+}
+/**
+ * Check if the current mode skips interactive breakpoint prompts.
+ * Returns true for "auto" (auto-approve based on rules) but NOT for "always" (always prompt).
+ */
+function shouldAutoApprove() {
+    return MODE_CONFIGS[_activeMode].breakpointApproval === "auto";
+}
+/** Check if the current mode wants to show plans before execution. */
+function shouldShowPlan() {
+    return MODE_CONFIGS[_activeMode].showPlan;
+}
+/** Check if parallel execution is enabled in the current mode. */
+function isParallelEnabled() {
+    return MODE_CONFIGS[_activeMode].parallelism;
+}
+/** Format mode information for display. */
+function formatModeInfo(mode) {
+    const config = mode ? MODE_CONFIGS[mode] : MODE_CONFIGS[_activeMode];
+    return [
+        `Mode: ${config.label} (${config.mode})`,
+        config.description,
+        `  Breakpoints: ${config.breakpointApproval}`,
+        `  Plan: ${config.showPlan ? "shown" : "hidden"}`,
+        `  Parallelism: ${config.parallelism ? "enabled" : "disabled"}`,
+        `  Verbosity: ${config.verbosity}`,
+    ].join("\n");
+}

package/dist/harness/modelSelection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GAP-HADAPT-002: Model Selection Per Task.
+ *
+ * Bridges task-level model preferences with harness capability routing.
+ * Uses selectHarness from capabilityRouter to find the best harness
+ * for a task's model requirement.
+ */
+import { type HarnessCandidate } from "./capabilityRouter";
+/** Minimal task definition shape for model selection. */
+export interface TaskDefInput {
+    kind?: string;
+    execution?: {
+        harness?: string;
+        model?: string;
+        permissions?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface ModelSelectionResult {
+    /** Name of the selected harness, or null if none available. */
+    selectedHarness: string | null;
+    /** Model that will be used (from task preference or harness default). */
+    selectedModel: string | undefined;
+    /** Whether a fallback harness was selected (model not matched exactly). */
+    fallback: boolean;
+    /** Human-readable reason for the selection. */
+    reason: string;
+}
+/**
+ * Resolve which harness and model to use for a given task definition.
+ *
+ * Delegates to selectHarness for scoring, then interprets the result
+ * to determine if the model was matched or a fallback was used.
+ */
+export declare function resolveModelForTask(taskDef: TaskDefInput, candidates: HarnessCandidate[]): ModelSelectionResult;
+//# sourceMappingURL=modelSelection.d.ts.map

package/dist/harness/modelSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelSelection.d.ts","sourceRoot":"","sources":["../../src/harness/modelSelection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAM5B,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,yEAAyE;IACzE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,gBAAgB,EAAE,GAC7B,oBAAoB,CAwDtB"}

package/dist/harness/modelSelection.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * GAP-HADAPT-002: Model Selection Per Task.
+ *
+ * Bridges task-level model preferences with harness capability routing.
+ * Uses selectHarness from capabilityRouter to find the best harness
+ * for a task's model requirement.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveModelForTask = resolveModelForTask;
+const capabilityRouter_1 = require("./capabilityRouter");
+// ---------------------------------------------------------------------------
+// Core
+// ---------------------------------------------------------------------------
+/**
+ * Resolve which harness and model to use for a given task definition.
+ *
+ * Delegates to selectHarness for scoring, then interprets the result
+ * to determine if the model was matched or a fallback was used.
+ */
+function resolveModelForTask(taskDef, candidates) {
+    if (candidates.length === 0) {
+        return {
+            selectedHarness: null,
+            selectedModel: undefined,
+            fallback: false,
+            reason: "No harness candidates available",
+        };
+    }
+    const requirements = (0, capabilityRouter_1.buildTaskRequirements)(taskDef);
+    const routingResult = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+    if (!routingResult) {
+        return {
+            selectedHarness: null,
+            selectedModel: undefined,
+            fallback: false,
+            reason: "No harness met minimum score threshold",
+        };
+    }
+    const preferredModel = requirements.preferredModel;
+    const selectedCandidate = routingResult.selected;
+    // Check if the selected harness actually has the preferred model
+    const hasExactModel = preferredModel
+        ? selectedCandidate?.supportedModels?.includes(preferredModel) ?? false
+        : false;
+    const hasFamilyMatch = preferredModel && !hasExactModel
+        ? selectedCandidate?.supportedModels?.some((m) => modelFamilyMatch(m, preferredModel)) ?? false
+        : false;
+    const modelMatched = hasExactModel || hasFamilyMatch;
+    const isFallback = typeof preferredModel === "string" && !modelMatched;
+    let reason;
+    if (!preferredModel) {
+        reason = `Selected ${routingResult.selected.name} (no model preference)`;
+    }
+    else if (hasExactModel) {
+        reason = `Selected ${routingResult.selected.name} — exact model match for ${preferredModel}`;
+    }
+    else if (hasFamilyMatch) {
+        reason = `Selected ${routingResult.selected.name} — model family match for ${preferredModel}`;
+    }
+    else {
+        reason = `Selected ${routingResult.selected.name} as fallback — preferred model ${preferredModel} not available`;
+    }
+    return {
+        selectedHarness: routingResult.selected.name,
+        selectedModel: preferredModel,
+        fallback: isFallback,
+        reason,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check if two model names share the same family (e.g., "claude-sonnet-4" and "claude-sonnet-4-latest").
+ */
+function modelFamilyMatch(available, preferred) {
+    const familyA = available.split("-").slice(0, -1).join("-");
+    const familyB = preferred.split("-").slice(0, -1).join("-");
+    return familyA.length > 0 && familyA === familyB;
+}

package/dist/harness/multiHarnessDispatch.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Multi-Harness Dispatch (GAP-PAR-003).
+ *
+ * Dispatches tasks to multiple harness targets in parallel and
+ * collects settled results. Enables cross-harness orchestration
+ * where the same effect can be executed by different agent runtimes.
+ */
+/** A target harness to dispatch to. */
+export interface DispatchTarget {
+    /** Harness identifier (e.g. "claude-code", "cursor", "windsurf"). */
+    harness: string;
+    /** Task prompt or payload to send. */
+    prompt: string;
+    /** Optional timeout in milliseconds. */
+    timeoutMs?: number;
+}
+/** Result from a single dispatched target. */
+export interface DispatchResult {
+    /** The target that was dispatched to. */
+    target: DispatchTarget;
+    /** Whether the dispatch succeeded. */
+    status: "fulfilled" | "rejected";
+    /** Response content, if successful. */
+    response?: string;
+    /** Error reason, if failed. */
+    reason?: unknown;
+    /** Wall-clock duration in milliseconds. */
+    durationMs: number;
+}
+/** Handler function that executes a dispatch to a single target. */
+export type DispatchHandler = (target: DispatchTarget) => Promise<string>;
+/**
+ * Dispatches tasks to multiple harness targets and collects results.
+ *
+ * The actual harness invocation is delegated to the provided handler,
+ * keeping this class transport-agnostic.
+ */
+export declare class MultiHarnessDispatcher {
+    private readonly handler;
+    constructor(handler: DispatchHandler);
+    /**
+     * Dispatch to all targets concurrently and return settled results.
+     *
+     * Never throws — all failures are captured in the result array.
+     */
+    dispatch(targets: DispatchTarget[]): Promise<DispatchResult[]>;
+    private executeWithTimeout;
+}
+//# sourceMappingURL=multiHarnessDispatch.d.ts.map

package/dist/harness/multiHarnessDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiHarnessDispatch.d.ts","sourceRoot":"","sources":["../../src/harness/multiHarnessDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,sCAAsC;IACtC,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;IACjC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAM1E;;;;;GAKG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAErD;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YA2BtD,kBAAkB;CAsBjC"}

package/dist/harness/multiHarnessDispatch.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Multi-Harness Dispatch (GAP-PAR-003).
+ *
+ * Dispatches tasks to multiple harness targets in parallel and
+ * collects settled results. Enables cross-harness orchestration
+ * where the same effect can be executed by different agent runtimes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiHarnessDispatcher = void 0;
+// ---------------------------------------------------------------------------
+// Dispatcher
+// ---------------------------------------------------------------------------
+/**
+ * Dispatches tasks to multiple harness targets and collects results.
+ *
+ * The actual harness invocation is delegated to the provided handler,
+ * keeping this class transport-agnostic.
+ */
+class MultiHarnessDispatcher {
+    handler;
+    constructor(handler) {
+        this.handler = handler;
+    }
+    /**
+     * Dispatch to all targets concurrently and return settled results.
+     *
+     * Never throws — all failures are captured in the result array.
+     */
+    async dispatch(targets) {
+        if (targets.length === 0)
+            return [];
+        const tasks = targets.map(async (target) => {
+            const startMs = Date.now();
+            try {
+                const response = await this.executeWithTimeout(target);
+                return {
+                    target,
+                    status: "fulfilled",
+                    response,
+                    durationMs: Date.now() - startMs,
+                };
+            }
+            catch (error) {
+                return {
+                    target,
+                    status: "rejected",
+                    reason: error,
+                    durationMs: Date.now() - startMs,
+                };
+            }
+        });
+        return Promise.all(tasks);
+    }
+    async executeWithTimeout(target) {
+        if (!target.timeoutMs) {
+            return this.handler(target);
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Dispatch to ${target.harness} timed out after ${target.timeoutMs}ms`));
+            }, target.timeoutMs);
+            this.handler(target).then((result) => {
+                clearTimeout(timer);
+                resolve(result);
+            }, (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+}
+exports.MultiHarnessDispatcher = MultiHarnessDispatcher;

package/dist/harness/oauthIntegration.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GAP-SEC-006: OAuth Integration.
+ *
+ * Provides types and pure helpers for constructing OAuth 2.0 authorization
+ * flows with PKCE support. Actual HTTP transport is injectable via fetch.
+ */
+export interface OAuthConfig {
+    /** OAuth client ID. */
+    clientId: string;
+    /** Authorization endpoint URL. */
+    authorizationUrl: string;
+    /** Token endpoint URL. */
+    tokenUrl: string;
+    /** Requested scopes. */
+    scopes: string[];
+    /** Redirect URI for the authorization callback. */
+    redirectUri: string;
+}
+export interface OAuthTokenSet {
+    /** The access token. */
+    accessToken: string;
+    /** Optional refresh token. */
+    refreshToken?: string;
+    /** Expiry time as epoch milliseconds. */
+    expiresAt: number;
+    /** Scopes granted. */
+    scopes: string[];
+}
+export interface PkceChallenge {
+    /** The code verifier (random string). */
+    codeVerifier: string;
+    /** The code challenge (S256 hash of verifier). */
+    codeChallenge: string;
+}
+/**
+ * Generate a PKCE code verifier and challenge pair.
+ */
+export declare function generatePkceChallenge(): PkceChallenge;
+/**
+ * Build the full authorization URL with PKCE challenge and state parameter.
+ */
+export declare function buildAuthorizationUrl(config: OAuthConfig, state: string): {
+    url: string;
+    pkce: PkceChallenge;
+};
+/**
+ * Exchange an authorization code for a token set.
+ * Uses an injectable fetch function for testability.
+ */
+export declare function exchangeCode(config: OAuthConfig, code: string, codeVerifier: string, fetchFn?: typeof globalThis.fetch): Promise<OAuthTokenSet>;
+/**
+ * Check whether a token set has expired (with optional buffer in ms).
+ */
+export declare function isTokenExpired(tokenSet: OAuthTokenSet, bufferMs?: number): boolean;
+//# sourceMappingURL=oauthIntegration.d.ts.map

package/dist/harness/oauthIntegration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthIntegration.d.ts","sourceRoot":"","sources":["../../src/harness/oauthIntegration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAMrD;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;CACrB,CAgBA;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,GAClD,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,SAAS,GAAG,OAAO,CAElF"}

package/dist/harness/oauthIntegration.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * GAP-SEC-006: OAuth Integration.
+ *
+ * Provides types and pure helpers for constructing OAuth 2.0 authorization
+ * flows with PKCE support. Actual HTTP transport is injectable via fetch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePkceChallenge = generatePkceChallenge;
+exports.buildAuthorizationUrl = buildAuthorizationUrl;
+exports.exchangeCode = exchangeCode;
+exports.isTokenExpired = isTokenExpired;
+const node_crypto_1 = require("node:crypto");
+// ---------------------------------------------------------------------------
+// PKCE helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generate a PKCE code verifier and challenge pair.
+ */
+function generatePkceChallenge() {
+    const codeVerifier = (0, node_crypto_1.randomBytes)(32).toString('base64url');
+    const codeChallenge = (0, node_crypto_1.createHash)('sha256')
+        .update(codeVerifier)
+        .digest('base64url');
+    return { codeVerifier, codeChallenge };
+}
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+/**
+ * Build the full authorization URL with PKCE challenge and state parameter.
+ */
+function buildAuthorizationUrl(config, state) {
+    const pkce = generatePkceChallenge();
+    const params = new URLSearchParams({
+        response_type: 'code',
+        client_id: config.clientId,
+        redirect_uri: config.redirectUri,
+        scope: config.scopes.join(' '),
+        state,
+        code_challenge: pkce.codeChallenge,
+        code_challenge_method: 'S256',
+    });
+    const separator = config.authorizationUrl.includes('?') ? '&' : '?';
+    const url = `${config.authorizationUrl}${separator}${params.toString()}`;
+    return { url, pkce };
+}
+/**
+ * Exchange an authorization code for a token set.
+ * Uses an injectable fetch function for testability.
+ */
+async function exchangeCode(config, code, codeVerifier, fetchFn = globalThis.fetch) {
+    const body = new URLSearchParams({
+        grant_type: 'authorization_code',
+        client_id: config.clientId,
+        redirect_uri: config.redirectUri,
+        code,
+        code_verifier: codeVerifier,
+    });
+    const response = await fetchFn(config.tokenUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: body.toString(),
+    });
+    if (!response.ok) {
+        throw new Error(`Token exchange failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const expiresIn = typeof data.expires_in === 'number' ? data.expires_in : 3600;
+    return {
+        accessToken: data.access_token,
+        refreshToken: data.refresh_token,
+        expiresAt: Date.now() + expiresIn * 1000,
+        scopes: typeof data.scope === 'string'
+            ? data.scope.split(' ')
+            : config.scopes,
+    };
+}
+/**
+ * Check whether a token set has expired (with optional buffer in ms).
+ */
+function isTokenExpired(tokenSet, bufferMs = 60_000) {
+    return Date.now() >= tokenSet.expiresAt - bufferMs;
+}

package/dist/harness/operatorCommands.d.ts

@@ -0,0 +1,38 @@
+/**
+ * GAP-USER-001: Operator Command Layer
+ *
+ * Surfaces key babysitter CLI commands as in-session actions during
+ * breakpoint interactions. Enables operators to inspect and manage
+ * orchestration without leaving the flow.
+ */
+export interface OperatorCommand {
+    /** Short command name for selection. */
+    name: string;
+    /** Human-readable label. */
+    label: string;
+    /** Brief description shown during breakpoint interaction. */
+    description: string;
+    /** The CLI command template. Placeholders: {{runDir}}, {{runId}}, {{effectId}}. */
+    commandTemplate: string;
+    /** Category for grouping in UI. */
+    category: OperatorCommandCategory;
+}
+export type OperatorCommandCategory = "inspect" | "manage" | "debug" | "tokens";
+export declare const OPERATOR_COMMANDS: OperatorCommand[];
+/** Render operator command template with run context. */
+export declare function renderOperatorCommand(template: string, context: {
+    runDir?: string;
+    runId?: string;
+    effectId?: string;
+}): string;
+/** Get operator commands filtered by category. */
+export declare function getCommandsByCategory(category: OperatorCommandCategory): OperatorCommand[];
+/** Get all categories with their commands. */
+export declare function getGroupedCommands(): Record<OperatorCommandCategory, OperatorCommand[]>;
+/** Format commands for display in a breakpoint prompt. */
+export declare function formatCommandsForPrompt(context: {
+    runDir?: string;
+    runId?: string;
+    effectId?: string;
+}): string;
+//# sourceMappingURL=operatorCommands.d.ts.map

package/dist/harness/operatorCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorCommands.d.ts","sourceRoot":"","sources":["../../src/harness/operatorCommands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAMhF,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAyD9C,CAAC;AAMF,yDAAyD;AACzD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,MAAM,CAKR;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,eAAe,EAAE,CAE1F;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,uBAAuB,EAAE,eAAe,EAAE,CAAC,CAWvF;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,MAAM,CAeR"}

package/dist/harness/operatorCommands.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * GAP-USER-001: Operator Command Layer
+ *
+ * Surfaces key babysitter CLI commands as in-session actions during
+ * breakpoint interactions. Enables operators to inspect and manage
+ * orchestration without leaving the flow.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPERATOR_COMMANDS = void 0;
+exports.renderOperatorCommand = renderOperatorCommand;
+exports.getCommandsByCategory = getCommandsByCategory;
+exports.getGroupedCommands = getGroupedCommands;
+exports.formatCommandsForPrompt = formatCommandsForPrompt;
+// ---------------------------------------------------------------------------
+// Built-in operator commands
+// ---------------------------------------------------------------------------
+exports.OPERATOR_COMMANDS = [
+    {
+        name: "status",
+        label: "Run Status",
+        description: "Show current run status and progress",
+        commandTemplate: "babysitter run:status {{runDir}}",
+        category: "inspect",
+    },
+    {
+        name: "tasks",
+        label: "Task List",
+        description: "List all tasks (pending, completed, failed)",
+        commandTemplate: "babysitter task:list {{runDir}} --pending",
+        category: "inspect",
+    },
+    {
+        name: "events",
+        label: "Recent Events",
+        description: "Show recent journal events",
+        commandTemplate: "babysitter run:events {{runDir}} --limit 20",
+        category: "inspect",
+    },
+    {
+        name: "tokens",
+        label: "Token Usage",
+        description: "Show token usage statistics for this run",
+        commandTemplate: "babysitter tokens:stats {{runId}}",
+        category: "tokens",
+    },
+    {
+        name: "task-detail",
+        label: "Task Detail",
+        description: "Show details of the current pending task",
+        commandTemplate: "babysitter task:show {{runDir}} {{effectId}}",
+        category: "inspect",
+    },
+    {
+        name: "compression",
+        label: "Compression Status",
+        description: "Show context compression status",
+        commandTemplate: "babysitter compression:status",
+        category: "tokens",
+    },
+    {
+        name: "rebuild",
+        label: "Rebuild State",
+        description: "Rebuild state cache from journal (recovery)",
+        commandTemplate: "babysitter run:rebuild-state {{runDir}}",
+        category: "manage",
+    },
+    {
+        name: "health",
+        label: "Health Check",
+        description: "Run system health diagnostics",
+        commandTemplate: "babysitter health",
+        category: "debug",
+    },
+];
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+/** Render operator command template with run context. */
+function renderOperatorCommand(template, context) {
+    return template
+        .replace(/\{\{runDir\}\}/g, context.runDir ?? ".")
+        .replace(/\{\{runId\}\}/g, context.runId ?? "<runId>")
+        .replace(/\{\{effectId\}\}/g, context.effectId ?? "<effectId>");
+}
+/** Get operator commands filtered by category. */
+function getCommandsByCategory(category) {
+    return exports.OPERATOR_COMMANDS.filter((c) => c.category === category);
+}
+/** Get all categories with their commands. */
+function getGroupedCommands() {
+    const grouped = {
+        inspect: [],
+        manage: [],
+        debug: [],
+        tokens: [],
+    };
+    for (const cmd of exports.OPERATOR_COMMANDS) {
+        grouped[cmd.category].push(cmd);
+    }
+    return grouped;
+}
+/** Format commands for display in a breakpoint prompt. */
+function formatCommandsForPrompt(context) {
+    const lines = ["## Available Operator Commands", ""];
+    const grouped = getGroupedCommands();
+    for (const [category, commands] of Object.entries(grouped)) {
+        if (commands.length === 0)
+            continue;
+        lines.push(`### ${category.charAt(0).toUpperCase() + category.slice(1)}`);
+        for (const cmd of commands) {
+            const rendered = renderOperatorCommand(cmd.commandTemplate, context);
+            lines.push(`- **${cmd.label}**: \`${rendered}\``);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}