@ouro.bot/cli 0.1.0-alpha.20 → 0.1.0-alpha.201

package/dist/heart/intentions.js

@@ -0,0 +1,173 @@
+"use strict";
+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.captureIntention = captureIntention;
+exports.readOpenIntentions = readOpenIntentions;
+exports.resolveIntention = resolveIntention;
+exports.dismissIntention = dismissIntention;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const sync_1 = require("./sync");
+function intentionsDir(agentRoot) {
+    return path.join(agentRoot, "arc", "intentions");
+}
+function intentionFilePath(agentRoot, id) {
+    return path.join(intentionsDir(agentRoot), `${id}.json`);
+}
+function generateId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 10);
+    return `int-${timestamp}-${random}`;
+}
+const SALIENCE_ORDER = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+function salienceRank(salience) {
+    if (!salience)
+        return 0;
+    return SALIENCE_ORDER[salience] ?? 0;
+}
+function captureIntention(agentRoot, input) {
+    const now = new Date().toISOString();
+    const id = generateId();
+    const intention = {
+        id,
+        content: input.content,
+        status: "open",
+        createdAt: now,
+        updatedAt: now,
+        ...(input.salience ? { salience: input.salience } : {}),
+        source: input.source,
+        ...(input.relatedFriendId ? { relatedFriendId: input.relatedFriendId } : {}),
+        ...(input.relatedObligationId ? { relatedObligationId: input.relatedObligationId } : {}),
+        ...(input.relatedCareId ? { relatedCareId: input.relatedCareId } : {}),
+        ...(input.nudgeAfter ? { nudgeAfter: input.nudgeAfter } : {}),
+    };
+    const dir = intentionsDir(agentRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = intentionFilePath(agentRoot, id);
+    fs.writeFileSync(filePath, JSON.stringify(intention, null, 2), "utf-8");
+    (0, sync_1.trackSyncWrite)(filePath);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intention_captured",
+        message: `intention captured: ${input.content.slice(0, 60)}`,
+        meta: { intentionId: id, source: input.source, salience: input.salience },
+    });
+    return intention;
+}
+function readOpenIntentions(agentRoot, options) {
+    const dir = intentionsDir(agentRoot);
+    if (!fs.existsSync(dir)) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "heart",
+            event: "heart.intentions_read",
+            message: "read intentions: directory missing, returning empty",
+            meta: { count: 0 },
+        });
+        return [];
+    }
+    const limit = options?.limit ?? 20;
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
+    const intentions = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(path.join(dir, file), "utf-8");
+            const intention = JSON.parse(content);
+            if (intention.status === "open") {
+                intentions.push(intention);
+            }
+        }
+        catch {
+            // Skip malformed JSON files
+        }
+    }
+    // Sort by salience descending, then createdAt descending
+    intentions.sort((a, b) => {
+        const salienceDiff = salienceRank(b.salience) - salienceRank(a.salience);
+        if (salienceDiff !== 0)
+            return salienceDiff;
+        return b.createdAt.localeCompare(a.createdAt);
+    });
+    const result = intentions.slice(0, limit);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intentions_read",
+        message: `read ${result.length} open intentions`,
+        meta: { count: result.length, total: intentions.length, limit },
+    });
+    return result;
+}
+function readIntentionFile(agentRoot, id) {
+    const filePath = intentionFilePath(agentRoot, id);
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Intention not found: ${id}`);
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+}
+function writeIntentionFile(agentRoot, intention) {
+    const filePath = intentionFilePath(agentRoot, intention.id);
+    fs.writeFileSync(filePath, JSON.stringify(intention, null, 2), "utf-8");
+    (0, sync_1.trackSyncWrite)(filePath);
+}
+function resolveIntention(agentRoot, id) {
+    const intention = readIntentionFile(agentRoot, id);
+    intention.status = "done";
+    intention.updatedAt = new Date().toISOString();
+    writeIntentionFile(agentRoot, intention);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intention_resolved",
+        message: `intention resolved: ${intention.content.slice(0, 60)}`,
+        meta: { intentionId: id },
+    });
+    return intention;
+}
+function dismissIntention(agentRoot, id) {
+    const intention = readIntentionFile(agentRoot, id);
+    intention.status = "dismissed";
+    intention.updatedAt = new Date().toISOString();
+    writeIntentionFile(agentRoot, intention);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intention_dismissed",
+        message: `intention dismissed: ${intention.content.slice(0, 60)}`,
+        meta: { intentionId: id },
+    });
+    return intention;
+}

package/dist/heart/kicks.js

@@ -1,28 +1,11 @@
 "use strict";
-// TODO: Kicks enforce "any action" but not "meaningful action". After a narration
-// kick, the model can satisfy the constraint by calling a no-op tool like
-// get_current_time({}). We need to detect trivial compliance and either re-kick
-// or discount the tool call. Ideally, the kick message would suggest a specific
-// tool call based on conversation context (what the user asked, what tools are
-// relevant) rather than just saying "call a tool". That's a bigger piece of work —
-// it requires the kick system to be context-aware.
-// See ouroboros' observation: "i'm not chickening out. i'm satisfying a crude
-// constraint. poorly."
-//
-// A kick is a self-correction. When the harness detects a malformed response,
-// it injects an assistant-role message as if the model caught its own mistake.
-//
-// Kicks are:
-//   - assistant role (self-correction, not external rebuke)
-//   - first person ("I" not "you")
-//   - forward-looking (what I'm doing next, not what I did wrong)
-//   - short (one sentence)
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasToolIntent = hasToolIntent;
 exports.detectKick = detectKick;
+const runtime_1 = require("../nerves/runtime");
 const KICK_MESSAGES = {
     empty: "I sent an empty message by accident — let me try again.",
-    narration: "I narrated instead of acting. Using the tool now -- if done, calling final_answer.",
+    narration: "I narrated instead of acting. Using the tool now -- if done, calling settle.",
     tool_required: "tool-required is on — I need to call a tool. use /tool-required to turn it off.",
 };
 const TOOL_INTENT_PATTERNS = [
@@ -141,4 +124,3 @@ function detectKick(content, options) {
     }
     return null;
 }
-const runtime_1 = require("../nerves/runtime");

package/dist/heart/migrate-config.js

@@ -0,0 +1,127 @@
+"use strict";
+// v1 → v2 agent.json migration.
+// Moves model from secrets.json into agent.json under humanFacing/agentFacing.
+// Uses raw fs — NO import from config.ts (avoids circular dependency).
+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.migrateAgentConfigV1ToV2 = migrateAgentConfigV1ToV2;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const MODEL_FIELD = {
+    azure: "modelName",
+    minimax: "model",
+    anthropic: "model",
+    "openai-codex": "model",
+    "github-copilot": "model",
+};
+function resolveSecretsPath(agentRoot, deps) {
+    const agentName = path.basename(agentRoot).replace(/\.ouro$/, "");
+    const secretsBase = deps?.secretsRoot ?? path.join(require("os").homedir(), ".agentsecrets");
+    return path.join(secretsBase, agentName, "secrets.json");
+}
+function migrateAgentConfigV1ToV2(agentRoot, deps) {
+    const configPath = path.join(agentRoot, "agent.json");
+    let raw;
+    try {
+        raw = fs.readFileSync(configPath, "utf-8");
+    }
+    catch {
+        return; // No agent.json — nothing to migrate
+    }
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Cannot parse agent.json at ${configPath} — invalid JSON`);
+    }
+    const version = typeof config.version === "number" ? config.version : 1;
+    if (version >= 2) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "config/identity",
+            event: "config_identity.migrate_skip",
+            message: "agent config already v2, skipping migration",
+            meta: { agentRoot },
+        });
+        return;
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "config/identity",
+        event: "config_identity.migrate_start",
+        message: "migrating agent config v1 → v2",
+        meta: { agentRoot },
+    });
+    const provider = config.provider;
+    let model = "";
+    if (provider) {
+        const secretsPath = resolveSecretsPath(agentRoot, deps);
+        try {
+            const secretsRaw = fs.readFileSync(secretsPath, "utf-8");
+            const secrets = JSON.parse(secretsRaw);
+            const providers = secrets.providers;
+            if (providers) {
+                const providerSecrets = providers[provider];
+                if (providerSecrets) {
+                    /* v8 ignore next -- fallback: all known providers are in MODEL_FIELD @preserve */
+                    const fieldName = MODEL_FIELD[provider] ?? "model";
+                    const rawModel = providerSecrets[fieldName];
+                    model = typeof rawModel === "string" ? rawModel : "";
+                    // Strip model from secrets
+                    delete providerSecrets[fieldName];
+                    fs.writeFileSync(secretsPath, JSON.stringify(secrets, null, 2) + "\n", "utf-8");
+                }
+            }
+        }
+        catch {
+            // Missing or malformed secrets.json — leave model as empty string
+        }
+    }
+    // Write v2 config
+    const { provider: _removed, ...rest } = config;
+    const v2Config = {
+        ...rest,
+        version: 2,
+        humanFacing: { provider: provider ?? "anthropic", model },
+        agentFacing: { provider: provider ?? "anthropic", model },
+    };
+    fs.writeFileSync(configPath, JSON.stringify(v2Config, null, 2) + "\n", "utf-8");
+    (0, runtime_1.emitNervesEvent)({
+        component: "config/identity",
+        event: "config_identity.migrate_end",
+        message: "agent config migration complete",
+        meta: { agentRoot, provider: provider ?? "unknown", model },
+    });
+}

