@a5c-ai/babysitter-sdk 0.0.187 → 0.0.188-staging.06ee31ad

package/dist/api/breakpoints.d.ts

@@ -0,0 +1,94 @@
+/**
+ * GAP-JSON-003: JSON Breakpoint Interaction API.
+ *
+ * Typed API wrappers for listing, showing, and responding to breakpoint effects,
+ * plus auto-approval rule management. All functions return ApiResult envelopes
+ * and never throw.
+ */
+import type { ApiResult } from "./runs";
+import type { BreakpointRule, AutoApprovalResult } from "../breakpoints/types";
+import type { BreakpointConfig } from "../profiles/types";
+export interface ListBreakpointsOutput {
+    breakpoints: BreakpointSummary[];
+}
+export interface BreakpointSummary {
+    effectId: string;
+    breakpointId?: string;
+    title?: string;
+    tags?: string[];
+    expert?: string | string[];
+    strategy?: string;
+    autoApproval?: unknown;
+    requestedAt?: string;
+}
+export interface ShowBreakpointOutput {
+    effectId: string;
+    status: string;
+    breakpointId?: string;
+    title?: string;
+    description?: string;
+    tags?: string[];
+    expert?: string | string[];
+    strategy?: string;
+    previousFeedback?: string;
+    attempt?: number;
+    options?: unknown;
+    autoApproval?: unknown;
+    result?: unknown;
+    requestedAt?: string;
+    resolvedAt?: string;
+}
+export interface RespondToBreakpointInput {
+    runDir: string;
+    effectId: string;
+    approved: boolean;
+    response?: string;
+    feedback?: string;
+    option?: string;
+    respondedBy?: string;
+}
+export interface AddAutoApprovalRuleInput {
+    pattern: string;
+    action: "auto-approve" | "never-auto-approve";
+    createdBy: string;
+    id?: string;
+    source?: string;
+    note?: string;
+    rulesPath?: string;
+}
+export interface EvaluateAutoApprovalInput {
+    breakpointId: string;
+    tags?: string[];
+    expert?: string;
+    rulesPath?: string;
+    autoApproveAfterN?: number;
+    consecutiveApprovals?: number;
+    profileConfig?: BreakpointConfig;
+}
+export declare function apiListBreakpoints(input: {
+    runDir: string;
+}): Promise<ApiResult<ListBreakpointsOutput>>;
+export declare function apiShowBreakpoint(input: {
+    runDir: string;
+    effectId: string;
+}): Promise<ApiResult<ShowBreakpointOutput>>;
+export declare function apiRespondToBreakpoint(input: RespondToBreakpointInput): Promise<ApiResult<{
+    resultRef: string;
+}>>;
+export declare function apiListAutoApprovalRules(input?: {
+    rulesPath?: string;
+}): Promise<ApiResult<{
+    rules: BreakpointRule[];
+}>>;
+export declare function apiAddAutoApprovalRule(input: AddAutoApprovalRuleInput): Promise<ApiResult<{
+    rule: BreakpointRule;
+    rules: BreakpointRule[];
+}>>;
+export declare function apiRemoveAutoApprovalRule(input: {
+    ruleId: string;
+    rulesPath?: string;
+}): Promise<ApiResult<{
+    rules: BreakpointRule[];
+}>>;
+export declare function apiEvaluateAutoApproval(input: EvaluateAutoApprovalInput): Promise<ApiResult<AutoApprovalResult>>;
+//# sourceMappingURL=breakpoints.d.ts.map

package/dist/api/breakpoints.d.ts.map

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

package/dist/api/breakpoints.js

