@ouro.bot/cli 0.1.0-alpha.21 → 0.1.0-alpha.210

package/dist/heart/commitments.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveCommitments = deriveCommitments;
+exports.formatCommitments = formatCommitments;
+const obligations_1 = require("../arc/obligations");
+const runtime_1 = require("../nerves/runtime");
+function describeActiveObligation(obligation) {
+    if (obligation.status === "pending") {
+        return `i owe ${obligation.origin.friendId}: ${obligation.content}`;
+    }
+    const surface = obligation.currentSurface?.label;
+    const statusText = obligation.status.replaceAll("_", " ");
+    if (surface) {
+        return `i owe ${obligation.origin.friendId}: ${obligation.content} (${statusText} in ${surface})`;
+    }
+    return `i owe ${obligation.origin.friendId}: ${obligation.content} (${statusText})`;
+}
+function deriveCommitments(activeWorkFrame, innerJob, pendingObligations) {
+    const committedTo = [];
+    const completionCriteria = [];
+    const safeToIgnore = [];
+    // Persistent obligations from the obligation store
+    // Sort by status priority: investigating/waiting/updating before pending
+    if (pendingObligations && pendingObligations.length > 0) {
+        const sorted = [...pendingObligations].sort((a, b) => {
+            const advancedA = a.status !== "pending" && a.status !== "fulfilled" ? 0 : 1;
+            const advancedB = b.status !== "pending" && b.status !== "fulfilled" ? 0 : 1;
+            return advancedA - advancedB;
+        });
+        let hasAdvancedObligation = false;
+        for (const ob of sorted) {
+            if (!(0, obligations_1.isOpenObligationStatus)(ob.status))
+                continue;
+            committedTo.push(describeActiveObligation(ob));
+            if (ob.status !== "pending")
+                hasAdvancedObligation = true;
+        }
+        completionCriteria.push("fulfill my outstanding obligations");
+        if (hasAdvancedObligation) {
+            completionCriteria.push("close my active obligation loops");
+        }
+    }
+    // Inner job
+    if (innerJob.status === "queued" || innerJob.status === "running") {
+        const contentSuffix = innerJob.content ? ` -- ${innerJob.content.slice(0, 60)}` : "";
+        committedTo.push(`i'm thinking through something privately${contentSuffix}`);
+    }
+    else if (innerJob.status === "surfaced") {
+        committedTo.push("i finished thinking about something and need to bring it back");
+    }
+    // mustResolveBeforeHandoff
+    if (activeWorkFrame.mustResolveBeforeHandoff) {
+        committedTo.push("i need to finish what i started before moving on");
+        completionCriteria.push("resolve the current thread before moving on");
+    }
+    // Bridges
+    for (const bridge of activeWorkFrame.bridges) {
+        committedTo.push(`i have shared work: ${bridge.summary || bridge.objective}`);
+    }
+    if (activeWorkFrame.bridges.length > 0) {
+        completionCriteria.push("keep shared work aligned across sessions");
+    }
+    // Tasks
+    for (const taskName of activeWorkFrame.taskPressure?.liveTaskNames ?? []) {
+        committedTo.push(`i'm tracking: ${taskName}`);
+    }
+    // Obligation completion criteria
+    if (innerJob.obligationStatus === "pending") {
+        const name = innerJob.origin?.friendName ?? innerJob.origin?.friendId ?? "them";
+        completionCriteria.push(`bring my answer back to ${name}`);
+    }
+    // Default completion criteria
+    if (completionCriteria.length === 0) {
+        completionCriteria.push("just be present in this conversation");
+    }
+    // Safe to ignore
+    if (innerJob.status === "idle" && !(activeWorkFrame.inner?.hasPending)) {
+        safeToIgnore.push("no private thinking in progress");
+    }
+    if (activeWorkFrame.bridges.length === 0) {
+        safeToIgnore.push("no shared work to coordinate");
+    }
+    if ((activeWorkFrame.taskPressure?.liveTaskNames ?? []).length === 0) {
+        safeToIgnore.push("no active tasks to track");
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.commitments_derive",
+        message: "derived commitments frame",
+        meta: { committedCount: committedTo.length, criteriaCount: completionCriteria.length },
+    });
+    return { committedTo, completionCriteria, safeToIgnore };
+}
+function formatCommitments(commitments) {
+    const sections = [];
+    if (commitments.committedTo.length === 0) {
+        sections.push("i'm not holding anything specific right now. i'm free to be present.");
+    }
+    else {
+        sections.push("## what i'm holding right now");
+        sections.push("");
+        sections.push(commitments.committedTo.map((c) => `- ${c}`).join("\n"));
+    }
+    sections.push("");
+    sections.push("## what \"done\" looks like");
+    sections.push(commitments.completionCriteria.map((c) => `- ${c}`).join("\n"));
+    sections.push("");
+    sections.push("## what i can let go of");
+    sections.push(commitments.safeToIgnore.map((c) => `- ${c}`).join("\n"));
+    return sections.join("\n");
+}