package/dist/heart/model-capabilities.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_CAPABILITIES = void 0;
+exports.getModelCapabilities = getModelCapabilities;
+const runtime_1 = require("../nerves/runtime");
+exports.MODEL_CAPABILITIES = {
+    "claude-opus-4-6": {
+        reasoningEffort: ["low", "medium", "high", "max"],
+        thinkingFormat: "anthropic",
+        maxOutputTokens: 128000,
+    },
+    "claude-sonnet-4-6": {
+        reasoningEffort: ["low", "medium", "high"],
+        thinkingFormat: "anthropic",
+        maxOutputTokens: 64000,
+    },
+    "claude-opus-4.6": {
+        reasoningEffort: ["low", "medium", "high", "max"],
+        maxOutputTokens: 128000,
+    },
+    "claude-sonnet-4.6": {
+        reasoningEffort: ["low", "medium", "high"],
+        maxOutputTokens: 64000,
+    },
+    "gpt-5.4": {
+        reasoningEffort: ["low", "medium", "high"],
+        phase: true,
+        maxOutputTokens: 100000,
+    },
+    "gpt-5.3-codex": {
+        reasoningEffort: ["low", "medium", "high"],
+        phase: true,
+        maxOutputTokens: 100000,
+    },
+};
+const EMPTY_CAPABILITIES = Object.freeze({});
+function getModelCapabilities(modelId) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.model_capabilities_lookup",
+        message: `model capabilities lookup: ${modelId}`,
+        meta: { modelId, found: modelId in exports.MODEL_CAPABILITIES },
+    });
+    const entry = exports.MODEL_CAPABILITIES[modelId];
+    if (entry)
+        return entry;
+    return { ...EMPTY_CAPABILITIES };
+}

