@zhivex-ai/core 1.18.0 → 1.20.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 (266) hide show
  1. package/README.md +4 -0
  2. package/dist/agent/approvals.d.ts +7 -0
  3. package/dist/agent/approvals.d.ts.map +1 -0
  4. package/dist/agent/approvals.js +97 -0
  5. package/dist/agent/approvals.js.map +1 -0
  6. package/dist/agent/cancellation.d.ts +4 -0
  7. package/dist/agent/cancellation.d.ts.map +1 -0
  8. package/dist/agent/cancellation.js +69 -0
  9. package/dist/agent/cancellation.js.map +1 -0
  10. package/dist/agent/common.d.ts +20 -0
  11. package/dist/agent/common.d.ts.map +1 -0
  12. package/dist/agent/common.js +150 -0
  13. package/dist/agent/common.js.map +1 -0
  14. package/dist/agent/compaction.d.ts +6 -0
  15. package/dist/agent/compaction.d.ts.map +1 -0
  16. package/dist/agent/compaction.js +156 -0
  17. package/dist/agent/compaction.js.map +1 -0
  18. package/dist/agent/context.d.ts +58 -0
  19. package/dist/agent/context.d.ts.map +1 -0
  20. package/dist/agent/context.js +267 -0
  21. package/dist/agent/context.js.map +1 -0
  22. package/dist/agent/definition.d.ts +4 -0
  23. package/dist/agent/definition.d.ts.map +1 -0
  24. package/dist/agent/definition.js +35 -0
  25. package/dist/agent/definition.js.map +1 -0
  26. package/dist/agent/execution.d.ts +14 -0
  27. package/dist/agent/execution.d.ts.map +1 -0
  28. package/dist/agent/execution.js +1062 -0
  29. package/dist/agent/execution.js.map +1 -0
  30. package/dist/agent/groups.d.ts +3 -0
  31. package/dist/agent/groups.d.ts.map +1 -0
  32. package/dist/agent/groups.js +130 -0
  33. package/dist/agent/groups.js.map +1 -0
  34. package/dist/agent/guardrails.d.ts +4 -0
  35. package/dist/agent/guardrails.d.ts.map +1 -0
  36. package/dist/agent/guardrails.js +29 -0
  37. package/dist/agent/guardrails.js.map +1 -0
  38. package/dist/agent/instance.d.ts +42 -0
  39. package/dist/agent/instance.d.ts.map +1 -0
  40. package/dist/agent/instance.js +82 -0
  41. package/dist/agent/instance.js.map +1 -0
  42. package/dist/agent/lifecycle.d.ts +31 -0
  43. package/dist/agent/lifecycle.d.ts.map +1 -0
  44. package/dist/agent/lifecycle.js +184 -0
  45. package/dist/agent/lifecycle.js.map +1 -0
  46. package/dist/agent/state.d.ts +6 -0
  47. package/dist/agent/state.d.ts.map +1 -0
  48. package/dist/agent/state.js +119 -0
  49. package/dist/agent/state.js.map +1 -0
  50. package/dist/agent/telemetry.d.ts +12 -0
  51. package/dist/agent/telemetry.d.ts.map +1 -0
  52. package/dist/agent/telemetry.js +176 -0
  53. package/dist/agent/telemetry.js.map +1 -0
  54. package/dist/agent/tool-execution.d.ts +6 -0
  55. package/dist/agent/tool-execution.d.ts.map +1 -0
  56. package/dist/agent/tool-execution.js +176 -0
  57. package/dist/agent/tool-execution.js.map +1 -0
  58. package/dist/agent-run-view.d.ts +9 -0
  59. package/dist/agent-run-view.d.ts.map +1 -0
  60. package/dist/agent-run-view.js +42 -0
  61. package/dist/agent-run-view.js.map +1 -0
  62. package/dist/agent-store/file.d.ts +11 -0
  63. package/dist/agent-store/file.d.ts.map +1 -0
  64. package/dist/agent-store/file.js +534 -0
  65. package/dist/agent-store/file.js.map +1 -0
  66. package/dist/agent-store/memory.d.ts +9 -0
  67. package/dist/agent-store/memory.d.ts.map +1 -0
  68. package/dist/agent-store/memory.js +198 -0
  69. package/dist/agent-store/memory.js.map +1 -0
  70. package/dist/agent-store/postgres.d.ts +4 -0
  71. package/dist/agent-store/postgres.d.ts.map +1 -0
  72. package/dist/agent-store/postgres.js +374 -0
  73. package/dist/agent-store/postgres.js.map +1 -0
  74. package/dist/agent-store/shared.d.ts +19 -0
  75. package/dist/agent-store/shared.d.ts.map +1 -0
  76. package/dist/agent-store/shared.js +137 -0
  77. package/dist/agent-store/shared.js.map +1 -0
  78. package/dist/agent-store/sqlite.d.ts +4 -0
  79. package/dist/agent-store/sqlite.d.ts.map +1 -0
  80. package/dist/agent-store/sqlite.js +362 -0
  81. package/dist/agent-store/sqlite.js.map +1 -0
  82. package/dist/agent-store.d.ts +5 -21
  83. package/dist/agent-store.d.ts.map +1 -1
  84. package/dist/agent-store.js +5 -1588
  85. package/dist/agent-store.js.map +1 -1
  86. package/dist/agent.d.ts +6 -57
  87. package/dist/agent.d.ts.map +1 -1
  88. package/dist/agent.js +6 -2631
  89. package/dist/agent.js.map +1 -1
  90. package/dist/agents-entry.d.ts +19 -0
  91. package/dist/agents-entry.d.ts.map +1 -0
  92. package/dist/agents-entry.js +14 -0
  93. package/dist/agents-entry.js.map +1 -0
  94. package/dist/api-stability.d.ts.map +1 -1
  95. package/dist/api-stability.js +1 -0
  96. package/dist/api-stability.js.map +1 -1
  97. package/dist/artifact/file.d.ts +6 -0
  98. package/dist/artifact/file.d.ts.map +1 -0
  99. package/dist/artifact/file.js +380 -0
  100. package/dist/artifact/file.js.map +1 -0
  101. package/dist/artifact/memory.d.ts +3 -0
  102. package/dist/artifact/memory.d.ts.map +1 -0
  103. package/dist/artifact/memory.js +80 -0
  104. package/dist/artifact/memory.js.map +1 -0
  105. package/dist/artifact/postgres.d.ts +3 -0
  106. package/dist/artifact/postgres.d.ts.map +1 -0
  107. package/dist/artifact/postgres.js +283 -0
  108. package/dist/artifact/postgres.js.map +1 -0
  109. package/dist/artifact/shared.d.ts +208 -0
  110. package/dist/artifact/shared.d.ts.map +1 -0
  111. package/dist/artifact/shared.js +523 -0
  112. package/dist/artifact/shared.js.map +1 -0
  113. package/dist/artifact/sqlite.d.ts +3 -0
  114. package/dist/artifact/sqlite.d.ts.map +1 -0
  115. package/dist/artifact/sqlite.js +283 -0
  116. package/dist/artifact/sqlite.js.map +1 -0
  117. package/dist/artifact.d.ts +6 -186
  118. package/dist/artifact.d.ts.map +1 -1
  119. package/dist/artifact.js +6 -1536
  120. package/dist/artifact.js.map +1 -1
  121. package/dist/catalog-contracts.d.ts +52 -0
  122. package/dist/catalog-contracts.d.ts.map +1 -0
  123. package/dist/catalog-contracts.js +250 -0
  124. package/dist/catalog-contracts.js.map +1 -0
  125. package/dist/catalog.d.ts +3 -52
  126. package/dist/catalog.d.ts.map +1 -1
  127. package/dist/catalog.js +3 -249
  128. package/dist/catalog.js.map +1 -1
  129. package/dist/generate-cache-file.d.ts +11 -0
  130. package/dist/generate-cache-file.d.ts.map +1 -0
  131. package/dist/generate-cache-file.js +124 -0
  132. package/dist/generate-cache-file.js.map +1 -0
  133. package/dist/generate-text.d.ts +2 -5
  134. package/dist/generate-text.d.ts.map +1 -1
  135. package/dist/generate-text.js +6 -18
  136. package/dist/generate-text.js.map +1 -1
  137. package/dist/generation-entry.d.ts +6 -0
  138. package/dist/generation-entry.d.ts.map +1 -0
  139. package/dist/generation-entry.js +6 -0
  140. package/dist/generation-entry.js.map +1 -0
  141. package/dist/image-input.d.ts +4 -0
  142. package/dist/image-input.d.ts.map +1 -0
  143. package/dist/image-input.js +26 -0
  144. package/dist/image-input.js.map +1 -0
  145. package/dist/index.d.ts +1 -0
  146. package/dist/index.d.ts.map +1 -1
  147. package/dist/index.js +1 -0
  148. package/dist/index.js.map +1 -1
  149. package/dist/middleware-runtime.d.ts +35 -0
  150. package/dist/middleware-runtime.d.ts.map +1 -0
  151. package/dist/middleware-runtime.js +532 -0
  152. package/dist/middleware-runtime.js.map +1 -0
  153. package/dist/middleware.d.ts +3 -43
  154. package/dist/middleware.d.ts.map +1 -1
  155. package/dist/middleware.js +3 -653
  156. package/dist/middleware.js.map +1 -1
  157. package/dist/normalize-messages.d.ts +3 -0
  158. package/dist/normalize-messages.d.ts.map +1 -0
  159. package/dist/normalize-messages.js +16 -0
  160. package/dist/normalize-messages.js.map +1 -0
  161. package/dist/provider-entry.d.ts +18 -0
  162. package/dist/provider-entry.d.ts.map +1 -0
  163. package/dist/provider-entry.js +14 -0
  164. package/dist/provider-entry.js.map +1 -0
  165. package/dist/realtime.d.ts +2 -0
  166. package/dist/realtime.d.ts.map +1 -1
  167. package/dist/realtime.js +6 -0
  168. package/dist/realtime.js.map +1 -1
  169. package/dist/store-key.d.ts +3 -0
  170. package/dist/store-key.d.ts.map +1 -0
  171. package/dist/store-key.js +5 -0
  172. package/dist/store-key.js.map +1 -0
  173. package/dist/store-security.d.ts +1 -2
  174. package/dist/store-security.d.ts.map +1 -1
  175. package/dist/store-security.js +2 -4
  176. package/dist/store-security.js.map +1 -1
  177. package/dist/types/agent-state.d.ts +236 -0
  178. package/dist/types/agent-state.d.ts.map +1 -0
  179. package/dist/types/agent-state.js +2 -0
  180. package/dist/types/agent-state.js.map +1 -0
  181. package/dist/types/agents.d.ts +429 -0
  182. package/dist/types/agents.d.ts.map +1 -0
  183. package/dist/types/agents.js +2 -0
  184. package/dist/types/agents.js.map +1 -0
  185. package/dist/types/common.d.ts +179 -0
  186. package/dist/types/common.d.ts.map +1 -0
  187. package/dist/types/common.js +2 -0
  188. package/dist/types/common.js.map +1 -0
  189. package/dist/types/generation.d.ts +109 -0
  190. package/dist/types/generation.d.ts.map +1 -0
  191. package/dist/types/generation.js +2 -0
  192. package/dist/types/generation.js.map +1 -0
  193. package/dist/types/media-data.d.ts +65 -0
  194. package/dist/types/media-data.d.ts.map +1 -0
  195. package/dist/types/media-data.js +2 -0
  196. package/dist/types/media-data.js.map +1 -0
  197. package/dist/types/media.d.ts +141 -0
  198. package/dist/types/media.d.ts.map +1 -0
  199. package/dist/types/media.js +2 -0
  200. package/dist/types/media.js.map +1 -0
  201. package/dist/types/messages.d.ts +84 -0
  202. package/dist/types/messages.d.ts.map +1 -0
  203. package/dist/types/messages.js +2 -0
  204. package/dist/types/messages.js.map +1 -0
  205. package/dist/types/middleware.d.ts +130 -0
  206. package/dist/types/middleware.d.ts.map +1 -0
  207. package/dist/types/middleware.js +2 -0
  208. package/dist/types/middleware.js.map +1 -0
  209. package/dist/types/model-tools.d.ts +409 -0
  210. package/dist/types/model-tools.d.ts.map +1 -0
  211. package/dist/types/model-tools.js +2 -0
  212. package/dist/types/model-tools.js.map +1 -0
  213. package/dist/types/persistence.d.ts +168 -0
  214. package/dist/types/persistence.d.ts.map +1 -0
  215. package/dist/types/persistence.js +2 -0
  216. package/dist/types/persistence.js.map +1 -0
  217. package/dist/types/provider-resources.d.ts +336 -0
  218. package/dist/types/provider-resources.d.ts.map +1 -0
  219. package/dist/types/provider-resources.js +2 -0
  220. package/dist/types/provider-resources.js.map +1 -0
  221. package/dist/types/provider.d.ts +23 -0
  222. package/dist/types/provider.d.ts.map +1 -0
  223. package/dist/types/provider.js +2 -0
  224. package/dist/types/provider.js.map +1 -0
  225. package/dist/types/resource-options.d.ts +88 -0
  226. package/dist/types/resource-options.d.ts.map +1 -0
  227. package/dist/types/resource-options.js +2 -0
  228. package/dist/types/resource-options.js.map +1 -0
  229. package/dist/types/stream.d.ts +70 -0
  230. package/dist/types/stream.d.ts.map +1 -0
  231. package/dist/types/stream.js +2 -0
  232. package/dist/types/stream.js.map +1 -0
  233. package/dist/types/ui.d.ts +110 -0
  234. package/dist/types/ui.d.ts.map +1 -0
  235. package/dist/types/ui.js +2 -0
  236. package/dist/types/ui.js.map +1 -0
  237. package/dist/types.d.ts +16 -2480
  238. package/dist/types.d.ts.map +1 -1
  239. package/dist/ui.d.ts.map +1 -1
  240. package/dist/ui.js +2 -0
  241. package/dist/ui.js.map +1 -1
  242. package/dist/workflow-state-service/file.d.ts +5 -0
  243. package/dist/workflow-state-service/file.d.ts.map +1 -0
  244. package/dist/workflow-state-service/file.js +142 -0
  245. package/dist/workflow-state-service/file.js.map +1 -0
  246. package/dist/workflow-state-service/memory.d.ts +3 -0
  247. package/dist/workflow-state-service/memory.d.ts.map +1 -0
  248. package/dist/workflow-state-service/memory.js +27 -0
  249. package/dist/workflow-state-service/memory.js.map +1 -0
  250. package/dist/workflow-state-service/postgres.d.ts +4 -0
  251. package/dist/workflow-state-service/postgres.d.ts.map +1 -0
  252. package/dist/workflow-state-service/postgres.js +179 -0
  253. package/dist/workflow-state-service/postgres.js.map +1 -0
  254. package/dist/workflow-state-service/shared.d.ts +43 -0
  255. package/dist/workflow-state-service/shared.d.ts.map +1 -0
  256. package/dist/workflow-state-service/shared.js +107 -0
  257. package/dist/workflow-state-service/shared.js.map +1 -0
  258. package/dist/workflow-state-service/sqlite.d.ts +4 -0
  259. package/dist/workflow-state-service/sqlite.d.ts.map +1 -0
  260. package/dist/workflow-state-service/sqlite.js +183 -0
  261. package/dist/workflow-state-service/sqlite.js.map +1 -0
  262. package/dist/workflow-state-service.d.ts +6 -33
  263. package/dist/workflow-state-service.d.ts.map +1 -1
  264. package/dist/workflow-state-service.js +6 -626
  265. package/dist/workflow-state-service.js.map +1 -1
  266. package/package.json +17 -1
