@agentprojectcontext/apx 1.31.2 → 1.32.2

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 (229) hide show
  1. package/package.json +6 -1
  2. package/skills/apc-context/SKILL.md +5 -2
  3. package/skills/apx/SKILL.md +3 -3
  4. package/skills/apx-agency-agents/SKILL.md +5 -5
  5. package/skills/apx-agent/SKILL.md +7 -7
  6. package/skills/apx-mcp/SKILL.md +6 -4
  7. package/skills/apx-mcp-builder/SKILL.md +4 -7
  8. package/skills/apx-project/SKILL.md +4 -5
  9. package/skills/apx-routine/SKILL.md +14 -12
  10. package/skills/apx-runtime/SKILL.md +5 -3
  11. package/skills/apx-sessions/SKILL.md +5 -5
  12. package/skills/apx-skill-builder/SKILL.md +10 -6
  13. package/skills/apx-task/SKILL.md +8 -8
  14. package/skills/apx-telegram/SKILL.md +23 -7
  15. package/skills/apx-voice/SKILL.md +8 -6
  16. package/src/core/{agent-system.js → agent/build-agent-system.js} +10 -12
  17. package/src/core/agent/constants.js +5 -0
  18. package/src/core/agent/index.js +0 -2
  19. package/src/core/{agent-memory.js → agent/memory.js} +2 -2
  20. package/src/core/agent/model-router.js +21 -43
  21. package/src/core/agent/prompt-builder.js +17 -63
  22. package/src/core/agent/prompts/action-discipline.md +17 -0
  23. package/src/core/agent/prompts/channels/code.md +8 -12
  24. package/src/core/agent/prompts/channels/desktop.md +6 -4
  25. package/src/core/agent/prompts/channels/routine.md +10 -1
  26. package/src/core/agent/prompts/channels/telegram.md +5 -0
  27. package/src/core/agent/prompts/channels/web_code.md +20 -0
  28. package/src/core/agent/prompts/modes/voice.md +2 -2
  29. package/src/core/agent/prompts/super-agent-base.md +2 -2
  30. package/src/core/agent/run-agent.js +66 -36
  31. package/src/core/agent/runtime-bridge.js +42 -0
  32. package/src/core/agent/self-memory.js +19 -9
  33. package/src/core/agent/skills/catalog.js +65 -0
  34. package/src/core/agent/skills/index.js +6 -0
  35. package/src/{host/daemon/skills-loader.js → core/agent/skills/loader.js} +3 -3
  36. package/src/core/agent/skills/rag.js +91 -0
  37. package/src/core/agent/skills/trigger.js +71 -0
  38. package/src/{host/daemon → core/agent}/super-agent.js +5 -5
  39. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/add-project.js +3 -4
  40. package/src/core/agent/tools/handlers/ask-questions.js +115 -0
  41. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/call-agent.js +2 -2
  42. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/call-mcp.js +1 -2
  43. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/call-runtime.js +10 -11
  44. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/create-task.js +1 -1
  45. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/discover-tools.js +1 -1
  46. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/edit-file.js +1 -2
  47. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/import-agent.js +4 -5
  48. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-agents.js +1 -1
  49. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-skills.js +7 -2
  50. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-tasks.js +1 -1
  51. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-vault-agents.js +1 -1
  52. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/load-skill.js +1 -1
  53. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/read-agent-memory.js +1 -1
  54. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/read-self-memory.js +1 -1
  55. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/remember.js +1 -1
  56. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/run-shell.js +1 -2
  57. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/search-messages.js +1 -1
  58. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/search-sessions.js +1 -1
  59. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/send-telegram.js +0 -2
  60. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/set-identity.js +1 -3
  61. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/set-permission-mode.js +1 -3
  62. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/tail-messages.js +1 -1
  63. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/transcribe-audio.js +1 -1
  64. package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/write-file.js +1 -2
  65. package/src/core/agent/tools/helpers.js +74 -0
  66. package/src/{host/daemon/super-agent-tools → core/agent/tools}/registry-bridge.js +3 -3
  67. package/src/{host/daemon/super-agent-tools/index.js → core/agent/tools/registry.js} +31 -32
  68. package/src/core/apc/agents-vault.js +37 -0
  69. package/src/core/{scaffold.js → apc/scaffold.js} +4 -5
  70. package/src/core/{config.js → config/index.js} +21 -27
  71. package/src/core/config/paths.js +32 -0
  72. package/src/core/constants/actors.js +8 -0
  73. package/src/core/constants/channels.js +19 -0
  74. package/src/core/constants/index.js +5 -0
  75. package/src/core/constants/permissions.js +17 -0
  76. package/src/core/constants/roles.js +9 -0
  77. package/src/core/engines/_streaming.js +63 -0
  78. package/src/core/engines/anthropic.js +11 -22
  79. package/src/core/engines/ollama.js +7 -16
  80. package/src/core/identity/index.js +8 -0
  81. package/src/core/{identity.js → identity/self.js} +5 -5
  82. package/src/core/{telegram-identity.js → identity/telegram.js} +1 -1
  83. package/src/core/logging.js +1 -1
  84. package/src/core/mascot.js +1 -1
  85. package/src/core/memory/active-threads.js +10 -10
  86. package/src/core/memory/broker.js +9 -9
  87. package/src/core/memory/compactor.js +2 -2
  88. package/src/core/memory/index.js +2 -2
  89. package/src/core/memory/indexer.js +1 -1
  90. package/src/core/{code-sessions-store.js → stores/code-sessions.js} +3 -7
  91. package/src/core/{messages-store.js → stores/messages.js} +6 -4
  92. package/src/core/stores/routine-memory.js +71 -0
  93. package/src/core/{routines-store.js → stores/routines.js} +1 -3
  94. package/src/core/stores/runtime-sessions.js +99 -0
  95. package/src/core/{tasks-store.js → stores/tasks.js} +3 -8
  96. package/src/core/update-check.js +1 -1
  97. package/src/core/util/ids.js +14 -0
  98. package/src/core/util/index.js +2 -0
  99. package/src/core/util/text-similarity.js +52 -0
  100. package/src/core/util/time.js +9 -0
  101. package/src/core/voice/tts.js +1 -1
  102. package/src/host/daemon/api/admin-config.js +4 -3
  103. package/src/host/daemon/api/admin.js +1 -1
  104. package/src/host/daemon/api/agents.js +4 -25
  105. package/src/host/daemon/api/artifacts.js +118 -1
  106. package/src/host/daemon/api/code.js +60 -16
  107. package/src/host/daemon/api/confirm.js +1 -1
  108. package/src/host/daemon/api/connections.js +2 -2
  109. package/src/host/daemon/api/conversations.js +2 -2
  110. package/src/host/daemon/api/deck.js +1 -1
  111. package/src/host/daemon/api/desktop.js +1 -1
  112. package/src/host/daemon/api/embeddings.js +4 -4
  113. package/src/host/daemon/api/engines.js +2 -2
  114. package/src/host/daemon/api/exec.js +3 -3
  115. package/src/host/daemon/api/identity.js +1 -1
  116. package/src/host/daemon/api/mcps.js +1 -1
  117. package/src/host/daemon/api/messages.js +1 -1
  118. package/src/host/daemon/api/runtimes.js +9 -8
  119. package/src/host/daemon/api/sessions-search.js +1 -1
  120. package/src/host/daemon/api/sessions.js +2 -2
  121. package/src/host/daemon/api/shared.js +5 -4
  122. package/src/host/daemon/api/skills.js +30 -0
  123. package/src/host/daemon/api/super-agent.js +29 -9
  124. package/src/host/daemon/api/tasks.js +2 -2
  125. package/src/host/daemon/api/telegram.js +1 -1
  126. package/src/host/daemon/api/tools.js +6 -6
  127. package/src/host/daemon/api/tts.js +2 -2
  128. package/src/host/daemon/api/voice.js +14 -12
  129. package/src/host/daemon/api.js +2 -0
  130. package/src/host/daemon/compact.js +1 -1
  131. package/src/host/daemon/db.js +4 -4
  132. package/src/host/daemon/desktop-ws.js +1 -1
  133. package/src/host/daemon/index.js +4 -4
  134. package/src/host/daemon/plugins/{desktop.js → desktop/index.js} +45 -6
  135. package/src/host/daemon/plugins/index.js +2 -2
  136. package/src/host/daemon/plugins/telegram/ask.js +309 -0
  137. package/src/host/daemon/plugins/{telegram.js → telegram/index.js} +390 -191
  138. package/src/host/daemon/plugins/telegram/media.js +162 -0
  139. package/src/host/daemon/projects-helpers.js +54 -0
  140. package/src/host/daemon/routines.js +28 -12
  141. package/src/host/daemon/smoke.js +2 -2
  142. package/src/host/daemon/token-store.js +1 -1
  143. package/src/host/daemon/transcription.js +2 -2
  144. package/src/host/daemon/wakeup.js +2 -2
  145. package/src/interfaces/cli/commands/agent.js +3 -3
  146. package/src/interfaces/cli/commands/artifact.js +99 -0
  147. package/src/interfaces/cli/commands/command.js +1 -1
  148. package/src/interfaces/cli/commands/config.js +3 -2
  149. package/src/interfaces/cli/commands/desktop.js +1 -1
  150. package/src/interfaces/cli/commands/exec.js +2 -1
  151. package/src/interfaces/cli/commands/identity.js +2 -2
  152. package/src/interfaces/cli/commands/init.js +1 -1
  153. package/src/interfaces/cli/commands/mcp.js +1 -1
  154. package/src/interfaces/cli/commands/memory.js +2 -2
  155. package/src/interfaces/cli/commands/model.js +16 -6
  156. package/src/interfaces/cli/commands/project.js +1 -1
  157. package/src/interfaces/cli/commands/routine.js +58 -0
  158. package/src/interfaces/cli/commands/search.js +1 -1
  159. package/src/interfaces/cli/commands/session.js +4 -4
  160. package/src/interfaces/cli/commands/setup.js +4 -3
  161. package/src/interfaces/cli/commands/skills.js +25 -4
  162. package/src/interfaces/cli/commands/status.js +1 -1
  163. package/src/interfaces/cli/commands/sys.js +11 -4
  164. package/src/interfaces/cli/commands/update.js +1 -1
  165. package/src/interfaces/cli/index.js +8 -4
  166. package/src/interfaces/cli/postinstall.js +2 -2
  167. package/src/interfaces/cli/terminal-chat/renderer.js +22 -2
  168. package/src/interfaces/mcp-server/index.js +1 -1
  169. package/src/interfaces/tui/component/prompt/index.tsx +3 -1
  170. package/src/interfaces/tui/context/sdk-apx.tsx +47 -7
  171. package/src/interfaces/tui/context/sync-apx.tsx +20 -2
  172. package/src/interfaces/tui/context/sync.tsx +2 -1
  173. package/src/interfaces/tui/routes/session/index.tsx +151 -136
  174. package/src/interfaces/tui/routes/session/sidebar-apx.tsx +37 -15
  175. package/src/interfaces/tui/run.ts +2 -0
  176. package/src/interfaces/web/dist/assets/index-34U_Mp1M.css +1 -0
  177. package/src/interfaces/web/dist/assets/index-BkybwwRn.js +570 -0
  178. package/src/interfaces/web/dist/assets/index-BkybwwRn.js.map +1 -0
  179. package/src/interfaces/web/dist/index.html +2 -2
  180. package/src/interfaces/web/package-lock.json +9 -9
  181. package/src/interfaces/web/src/App.tsx +51 -32
  182. package/src/interfaces/web/src/components/RobyBubble.tsx +12 -6
  183. package/src/interfaces/web/src/components/UiSelect.tsx +1 -1
  184. package/src/interfaces/web/src/components/chat/AskQuestionsCard.tsx +72 -0
  185. package/src/interfaces/web/src/components/chat/InlineAskPanel.tsx +399 -0
  186. package/src/interfaces/web/src/components/chat/MessageBubble.tsx +16 -3
  187. package/src/interfaces/web/src/components/chat/MessageList.tsx +2 -1
  188. package/src/interfaces/web/src/components/chat/SkillPicker.tsx +77 -0
  189. package/src/interfaces/web/src/components/code/CodeArtifactsTab.tsx +230 -0
  190. package/src/interfaces/web/src/components/code/CodeProjectPicker.tsx +1 -1
  191. package/src/interfaces/web/src/components/code/CodeSidePanel.tsx +40 -17
  192. package/src/interfaces/web/src/components/common/TabLayout.tsx +9 -5
  193. package/src/interfaces/web/src/components/common/TabNav.tsx +3 -3
  194. package/src/interfaces/web/src/components/layout/ProjectSidebar.tsx +4 -2
  195. package/src/interfaces/web/src/hooks/useChat.ts +47 -2
  196. package/src/interfaces/web/src/hooks/useNavCollapseCtx.tsx +59 -0
  197. package/src/interfaces/web/src/hooks/usePersonaName.ts +11 -0
  198. package/src/interfaces/web/src/i18n/en.ts +27 -7
  199. package/src/interfaces/web/src/i18n/es.ts +27 -7
  200. package/src/interfaces/web/src/lib/api/artifacts.ts +47 -0
  201. package/src/interfaces/web/src/lib/api/skills.ts +25 -0
  202. package/src/interfaces/web/src/lib/api.ts +2 -0
  203. package/src/interfaces/web/src/screens/modules/CodeScreen.tsx +41 -20
  204. package/src/interfaces/web/src/screens/modules/DeckScreen.tsx +5 -18
  205. package/src/interfaces/web/src/screens/modules/DesktopScreen.tsx +1 -8
  206. package/src/interfaces/web/src/screens/modules/VoiceScreen.tsx +39 -40
  207. package/src/interfaces/web/src/screens/project/ChatTab.tsx +27 -9
  208. package/src/skills/apc-context/SKILL.md +159 -0
  209. package/src/core/agent/ghost-guard.js +0 -24
  210. package/src/core/agent/prompts/channels/terminal.md +0 -16
  211. package/src/host/daemon/apc-runtime-context.js +0 -124
  212. package/src/host/daemon/super-agent-tools/helpers.js +0 -124
  213. package/src/host/daemon/super-agent-tools/tools/ask-questions.js +0 -32
  214. package/src/host/daemon/tool-call-parser.js +0 -2
  215. package/src/interfaces/web/dist/assets/index-BDUsA6L6.css +0 -1
  216. package/src/interfaces/web/dist/assets/index-BV615I9p.js +0 -548
  217. package/src/interfaces/web/dist/assets/index-BV615I9p.js.map +0 -1
  218. /package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-files.js +0 -0
  219. /package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-mcps.js +0 -0
  220. /package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/list-projects.js +0 -0
  221. /package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/read-file.js +0 -0
  222. /package/src/{host/daemon/super-agent-tools/tools → core/agent/tools/handlers}/search-files.js +0 -0
  223. /package/src/core/agent/{pseudo-tools.js → tools/pseudo-tools.js} +0 -0
  224. /package/src/core/agent/{tool-call-parser.js → tools/tool-call-parser.js} +0 -0
  225. /package/src/core/{parser.js → apc/parser.js} +0 -0
  226. /package/src/core/{apc-skill-sync.js → apc/skill-sync.js} +0 -0
  227. /package/src/core/{artifacts-store.js → stores/artifacts.js} +0 -0
  228. /package/src/{host/daemon → core/stores}/engine-sessions.js +0 -0
  229. /package/src/core/{session-store.js → stores/sessions.js} +0 -0
