@ouro.bot/cli 0.1.0-alpha.184 → 0.1.0-alpha.186

package/dist/heart/intentions.js

@@ -0,0 +1,168 @@
+"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");
+function intentionsDir(agentRoot) {
+    return path.join(agentRoot, "state", "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 });
+    fs.writeFileSync(intentionFilePath(agentRoot, id), JSON.stringify(intention, null, 2), "utf-8");
+    (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) {
+    fs.writeFileSync(intentionFilePath(agentRoot, intention.id), JSON.stringify(intention, null, 2), "utf-8");
+}
+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/obligations.js

@@ -41,6 +41,7 @@ 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");
@@ -195,3 +196,25 @@ function findPendingObligationForOrigin(agentRoot, origin) {
         && 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, 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;
+}

package/dist/heart/presence.js

@@ -0,0 +1,185 @@
+"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.derivePresence = derivePresence;
+exports.writePresence = writePresence;
+exports.readPresence = readPresence;
+exports.readPeerPresence = readPeerPresence;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const runtime_1 = require("../nerves/runtime");
+function presenceDir(agentRoot) {
+    return path.join(agentRoot, "state", "presence");
+}
+function deriveAvailability(inputs) {
+    if (inputs.currentTempo === "crisis")
+        return "dnd";
+    if (inputs.activeSessions > 0)
+        return "active";
+    if (inputs.openObligations > 0)
+        return "idle";
+    return "away";
+}
+function deriveLane(inputs) {
+    const hasCoding = inputs.codingLanes > 0;
+    const hasBridges = inputs.activeBridges > 0;
+    if (hasCoding && hasBridges)
+        return "mixed";
+    if (hasCoding)
+        return "coding";
+    if (hasBridges)
+        return "conversation";
+    return "idle";
+}
+function deriveMission(inputs) {
+    const parts = [];
+    if (inputs.openObligations > 0) {
+        parts.push(`${inputs.openObligations} open obligation${inputs.openObligations !== 1 ? "s" : ""}`);
+    }
+    if (inputs.activeBridges > 0) {
+        parts.push(`${inputs.activeBridges} active bridge${inputs.activeBridges !== 1 ? "s" : ""}`);
+    }
+    if (inputs.codingLanes > 0) {
+        parts.push(`${inputs.codingLanes} coding lane${inputs.codingLanes !== 1 ? "s" : ""}`);
+    }
+    if (parts.length === 0)
+        return "no active work";
+    return parts.join(", ");
+}
+function derivePresence(_agentRoot, agentName, inputs) {
+    const presence = {
+        agentName,
+        availability: deriveAvailability(inputs),
+        lane: deriveLane(inputs),
+        mission: deriveMission(inputs),
+        tempo: inputs.currentTempo,
+        updatedAt: new Date().toISOString(),
+    };
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.presence_derived",
+        message: `presence derived: ${presence.availability}/${presence.lane}`,
+        meta: {
+            agentName,
+            availability: presence.availability,
+            lane: presence.lane,
+            tempo: presence.tempo,
+        },
+    });
+    return presence;
+}
+function writePresence(agentRoot, _agentName, presence) {
+    const dir = presenceDir(agentRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, "self.json"), JSON.stringify(presence, null, 2), "utf-8");
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.presence_written",
+        message: `presence written for ${presence.agentName}`,
+        meta: { agentName: presence.agentName },
+    });
+}
+function readPresence(agentRoot, _agentName) {
+    const filePath = path.join(presenceDir(agentRoot), "self.json");
+    if (!fs.existsSync(filePath)) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "heart",
+            event: "heart.presence_read",
+            message: "presence file not found",
+            meta: { found: false },
+        });
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const presence = JSON.parse(raw);
+        (0, runtime_1.emitNervesEvent)({
+            component: "heart",
+            event: "heart.presence_read",
+            message: `presence read: ${presence.availability}`,
+            meta: { agentName: presence.agentName, found: true },
+        });
+        return presence;
+    }
+    catch {
+        (0, runtime_1.emitNervesEvent)({
+            component: "heart",
+            event: "heart.presence_read_error",
+            message: "failed to read presence file",
+            meta: { error: "parse error" },
+        });
+        return null;
+    }
+}
+function readPeerPresence(agentRoot) {
+    const relDir = path.join(agentRoot, "state", "relationships");
+    if (!fs.existsSync(relDir)) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "heart",
+            event: "heart.peer_presence_read",
+            message: "no relationships directory, no peers",
+            meta: { peerCount: 0 },
+        });
+        return [];
+    }
+    const files = fs.readdirSync(relDir).filter((f) => f.endsWith(".json"));
+    const peers = [];
+    for (const file of files) {
+        try {
+            const raw = fs.readFileSync(path.join(relDir, file), "utf-8");
+            const rel = JSON.parse(raw);
+            const peerName = rel.agentName;
+            // Read peer's presence from their bundle
+            const peerRoot = path.join(os.homedir(), "AgentBundles", `${peerName}.ouro`);
+            const peerPresencePath = path.join(peerRoot, "state", "presence", "self.json");
+            if (fs.existsSync(peerPresencePath)) {
+                const presenceRaw = fs.readFileSync(peerPresencePath, "utf-8");
+                const presence = JSON.parse(presenceRaw);
+                peers.push(presence);
+            }
+        }
+        catch {
+            // Skip peers with unreadable data
+        }
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.peer_presence_read",
+        message: `read ${peers.length} peer presence records`,
+        meta: { peerCount: peers.length },
+    });
+    return peers;
+}