package/dist/heart/config-registry.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_REGISTRY = void 0;
+exports.getRegistryEntries = getRegistryEntries;
+exports.getRegistryEntriesByTier = getRegistryEntriesByTier;
+exports.getRegistryEntriesByTopic = getRegistryEntriesByTopic;
+exports.getRegistryEntry = getRegistryEntry;
+const runtime_1 = require("../nerves/runtime");
+// --- Validation helpers ---
+const KNOWN_PROVIDERS = ["anthropic", "azure", "minimax", "openai-codex", "github-copilot"];
+function validateNumber(value) {
+    if (typeof value !== "number")
+        return `expected number, got ${typeof value}`;
+    return undefined;
+}
+function validateBoolean(value) {
+    if (typeof value !== "boolean")
+        return `expected boolean, got ${typeof value}`;
+    return undefined;
+}
+function validateString(value) {
+    if (typeof value !== "string")
+        return `expected string, got ${typeof value}`;
+    return undefined;
+}
+function validateStringEnum(allowed) {
+    return (value) => {
+        if (typeof value !== "string")
+            return `expected string, got ${typeof value}`;
+        if (!allowed.includes(value))
+            return `expected one of [${allowed.join(", ")}], got "${value}"`;
+        return undefined;
+    };
+}
+function validateInteger(min, max) {
+    return (value) => {
+        if (typeof value !== "number")
+            return `expected number, got ${typeof value}`;
+        if (!Number.isInteger(value))
+            return `expected integer, got ${value}`;
+        if (value < min || value > max)
+            return `expected integer between ${min} and ${max}, got ${value}`;
+        return undefined;
+    };
+}
+function validateStringArray(value) {
+    if (!Array.isArray(value))
+        return `expected array, got ${typeof value}`;
+    for (let i = 0; i < value.length; i++) {
+        if (typeof value[i] !== "string")
+            return `expected string at index ${i}, got ${typeof value[i]}`;
+    }
+    return undefined;
+}
+function validateStringEnumArray(allowed) {
+    return (value) => {
+        if (!Array.isArray(value))
+            return `expected array, got ${typeof value}`;
+        for (let i = 0; i < value.length; i++) {
+            if (typeof value[i] !== "string")
+                return `expected string at index ${i}, got ${typeof value[i]}`;
+            if (!allowed.includes(value[i]))
+                return `expected one of [${allowed.join(", ")}] at index ${i}, got "${value[i]}"`;
+        }
+        return undefined;
+    };
+}
+function validateObject(requiredFields) {
+    return (value) => {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            return `expected object, got ${Array.isArray(value) ? "array" : typeof value}`;
+        }
+        const obj = value;
+        for (const [field, validator] of Object.entries(requiredFields)) {
+            if (!(field in obj))
+                return `missing required field "${field}"`;
+            const err = validator(obj[field]);
+            if (err)
+                return `field "${field}": ${err}`;
+        }
+        return undefined;
+    };
+}
+const registryData = [
+    // --- Tier 3: Operator-only ---
+    {
+        path: "version",
+        tier: 3,
+        description: "Agent config schema version. Must be an integer >= 1.",
+        default: 2,
+        effects: "Controls which config migrations apply on load. Changing incorrectly can corrupt config.",
+        topics: ["schema", "migration"],
+        validate: validateNumber,
+    },
+    {
+        path: "enabled",
+        tier: 3,
+        description: "Whether the agent is enabled. When false, the agent refuses to start.",
+        default: true,
+        effects: "Disables all agent functionality when set to false.",
+        topics: ["lifecycle", "activation"],
+        validate: validateBoolean,
+    },
+    {
+        path: "mcpServers",
+        tier: 3,
+        description: "MCP server configurations. Maps server name to command, args, and env.",
+        default: undefined,
+        effects: "Adds or removes MCP tool servers. Incorrect config can expose the agent to untrusted tool sources.",
+        topics: ["tools", "mcp", "servers", "extensions"],
+    },
+    // --- Tier 2: Proposal ---
+    {
+        path: "humanFacing.provider",
+        tier: 2,
+        description: "Provider for human-facing interactions (CLI, Teams, BlueBubbles).",
+        default: "anthropic",
+        effects: "Changes the LLM provider used for all human-facing conversations. Affects quality, latency, and cost.",
+        topics: ["model", "provider", "llm", "human"],
+        validate: validateStringEnum(KNOWN_PROVIDERS),
+    },
+    {
+        path: "humanFacing.model",
+        tier: 2,
+        description: "Model name for human-facing interactions.",
+        default: "claude-opus-4-6",
+        effects: "Changes the specific model used for human-facing conversations.",
+        topics: ["model", "provider", "llm", "human"],
+        validate: validateString,
+    },
+    {
+        path: "agentFacing.provider",
+        tier: 2,
+        description: "Provider for agent-facing interactions (inner dialog, delegation).",
+        default: "anthropic",
+        effects: "Changes the LLM provider used for inner dialog and agent-to-agent communication.",
+        topics: ["model", "provider", "llm", "agent", "inner-dialog"],
+        validate: validateStringEnum(KNOWN_PROVIDERS),
+    },
+    {
+        path: "agentFacing.model",
+        tier: 2,
+        description: "Model name for agent-facing interactions.",
+        default: "claude-opus-4-6",
+        effects: "Changes the specific model used for inner dialog and agent-to-agent communication.",
+        topics: ["model", "provider", "llm", "agent", "inner-dialog"],
+        validate: validateString,
+    },
+    {
+        path: "context.maxTokens",
+        tier: 2,
+        description: "Maximum context window size in tokens.",
+        default: 80000,
+        effects: "Larger values allow more context but increase cost and latency. Must match model capability.",
+        topics: ["context", "tokens", "memory", "performance"],
+        validate: validateInteger(1000, 1000000),
+    },
+    {
+        path: "senses.cli",
+        tier: 2,
+        description: "CLI sense configuration. Controls whether the CLI interface is enabled.",
+        default: { enabled: true },
+        effects: "Enables or disables the CLI (terminal) interaction channel.",
+        topics: ["senses", "cli", "channels", "interface"],
+        validate: validateObject({ enabled: validateBoolean }),
+    },
+    {
+        path: "senses.teams",
+        tier: 2,
+        description: "Teams sense configuration. Controls whether the Teams interface is enabled.",
+        default: { enabled: false },
+        effects: "Enables or disables the Microsoft Teams interaction channel.",
+        topics: ["senses", "teams", "channels", "interface"],
+        validate: validateObject({ enabled: validateBoolean }),
+    },
+    {
+        path: "senses.bluebubbles",
+        tier: 2,
+        description: "BlueBubbles sense configuration. Controls whether the iMessage interface is enabled.",
+        default: { enabled: false },
+        effects: "Enables or disables the BlueBubbles (iMessage) interaction channel.",
+        topics: ["senses", "bluebubbles", "imessage", "channels", "interface"],
+        validate: validateObject({ enabled: validateBoolean }),
+    },
+    {
+        path: "sync.enabled",
+        tier: 2,
+        description: "Whether git-based bundle sync is enabled.",
+        default: false,
+        effects: "Enables automatic synchronization of agent state via git. Requires sync.remote to be configured.",
+        topics: ["sync", "git", "state", "backup"],
+        validate: validateBoolean,
+    },
+    {
+        path: "sync.remote",
+        tier: 2,
+        description: "Git remote name used for bundle sync.",
+        default: "origin",
+        effects: "Controls which git remote is used when sync is enabled.",
+        topics: ["sync", "git", "remote"],
+        validate: validateString,
+    },
+    // --- Tier 1: Self-service ---
+    {
+        path: "context.contextMargin",
+        tier: 1,
+        description: "Percentage of context window reserved as margin before compaction triggers.",
+        default: 20,
+        effects: "Higher values trigger compaction earlier, preserving more headroom. Lower values use more context.",
+        topics: ["context", "compaction", "memory", "performance"],
+        validate: validateInteger(0, 100),
+    },
+    {
+        path: "phrases.thinking",
+        tier: 1,
+        description: "Array of phrases displayed while the agent is thinking.",
+        default: ["working"],
+        effects: "Changes the thinking indicator text shown to users. Purely cosmetic.",
+        topics: ["phrases", "ux", "display", "personality"],
+        validate: validateStringArray,
+    },
+    {
+        path: "phrases.tool",
+        tier: 1,
+        description: "Array of phrases displayed while the agent is running a tool.",
+        default: ["running tool"],
+        effects: "Changes the tool-use indicator text shown to users. Purely cosmetic.",
+        topics: ["phrases", "ux", "display", "personality"],
+        validate: validateStringArray,
+    },
+    {
+        path: "phrases.followup",
+        tier: 1,
+        description: "Array of phrases displayed during follow-up processing.",
+        default: ["processing"],
+        effects: "Changes the follow-up indicator text shown to users. Purely cosmetic.",
+        topics: ["phrases", "ux", "display", "personality"],
+        validate: validateStringArray,
+    },
+    {
+        path: "shell.defaultTimeout",
+        tier: 1,
+        description: "Default timeout in milliseconds for shell command execution.",
+        default: undefined,
+        effects: "Controls how long shell commands run before timing out. Undefined uses system default.",
+        topics: ["shell", "timeout", "execution", "tools"],
+        validate: validateInteger(1000, 600000),
+    },
+    {
+        path: "logging.level",
+        tier: 1,
+        description: "Minimum log level: debug, info, warn, or error.",
+        default: undefined,
+        effects: "Controls verbosity of runtime logging. Lower levels produce more output.",
+        topics: ["logging", "debug", "diagnostics"],
+        validate: validateStringEnum(["debug", "info", "warn", "error"]),
+    },
+    {
+        path: "logging.sinks",
+        tier: 1,
+        description: "Array of log sink types: 'terminal' and/or 'ndjson'.",
+        default: undefined,
+        effects: "Controls where log output is directed. Terminal shows in console, ndjson writes structured logs.",
+        topics: ["logging", "output", "diagnostics"],
+        validate: validateStringEnumArray(["terminal", "ndjson"]),
+    },
+];
+exports.CONFIG_REGISTRY = new Map(registryData.map((entry) => [entry.path, entry]));
+function getRegistryEntries() {
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "config_registry.access",
+        message: "listing all registry entries",
+        meta: { count: exports.CONFIG_REGISTRY.size },
+    });
+    return [...exports.CONFIG_REGISTRY.values()];
+}
+function getRegistryEntriesByTier(tier) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "config_registry.access",
+        message: `filtering registry entries by tier ${tier}`,
+        meta: { tier },
+    });
+    return [...exports.CONFIG_REGISTRY.values()].filter((entry) => entry.tier === tier);
+}
+function getRegistryEntriesByTopic(topic) {
+    const needle = topic.toLowerCase();
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "config_registry.access",
+        message: `filtering registry entries by topic "${topic}"`,
+        meta: { topic },
+    });
+    return [...exports.CONFIG_REGISTRY.values()].filter((entry) => entry.topics.some((t) => t.toLowerCase().includes(needle)));
+}
+function getRegistryEntry(path) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "config_registry.access",
+        message: `looking up registry entry for "${path}"`,
+        meta: { path },
+    });
+    return exports.CONFIG_REGISTRY.get(path);
+}

