@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/api/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAE3C;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAEnE;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5D;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAwCtF"}

package/dist/api/utils.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Shared API utility functions for result envelope construction, path checks,
+ * and journal effect parsing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ok = ok;
+exports.fail = fail;
+exports.pathExists = pathExists;
+exports.buildBaseEffectMap = buildBaseEffectMap;
+const fs_1 = require("fs");
+function ok(data) {
+    return { ok: true, data };
+}
+function fail(code, message) {
+    return { ok: false, error: { code, message } };
+}
+async function pathExists(p) {
+    try {
+        await fs_1.promises.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse journal events into a map of effect info keyed by effectId.
+ * Shared between effects.ts and breakpoints.ts to avoid duplication.
+ */
+function buildBaseEffectMap(events) {
+    const effects = new Map();
+    for (const event of events) {
+        if (event.type === "EFFECT_REQUESTED") {
+            const data = event.data;
+            const effectId = data.effectId;
+            if (!effectId)
+                continue;
+            effects.set(effectId, {
+                effectId,
+                kind: typeof data.kind === "string" ? data.kind : undefined,
+                taskId: typeof data.taskId === "string" ? data.taskId : undefined,
+                labels: Array.isArray(data.labels) ? data.labels : undefined,
+                invocationKey: typeof data.invocationKey === "string" ? data.invocationKey : undefined,
+                lifecycle: "requested",
+                requestedAt: event.recordedAt,
+            });
+        }
+        else if (event.type === "EFFECT_RESOLVED") {
+            const data = event.data;
+            const effectId = data.effectId;
+            if (!effectId)
+                continue;
+            const existing = effects.get(effectId);
+            if (existing) {
+                existing.lifecycle = "resolved";
+                existing.resolvedStatus = typeof data.status === "string" ? data.status : undefined;
+                existing.resolvedAt = event.recordedAt;
+            }
+        }
+        else if (event.type === "EFFECT_CANCELLED") {
+            const data = event.data;
+            const effectId = data.effectId;
+            if (!effectId)
+                continue;
+            const existing = effects.get(effectId);
+            if (existing) {
+                existing.lifecycle = "cancelled";
+                existing.resolvedAt = event.recordedAt;
+            }
+        }
+    }
+    return effects;
+}

package/dist/breakpoints/approvalChains.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-BRK-001: Breakpoint Approval Chains.
+ *
+ * Multi-stage approval chains for breakpoints. Define approval
+ * sequences (e.g., reviewer then approver), quorum rules,
+ * and escalation paths. Pure functions, no I/O.
+ */
+export interface ApprovalChainStep {
+    stepId: string;
+    expert: string | string[];
+    label: string;
+    tags?: string[];
+    timeoutMs?: number;
+    escalateTo?: string;
+}
+export interface QuorumConfig {
+    experts: string[];
+    required: number;
+    strategy: "first-response-wins" | "collect-all" | "quorum";
+}
+export interface ApprovalChainDefinition {
+    chainId: string;
+    steps: ApprovalChainStep[];
+    quorum?: QuorumConfig;
+}
+export interface CompletedChainStep {
+    stepId: string;
+    approved: boolean;
+    respondedBy?: string;
+    response?: string;
+    completedAt: string;
+}
+export interface ApprovalChainState {
+    chainId: string;
+    currentStepIndex: number;
+    completedSteps: CompletedChainStep[];
+    status: "pending" | "approved" | "rejected" | "escalated";
+    startedAt: string;
+}
+export interface ChainEvaluationResult {
+    status: "approved" | "rejected" | "pending" | "escalated";
+    nextStep: ApprovalChainStep | undefined;
+    escalationTarget: ApprovalChainStep | undefined;
+    completedSteps: CompletedChainStep[];
+    reason: string;
+}
+/**
+ * Create initial chain state at step 0.
+ */
+export declare function initChainState(chainId: string): ApprovalChainState;
+/**
+ * Advance chain state by appending a completed step result.
+ * Returns new state (does not mutate input).
+ */
+export declare function advanceChainStep(state: ApprovalChainState, stepResult: CompletedChainStep): ApprovalChainState;
+/**
+ * Evaluate the current state of an approval chain.
+ * Determines next step, checks for rejections, and handles quorum logic.
+ */
+export declare function evaluateApprovalChain(chain: ApprovalChainDefinition, state: ApprovalChainState): ChainEvaluationResult;
+/**
+ * Resolve escalation path from a given step.
+ * Returns the target step definition, or undefined if no escalation configured.
+ */
+export declare function resolveEscalationPath(chain: ApprovalChainDefinition, fromStepId: string): ApprovalChainStep | undefined;
+//# sourceMappingURL=approvalChains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approvalChains.d.ts","sourceRoot":"","sources":["../../src/breakpoints/approvalChains.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,qBAAqB,GAAG,aAAa,GAAG,QAAQ,CAAC;CAC5D;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IAC1D,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,gBAAgB,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAChD,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAQlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAMpB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,kBAAkB,GACxB,qBAAqB,CA2DvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,uBAAuB,EAC9B,UAAU,EAAE,MAAM,GACjB,iBAAiB,GAAG,SAAS,CAK/B"}

package/dist/breakpoints/approvalChains.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-BRK-001: Breakpoint Approval Chains.
+ *
+ * Multi-stage approval chains for breakpoints. Define approval
+ * sequences (e.g., reviewer then approver), quorum rules,
+ * and escalation paths. Pure functions, no I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initChainState = initChainState;
+exports.advanceChainStep = advanceChainStep;
+exports.evaluateApprovalChain = evaluateApprovalChain;
+exports.resolveEscalationPath = resolveEscalationPath;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Create initial chain state at step 0.
+ */
+function initChainState(chainId) {
+    return {
+        chainId,
+        currentStepIndex: 0,
+        completedSteps: [],
+        status: "pending",
+        startedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Advance chain state by appending a completed step result.
+ * Returns new state (does not mutate input).
+ */
+function advanceChainStep(state, stepResult) {
+    return {
+        ...state,
+        currentStepIndex: state.currentStepIndex + 1,
+        completedSteps: [...state.completedSteps, stepResult],
+    };
+}
+/**
+ * Evaluate the current state of an approval chain.
+ * Determines next step, checks for rejections, and handles quorum logic.
+ */
+function evaluateApprovalChain(chain, state) {
+    const { completedSteps } = state;
+    // Check for any rejection — short-circuit
+    const rejected = completedSteps.find((s) => !s.approved);
+    if (rejected) {
+        return {
+            status: "rejected",
+            nextStep: undefined,
+            escalationTarget: undefined,
+            completedSteps,
+            reason: `Step '${rejected.stepId}' was rejected`,
+        };
+    }
+    // Handle quorum logic
+    if (chain.quorum) {
+        const approvalCount = completedSteps.filter((s) => s.approved).length;
+        if (approvalCount >= chain.quorum.required) {
+            return {
+                status: "approved",
+                nextStep: undefined,
+                escalationTarget: undefined,
+                completedSteps,
+                reason: `Quorum met: ${approvalCount}/${chain.quorum.required} approvals`,
+            };
+        }
+        // Quorum not yet met — still pending
+        const nextStep = chain.steps[Math.min(state.currentStepIndex, chain.steps.length - 1)];
+        return {
+            status: "pending",
+            nextStep,
+            escalationTarget: undefined,
+            completedSteps,
+            reason: `Quorum pending: ${approvalCount}/${chain.quorum.required} approvals`,
+        };
+    }
+    // Sequential chain: check if all steps completed
+    if (state.currentStepIndex >= chain.steps.length) {
+        // All steps completed and all approved (rejections caught above)
+        return {
+            status: "approved",
+            nextStep: undefined,
+            escalationTarget: undefined,
+            completedSteps,
+            reason: `All ${chain.steps.length} steps approved`,
+        };
+    }
+    // More steps to go
+    const nextStep = chain.steps[state.currentStepIndex];
+    return {
+        status: "pending",
+        nextStep,
+        escalationTarget: undefined,
+        completedSteps,
+        reason: `Pending step '${nextStep.stepId}' (${state.currentStepIndex + 1}/${chain.steps.length})`,
+    };
+}
+/**
+ * Resolve escalation path from a given step.
+ * Returns the target step definition, or undefined if no escalation configured.
+ */
+function resolveEscalationPath(chain, fromStepId) {
+    const fromStep = chain.steps.find((s) => s.stepId === fromStepId);
+    if (!fromStep?.escalateTo)
+        return undefined;
+    return chain.steps.find((s) => s.stepId === fromStep.escalateTo);
+}

package/dist/breakpoints/delegation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-BRK-002: Breakpoint Delegation to External Systems.
+ *
+ * Routes breakpoint approvals to external systems via webhooks.
+ * Supports async approval workflows with configurable timeouts.
+ */
+import type { DelegationRule, DelegationPayload, DelegationSendOptions, DelegationResponse } from "./delegationTypes";
+/**
+ * Returns all delegation rules whose patterns match the given breakpoint.
+ */
+export declare function evaluateDelegation(breakpointId: string, tags: string[] | undefined, rules: DelegationRule[]): DelegationRule[];
+/**
+ * Sends breakpoint data to a webhook endpoint and returns the response.
+ */
+export declare function sendDelegationWebhook(rule: DelegationRule, payload: DelegationPayload, options?: DelegationSendOptions): Promise<DelegationResponse>;
+/**
+ * Read delegation rules from file.
+ */
+export declare function readDelegationRules(rulesPath?: string): Promise<DelegationRule[]>;
+/**
+ * Write delegation rules atomically.
+ */
+export declare function writeDelegationRules(rules: DelegationRule[], rulesPath?: string): Promise<void>;
+/**
+ * Add a delegation rule. Deduplicates by rule ID.
+ */
+export declare function addDelegationRule(rule: DelegationRule, rulesPath?: string): Promise<DelegationRule[]>;
+/**
+ * Remove a delegation rule by ID.
+ */
+export declare function removeDelegationRule(ruleId: string, rulesPath?: string): Promise<DelegationRule[]>;
+/**
+ * List all delegation rules.
+ */
+export declare function listDelegationRules(rulesPath?: string): Promise<DelegationRule[]>;
+/**
+ * Send breakpoint to all matching delegates. Returns first approval/rejection (first-response-wins).
+ */
+export declare function delegateBreakpoint(breakpointId: string, payload: DelegationPayload, rules: DelegationRule[], options?: DelegationSendOptions): Promise<DelegationResponse>;
+//# sourceMappingURL=delegation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../src/breakpoints/delegation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAU3B;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAC1B,KAAK,EAAE,cAAc,EAAE,GACtB,cAAc,EAAE,CAMlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAiD7B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAWvF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,cAAc,EAAE,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC,CAM3B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC,CAK3B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEvF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}

package/dist/breakpoints/delegation.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-BRK-002: Breakpoint Delegation to External Systems.
+ *
+ * Routes breakpoint approvals to external systems via webhooks.
+ * Supports async approval workflows with configurable timeouts.
+ */
+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.evaluateDelegation = evaluateDelegation;
+exports.sendDelegationWebhook = sendDelegationWebhook;
+exports.readDelegationRules = readDelegationRules;
+exports.writeDelegationRules = writeDelegationRules;
+exports.addDelegationRule = addDelegationRule;
+exports.removeDelegationRule = removeDelegationRule;
+exports.listDelegationRules = listDelegationRules;
+exports.delegateBreakpoint = delegateBreakpoint;
+const node_fs_1 = require("node:fs");
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const atomic_1 = require("@a5c-ai/babysitter-sdk/dist/storage/atomic");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const delegationTypes_1 = require("./delegationTypes");
+function defaultDelegationRulesPath() {
+    return path.join(os.homedir(), ".a5c", "breakpoint-delegations", "rules.json");
+}
+/**
+ * Returns all delegation rules whose patterns match the given breakpoint.
+ */
+function evaluateDelegation(breakpointId, tags, rules) {
+    const attributes = { tags, expert: undefined };
+    return rules.filter((rule) => {
+        const pattern = (0, babysitter_sdk_1.parsePattern)(rule.pattern);
+        return (0, babysitter_sdk_1.matchPattern)(pattern, breakpointId, attributes);
+    });
+}
+/**
+ * Sends breakpoint data to a webhook endpoint and returns the response.
+ */
+async function sendDelegationWebhook(rule, payload, options) {
+    const timeoutMs = options?.timeoutMs ?? rule.timeoutMs ?? delegationTypes_1.DEFAULT_DELEGATION_TIMEOUT_MS;
+    const method = rule.method ?? "POST";
+    const headers = {
+        "Content-Type": "application/json",
+        ...rule.headers,
+    };
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    // Combine with external signal if provided
+    if (options?.signal) {
+        options.signal.addEventListener("abort", () => ac.abort(), { once: true });
+    }
+    try {
+        const response = await fetch(rule.webhookUrl, {
+            method,
+            headers,
+            body: JSON.stringify(payload),
+            signal: ac.signal,
+        });
+        clearTimeout(timer);
+        if (!response.ok) {
+            return {
+                approved: false,
+                error: `HTTP ${response.status}: ${response.statusText}`,
+            };
+        }
+        const data = (await response.json());
+        return {
+            approved: data.approved === true,
+            respondedBy: typeof data.respondedBy === "string" ? data.respondedBy : undefined,
+            responseData: data,
+        };
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err instanceof Error && err.name === "AbortError") {
+            return { approved: false, timedOut: true, error: "Delegation timed out" };
+        }
+        return {
+            approved: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Read delegation rules from file.
+ */
+async function readDelegationRules(rulesPath) {
+    const filePath = rulesPath ?? defaultDelegationRulesPath();
+    try {
+        const raw = await node_fs_1.promises.readFile(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed.rules))
+            return [];
+        return parsed.rules;
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+/**
+ * Write delegation rules atomically.
+ */
+async function writeDelegationRules(rules, rulesPath) {
+    const filePath = rulesPath ?? defaultDelegationRulesPath();
+    const dir = path.dirname(filePath);
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    const data = {
+        schemaVersion: delegationTypes_1.DELEGATION_RULES_SCHEMA_VERSION,
+        rules,
+    };
+    await (0, atomic_1.writeFileAtomic)(filePath, JSON.stringify(data, null, 2) + "\n");
+}
+/**
+ * Add a delegation rule. Deduplicates by rule ID.
+ */
+async function addDelegationRule(rule, rulesPath) {
+    const existing = await readDelegationRules(rulesPath);
+    const filtered = existing.filter((r) => r.id !== rule.id);
+    filtered.push(rule);
+    await writeDelegationRules(filtered, rulesPath);
+    return filtered;
+}
+/**
+ * Remove a delegation rule by ID.
+ */
+async function removeDelegationRule(ruleId, rulesPath) {
+    const existing = await readDelegationRules(rulesPath);
+    const filtered = existing.filter((r) => r.id !== ruleId);
+    await writeDelegationRules(filtered, rulesPath);
+    return filtered;
+}
+/**
+ * List all delegation rules.
+ */
+async function listDelegationRules(rulesPath) {
+    return readDelegationRules(rulesPath);
+}
+/**
+ * Send breakpoint to all matching delegates. Returns first approval/rejection (first-response-wins).
+ */
+async function delegateBreakpoint(breakpointId, payload, rules, options) {
+    const matchingRules = evaluateDelegation(breakpointId, payload.tags, rules);
+    if (matchingRules.length === 0) {
+        return { approved: false, error: "No matching delegation rules" };
+    }
+    // First-response-wins: race all matching webhooks
+    const promises = matchingRules.map((rule) => sendDelegationWebhook(rule, payload, options));
+    const results = await Promise.allSettled(promises);
+    // Return first successful (non-error) response
+    for (const result of results) {
+        if (result.status === "fulfilled" && !result.value.error) {
+            return result.value;
+        }
+    }
+    // All failed — return first error
+    for (const result of results) {
+        if (result.status === "fulfilled") {
+            return result.value;
+        }
+    }
+    return { approved: false, error: "All delegation webhooks failed" };
+}

package/dist/breakpoints/delegationTypes.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-BRK-002: Breakpoint delegation types.
+ */
+export interface DelegationRule {
+    id: string;
+    pattern: string;
+    webhookUrl: string;
+    method?: "POST" | "PUT";
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    retries?: number;
+    createdAt: string;
+    createdBy: string;
+    note?: string;
+}
+export interface DelegationRulesFile {
+    schemaVersion: string;
+    rules: DelegationRule[];
+}
+export interface DelegationPayload {
+    breakpointId: string;
+    title?: string;
+    description?: string;
+    tags?: string[];
+    expert?: string | string[];
+    options?: string[];
+    callbackUrl?: string;
+    runId?: string;
+    effectId?: string;
+}
+export interface DelegationSendOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface DelegationResponse {
+    approved: boolean;
+    respondedBy?: string;
+    responseData?: Record<string, unknown>;
+    error?: string;
+    timedOut?: boolean;
+}
+export declare const DELEGATION_RULES_SCHEMA_VERSION = "2026.01.delegation-rules-v1";
+export declare const DEFAULT_DELEGATION_TIMEOUT_MS = 300000;
+//# sourceMappingURL=delegationTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegationTypes.d.ts","sourceRoot":"","sources":["../../src/breakpoints/delegationTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAC7E,eAAO,MAAM,6BAA6B,SAAU,CAAC"}

package/dist/breakpoints/delegationTypes.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-BRK-002: Breakpoint delegation types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_DELEGATION_TIMEOUT_MS = exports.DELEGATION_RULES_SCHEMA_VERSION = void 0;
+exports.DELEGATION_RULES_SCHEMA_VERSION = "2026.01.delegation-rules-v1";
+exports.DEFAULT_DELEGATION_TIMEOUT_MS = 300_000; // 5 minutes

package/dist/breakpoints/postures.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-SEC-005: Approval Posture Model
+ *
+ * Defines the canonical safety ladder for action categories and provides
+ * posture resolution from breakpoint IDs.
+ *
+ * @module breakpoints/postures
+ */
+import type { ActionCategory, ApprovalPosture } from '@a5c-ai/babysitter-sdk';
+/**
+ * Default postures per action category.
+ * The canonical safety ladder: read (permissive) -> write/network -> execute -> destroy/auth (locked).
+ */
+export declare const DEFAULT_POSTURES: Record<ActionCategory, ApprovalPosture>;
+/**
+ * Get the posture for a category, optionally merged with overrides.
+ */
+export declare function getPostureForCategory(category: ActionCategory, overrides?: Partial<ApprovalPosture>): ApprovalPosture;
+/**
+ * Resolve an action category from a breakpoint ID's namespace prefix.
+ * Returns undefined for unknown prefixes (no posture enforcement applied).
+ *
+ * Convention: breakpointId format is `prefix.name` (e.g., `destroy.important-files`).
+ */
+export declare function resolvePostureFromBreakpointId(breakpointId: string): ActionCategory | undefined;
+//# sourceMappingURL=postures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postures.d.ts","sourceRoot":"","sources":["../../src/breakpoints/postures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,eAAe,CA2CpE,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACnC,eAAe,CAIjB;AAkBD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAK/F"}