@minpeter/pss-runtime 0.1.0-next.2 → 0.1.0-next.3

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 (141) hide show
  1. package/README.md +166 -78
  2. package/dist/agent-host-session-store.js +2 -4
  3. package/dist/agent-host-session-store.js.map +1 -1
  4. package/dist/agent-loop.js +2 -3
  5. package/dist/agent-loop.js.map +1 -1
  6. package/dist/agent-namespace.js +3 -7
  7. package/dist/agent-namespace.js.map +1 -1
  8. package/dist/agent-options.d.ts +2 -8
  9. package/dist/agent-options.js +4 -4
  10. package/dist/agent-options.js.map +1 -1
  11. package/dist/agent-resume.js +2 -82
  12. package/dist/agent-resume.js.map +1 -1
  13. package/dist/agent-session-entry.d.ts +1 -1
  14. package/dist/agent.d.ts +4 -4
  15. package/dist/agent.js +16 -70
  16. package/dist/agent.js.map +1 -1
  17. package/dist/cloudflare/cloudflare-agent-context.d.ts +40 -0
  18. package/dist/cloudflare/cloudflare-agent-context.js +37 -0
  19. package/dist/cloudflare/cloudflare-agent-context.js.map +1 -0
  20. package/dist/cloudflare/cloudflare-alarm-budget.d.ts +18 -0
  21. package/dist/cloudflare/cloudflare-alarm-budget.js +77 -0
  22. package/dist/cloudflare/cloudflare-alarm-budget.js.map +1 -0
  23. package/dist/cloudflare/cloudflare-alarm-drainer.d.ts +45 -0
  24. package/dist/cloudflare/cloudflare-alarm-drainer.js +103 -0
  25. package/dist/cloudflare/cloudflare-alarm-drainer.js.map +1 -0
  26. package/dist/cloudflare/cloudflare-alarm-run-drain.d.ts +13 -0
  27. package/dist/cloudflare/cloudflare-alarm-run-drain.js +81 -0
  28. package/dist/cloudflare/cloudflare-alarm-run-drain.js.map +1 -0
  29. package/dist/cloudflare/cloudflare-alarm-work.js +110 -0
  30. package/dist/cloudflare/cloudflare-alarm-work.js.map +1 -0
  31. package/dist/cloudflare/cloudflare-checkpoint-store.js +39 -0
  32. package/dist/cloudflare/cloudflare-checkpoint-store.js.map +1 -0
  33. package/dist/cloudflare/cloudflare-durable-object-fetch.d.ts +21 -0
  34. package/dist/cloudflare/cloudflare-durable-object-fetch.js +11 -0
  35. package/dist/cloudflare/cloudflare-durable-object-fetch.js.map +1 -0
  36. package/dist/cloudflare/cloudflare-event-store.js +33 -0
  37. package/dist/cloudflare/cloudflare-event-store.js.map +1 -0
  38. package/dist/cloudflare/cloudflare-execution-session-store.js +40 -0
  39. package/dist/cloudflare/cloudflare-execution-session-store.js.map +1 -0
  40. package/dist/cloudflare/cloudflare-execution-store.js +35 -0
  41. package/dist/cloudflare/cloudflare-execution-store.js.map +1 -0
  42. package/dist/cloudflare/cloudflare-host.d.ts +61 -0
  43. package/dist/cloudflare/cloudflare-host.js +113 -0
  44. package/dist/cloudflare/cloudflare-host.js.map +1 -0
  45. package/dist/cloudflare/cloudflare-notification-store.js +59 -0
  46. package/dist/cloudflare/cloudflare-notification-store.js.map +1 -0
  47. package/dist/cloudflare/cloudflare-run-store.js +81 -0
  48. package/dist/cloudflare/cloudflare-run-store.js.map +1 -0
  49. package/dist/cloudflare/cloudflare-store-utils.js +43 -0
  50. package/dist/cloudflare/cloudflare-store-utils.js.map +1 -0
  51. package/dist/cloudflare/durable-object-storage.d.ts +20 -0
  52. package/dist/cloudflare/durable-object-storage.js +76 -0
  53. package/dist/cloudflare/durable-object-storage.js.map +1 -0
  54. package/dist/cloudflare/index.d.ts +7 -0
  55. package/dist/cloudflare/index.js +6 -0
  56. package/dist/execution/capabilities.d.ts +40 -0
  57. package/dist/execution/host.d.ts +9 -0
  58. package/dist/execution/host.js +49 -1
  59. package/dist/execution/host.js.map +1 -1
  60. package/dist/execution/index.d.ts +3 -1
  61. package/dist/execution/index.js +2 -1
  62. package/dist/execution/memory.js +1 -1
  63. package/dist/execution/memory.js.map +1 -1
  64. package/dist/execution/types.d.ts +5 -10
  65. package/dist/index.d.ts +8 -4
  66. package/dist/index.js +6 -1
  67. package/dist/plugins.d.ts +25 -3
  68. package/dist/plugins.js +35 -6
  69. package/dist/plugins.js.map +1 -1
  70. package/dist/session/delegate-input.d.ts +9 -0
  71. package/dist/session/delegate-input.js +16 -0
  72. package/dist/session/delegate-input.js.map +1 -0
  73. package/dist/session/events.d.ts +43 -25
  74. package/dist/session/events.js +41 -0
  75. package/dist/session/events.js.map +1 -0
  76. package/dist/session/input-meta-types.d.ts +10 -0
  77. package/dist/session/input-meta.d.ts +13 -0
  78. package/dist/session/input-meta.js +45 -0
  79. package/dist/session/input-meta.js.map +1 -0
  80. package/dist/session/input.d.ts +4 -0
  81. package/dist/session/mapping.js +4 -2
  82. package/dist/session/mapping.js.map +1 -1
  83. package/dist/session/runtime-input-emit.js +41 -0
  84. package/dist/session/runtime-input-emit.js.map +1 -0
  85. package/dist/session/runtime-input.js +5 -1
  86. package/dist/session/runtime-input.js.map +1 -1
  87. package/dist/session/session-events.js +20 -6
  88. package/dist/session/session-events.js.map +1 -1
  89. package/dist/session/session-notification.js +3 -2
  90. package/dist/session/session-notification.js.map +1 -1
  91. package/dist/session/session-runtime-drain.js +3 -9
  92. package/dist/session/session-runtime-drain.js.map +1 -1
  93. package/dist/session/session-turn-processor.js +7 -17
  94. package/dist/session/session-turn-processor.js.map +1 -1
  95. package/dist/session/session.js +11 -4
  96. package/dist/session/session.js.map +1 -1
  97. package/package.json +6 -1
  98. package/dist/agent-child-runs.js +0 -16
  99. package/dist/agent-child-runs.js.map +0 -1
  100. package/dist/agent-host-capabilities.js +0 -9
  101. package/dist/agent-host-capabilities.js.map +0 -1
  102. package/dist/agent-validation.js +0 -35
  103. package/dist/agent-validation.js.map +0 -1
  104. package/dist/child-session-cleanups.js +0 -61
  105. package/dist/child-session-cleanups.js.map +0 -1
  106. package/dist/execution/run.js +0 -55
  107. package/dist/execution/run.js.map +0 -1
  108. package/dist/subagent-background-child-run-state.js +0 -51
  109. package/dist/subagent-background-child-run-state.js.map +0 -1
  110. package/dist/subagent-background-child-run.js +0 -103
  111. package/dist/subagent-background-child-run.js.map +0 -1
  112. package/dist/subagent-background-in-process.js +0 -98
  113. package/dist/subagent-background-in-process.js.map +0 -1
  114. package/dist/subagent-background-notification-inbox.js +0 -106
  115. package/dist/subagent-background-notification-inbox.js.map +0 -1
  116. package/dist/subagent-background-notify.js +0 -136
  117. package/dist/subagent-background-notify.js.map +0 -1
  118. package/dist/subagent-background-resume-group.js +0 -99
  119. package/dist/subagent-background-resume-group.js.map +0 -1
  120. package/dist/subagent-background-runner.js +0 -115
  121. package/dist/subagent-background-runner.js.map +0 -1
  122. package/dist/subagent-background-schedule.js +0 -43
  123. package/dist/subagent-background-schedule.js.map +0 -1
  124. package/dist/subagent-child-run.js +0 -68
  125. package/dist/subagent-child-run.js.map +0 -1
  126. package/dist/subagent-job-cancel.js +0 -84
  127. package/dist/subagent-job-cancel.js.map +0 -1
  128. package/dist/subagent-job-observer.js +0 -19
  129. package/dist/subagent-job-observer.js.map +0 -1
  130. package/dist/subagent-job-output.js +0 -87
  131. package/dist/subagent-job-output.js.map +0 -1
  132. package/dist/subagent-job-state.js +0 -66
  133. package/dist/subagent-job-state.js.map +0 -1
  134. package/dist/subagent-jobs.js +0 -96
  135. package/dist/subagent-jobs.js.map +0 -1
  136. package/dist/subagent-prompt-schema.js +0 -114
  137. package/dist/subagent-prompt-schema.js.map +0 -1
  138. package/dist/subagent-run.js +0 -111
  139. package/dist/subagent-run.js.map +0 -1
  140. package/dist/subagents.js +0 -125
  141. package/dist/subagents.js.map +0 -1