package/dist/heart/config.js

@@ -40,6 +40,8 @@ exports.getAzureConfig = getAzureConfig;
 exports.getMinimaxConfig = getMinimaxConfig;
 exports.getAnthropicConfig = getAnthropicConfig;
 exports.getOpenAICodexConfig = getOpenAICodexConfig;
+exports.getGithubCopilotConfig = getGithubCopilotConfig;
+exports.getProviderConfig = getProviderConfig;
 exports.getTeamsConfig = getTeamsConfig;
 exports.getTeamsSecondaryConfig = getTeamsSecondaryConfig;
 exports.getContextConfig = getContextConfig;
@@ -49,38 +51,40 @@ exports.getTeamsChannelConfig = getTeamsChannelConfig;
 exports.getBlueBubblesConfig = getBlueBubblesConfig;
 exports.getBlueBubblesChannelConfig = getBlueBubblesChannelConfig;
 exports.getIntegrationsConfig = getIntegrationsConfig;
+exports.getSyncConfig = getSyncConfig;
 exports.getOpenAIEmbeddingsApiKey = getOpenAIEmbeddingsApiKey;
 exports.getLogsDir = getLogsDir;
+exports.sanitizeKey = sanitizeKey;
+exports.slugify = slugify;
+exports.resolveSessionPath = resolveSessionPath;
 exports.sessionPath = sessionPath;
 exports.logPath = logPath;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const os = __importStar(require("os"));
 const identity_1 = require("./identity");
 const runtime_1 = require("../nerves/runtime");
 const DEFAULT_SECRETS_TEMPLATE = {
     providers: {
-        // Keep provider field ordering consistent: model first, then auth credentials,
-        // then provider-specific transport fields.
         azure: {
-            modelName: "",
             apiKey: "",
             endpoint: "",
             deployment: "",
             apiVersion: "2025-04-01-preview",
+            managedIdentityClientId: "",
         },
         minimax: {
-            model: "",
             apiKey: "",
         },
         anthropic: {
-            model: "claude-opus-4-6",
             setupToken: "",
         },
         "openai-codex": {
-            model: "gpt-5.4",
             oauthAccessToken: "",
         },
+        "github-copilot": {
+            githubToken: "",
+            baseUrl: "",
+        },
     },
     teams: {
         clientId: "",
@@ -125,6 +129,7 @@ function defaultRuntimeConfig() {
             minimax: { ...DEFAULT_SECRETS_TEMPLATE.providers.minimax },
             anthropic: { ...DEFAULT_SECRETS_TEMPLATE.providers.anthropic },
             "openai-codex": { ...DEFAULT_SECRETS_TEMPLATE.providers["openai-codex"] },
+            "github-copilot": { ...DEFAULT_SECRETS_TEMPLATE.providers["github-copilot"] },
         },
         teams: { ...DEFAULT_SECRETS_TEMPLATE.teams },
         teamsSecondary: { ...DEFAULT_SECRETS_TEMPLATE.teamsSecondary },
@@ -136,7 +141,7 @@ function defaultRuntimeConfig() {
         integrations: { ...DEFAULT_SECRETS_TEMPLATE.integrations },
     };
 }
-let _cachedConfig = null;
+let _runtimeConfigOverride = null;
 let _testContextOverride = null;
 function resolveConfigPath() {
     return (0, identity_1.getAgentSecretsPath)();
@@ -158,15 +163,6 @@ function deepMerge(defaults, partial) {
     return result;
 }
 function loadConfig() {
-    if (_cachedConfig) {
-        (0, runtime_1.emitNervesEvent)({
-            event: "config.load",
-            component: "config/identity",
-            message: "config loaded from cache",
-            meta: { source: "cache" },
-        });
-        return _cachedConfig;
-    }
     const configPath = resolveConfigPath();
     // Auto-create config directory if it doesn't exist
     const configDir = path.dirname(configPath);
@@ -227,7 +223,10 @@ function loadConfig() {
             },
         });
     }
