@zihanw/pi-forge 0.3.2 → 0.4.0

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 (231) hide show
  1. package/CHANGELOG.md +196 -0
  2. package/PUBLIC_API.md +5 -0
  3. package/README.md +93 -478
  4. package/README.zh-CN.md +88 -461
  5. package/SUBAGENT_ADAPTER_CONTRACT.md +5 -0
  6. package/dist/agent-profile.d.ts +71 -0
  7. package/dist/agent-profile.d.ts.map +1 -0
  8. package/dist/agent-profile.js +303 -0
  9. package/dist/agent-profile.js.map +1 -0
  10. package/dist/forge-config.d.ts +88 -0
  11. package/dist/forge-config.d.ts.map +1 -0
  12. package/dist/forge-config.js +290 -0
  13. package/dist/forge-config.js.map +1 -0
  14. package/dist/forge-extensions.d.ts.map +1 -1
  15. package/dist/forge-extensions.js +19 -3
  16. package/dist/forge-extensions.js.map +1 -1
  17. package/dist/index.d.ts +4 -0
  18. package/dist/index.d.ts.map +1 -1
  19. package/dist/index.js +97 -358
  20. package/dist/index.js.map +1 -1
  21. package/dist/lifecycle.d.ts +11 -3
  22. package/dist/lifecycle.d.ts.map +1 -1
  23. package/dist/lifecycle.js +90 -4
  24. package/dist/lifecycle.js.map +1 -1
  25. package/dist/loader.d.ts.map +1 -1
  26. package/dist/loader.js +116 -5
  27. package/dist/loader.js.map +1 -1
  28. package/dist/payload-capture.d.ts.map +1 -1
  29. package/dist/payload-capture.js +27 -0
  30. package/dist/payload-capture.js.map +1 -1
  31. package/dist/payload-command.d.ts +3 -3
  32. package/dist/payload-command.d.ts.map +1 -1
  33. package/dist/payload-command.js.map +1 -1
  34. package/dist/preview.d.ts +2 -2
  35. package/dist/preview.d.ts.map +1 -1
  36. package/dist/preview.js +2 -3
  37. package/dist/preview.js.map +1 -1
  38. package/dist/profile-command.d.ts +12 -0
  39. package/dist/profile-command.d.ts.map +1 -0
  40. package/dist/profile-command.js +291 -0
  41. package/dist/profile-command.js.map +1 -0
  42. package/dist/profile-service.d.ts +103 -0
  43. package/dist/profile-service.d.ts.map +1 -0
  44. package/dist/profile-service.js +220 -0
  45. package/dist/profile-service.js.map +1 -0
  46. package/dist/runtime/profile-runtime.d.ts +13 -0
  47. package/dist/runtime/profile-runtime.d.ts.map +1 -0
  48. package/dist/runtime/profile-runtime.js +47 -0
  49. package/dist/runtime/profile-runtime.js.map +1 -0
  50. package/dist/runtime/prompt-stack-runtime.d.ts +22 -0
  51. package/dist/runtime/prompt-stack-runtime.d.ts.map +1 -0
  52. package/dist/runtime/prompt-stack-runtime.js +104 -0
  53. package/dist/runtime/prompt-stack-runtime.js.map +1 -0
  54. package/dist/runtime/subagent-runtime.d.ts +45 -0
  55. package/dist/runtime/subagent-runtime.d.ts.map +1 -0
  56. package/dist/runtime/subagent-runtime.js +335 -0
  57. package/dist/runtime/subagent-runtime.js.map +1 -0
  58. package/dist/runtime/tool-policy-runtime.d.ts +15 -0
  59. package/dist/runtime/tool-policy-runtime.d.ts.map +1 -0
  60. package/dist/runtime/tool-policy-runtime.js +170 -0
  61. package/dist/runtime/tool-policy-runtime.js.map +1 -0
  62. package/dist/runtime/web-editor-runtime.d.ts +9 -0
  63. package/dist/runtime/web-editor-runtime.d.ts.map +1 -0
  64. package/dist/runtime/web-editor-runtime.js +131 -0
  65. package/dist/runtime/web-editor-runtime.js.map +1 -0
  66. package/dist/runtime-state.d.ts +4 -0
  67. package/dist/runtime-state.d.ts.map +1 -1
  68. package/dist/runtime-state.js +2 -0
  69. package/dist/runtime-state.js.map +1 -1
  70. package/dist/storage.d.ts +4 -0
  71. package/dist/storage.d.ts.map +1 -1
  72. package/dist/storage.js +24 -1
  73. package/dist/storage.js.map +1 -1
  74. package/dist/subagent/canonical.d.ts +22 -0
  75. package/dist/subagent/canonical.d.ts.map +1 -0
  76. package/dist/subagent/canonical.js +24 -0
  77. package/dist/subagent/canonical.js.map +1 -0
  78. package/dist/subagent/context.d.ts +8 -0
  79. package/dist/subagent/context.d.ts.map +1 -0
  80. package/dist/subagent/context.js +125 -0
  81. package/dist/subagent/context.js.map +1 -0
  82. package/dist/subagent/contract.d.ts +10 -0
  83. package/dist/subagent/contract.d.ts.map +1 -0
  84. package/dist/subagent/contract.js +10 -0
  85. package/dist/subagent/contract.js.map +1 -0
  86. package/dist/subagent/index.d.ts +14 -0
  87. package/dist/subagent/index.d.ts.map +1 -0
  88. package/dist/subagent/index.js +14 -0
  89. package/dist/subagent/index.js.map +1 -0
  90. package/dist/subagent/plan.d.ts +18 -0
  91. package/dist/subagent/plan.d.ts.map +1 -0
  92. package/dist/subagent/plan.js +157 -0
  93. package/dist/subagent/plan.js.map +1 -0
  94. package/dist/subagent/preflight.d.ts +4 -0
  95. package/dist/subagent/preflight.d.ts.map +1 -0
  96. package/dist/subagent/preflight.js +108 -0
  97. package/dist/subagent/preflight.js.map +1 -0
  98. package/dist/subagent/request.d.ts +4 -0
  99. package/dist/subagent/request.d.ts.map +1 -0
  100. package/dist/subagent/request.js +122 -0
  101. package/dist/subagent/request.js.map +1 -0
  102. package/dist/subagent/response.d.ts +8 -0
  103. package/dist/subagent/response.d.ts.map +1 -0
  104. package/dist/subagent/response.js +155 -0
  105. package/dist/subagent/response.js.map +1 -0
  106. package/dist/subagent/tools.d.ts +4 -0
  107. package/dist/subagent/tools.d.ts.map +1 -0
  108. package/dist/subagent/tools.js +42 -0
  109. package/dist/subagent/tools.js.map +1 -0
  110. package/dist/subagent/types.d.ts +268 -0
  111. package/dist/subagent/types.d.ts.map +1 -0
  112. package/dist/subagent/types.js +3 -0
  113. package/dist/subagent/types.js.map +1 -0
  114. package/dist/subagent/validation.d.ts +35 -0
  115. package/dist/subagent/validation.d.ts.map +1 -0
  116. package/dist/subagent/validation.js +314 -0
  117. package/dist/subagent/validation.js.map +1 -0
  118. package/dist/subagent-command.d.ts +4 -0
  119. package/dist/subagent-command.d.ts.map +1 -0
  120. package/dist/subagent-command.js +246 -0
  121. package/dist/subagent-command.js.map +1 -0
  122. package/dist/subagent-host.d.ts +44 -0
  123. package/dist/subagent-host.d.ts.map +1 -0
  124. package/dist/subagent-host.js +292 -0
  125. package/dist/subagent-host.js.map +1 -0
  126. package/dist/subagent-profile-tool.d.ts +49 -0
  127. package/dist/subagent-profile-tool.d.ts.map +1 -0
  128. package/dist/subagent-profile-tool.js +124 -0
  129. package/dist/subagent-profile-tool.js.map +1 -0
  130. package/dist/subagent-tool.d.ts +53 -0
  131. package/dist/subagent-tool.d.ts.map +1 -0
  132. package/dist/subagent-tool.js +456 -0
  133. package/dist/subagent-tool.js.map +1 -0
  134. package/dist/web-editor/client-script.d.ts +2 -0
  135. package/dist/web-editor/client-script.d.ts.map +1 -0
  136. package/dist/web-editor/client-script.generated.d.ts +2 -0
  137. package/dist/web-editor/client-script.generated.d.ts.map +1 -0
  138. package/dist/web-editor/client-script.generated.js +3 -0
  139. package/dist/web-editor/client-script.generated.js.map +1 -0
  140. package/dist/web-editor/client-script.js +2 -0
  141. package/dist/web-editor/client-script.js.map +1 -0
  142. package/dist/web-editor/client-styles.d.ts +2 -0
  143. package/dist/web-editor/client-styles.d.ts.map +1 -0
  144. package/dist/web-editor/client-styles.generated.d.ts +2 -0
  145. package/dist/web-editor/client-styles.generated.d.ts.map +1 -0
  146. package/dist/web-editor/client-styles.generated.js +3 -0
  147. package/dist/web-editor/client-styles.generated.js.map +1 -0
  148. package/dist/web-editor/client-styles.js +2 -0
  149. package/dist/web-editor/client-styles.js.map +1 -0
  150. package/dist/web-editor/page.d.ts +2 -0
  151. package/dist/web-editor/page.d.ts.map +1 -1
  152. package/dist/web-editor/page.js +14 -3319
  153. package/dist/web-editor/page.js.map +1 -1
  154. package/dist/web-editor/server.d.ts.map +1 -1
  155. package/dist/web-editor/server.js +148 -0
  156. package/dist/web-editor/server.js.map +1 -1
  157. package/dist/web-editor/styles.d.ts +2 -0
  158. package/dist/web-editor/styles.d.ts.map +1 -0
  159. package/dist/web-editor/styles.js +1053 -0
  160. package/dist/web-editor/styles.js.map +1 -0
  161. package/dist/web-editor/types.d.ts +79 -0
  162. package/dist/web-editor/types.d.ts.map +1 -1
  163. package/dist/web-host.d.ts +16 -5
  164. package/dist/web-host.d.ts.map +1 -1
  165. package/dist/web-host.js +307 -0
  166. package/dist/web-host.js.map +1 -1
  167. package/docs/README.md +41 -0
  168. package/docs/concepts/agent-profiles.md +60 -0
  169. package/docs/concepts/prompt-stacks.md +90 -0
  170. package/docs/design/README.md +17 -0
  171. package/docs/design/roadmap-0.4-archive.md +216 -0
  172. package/docs/design/subagents/design-review.md +220 -0
  173. package/docs/design/subagents/interface-design.md +274 -0
  174. package/docs/design/subagents/sdk-spike-findings.md +117 -0
  175. package/docs/development/complexity-review.md +86 -0
  176. package/docs/development/release.md +31 -0
  177. package/docs/development/roadmap.md +42 -0
  178. package/docs/development/setup.md +75 -0
  179. package/docs/getting-started.md +93 -0
  180. package/docs/guides/custom-macros-and-slots.md +68 -0
  181. package/docs/guides/debugging.md +39 -0
  182. package/docs/guides/delegation.md +99 -0
  183. package/docs/guides/sillytavern-import.md +47 -0
  184. package/docs/guides/use-cases.md +65 -0
  185. package/docs/guides/web-editor.md +75 -0
  186. package/docs/reference/commands.md +60 -0
  187. package/docs/reference/configuration.md +64 -0
  188. package/docs/reference/features.md +279 -0
  189. package/docs/reference/macros-and-slots.md +82 -0
  190. package/docs/reference/public-api.md +28 -0
  191. package/docs/reference/stack-schema.md +167 -0
  192. package/docs/reference/subagent-adapter.md +204 -0
  193. package/docs/zh-CN/README.md +37 -0
  194. package/docs/zh-CN/concepts/agent-profiles.md +44 -0
  195. package/docs/zh-CN/concepts/prompt-stacks.md +40 -0
  196. package/docs/zh-CN/getting-started.md +79 -0
  197. package/docs/zh-CN/guides/delegation.md +66 -0
  198. package/docs/zh-CN/guides/web-editor.md +45 -0
  199. package/docs/zh-CN/reference/commands.md +58 -0
  200. package/package.json +55 -13
  201. package/src/compiler.ts +0 -578
  202. package/src/extension-registry.ts +0 -33
  203. package/src/forge-extensions.ts +0 -223
  204. package/src/index.ts +0 -445
  205. package/src/lifecycle.ts +0 -171
  206. package/src/loader.ts +0 -394
  207. package/src/macro-engine.ts +0 -358
  208. package/src/payload-capture.ts +0 -85
  209. package/src/payload-command.ts +0 -138
  210. package/src/policy.ts +0 -42
  211. package/src/preset-command.ts +0 -280
  212. package/src/preview.ts +0 -226
  213. package/src/regex.ts +0 -500
  214. package/src/render-helpers.ts +0 -169
  215. package/src/runtime-state.ts +0 -40
  216. package/src/sillytavern-importer/items.ts +0 -98
  217. package/src/sillytavern-importer/macros.ts +0 -159
  218. package/src/sillytavern-importer/prompt-order.ts +0 -54
  219. package/src/sillytavern-importer/regex.ts +0 -270
  220. package/src/sillytavern-importer/report.ts +0 -202
  221. package/src/sillytavern-importer/types.ts +0 -120
  222. package/src/sillytavern-importer.ts +0 -152
  223. package/src/slot-renderers.ts +0 -414
  224. package/src/stack-migration.ts +0 -159
  225. package/src/storage.ts +0 -45
  226. package/src/types.ts +0 -209
  227. package/src/web-editor/index.ts +0 -2
  228. package/src/web-editor/page.ts +0 -3330
  229. package/src/web-editor/server.ts +0 -294
  230. package/src/web-editor/types.ts +0 -98
  231. package/src/web-host.ts +0 -232
