pulseed 0.0.1 → 0.1.0

package/dist/llm-client.js

@@ -0,0 +1,151 @@
+import Anthropic from "@anthropic-ai/sdk";
+// ─── Constants ───
+const DEFAULT_MODEL = "claude-sonnet-4-20250514";
+const DEFAULT_MAX_TOKENS = 4096;
+const DEFAULT_TEMPERATURE = 0;
+const MAX_RETRY_ATTEMPTS = 3;
+/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+// ─── Helpers ───
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Extract JSON from a string that may contain markdown code blocks.
+ * Tries ```json ... ``` first, then ``` ... ```, then bare JSON.
+ */
+export function extractJSON(text) {
+    // Try ```json ... ``` block
+    const jsonBlock = text.match(/```json\s*([\s\S]*?)```/);
+    if (jsonBlock) {
+        return jsonBlock[1].trim();
+    }
+    // Try generic ``` ... ``` block
+    const genericBlock = text.match(/```\s*([\s\S]*?)```/);
+    if (genericBlock) {
+        return genericBlock[1].trim();
+    }
+    // Return as-is (bare JSON)
+    return text.trim();
+}
+// ─── LLMClient ───
+/**
+ * Thin wrapper around the Anthropic SDK.
+ * Provides retry logic and JSON extraction/validation.
+ *
+ * Constructor throws if no API key is available (no param, no env var).
+ */
+export class LLMClient {
+    client;
+    constructor(apiKey) {
+        const key = apiKey ?? process.env["ANTHROPIC_API_KEY"];
+        if (!key) {
+            throw new Error("LLMClient: no API key provided. Pass apiKey to constructor or set ANTHROPIC_API_KEY env var.");
+        }
+        this.client = new Anthropic({ apiKey: key });
+    }
+    /**
+     * Send a message to the Anthropic API with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff.
+     */
+    async sendMessage(messages, options) {
+        const model = options?.model ?? DEFAULT_MODEL;
+        const max_tokens = options?.max_tokens ?? DEFAULT_MAX_TOKENS;
+        const temperature = options?.temperature ?? DEFAULT_TEMPERATURE;
+        const system = options?.system;
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                const response = await this.client.messages.create({
+                    model,
+                    max_tokens,
+                    temperature,
+                    ...(system ? { system } : {}),
+                    messages: messages.map((m) => ({
+                        role: m.role,
+                        content: m.content,
+                    })),
+                });
+                const block = response.content[0];
+                const content = block && block.type === "text" ? block.text : "";
+                return {
+                    content,
+                    usage: {
+                        input_tokens: response.usage.input_tokens,
+                        output_tokens: response.usage.output_tokens,
+                    },
+                    stop_reason: response.stop_reason ?? "unknown",
+                };
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < MAX_RETRY_ATTEMPTS - 1) {
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 1000);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON(content, schema) {
+        const jsonText = extractJSON(content);
+        let raw;
+        try {
+            raw = JSON.parse(jsonText);
+        }
+        catch (err) {
+            throw new Error(`LLMClient.parseJSON: failed to parse JSON — ${String(err)}\nContent: ${content}`);
+        }
+        return schema.parse(raw);
+    }
+}
+// ─── MockLLMClient ───
+/**
+ * Mock implementation for testing.
+ * Returns provided responses in order, tracking call count.
+ */
+export class MockLLMClient {
+    responses;
+    _callCount = 0;
+    constructor(responses) {
+        this.responses = responses;
+    }
+    get callCount() {
+        return this._callCount;
+    }
+    async sendMessage(_messages, _options) {
+        const index = this._callCount;
+        this._callCount++;
+        if (index >= this.responses.length) {
+            throw new Error(`MockLLMClient: no response at index ${index} (only ${this.responses.length} responses configured)`);
+        }
+        const content = this.responses[index];
+        return {
+            content,
+            usage: {
+                input_tokens: 10,
+                output_tokens: content.length,
+            },
+            stop_reason: "end_turn",
+        };
+    }
+    /**
+     * Delegates to real JSON extraction and Zod validation.
+     */
+    parseJSON(content, schema) {
+        const jsonText = extractJSON(content);
+        let raw;
+        try {
+            raw = JSON.parse(jsonText);
+        }
+        catch (err) {
+            throw new Error(`MockLLMClient.parseJSON: failed to parse JSON — ${String(err)}\nContent: ${content}`);
+        }
+        return schema.parse(raw);
+    }
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/llm-client.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,30 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerConfig {
+    dir: string;
+    maxSizeMB?: number;
+    maxFiles?: number;
+    level?: LogLevel;
+    consoleOutput?: boolean;
+    rotateByDate?: boolean;
+}
+export declare class Logger {
+    private dir;
+    private maxSizeBytes;
+    private maxFiles;
+    private level;
+    private consoleOutput;
+    private rotateByDate;
+    private currentFile;
+    private lastWriteDate;
+    constructor(config: LoggerConfig);
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private log;
+    private writeToFile;
+    private getCurrentDate;
+    private rotateCurrent;
+    private rotateIfNeeded;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAuB;gBAEhC,MAAM,EAAE,YAAY;IAahC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,OAAO,CAAC,GAAG;IAmBX,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,cAAc;CA2CvB"}

package/dist/logger.js

@@ -0,0 +1,121 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export class Logger {
+    dir;
+    maxSizeBytes;
+    maxFiles;
+    level;
+    consoleOutput;
+    rotateByDate;
+    currentFile;
+    lastWriteDate = null;
+    constructor(config) {
+        this.dir = config.dir;
+        this.maxSizeBytes = (config.maxSizeMB ?? 10) * 1024 * 1024;
+        this.maxFiles = config.maxFiles ?? 5;
+        this.level = LOG_LEVELS[config.level ?? "info"];
+        this.consoleOutput = config.consoleOutput ?? true;
+        this.rotateByDate = config.rotateByDate ?? true;
+        this.currentFile = path.join(this.dir, "motiva.log");
+        // Ensure log directory exists
+        fs.mkdirSync(this.dir, { recursive: true });
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    log(level, message, context) {
+        if (LOG_LEVELS[level] < this.level)
+            return;
+        const timestamp = new Date().toISOString();
+        const contextStr = context ? " " + JSON.stringify(context) : "";
+        const line = `[${timestamp}] [${level.toUpperCase().padEnd(5)}] ${message}${contextStr}\n`;
+        // Console output
+        if (this.consoleOutput) {
+            const consoleFn = level === "error" ? console.error
+                : level === "warn" ? console.warn
+                    : console.log;
+            consoleFn(line.trimEnd());
+        }
+        // File output
+        this.writeToFile(line);
+    }
+    writeToFile(line) {
+        try {
+            // Check if rotation needed
+            this.rotateIfNeeded();
+            // Append to current log file
+            fs.appendFileSync(this.currentFile, line, "utf-8");
+        }
+        catch {
+            // Silently fail file writes (don't crash daemon for logging issues)
+        }
+    }
+    // Returns the current date as YYYY-MM-DD (overridable for testing via vi.setSystemTime)
+    getCurrentDate() {
+        return new Date().toISOString().slice(0, 10);
+    }
+    rotateCurrent(destName) {
+        // Rename the current motiva.log to destName (e.g. motiva.1.log or motiva.2026-03-16.log)
+        fs.renameSync(this.currentFile, path.join(this.dir, destName));
+    }
+    rotateIfNeeded() {
+        try {
+            // ── Date-based rotation ──────────────────────────────────────────────
+            // Run regardless of whether the current file exists yet (lastWriteDate
+            // must be initialized even before the first byte is written).
+            if (this.rotateByDate) {
+                const today = this.getCurrentDate();
+                if (this.lastWriteDate === null) {
+                    // First write: just record the date, no rotation
+                    this.lastWriteDate = today;
+                }
+                else if (this.lastWriteDate !== today) {
+                    // Date changed: rename existing file to motiva.YYYY-MM-DD.log
+                    if (fs.existsSync(this.currentFile)) {
+                        this.rotateCurrent(`motiva.${this.lastWriteDate}.log`);
+                    }
+                    this.lastWriteDate = today;
+                    return; // file was rotated (or didn't exist); fresh motiva.log created on append
+                }
+            }
+            // ── Size-based rotation ──────────────────────────────────────────────
+            if (!fs.existsSync(this.currentFile))
+                return;
+            const stat = fs.statSync(this.currentFile);
+            if (stat.size < this.maxSizeBytes)
+                return;
+            // Rotate: motiva.4.log -> delete, motiva.3.log -> motiva.4.log, etc.
+            for (let i = this.maxFiles - 1; i >= 1; i--) {
+                const older = path.join(this.dir, `motiva.${i + 1}.log`);
+                const newer = path.join(this.dir, `motiva.${i}.log`);
+                if (i === this.maxFiles - 1 && fs.existsSync(older)) {
+                    fs.unlinkSync(older);
+                }
+                if (fs.existsSync(newer)) {
+                    fs.renameSync(newer, older);
+                }
+            }
+            // Current -> motiva.1.log
+            fs.renameSync(this.currentFile, path.join(this.dir, "motiva.1.log"));
+        }
+        catch {
+            // Ignore rotation errors
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/loop/checkpoint-manager-loop.d.ts

@@ -0,0 +1,28 @@
+/**
+ * checkpoint-manager-loop.ts
+ *
+ * Loop-level checkpoint save/restore for crash recovery (§4.8).
+ *
+ * NOTE: This is distinct from CheckpointManager in src/execution/checkpoint-manager.ts,
+ * which handles multi-agent session transfer. This module handles dimension value and
+ * trust balance snapshots for crash recovery within a single run.
+ */
+import type { StateManager } from "../state-manager.js";
+import type { TrustManager } from "../traits/trust-manager.js";
+import type { LoopIterationResult } from "./core-loop-types.js";
+import type { Logger } from "../runtime/logger.js";
+/**
+ * Save a checkpoint after a successful verify step.
+ * Records dimension values, trust balance, and cycle number.
+ * Non-fatal: checkpoint save failures do not abort the run.
+ */
+export declare function saveLoopCheckpoint(stateManager: StateManager, goalId: string, loopIndex: number, iterationResult: LoopIterationResult, adapterType: string, trustManager: TrustManager | undefined, logger: Logger | undefined): Promise<void>;
+/**
+ * Restore dimension values and trust balance from a checkpoint if one exists.
+ * Delegates to StateManager.restoreFromCheckpoint which uses Zod validation.
+ * Returns the saved cycle_number so the caller can resume iteration counting,
+ * or 0 if no checkpoint exists or restore fails.
+ * Non-fatal: restore failures do not abort the run.
+ */
+export declare function restoreLoopCheckpoint(stateManager: StateManager, goalId: string, adapterType: string, trustManager: TrustManager | undefined): Promise<number>;
+//# sourceMappingURL=checkpoint-manager-loop.d.ts.map

package/dist/loop/checkpoint-manager-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager-loop.d.ts","sourceRoot":"","sources":["../../src/loop/checkpoint-manager-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,EACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/loop/checkpoint-manager-loop.js

@@ -0,0 +1,62 @@
+/**
+ * checkpoint-manager-loop.ts
+ *
+ * Loop-level checkpoint save/restore for crash recovery (§4.8).
+ *
+ * NOTE: This is distinct from CheckpointManager in src/execution/checkpoint-manager.ts,
+ * which handles multi-agent session transfer. This module handles dimension value and
+ * trust balance snapshots for crash recovery within a single run.
+ */
+/**
+ * Save a checkpoint after a successful verify step.
+ * Records dimension values, trust balance, and cycle number.
+ * Non-fatal: checkpoint save failures do not abort the run.
+ */
+export async function saveLoopCheckpoint(stateManager, goalId, loopIndex, iterationResult, adapterType, trustManager, logger) {
+    try {
+        const currentGoalForCp = await stateManager.readRaw(`goals/${goalId}/goal.json`);
+        const dimensionSnapshot = {};
+        if (currentGoalForCp && typeof currentGoalForCp === "object") {
+            const dims = currentGoalForCp.dimensions;
+            if (dims) {
+                for (const dim of dims) {
+                    if (typeof dim.name === "string" && typeof dim.current_value === "number") {
+                        dimensionSnapshot[dim.name] = dim.current_value;
+                    }
+                }
+            }
+        }
+        let trustSnapshot;
+        if (trustManager) {
+            try {
+                const trustBalance = await trustManager.getBalance(adapterType);
+                trustSnapshot = trustBalance.balance;
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+        await stateManager.writeRaw(`goals/${goalId}/checkpoint.json`, {
+            cycle_number: loopIndex + 1,
+            last_verified_task_id: iterationResult.taskResult?.task.id,
+            dimension_snapshot: dimensionSnapshot,
+            trust_snapshot: trustSnapshot,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    catch {
+        // Checkpoint save failure is non-fatal
+        logger?.warn("saveLoopCheckpoint: failed to save checkpoint", { goalId });
+    }
+}
+/**
+ * Restore dimension values and trust balance from a checkpoint if one exists.
+ * Delegates to StateManager.restoreFromCheckpoint which uses Zod validation.
+ * Returns the saved cycle_number so the caller can resume iteration counting,
+ * or 0 if no checkpoint exists or restore fails.
+ * Non-fatal: restore failures do not abort the run.
+ */
+export async function restoreLoopCheckpoint(stateManager, goalId, adapterType, trustManager) {
+    return stateManager.restoreFromCheckpoint(goalId, adapterType, trustManager);
+}
+//# sourceMappingURL=checkpoint-manager-loop.js.map

package/dist/loop/checkpoint-manager-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager-loop.js","sourceRoot":"","sources":["../../src/loop/checkpoint-manager-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,MAAc,EACd,SAAiB,EACjB,eAAoC,EACpC,WAAmB,EACnB,YAAsC,EACtC,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,MAAM,YAAY,CAAC,CAAC;QACjF,MAAM,iBAAiB,GAA2B,EAAE,CAAC;QACrD,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAI,gBAA4C,CAAC,UAE9C,CAAC;YACd,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;wBAC1E,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC;oBAClD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,aAAiC,CAAC;QACtC,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;gBAChE,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,MAAM,kBAAkB,EAAE;YAC7D,YAAY,EAAE,SAAS,GAAG,CAAC;YAC3B,qBAAqB,EAAE,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;YAC1D,kBAAkB,EAAE,iBAAiB;YACrC,cAAc,EAAE,aAAa;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;QACvC,MAAM,EAAE,IAAI,CAAC,+CAA+C,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAA0B,EAC1B,MAAc,EACd,WAAmB,EACnB,YAAsC;IAEtC,OAAO,YAAY,CAAC,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAC/E,CAAC"}

package/dist/loop/core-loop-capability.d.ts

@@ -0,0 +1,19 @@
+/**
+ * core-loop-capability.ts
+ *
+ * Standalone capability acquisition functions extracted from CoreLoop.
+ * These functions accept deps explicitly instead of using `this`.
+ */
+import type { Logger } from "../runtime/logger.js";
+import type { IAdapter } from "../execution/adapter-layer.js";
+import type { CapabilityDetector } from "../observation/capability-detector.js";
+import type { CapabilityAcquisitionTask } from "../types/capability.js";
+/** Handle the "capability_acquiring" action from TaskLifecycle.
+ * Delegates acquisition to an adapter, verifies the result, and registers
+ * the capability on success. Retries up to 3 times before escalating. */
+export declare function handleCapabilityAcquisition(acquisitionTask: CapabilityAcquisitionTask, goalId: string, adapter: IAdapter, capabilityDetector: CapabilityDetector | undefined, capabilityAcquisitionFailures: Map<string, number>, logger: Logger | undefined): Promise<void>;
+/** Records a capability acquisition failure and escalates after 3 consecutive failures. */
+export declare function recordCapabilityFailure(capabilityDetector: CapabilityDetector, acquisitionTask: CapabilityAcquisitionTask, goalId: string, capabilityAcquisitionFailures: Map<string, number>, logger: Logger | undefined): Promise<void>;
+/** Escalates a capability acquisition failure to the user and marks status as verification_failed. */
+export declare function escalateCapability(capabilityDetector: CapabilityDetector, acquisitionTask: CapabilityAcquisitionTask, goalId: string, logger: Logger | undefined): Promise<void>;
+//# sourceMappingURL=core-loop-capability.d.ts.map

package/dist/loop/core-loop-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-loop-capability.d.ts","sourceRoot":"","sources":["../../src/loop/core-loop-capability.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE;;yEAEyE;AACzE,wBAAsB,2BAA2B,CAC/C,eAAe,EAAE,yBAAyB,EAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,EACjB,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,EAClD,6BAA6B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClD,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CA6Ef;AAED,2FAA2F;AAC3F,wBAAsB,uBAAuB,CAC3C,kBAAkB,EAAE,kBAAkB,EACtC,eAAe,EAAE,yBAAyB,EAC1C,MAAM,EAAE,MAAM,EACd,6BAA6B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClD,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,sGAAsG;AACtG,wBAAsB,kBAAkB,CACtC,kBAAkB,EAAE,kBAAkB,EACtC,eAAe,EAAE,yBAAyB,EAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/loop/core-loop-capability.js

@@ -0,0 +1,107 @@
+/**
+ * core-loop-capability.ts
+ *
+ * Standalone capability acquisition functions extracted from CoreLoop.
+ * These functions accept deps explicitly instead of using `this`.
+ */
+/** Handle the "capability_acquiring" action from TaskLifecycle.
+ * Delegates acquisition to an adapter, verifies the result, and registers
+ * the capability on success. Retries up to 3 times before escalating. */
+export async function handleCapabilityAcquisition(acquisitionTask, goalId, adapter, capabilityDetector, capabilityAcquisitionFailures, logger) {
+    if (!capabilityDetector) {
+        logger?.warn("CoreLoop: capability_acquiring action received but no capabilityDetector configured — skipping");
+        return;
+    }
+    const capName = acquisitionTask.gap.missing_capability.name;
+    const capType = acquisitionTask.gap.missing_capability.type;
+    logger?.info("CoreLoop: handling capability acquisition", { capName, capType, method: acquisitionTask.method });
+    const prompt = `Capability Acquisition Task\n` +
+        `Method: ${acquisitionTask.method}\n` +
+        `Description: ${acquisitionTask.task_description}\n` +
+        `Success criteria: ${acquisitionTask.success_criteria.join("; ")}\n\n` +
+        `Instructions: Please acquire or set up the capability "${capName}" (${capType}). ` +
+        `Follow the method "${acquisitionTask.method}" and ensure the success criteria are met.`;
+    let agentResult;
+    try {
+        agentResult = await adapter.execute({ prompt, timeout_ms: 120000, adapter_type: adapter.adapterType });
+    }
+    catch (err) {
+        logger?.error("CoreLoop: adapter execution failed during capability acquisition", {
+            capName,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        await recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger);
+        return;
+    }
+    const capability = {
+        id: capName.toLowerCase().replace(/\s+/g, "_"),
+        name: capName,
+        description: acquisitionTask.task_description,
+        type: capType,
+        status: "acquiring",
+    };
+    let verificationResult;
+    try {
+        verificationResult = await capabilityDetector.verifyAcquiredCapability(capability, acquisitionTask, agentResult);
+    }
+    catch (err) {
+        logger?.error("CoreLoop: capability verification threw an error", {
+            capName,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        await recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger);
+        return;
+    }
+    if (verificationResult === "pass") {
+        capabilityAcquisitionFailures.delete(capName);
+        try {
+            await capabilityDetector.registerCapability(capability, {
+                goal_id: goalId,
+                originating_task_id: acquisitionTask.gap.related_task_id,
+                acquired_at: new Date().toISOString(),
+            });
+            await capabilityDetector.setCapabilityStatus(capName, capType, "available");
+            logger?.info("CoreLoop: capability acquired and registered successfully", { capName });
+        }
+        catch (err) {
+            logger?.error("CoreLoop: failed to register capability after verification pass", {
+                capName,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    else if (verificationResult === "escalate") {
+        capabilityAcquisitionFailures.delete(capName);
+        await escalateCapability(capabilityDetector, acquisitionTask, goalId, logger);
+    }
+    else {
+        await recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger);
+    }
+}
+/** Records a capability acquisition failure and escalates after 3 consecutive failures. */
+export async function recordCapabilityFailure(capabilityDetector, acquisitionTask, goalId, capabilityAcquisitionFailures, logger) {
+    const capName = acquisitionTask.gap.missing_capability.name;
+    const currentCount = (capabilityAcquisitionFailures.get(capName) ?? 0) + 1;
+    capabilityAcquisitionFailures.set(capName, currentCount);
+    logger?.warn("CoreLoop: capability acquisition failed", { capName, failureCount: currentCount });
+    if (currentCount >= 3) {
+        await escalateCapability(capabilityDetector, acquisitionTask, goalId, logger);
+    }
+}
+/** Escalates a capability acquisition failure to the user and marks status as verification_failed. */
+export async function escalateCapability(capabilityDetector, acquisitionTask, goalId, logger) {
+    const capName = acquisitionTask.gap.missing_capability.name;
+    const capType = acquisitionTask.gap.missing_capability.type;
+    logger?.warn("CoreLoop: escalating capability acquisition to user", { capName });
+    try {
+        await capabilityDetector.escalateToUser(acquisitionTask.gap, goalId);
+        await capabilityDetector.setCapabilityStatus(capName, capType, "verification_failed");
+    }
+    catch (err) {
+        logger?.error("CoreLoop: escalation failed", {
+            capName,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=core-loop-capability.js.map

package/dist/loop/core-loop-capability.js.map

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

package/dist/loop/core-loop-learning.d.ts

@@ -0,0 +1,34 @@
+/**
+ * core-loop-learning.ts
+ *
+ * Encapsulates learning/transfer/capability-acquisition state and logic
+ * extracted from CoreLoop. Holds three fields that were previously inline on
+ * CoreLoop and exposes methods used in run() and runOneIteration().
+ */
+import type { Logger } from "../runtime/logger.js";
+import type { CoreLoopDeps } from "./core-loop-types.js";
+export declare class CoreLoopLearning {
+    private lastLearningReviewAt;
+    private transferCheckCounter;
+    /** Tracks consecutive capability acquisition failures per capability name */
+    private capabilityAcquisitionFailures;
+    getCapabilityFailures(): Map<string, number>;
+    incrementTransferCounter(): number;
+    /**
+     * Returns the periodic learning review interval in milliseconds based on
+     * how much time remains until the goal's target_date.
+     */
+    getPeriodicReviewInterval(goalId: string, stateManager: CoreLoopDeps["stateManager"]): Promise<number>;
+    /**
+     * Checks whether it is time to run a periodic learning review and, if so,
+     * calls learningPipeline.onPeriodicReview(). Non-fatal — errors are logged
+     * but do not bubble up.
+     */
+    checkPeriodicReview(goalId: string, deps: CoreLoopDeps, logger: Logger | undefined): Promise<void>;
+    /**
+     * Called after the run loop completes with finalStatus === "completed".
+     * Triggers learningPipeline.onGoalCompleted(). Non-fatal.
+     */
+    onGoalCompleted(goalId: string, deps: CoreLoopDeps, logger: Logger | undefined): Promise<void>;
+}
+//# sourceMappingURL=core-loop-learning.d.ts.map

package/dist/loop/core-loop-learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-loop-learning.d.ts","sourceRoot":"","sources":["../../src/loop/core-loop-learning.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,oBAAoB,CAAa;IACzC,6EAA6E;IAC7E,OAAO,CAAC,6BAA6B,CAAkC;IAEvE,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI5C,wBAAwB,IAAI,MAAM;IAIlC;;;OAGG;IACG,yBAAyB,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;OAIG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAAC,IAAI,CAAC;CAajB"}