@ouro.bot/cli 0.1.0-alpha.14 → 0.1.0-alpha.140

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. package/AdoptionSpecialist.ouro/psyche/SOUL.md +2 -2
  2. package/AdoptionSpecialist.ouro/psyche/identities/monty.md +2 -2
  3. package/README.md +151 -205
  4. package/changelog.json +902 -0
  5. package/dist/heart/active-work.js +633 -0
  6. package/dist/heart/bridges/manager.js +358 -0
  7. package/dist/heart/bridges/state-machine.js +135 -0
  8. package/dist/heart/bridges/store.js +123 -0
  9. package/dist/heart/commitments.js +105 -0
  10. package/dist/heart/config.js +66 -21
  11. package/dist/heart/core.js +579 -112
  12. package/dist/heart/cross-chat-delivery.js +146 -0
  13. package/dist/heart/daemon/agent-discovery.js +81 -0
  14. package/dist/heart/daemon/agent-service.js +467 -0
  15. package/dist/heart/daemon/auth-flow.js +457 -0
  16. package/dist/heart/daemon/daemon-cli.js +1840 -196
  17. package/dist/heart/daemon/daemon-entry.js +80 -3
  18. package/dist/heart/daemon/daemon-runtime-sync.js +212 -0
  19. package/dist/heart/daemon/daemon.js +301 -1
  20. package/dist/heart/daemon/hatch-animation.js +10 -3
  21. package/dist/heart/daemon/hatch-flow.js +15 -80
  22. package/dist/heart/daemon/heartbeat-timer.js +131 -0
  23. package/dist/heart/daemon/hooks/bundle-meta.js +92 -0
  24. package/dist/heart/daemon/launchd.js +159 -0
  25. package/dist/heart/daemon/log-tailer.js +4 -3
  26. package/dist/heart/daemon/mcp-server.js +464 -0
  27. package/dist/heart/daemon/message-router.js +17 -8
  28. package/dist/heart/daemon/ouro-bot-global-installer.js +128 -0
  29. package/dist/heart/daemon/ouro-path-installer.js +67 -34
  30. package/dist/heart/daemon/ouro-version-manager.js +171 -0
  31. package/dist/heart/daemon/process-manager.js +13 -0
  32. package/dist/heart/daemon/run-hooks.js +37 -0
  33. package/dist/heart/daemon/runtime-logging.js +58 -15
  34. package/dist/heart/daemon/runtime-metadata.js +219 -0
  35. package/dist/heart/daemon/runtime-mode.js +67 -0
  36. package/dist/heart/daemon/sense-manager.js +50 -2
  37. package/dist/heart/daemon/skill-management-installer.js +94 -0
  38. package/dist/heart/daemon/socket-client.js +202 -0
  39. package/dist/heart/daemon/specialist-orchestrator.js +2 -2
  40. package/dist/heart/daemon/specialist-prompt.js +10 -7
  41. package/dist/heart/daemon/specialist-tools.js +52 -3
  42. package/dist/heart/daemon/staged-restart.js +114 -0
  43. package/dist/heart/daemon/thoughts.js +507 -0
  44. package/dist/heart/daemon/update-checker.js +111 -0
  45. package/dist/heart/daemon/update-hooks.js +138 -0
  46. package/dist/heart/daemon/wrapper-publish-guard.js +86 -0
  47. package/dist/heart/delegation.js +62 -0
  48. package/dist/heart/identity.js +64 -21
  49. package/dist/heart/kicks.js +2 -20
  50. package/dist/heart/model-capabilities.js +48 -0
  51. package/dist/heart/obligations.js +197 -0
  52. package/dist/heart/progress-story.js +42 -0
  53. package/dist/heart/provider-failover.js +88 -0
  54. package/dist/heart/provider-ping.js +159 -0
  55. package/dist/heart/providers/anthropic-token.js +163 -0
  56. package/dist/heart/providers/anthropic.js +195 -34
  57. package/dist/heart/providers/azure.js +115 -9
  58. package/dist/heart/providers/github-copilot.js +157 -0
  59. package/dist/heart/providers/minimax.js +33 -3
  60. package/dist/heart/providers/openai-codex.js +49 -14
  61. package/dist/heart/session-activity.js +173 -0
  62. package/dist/heart/session-recall.js +216 -0
  63. package/dist/heart/streaming.js +117 -33
  64. package/dist/heart/target-resolution.js +123 -0
  65. package/dist/heart/tool-loop.js +198 -0
  66. package/dist/heart/turn-coordinator.js +28 -0
  67. package/dist/mind/associative-recall.js +122 -32
  68. package/dist/mind/bundle-manifest.js +14 -0
  69. package/dist/mind/context.js +124 -14
  70. package/dist/mind/{memory.js → diary.js} +70 -56
  71. package/dist/mind/first-impressions.js +16 -2
  72. package/dist/mind/friends/channel.js +35 -0
  73. package/dist/mind/friends/group-context.js +144 -0
  74. package/dist/mind/friends/store-file.js +19 -0
  75. package/dist/mind/friends/trust-explanation.js +74 -0
  76. package/dist/mind/friends/types.js +8 -0
  77. package/dist/mind/journal-index.js +161 -0
  78. package/dist/mind/obligation-steering.js +221 -0
  79. package/dist/mind/obligations.js +134 -0
  80. package/dist/mind/pending.js +76 -9
  81. package/dist/mind/phrases.js +1 -0
  82. package/dist/mind/prompt.js +554 -88
  83. package/dist/mind/token-estimate.js +8 -12
  84. package/dist/nerves/cli-logging.js +15 -2
  85. package/dist/nerves/coverage/run-artifacts.js +1 -1
  86. package/dist/nerves/index.js +12 -0
  87. package/dist/nerves/runtime.js +5 -1
  88. package/dist/repertoire/ado-client.js +4 -2
  89. package/dist/repertoire/ado-semantic.js +6 -0
  90. package/dist/repertoire/coding/codex-jsonl.js +64 -0
  91. package/dist/repertoire/coding/context-pack.js +254 -0
  92. package/dist/repertoire/coding/feedback.js +301 -0
  93. package/dist/repertoire/coding/index.js +4 -1
  94. package/dist/repertoire/coding/manager.js +210 -4
  95. package/dist/repertoire/coding/spawner.js +59 -12
  96. package/dist/repertoire/coding/tools.js +176 -4
  97. package/dist/repertoire/data/ado-endpoints.json +188 -0
  98. package/dist/repertoire/guardrails.js +290 -0
  99. package/dist/repertoire/mcp-client.js +254 -0
  100. package/dist/repertoire/mcp-manager.js +198 -0
  101. package/dist/repertoire/skills.js +14 -23
  102. package/dist/repertoire/tasks/board.js +12 -0
  103. package/dist/repertoire/tasks/index.js +23 -9
  104. package/dist/repertoire/tasks/transitions.js +1 -2
  105. package/dist/repertoire/tools-base.js +975 -271
  106. package/dist/repertoire/tools-bluebubbles.js +94 -0
  107. package/dist/repertoire/tools-github.js +1 -6
  108. package/dist/repertoire/tools-teams.js +65 -59
  109. package/dist/repertoire/tools.js +265 -91
  110. package/dist/senses/attention-queue.js +97 -0
  111. package/dist/senses/bluebubbles-client.js +210 -5
  112. package/dist/senses/bluebubbles-entry.js +2 -0
  113. package/dist/senses/bluebubbles-inbound-log.js +109 -0
  114. package/dist/senses/bluebubbles-media.js +339 -0
  115. package/dist/senses/bluebubbles-model.js +12 -4
  116. package/dist/senses/bluebubbles-mutation-log.js +45 -5
  117. package/dist/senses/bluebubbles-runtime-state.js +109 -0
  118. package/dist/senses/bluebubbles-session-cleanup.js +72 -0
  119. package/dist/senses/bluebubbles.js +944 -45
  120. package/dist/senses/cli-entry.js +1 -1
  121. package/dist/senses/cli-layout.js +187 -0
  122. package/dist/senses/cli.js +374 -131
  123. package/dist/senses/contextual-heartbeat.js +102 -0
  124. package/dist/senses/continuity.js +94 -0
  125. package/dist/senses/debug-activity.js +154 -0
  126. package/dist/senses/inner-dialog-worker.js +47 -18
  127. package/dist/senses/inner-dialog.js +500 -84
  128. package/dist/senses/pipeline.js +454 -0
  129. package/dist/senses/surface-tool.js +82 -0
  130. package/dist/senses/teams.js +607 -129
  131. package/dist/senses/trust-gate.js +112 -2
  132. package/package.json +12 -4
  133. package/skills/configure-dev-tools.md +109 -0
  134. package/subagents/README.md +4 -70
  135. package/dist/heart/daemon/subagent-installer.js +0 -134
  136. package/subagents/work-doer.md +0 -233
  137. package/subagents/work-merger.md +0 -624
  138. package/subagents/work-planner.md +0 -373