package/dist/heart/obligations.js

@@ -0,0 +1,225 @@
+"use strict";
+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.isOpenObligationStatus = isOpenObligationStatus;
+exports.isOpenObligation = isOpenObligation;
+exports.createObligation = createObligation;
+exports.readObligations = readObligations;
+exports.readPendingObligations = readPendingObligations;
+exports.advanceObligation = advanceObligation;
+exports.fulfillObligation = fulfillObligation;
+exports.findPendingObligationForOrigin = findPendingObligationForOrigin;
+exports.enrichObligation = enrichObligation;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const sync_1 = require("./sync");
+function obligationsDir(agentRoot) {
+    return path.join(agentRoot, "arc", "obligations");
+}
+function obligationFilePath(agentRoot, id) {
+    return path.join(obligationsDir(agentRoot), `${id}.json`);
+}
+function generateId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 10);
+    return `${timestamp}-${random}`;
+}
+function isOpenObligationStatus(status) {
+    return status !== "fulfilled";
+}
+function isOpenObligation(obligation) {
+    return isOpenObligationStatus(obligation.status);
+}
+function createObligation(agentRoot, input) {
+    const now = new Date().toISOString();
+    const id = generateId();
+    const obligation = {
+        id,
+        origin: input.origin,
+        ...(input.bridgeId ? { bridgeId: input.bridgeId } : {}),
+        content: input.content,
+        status: "pending",
+        createdAt: now,
+        updatedAt: now,
+    };
+    const dir = obligationsDir(agentRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = obligationFilePath(agentRoot, id);
+    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf-8");
+    (0, sync_1.trackSyncWrite)(filePath);
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.obligation_created",
+        message: "obligation created",
+        meta: {
+            obligationId: id,
+            friendId: input.origin.friendId,
+            channel: input.origin.channel,
+            key: input.origin.key,
+        },
+    });
+    return obligation;
+}
+function readObligations(agentRoot) {
+    const dir = obligationsDir(agentRoot);
+    if (!fs.existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        /* v8 ignore next -- defensive: readdirSync race after existsSync @preserve */
+        return [];
+    }
+    const jsonFiles = entries.filter((entry) => entry.endsWith(".json")).sort();
+    const obligations = [];
+    for (const file of jsonFiles) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.id === "string" && typeof parsed.content === "string") {
+                obligations.push(parsed);
+            }
+        }
+        catch {
+            // skip malformed files
+        }
+    }
+    return obligations;
+}
+function readPendingObligations(agentRoot) {
+    return readObligations(agentRoot).filter(isOpenObligation);
+}
+function advanceObligation(agentRoot, obligationId, update) {
+    const filePath = obligationFilePath(agentRoot, obligationId);
+    let obligation;
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        obligation = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    const previousStatus = obligation.status;
+    if (update.status) {
+        obligation.status = update.status;
+        if (update.status === "fulfilled") {
+            obligation.fulfilledAt = new Date().toISOString();
+        }
+    }
+    if (update.currentSurface) {
+        obligation.currentSurface = update.currentSurface;
+    }
+    if (typeof update.currentArtifact === "string") {
+        obligation.currentArtifact = update.currentArtifact;
+    }
+    if (typeof update.nextAction === "string") {
+        obligation.nextAction = update.nextAction;
+    }
+    if (typeof update.latestNote === "string") {
+        obligation.latestNote = update.latestNote;
+    }
+    obligation.updatedAt = new Date().toISOString();
+    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf-8");
+    (0, sync_1.trackSyncWrite)(filePath);
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.obligation_advanced",
+        message: "obligation advanced",
+        meta: {
+            obligationId,
+            previousStatus,
+            status: obligation.status,
+            friendId: obligation.origin.friendId,
+            channel: obligation.origin.channel,
+            key: obligation.origin.key,
+            surfaceKind: obligation.currentSurface?.kind ?? null,
+            surfaceLabel: obligation.currentSurface?.label ?? null,
+        },
+    });
+}
+function fulfillObligation(agentRoot, obligationId) {
+    advanceObligation(agentRoot, obligationId, { status: "fulfilled" });
+    const filePath = obligationFilePath(agentRoot, obligationId);
+    let obligation;
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        obligation = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.obligation_fulfilled",
+        message: "obligation fulfilled",
+        meta: {
+            obligationId,
+            friendId: obligation.origin.friendId,
+            channel: obligation.origin.channel,
+            key: obligation.origin.key,
+        },
+    });
+}
+function findPendingObligationForOrigin(agentRoot, origin) {
+    return readPendingObligations(agentRoot).find((ob) => ob.origin.friendId === origin.friendId
+        && ob.origin.channel === origin.channel
+        && ob.origin.key === origin.key);
+}
+function enrichObligation(agentRoot, id, meaning) {
+    const filePath = obligationFilePath(agentRoot, id);
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Obligation not found: ${id}`);
+    }
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const obligation = JSON.parse(raw);
+    obligation.meaning = meaning;
+    obligation.updatedAt = new Date().toISOString();
+    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf-8");
+    (0, sync_1.trackSyncWrite)(filePath);
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.obligation_enriched",
+        message: "obligation enriched with meaning",
+        meta: {
+            obligationId: id,
+            salience: meaning.salience,
+            stalenessClass: meaning.stalenessClass,
+        },
+    });
+    return obligation;
+}