@@ -1,24 +0,0 @@
1
- export function isShortConfirmation(text) {
2
- return /^(yes|y|si|si dale|dale|ok|okay|confirm|confirmed|go|proceed|do it)\b/i
3
- .test(String(text || "").trim());
4
- }
5
-
6
- export function lastAssistantAskedForConfirmation(messages) {
7
- for (let i = messages.length - 1; i >= 0; i--) {
8
- if (messages[i]?.role !== "assistant") continue;
9
- return /\b(confirm|confirmation|ok|okay|permission|allowed|proceed|do it|dale)\b/i.test(messages[i].content || "");
10
- }
11
- return false;
12
- }
13
-
14
- export function isGhostResponse(text) {
15
- const t = String(text || "").trim();
16
- if (t.length > 200) return false;
17
- return /^(ok|okay|got it|understood|sure|of course|on it|dale|entendido|claro|voy|ya lo hago|dame un (segundo|momento)|un momento|let me|i (will|can|shall)|i'm (going|about)|give me a|ahora lo|enseguida|checking|looking|fetching|working on|stand by|please wait|un seg|dame sec)[\s.,!]*/i
18
- .test(t);
19
- }
20
-
21
- export function looksLikeActionRequest(text) {
22
- const t = String(text || "").trim().toLowerCase();
23
- return /\b(list|show|find|get|fetch|search|run|execute|create|add|make|start|stop|delete|update|send|check|read|write|look|tell me|dame|mostra|busca|ejecuta|crea|agrega|mandá|revisá|corré|borrá|arrancá)\b/.test(t);
24
- }
@@ -1,16 +0,0 @@
1
- # Channel context
2
- Channel: **terminal** (interactive APX sys session) — the same OpenCode-style coding surface as the web Code module, just in the terminal. You can read, search, edit files and run shell commands.
3
-
4
- - CWD: {{cwd}}
5
- - References to "this directory", "this project", "here", "current folder" mean the CWD above — use it as the path argument; do not ask for a path
6
-
7
- Working style — KEEP GOING UNTIL THE TASK IS DONE (build mode):
8
- - You are an autonomous coding agent. Once the user gives a task, complete the WHOLE thing in this turn: chain as many tool calls as needed (read → edit → run → verify), do not stop after one or two steps.
9
- - NEVER stop to ask "do you want me to…?" / "¿confirmás…?" / "should I continue?". You already have permission on this surface — just do it. Only ask if the task is truly ambiguous and you genuinely cannot proceed.
10
- - NEVER announce an action and then end your turn ("now I'll edit the file." → stop). If you say you will do something, immediately call the tool and actually do it in the same turn.
11
- - After each tool result, decide the next concrete step and take it. Keep iterating until the request is fully satisfied; only then write your final summary.
12
- - If something fails, read the error, fix it, and retry — don't hand the problem back to the user.
13
-
14
- Formatting:
15
- - Markdown OK; keep readable; use code diffs when editing.
16
- - Lead with the result; keep prose tight. Don't re-paste full tool output the user can already see.
@@ -1,124 +0,0 @@
1
- // Helpers that wrap external runtimes (Claude Code, Codex, OpenCode, Aider,
2
- // Cursor Agent, Gemini CLI, Qwen Code)
3
- // with APC awareness:
4
- //
5
- // 1. Create an APX runtime session BEFORE the runtime starts.
6
- // 2. Inject an "APC Runtime Context" block into the system prompt so the
7
- // runtime knows the session id, the cwd of the project, and the apx
8
- // commands it can use to update memory / append session notes.
9
- // 3. After the runtime returns, capture the external transcript path
10
- // (Claude Code gives one; most other runtimes don't yet) and write it
11
- // into the APX session frontmatter.
12
- // 4. Close the session with a synthesised result (truncated stdout).
13
- //
14
- // Used by both POST /projects/:pid/agents/:slug/runtime (CLI) and the
15
- // super-agent's call_runtime tool.
16
-
17
- import fs from "node:fs";
18
- import path from "node:path";
19
- import { generateSessionId } from "../../core/session-store.js";
20
-
21
- const nowIso = () => new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
22
-
23
- const APC_RUNTIME_HINT = `
24
- # APC Runtime Context
25
-
26
- You are running inside an APC (Agent Project Context) project. APC gives you portable project context. APX gives you local runtime session state.
27
-
28
- - **Project**: {{name}} ({{path}})
29
- - **Agent**: {{agent}}
30
- - **APC session id**: {{session_id}}
31
- (stored in APX local runtime storage, outside .apc/)
32
-
33
- ## Commands you can use during this run
34
-
35
- - \`apx memory {{agent}} --append "<note>"\` save a long-term fact for this agent
36
- - \`apx session update {{session_id}} --status "..."\` update the session status
37
- - \`apx session update {{session_id}} --task-ref TASK-...\` link to an external task
38
-
39
- ## When you finish
40
-
41
- Close the session with a one-line result so a future operator (or apx session resume) can summarize:
42
-
43
- apx session close {{session_id}} --result "<one-line summary of what you did>"
44
-
45
- If you cannot run apx (sandboxed shell), just print the result on the last line of your output prefixed with "APC_RESULT:" and APX will capture it automatically.
46
- `.trim();
47
-
48
- export function buildApfHint({ projectName, projectPath, agentSlug, sessionId }) {
49
- return APC_RUNTIME_HINT
50
- .replace(/\{\{name\}\}/g, projectName)
51
- .replace(/\{\{path\}\}/g, projectPath)
52
- .replace(/\{\{agent\}\}/g, agentSlug)
53
- .replace(/\{\{session_id\}\}/g, sessionId);
54
- }
55
-
56
- // Create the APX runtime session file on disk. Returns { id, filename, path }.
57
- export function createRuntimeSession({ projectRoot, storageRoot = projectRoot, agentSlug, runtime, taskRef = "", title }) {
58
- const dir = path.join(storageRoot, "agents", agentSlug, "sessions");
59
- fs.mkdirSync(dir, { recursive: true });
60
- const id = generateSessionId(storageRoot, agentSlug);
61
- const file = path.join(dir, `${id}.md`);
62
- const started = nowIso();
63
- const sessionTitle = title || `Runtime: ${runtime}`;
64
- const body =
65
- `---\n` +
66
- `id: ${id}\n` +
67
- `agent: ${agentSlug}\n` +
68
- `title: ${sessionTitle}\n` +
69
- `task_ref: ${taskRef}\n` +
70
- `status: 🔄 In progress\n` +
71
- `started: ${started}\n` +
72
- `completed: \n` +
73
- `result: \n` +
74
- `runtime: ${runtime}\n` +
75
- `external_session_path: \n` +
76
- `---\n\n` +
77
- `# ${sessionTitle}\n\n`;
78
- fs.writeFileSync(file, body);
79
- return { id, filename: `${id}.md`, path: file };
80
- }
81
-
82
- // Update session frontmatter with the external transcript path captured from
83
- // the runtime adapter. Closes the session with a result string.
84
- export function closeRuntimeSession({ filePath, externalSessionPath, exitCode, result }) {
85
- let text = fs.readFileSync(filePath, "utf8");
86
- text = setField(text, "completed", nowIso());
87
- if (externalSessionPath) {
88
- text = setField(text, "external_session_path", externalSessionPath);
89
- }
90
- if (typeof exitCode === "number") {
91
- text = setField(text, "result", `${exitCode === 0 ? "✅" : "⚠️"} exit ${exitCode}: ${(result || "").slice(0, 200)}`);
92
- } else if (result) {
93
- text = setField(text, "result", result.slice(0, 300));
94
- }
95
- text = setField(text, "status", exitCode === 0 ? "✅ Completed" : "⚠️ Closed with error");
96
- fs.writeFileSync(filePath, text);
97
- }
98
-
99
- function setField(text, field, value) {
100
- if (!text.startsWith("---\n")) return text;
101
- const end = text.indexOf("\n---", 4);
102
- if (end === -1) return text;
103
- const fmText = text.slice(4, end);
104
- const lines = fmText.split("\n");
105
- let found = false;
106
- const out = lines.map((line) => {
107
- if (line.startsWith(`${field}:`)) {
108
- found = true;
109
- return `${field}: ${value}`;
110
- }
111
- return line;
112
- });
113
- if (!found) out.push(`${field}: ${value}`);
114
- return `---\n${out.join("\n")}\n---${text.slice(end + 4)}`;
115
- }
116
-
117
- // Look at the runtime's stdout for a self-reported "APC_RESULT: ..." line
118
- // (the convention printed in the hint above). Returns the captured string or
119
- // null. This is the fallback for runtimes that can't shell out.
120
- export function extractApfResult(stdout) {
121
- if (!stdout || typeof stdout !== "string") return null;
122
- const m = stdout.match(/^APC_RESULT:\s*(.+?)\s*$/m);
123
- return m ? m[1].trim() : null;
124
- }
@@ -1,124 +0,0 @@
1
- import path from "node:path";
2
- import { agentSkills, buildAgentSystem as buildCoreAgentSystem } from "../../../core/agent-system.js";
3
- import { buildConfirmDescription } from "../../../core/confirmation/index.js";
4
-
5
- export function projectMeta(projects, entry) {
6
- const meta = projects.list().find((p) => p.id === entry.id);
7
- return {
8
- id: entry.id,
9
- name: meta?.name || path.basename(entry.path),
10
- path: entry.path,
11
- };
12
- }
13
-
14
- export function resolveProject(projects, target, { allowMulti = false } = {}) {
15
- if (target === undefined || target === null || target === "") {
16
- if (allowMulti) return null;
17
- const defaultProject = projects.get(0);
18
- if (defaultProject) return defaultProject;
19
- const all = projects.list();
20
- if (all.length === 1) return projects.get(all[0].id);
21
- throw new Error(`multiple projects registered (${all.length}); specify project=<id|name|path>`);
22
- }
23
-
24
- const tgt = String(target);
25
- if (tgt.toLowerCase() === "default") {
26
- const defaultProject = projects.get(0);
27
- if (!defaultProject) throw new Error("default project not available");
28
- return defaultProject;
29
- }
30
-
31
- if (typeof target === "number" || /^\d+$/.test(tgt)) {
32
- const entry = projects.get(parseInt(tgt, 10));
33
- if (!entry) throw new Error(`project id ${target} not found`);
34
- return entry;
35
- }
36
-
37
- const all = projects.list();
38
- const byPath = all.find((p) => p.path === path.resolve(tgt));
39
- if (byPath) return projects.get(byPath.id);
40
-
41
- const byName = all.find((p) => p.name === tgt);
42
- if (byName) return projects.get(byName.id);
43
-
44
- const tgtLow = tgt.toLowerCase();
45
- const fuzzy = all.filter(
46
- (p) => p.name.toLowerCase().includes(tgtLow) || p.path.toLowerCase().includes(tgtLow)
47
- );
48
- if (fuzzy.length === 1) return projects.get(fuzzy[0].id);
49
- if (fuzzy.length > 1) {
50
- throw new Error(`project "${tgt}" is ambiguous; matches: ${fuzzy.map((p) => p.name).join(", ")}`);
51
- }
52
- throw new Error(`project "${tgt}" not found`);
53
- }
54
-
55
- export function safePathJoin(root, sub = ".") {
56
- const target = path.resolve(root, sub || ".");
57
- const rootResolved = path.resolve(root);
58
- if (target !== rootResolved && !target.startsWith(rootResolved + path.sep)) {
59
- throw new Error(`path "${sub}" escapes the project root`);
60
- }
61
- return target;
62
- }
63
-
64
- export function skillsFromFields(fields = {}) {
65
- return agentSkills({ fields });
66
- }
67
-
68
- export function agentRow(agent) {
69
- return {
70
- slug: agent.slug,
71
- role: agent.fields.Role || null,
72
- model: agent.fields.Model || null,
73
- language: agent.fields.Language || null,
74
- description: agent.fields.Description || null,
75
- skills: skillsFromFields(agent.fields),
76
- };
77
- }
78
-
79
- export function buildAgentSystem(project, agent, opts = {}) {
80
- return buildCoreAgentSystem(project, agent, opts);
81
- }
82
-
83
- export function createPermissionGuard(globalConfig = {}, {
84
- implicitConfirmation = false,
85
- requestConfirmation = null,
86
- } = {}) {
87
- const permissionMode = globalConfig.super_agent?.permission_mode || "automatico";
88
- const allowedTools = new Set(globalConfig.super_agent?.allowed_tools || []);
89
-
90
- // async so tools can `await requirePermission(...)` and the confirmation
91
- // dialog resolves transparently before execution continues.
92
- return async function requirePermission(tool, { dangerous = false, confirmed = false, args } = {}) {
93
- const ok = confirmed || implicitConfirmation;
94
- if (permissionMode === "total") return;
95
-
96
- const blocked =
97
- (permissionMode === "permiso" && !allowedTools.has(tool) && !ok) ||
98
- (permissionMode === "automatico" && dangerous && !ok);
99
-
100
- if (!blocked) return;
101
-
102
- const description = buildConfirmDescription(tool, args || {});
103
-
104
- if (!requestConfirmation) {
105
- // No confirmation channel wired for this invocation context (e.g. routine,
106
- // autonomous agent). Surface a clear message so the model can explain it.
107
- throw new Error(`Action requires user confirmation: ${description}`);
108
- }
109
-
110
- const userConfirmed = await requestConfirmation(tool, args || {}, description);
111
-
112
- if (!userConfirmed) {
113
- throw new Error(`User did not confirm: ${description}`);
114
- }
115
- // Confirmed — fall through, tool executes normally.
116
- };
117
- }
118
-
119
- export function confirmedProperty(description) {
120
- return {
121
- type: "boolean",
122
- description: description || "true only after explicit user confirmation for this exact action",
123
- };
124
- }
@@ -1,32 +0,0 @@
1
- export default {
2
- name: "ask_questions",
3
- schema: {
4
- // type: "function" is REQUIRED at the top level — OpenAI and Groq reject
5
- // schemas without it (Groq → 400 'tools.N.type': property 'type' is missing).
6
- // Anthropic / Ollama tolerate its absence but the contract is clearer with it.
7
- type: "function",
8
- function: {
9
- name: "ask_questions",
10
- description: "Ask the user one or more specific questions to clarify the task or gather requirements.",
11
- parameters: {
12
- type: "object",
13
- properties: {
14
- questions: {
15
- type: "array",
16
- items: { type: "string" },
17
- description: "A list of questions for the user."
18
- }
19
- },
20
- required: ["questions"]
21
- }
22
- }
23
- },
24
- makeHandler: () => async ({ questions }) => {
25
- // This tool is used by the agent to explicitly signal that it is waiting for
26
- // answers to specific questions. The UI can then highlight these.
27
- return {
28
- status: "Questions presented to user. Waiting for input.",
29
- count: questions.length
30
- };
31
- }
32
- };
@@ -1,2 +0,0 @@
1
- // Compat shim — parser moved to core/agent/tool-call-parser.js
2
- export * from "../../core/agent/tool-call-parser.js";