@@ -1,96 +0,0 @@
1
- import { createBackgroundTaskId, createDurableBackgroundTaskId, getBackgroundChildRun, getOrCreateBackgroundChildRun } from "./subagent-background-child-run.js";
2
- import { backgroundCancelledLaunchOutput, backgroundLaunchOutput, backgroundReplayOutput, backgroundRunJobStatus, hasBackgroundJobCapacity } from "./subagent-job-state.js";
3
- import { startInProcessBackgroundJob } from "./subagent-background-in-process.js";
4
- import { scheduleDurableBackgroundJob } from "./subagent-background-schedule.js";
5
- //#region src/subagent-jobs.ts
6
- const maxBackgroundJobs = 64;
7
- const maxRetainedBackgroundJobs = maxBackgroundJobs * 4;
8
- async function startBackgroundJob({ abortSignal, description, executionHost, jobs, groupId, groups = /* @__PURE__ */ new Map(), delegateToolCallId, parentSession, parentRunId, parentSessionKey, ownerNamespace, prompt, registerCleanup, sessionKey, subagent }) {
9
- const existingChildRun = await getBackgroundChildRun({
10
- delegateToolCallId,
11
- executionHost,
12
- parentRunId,
13
- parentSessionKey,
14
- prompt,
15
- sessionKey
16
- });
17
- const id = existingChildRun?.publicTaskId ?? (executionHost ? await createDurableBackgroundTaskId({
18
- delegateToolCallId,
19
- prompt,
20
- sessionKey
21
- }) : createBackgroundTaskId());
22
- const existingJob = jobs.get(id);
23
- if (existingJob) return backgroundLaunchOutput(existingJob);
24
- const replayedStatus = backgroundRunJobStatus(existingChildRun?.status);
25
- if (existingChildRun?.publicTaskId && replayedStatus) return backgroundReplayOutput({
26
- id: existingChildRun.publicTaskId,
27
- status: replayedStatus,
28
- subagent: subagent.name ?? "subagent"
29
- });
30
- if (!hasBackgroundJobCapacity({
31
- jobs,
32
- maxActiveJobs: maxBackgroundJobs,
33
- maxRetainedJobs: maxRetainedBackgroundJobs
34
- })) return {
35
- message: "Background subagent job was not started because the background job limit is full.",
36
- run_in_background: true,
37
- status: "cancelled",
38
- subagent: subagent.name,
39
- task_id: id
40
- };
41
- if (abortSignal.aborted) return backgroundCancelledLaunchOutput({
42
- id,
43
- subagent: subagent.name
44
- });
45
- const childRun = executionHost ? existingChildRun ?? await getOrCreateBackgroundChildRun({
46
- delegateToolCallId,
47
- description,
48
- executionHost,
49
- groupId,
50
- ownerNamespace,
51
- parentRunId,
52
- parentSessionKey,
53
- prompt,
54
- publicTaskId: id,
55
- sessionKey,
56
- subagent: subagent.name ?? "subagent"
57
- }) : void 0;
58
- if (executionHost?.capabilities.backgroundSubagents === "durable" && childRun) return backgroundLaunchOutput(await scheduleDurableBackgroundJob({
59
- childRun,
60
- delegateToolCallId,
61
- description,
62
- executionHost,
63
- groupId,
64
- groups,
65
- id,
66
- jobs,
67
- parentRunId,
68
- parentSession,
69
- parentSessionKey,
70
- ownerNamespace,
71
- subagent: subagent.name ?? "subagent"
72
- }));
73
- return await startInProcessBackgroundJob({
74
- abortSignal,
75
- childRun,
76
- delegateToolCallId,
77
- description,
78
- executionHost,
79
- groupId,
80
- groups,
81
- id,
82
- jobs,
83
- parentRunId,
84
- parentSession,
85
- parentSessionKey,
86
- ownerNamespace,
87
- prompt,
88
- registerCleanup,
89
- sessionKey,
90
- subagent
91
- });
92
- }
93
- //#endregion
94
- export { startBackgroundJob };
95
-
96
- //# sourceMappingURL=subagent-jobs.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"subagent-jobs.js","names":[],"sources":["../src/subagent-jobs.ts"],"sourcesContent":["import type { ExecutionHost } from \"./execution/types\";\nimport type { AgentInput } from \"./session/input\";\nimport {\n createBackgroundTaskId,\n createDurableBackgroundTaskId,\n getBackgroundChildRun,\n getOrCreateBackgroundChildRun,\n} from \"./subagent-background-child-run\";\nimport { startInProcessBackgroundJob } from \"./subagent-background-in-process\";\nimport { scheduleDurableBackgroundJob } from \"./subagent-background-schedule\";\nimport {\n backgroundCancelledLaunchOutput,\n backgroundLaunchOutput,\n backgroundReplayOutput,\n backgroundRunJobStatus,\n hasBackgroundJobCapacity,\n} from \"./subagent-job-state\";\nimport type {\n RuntimeInputSink,\n Subagent,\n SubagentJob,\n SubagentJobGroup,\n} from \"./subagent-types\";\n\nconst maxBackgroundJobs = 64;\nconst maxRetainedBackgroundJobs = maxBackgroundJobs * 4;\n\nexport async function startBackgroundJob({\n abortSignal,\n description,\n executionHost,\n jobs,\n groupId,\n groups = new Map<string, SubagentJobGroup>(),\n delegateToolCallId,\n parentSession,\n parentRunId,\n parentSessionKey,\n ownerNamespace,\n prompt,\n registerCleanup,\n sessionKey,\n subagent,\n}: {\n readonly abortSignal: AbortSignal;\n readonly description?: string;\n readonly executionHost?: ExecutionHost;\n readonly jobs: Map<string, SubagentJob>;\n readonly groupId?: string;\n readonly groups?: Map<string, SubagentJobGroup>;\n readonly delegateToolCallId?: string;\n readonly parentSession: RuntimeInputSink;\n readonly parentRunId?: string;\n readonly parentSessionKey?: string;\n readonly ownerNamespace?: string;\n readonly prompt: AgentInput;\n readonly registerCleanup: (cleanup: () => Promise<void>) => () => void;\n readonly sessionKey: string;\n readonly subagent: Subagent;\n}) {\n const existingChildRun = await getBackgroundChildRun({\n delegateToolCallId,\n executionHost,\n parentRunId,\n parentSessionKey,\n prompt,\n sessionKey,\n });\n const id =\n existingChildRun?.publicTaskId ??\n (executionHost\n ? await createDurableBackgroundTaskId({\n delegateToolCallId,\n prompt,\n sessionKey,\n })\n : createBackgroundTaskId());\n const existingJob = jobs.get(id);\n if (existingJob) {\n return backgroundLaunchOutput(existingJob);\n }\n const replayedStatus = backgroundRunJobStatus(existingChildRun?.status);\n if (existingChildRun?.publicTaskId && replayedStatus) {\n return backgroundReplayOutput({\n id: existingChildRun.publicTaskId,\n status: replayedStatus,\n subagent: subagent.name ?? \"subagent\",\n });\n }\n\n if (\n !hasBackgroundJobCapacity({\n jobs,\n maxActiveJobs: maxBackgroundJobs,\n maxRetainedJobs: maxRetainedBackgroundJobs,\n })\n ) {\n return {\n message:\n \"Background subagent job was not started because the background job limit is full.\",\n run_in_background: true,\n status: \"cancelled\",\n subagent: subagent.name,\n task_id: id,\n };\n }\n\n if (abortSignal.aborted) {\n return backgroundCancelledLaunchOutput({ id, subagent: subagent.name });\n }\n\n const childRun = executionHost\n ? (existingChildRun ??\n (await getOrCreateBackgroundChildRun({\n delegateToolCallId,\n description,\n executionHost,\n groupId,\n ownerNamespace,\n parentRunId,\n parentSessionKey,\n prompt,\n publicTaskId: id,\n sessionKey,\n subagent: subagent.name ?? \"subagent\",\n })))\n : undefined;\n if (\n executionHost?.capabilities.backgroundSubagents === \"durable\" &&\n childRun\n ) {\n const job = await scheduleDurableBackgroundJob({\n childRun,\n delegateToolCallId,\n description,\n executionHost,\n groupId,\n groups,\n id,\n jobs,\n parentRunId,\n parentSession,\n parentSessionKey,\n ownerNamespace,\n subagent: subagent.name ?? \"subagent\",\n });\n return backgroundLaunchOutput(job);\n }\n return await startInProcessBackgroundJob({\n abortSignal,\n childRun,\n delegateToolCallId,\n description,\n executionHost,\n groupId,\n groups,\n id,\n jobs,\n parentRunId,\n parentSession,\n parentSessionKey,\n ownerNamespace,\n prompt,\n registerCleanup,\n sessionKey,\n subagent,\n });\n}\n"],"mappings":";;;;;AAwBA,MAAM,oBAAoB;AAC1B,MAAM,4BAA4B,oBAAoB;AAEtD,eAAsB,mBAAmB,EACvC,aACA,aACA,eACA,MACA,SACA,yBAAS,IAAI,IAA8B,GAC3C,oBACA,eACA,aACA,kBACA,gBACA,QACA,iBACA,YACA,YAiBC;CACD,MAAM,mBAAmB,MAAM,sBAAsB;EACnD;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,MAAM,KACJ,kBAAkB,iBACjB,gBACG,MAAM,8BAA8B;EAClC;EACA;EACA;CACF,CAAC,IACD,uBAAuB;CAC7B,MAAM,cAAc,KAAK,IAAI,EAAE;CAC/B,IAAI,aACF,OAAO,uBAAuB,WAAW;CAE3C,MAAM,iBAAiB,uBAAuB,kBAAkB,MAAM;CACtE,IAAI,kBAAkB,gBAAgB,gBACpC,OAAO,uBAAuB;EAC5B,IAAI,iBAAiB;EACrB,QAAQ;EACR,UAAU,SAAS,QAAQ;CAC7B,CAAC;CAGH,IACE,CAAC,yBAAyB;EACxB;EACA,eAAe;EACf,iBAAiB;CACnB,CAAC,GAED,OAAO;EACL,SACE;EACF,mBAAmB;EACnB,QAAQ;EACR,UAAU,SAAS;EACnB,SAAS;CACX;CAGF,IAAI,YAAY,SACd,OAAO,gCAAgC;EAAE;EAAI,UAAU,SAAS;CAAK,CAAC;CAGxE,MAAM,WAAW,gBACZ,oBACA,MAAM,8BAA8B;EACnC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,cAAc;EACd;EACA,UAAU,SAAS,QAAQ;CAC7B,CAAC,IACD,KAAA;CACJ,IACE,eAAe,aAAa,wBAAwB,aACpD,UAiBA,OAAO,uBAAuB,MAfZ,6BAA6B;EAC7C;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU,SAAS,QAAQ;CAC7B,CAAC,CACgC;CAEnC,OAAO,MAAM,4BAA4B;EACvC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;AACH"}
@@ -1,114 +0,0 @@
1
- //#region src/subagent-prompt-schema.ts
2
- const contentArraySchema = {
3
- items: { anyOf: [
4
- {
5
- additionalProperties: false,
6
- properties: {
7
- text: { type: "string" },
8
- type: { const: "text" }
9
- },
10
- required: ["type", "text"],
11
- type: "object"
12
- },
13
- {
14
- additionalProperties: false,
15
- properties: {
16
- image: { type: "string" },
17
- mediaType: { type: "string" },
18
- type: { const: "image" }
19
- },
20
- required: ["type", "image"],
21
- type: "object"
22
- },
23
- {
24
- additionalProperties: false,
25
- properties: {
26
- data: { anyOf: [
27
- { type: "string" },
28
- {
29
- additionalProperties: false,
30
- properties: {
31
- data: { type: "string" },
32
- type: { const: "data" }
33
- },
34
- required: ["type", "data"],
35
- type: "object"
36
- },
37
- {
38
- additionalProperties: false,
39
- properties: {
40
- reference: {
41
- additionalProperties: { type: "string" },
42
- type: "object"
43
- },
44
- type: { const: "reference" }
45
- },
46
- required: ["type", "reference"],
47
- type: "object"
48
- },
49
- {
50
- additionalProperties: false,
51
- properties: {
52
- text: { type: "string" },
53
- type: { const: "text" }
54
- },
55
- required: ["type", "text"],
56
- type: "object"
57
- },
58
- {
59
- additionalProperties: false,
60
- properties: {
61
- type: { const: "url" },
62
- url: { type: "string" }
63
- },
64
- required: ["type", "url"],
65
- type: "object"
66
- }
67
- ] },
68
- filename: { type: "string" },
69
- mediaType: { type: "string" },
70
- type: { const: "file" }
71
- },
72
- required: [
73
- "type",
74
- "data",
75
- "mediaType"
76
- ],
77
- type: "object"
78
- }
79
- ] },
80
- type: "array"
81
- };
82
- const delegatePromptSchema = { anyOf: [
83
- { type: "string" },
84
- {
85
- items: { type: "string" },
86
- type: "array"
87
- },
88
- {
89
- additionalProperties: false,
90
- properties: {
91
- text: { anyOf: [{ type: "string" }, {
92
- items: { type: "string" },
93
- type: "array"
94
- }] },
95
- type: { const: "user-text" }
96
- },
97
- required: ["type", "text"],
98
- type: "object"
99
- },
100
- {
101
- additionalProperties: false,
102
- properties: {
103
- content: contentArraySchema,
104
- type: { const: "user-message" }
105
- },
106
- required: ["type", "content"],
107
- type: "object"
108
- },
109
- contentArraySchema
110
- ] };
111
- //#endregion
112
- export { delegatePromptSchema };
113
-
114
- //# sourceMappingURL=subagent-prompt-schema.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"subagent-prompt-schema.js","names":[],"sources":["../src/subagent-prompt-schema.ts"],"sourcesContent":["const fileDataSchema = {\n anyOf: [\n { type: \"string\" },\n {\n additionalProperties: false,\n properties: {\n data: { type: \"string\" },\n type: { const: \"data\" },\n },\n required: [\"type\", \"data\"],\n type: \"object\",\n },\n {\n additionalProperties: false,\n properties: {\n reference: {\n additionalProperties: { type: \"string\" },\n type: \"object\",\n },\n type: { const: \"reference\" },\n },\n required: [\"type\", \"reference\"],\n type: \"object\",\n },\n {\n additionalProperties: false,\n properties: {\n text: { type: \"string\" },\n type: { const: \"text\" },\n },\n required: [\"type\", \"text\"],\n type: \"object\",\n },\n {\n additionalProperties: false,\n properties: {\n type: { const: \"url\" },\n url: { type: \"string\" },\n },\n required: [\"type\", \"url\"],\n type: \"object\",\n },\n ],\n};\n\nconst contentPartSchema = {\n anyOf: [\n {\n additionalProperties: false,\n properties: {\n text: { type: \"string\" },\n type: { const: \"text\" },\n },\n required: [\"type\", \"text\"],\n type: \"object\",\n },\n {\n additionalProperties: false,\n properties: {\n image: { type: \"string\" },\n mediaType: { type: \"string\" },\n type: { const: \"image\" },\n },\n required: [\"type\", \"image\"],\n type: \"object\",\n },\n {\n additionalProperties: false,\n properties: {\n data: fileDataSchema,\n filename: { type: \"string\" },\n mediaType: { type: \"string\" },\n type: { const: \"file\" },\n },\n required: [\"type\", \"data\", \"mediaType\"],\n type: \"object\",\n },\n ],\n};\n\nconst contentArraySchema = {\n items: contentPartSchema,\n type: \"array\",\n};\n\nexport const delegatePromptSchema = {\n anyOf: [\n { type: \"string\" },\n { items: { type: \"string\" }, type: \"array\" },\n {\n additionalProperties: false,\n properties: {\n text: {\n anyOf: [\n { type: \"string\" },\n { items: { type: \"string\" }, type: \"array\" },\n ],\n },\n type: { const: \"user-text\" },\n },\n required: [\"type\", \"text\"],\n type: \"object\",\n },\n {\n additionalProperties: false,\n properties: {\n content: contentArraySchema,\n type: { const: \"user-message\" },\n },\n required: [\"type\", \"content\"],\n type: \"object\",\n },\n contentArraySchema,\n ],\n};\n"],"mappings":";AAgFA,MAAM,qBAAqB;CACzB,OAAO,EAnCP,OAAO;EACL;GACE,sBAAsB;GACtB,YAAY;IACV,MAAM,EAAE,MAAM,SAAS;IACvB,MAAM,EAAE,OAAO,OAAO;GACxB;GACA,UAAU,CAAC,QAAQ,MAAM;GACzB,MAAM;EACR;EACA;GACE,sBAAsB;GACtB,YAAY;IACV,OAAO,EAAE,MAAM,SAAS;IACxB,WAAW,EAAE,MAAM,SAAS;IAC5B,MAAM,EAAE,OAAO,QAAQ;GACzB;GACA,UAAU,CAAC,QAAQ,OAAO;GAC1B,MAAM;EACR;EACA;GACE,sBAAsB;GACtB,YAAY;IACV,MAAM,EApEZ,OAAO;KACL,EAAE,MAAM,SAAS;KACjB;MACE,sBAAsB;MACtB,YAAY;OACV,MAAM,EAAE,MAAM,SAAS;OACvB,MAAM,EAAE,OAAO,OAAO;MACxB;MACA,UAAU,CAAC,QAAQ,MAAM;MACzB,MAAM;KACR;KACA;MACE,sBAAsB;MACtB,YAAY;OACV,WAAW;QACT,sBAAsB,EAAE,MAAM,SAAS;QACvC,MAAM;OACR;OACA,MAAM,EAAE,OAAO,YAAY;MAC7B;MACA,UAAU,CAAC,QAAQ,WAAW;MAC9B,MAAM;KACR;KACA;MACE,sBAAsB;MACtB,YAAY;OACV,MAAM,EAAE,MAAM,SAAS;OACvB,MAAM,EAAE,OAAO,OAAO;MACxB;MACA,UAAU,CAAC,QAAQ,MAAM;MACzB,MAAM;KACR;KACA;MACE,sBAAsB;MACtB,YAAY;OACV,MAAM,EAAE,OAAO,MAAM;OACrB,KAAK,EAAE,MAAM,SAAS;MACxB;MACA,UAAU,CAAC,QAAQ,KAAK;MACxB,MAAM;KACR;IACF,EA2ByB;IACnB,UAAU,EAAE,MAAM,SAAS;IAC3B,WAAW,EAAE,MAAM,SAAS;IAC5B,MAAM,EAAE,OAAO,OAAO;GACxB;GACA,UAAU;IAAC;IAAQ;IAAQ;GAAW;GACtC,MAAM;EACR;CACF,EAIuB;CACvB,MAAM;AACR;AAEA,MAAa,uBAAuB,EAClC,OAAO;CACL,EAAE,MAAM,SAAS;CACjB;EAAE,OAAO,EAAE,MAAM,SAAS;EAAG,MAAM;CAAQ;CAC3C;EACE,sBAAsB;EACtB,YAAY;GACV,MAAM,EACJ,OAAO,CACL,EAAE,MAAM,SAAS,GACjB;IAAE,OAAO,EAAE,MAAM,SAAS;IAAG,MAAM;GAAQ,CAC7C,EACF;GACA,MAAM,EAAE,OAAO,YAAY;EAC7B;EACA,UAAU,CAAC,QAAQ,MAAM;EACzB,MAAM;CACR;CACA;EACE,sBAAsB;EACtB,YAAY;GACV,SAAS;GACT,MAAM,EAAE,OAAO,eAAe;EAChC;EACA,UAAU,CAAC,QAAQ,SAAS;EAC5B,MAAM;CACR;CACA;AACF,EACF"}
@@ -1,111 +0,0 @@
1
- //#region src/subagent-run.ts
2
- const maxCompactTextLength = 2e4;
3
- const maxStoredEvents = 200;
4
- const childSessionKeySuffixPattern = /^[A-Za-z0-9_-]{1,80}$/;
5
- async function runBlockingDelegation({ abortSignal, prompt, sessionKey, subagent }) {
6
- const childSession = subagent.session(sessionKey);
7
- if (abortSignal?.aborted) return {
8
- eventCount: 0,
9
- result: "aborted",
10
- run_in_background: false,
11
- subagent: subagent.name ?? "subagent",
12
- text: ""
13
- };
14
- const abort = () => childSession.interrupt();
15
- abortSignal?.addEventListener("abort", abort, { once: true });
16
- try {
17
- return await collectSubagentRun(await childSession.send(prompt), subagent.name ?? "subagent");
18
- } finally {
19
- abortSignal?.removeEventListener("abort", abort);
20
- }
21
- }
22
- async function collectSubagentRun(run, subagent) {
23
- return (await collectSubagentRunWithEvents(run, subagent)).result;
24
- }
25
- async function collectSubagentRunWithEvents(run, subagent, onEvent) {
26
- let eventCount = 0;
27
- let result = "completed";
28
- const events = [];
29
- const textParts = [];
30
- let textLength = 0;
31
- let textTruncated = false;
32
- try {
33
- for await (const event of run.events()) {
34
- eventCount += 1;
35
- if (events.length < maxStoredEvents) events.push(event);
36
- await onEvent?.(event);
37
- if (event.type === "assistant-text") {
38
- const appended = appendCompactText(textParts, textLength, event.text);
39
- textLength = appended.length;
40
- textTruncated ||= appended.truncated;
41
- } else if (event.type === "turn-abort") result = "aborted";
42
- else if (event.type === "turn-error") return {
43
- retainedEvents: events,
44
- result: {
45
- error: event.message,
46
- eventCount,
47
- result: "error",
48
- run_in_background: false,
49
- subagent,
50
- text: compactText(textParts, textTruncated)
51
- }
52
- };
53
- }
54
- } catch (error) {
55
- return {
56
- retainedEvents: events,
57
- result: {
58
- error: errorMessage(error),
59
- eventCount,
60
- result: "error",
61
- run_in_background: false,
62
- subagent,
63
- text: compactText(textParts, textTruncated)
64
- }
65
- };
66
- }
67
- return {
68
- retainedEvents: events,
69
- result: {
70
- eventCount,
71
- result,
72
- run_in_background: false,
73
- subagent,
74
- text: compactText(textParts, textTruncated)
75
- }
76
- };
77
- }
78
- function defaultChildSessionKey(parentAgentNamespace, parentSessionKey, subagent) {
79
- return `parent:${parentAgentNamespace}:${parentSessionKey}:subagent:${subagent}`;
80
- }
81
- function scopedChildSessionKey({ parentAgentNamespace, parentSessionKey, sessionKey, subagent }) {
82
- const base = defaultChildSessionKey(parentAgentNamespace, parentSessionKey, subagent);
83
- if (!sessionKey) return base;
84
- if (!childSessionKeySuffixPattern.test(sessionKey)) throw new Error("delegate sessionKey must be a short alphanumeric child-session suffix");
85
- return `${base}:${sessionKey}`;
86
- }
87
- function compactText(parts, truncated) {
88
- const text = parts.join("");
89
- return truncated ? `${text}…[truncated]` : text;
90
- }
91
- function appendCompactText(parts, currentLength, next) {
92
- if (currentLength >= maxCompactTextLength) return {
93
- length: currentLength,
94
- truncated: next.length > 0
95
- };
96
- const remaining = maxCompactTextLength - currentLength;
97
- const chunk = next.length > remaining ? next.slice(0, remaining) : next;
98
- parts.push(chunk);
99
- return {
100
- length: currentLength + chunk.length,
101
- truncated: next.length > remaining
102
- };
103
- }
104
- function errorMessage(error) {
105
- if (error instanceof Error) return error.message;
106
- return String(error);
107
- }
108
- //#endregion
109
- export { collectSubagentRunWithEvents, runBlockingDelegation, scopedChildSessionKey };
110
-
111
- //# sourceMappingURL=subagent-run.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"subagent-run.js","names":[],"sources":["../src/subagent-run.ts"],"sourcesContent":["import type { AgentEvent } from \"./session/events\";\nimport type { AgentInput } from \"./session/input\";\nimport type { AgentRun } from \"./session/run\";\nimport type {\n CompactSubagentResult,\n Subagent,\n SubagentRunResult,\n} from \"./subagent-types\";\n\nconst maxCompactTextLength = 20_000;\nconst maxStoredEvents = 200;\nconst childSessionKeySuffixPattern = /^[A-Za-z0-9_-]{1,80}$/;\n\nexport async function runBlockingDelegation({\n abortSignal,\n prompt,\n sessionKey,\n subagent,\n}: {\n readonly abortSignal?: AbortSignal;\n readonly prompt: AgentInput;\n readonly sessionKey: string;\n readonly subagent: Subagent;\n}): Promise<CompactSubagentResult> {\n const childSession = subagent.session(sessionKey);\n if (abortSignal?.aborted) {\n return {\n eventCount: 0,\n result: \"aborted\",\n run_in_background: false,\n subagent: subagent.name ?? \"subagent\",\n text: \"\",\n };\n }\n\n const abort = () => childSession.interrupt();\n abortSignal?.addEventListener(\"abort\", abort, { once: true });\n try {\n return await collectSubagentRun(\n await childSession.send(prompt),\n subagent.name ?? \"subagent\"\n );\n } finally {\n abortSignal?.removeEventListener(\"abort\", abort);\n }\n}\n\nexport async function collectSubagentRun(\n run: AgentRun,\n subagent: string\n): Promise<CompactSubagentResult> {\n return (await collectSubagentRunWithEvents(run, subagent)).result;\n}\n\nexport async function collectSubagentRunWithEvents(\n run: AgentRun,\n subagent: string,\n onEvent?: (event: AgentEvent) => Promise<void> | void\n): Promise<SubagentRunResult> {\n let eventCount = 0;\n let result: CompactSubagentResult[\"result\"] = \"completed\";\n const events: AgentEvent[] = [];\n const textParts: string[] = [];\n let textLength = 0;\n let textTruncated = false;\n\n try {\n for await (const event of run.events()) {\n eventCount += 1;\n if (events.length < maxStoredEvents) {\n events.push(event);\n }\n await onEvent?.(event);\n if (event.type === \"assistant-text\") {\n const appended = appendCompactText(textParts, textLength, event.text);\n textLength = appended.length;\n textTruncated ||= appended.truncated;\n } else if (event.type === \"turn-abort\") {\n result = \"aborted\";\n } else if (event.type === \"turn-error\") {\n return {\n retainedEvents: events,\n result: {\n error: event.message,\n eventCount,\n result: \"error\",\n run_in_background: false,\n subagent,\n text: compactText(textParts, textTruncated),\n },\n };\n }\n }\n } catch (error) {\n return {\n retainedEvents: events,\n result: {\n error: errorMessage(error),\n eventCount,\n result: \"error\",\n run_in_background: false,\n subagent,\n text: compactText(textParts, textTruncated),\n },\n };\n }\n\n return {\n retainedEvents: events,\n result: {\n eventCount,\n result,\n run_in_background: false,\n subagent,\n text: compactText(textParts, textTruncated),\n },\n };\n}\n\nexport function defaultChildSessionKey(\n parentAgentNamespace: string,\n parentSessionKey: string,\n subagent: string\n): string {\n return `parent:${parentAgentNamespace}:${parentSessionKey}:subagent:${subagent}`;\n}\n\nexport function scopedChildSessionKey({\n parentAgentNamespace,\n parentSessionKey,\n sessionKey,\n subagent,\n}: {\n readonly parentAgentNamespace: string;\n readonly parentSessionKey: string;\n readonly sessionKey?: string;\n readonly subagent: string;\n}): string {\n const base = defaultChildSessionKey(\n parentAgentNamespace,\n parentSessionKey,\n subagent\n );\n if (!sessionKey) {\n return base;\n }\n\n if (!childSessionKeySuffixPattern.test(sessionKey)) {\n throw new Error(\n \"delegate sessionKey must be a short alphanumeric child-session suffix\"\n );\n }\n\n return `${base}:${sessionKey}`;\n}\n\nfunction compactText(parts: readonly string[], truncated: boolean): string {\n const text = parts.join(\"\");\n return truncated ? `${text}…[truncated]` : text;\n}\n\nfunction appendCompactText(\n parts: string[],\n currentLength: number,\n next: string\n): { readonly length: number; readonly truncated: boolean } {\n if (currentLength >= maxCompactTextLength) {\n return { length: currentLength, truncated: next.length > 0 };\n }\n\n const remaining = maxCompactTextLength - currentLength;\n const chunk = next.length > remaining ? next.slice(0, remaining) : next;\n parts.push(chunk);\n return {\n length: currentLength + chunk.length,\n truncated: next.length > remaining,\n };\n}\n\nfunction errorMessage(error: unknown): string {\n if (error instanceof Error) {\n return error.message;\n }\n\n return String(error);\n}\n"],"mappings":"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"}
package/dist/subagents.js DELETED
@@ -1,125 +0,0 @@
1
- import { scopedChildSessionKey } from "./subagent-run.js";
2
- import { normalizeAgentInput } from "./session/input-normalization.js";
3
- import { blockingSubagentDedupeKey, runBlockingChild } from "./subagent-child-run.js";
4
- import { createBackgroundCancelTool } from "./subagent-job-cancel.js";
5
- import { createBackgroundOutputTool } from "./subagent-job-output.js";
6
- import { startBackgroundJob } from "./subagent-jobs.js";
7
- import { delegatePromptSchema } from "./subagent-prompt-schema.js";
8
- import { jsonSchema, tool } from "ai";
9
- //#region src/subagents.ts
10
- function createSubagentTools({ backgroundSubagents, executionHost, parentAgentNamespace, parentSession, parentSessionKey, registerChildSession, subagents }) {
11
- if (subagents.length === 0) return {};
12
- const jobs = /* @__PURE__ */ new Map();
13
- const groups = /* @__PURE__ */ new Map();
14
- const blockingRuns = /* @__PURE__ */ new Map();
15
- const backgroundToolScope = { childSessionKeyPrefix: `parent:${parentAgentNamespace}:${parentSessionKey}:subagent:` };
16
- const generatedTools = backgroundSubagents ? {
17
- background_cancel: createBackgroundCancelTool(jobs, executionHost, backgroundToolScope),
18
- background_output: createBackgroundOutputTool(jobs, executionHost, backgroundToolScope)
19
- } : {};
20
- for (const subagent of subagents) {
21
- const name = subagent.name;
22
- if (!name) continue;
23
- generatedTools[`delegate_to_${name.replaceAll("-", "_")}`] = createDelegateTool({
24
- jobs,
25
- groups,
26
- backgroundSubagents,
27
- blockingRuns,
28
- executionHost,
29
- parentAgentNamespace,
30
- parentSession,
31
- parentSessionKey,
32
- registerChildSession,
33
- subagent
34
- });
35
- }
36
- return generatedTools;
37
- }
38
- function createDelegateTool({ jobs, groups, backgroundSubagents, blockingRuns, executionHost, parentAgentNamespace, parentSession, parentSessionKey, registerChildSession, subagent }) {
39
- return tool({
40
- description: `Delegate work to ${subagent.name}: ${subagent.description}`,
41
- execute: async (input, { abortSignal, toolCallId }) => {
42
- const prompt = normalizeAgentInput(input.prompt);
43
- const sessionKey = scopedChildSessionKey({
44
- parentAgentNamespace,
45
- parentSessionKey,
46
- sessionKey: input.sessionKey,
47
- subagent: subagent.name ?? "subagent"
48
- });
49
- if (input.run_in_background === true) {
50
- if (!backgroundSubagents) throw new Error("Background subagent delegation is not available for this host.");
51
- return await startBackgroundJob({
52
- abortSignal: abortSignal ?? new AbortController().signal,
53
- description: input.description,
54
- executionHost,
55
- groupId: parentSession.currentBackgroundGroupId?.(),
56
- groups,
57
- jobs,
58
- delegateToolCallId: toolCallId,
59
- parentSession,
60
- parentRunId: parentSession.currentRunId?.() ?? parentAgentNamespace,
61
- parentSessionKey,
62
- ownerNamespace: parentAgentNamespace,
63
- prompt,
64
- registerCleanup: (cleanup) => registerChildSession(parentSessionKey, cleanup),
65
- sessionKey,
66
- subagent
67
- });
68
- }
69
- registerChildSession(parentSessionKey, () => subagent.session(sessionKey).delete());
70
- await parentSession.emitObserverEvent({
71
- description: input.description,
72
- delegateToolCallId: toolCallId,
73
- run_in_background: false,
74
- subagent: subagent.name ?? "subagent",
75
- type: "subagent-job-start"
76
- });
77
- const dedupeKey = blockingSubagentDedupeKey(parentAgentNamespace, toolCallId);
78
- const result = blockingRuns.get(dedupeKey) ?? runBlockingChild({
79
- abortSignal,
80
- dedupeKey,
81
- executionHost,
82
- parentRunId: parentSession.currentRunId?.() ?? parentAgentNamespace,
83
- prompt,
84
- sessionKey,
85
- subagent
86
- });
87
- blockingRuns.set(dedupeKey, result);
88
- const awaitedResult = await result;
89
- await parentSession.emitObserverEvent({
90
- error: awaitedResult.error,
91
- eventCount: awaitedResult.eventCount,
92
- delegateToolCallId: toolCallId,
93
- status: awaitedResult.result,
94
- subagent: subagent.name ?? "subagent",
95
- type: "subagent-job-end"
96
- });
97
- return awaitedResult;
98
- },
99
- inputSchema: jsonSchema({
100
- additionalProperties: false,
101
- properties: createDelegateToolProperties(backgroundSubagents),
102
- required: ["prompt"],
103
- type: "object"
104
- })
105
- });
106
- }
107
- function createDelegateToolProperties(backgroundSubagents) {
108
- const baseProperties = {
109
- description: { type: "string" },
110
- prompt: delegatePromptSchema,
111
- sessionKey: { type: "string" }
112
- };
113
- if (!backgroundSubagents) return baseProperties;
114
- return {
115
- ...baseProperties,
116
- run_in_background: {
117
- default: false,
118
- type: "boolean"
119
- }
120
- };
121
- }
122
- //#endregion
123
- export { createSubagentTools };
124
-
125
- //# sourceMappingURL=subagents.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"subagents.js","names":[],"sources":["../src/subagents.ts"],"sourcesContent":["import { jsonSchema, type ToolSet, tool } from \"ai\";\nimport type { ExecutionHost } from \"./execution/types\";\nimport { normalizeAgentInput } from \"./session/input-normalization\";\nimport {\n type BlockingSubagentRunCache,\n blockingSubagentDedupeKey,\n runBlockingChild,\n} from \"./subagent-child-run\";\nimport { createBackgroundCancelTool } from \"./subagent-job-cancel\";\nimport { createBackgroundOutputTool } from \"./subagent-job-output\";\nimport { startBackgroundJob } from \"./subagent-jobs\";\nimport { delegatePromptSchema } from \"./subagent-prompt-schema\";\nimport { scopedChildSessionKey } from \"./subagent-run\";\nimport type {\n CreateSubagentToolsOptions,\n DelegateInput,\n RuntimeInputSink,\n Subagent,\n SubagentJob,\n SubagentJobGroup,\n} from \"./subagent-types\";\n\nexport function createSubagentTools({\n backgroundSubagents,\n executionHost,\n parentAgentNamespace,\n parentSession,\n parentSessionKey,\n registerChildSession,\n subagents,\n}: CreateSubagentToolsOptions): ToolSet {\n if (subagents.length === 0) {\n return {};\n }\n\n const jobs = new Map<string, SubagentJob>();\n const groups = new Map<string, SubagentJobGroup>();\n const blockingRuns: BlockingSubagentRunCache = new Map();\n const backgroundToolScope = {\n childSessionKeyPrefix: `parent:${parentAgentNamespace}:${parentSessionKey}:subagent:`,\n };\n const generatedTools: Record<string, unknown> = backgroundSubagents\n ? {\n background_cancel: createBackgroundCancelTool(\n jobs,\n executionHost,\n backgroundToolScope\n ),\n background_output: createBackgroundOutputTool(\n jobs,\n executionHost,\n backgroundToolScope\n ),\n }\n : {};\n\n for (const subagent of subagents) {\n const name = subagent.name;\n if (!name) {\n continue;\n }\n\n generatedTools[`delegate_to_${name.replaceAll(\"-\", \"_\")}`] =\n createDelegateTool({\n jobs,\n groups,\n backgroundSubagents,\n blockingRuns,\n executionHost,\n parentAgentNamespace,\n parentSession,\n parentSessionKey,\n registerChildSession,\n subagent,\n });\n }\n\n return generatedTools as ToolSet;\n}\n\nfunction createDelegateTool({\n jobs,\n groups,\n backgroundSubagents,\n blockingRuns,\n executionHost,\n parentAgentNamespace,\n parentSession,\n parentSessionKey,\n registerChildSession,\n subagent,\n}: {\n readonly jobs: Map<string, SubagentJob>;\n readonly groups: Map<string, SubagentJobGroup>;\n readonly backgroundSubagents: boolean;\n readonly blockingRuns: BlockingSubagentRunCache;\n readonly executionHost?: ExecutionHost;\n readonly parentAgentNamespace: string;\n readonly parentSession: RuntimeInputSink;\n readonly parentSessionKey: string;\n readonly registerChildSession: CreateSubagentToolsOptions[\"registerChildSession\"];\n readonly subagent: Subagent;\n}) {\n return tool<DelegateInput, unknown, Record<string, unknown>>({\n description: `Delegate work to ${subagent.name}: ${subagent.description}`,\n execute: async (input: DelegateInput, { abortSignal, toolCallId }) => {\n const prompt = normalizeAgentInput(input.prompt);\n const sessionKey = scopedChildSessionKey({\n parentAgentNamespace,\n parentSessionKey,\n sessionKey: input.sessionKey,\n subagent: subagent.name ?? \"subagent\",\n });\n if (input.run_in_background === true) {\n if (!backgroundSubagents) {\n throw new Error(\n \"Background subagent delegation is not available for this host.\"\n );\n }\n\n return await startBackgroundJob({\n abortSignal: abortSignal ?? new AbortController().signal,\n description: input.description,\n executionHost,\n groupId: parentSession.currentBackgroundGroupId?.(),\n groups,\n jobs,\n delegateToolCallId: toolCallId,\n parentSession,\n parentRunId: parentSession.currentRunId?.() ?? parentAgentNamespace,\n parentSessionKey,\n ownerNamespace: parentAgentNamespace,\n prompt,\n registerCleanup: (cleanup) =>\n registerChildSession(parentSessionKey, cleanup),\n sessionKey,\n subagent,\n });\n }\n\n registerChildSession(parentSessionKey, () =>\n subagent.session(sessionKey).delete()\n );\n await parentSession.emitObserverEvent({\n description: input.description,\n delegateToolCallId: toolCallId,\n run_in_background: false,\n subagent: subagent.name ?? \"subagent\",\n type: \"subagent-job-start\",\n });\n const dedupeKey = blockingSubagentDedupeKey(\n parentAgentNamespace,\n toolCallId\n );\n const existing = blockingRuns.get(dedupeKey);\n const result =\n existing ??\n runBlockingChild({\n abortSignal,\n dedupeKey,\n executionHost,\n parentRunId: parentSession.currentRunId?.() ?? parentAgentNamespace,\n prompt,\n sessionKey,\n subagent,\n });\n blockingRuns.set(dedupeKey, result);\n const awaitedResult = await result;\n await parentSession.emitObserverEvent({\n error: awaitedResult.error,\n eventCount: awaitedResult.eventCount,\n delegateToolCallId: toolCallId,\n status: awaitedResult.result,\n subagent: subagent.name ?? \"subagent\",\n type: \"subagent-job-end\",\n });\n return awaitedResult;\n },\n inputSchema: jsonSchema<DelegateInput>({\n additionalProperties: false,\n properties: createDelegateToolProperties(backgroundSubagents),\n required: [\"prompt\"],\n type: \"object\",\n }),\n });\n}\n\nfunction createDelegateToolProperties(backgroundSubagents: boolean) {\n const baseProperties = {\n description: { type: \"string\" },\n prompt: delegatePromptSchema,\n sessionKey: { type: \"string\" },\n };\n\n if (!backgroundSubagents) {\n return baseProperties;\n }\n\n return {\n ...baseProperties,\n run_in_background: { default: false, type: \"boolean\" },\n };\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,oBAAoB,EAClC,qBACA,eACA,sBACA,eACA,kBACA,sBACA,aACsC;CACtC,IAAI,UAAU,WAAW,GACvB,OAAO,CAAC;CAGV,MAAM,uBAAO,IAAI,IAAyB;CAC1C,MAAM,yBAAS,IAAI,IAA8B;CACjD,MAAM,+BAAyC,IAAI,IAAI;CACvD,MAAM,sBAAsB,EAC1B,uBAAuB,UAAU,qBAAqB,GAAG,iBAAiB,YAC5E;CACA,MAAM,iBAA0C,sBAC5C;EACE,mBAAmB,2BACjB,MACA,eACA,mBACF;EACA,mBAAmB,2BACjB,MACA,eACA,mBACF;CACF,IACA,CAAC;CAEL,KAAK,MAAM,YAAY,WAAW;EAChC,MAAM,OAAO,SAAS;EACtB,IAAI,CAAC,MACH;EAGF,eAAe,eAAe,KAAK,WAAW,KAAK,GAAG,OACpD,mBAAmB;GACjB;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC;CACL;CAEA,OAAO;AACT;AAEA,SAAS,mBAAmB,EAC1B,MACA,QACA,qBACA,cACA,eACA,sBACA,eACA,kBACA,sBACA,YAYC;CACD,OAAO,KAAsD;EAC3D,aAAa,oBAAoB,SAAS,KAAK,IAAI,SAAS;EAC5D,SAAS,OAAO,OAAsB,EAAE,aAAa,iBAAiB;GACpE,MAAM,SAAS,oBAAoB,MAAM,MAAM;GAC/C,MAAM,aAAa,sBAAsB;IACvC;IACA;IACA,YAAY,MAAM;IAClB,UAAU,SAAS,QAAQ;GAC7B,CAAC;GACD,IAAI,MAAM,sBAAsB,MAAM;IACpC,IAAI,CAAC,qBACH,MAAM,IAAI,MACR,gEACF;IAGF,OAAO,MAAM,mBAAmB;KAC9B,aAAa,eAAe,IAAI,gBAAgB,EAAE;KAClD,aAAa,MAAM;KACnB;KACA,SAAS,cAAc,2BAA2B;KAClD;KACA;KACA,oBAAoB;KACpB;KACA,aAAa,cAAc,eAAe,KAAK;KAC/C;KACA,gBAAgB;KAChB;KACA,kBAAkB,YAChB,qBAAqB,kBAAkB,OAAO;KAChD;KACA;IACF,CAAC;GACH;GAEA,qBAAqB,wBACnB,SAAS,QAAQ,UAAU,EAAE,OAAO,CACtC;GACA,MAAM,cAAc,kBAAkB;IACpC,aAAa,MAAM;IACnB,oBAAoB;IACpB,mBAAmB;IACnB,UAAU,SAAS,QAAQ;IAC3B,MAAM;GACR,CAAC;GACD,MAAM,YAAY,0BAChB,sBACA,UACF;GAEA,MAAM,SADW,aAAa,IAAI,SAEzB,KACP,iBAAiB;IACf;IACA;IACA;IACA,aAAa,cAAc,eAAe,KAAK;IAC/C;IACA;IACA;GACF,CAAC;GACH,aAAa,IAAI,WAAW,MAAM;GAClC,MAAM,gBAAgB,MAAM;GAC5B,MAAM,cAAc,kBAAkB;IACpC,OAAO,cAAc;IACrB,YAAY,cAAc;IAC1B,oBAAoB;IACpB,QAAQ,cAAc;IACtB,UAAU,SAAS,QAAQ;IAC3B,MAAM;GACR,CAAC;GACD,OAAO;EACT;EACA,aAAa,WAA0B;GACrC,sBAAsB;GACtB,YAAY,6BAA6B,mBAAmB;GAC5D,UAAU,CAAC,QAAQ;GACnB,MAAM;EACR,CAAC;CACH,CAAC;AACH;AAEA,SAAS,6BAA6B,qBAA8B;CAClE,MAAM,iBAAiB;EACrB,aAAa,EAAE,MAAM,SAAS;EAC9B,QAAQ;EACR,YAAY,EAAE,MAAM,SAAS;CAC/B;CAEA,IAAI,CAAC,qBACH,OAAO;CAGT,OAAO;EACL,GAAG;EACH,mBAAmB;GAAE,SAAS;GAAO,MAAM;EAAU;CACvD;AACF"}