@@ -0,0 +1,58 @@
1
+ import type { AgentDefinition, AgentExecutionEnvironmentBinding, AgentRunInput, AgentRunState, AgentRunStore, JsonValue, LanguageModel, ModelMessage } from "../types.js";
2
+ export declare const ensureValidIdempotencyInput: (input: AgentRunInput, store: AgentRunStore | undefined) => void;
3
+ export declare const ensureValidScope: (scope: AgentRunInput["scope"]) => void;
4
+ export declare const resolveContext: <TModel extends LanguageModel, TContext, TOutput>(agent: AgentDefinition<TModel, TContext, TOutput>, input: AgentRunInput<TModel, TContext>) => Promise<{
5
+ state: AgentRunState;
6
+ messages: ModelMessage[];
7
+ remainingSteps: number;
8
+ memoryMessages: ModelMessage[];
9
+ context: TContext | undefined;
10
+ executionEnvironment: import("../types.js").AgentExecutionEnvironment<TContext> | undefined;
11
+ fresh: boolean;
12
+ } | {
13
+ state: {
14
+ taskOutcome?: import("../types.js").AgentTaskOutcome;
15
+ reconciliations?: import("../types.js").AgentToolReconciliationRecord[];
16
+ revision?: number;
17
+ runId: string;
18
+ harness?: import("../types.js").AgentHarnessBinding;
19
+ executionEnvironment?: AgentExecutionEnvironmentBinding;
20
+ status: import("../types.js").AgentStatus;
21
+ steps: import("../types.js").AgentStep[];
22
+ toolResults: import("../types.js").ToolExecutionResult[];
23
+ currentStep: number;
24
+ outputText: string;
25
+ finalOutput?: JsonValue;
26
+ outputMode?: Exclude<import("../types.js").StructuredOutputMode, "auto">;
27
+ finishReason?: import("../types.js").FinishReason;
28
+ providerFinishReason?: string;
29
+ usage?: import("../types.js").TokenUsage;
30
+ childRuns?: import("../types.js").AgentChildRun[];
31
+ compactions?: import("../types.js").AgentCompactionRecord[];
32
+ handoff?: import("../types.js").AgentHandoff;
33
+ startedAt?: number;
34
+ cancelledAt?: number;
35
+ cancellationReason?: string;
36
+ error?: import("../types.js").AgentRunError;
37
+ schemaVersion: 1;
38
+ idempotencyKey: string | undefined;
39
+ scope: import("../types.js").AgentStoreScope | undefined;
40
+ agentId: string | undefined;
41
+ parentRunId: string | undefined;
42
+ provider: string;
43
+ modelId: string;
44
+ maxSteps: number;
45
+ messages: ModelMessage[];
46
+ pendingApprovals: import("../types.js").AgentApprovalRequest[];
47
+ approvalHistory: import("../types.js").AgentApprovalResolution[];
48
+ metadata: any;
49
+ updatedAt: number;
50
+ };
51
+ messages: ModelMessage[];
52
+ remainingSteps: number;
53
+ memoryMessages: ModelMessage[];
54
+ context: TContext | undefined;
55
+ executionEnvironment: import("../types.js").AgentExecutionEnvironment<TContext> | undefined;
56
+ fresh: boolean;
57
+ }>;
58
+ //# sourceMappingURL=context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,eAAe,EACf,gCAAgC,EAChC,aAAa,EACb,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AAyFrB,eAAO,MAAM,2BAA2B,UAAW,aAAa,SAAS,aAAa,GAAG,SAAS,SAYjG,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,aAAa,CAAC,OAAO,CAAC,SAU7D,CAAC;AA6HF,eAAO,MAAM,cAAc,GACzB,MAAM,SAAS,aAAa,EAC5B,QAAQ,EACR,OAAO,SAEA,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,SAC1C,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA+GZ,YAAY,EAAE;;;;EAmCzC,CAAC"}
@@ -0,0 +1,267 @@
1
+ import { createAgentHandoffMessage } from "../agent-handoff-contracts.js";
2
+ import { createAgentExecutionEnvironmentBinding } from "../agent-harness.js";
3
+ import { AGENT_RUN_STATE_SCHEMA_VERSION, normalizeAgentRunState } from "../agent-state.js";
4
+ import { ConflictError, ValidationError } from "../errors.js";
5
+ import { normalizeMessages } from "../generate-text.js";
6
+ import { cloneMetadata, joinInstructions, promptedOutputInstruction, randomId, resolveAgentOutputMode } from "./common.js";
7
+ import { invokeOperationalHook } from "./telemetry.js";
8
+ import { applyApprovalResponses } from "./approvals.js";
9
+ const createBaseState = (provider, modelId, initialMessages, maxSteps, metadata, agentId, runId, handoff, parentRunId, idempotencyKey, scope, outputMode, harness, executionEnvironment) => {
10
+ const startedAt = Date.now();
11
+ return {
12
+ schemaVersion: AGENT_RUN_STATE_SCHEMA_VERSION,
13
+ revision: 0,
14
+ runId,
15
+ scope,
16
+ idempotencyKey,
17
+ agentId,
18
+ parentRunId: parentRunId ?? handoff?.fromRunId,
19
+ provider,
20
+ modelId,
21
+ harness,
22
+ executionEnvironment,
23
+ status: "running",
24
+ messages: initialMessages,
25
+ steps: [],
26
+ toolResults: [],
27
+ currentStep: 0,
28
+ maxSteps,
29
+ outputText: "",
30
+ outputMode,
31
+ pendingApprovals: [],
32
+ approvalHistory: [],
33
+ compactions: [],
34
+ metadata,
35
+ handoff,
36
+ startedAt,
37
+ updatedAt: startedAt
38
+ };
39
+ };
40
+ const ensureValidStateInput = (input) => {
41
+ if (input.approvals?.length && !input.state) {
42
+ throw new ValidationError('The "approvals" option requires an existing agent "state".');
43
+ }
44
+ if (!input.state) {
45
+ return;
46
+ }
47
+ if (input.prompt !== undefined || input.messages !== undefined || input.system !== undefined || input.handoff !== undefined) {
48
+ throw new ValidationError('Pass either "state" or a fresh "prompt"/"messages" input, but not both.');
49
+ }
50
+ const stateScope = input.state?.scope;
51
+ const inputScope = input.scope;
52
+ if (stateScope &&
53
+ inputScope &&
54
+ (stateScope.tenantId !== inputScope.tenantId ||
55
+ stateScope.userId !== inputScope.userId ||
56
+ stateScope.namespace !== inputScope.namespace)) {
57
+ throw new ValidationError('The provided agent state belongs to a different tenant/user scope.');
58
+ }
59
+ };
60
+ export const ensureValidIdempotencyInput = (input, store) => {
61
+ if (!input.idempotencyKey) {
62
+ return;
63
+ }
64
+ if (!store) {
65
+ throw new ValidationError('The "idempotencyKey" option requires an agent run "store".');
66
+ }
67
+ if (!store.claimIdempotencyKey) {
68
+ throw new ValidationError('The agent run "store" must implement "claimIdempotencyKey()" to use "idempotencyKey" safely.');
69
+ }
70
+ };
71
+ export const ensureValidScope = (scope) => {
72
+ if (!scope)
73
+ return;
74
+ if (typeof scope.tenantId !== "string" || scope.tenantId.length === 0) {
75
+ throw new ValidationError('Agent scope "tenantId" must be a non-empty string.');
76
+ }
77
+ for (const field of ["userId", "namespace"]) {
78
+ if (scope[field] !== undefined && (typeof scope[field] !== "string" || scope[field].length === 0)) {
79
+ throw new ValidationError(`Agent scope "${field}" must be a non-empty string when provided.`);
80
+ }
81
+ }
82
+ };
83
+ const injectContextMessages = (messages, extraMessages) => {
84
+ if (!extraMessages.length) {
85
+ return messages;
86
+ }
87
+ if (messages[0]?.role === "system") {
88
+ return [messages[0], ...extraMessages, ...messages.slice(1)];
89
+ }
90
+ return [...extraMessages, ...messages];
91
+ };
92
+ const prepareFreshMessages = async (agent, input, runId) => {
93
+ let messages = normalizeMessages({
94
+ prompt: input.prompt,
95
+ messages: input.messages,
96
+ system: joinInstructions(agent.instructions, input.system, promptedOutputInstruction(agent))
97
+ });
98
+ const handoffMessages = input.handoff
99
+ ? [createAgentHandoffMessage(input.handoff), ...input.handoff.contextMessages.filter((message) => message.role !== "system")]
100
+ : [];
101
+ messages = injectContextMessages(messages, handoffMessages);
102
+ const memoryMessages = await invokeOperationalHook(agent, "memory", "load", runId, agent.memory
103
+ ? () => agent.memory.load({
104
+ runId,
105
+ agentId: agent.id,
106
+ scope: input.scope ?? input.handoff?.scope,
107
+ metadata: cloneMetadata(agent.metadata, input.metadata)
108
+ })
109
+ : undefined, []);
110
+ messages = injectContextMessages(messages, memoryMessages);
111
+ return {
112
+ messages,
113
+ memoryMessages
114
+ };
115
+ };
116
+ const bindDurableRuntime = (agent, input, state, executionEnvironment) => {
117
+ const policy = {
118
+ ...(agent.policy ?? {}),
119
+ ...(input.policy ?? {})
120
+ };
121
+ if (state.harness && !agent.harness) {
122
+ throw new ConflictError(`Agent run "${state.runId}" is bound to harness "${state.harness.id}", but the current agent has no harness binding.`);
123
+ }
124
+ if (state.harness && agent.harness) {
125
+ if (state.harness.id !== agent.harness.id ||
126
+ state.harness.version !== agent.harness.version ||
127
+ state.harness.fingerprint !== agent.harness.fingerprint) {
128
+ throw new ConflictError(`Agent run "${state.runId}" was created by a different harness fingerprint.`);
129
+ }
130
+ }
131
+ else if (!state.harness && agent.harness) {
132
+ if (!policy?.allowLegacyHarnessResume) {
133
+ throw new ConflictError(`Agent run "${state.runId}" predates harness binding; set allowLegacyHarnessResume only for an explicit migration.`);
134
+ }
135
+ state.harness = agent.harness;
136
+ }
137
+ if (state.executionEnvironment && !executionEnvironment) {
138
+ throw new ConflictError(`Agent run "${state.runId}" is bound to execution environment "${state.executionEnvironment.environmentId}".`);
139
+ }
140
+ if (state.executionEnvironment && executionEnvironment) {
141
+ if (state.executionEnvironment.environmentId !== executionEnvironment.environmentId ||
142
+ state.executionEnvironment.environmentVersion !== executionEnvironment.environmentVersion ||
143
+ state.executionEnvironment.fingerprint !== executionEnvironment.fingerprint ||
144
+ state.executionEnvironment.workspaceId !== executionEnvironment.workspaceId) {
145
+ throw new ConflictError(`Agent run "${state.runId}" was created in a different execution environment.`);
146
+ }
147
+ }
148
+ else if (!state.executionEnvironment && executionEnvironment) {
149
+ if (!policy?.allowLegacyExecutionEnvironmentResume) {
150
+ throw new ConflictError(`Agent run "${state.runId}" predates execution-environment binding; enable the explicit migration policy to resume it.`);
151
+ }
152
+ state.executionEnvironment = executionEnvironment;
153
+ }
154
+ };
155
+ const validateHarnessBinding = (binding) => {
156
+ if (!binding) {
157
+ return;
158
+ }
159
+ if (binding.schemaVersion !== 1 ||
160
+ binding.algorithm !== "sha256" ||
161
+ !binding.id ||
162
+ !binding.version ||
163
+ !/^sha256:[0-9a-f]{64}$/.test(binding.fingerprint)) {
164
+ throw new ValidationError("Agent harness binding is invalid.");
165
+ }
166
+ };
167
+ export const resolveContext = async (agent, input) => {
168
+ validateHarnessBinding(agent.harness);
169
+ const executionEnvironment = input.executionEnvironment ?? agent.executionEnvironment;
170
+ const executionEnvironmentBinding = executionEnvironment
171
+ ? createAgentExecutionEnvironmentBinding(executionEnvironment.manifest)
172
+ : undefined;
173
+ let parsedContext = input.context;
174
+ if (agent.contextSchema) {
175
+ const result = await agent.contextSchema.safeParseAsync(input.context);
176
+ if (!result.success) {
177
+ throw new ValidationError(`Invalid agent context: ${result.error.message}`);
178
+ }
179
+ parsedContext = result.data;
180
+ }
181
+ ensureValidIdempotencyInput(input, agent.store);
182
+ const inputScope = input.scope ?? input.handoff?.scope;
183
+ ensureValidScope(inputScope);
184
+ let loadedState = input.state ? normalizeAgentRunState(input.state) : undefined;
185
+ let loadedByIdempotencyKey = false;
186
+ if (!loadedState && input.runId && agent.store) {
187
+ loadedState = await agent.store.load(input.runId, inputScope);
188
+ if (loadedState) {
189
+ loadedState = normalizeAgentRunState(loadedState);
190
+ }
191
+ }
192
+ if (!loadedState && input.idempotencyKey) {
193
+ const runId = input.runId ?? randomId("run");
194
+ const maxSteps = Math.max(1, input.maxSteps ?? agent.maxSteps ?? 1);
195
+ const metadata = cloneMetadata(agent.metadata, input.metadata, input.handoff?.metadata);
196
+ const prepared = await prepareFreshMessages(agent, input, runId);
197
+ const candidate = createBaseState(agent.model.provider, agent.model.modelId, prepared.messages, maxSteps, metadata, agent.id, runId, input.handoff, input.parentRunId, input.idempotencyKey, inputScope, resolveAgentOutputMode(agent), agent.harness, executionEnvironmentBinding);
198
+ const claim = await agent.store.claimIdempotencyKey(candidate);
199
+ if (claim.claimed) {
200
+ return {
201
+ state: normalizeAgentRunState(claim.state),
202
+ messages: prepared.messages,
203
+ remainingSteps: maxSteps,
204
+ memoryMessages: prepared.memoryMessages,
205
+ context: parsedContext,
206
+ executionEnvironment,
207
+ fresh: true
208
+ };
209
+ }
210
+ loadedState = normalizeAgentRunState(claim.state);
211
+ loadedByIdempotencyKey = true;
212
+ }
213
+ const normalizedInput = loadedState && loadedByIdempotencyKey
214
+ ? { ...input, prompt: undefined, messages: undefined, system: undefined, handoff: undefined, state: loadedState }
215
+ : loadedState
216
+ ? { ...input, state: loadedState }
217
+ : input;
218
+ ensureValidStateInput(normalizedInput);
219
+ const metadata = cloneMetadata(agent.metadata, loadedState?.metadata, input.metadata, input.handoff?.metadata);
220
+ if (loadedState) {
221
+ const groupIdentity = input.metadata?.agentGroupIdentity;
222
+ if (groupIdentity !== undefined && (loadedState.metadata?.agentGroupIdentity !== groupIdentity ||
223
+ loadedState.agentId !== agent.id)) {
224
+ throw new ConflictError("Agent group idempotency key belongs to a different member or agent.");
225
+ }
226
+ bindDurableRuntime(agent, input, loadedState, executionEnvironmentBinding);
227
+ const maxSteps = input.maxSteps ?? loadedState.maxSteps;
228
+ const resumed = await applyApprovalResponses(loadedState.messages, input.approvals, loadedState.pendingApprovals, loadedState.approvalHistory, agent.toolApprovalSigner);
229
+ return {
230
+ state: {
231
+ ...loadedState,
232
+ schemaVersion: AGENT_RUN_STATE_SCHEMA_VERSION,
233
+ idempotencyKey: loadedState.idempotencyKey ?? input.idempotencyKey,
234
+ scope: loadedState.scope ?? inputScope,
235
+ agentId: loadedState.agentId ?? agent.id,
236
+ parentRunId: loadedState.parentRunId ?? input.parentRunId,
237
+ provider: agent.model.provider,
238
+ modelId: agent.model.modelId,
239
+ maxSteps,
240
+ messages: resumed.messages,
241
+ pendingApprovals: resumed.pendingApprovals,
242
+ approvalHistory: resumed.approvalHistory,
243
+ metadata,
244
+ updatedAt: Date.now()
245
+ },
246
+ messages: resumed.messages,
247
+ remainingSteps: Math.max(0, maxSteps - loadedState.currentStep),
248
+ memoryMessages: [],
249
+ context: parsedContext,
250
+ executionEnvironment,
251
+ fresh: false
252
+ };
253
+ }
254
+ const runId = input.runId ?? randomId("run");
255
+ const maxSteps = Math.max(1, input.maxSteps ?? agent.maxSteps ?? 1);
256
+ const prepared = await prepareFreshMessages(agent, input, runId);
257
+ return {
258
+ state: createBaseState(agent.model.provider, agent.model.modelId, prepared.messages, maxSteps, metadata, agent.id, runId, input.handoff, input.parentRunId, input.idempotencyKey, inputScope, resolveAgentOutputMode(agent), agent.harness, executionEnvironmentBinding),
259
+ messages: prepared.messages,
260
+ remainingSteps: maxSteps,
261
+ memoryMessages: prepared.memoryMessages,
262
+ context: parsedContext,
263
+ executionEnvironment,
264
+ fresh: true
265
+ };
266
+ };
267
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/agent/context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { AgentDefinition, LanguageModel, PrepareSubagentsForAgentOptions } from "../types.js";
2
+ export declare const createAgent: <TModel extends AgentDefinition["model"], TContext = unknown, TOutput = unknown>(definition: AgentDefinition<TModel, TContext, TOutput>) => AgentDefinition<TModel, TContext, TOutput>;
3
+ export declare const prepareSubagentsForAgent: <TModel extends LanguageModel>(agent: AgentDefinition<TModel>, options?: PrepareSubagentsForAgentOptions) => AgentDefinition<TModel>;
4
+ //# sourceMappingURL=definition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/agent/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,+BAA+B,EAChC,MAAM,aAAa,CAAC;AAKrB,eAAO,MAAM,WAAW,GACtB,MAAM,SAAS,eAAe,CAAC,OAAO,CAAC,EACvC,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,cAEL,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,KACrD,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAG1C,CAAC;AAEH,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,aAAa,SAC5D,eAAe,CAAC,MAAM,CAAC,YACrB,+BAA+B,KACvC,eAAe,CAAC,MAAM,CA6BxB,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { cloneMetadata } from "./common.js";
2
+ export const createAgent = (definition) => ({
3
+ ...definition,
4
+ metadata: cloneMetadata(definition.metadata)
5
+ });
6
+ export const prepareSubagentsForAgent = (agent, options = {}) => {
7
+ const store = options.store ?? agent.store;
8
+ const memory = options.memory ?? agent.memory;
9
+ const onTelemetryEvent = options.onTelemetryEvent ?? agent.onTelemetryEvent;
10
+ const toolApprovalPolicy = options.toolApprovalPolicy ?? agent.toolApprovalPolicy;
11
+ const toolExecution = options.toolExecution ?? agent.toolExecution;
12
+ const executionEnvironment = options.executionEnvironment ?? agent.executionEnvironment;
13
+ const compaction = options.compaction ?? agent.compaction;
14
+ const defaultMetadata = cloneMetadata(agent.metadata, options.metadata);
15
+ return {
16
+ ...agent,
17
+ metadata: cloneMetadata(agent.metadata),
18
+ subagents: (agent.subagents ?? []).map((subagent) => ({
19
+ ...subagent,
20
+ metadata: cloneMetadata(defaultMetadata, subagent.metadata),
21
+ agent: {
22
+ ...subagent.agent,
23
+ store: subagent.agent.store ?? store,
24
+ memory: subagent.agent.memory ?? memory,
25
+ onTelemetryEvent: subagent.agent.onTelemetryEvent ?? onTelemetryEvent,
26
+ toolApprovalPolicy: subagent.agent.toolApprovalPolicy ?? toolApprovalPolicy,
27
+ toolExecution: subagent.agent.toolExecution ?? toolExecution,
28
+ executionEnvironment: subagent.agent.executionEnvironment ?? executionEnvironment,
29
+ compaction: subagent.agent.compaction ?? compaction,
30
+ metadata: cloneMetadata(defaultMetadata, subagent.agent.metadata)
31
+ }
32
+ }))
33
+ };
34
+ };
35
+ //# sourceMappingURL=definition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/agent/definition.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,WAAW,GAAG,CAKzB,UAAsD,EACV,EAAE,CAAC,CAAC;IAChD,GAAG,UAAU;IACb,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,KAA8B,EAC9B,OAAO,GAAoC,EAAE,EACpB,EAAE;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAC9C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC;IAC5E,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,KAAK,CAAC,kBAAkB,CAAC;IAClF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAC;IACnE,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,KAAK,CAAC,oBAAoB,CAAC;IACxF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;IAC1D,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAExE,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvC,SAAS,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACpD,GAAG,QAAQ;YACX,QAAQ,EAAE,aAAa,CAAC,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAC3D,KAAK,EAAE;gBACL,GAAG,QAAQ,CAAC,KAAK;gBACjB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK;gBACpC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM;gBACvC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,gBAAgB,IAAI,gBAAgB;gBACrE,kBAAkB,EAAE,QAAQ,CAAC,KAAK,CAAC,kBAAkB,IAAI,kBAAkB;gBAC3E,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,IAAI,aAAa;gBAC5D,oBAAoB,EAAE,QAAQ,CAAC,KAAK,CAAC,oBAAoB,IAAI,oBAAoB;gBACjF,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,IAAI,UAAU;gBACnD,QAAQ,EAAE,aAAa,CAAC,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;aAClE;SACF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { z } from "zod";
2
+ import type { AgentDefinition, AgentRunInput, AgentRunOutput, AgentRunState, AgentStreamResult, CreateSubAgentToolOptions, LanguageModel, SubAgentToolOutput, ToolDefinition } from "../types.js";
3
+ declare const subAgentToolInputSchema: z.ZodObject<{
4
+ prompt: z.ZodString;
5
+ system: z.ZodOptional<z.ZodString>;
6
+ }, z.core.$strip>;
7
+ export declare const createSubAgentTool: <TModel extends LanguageModel>(options: CreateSubAgentToolOptions<TModel>) => ToolDefinition<typeof subAgentToolInputSchema, SubAgentToolOutput>;
8
+ export declare const runAgent: <TModel extends LanguageModel, TContext = unknown, TOutput = unknown>(agent: AgentDefinition<TModel, TContext, TOutput>, input?: AgentRunInput<TModel, TContext>) => Promise<AgentRunOutput<TOutput>>;
9
+ export declare const streamAgent: <TModel extends LanguageModel, TContext = unknown, TOutput = unknown>(agent: AgentDefinition<TModel, TContext, TOutput>, input?: AgentRunInput<TModel, TContext>) => AgentStreamResult<TOutput>;
10
+ export declare const resumeAgent: <TModel extends LanguageModel, TContext = unknown, TOutput = unknown>(agent: AgentDefinition<TModel, TContext, TOutput>, input: AgentRunInput<TModel, TContext> & {
11
+ state: AgentRunState;
12
+ }) => Promise<AgentRunOutput<TOutput>>;
13
+ export {};
14
+ //# sourceMappingURL=execution.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/agent/execution.ts"],"names":[],"mappings":"AA8CA,OAAO,EACL,CAAC,EACF,MAAM,KAAK,CAAC;AACb,OAAO,KAAK,EAIV,eAAe,EAGf,aAAa,EACb,cAAc,EACd,aAAa,EAIb,iBAAiB,EACjB,yBAAyB,EAGzB,aAAa,EAGb,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AA4DrB,QAAA,MAAM,uBAAuB;;;iBAG3B,CAAC;AAaH,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,aAAa,WACpD,yBAAyB,CAAC,MAAM,CAAC,KACzC,cAAc,CAAC,OAAO,uBAAuB,EAAE,kBAAkB,CAkKnE,CAAC;AA4TF,eAAO,MAAM,QAAQ,GACnB,MAAM,SAAS,aAAa,EAC5B,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,SAEV,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,UAC1C,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,KACrC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAqOjC,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,MAAM,SAAS,aAAa,EAC5B,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,SAEV,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,UAC1C,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,KACrC,iBAAiB,CAAC,OAAO,CAsc3B,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,MAAM,SAAS,aAAa,EAC5B,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,OAAO,SAEV,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,SAC1C,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,KAChE,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAsD,CAAC"}