@@ -0,0 +1,340 @@
+"use strict";
+/**
+ * GAP-JSON-003: JSON Breakpoint Interaction API.
+ *
+ * Typed API wrappers for listing, showing, and responding to breakpoint effects,
+ * plus auto-approval rule management. All functions return ApiResult envelopes
+ * and never throw.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiListBreakpoints = apiListBreakpoints;
+exports.apiShowBreakpoint = apiShowBreakpoint;
+exports.apiRespondToBreakpoint = apiRespondToBreakpoint;
+exports.apiListAutoApprovalRules = apiListAutoApprovalRules;
+exports.apiAddAutoApprovalRule = apiAddAutoApprovalRule;
+exports.apiRemoveAutoApprovalRule = apiRemoveAutoApprovalRule;
+exports.apiEvaluateAutoApproval = apiEvaluateAutoApproval;
+const crypto = __importStar(require("node:crypto"));
+const journal_1 = require("../storage/journal");
+const tasks_1 = require("../storage/tasks");
+const lock_1 = require("../storage/lock");
+const serializer_1 = require("../tasks/serializer");
+const rules_1 = require("../breakpoints/rules");
+const evaluator_1 = require("../breakpoints/evaluator");
+const dispatcher_1 = require("../hooks/dispatcher");
+const utils_1 = require("./utils");
+// ── Internal helpers ───────────────────────────────────────────────────────
+function isBreakpointEffect(info) {
+    return info.kind === "breakpoint" || info.taskId === "__sdk.breakpoint";
+}
+// ── API functions ──────────────────────────────────────────────────────────
+async function apiListBreakpoints(input) {
+    try {
+        if (!input.runDir) {
+            return (0, utils_1.fail)("INVALID_INPUT", "runDir must be a non-empty string");
+        }
+        if (!(await (0, utils_1.pathExists)(input.runDir))) {
+            return (0, utils_1.fail)("RUN_NOT_FOUND", `Run directory not found: ${input.runDir}`);
+        }
+        const events = await (0, journal_1.loadJournal)(input.runDir);
+        const effectMap = (0, utils_1.buildBaseEffectMap)(events);
+        const breakpoints = [];
+        for (const info of effectMap.values()) {
+            if (!isBreakpointEffect(info))
+                continue;
+            if (info.lifecycle !== "requested")
+                continue;
+            // Read task definition to extract breakpoint-specific fields
+            let taskDef;
+            try {
+                taskDef = await (0, tasks_1.readTaskDefinition)(input.runDir, info.effectId);
+            }
+            catch {
+                // task.json may not exist
+            }
+            const td = taskDef;
+            breakpoints.push({
+                effectId: info.effectId,
+                breakpointId: td?.breakpointId,
+                title: td?.title,
+                tags: Array.isArray(td?.tags) ? td.tags : undefined,
+                expert: td?.expert,
+                strategy: td?.strategy,
+                autoApproval: td?.autoApproval,
+                requestedAt: info.requestedAt,
+            });
+        }
+        return (0, utils_1.ok)({ breakpoints });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function apiShowBreakpoint(input) {
+    try {
+        if (!input.runDir) {
+            return (0, utils_1.fail)("INVALID_INPUT", "runDir must be a non-empty string");
+        }
+        if (!input.effectId) {
+            return (0, utils_1.fail)("INVALID_INPUT", "effectId must be a non-empty string");
+        }
+        if (!(await (0, utils_1.pathExists)(input.runDir))) {
+            return (0, utils_1.fail)("RUN_NOT_FOUND", `Run directory not found: ${input.runDir}`);
+        }
+        const events = await (0, journal_1.loadJournal)(input.runDir);
+        const effectMap = (0, utils_1.buildBaseEffectMap)(events);
+        const info = effectMap.get(input.effectId);
+        if (!info) {
+            return (0, utils_1.fail)("EFFECT_NOT_FOUND", `Effect not found: ${input.effectId}`);
+        }
+        if (!isBreakpointEffect(info)) {
+            return (0, utils_1.fail)("EFFECT_NOT_BREAKPOINT", `Effect ${input.effectId} is not a breakpoint (kind=${info.kind})`);
+        }
+        // Read task definition
+        let taskDef;
+        try {
+            taskDef = await (0, tasks_1.readTaskDefinition)(input.runDir, input.effectId);
+        }
+        catch {
+            // task.json may not exist
+        }
+        // Read result if resolved
+        let resultData = undefined;
+        if (info.lifecycle === "resolved") {
+            try {
+                const storedResult = await (0, tasks_1.readTaskResult)(input.runDir, input.effectId);
+                resultData = storedResult ?? undefined;
+            }
+            catch {
+                // result.json may be missing/corrupt
+            }
+        }
+        const td = taskDef;
+        const output = {
+            effectId: info.effectId,
+            status: info.lifecycle,
+            breakpointId: td?.breakpointId,
+            title: td?.title,
+            description: td?.description,
+            tags: Array.isArray(td?.tags) ? td.tags : undefined,
+            expert: td?.expert,
+            strategy: td?.strategy,
+            previousFeedback: td?.previousFeedback,
+            attempt: typeof td?.attempt === "number" ? td.attempt : undefined,
+            options: td?.options,
+            autoApproval: td?.autoApproval,
+            result: resultData,
+            requestedAt: info.requestedAt,
+            resolvedAt: info.resolvedAt,
+        };
+        return (0, utils_1.ok)(output);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function apiRespondToBreakpoint(input) {
+    try {
+        // Validate input
+        if (!input.runDir) {
+            return (0, utils_1.fail)("INVALID_INPUT", "runDir must be a non-empty string");
+        }
+        if (!input.effectId) {
+            return (0, utils_1.fail)("INVALID_INPUT", "effectId must be a non-empty string");
+        }
+        if (input.approved === false && (!input.feedback || input.feedback.trim() === "")) {
+            return (0, utils_1.fail)("INVALID_INPUT", "feedback is required when rejecting a breakpoint (approved=false)");
+        }
+        if (!(await (0, utils_1.pathExists)(input.runDir))) {
+            return (0, utils_1.fail)("RUN_NOT_FOUND", `Run directory not found: ${input.runDir}`);
+        }
+        return await (0, lock_1.withRunLock)(input.runDir, "api:respondToBreakpoint", async () => {
+            const events = await (0, journal_1.loadJournal)(input.runDir);
+            const effectMap = (0, utils_1.buildBaseEffectMap)(events);
+            const info = effectMap.get(input.effectId);
+            if (!info) {
+                return (0, utils_1.fail)("EFFECT_NOT_FOUND", `Effect not found: ${input.effectId}`);
+            }
+            if (!isBreakpointEffect(info)) {
+                return (0, utils_1.fail)("EFFECT_NOT_BREAKPOINT", `Effect ${input.effectId} is not a breakpoint (kind=${info.kind})`);
+            }
+            if (info.lifecycle !== "requested") {
+                return (0, utils_1.fail)("EFFECT_NOT_PENDING", `Breakpoint ${input.effectId} is not pending (status=${info.lifecycle})`);
+            }
+            const taskId = info.taskId ?? `task-${input.effectId}`;
+            const invocationKey = info.invocationKey ?? `key-${input.effectId}`;
+            // Build breakpoint result value
+            const breakpointResult = {
+                approved: input.approved,
+            };
+            if (input.response !== undefined)
+                breakpointResult.response = input.response;
+            if (input.feedback !== undefined)
+                breakpointResult.feedback = input.feedback;
+            if (input.option !== undefined)
+                breakpointResult.option = input.option;
+            if (input.respondedBy !== undefined)
+                breakpointResult.respondedBy = input.respondedBy;
+            const { resultRef } = await (0, serializer_1.serializeAndWriteTaskResult)({
+                runDir: input.runDir,
+                effectId: input.effectId,
+                taskId,
+                invocationKey,
+                payload: {
+                    status: "ok",
+                    result: breakpointResult,
+                },
+            });
+            await (0, journal_1.appendEvent)({
+                runDir: input.runDir,
+                eventType: "EFFECT_RESOLVED",
+                event: {
+                    effectId: input.effectId,
+                    status: "ok",
+                    resultRef,
+                },
+            });
+            // GAP-SEC-003: Fire on-permission-denied hook when breakpoint is denied
+            if (!input.approved) {
+                const td = await (0, tasks_1.readTaskDefinition)(input.runDir, input.effectId).catch(() => undefined);
+                const bpId = td?.breakpointId;
+                const kind = td?.kind;
+                (0, dispatcher_1.callHook)({
+                    hookType: "on-permission-denied",
+                    payload: {
+                        hookType: "on-permission-denied",
+                        breakpointId: bpId ?? input.effectId,
+                        title: td?.title,
+                        kind: kind ?? "breakpoint",
+                        runId: input.runDir.split("/").pop(),
+                        effectId: input.effectId,
+                        respondedBy: input.respondedBy,
+                        feedback: input.feedback,
+                        timestamp: new Date().toISOString(),
+                    },
+                    cwd: input.runDir,
+                }).catch(() => { });
+            }
+            return (0, utils_1.ok)({ resultRef });
+        });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function apiListAutoApprovalRules(input) {
+    try {
+        const rules = await (0, rules_1.readRules)(input?.rulesPath);
+        return (0, utils_1.ok)({ rules });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function apiAddAutoApprovalRule(input) {
+    try {
+        if (!input.pattern) {
+            return (0, utils_1.fail)("INVALID_INPUT", "pattern must be a non-empty string");
+        }
+        const validActions = ["auto-approve", "never-auto-approve"];
+        if (!validActions.includes(input.action)) {
+            return (0, utils_1.fail)("INVALID_INPUT", `action must be one of: ${validActions.join(", ")}`);
+        }
+        if (!input.createdBy) {
+            return (0, utils_1.fail)("INVALID_INPUT", "createdBy must be a non-empty string");
+        }
+        const rule = {
+            id: input.id ?? crypto.randomUUID(),
+            pattern: input.pattern,
+            action: input.action,
+            createdAt: new Date().toISOString(),
+            createdBy: input.createdBy,
+            source: input.source,
+            note: input.note,
+        };
+        const rules = await (0, rules_1.addRule)(rule, input.rulesPath);
+        return (0, utils_1.ok)({ rule, rules });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function apiRemoveAutoApprovalRule(input) {
+    try {
+        if (!input.ruleId) {
+            return (0, utils_1.fail)("INVALID_INPUT", "ruleId must be a non-empty string");
+        }
+        // Check if rule exists before removing
+        const existingRules = await (0, rules_1.readRules)(input.rulesPath);
+        const ruleExists = existingRules.some((r) => r.id === input.ruleId);
+        if (!ruleExists) {
+            return (0, utils_1.fail)("RULE_NOT_FOUND", `Rule not found: ${input.ruleId}`);
+        }
+        const rules = await (0, rules_1.removeRule)(input.ruleId, input.rulesPath);
+        return (0, utils_1.ok)({ rules });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function apiEvaluateAutoApproval(input) {
+    try {
+        if (!input.breakpointId) {
+            return (0, utils_1.fail)("INVALID_INPUT", "breakpointId must be a non-empty string");
+        }
+        const rules = await (0, rules_1.readRules)(input.rulesPath);
+        const result = (0, evaluator_1.evaluateAutoApproval)({
+            breakpointId: input.breakpointId,
+            tags: input.tags,
+            expert: input.expert,
+            rules,
+            profileConfig: input.profileConfig,
+            consecutiveApprovals: input.consecutiveApprovals,
+            autoApproveAfterN: input.autoApproveAfterN,
+        });
+        return (0, utils_1.ok)(result);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, utils_1.fail)("INTERNAL_ERROR", msg);
+    }
+}

package/dist/api/effects.d.ts

@@ -0,0 +1,87 @@
+/**
+ * GAP-JSON-002: Effect Dispatch and Response Protocol.
+ *
+ * Typed API wrappers for listing, showing, cancelling, and batch-committing
+ * effects.  All functions return ApiResult envelopes and never throw.
+ */
+import type { ApiResult } from "./runs";
+import type { JsonRecord } from "../storage/types";
+type EffectStatusFilter = "requested" | "resolved" | "cancelled";
+type EffectStatusOutput = "requested" | "resolved_ok" | "resolved_error" | "cancelled";
+export interface ListEffectsInput {
+    runDir: string;
+    filter?: {
+        kind?: string | string[];
+        status?: EffectStatusFilter;
+    };
+}
+export interface EffectSummary {
+    effectId: string;
+    kind?: string;
+    status: EffectStatusOutput;
+    taskId?: string;
+    labels?: string[];
+    requestedAt?: string;
+    resolvedAt?: string;
+}
+export interface ListEffectsOutput {
+    effects: EffectSummary[];
+}
+export interface ShowEffectInput {
+    runDir: string;
+    effectId: string;
+}
+export interface ShowEffectOutput {
+    effectId: string;
+    kind?: string;
+    status: EffectStatusOutput;
+    taskId?: string;
+    labels?: string[];
+    requestedAt?: string;
+    resolvedAt?: string;
+    taskDefinition?: JsonRecord;
+    result?: unknown;
+    autoApproval?: unknown;
+}
+export interface CancelEffectInput {
+    runDir: string;
+    effectId: string;
+    reason?: string;
+}
+export interface CancelEffectOutput {
+    resultRef: string;
+}
+export interface BatchCommitEffectEntry {
+    effectId: string;
+    result: {
+        status: "ok" | "error";
+        value?: unknown;
+        error?: string;
+        stdout?: string;
+        stderr?: string;
+        stdoutRef?: string;
+        stderrRef?: string;
+        startedAt?: string;
+        finishedAt?: string;
+        metadata?: JsonRecord;
+    };
+}
+export interface BatchCommitEffectsInput {
+    runDir: string;
+    effects: BatchCommitEffectEntry[];
+}
+export interface BatchCommitEffectResult {
+    effectId: string;
+    ok: boolean;
+    resultRef?: string;
+    error?: string;
+}
+export interface BatchCommitEffectsOutput {
+    results: BatchCommitEffectResult[];
+}
+export declare function apiListEffects(input: ListEffectsInput): Promise<ApiResult<ListEffectsOutput>>;
+export declare function apiShowEffect(input: ShowEffectInput): Promise<ApiResult<ShowEffectOutput>>;
+export declare function apiCancelEffect(input: CancelEffectInput): Promise<ApiResult<CancelEffectOutput>>;
+export declare function apiBatchCommitEffects(input: BatchCommitEffectsInput): Promise<ApiResult<BatchCommitEffectsOutput>>;
+export {};
+//# sourceMappingURL=effects.d.ts.map

package/dist/api/effects.d.ts.map

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