@ouro.bot/cli 0.1.0-alpha.205 → 0.1.0-alpha.207

package/dist/repertoire/tools-shell.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shellToolDefinitions = void 0;
+const child_process_1 = require("child_process");
+const shell_sessions_1 = require("./shell-sessions");
+const identity_1 = require("../heart/identity");
+const runtime_1 = require("../nerves/runtime");
+exports.shellToolDefinitions = [
+    {
+        tool: {
+            type: "function",
+            function: {
+                name: "shell",
+                description: "Run a shell command and return stdout/stderr. Working directory persists between calls. Use dedicated tools instead of shell when available: read_file instead of cat, edit_file instead of sed, glob instead of find, grep instead of grep/rg. Reserve shell for operations that genuinely need the shell: installing packages, running builds/tests, git operations, process management. Be careful with destructive commands -- consider reversibility before running. If a command fails, read the error output before retrying with a different approach.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        command: { type: "string" },
+                        timeout_ms: {
+                            type: "number",
+                            description: "Timeout in milliseconds. Default: 30000. Max: 600000.",
+                        },
+                        background: {
+                            type: "boolean",
+                            description: "Run in background. Returns immediately with a process ID. Use shell_status/shell_tail to monitor.",
+                        },
+                    },
+                    required: ["command"],
+                },
+            },
+        },
+        handler: (a) => {
+            // Destructive pattern detection (friction, not a block)
+            const destructivePatterns = (0, shell_sessions_1.detectDestructivePatterns)(a.command);
+            if (destructivePatterns.length > 0) {
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    event: "tool.shell.destructive_detected",
+                    component: "tools",
+                    message: `destructive pattern detected: ${destructivePatterns.join(", ")}`,
+                    meta: { command: a.command, patterns: destructivePatterns },
+                });
+            }
+            // Background mode: spawn and return immediately
+            if (a.background === "true") {
+                const session = (0, shell_sessions_1.spawnBackgroundShell)(a.command);
+                return JSON.stringify({ id: session.id, command: session.command, status: session.status });
+            }
+            const MAX_TIMEOUT = 600000;
+            const requestedTimeout = Number(a.timeout_ms) || 0;
+            let configDefault = 30000;
+            try {
+                configDefault = (0, identity_1.loadAgentConfig)().shell?.defaultTimeout ?? 30000;
+            }
+            catch { /* test env: no --agent flag */ }
+            const baseTimeout = requestedTimeout > 0 ? requestedTimeout : configDefault;
+            const timeout = Math.min(baseTimeout, MAX_TIMEOUT);
+            const output = (0, child_process_1.execSync)(a.command, {
+                encoding: "utf-8",
+                timeout,
+            });
+            if (destructivePatterns.length > 0) {
+                return `${output}\n\n--- destructive pattern detected: ${destructivePatterns.join(", ")} ---`;
+            }
+            return output;
+        },
+        summaryKeys: ["command"],
+    },
+    {
+        tool: {
+            type: "function",
+            function: {
+                name: "shell_status",
+                description: "Check status of background shell processes. Omit id to list all.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", description: "Background shell process ID" },
+                    },
+                },
+            },
+        },
+        handler: (a) => {
+            if (!a.id) {
+                return JSON.stringify((0, shell_sessions_1.listShellSessions)());
+            }
+            const session = (0, shell_sessions_1.getShellSession)(a.id);
+            if (!session)
+                return `process not found: ${a.id}`;
+            return JSON.stringify(session);
+        },
+        summaryKeys: ["id"],
+    },
+    {
+        tool: {
+            type: "function",
+            function: {
+                name: "shell_tail",
+                description: "Show recent output from a background shell process.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", description: "Background shell process ID" },
+                    },
+                    required: ["id"],
+                },
+            },
+        },
+        handler: (a) => {
+            /* v8 ignore next -- schema requires id, defensive guard @preserve */
+            if (!a.id)
+                return "id is required";
+            const output = (0, shell_sessions_1.tailShellSession)(a.id);
+            if (output === undefined)
+                return `process not found: ${a.id}`;
+            return output || "(no output yet)";
+        },
+        summaryKeys: ["id"],
+    },
+];

package/dist/repertoire/tools-surface.js