package/dist/heart/tempo.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMPO_BUDGETS = void 0;
+exports.deriveTempo = deriveTempo;
+exports.getTokenBudget = getTokenBudget;
+exports.detectTempoShift = detectTempoShift;
+const runtime_1 = require("../nerves/runtime");
+exports.TEMPO_BUDGETS = {
+    brief: { min: 150, max: 250 },
+    standard: { min: 450, max: 700 },
+    dense: { min: 900, max: 1100 },
+    crisis: { min: 700, max: 1000 },
+};
+const FIVE_MINUTES_MS = 5 * 60 * 1000;
+const TWO_HOURS_MS = 2 * 60 * 60 * 1000;
+function deriveMode(inputs) {
+    if (inputs.hasBlockers)
+        return "crisis";
+    if (inputs.openObligations > 3 || inputs.recentEpisodeCount > 10)
+        return "dense";
+    if (inputs.activeSessions > 0)
+        return "standard";
+    return "brief";
+}
+function deriveSignificance(inputs) {
+    if (inputs.highSalienceEpisodes > 0 || inputs.atRiskCareCount > 0)
+        return "high";
+    if (inputs.activeCareCount > 0)
+        return "medium";
+    return "low";
+}
+function deriveReentryDepth(inputs) {
+    if (inputs.lastActivityAgeMs < FIVE_MINUTES_MS)
+        return "warm";
+    if (inputs.lastActivityAgeMs < TWO_HOURS_MS)
+        return "cooled";
+    return "cold";
+}
+function computeEffectiveBudget(mode, significance, reentryDepth) {
+    const base = exports.TEMPO_BUDGETS[mode];
+    // Crisis always uses crisis budget regardless
+    if (mode === "crisis")
+        return { ...base };
+    const range = base.max - base.min;
+    // Start at the mode minimum
+    let effectiveMin = base.min;
+    // Significance pushes up within range
+    if (significance === "high") {
+        effectiveMin += Math.round(range * 0.5);
+    }
+    else if (significance === "medium") {
+        effectiveMin += Math.round(range * 0.25);
+    }
+    // Cold re-entry pushes up (need more context to re-orient)
+    if (reentryDepth === "cold") {
+        effectiveMin += Math.round(range * 0.3);
+    }
+    else if (reentryDepth === "cooled") {
+        effectiveMin += Math.round(range * 0.1);
+    }
+    // Clamp within mode range
+    effectiveMin = Math.min(effectiveMin, base.max);
+    return { min: effectiveMin, max: base.max };
+}
+function deriveTempo(inputs) {
+    const mode = deriveMode(inputs);
+    const significance = deriveSignificance(inputs);
+    const reentryDepth = deriveReentryDepth(inputs);
+    const effectiveBudget = computeEffectiveBudget(mode, significance, reentryDepth);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.tempo_derived",
+        message: `tempo derived: ${mode}/${significance}/${reentryDepth}`,
+        meta: {
+            mode,
+            significance,
+            reentryDepth,
+            effectiveMin: effectiveBudget.min,
+            effectiveMax: effectiveBudget.max,
+        },
+    });
+    return { mode, significance, reentryDepth, effectiveBudget };
+}
+function getTokenBudget(state) {
+    return state.effectiveBudget;
+}
+function detectTempoShift(previous, current) {
+    if (!previous)
+        return true;
+    return (previous.mode !== current.mode
+        || previous.significance !== current.significance
+        || previous.reentryDepth !== current.reentryDepth);
+}

package/dist/heart/temporal-view.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTemporalView = buildTemporalView;
+const runtime_1 = require("../nerves/runtime");
+const episodes_1 = require("../mind/episodes");
+const obligations_1 = require("./obligations");
+const cares_1 = require("./cares");
+const intentions_1 = require("./intentions");
+const presence_1 = require("./presence");
+function buildTemporalView(agentRoot, options) {
+    const episodeLimit = options?.episodeLimit ?? 20;
+    const tempo = options?.tempo ?? "brief";
+    const recentEpisodes = options?.preloaded?.recentEpisodes ?? (0, episodes_1.readRecentEpisodes)(agentRoot, { limit: episodeLimit });
+    const activeObligations = options?.preloaded?.activeObligations ?? (0, obligations_1.readPendingObligations)(agentRoot);
+    const activeCares = options?.preloaded?.activeCares ?? (0, cares_1.readActiveCares)(agentRoot);
+    const openIntentions = (0, intentions_1.readOpenIntentions)(agentRoot);
+    const peerPresence = (0, presence_1.readPeerPresence)(agentRoot);
+    const view = {
+        recentEpisodes,
+        activeObligations,
+        activeCares,
+        openIntentions,
+        peerPresence,
+        tempo,
+        assembledAt: new Date().toISOString(),
+    };
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.temporal_view_assembled",
+        message: `temporal view assembled: ${recentEpisodes.length} episodes, ${activeObligations.length} obligations, ${activeCares.length} cares, ${openIntentions.length} intentions`,
+        meta: {
+            episodeCount: recentEpisodes.length,
+            obligationCount: activeObligations.length,
+            careCount: activeCares.length,
+            intentionCount: openIntentions.length,
+            peerCount: peerPresence.length,
+            tempo,
+        },
+    });
+    return view;
+}