@@ -1,29 +1,221 @@
1
1
  "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
2
35
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.teamsTools = exports.finalAnswerTool = exports.tools = void 0;
36
+ exports.descendTool = exports.observeTool = exports.settleTool = exports.tools = void 0;
4
37
  exports.getToolsForChannel = getToolsForChannel;
5
38
  exports.isConfirmationRequired = isConfirmationRequired;
6
39
  exports.execTool = execTool;
7
40
  exports.summarizeArgs = summarizeArgs;
8
41
  const tools_base_1 = require("./tools-base");
9
42
  const tools_teams_1 = require("./tools-teams");
43
+ const tools_bluebubbles_1 = require("./tools-bluebubbles");
10
44
  const ado_semantic_1 = require("./ado-semantic");
11
45
  const tools_github_1 = require("./tools-github");
12
46
  const runtime_1 = require("../nerves/runtime");
47
+ const guardrails_1 = require("./guardrails");
48
+ const identity_1 = require("../heart/identity");
49
+ const surface_tool_1 = require("../senses/surface-tool");
50
+ const obligations_1 = require("../mind/obligations");
51
+ const session_activity_1 = require("../heart/session-activity");
52
+ const path = __importStar(require("path"));
53
+ function safeGetAgentRoot() {
54
+ try {
55
+ return (0, identity_1.getAgentRoot)();
56
+ }
57
+ catch {
58
+ return undefined;
59
+ }
60
+ }
13
61
  // Re-export types and constants used by the rest of the codebase