@@ -0,0 +1,228 @@
+"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.surfaceToolDefinition = exports.surfaceToolDef = void 0;
+const identity_1 = require("../heart/identity");
+const surface_tool_1 = require("../senses/surface-tool");
+const obligations_1 = require("../heart/obligations");
+const session_activity_1 = require("../heart/session-activity");
+const path = __importStar(require("path"));
+// Surface tool schema — canonical home. Handler lives in senses/surface-tool.ts.
+exports.surfaceToolDef = {
+    type: "function",
+    function: {
+        name: "surface",
+        description: "share a thought outward — deliver an answer, ask a follow-up, or surface progress to whoever needs to hear it. pass delegationId to address a held thought (see your attention queue above), or friendId for spontaneous outreach. does not end your turn.",
+        parameters: {
+            type: "object",
+            properties: {
+                content: {
+                    type: "string",
+                    description: "the message to deliver",
+                },
+                delegationId: {
+                    type: "string",
+                    description: "ID from your attention queue — addresses a specific held thought",
+                },
+                friendId: {
+                    type: "string",
+                    description: "friend to reach out to spontaneously (when not addressing a held thought)",
+                },
+            },
+            required: ["content"],
+        },
+    },
+};
+// Surface tool handler: routes content to friend's freshest session
+/* v8 ignore start -- surface handler wiring: core logic tested via surface-tool.test.ts; this wires identity/routing deps @preserve */
+exports.surfaceToolDefinition = {
+    tool: exports.surfaceToolDef,
+    handler: async (args, ctx) => {
+        const queue = ctx?.delegatedOrigins ?? [];
+        const agentName = (() => { try {
+            return (0, identity_1.getAgentName)();
+        }
+        catch {
+            return "unknown";
+        } })();
+        const routeToFriend = async (friendId, content, queueItem) => {
+            /* v8 ignore start -- routing: integration path tested via inner-dialog routing tests @preserve */
+            try {
+                const agentRoot = (0, identity_1.getAgentRoot)();
+                const sessionsDir = path.join(agentRoot, "state", "sessions");
+                const friendsDir = path.join(agentRoot, "friends");
+                // Priority 1: Bridge-preferred session (if queue item has a bridgeId)
+                if (queueItem?.bridgeId) {
+                    const { createBridgeManager } = await Promise.resolve().then(() => __importStar(require("../heart/bridges/manager")));
+                    const bridge = createBridgeManager().getBridge(queueItem.bridgeId);
+                    if (bridge && bridge.lifecycle !== "completed" && bridge.lifecycle !== "cancelled") {
+                        const allSessions = (0, session_activity_1.listSessionActivity)({ sessionsDir, friendsDir, agentName });
+                        const bridgeTarget = allSessions.find((activity) => activity.friendId === friendId
+                            && activity.channel !== "inner"
+                            && bridge.attachedSessions.some((s) => s.friendId === activity.friendId && s.channel === activity.channel && s.key === activity.key));
+                        if (bridgeTarget) {
+                            // Attempt proactive BB delivery for bridge target
+                            if (bridgeTarget.channel === "bluebubbles") {
+                                const { sendProactiveBlueBubblesMessageToSession } = await Promise.resolve().then(() => __importStar(require("../senses/bluebubbles")));
+                                const proactiveResult = await sendProactiveBlueBubblesMessageToSession({
+                                    friendId: bridgeTarget.friendId,
+                                    sessionKey: bridgeTarget.key,
+                                    text: content,
+                                });
+                                if (proactiveResult.delivered) {
+                                    // Inject surfaced content into the target session so it knows what was delivered
+                                    const { appendSyntheticAssistantMessage } = await Promise.resolve().then(() => __importStar(require("../mind/context")));
+                                    const sessionFilePath = path.join(sessionsDir, bridgeTarget.friendId, bridgeTarget.channel, `${bridgeTarget.key}.json`);
+                                    appendSyntheticAssistantMessage(sessionFilePath, `[surfaced from inner dialog] ${content}`);
+                                    return { status: "delivered", detail: "via iMessage" };
+                                }
+                            }
+                            // Fall back to pending queue for bridge target
+                            const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
+                            const pendingDir = getPendingDir(agentName, bridgeTarget.friendId, bridgeTarget.channel, bridgeTarget.key);
+                            queuePendingMessage(pendingDir, {
+                                from: agentName,
+                                friendId: bridgeTarget.friendId,
+                                channel: bridgeTarget.channel,
+                                key: bridgeTarget.key,
+                                content,
+                                timestamp: Date.now(),
+                            });
+                            return { status: "queued", detail: `for next interaction via ${bridgeTarget.channel}` };
+                        }
+                    }
+                }
+                // Priority 2: Freshest active friend session
+                const freshest = (0, session_activity_1.findFreshestFriendSession)({
+                    sessionsDir,
+                    friendsDir,
+                    agentName,
+                    friendId,
+                    activeOnly: true,
+                });
+                if (freshest && freshest.channel !== "inner") {
+                    // Attempt proactive BB delivery
+                    if (freshest.channel === "bluebubbles") {
+                        const { sendProactiveBlueBubblesMessageToSession } = await Promise.resolve().then(() => __importStar(require("../senses/bluebubbles")));
+                        const proactiveResult = await sendProactiveBlueBubblesMessageToSession({
+                            friendId: freshest.friendId,
+                            sessionKey: freshest.key,
+                            text: content,
+                        });
+                        if (proactiveResult.delivered) {
+                            // Inject surfaced content into the target session so it knows what was delivered
+                            const { appendSyntheticAssistantMessage } = await Promise.resolve().then(() => __importStar(require("../mind/context")));
+                            const sessionFilePath = path.join(sessionsDir, freshest.friendId, freshest.channel, `${freshest.key}.json`);
+                            appendSyntheticAssistantMessage(sessionFilePath, `[surfaced from inner dialog] ${content}`);
+                            return { status: "delivered", detail: "via iMessage" };
+                        }
+                    }
+                    // Queue as pending for next interaction
+                    const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
+                    const pendingDir = getPendingDir(agentName, freshest.friendId, freshest.channel, freshest.key);
+                    queuePendingMessage(pendingDir, {
+                        from: agentName,
+                        friendId: freshest.friendId,
+                        channel: freshest.channel,
+                        key: freshest.key,
+                        content,
+                        timestamp: Date.now(),
+                    });
+                    return { status: "queued", detail: `for next interaction via ${freshest.channel}` };
+                }
+                // Priority 3: Deferred — no active session found
+                const { getDeferredReturnDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
+                const { queuePendingMessage: queueDeferred } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
+                const deferredDir = getDeferredReturnDir(agentName, friendId);
+                queueDeferred(deferredDir, {
+                    from: agentName,
+                    friendId,
+                    channel: "deferred",
+                    key: "return",
+                    content,
+                    timestamp: Date.now(),
+                });
+                return { status: "deferred", detail: "they'll see it next time" };
+            }
+            catch {
+                return { status: "failed" };
+            }
+            /* v8 ignore stop */
+        };
+        return (0, surface_tool_1.handleSurface)({
+            content: args.content ?? "",
+            delegationId: args.delegationId,
+            friendId: args.friendId,
+            queue,
+            routeToFriend,
+            advanceObligation: (obligationId, update) => {
+                /* v8 ignore start -- obligation advance: tested via attention-queue tests @preserve */
+                try {
+                    const name = (() => { try {
+                        return (0, identity_1.getAgentName)();
+                    }
+                    catch {
+                        return "unknown";
+                    } })();
+                    (0, obligations_1.advanceReturnObligation)(name, obligationId, {
+                        status: update.status,
+                        ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
+                        ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
+                    });
+                }
+                catch {
+                    // swallowed — obligation advance must never break surface delivery
+                }
+                /* v8 ignore stop */
+            },
+            fulfillHeartObligation: (origin) => {
+                /* v8 ignore start -- heart obligation fulfillment: tested via surface-tool.test.ts @preserve */
+                try {
+                    const agentRoot = (0, identity_1.getAgentRoot)();
+                    const heartObligation = (0, obligations_1.findPendingObligationForOrigin)(agentRoot, origin);
+                    if (heartObligation) {
+                        (0, obligations_1.fulfillObligation)(agentRoot, heartObligation.id);
+                    }
+                }
+                catch {
+                    // swallowed — heart obligation fulfillment must never break surface delivery
+                }
+                /* v8 ignore stop */
+            },
+        });
+    },
+    summaryKeys: ["content", "delegationId"],
+};
+/* v8 ignore stop */

package/dist/repertoire/tools.js

@@ -1,41 +1,9 @@
 "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.surfaceToolDef = exports.restTool = exports.ponderTool = exports.observeTool = exports.settleTool = exports.tools = void 0;
 exports.getToolsForChannel = getToolsForChannel;
 exports.isConfirmationRequired = isConfirmationRequired;
+exports.isConfirmationAlwaysRequired = isConfirmationAlwaysRequired;
 exports.execTool = execTool;
 exports.summarizeArgs = summarizeArgs;
 exports.buildToolResultSummary = buildToolResultSummary;
@@ -47,10 +15,7 @@ const tools_github_1 = require("./tools-github");
 const runtime_1 = require("../nerves/runtime");
 const guardrails_1 = require("./guardrails");
 const identity_1 = require("../heart/identity");
-const surface_tool_1 = require("../senses/surface-tool");
-const obligations_1 = require("../heart/obligations");
-const session_activity_1 = require("../heart/session-activity");
-const path = __importStar(require("path"));
+const tools_surface_1 = require("./tools-surface");
 function safeGetAgentRoot() {
     try {
         return (0, identity_1.getAgentRoot)();
@@ -66,195 +31,11 @@ Object.defineProperty(exports, "settleTool", { enumerable: true, get: function (
 Object.defineProperty(exports, "observeTool", { enumerable: true, get: function () { return tools_base_2.observeTool; } });
 Object.defineProperty(exports, "ponderTool", { enumerable: true, get: function () { return tools_base_2.ponderTool; } });
 Object.defineProperty(exports, "restTool", { enumerable: true, get: function () { return tools_base_2.restTool; } });
-// Surface tool schema — canonical home. Handler lives in senses/surface-tool.ts.
-exports.surfaceToolDef = {
-    type: "function",
-    function: {
-        name: "surface",
-        description: "share a thought outward — deliver an answer, ask a follow-up, or surface progress to whoever needs to hear it. pass delegationId to address a held thought (see your attention queue above), or friendId for spontaneous outreach. does not end your turn.",
-        parameters: {
-            type: "object",
-            properties: {
-                content: {
-                    type: "string",
-                    description: "the message to deliver",
-                },
-                delegationId: {
-                    type: "string",
-                    description: "ID from your attention queue — addresses a specific held thought",
-                },
-                friendId: {
-                    type: "string",
-                    description: "friend to reach out to spontaneously (when not addressing a held thought)",
-                },
-            },
-            required: ["content"],
-        },
-    },
-};
-// Surface tool handler: routes content to friend's freshest session
-/* v8 ignore start -- surface handler wiring: core logic tested via surface-tool.test.ts; this wires identity/routing deps @preserve */
-const surfaceToolDefinition = {
-    tool: exports.surfaceToolDef,
-    handler: async (args, ctx) => {
-        const queue = ctx?.delegatedOrigins ?? [];
-        const agentName = (() => { try {
-            return (0, identity_1.getAgentName)();
-        }
-        catch {
-            return "unknown";
-        } })();
-        const routeToFriend = async (friendId, content, queueItem) => {
-            /* v8 ignore start -- routing: integration path tested via inner-dialog routing tests @preserve */
-            try {
-                const agentRoot = (0, identity_1.getAgentRoot)();
-                const sessionsDir = path.join(agentRoot, "state", "sessions");
-                const friendsDir = path.join(agentRoot, "friends");
-                // Priority 1: Bridge-preferred session (if queue item has a bridgeId)
-                if (queueItem?.bridgeId) {
-                    const { createBridgeManager } = await Promise.resolve().then(() => __importStar(require("../heart/bridges/manager")));
-                    const bridge = createBridgeManager().getBridge(queueItem.bridgeId);
-                    if (bridge && bridge.lifecycle !== "completed" && bridge.lifecycle !== "cancelled") {
-                        const allSessions = (0, session_activity_1.listSessionActivity)({ sessionsDir, friendsDir, agentName });
-                        const bridgeTarget = allSessions.find((activity) => activity.friendId === friendId
-                            && activity.channel !== "inner"
-                            && bridge.attachedSessions.some((s) => s.friendId === activity.friendId && s.channel === activity.channel && s.key === activity.key));
-                        if (bridgeTarget) {
-                            // Attempt proactive BB delivery for bridge target
-                            if (bridgeTarget.channel === "bluebubbles") {
-                                const { sendProactiveBlueBubblesMessageToSession } = await Promise.resolve().then(() => __importStar(require("../senses/bluebubbles")));
-                                const proactiveResult = await sendProactiveBlueBubblesMessageToSession({
-                                    friendId: bridgeTarget.friendId,
-                                    sessionKey: bridgeTarget.key,
-                                    text: content,
-                                });
-                                if (proactiveResult.delivered) {
-                                    // Inject surfaced content into the target session so it knows what was delivered
-                                    const { appendSyntheticAssistantMessage } = await Promise.resolve().then(() => __importStar(require("../mind/context")));
-                                    const sessionFilePath = path.join(sessionsDir, bridgeTarget.friendId, bridgeTarget.channel, `${bridgeTarget.key}.json`);
-                                    appendSyntheticAssistantMessage(sessionFilePath, `[surfaced from inner dialog] ${content}`);
-                                    return { status: "delivered", detail: "via iMessage" };
-                                }
-                            }
-                            // Fall back to pending queue for bridge target
-                            const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
-                            const pendingDir = getPendingDir(agentName, bridgeTarget.friendId, bridgeTarget.channel, bridgeTarget.key);
-                            queuePendingMessage(pendingDir, {
-                                from: agentName,
-                                friendId: bridgeTarget.friendId,
-                                channel: bridgeTarget.channel,
-                                key: bridgeTarget.key,
-                                content,
-                                timestamp: Date.now(),
-                            });
-                            return { status: "queued", detail: `for next interaction via ${bridgeTarget.channel}` };
-                        }
-                    }
-                }
-                // Priority 2: Freshest active friend session
-                const freshest = (0, session_activity_1.findFreshestFriendSession)({
-                    sessionsDir,
-                    friendsDir,
-                    agentName,
-                    friendId,
-                    activeOnly: true,
-                });
-                if (freshest && freshest.channel !== "inner") {
-                    // Attempt proactive BB delivery
-                    if (freshest.channel === "bluebubbles") {
-                        const { sendProactiveBlueBubblesMessageToSession } = await Promise.resolve().then(() => __importStar(require("../senses/bluebubbles")));
-                        const proactiveResult = await sendProactiveBlueBubblesMessageToSession({
-                            friendId: freshest.friendId,
-                            sessionKey: freshest.key,
-                            text: content,
-                        });
-                        if (proactiveResult.delivered) {
-                            // Inject surfaced content into the target session so it knows what was delivered
-                            const { appendSyntheticAssistantMessage } = await Promise.resolve().then(() => __importStar(require("../mind/context")));
-                            const sessionFilePath = path.join(sessionsDir, freshest.friendId, freshest.channel, `${freshest.key}.json`);
-                            appendSyntheticAssistantMessage(sessionFilePath, `[surfaced from inner dialog] ${content}`);
-                            return { status: "delivered", detail: "via iMessage" };
-                        }
-                    }
-                    // Queue as pending for next interaction
-                    const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
-                    const pendingDir = getPendingDir(agentName, freshest.friendId, freshest.channel, freshest.key);
-                    queuePendingMessage(pendingDir, {
-                        from: agentName,
-                        friendId: freshest.friendId,
-                        channel: freshest.channel,
-                        key: freshest.key,
-                        content,
-                        timestamp: Date.now(),
-                    });
-                    return { status: "queued", detail: `for next interaction via ${freshest.channel}` };
-                }
-                // Priority 3: Deferred — no active session found
-                const { getDeferredReturnDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
-                const { queuePendingMessage: queueDeferred } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
-                const deferredDir = getDeferredReturnDir(agentName, friendId);
-                queueDeferred(deferredDir, {
-                    from: agentName,
-                    friendId,
-                    channel: "deferred",
-                    key: "return",
-                    content,
-                    timestamp: Date.now(),
-                });
-                return { status: "deferred", detail: "they'll see it next time" };
-            }
-            catch {
-                return { status: "failed" };
-            }
-            /* v8 ignore stop */
-        };
-        return (0, surface_tool_1.handleSurface)({
-            content: args.content ?? "",
-            delegationId: args.delegationId,
-            friendId: args.friendId,
-            queue,
-            routeToFriend,
-            advanceObligation: (obligationId, update) => {
-                /* v8 ignore start -- obligation advance: tested via attention-queue tests @preserve */
-                try {
-                    const name = (() => { try {
-                        return (0, identity_1.getAgentName)();
-                    }
-                    catch {
-                        return "unknown";
-                    } })();
-                    (0, obligations_1.advanceReturnObligation)(name, obligationId, {
-                        status: update.status,
-                        ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
-                        ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
-                    });
-                }
-                catch {
-                    // swallowed — obligation advance must never break surface delivery
-                }
-                /* v8 ignore stop */
-            },
-            fulfillHeartObligation: (origin) => {
-                /* v8 ignore start -- heart obligation fulfillment: tested via surface-tool.test.ts @preserve */
-                try {
-                    const agentRoot = (0, identity_1.getAgentRoot)();
-                    const heartObligation = (0, obligations_1.findPendingObligationForOrigin)(agentRoot, origin);
-                    if (heartObligation) {
-                        (0, obligations_1.fulfillObligation)(agentRoot, heartObligation.id);
-                    }
-                }
-                catch {
-                    // swallowed — heart obligation fulfillment must never break surface delivery
-                }
-                /* v8 ignore stop */
-            },
-        });
-    },
-    summaryKeys: ["content", "delegationId"],
-};
-/* v8 ignore stop */
+// Re-export surface tool schema for consumers (e.g. heart/core.ts)
+var tools_surface_2 = require("./tools-surface");
+Object.defineProperty(exports, "surfaceToolDef", { enumerable: true, get: function () { return tools_surface_2.surfaceToolDef; } });
 // All tool definitions in a single registry
-const allDefinitions = [...tools_base_1.baseToolDefinitions, ...tools_bluebubbles_1.bluebubblesToolDefinitions, ...tools_teams_1.teamsToolDefinitions, ...ado_semantic_1.adoSemanticToolDefinitions, ...tools_github_1.githubToolDefinitions, surfaceToolDefinition];
+const allDefinitions = [...tools_base_1.baseToolDefinitions, ...tools_bluebubbles_1.bluebubblesToolDefinitions, ...tools_teams_1.teamsToolDefinitions, ...ado_semantic_1.adoSemanticToolDefinitions, ...tools_github_1.githubToolDefinitions, tools_surface_1.surfaceToolDefinition];
 function baseToolsForCapabilities() {
     // Use baseToolDefinitions at call time so dynamically-added tools are included
     return tools_base_1.baseToolDefinitions.map((d) => d.tool);
@@ -325,6 +106,12 @@ function isConfirmationRequired(toolName) {
     const def = allDefinitions.find((d) => d.tool.function.name === toolName);
     return def?.confirmationRequired === true;
 }
+// Check whether a tool's confirmation is non-bypassable (cannot be skipped by skipConfirmation).
+// Used for T2 config proposals that must always require operator approval.
+function isConfirmationAlwaysRequired(toolName) {
+    const def = allDefinitions.find((d) => d.tool.function.name === toolName);
+    return def?.confirmationAlwaysRequired === true;
+}
 function normalizeGuardArgs(_name, args) {
     return args;
 }
@@ -419,6 +206,7 @@ function summarizeArgs(name, args) {
  * Falls back to arg-based summary for unrecognized tools.
  */
 function buildToolResultSummary(name, args, _result, success) {
+    /* v8 ignore start -- branches: ?? fallbacks and ternaries in tool summary formatting @preserve */
     switch (name) {
         case "edit_file": {
             if (!success)
@@ -448,4 +236,5 @@ function buildToolResultSummary(name, args, _result, success) {
         default:
             return summarizeArgs(name, args);
     }
+    /* v8 ignore stop */
 }

package/dist/senses/pipeline.js

@@ -390,6 +390,10 @@ async function handleInboundTurn(input) {
                 if (syncFailure) {
                     startOfTurnPacket.syncFailure = syncFailure;
                 }
+                const capabilities = (0, start_of_turn_packet_1.buildCapabilitiesSection)(agentRoot);
+                if (capabilities) {
+                    startOfTurnPacket.capabilities = capabilities;
+                }
                 renderedStartOfTurnPacket = (0, start_of_turn_packet_1.renderStartOfTurnPacket)(startOfTurnPacket);
                 if (!renderedStartOfTurnPacket)
                     renderedStartOfTurnPacket = undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.205",
+  "version": "0.1.0-alpha.207",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",