@@ -0,0 +1,292 @@
1
+ import { getRegisteredMacros, } from "./macro-engine.js";
2
+ import { getRegisteredSlots, } from "./slot-renderers.js";
3
+ import { compileMessages, compileSystemPrompt, createPromptVariableStore } from "./compiler.js";
4
+ import { subagentPromptStackFingerprint, subagentSourceProfileFingerprint, negotiateSubagentTools, prepareSubagentInitialMessages, } from "./subagent/contract.js";
5
+ const BUILT_IN_MACROS = new Set([
6
+ "cwd", "date", "time", "lastUserMessage", "selectedTools", "tools", "activeModel",
7
+ "setvar", "setturnvar", "setsessionvar", "getvar", "var", "getturnvar", "getsessionvar",
8
+ "clearvar", "clearturnvar", "clearsessionvar", "trim", "upper", "lower", "json", "xml",
9
+ "ifvar", "ifeq", "iftools", "ifslot",
10
+ ]);
11
+ const BUILT_IN_SLOTS = new Set([
12
+ "chat-history", "tools", "tool-guidelines", "skills", "project-context", "append-system-prompt",
13
+ "date", "cwd", "date-cwd", "active-model", "pi-docs", "variables",
14
+ ]);
15
+ export function currentSubagentPromptRegistrationCatalog() {
16
+ return {
17
+ macros: getRegisteredMacros().map(registrationEntry),
18
+ slots: getRegisteredSlots().map(registrationEntry),
19
+ };
20
+ }
21
+ export function resolveSubagentHostProfile(loaded, resources) {
22
+ const diagnostics = loaded.diagnostics.map((diagnostic) => ({
23
+ level: diagnostic.level,
24
+ code: "profile.validation",
25
+ path: diagnostic.field ? `profile.${diagnostic.field}` : "profile",
26
+ message: diagnostic.message,
27
+ }));
28
+ const registrations = resources.registrations ?? currentSubagentPromptRegistrationCatalog();
29
+ let promptStack;
30
+ if (loaded.profile.promptStack !== null) {
31
+ const matches = resources.promptStacks.filter((candidate) => candidate.stack.id === loaded.profile.promptStack);
32
+ if (matches.length !== 1) {
33
+ diagnostics.push({
34
+ level: "error",
35
+ code: matches.length === 0 ? "profile.stack-missing" : "profile.stack-ambiguous",
36
+ path: "profile.promptStack",
37
+ message: matches.length === 0
38
+ ? `Unknown prompt stack: ${loaded.profile.promptStack}`
39
+ : `Prompt stack id is ambiguous: ${loaded.profile.promptStack}`,
40
+ });
41
+ }
42
+ else {
43
+ promptStack = matches[0];
44
+ for (const diagnostic of promptStack.diagnostics) {
45
+ diagnostics.push({
46
+ level: diagnostic.level,
47
+ code: "profile.stack-validation",
48
+ path: diagnostic.itemId ? `promptStack.items.${diagnostic.itemId}` : "promptStack",
49
+ message: diagnostic.message,
50
+ });
51
+ }
52
+ if (!promptStack.stack.mode || !["replace", "append", "prepend"].includes(promptStack.stack.mode)) {
53
+ if (promptStack.stack.mode !== undefined)
54
+ diagnostics.push({ level: "error", code: "profile.stack-mode", path: "promptStack.mode", message: `Unsupported prompt stack mode: ${String(promptStack.stack.mode)}` });
55
+ }
56
+ }
57
+ }
58
+ const dependencyResult = promptStack
59
+ ? collectSubagentPromptDependencies(promptStack.stack, registrations)
60
+ : { dependencies: [], missingDependencies: [], diagnostics: [] };
61
+ diagnostics.push(...dependencyResult.diagnostics);
62
+ const resolution = {
63
+ profileId: loaded.profile.id,
64
+ dependencies: dependencyResult.dependencies,
65
+ missingDependencies: dependencyResult.missingDependencies,
66
+ diagnostics,
67
+ };
68
+ if (!diagnostics.some((diagnostic) => diagnostic.level === "error")) {
69
+ resolution.snapshot = {
70
+ schemaVersion: 1,
71
+ profile: structuredClone(loaded.profile),
72
+ promptStack: promptStack ? structuredClone(promptStack.stack) : null,
73
+ dependencies: structuredClone(dependencyResult.dependencies),
74
+ profileFingerprint: subagentSourceProfileFingerprint(loaded.profile),
75
+ promptStackFingerprint: promptStack ? subagentPromptStackFingerprint(promptStack.stack) : null,
76
+ };
77
+ }
78
+ return resolution;
79
+ }
80
+ export function prepareSubagentHostPlan(input) {
81
+ const toolNegotiation = negotiateSubagentTools(input.preflight.toolCatalog, input.snapshot.promptStack?.tools, input.request.access);
82
+ const options = {
83
+ ...structuredClone(input.runtime.options),
84
+ selectedTools: [...toolNegotiation.effectiveToolNames],
85
+ toolSnippets: Object.fromEntries(Object.entries(input.runtime.options.toolSnippets)
86
+ .filter(([name]) => toolNegotiation.effectiveToolNames.includes(name))),
87
+ promptGuidelines: toolNegotiation.effectiveToolNames.length > 0
88
+ ? [...input.runtime.options.promptGuidelines]
89
+ : [],
90
+ skills: structuredClone(input.runtime.options.skills),
91
+ contextFiles: [...input.runtime.options.contextFiles],
92
+ };
93
+ const model = {
94
+ provider: input.runtime.model.provider,
95
+ id: input.runtime.model.id,
96
+ api: "unknown",
97
+ };
98
+ const runtime = {
99
+ options,
100
+ ctx: { model },
101
+ latestUserMessage: input.request.input.text,
102
+ now: new Date(input.runtime.preparedAt),
103
+ variables: createPromptVariableStore(),
104
+ };
105
+ let systemPrompt = input.runtime.baseSystemPrompt;
106
+ let stackMessages = [];
107
+ const diagnostics = [];
108
+ if (input.snapshot.promptStack) {
109
+ const system = compileSystemPrompt(input.snapshot.promptStack, runtime, input.runtime.baseSystemPrompt);
110
+ systemPrompt = system.systemPrompt;
111
+ diagnostics.push(...system.diagnostics.map((item) => promptDiagnostic("system", item)));
112
+ const messages = compileMessages(input.snapshot.promptStack, runtime, []);
113
+ stackMessages = messages.messages.map(preparedPromptStackMessage);
114
+ diagnostics.push(...messages.diagnostics.map((item) => promptDiagnostic("messages", item)));
115
+ }
116
+ const initial = prepareSubagentInitialMessages(input.request, stackMessages);
117
+ return {
118
+ systemPrompt,
119
+ messages: initial.messages,
120
+ contextBudget: initial.contextBudget,
121
+ toolNegotiation,
122
+ diagnostics: [...diagnostics, ...initial.diagnostics],
123
+ };
124
+ }
125
+ export function collectSubagentPromptDependencies(stack, registrations = currentSubagentPromptRegistrationCatalog()) {
126
+ const diagnostics = [];
127
+ const dependencies = new Map();
128
+ const missing = new Map();
129
+ const macroCatalog = new Map(registrations.macros.map((entry) => [entry.name, entry]));
130
+ const slotCatalog = new Map(registrations.slots.map((entry) => [entry.name, entry]));
131
+ const staticVariables = new Set(Object.keys(stack.variables ?? {}));
132
+ for (const item of stack.items) {
133
+ if (item.kind === "slot") {
134
+ if (BUILT_IN_SLOTS.has(item.slot))
135
+ continue;
136
+ addDependency("slot", item.slot, slotCatalog, dependencies, missing, diagnostics, `promptStack.items.${item.id}`);
137
+ continue;
138
+ }
139
+ for (const name of collectMacroCommandNames(item.content)) {
140
+ if (BUILT_IN_MACROS.has(name) || staticVariables.has(name))
141
+ continue;
142
+ addDependency("macro", name, macroCatalog, dependencies, missing, diagnostics, `promptStack.items.${item.id}`);
143
+ }
144
+ }
145
+ return {
146
+ dependencies: [...dependencies.values()].sort(compareDependencies),
147
+ missingDependencies: [...missing.values()].sort(compareDependencies),
148
+ diagnostics,
149
+ };
150
+ }
151
+ export function collectMacroCommandNames(text) {
152
+ const names = new Set();
153
+ collectMacroCommandsInto(text, names);
154
+ return [...names].sort();
155
+ }
156
+ export function appendProtectedAgentTask(compiledMessages, protectedTask) {
157
+ if (protectedTask.role !== "user")
158
+ throw new Error("Protected delegated task must be a user message.");
159
+ return [...structuredClone(compiledMessages), structuredClone(protectedTask)];
160
+ }
161
+ export function compileProtectedAgentTaskMessages(stack, runtime, originalMessages) {
162
+ const taskIndex = findLastUserMessageIndex(originalMessages);
163
+ if (taskIndex === -1)
164
+ throw new Error("Delegated context contains no final user task.");
165
+ const protectedTask = structuredClone(originalMessages[taskIndex]);
166
+ const history = originalMessages.filter((_message, index) => index !== taskIndex);
167
+ const compiled = compileMessages(stack.stack, runtime, history);
168
+ return { messages: appendProtectedAgentTask(compiled.messages, protectedTask), diagnostics: compiled.diagnostics };
169
+ }
170
+ export function isProtectedAgentTaskPreserved(messages, task) {
171
+ if (!messages.length || task.role !== "user")
172
+ return false;
173
+ const finalMessage = messages.at(-1);
174
+ if (finalMessage?.role !== "user")
175
+ return false;
176
+ return normalizeUserContent(finalMessage.content)
177
+ === normalizeUserContent(task.content);
178
+ }
179
+ function registrationEntry(definition) {
180
+ return { name: definition.name, source: definition.source };
181
+ }
182
+ function addDependency(kind, name, catalog, dependencies, missing, diagnostics, path) {
183
+ const key = `${kind}:${name}`;
184
+ const registration = catalog.get(name);
185
+ if (!registration) {
186
+ missing.set(key, { kind, name });
187
+ diagnostics.push({ level: "error", code: "profile.dependency-missing", path, message: `Missing required custom ${kind}: ${name}` });
188
+ return;
189
+ }
190
+ const identity = `${kind}:${registration.source ?? "anonymous"}:${name}`;
191
+ dependencies.set(key, { kind, name, identity, source: registration.source });
192
+ if (!registration.source)
193
+ diagnostics.push({ level: "warning", code: "profile.dependency-anonymous", path, message: `Custom ${kind} ${name} has no stable source identity.` });
194
+ }
195
+ function collectMacroCommandsInto(text, names) {
196
+ let index = 0;
197
+ while (index < text.length) {
198
+ const start = text.indexOf("{{", index);
199
+ if (start === -1)
200
+ return;
201
+ const end = findMacroEnd(text, start + 2);
202
+ if (end === undefined)
203
+ return;
204
+ const expression = text.slice(start + 2, end).trim();
205
+ const parts = splitMacroExpression(expression);
206
+ const command = parts[0]?.trim();
207
+ if (command && /^[A-Za-z][A-Za-z0-9_.-]*$/.test(command))
208
+ names.add(command);
209
+ for (const argument of parts.slice(1))
210
+ collectMacroCommandsInto(argument, names);
211
+ index = end + 2;
212
+ }
213
+ }
214
+ function findMacroEnd(text, start) {
215
+ let depth = 1;
216
+ for (let index = start; index < text.length - 1; index++) {
217
+ const pair = text.slice(index, index + 2);
218
+ if (pair === "{{") {
219
+ depth++;
220
+ index++;
221
+ }
222
+ else if (pair === "}}") {
223
+ depth--;
224
+ if (depth === 0)
225
+ return index;
226
+ index++;
227
+ }
228
+ }
229
+ return undefined;
230
+ }
231
+ function splitMacroExpression(expression) {
232
+ const parts = [];
233
+ let start = 0;
234
+ let depth = 0;
235
+ for (let index = 0; index < expression.length - 1; index++) {
236
+ const pair = expression.slice(index, index + 2);
237
+ if (pair === "{{") {
238
+ depth++;
239
+ index++;
240
+ }
241
+ else if (pair === "}}" && depth > 0) {
242
+ depth--;
243
+ index++;
244
+ }
245
+ else if (pair === "::" && depth === 0) {
246
+ parts.push(expression.slice(start, index));
247
+ start = index + 2;
248
+ index++;
249
+ }
250
+ }
251
+ parts.push(expression.slice(start));
252
+ return parts;
253
+ }
254
+ function findLastUserMessageIndex(messages) {
255
+ for (let index = messages.length - 1; index >= 0; index--) {
256
+ if (messages[index]?.role === "user")
257
+ return index;
258
+ }
259
+ return -1;
260
+ }
261
+ function normalizeUserContent(content) {
262
+ const normalized = typeof content === "string" ? [{ type: "text", text: content }] : Array.isArray(content) ? content : [content];
263
+ return JSON.stringify(normalized);
264
+ }
265
+ function preparedPromptStackMessage(message) {
266
+ if (message.role !== "user" && message.role !== "assistant" && message.role !== "custom") {
267
+ throw new Error(`Unsupported prompt-stack message role for subagent preparation: ${message.role}`);
268
+ }
269
+ const rawContent = message.content;
270
+ const parts = typeof rawContent === "string"
271
+ ? [{ type: "text", text: rawContent }]
272
+ : Array.isArray(rawContent)
273
+ ? rawContent.filter((part) => !!part && typeof part === "object" && part.type === "text" && typeof part.text === "string")
274
+ : [];
275
+ return {
276
+ role: message.role,
277
+ content: parts.length > 0 ? parts : [{ type: "text", text: "" }],
278
+ source: "prompt-stack",
279
+ };
280
+ }
281
+ function promptDiagnostic(stage, diagnostic) {
282
+ return {
283
+ level: diagnostic.level,
284
+ code: `preparation.${stage}`,
285
+ path: diagnostic.itemId ? `promptStack.items.${diagnostic.itemId}` : "promptStack",
286
+ message: diagnostic.message,
287
+ };
288
+ }
289
+ function compareDependencies(left, right) {
290
+ return left.kind.localeCompare(right.kind) || left.name.localeCompare(right.name);
291
+ }
292
+ //# sourceMappingURL=subagent-host.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subagent-host.js","sourceRoot":"","sources":["../src/subagent-host.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,mBAAmB,GAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,kBAAkB,GAElB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EACN,8BAA8B,EAC9B,gCAAgC,EAChC,sBAAsB,EACtB,8BAA8B,GAQ9B,MAAM,wBAAwB,CAAC;AAqBhC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC/B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa;IACjF,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,eAAe;IACvF,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;IACtF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ;CACpC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC9B,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB;IAC/F,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW;CACjE,CAAC,CAAC;AAEH,MAAM,UAAU,wCAAwC;IACvD,OAAO;QACN,MAAM,EAAE,mBAAmB,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACpD,KAAK,EAAE,kBAAkB,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC;KAClD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACzC,MAA0B,EAC1B,SAGC;IAED,MAAM,WAAW,GAAyB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACjF,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,OAAO,EAAE,UAAU,CAAC,OAAO;KACG,CAAA,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,wCAAwC,EAAE,CAAC;IAC5F,IAAI,WAA0C,CAAC;IAC/C,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC;gBAChB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,yBAAyB;gBAChF,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;oBAC5B,CAAC,CAAC,yBAAyB,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE;oBACvD,CAAC,CAAC,iCAAiC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE;aAChE,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;gBAClD,WAAW,CAAC,IAAI,CAAC;oBAChB,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,IAAI,EAAE,0BAA0B;oBAChC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,aAAa;oBAClF,OAAO,EAAE,UAAU,CAAC,OAAO;iBAC3B,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnG,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;oBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,kCAAkC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACnN,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,gBAAgB,GAAG,WAAW;QACnC,CAAC,CAAC,iCAAiC,CAAC,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC;QACrE,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAClE,WAAW,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,UAAU,GAA2B;QAC1C,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;QAC5B,YAAY,EAAE,gBAAgB,CAAC,YAAY;QAC3C,mBAAmB,EAAE,gBAAgB,CAAC,mBAAmB;QACzD,WAAW;KACX,CAAC;IACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,KAAK,OAAO,CAAC,EAAE,CAAC;QACrE,UAAU,CAAC,QAAQ,GAAG;YACrB,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC;YACxC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;YACpE,YAAY,EAAE,eAAe,CAAC,gBAAgB,CAAC,YAAY,CAAC;YAC5D,kBAAkB,EAAE,gCAAgC,CAAC,MAAM,CAAC,OAAO,CAAC;YACpE,sBAAsB,EAAE,WAAW,CAAC,CAAC,CAAC,8BAA8B,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;SAC9F,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAA+B;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrI,MAAM,OAAO,GAA6B;QACzC,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACzC,aAAa,EAAE,CAAC,GAAG,eAAe,CAAC,kBAAkB,CAAC;QACtD,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;aACjF,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,gBAAgB,EAAE,eAAe,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAC9D,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC7C,CAAC,CAAC,EAAE;QACL,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAuC;QAC3F,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;KACrD,CAAC;IACF,MAAM,KAAK,GAAG;QACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ;QACtC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAC1B,GAAG,EAAE,SAAS;KACd,CAAC;IACF,MAAM,OAAO,GAAkB;QAC9B,OAAO;QACP,GAAG,EAAE,EAAE,KAAK,EAAiC;QAC7C,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI;QAC3C,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACvC,SAAS,EAAE,yBAAyB,EAAE;KACtC,CAAC;IACF,IAAI,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAClD,IAAI,aAAa,GAA8B,EAAE,CAAC;IAClD,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxG,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACnC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACxF,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1E,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QAClE,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,OAAO,GAAG,8BAA8B,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC7E,OAAO;QACN,YAAY;QACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,eAAe;QACf,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;KACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAChD,KAAkB,EAClB,gBAAmD,wCAAwC,EAAE;IAM7F,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0D,CAAC;IAClF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IAEpE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5C,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAClH,SAAS;QACV,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YACrE,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAChH,CAAC;IACF,CAAC;IAED,OAAO;QACN,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;QAClE,mBAAmB,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACpE,WAAW;KACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACpD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,wBAAwB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACvC,gBAAyC,EACzC,aAA2B;IAE3B,IAAI,aAAa,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACvG,OAAO,CAAC,GAAG,eAAe,CAAC,gBAAgB,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,iCAAiC,CAChD,KAAwB,EACxB,OAAsB,EACtB,gBAAyC;IAEzC,MAAM,SAAS,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACxF,MAAM,aAAa,GAAG,eAAe,CAAC,gBAAgB,CAAC,SAAS,CAAE,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,EAAE,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAiC,EAAE,IAAkB;IAClG,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,YAAY,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,YAAY,EAAE,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,oBAAoB,CAAE,YAAsC,CAAC,OAAO,CAAC;YACvE,oBAAoB,CAAE,IAA8B,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAwD;IAClF,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,aAAa,CACrB,IAA4B,EAC5B,IAAY,EACZ,OAAgD,EAChD,YAAmD,EACnD,OAAoE,EACpE,WAAiC,EACjC,IAAY;IAEZ,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;QACpI,OAAO;IACR,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,YAAY,CAAC,MAAM,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;IACzE,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,YAAY,CAAC,MAAM;QAAE,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,8BAA8B,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI,IAAI,iCAAiC,EAAE,CAAC,CAAC;AAChL,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY,EAAE,KAAkB;IACjE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO;QACzB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACjC,IAAI,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7E,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjF,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;IACjB,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnB,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;QACT,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9B,KAAK,EAAE,CAAC;QACT,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAkB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnB,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;QACT,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;QACT,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3C,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;YAClB,KAAK,EAAE,CAAC;QACT,CAAC;IACF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAiC;IAClE,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACX,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAgB;IAC7C,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAClI,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAqB;IACxD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,mEAAmE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,UAAU,GAAI,OAAiC,CAAC,OAAO,CAAC;IAC9D,MAAM,KAAK,GAAG,OAAO,UAAU,KAAK,QAAQ;QAC3C,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YAC1B,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAA0C,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,IAA2B,CAAC,IAAI,KAAK,MAAM,IAAI,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC;YAClN,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAChE,MAAM,EAAE,cAAc;KACtB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA4B,EAAE,UAAsD;IAC7G,OAAO;QACN,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,IAAI,EAAE,eAAe,KAAK,EAAE;QAC5B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,aAAa;QAClF,OAAO,EAAE,UAAU,CAAC,OAAO;KAC3B,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC3B,IAAoD,EACpD,KAAqD;IAErD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC"}
@@ -0,0 +1,49 @@
1
+ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
2
+ import { type ForgeSubagentBackendSource, type ResolvedSubagentProfilePolicy } from "./forge-config.ts";
3
+ import { type AgentProfileDiagnostic, type LoadedAgentProfile, type ResolvedAgentProfile } from "./agent-profile.ts";
4
+ export interface ForgeSubagentProfileSummary {
5
+ id: string;
6
+ name?: string;
7
+ description?: string;
8
+ model: {
9
+ provider: string;
10
+ id: string;
11
+ };
12
+ thinkingLevel: string;
13
+ promptStack: string | null;
14
+ backend: {
15
+ id: string;
16
+ source: ForgeSubagentBackendSource;
17
+ };
18
+ timeout: {
19
+ milliseconds: number;
20
+ source: Exclude<ForgeSubagentBackendSource, "explicit">;
21
+ };
22
+ status: "ready" | "unavailable";
23
+ diagnostics: AgentProfileDiagnostic[];
24
+ }
25
+ export interface ForgeSubagentProfilesToolDetails {
26
+ status: "completed" | "disabled";
27
+ invocationToolAvailable: boolean;
28
+ approvalMode: "interactive" | "unattended-config";
29
+ defaultBackend?: {
30
+ id: string;
31
+ source: ForgeSubagentBackendSource;
32
+ };
33
+ timeout: {
34
+ milliseconds: number;
35
+ source: Exclude<ForgeSubagentBackendSource, "explicit">;
36
+ };
37
+ configWarnings: string[];
38
+ profiles: ForgeSubagentProfileSummary[];
39
+ }
40
+ export declare function registerForgeSubagentProfilesTool(pi: ExtensionAPI, profiles: () => readonly LoadedAgentProfile[], resolveProfile: (profile: LoadedAgentProfile, ctx: ExtensionContext) => ResolvedAgentProfile): void;
41
+ export declare function summarizeProfile(loaded: LoadedAgentProfile, resolved: ResolvedAgentProfile, policy: ResolvedSubagentProfilePolicy): ForgeSubagentProfileSummary;
42
+ export declare function renderProfileCatalog(profiles: readonly ForgeSubagentProfileSummary[], invocationToolAvailable: boolean, approvalMode?: "interactive" | "unattended-config", configWarnings?: readonly string[], defaultBackend?: {
43
+ id: string;
44
+ source: ForgeSubagentBackendSource;
45
+ }, timeout?: {
46
+ milliseconds: number;
47
+ source: Exclude<ForgeSubagentBackendSource, "explicit">;
48
+ }): string;
49
+ //# sourceMappingURL=subagent-profile-tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subagent-profile-tool.d.ts","sourceRoot":"","sources":["../src/subagent-profile-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEtF,OAAO,EAKN,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEN,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,2BAA2B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,0BAA0B,CAAA;KAAE,CAAC;IAC5D,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;IAC3F,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC;IAChC,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,gCAAgC;IAChD,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,YAAY,EAAE,aAAa,GAAG,mBAAmB,CAAC;IAClD,cAAc,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,0BAA0B,CAAA;KAAE,CAAC;IACpE,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;IAC3F,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,2BAA2B,EAAE,CAAC;CACxC;AAED,wBAAgB,iCAAiC,CAChD,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,MAAM,SAAS,kBAAkB,EAAE,EAC7C,cAAc,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,gBAAgB,KAAK,oBAAoB,GAC1F,IAAI,CAyCN;AAED,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,6BAA6B,GACnC,2BAA2B,CAa7B;AAED,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,EAChD,uBAAuB,EAAE,OAAO,EAChC,YAAY,GAAE,aAAa,GAAG,mBAAmC,EACjE,cAAc,GAAE,SAAS,MAAM,EAAO,EACtC,cAAc,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,EACnE,OAAO,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAA;CAAE,GACzF,MAAM,CAkCR"}
@@ -0,0 +1,124 @@
1
+ import { Type } from "typebox";
2
+ import { DEFAULT_SUBAGENT_TIMEOUT_MS, loadForgeSubagentSettings, resolveSubagentBackend, resolveSubagentProfilePolicy, } from "./forge-config.js";
3
+ import { isResolvedAgentProfileUsable, } from "./agent-profile.js";
4
+ const MAX_VISIBLE_DESCRIPTION_CHARS = 1_000;
5
+ const ForgeSubagentProfilesParameters = Type.Object({});
6
+ export function registerForgeSubagentProfilesTool(pi, profiles, resolveProfile) {
7
+ pi.registerTool({
8
+ name: "forge_subagent_profiles",
9
+ label: "Forge Subagent Profiles",
10
+ description: [
11
+ "List Pi Forge agent profiles explicitly enabled for subagent delegation, with descriptions, execution settings, and active approval mode.",
12
+ "Use this before forge_subagent when the user has not already specified a profile ID.",
13
+ "This reads only in-memory profile metadata and performs no provider request or subagent prompt preparation.",
14
+ ].join(" "),
15
+ parameters: ForgeSubagentProfilesParameters,
16
+ async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
17
+ if (!ctx.isProjectTrusted()) {
18
+ return result("Subagent profile discovery is disabled because the project is not trusted.", {
19
+ status: "disabled",
20
+ invocationToolAvailable: false,
21
+ approvalMode: "interactive",
22
+ timeout: { milliseconds: DEFAULT_SUBAGENT_TIMEOUT_MS, source: "built-in" },
23
+ configWarnings: [],
24
+ profiles: [],
25
+ });
26
+ }
27
+ const invocationToolAvailable = pi.getActiveTools().includes("forge_subagent");
28
+ const settings = loadForgeSubagentSettings(ctx);
29
+ const approvalMode = settings.allowAgentInvocationWithoutApproval ? "unattended-config" : "interactive";
30
+ const defaultBackend = resolveSubagentBackend(settings);
31
+ const summaries = profiles().flatMap((loaded) => {
32
+ const policy = resolveSubagentProfilePolicy(settings, loaded.profile.id);
33
+ return policy.enabled ? [summarizeProfile(loaded, resolveProfile(loaded, ctx), policy)] : [];
34
+ });
35
+ const timeout = { milliseconds: settings.timeoutMs, source: settings.timeoutSource };
36
+ return result(renderProfileCatalog(summaries, invocationToolAvailable, approvalMode, settings.warnings, defaultBackend, timeout), { status: "completed", invocationToolAvailable, approvalMode, defaultBackend, timeout, configWarnings: settings.warnings, profiles: summaries });
37
+ },
38
+ });
39
+ }
40
+ export function summarizeProfile(loaded, resolved, policy) {
41
+ return {
42
+ id: loaded.profile.id,
43
+ name: loaded.profile.name,
44
+ description: loaded.profile.description,
45
+ model: structuredClone(loaded.profile.model),
46
+ thinkingLevel: loaded.profile.thinkingLevel,
47
+ promptStack: loaded.profile.promptStack,
48
+ backend: structuredClone(policy.backend),
49
+ timeout: structuredClone(policy.timeout),
50
+ status: isResolvedAgentProfileUsable(resolved) ? "ready" : "unavailable",
51
+ diagnostics: structuredClone(resolved.diagnostics),
52
+ };
53
+ }
54
+ export function renderProfileCatalog(profiles, invocationToolAvailable, approvalMode = "interactive", configWarnings = [], defaultBackend, timeout) {
55
+ if (profiles.length === 0) {
56
+ return [
57
+ `No Pi Forge agent profiles are enabled for subagent delegation. Parent invocation tool: ${invocationToolAvailable ? "active" : "inactive"}. Approval mode: ${approvalMode}.`,
58
+ "Enable a profile explicitly with subagents.profiles.<id>.enabled: true.",
59
+ ...(defaultBackend ? [`Default backend: ${defaultBackend.id} (${defaultBackend.source}).`] : []),
60
+ ...(timeout ? [`Timeout: ${timeout.milliseconds} ms (${timeout.source}; best-effort host abort).`] : []),
61
+ ...configWarnings.map((warning) => `Configuration warning: ${warning}`),
62
+ ].join("\n");
63
+ }
64
+ const ready = profiles.filter((profile) => profile.status === "ready");
65
+ const unavailable = profiles.filter((profile) => profile.status === "unavailable");
66
+ const lines = [
67
+ `Pi Forge subagent profiles: ${ready.length} ready, ${unavailable.length} unavailable.`,
68
+ `Parent invocation tool: ${invocationToolAvailable ? "active" : "inactive; the current tool policy must permit forge_subagent before the main agent can invoke a profile"}.`,
69
+ approvalMode === "unattended-config"
70
+ ? "Approval mode: unattended-config; exact backend preflight still runs, but forge_subagent may contact the provider without per-run human approval."
71
+ : "Approval mode: interactive; a ready profile still undergoes exact backend preflight and per-run human approval.",
72
+ ];
73
+ if (defaultBackend)
74
+ lines.push(`Default backend: ${defaultBackend.id} (${defaultBackend.source}); the interactive forge_subagent backend parameter or /forge-agent --backend overrides it per run.`);
75
+ if (timeout)
76
+ lines.push(`Timeout: ${timeout.milliseconds} ms (${timeout.source}; best-effort host abort).`);
77
+ if (configWarnings.length > 0)
78
+ lines.push(...configWarnings.map((warning) => `Configuration warning: ${warning}`));
79
+ if (ready.length > 0) {
80
+ lines.push("", "Ready profiles:");
81
+ for (const profile of ready)
82
+ lines.push(...renderProfile(profile));
83
+ }
84
+ if (unavailable.length > 0) {
85
+ lines.push("", "Unavailable profiles:");
86
+ for (const profile of unavailable)
87
+ lines.push(...renderProfile(profile, true));
88
+ }
89
+ return lines.join("\n");
90
+ }
91
+ function renderProfile(profile, includeErrors = false) {
92
+ const title = `- ${profile.id}${profile.name ? ` — ${compact(profile.name)}` : ""}`;
93
+ const description = profile.description ? truncate(compact(profile.description), MAX_VISIBLE_DESCRIPTION_CHARS) : "(no description provided)";
94
+ const lines = [
95
+ title,
96
+ ` Description: ${description}`,
97
+ ` Model: ${profile.model.provider}/${profile.model.id}; thinking: ${profile.thinkingLevel}; stack: ${profile.promptStack ?? "none"}`,
98
+ ` Execution: backend ${profile.backend.id} (${settingSourceLabel(profile.backend.source)}); timeout ${profile.timeout.milliseconds} ms (${settingSourceLabel(profile.timeout.source)}; best-effort host abort)`,
99
+ ];
100
+ if (includeErrors) {
101
+ const errors = profile.diagnostics.filter((diagnostic) => diagnostic.level === "error");
102
+ lines.push(` Unavailable because: ${errors.map((diagnostic) => diagnostic.message).join("; ") || "profile resolution failed"}`);
103
+ }
104
+ return lines;
105
+ }
106
+ function settingSourceLabel(source) {
107
+ switch (source) {
108
+ case "explicit": return "per-run override";
109
+ case "project-profile": return "project profile override";
110
+ case "project": return "project config";
111
+ case "global": return "global config";
112
+ default: return "built-in";
113
+ }
114
+ }
115
+ function result(text, details) {
116
+ return { content: [{ type: "text", text }], details: structuredClone(details) };
117
+ }
118
+ function compact(value) {
119
+ return value.replace(/\s+/g, " ").trim();
120
+ }
121
+ function truncate(value, maxChars) {
122
+ return value.length <= maxChars ? value : `${value.slice(0, Math.max(0, maxChars - 3))}...`;
123
+ }
124
+ //# sourceMappingURL=subagent-profile-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subagent-profile-tool.js","sourceRoot":"","sources":["../src/subagent-profile-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import { type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
2
+ import type { ForgeSubagentPreparedRun, ForgeSubagentRuntime, SubagentBackendExecutionUpdate } from "./runtime/subagent-runtime.ts";
3
+ import type { AgentResponse, SubagentDiagnostic } from "./subagent/contract.ts";
4
+ import { type PiSubprocessRunReport } from "@zihanw/pi-subagent-runtime/backends/subprocess";
5
+ export interface ForgeSubagentApprovalReceipt {
6
+ required: boolean;
7
+ approved: boolean;
8
+ viewedFullPrompt: boolean;
9
+ source: "none" | "human" | "trusted-project-config";
10
+ executionFingerprint?: string;
11
+ approvedAt?: string;
12
+ }
13
+ export interface ForgeSubagentPlanSummary {
14
+ backendId: string;
15
+ profileId: string;
16
+ promptStackId: string | null;
17
+ provider: string;
18
+ model: string;
19
+ thinkingLevel: string;
20
+ effectiveToolIds: string[];
21
+ executionBoundary: string;
22
+ workingDirectory: string;
23
+ systemPromptChars: number;
24
+ messageCount: number;
25
+ messageRoles: string[];
26
+ timeoutMs?: number;
27
+ timeoutEnforcement?: string;
28
+ promptRuntimeFingerprint: string;
29
+ conversationFingerprint: string;
30
+ executionFingerprint: string;
31
+ }
32
+ export interface ForgeSubagentToolDetails {
33
+ status: "preparing" | "prepared" | "awaiting-approval" | "cancelled" | "running" | "completed" | "failed" | "timed-out";
34
+ profileId: string;
35
+ task: string;
36
+ plan?: ForgeSubagentPlanSummary;
37
+ approval: ForgeSubagentApprovalReceipt;
38
+ diagnostics: SubagentDiagnostic[];
39
+ progress: SubagentBackendExecutionUpdate[];
40
+ response?: AgentResponse;
41
+ report?: PiSubprocessRunReport;
42
+ }
43
+ export interface ForgeSubagentApprovalResult {
44
+ approved: boolean;
45
+ viewedFullPrompt: boolean;
46
+ }
47
+ export declare function registerForgeSubagentTool(pi: ExtensionAPI, runtime: ForgeSubagentRuntime, profileIds: () => string[]): void;
48
+ export declare function requestForgeSubagentApproval(prepared: ForgeSubagentPreparedRun, task: string, ctx: ExtensionContext, signal?: AbortSignal): Promise<ForgeSubagentApprovalResult>;
49
+ export declare function summarizeForgeSubagentPlan(prepared: ForgeSubagentPreparedRun, cwd: string): ForgeSubagentPlanSummary;
50
+ export declare function renderApprovalSummary(prepared: ForgeSubagentPreparedRun, task: string, cwd: string): string;
51
+ export declare function renderApprovalDetails(prepared: ForgeSubagentPreparedRun, task: string, cwd: string): string;
52
+ export declare function renderFullForgeSubagentPrompt(prepared: ForgeSubagentPreparedRun): string;
53
+ //# sourceMappingURL=subagent-tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"subagent-tool.d.ts","sourceRoot":"","sources":["../src/subagent-tool.ts"],"names":[],"mappings":"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"}