14
62
  var tools_base_2 = require("./tools-base");
15
63
  Object.defineProperty(exports, "tools", { enumerable: true, get: function () { return tools_base_2.tools; } });
16
- Object.defineProperty(exports, "finalAnswerTool", { enumerable: true, get: function () { return tools_base_2.finalAnswerTool; } });
17
- var tools_teams_2 = require("./tools-teams");
18
- Object.defineProperty(exports, "teamsTools", { enumerable: true, get: function () { return tools_teams_2.teamsTools; } });
64
+ Object.defineProperty(exports, "settleTool", { enumerable: true, get: function () { return tools_base_2.settleTool; } });
65
+ Object.defineProperty(exports, "observeTool", { enumerable: true, get: function () { return tools_base_2.observeTool; } });
66
+ Object.defineProperty(exports, "descendTool", { enumerable: true, get: function () { return tools_base_2.descendTool; } });
67
+ // Surface tool handler: routes content to friend's freshest session
68
+ /* v8 ignore start -- surface handler wiring: core logic tested via surface-tool.test.ts; this wires identity/routing deps @preserve */
69
+ const surfaceToolDefinition = {
70
+ tool: surface_tool_1.surfaceToolDef,
71
+ handler: async (args, ctx) => {
72
+ const queue = ctx?.delegatedOrigins ?? [];
73
+ const agentName = (() => { try {
74
+ return (0, identity_1.getAgentName)();
75
+ }
76
+ catch {
77
+ return "unknown";
78
+ } })();
79
+ const routeToFriend = async (friendId, content, queueItem) => {
80
+ /* v8 ignore start -- routing: integration path tested via inner-dialog routing tests @preserve */
81
+ try {
82
+ const agentRoot = (0, identity_1.getAgentRoot)();
83
+ const sessionsDir = path.join(agentRoot, "state", "sessions");
84
+ const friendsDir = path.join(agentRoot, "friends");
85
+ // Priority 1: Bridge-preferred session (if queue item has a bridgeId)
86
+ if (queueItem?.bridgeId) {
87
+ const { createBridgeManager } = await Promise.resolve().then(() => __importStar(require("../heart/bridges/manager")));
88
+ const bridge = createBridgeManager().getBridge(queueItem.bridgeId);
89
+ if (bridge && bridge.lifecycle !== "completed" && bridge.lifecycle !== "cancelled") {
90
+ const allSessions = (0, session_activity_1.listSessionActivity)({ sessionsDir, friendsDir, agentName });
91
+ const bridgeTarget = allSessions.find((activity) => activity.friendId === friendId
92
+ && activity.channel !== "inner"
93
+ && bridge.attachedSessions.some((s) => s.friendId === activity.friendId && s.channel === activity.channel && s.key === activity.key));
94
+ if (bridgeTarget) {
95
+ // Attempt proactive BB delivery for bridge target
96
+ if (bridgeTarget.channel === "bluebubbles") {
97
+ const { sendProactiveBlueBubblesMessageToSession } = await Promise.resolve().then(() => __importStar(require("../senses/bluebubbles")));
98
+ const proactiveResult = await sendProactiveBlueBubblesMessageToSession({
99
+ friendId: bridgeTarget.friendId,
100
+ sessionKey: bridgeTarget.key,
101
+ text: content,
102
+ });
103
+ if (proactiveResult.delivered) {
104
+ // Inject surfaced content into the target session so it knows what was delivered
105
+ const { appendSyntheticAssistantMessage } = await Promise.resolve().then(() => __importStar(require("../mind/context")));
106
+ const sessionFilePath = path.join(sessionsDir, bridgeTarget.friendId, bridgeTarget.channel, `${bridgeTarget.key}.json`);
107
+ appendSyntheticAssistantMessage(sessionFilePath, `[surfaced from inner dialog] ${content}`);
108
+ return { status: "delivered", detail: "via iMessage" };
109
+ }
110
+ }
111
+ // Fall back to pending queue for bridge target
112
+ const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
113
+ const pendingDir = getPendingDir(agentName, bridgeTarget.friendId, bridgeTarget.channel, bridgeTarget.key);
114
+ queuePendingMessage(pendingDir, {
115
+ from: agentName,
116
+ friendId: bridgeTarget.friendId,
117
+ channel: bridgeTarget.channel,
118
+ key: bridgeTarget.key,
119
+ content,
120
+ timestamp: Date.now(),
121
+ });
122
+ return { status: "queued", detail: `for next interaction via ${bridgeTarget.channel}` };
123
+ }
124
+ }
125
+ }
126
+ // Priority 2: Freshest active friend session
127
+ const freshest = (0, session_activity_1.findFreshestFriendSession)({
128
+ sessionsDir,
129
+ friendsDir,
130
+ agentName,
131
+ friendId,
132
+ activeOnly: true,
133
+ });
134
+ if (freshest && freshest.channel !== "inner") {
135
+ // Attempt proactive BB delivery
136
+ if (freshest.channel === "bluebubbles") {
137
+ const { sendProactiveBlueBubblesMessageToSession } = await Promise.resolve().then(() => __importStar(require("../senses/bluebubbles")));
138
+ const proactiveResult = await sendProactiveBlueBubblesMessageToSession({
139
+ friendId: freshest.friendId,
140
+ sessionKey: freshest.key,
141
+ text: content,
142
+ });
143
+ if (proactiveResult.delivered) {
144
+ // Inject surfaced content into the target session so it knows what was delivered
145
+ const { appendSyntheticAssistantMessage } = await Promise.resolve().then(() => __importStar(require("../mind/context")));
146
+ const sessionFilePath = path.join(sessionsDir, freshest.friendId, freshest.channel, `${freshest.key}.json`);
147
+ appendSyntheticAssistantMessage(sessionFilePath, `[surfaced from inner dialog] ${content}`);
148
+ return { status: "delivered", detail: "via iMessage" };
149
+ }
150
+ }
151
+ // Queue as pending for next interaction
152
+ const { queuePendingMessage, getPendingDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
153
+ const pendingDir = getPendingDir(agentName, freshest.friendId, freshest.channel, freshest.key);
154
+ queuePendingMessage(pendingDir, {
155
+ from: agentName,
156
+ friendId: freshest.friendId,
157
+ channel: freshest.channel,
158
+ key: freshest.key,
159
+ content,
160
+ timestamp: Date.now(),
161
+ });
162
+ return { status: "queued", detail: `for next interaction via ${freshest.channel}` };
163
+ }
164
+ // Priority 3: Deferred — no active session found
165
+ const { getDeferredReturnDir } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
166
+ const { queuePendingMessage: queueDeferred } = await Promise.resolve().then(() => __importStar(require("../mind/pending")));
167
+ const deferredDir = getDeferredReturnDir(agentName, friendId);
168
+ queueDeferred(deferredDir, {
169
+ from: agentName,
170
+ friendId,
171
+ channel: "deferred",
172
+ key: "return",
173
+ content,
174
+ timestamp: Date.now(),
175
+ });
176
+ return { status: "deferred", detail: "they'll see it next time" };
177
+ }
178
+ catch {
179
+ return { status: "failed" };
180
+ }
181
+ /* v8 ignore stop */
182
+ };
183
+ return (0, surface_tool_1.handleSurface)({
184
+ content: args.content ?? "",
185
+ delegationId: args.delegationId,
186
+ friendId: args.friendId,
187
+ queue,
188
+ routeToFriend,
189
+ advanceObligation: (obligationId, update) => {
190
+ /* v8 ignore start -- obligation advance: tested via attention-queue tests @preserve */
191
+ try {
192
+ const name = (() => { try {
193
+ return (0, identity_1.getAgentName)();
194
+ }
195
+ catch {
196
+ return "unknown";
197
+ } })();
198
+ (0, obligations_1.advanceObligation)(name, obligationId, {
199
+ status: update.status,
200
+ ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
201
+ ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
202
+ });
203
+ }
204
+ catch {
205
+ // swallowed — obligation advance must never break surface delivery
206
+ }
207
+ /* v8 ignore stop */
208
+ },
209
+ });
210
+ },
211
+ summaryKeys: ["content", "delegationId"],
212
+ };
213
+ /* v8 ignore stop */
19
214
  // All tool definitions in a single registry
20
- const allDefinitions = [...tools_base_1.baseToolDefinitions, ...tools_teams_1.teamsToolDefinitions, ...ado_semantic_1.adoSemanticToolDefinitions, ...tools_github_1.githubToolDefinitions];
21
- const REMOTE_BLOCKED_LOCAL_TOOLS = new Set(["shell", "read_file", "write_file", "git_commit", "gh_cli"]);
22
- function baseToolsForCapabilities(capabilities) {
23
- const isRemoteChannel = capabilities?.channel === "teams" || capabilities?.channel === "bluebubbles";
24
- if (!isRemoteChannel)
25
- return tools_base_1.tools;
26
- return tools_base_1.tools.filter((tool) => !REMOTE_BLOCKED_LOCAL_TOOLS.has(tool.function.name));
215
+ const allDefinitions = [...tools_base_1.baseToolDefinitions, ...tools_bluebubbles_1.bluebubblesToolDefinitions, ...tools_teams_1.teamsToolDefinitions, ...ado_semantic_1.adoSemanticToolDefinitions, ...tools_github_1.githubToolDefinitions, surfaceToolDefinition];
216
+ function baseToolsForCapabilities() {
217
+ // Use baseToolDefinitions at call time so dynamically-added tools are included
218
+ return tools_base_1.baseToolDefinitions.map((d) => d.tool);
27
219
  }
28
220
  // Apply a single tool preference to a tool schema, returning a new object.
29
221
  function applyPreference(tool, pref) {
@@ -35,32 +227,55 @@ function applyPreference(tool, pref) {
35
227
  },
36
228
  };
37
229
  }
230
+ // Filter out tools whose requiredCapability is not in the provider's capability set.
231
+ // Uses baseToolDefinitions at call time so dynamically-added tools are included.
232
+ // Only base tools can have requiredCapability (integration tools do not).
233
+ function filterByCapability(toolList, providerCapabilities) {
234
+ return toolList.filter((tool) => {
235
+ const def = tools_base_1.baseToolDefinitions.find((d) => d.tool.function.name === tool.function.name);
236
+ if (!def?.requiredCapability)
237
+ return true;
238
+ return providerCapabilities?.has(def.requiredCapability) === true;
239
+ });
240
+ }
38
241
  // Return the appropriate tools list based on channel capabilities.
39
242
  // Base tools (no integration) are always included.
40
243
  // Teams/integration tools are included only if their integration is in availableIntegrations.
41
244
  // When toolPreferences is provided, matching preferences are appended to tool descriptions.
42
- function getToolsForChannel(capabilities, toolPreferences) {
43
- const baseTools = baseToolsForCapabilities(capabilities);
245
+ // When providerCapabilities is provided, tools with requiredCapability are filtered.
246
+ function getToolsForChannel(capabilities, toolPreferences, _context, providerCapabilities) {
247
+ const baseTools = baseToolsForCapabilities();
248
+ const bluebubblesTools = capabilities?.channel === "bluebubbles"
249
+ ? tools_bluebubbles_1.bluebubblesToolDefinitions.map((d) => d.tool)
250
+ : [];
251
+ let result;
44
252
  if (!capabilities || capabilities.availableIntegrations.length === 0) {
45
- return baseTools;
46
- }
47
- const available = new Set(capabilities.availableIntegrations);
48
- const integrationDefs = [...tools_teams_1.teamsToolDefinitions, ...ado_semantic_1.adoSemanticToolDefinitions, ...tools_github_1.githubToolDefinitions].filter((d) => d.integration && available.has(d.integration));
49
- if (!toolPreferences || Object.keys(toolPreferences).length === 0) {
50
- return [...baseTools, ...integrationDefs.map((d) => d.tool)];
253
+ result = [...baseTools, ...bluebubblesTools];
51
254
  }
52
- // Build a map of integration -> preference text for fast lookup
53
- const prefMap = new Map();
54
- for (const [key, value] of Object.entries(toolPreferences)) {
55
- prefMap.set(key, value);
255
+ else {
256
+ const available = new Set(capabilities.availableIntegrations);
257
+ const channelDefs = [...tools_teams_1.teamsToolDefinitions, ...ado_semantic_1.adoSemanticToolDefinitions, ...tools_github_1.githubToolDefinitions];
258
+ // Include tools whose integration is available, plus channel tools with no integration gate (e.g. teams_send_message)
259
+ const integrationDefs = channelDefs.filter((d) => d.integration ? available.has(d.integration) : capabilities.channel === "teams");
260
+ if (!toolPreferences || Object.keys(toolPreferences).length === 0) {
261
+ result = [...baseTools, ...bluebubblesTools, ...integrationDefs.map((d) => d.tool)];
262
+ }
263
+ else {
264
+ // Build a map of integration -> preference text for fast lookup
265
+ const prefMap = new Map();
266
+ for (const [key, value] of Object.entries(toolPreferences)) {
267
+ prefMap.set(key, value);
268
+ }
269
+ // Apply preferences to matching integration tools (new objects, no mutation)
270
+ // d.integration is guaranteed truthy -- integrationDefs are pre-filtered above
271
+ const enrichedIntegrationTools = integrationDefs.map((d) => {
272
+ const pref = prefMap.get(d.integration);
273
+ return pref ? applyPreference(d.tool, pref) : d.tool;
274
+ });
275
+ result = [...baseTools, ...bluebubblesTools, ...enrichedIntegrationTools];
276
+ }
56
277
  }
57
- // Apply preferences to matching integration tools (new objects, no mutation)
58
- // d.integration is guaranteed truthy -- integrationDefs are pre-filtered above
59
- const enrichedIntegrationTools = integrationDefs.map((d) => {
60
- const pref = prefMap.get(d.integration);
61
- return pref ? applyPreference(d.tool, pref) : d.tool;
62
- });
63
- return [...baseTools, ...enrichedIntegrationTools];
278
+ return filterByCapability(result, providerCapabilities);
64
279
  }
65
280
  // Check whether a tool requires user confirmation before execution.
66
281
  // Reads from ToolDefinition.confirmationRequired instead of a separate Set.
@@ -68,12 +283,15 @@ function isConfirmationRequired(toolName) {
68
283
  const def = allDefinitions.find((d) => d.tool.function.name === toolName);
69
284
  return def?.confirmationRequired === true;
70
285
  }
286
+ function normalizeGuardArgs(_name, args) {
287
+ return args;
288
+ }
71
289
  async function execTool(name, args, ctx) {
72
290
  (0, runtime_1.emitNervesEvent)({
73
291
  event: "tool.start",
74
292
  component: "tools",
75
293
  message: "tool execution started",
76
- meta: { name },
294
+ meta: { name, ...(name === "shell" && args.command ? { command: args.command } : {}) },
77
295
  });
78
296
  // Look up from combined registry
79
297
  const def = allDefinitions.find((d) => d.tool.function.name === name);
@@ -87,17 +305,23 @@ async function execTool(name, args, ctx) {
87
305
  });
88
306
  return `unknown: ${name}`;
89
307
  }
90
- const isRemoteChannel = ctx?.context?.channel?.channel === "teams" || ctx?.context?.channel?.channel === "bluebubbles";
91
- if (isRemoteChannel && REMOTE_BLOCKED_LOCAL_TOOLS.has(name)) {
92
- const message = "I can't do that from here because I'm talking to multiple people in a shared remote channel, and local shell/file/git/gh operations could let conversations interfere with each other. Ask me for a remote-safe alternative (Graph/ADO/web), or run that operation from CLI.";
308
+ // Guardrail check: structural + trust-level
309
+ const guardContext = {
310
+ readPaths: tools_base_1.editFileReadTracker,
311
+ trustLevel: ctx?.context?.friend?.trustLevel,
312
+ agentRoot: safeGetAgentRoot(),
313
+ };
314
+ const guardArgs = normalizeGuardArgs(name, args);
315
+ const guardResult = (0, guardrails_1.guardInvocation)(name, guardArgs, guardContext);
316
+ if (!guardResult.allowed) {
93
317
  (0, runtime_1.emitNervesEvent)({
94
318
  level: "warn",
95
- event: "tool.error",
319
+ event: "tool.guardrail_block",
96
320
  component: "tools",
97
- message: "blocked local tool in remote channel",
98
- meta: { name, channel: ctx?.context?.channel?.channel },
321
+ message: "guardrail blocked tool execution",
322
+ meta: { name, reason: guardResult.reason },
99
323
  });
100
- return message;
324
+ return guardResult.reason;
101
325
  }
102
326
  try {
103
327
  const result = await def.handler(args, ctx);
@@ -141,59 +365,9 @@ function summarizeUnknownArgs(args) {
141
365
  return summarizeKeyValues(args, keys);
142
366
  }
143
367
  function summarizeArgs(name, args) {
144
- // Check teams tools first
145
- const teamsSummary = (0, tools_teams_1.summarizeTeamsArgs)(name, args);
146
- if (teamsSummary !== undefined)
147
- return teamsSummary;
148
- // Check github tools
149
- const githubSummary = (0, tools_github_1.summarizeGithubArgs)(name, args);
150
- if (githubSummary !== undefined)
151
- return githubSummary;
152
- // Base tools
153
- if (name === "read_file" || name === "write_file")
154
- return summarizeKeyValues(args, ["path"]);
155
- if (name === "shell")
156
- return summarizeKeyValues(args, ["command"]);
157
- if (name === "list_directory")
158
- return summarizeKeyValues(args, ["path"]);
159
- if (name === "git_commit")
160
- return summarizeKeyValues(args, ["message"]);
161
- if (name === "gh_cli")
162
- return summarizeKeyValues(args, ["command"]);
163
- if (name === "load_skill")
164
- return summarizeKeyValues(args, ["name"]);
165
- if (name === "task_create")
166
- return summarizeKeyValues(args, ["title", "type", "category"]);
167
- if (name === "task_update_status")
168
- return summarizeKeyValues(args, ["name", "status"]);
169
- if (name === "task_board_status")
170
- return summarizeKeyValues(args, ["status"]);
171
- if (name === "task_board_action")
172
- return summarizeKeyValues(args, ["scope"]);
173
- if (name === "task_board" || name === "task_board_deps" || name === "task_board_sessions")
174
- return "";
175
- if (name === "coding_spawn")
176
- return summarizeKeyValues(args, ["runner", "workdir", "taskRef"]);
177
- if (name === "coding_status")
178
- return summarizeKeyValues(args, ["sessionId"]);
179
- if (name === "coding_send_input")
180
- return summarizeKeyValues(args, ["sessionId", "input"]);
181
- if (name === "coding_kill")
182
- return summarizeKeyValues(args, ["sessionId"]);
183
- if (name === "claude")
184
- return summarizeKeyValues(args, ["prompt"]);
185
- if (name === "web_search")
186
- return summarizeKeyValues(args, ["query"]);
187
- if (name === "memory_search")
188
- return summarizeKeyValues(args, ["query"]);
189
- if (name === "memory_save")
190
- return summarizeKeyValues(args, ["text", "about"]);
191
- if (name === "get_friend_note")
192
- return summarizeKeyValues(args, ["friendId"]);
193
- if (name === "save_friend_note") {
194
- return summarizeKeyValues(args, ["type", "key", "content"]);
368
+ const def = allDefinitions.find((d) => d.tool.function.name === name);
369
+ if (def && def.summaryKeys !== undefined) {
370
+ return summarizeKeyValues(args, def.summaryKeys);
195
371
  }
196
- if (name === "ado_backlog_list")
197
- return summarizeKeyValues(args, ["organization", "project"]);
198
372
  return summarizeUnknownArgs(args);
199
373
  }
@@ -0,0 +1,97 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.buildAttentionQueue = buildAttentionQueue;
4
+ exports.dequeueAttentionItem = dequeueAttentionItem;
5
+ exports.attentionQueueEmpty = attentionQueueEmpty;
6
+ exports.buildAttentionQueueSummary = buildAttentionQueueSummary;
7
+ const runtime_1 = require("../nerves/runtime");
8
+ // ── Queue construction ───────────────────────────────────────────
9
+ function generateItemId() {
10
+ return Math.random().toString(36).slice(2, 10);
11
+ }
12
+ function originKey(friendId, channel, key) {
13
+ return `${friendId}/${channel}/${key}`;
14
+ }
15
+ function buildAttentionQueue(input) {
16
+ const { drainedPending, outstandingObligations, friendNameResolver } = input;
17
+ const seen = new Set();
18
+ const items = [];
19
+ // Source 1: drained pending messages with delegatedFrom (current-turn delegations)
20
+ for (const msg of drainedPending) {
21
+ if (!msg.delegatedFrom)
22
+ continue;
23
+ const { friendId, channel, key, bridgeId } = msg.delegatedFrom;
24
+ const oKey = originKey(friendId, channel, key);
25
+ seen.add(oKey);
26
+ const resolvedName = friendNameResolver(friendId);
27
+ items.push({
28
+ id: msg.obligationId ?? generateItemId(),
29
+ friendId,
30
+ friendName: resolvedName ?? friendId,
31
+ channel,
32
+ key,
33
+ ...(bridgeId ? { bridgeId } : {}),
34
+ delegatedContent: msg.content,
35
+ ...(msg.obligationId ? { obligationId: msg.obligationId } : {}),
36
+ source: "drained",
37
+ timestamp: msg.timestamp,
38
+ });
39
+ }
40
+ // Source 2: outstanding obligations (crash recovery)
41
+ for (const obligation of outstandingObligations) {
42
+ const { friendId, channel, key, bridgeId } = obligation.origin;
43
+ const oKey = originKey(friendId, channel, key);
44
+ if (seen.has(oKey))
45
+ continue; // deduplicate: prefer drained version
46
+ seen.add(oKey);
47
+ const resolvedName = friendNameResolver(friendId);
48
+ items.push({
49
+ id: obligation.id,
50
+ friendId,
51
+ friendName: resolvedName ?? friendId,
52
+ channel,
53
+ key,
54
+ ...(bridgeId ? { bridgeId } : {}),
55
+ delegatedContent: obligation.delegatedContent,
56
+ obligationId: obligation.id,
57
+ source: "obligation-recovery",
58
+ timestamp: obligation.createdAt,
59
+ });
60
+ }
61
+ // Sort FIFO (oldest first)
62
+ items.sort((a, b) => a.timestamp - b.timestamp);
63
+ (0, runtime_1.emitNervesEvent)({
64
+ event: "senses.attention_queue_built",
65
+ component: "senses",
66
+ message: `attention queue built with ${items.length} item(s)`,
67
+ meta: {
68
+ drainedCount: items.filter((i) => i.source === "drained").length,
69
+ recoveredCount: items.filter((i) => i.source === "obligation-recovery").length,
70
+ },
71
+ });
72
+ return items;
73
+ }
74
+ // ── Queue operations ─────────────────────────────────────────────
75
+ function dequeueAttentionItem(queue, id) {
76
+ const index = queue.findIndex((item) => item.id === id);
77
+ if (index === -1)
78
+ return null;
79
+ return queue.splice(index, 1)[0];
80
+ }
81
+ function attentionQueueEmpty(queue) {
82
+ return queue.length === 0;
83
+ }
84
+ // ── Queue visibility ─────────────────────────────────────────────
85
+ const CONTENT_PREVIEW_MAX = 80;
86
+ function buildAttentionQueueSummary(queue) {
87
+ if (queue.length === 0)
88
+ return "";
89
+ const lines = ["you're holding:"];
90
+ for (const item of queue) {
91
+ const preview = item.delegatedContent.length > CONTENT_PREVIEW_MAX
92
+ ? `${item.delegatedContent.slice(0, CONTENT_PREVIEW_MAX - 3)}...`
93
+ : item.delegatedContent;
94
+ lines.push(`- [${item.id}] ${item.friendName} asked: "${preview}"`);
95
+ }
96
+ return lines.join("\n");
97
+ }