-    _cachedConfig = deepMerge(defaultRuntimeConfig(), sanitizedFileData);
+    const mergedConfig = deepMerge(defaultRuntimeConfig(), sanitizedFileData);
+    const config = _runtimeConfigOverride
+        ? deepMerge(mergedConfig, _runtimeConfigOverride)
+        : mergedConfig;
     (0, runtime_1.emitNervesEvent)({
         event: "config.load",
         component: "config/identity",
@@ -235,22 +234,22 @@ function loadConfig() {
         meta: {
             source: "disk",
             used_defaults_only: Object.keys(fileData).length === 0,
+            override_applied: _runtimeConfigOverride !== null,
         },
     });
-    return _cachedConfig;
+    return config;
 }
 function resetConfigCache() {
-    _cachedConfig = null;
+    _runtimeConfigOverride = null;
     _testContextOverride = null;
 }
 function patchRuntimeConfig(partial) {
-    loadConfig(); // ensure _cachedConfig exists
     const contextPatch = partial.context;
     if (contextPatch) {
         const base = _testContextOverride ?? identity_1.DEFAULT_AGENT_CONTEXT;
         _testContextOverride = deepMerge(base, contextPatch);
     }
-    _cachedConfig = deepMerge(_cachedConfig, partial);
+    _runtimeConfigOverride = deepMerge((_runtimeConfigOverride ?? {}), partial);
 }
 function getAzureConfig() {
     const config = loadConfig();
@@ -268,6 +267,14 @@ function getOpenAICodexConfig() {
     const config = loadConfig();
     return { ...config.providers["openai-codex"] };
 }
+function getGithubCopilotConfig() {
+    const config = loadConfig();
+    return { ...config.providers["github-copilot"] };
+}
+function getProviderConfig(provider) {
+    const config = loadConfig();
+    return { ...config.providers[provider] };
+}
 function getTeamsConfig() {
     const config = loadConfig();
     return { ...config.teams };
@@ -335,24 +342,46 @@ function getIntegrationsConfig() {
     const config = loadConfig();
     return { ...config.integrations };
 }
+function getSyncConfig() {
+    try {
+        const agentConfig = (0, identity_1.loadAgentConfig)();
+        return {
+            enabled: agentConfig.sync?.enabled ?? false,
+            remote: agentConfig.sync?.remote ?? "origin",
+        };
+    }
+    catch {
+        /* v8 ignore next -- defensive: loadAgentConfig failure in test/bootstrap @preserve */
+        return { enabled: false, remote: "origin" };
+    }
+}
 function getOpenAIEmbeddingsApiKey() {
     return getIntegrationsConfig().openaiEmbeddingsApiKey;
 }
 function getLogsDir() {
-    return path.join(os.homedir(), ".agentstate", (0, identity_1.getAgentName)(), "logs");
+    return path.join((0, identity_1.getAgentRoot)(), "state", "logs");
 }
 function sanitizeKey(key) {
     return key.replace(/[/:]/g, "_");
 }
-function sessionPath(friendId, channel, key) {
-    // On Azure App Service, os.homedir() returns /root which is ephemeral.
-    // Use /home (persistent storage) when WEBSITE_SITE_NAME is set.
-    /* v8 ignore next -- Azure vs local path branch; environment-specific @preserve */
-    const homeBase = process.env.WEBSITE_SITE_NAME ? "/home" : os.homedir();
-    const dir = path.join(homeBase, ".agentstate", (0, identity_1.getAgentName)(), "sessions", friendId, channel);
-    fs.mkdirSync(dir, { recursive: true });
+function slugify(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "");
+}
+function resolveSessionPath(friendId, channel, key, options) {
+    const dir = path.join((0, identity_1.getAgentRoot)(), "state", "sessions", friendId, channel);
+    if (options?.ensureDir) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
     return path.join(dir, sanitizeKey(key) + ".json");
 }
+function sessionPath(friendId, channel, key) {
+    return resolveSessionPath(friendId, channel, key, { ensureDir: true });
+}
 function logPath(channel, key) {
     return path.join(getLogsDir(), channel, sanitizeKey(key) + ".ndjson");
 }