@agentick/shared 0.0.1

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 (85) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +322 -0
  3. package/dist/.tsbuildinfo +1 -0
  4. package/dist/.tsbuildinfo.build +1 -0
  5. package/dist/block-types.d.ts +85 -0
  6. package/dist/block-types.d.ts.map +1 -0
  7. package/dist/block-types.js +98 -0
  8. package/dist/block-types.js.map +1 -0
  9. package/dist/blocks.d.ts +396 -0
  10. package/dist/blocks.d.ts.map +1 -0
  11. package/dist/blocks.js +209 -0
  12. package/dist/blocks.js.map +1 -0
  13. package/dist/devtools.d.ts +672 -0
  14. package/dist/devtools.d.ts.map +1 -0
  15. package/dist/devtools.js +445 -0
  16. package/dist/devtools.js.map +1 -0
  17. package/dist/errors.d.ts +335 -0
  18. package/dist/errors.d.ts.map +1 -0
  19. package/dist/errors.js +529 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/identity.d.ts +99 -0
  22. package/dist/identity.d.ts.map +1 -0
  23. package/dist/identity.js +116 -0
  24. package/dist/identity.js.map +1 -0
  25. package/dist/index.d.ts +56 -0
  26. package/dist/index.d.ts.map +1 -0
  27. package/dist/index.js +56 -0
  28. package/dist/index.js.map +1 -0
  29. package/dist/input.d.ts +55 -0
  30. package/dist/input.d.ts.map +1 -0
  31. package/dist/input.js +83 -0
  32. package/dist/input.js.map +1 -0
  33. package/dist/messages.d.ts +98 -0
  34. package/dist/messages.d.ts.map +1 -0
  35. package/dist/messages.js +81 -0
  36. package/dist/messages.js.map +1 -0
  37. package/dist/model-catalog.d.ts +144 -0
  38. package/dist/model-catalog.d.ts.map +1 -0
  39. package/dist/model-catalog.js +861 -0
  40. package/dist/model-catalog.js.map +1 -0
  41. package/dist/models.d.ts +173 -0
  42. package/dist/models.d.ts.map +1 -0
  43. package/dist/models.js +10 -0
  44. package/dist/models.js.map +1 -0
  45. package/dist/protocol.d.ts +257 -0
  46. package/dist/protocol.d.ts.map +1 -0
  47. package/dist/protocol.js +41 -0
  48. package/dist/protocol.js.map +1 -0
  49. package/dist/streaming.d.ts +635 -0
  50. package/dist/streaming.d.ts.map +1 -0
  51. package/dist/streaming.js +134 -0
  52. package/dist/streaming.js.map +1 -0
  53. package/dist/testing/fixtures.d.ts +250 -0
  54. package/dist/testing/fixtures.d.ts.map +1 -0
  55. package/dist/testing/fixtures.js +827 -0
  56. package/dist/testing/fixtures.js.map +1 -0
  57. package/dist/testing/helpers.d.ts +95 -0
  58. package/dist/testing/helpers.d.ts.map +1 -0
  59. package/dist/testing/helpers.js +271 -0
  60. package/dist/testing/helpers.js.map +1 -0
  61. package/dist/testing/index.d.ts +42 -0
  62. package/dist/testing/index.d.ts.map +1 -0
  63. package/dist/testing/index.js +70 -0
  64. package/dist/testing/index.js.map +1 -0
  65. package/dist/timeline.d.ts +59 -0
  66. package/dist/timeline.d.ts.map +1 -0
  67. package/dist/timeline.js +11 -0
  68. package/dist/timeline.js.map +1 -0
  69. package/dist/tools.d.ts +220 -0
  70. package/dist/tools.d.ts.map +1 -0
  71. package/dist/tools.js +63 -0
  72. package/dist/tools.js.map +1 -0
  73. package/dist/utils/entity-ids.d.ts +26 -0
  74. package/dist/utils/entity-ids.d.ts.map +1 -0
  75. package/dist/utils/entity-ids.js +44 -0
  76. package/dist/utils/entity-ids.js.map +1 -0
  77. package/dist/utils/index.d.ts +3 -0
  78. package/dist/utils/index.d.ts.map +1 -0
  79. package/dist/utils/index.js +3 -0
  80. package/dist/utils/index.js.map +1 -0
  81. package/dist/utils/merge-deep.d.ts +10 -0
  82. package/dist/utils/merge-deep.d.ts.map +1 -0
  83. package/dist/utils/merge-deep.js +33 -0
  84. package/dist/utils/merge-deep.js.map +1 -0
  85. package/package.json +84 -0
@@ -0,0 +1,134 @@
1
+ /**
2
+ * Streaming Types
3
+ *
4
+ * Platform-independent types for streaming model responses and engine events.
5
+ * Used by both backend (@agentick/core) and frontend (@agentick/client).
6
+ *
7
+ * ## Event Architecture
8
+ *
9
+ * - **ModelStreamEvent**: Model output events (content, reasoning, messages, tool calls)
10
+ * - **OrchestrationStreamEvent**: Orchestration events (execution lifecycle, ticks, tool results)
11
+ * - **ResultStreamEvent**: Final execution result
12
+ * - **StreamEvent**: Combined union of all streamable events
13
+ *
14
+ * ## Event Pattern
15
+ *
16
+ * For streamable content, events follow the pattern:
17
+ * ```
18
+ * [thing]_start → [thing]_delta (0..n) → [thing]_end → [thing] (fully formed)
19
+ * ```
20
+ *
21
+ * This allows consumers to choose granularity:
22
+ * - Streaming UI: Listen for `*_delta` events
23
+ * - Simple consumption: Listen for `content`, `reasoning`, `message`, `tool_call`
24
+ */
25
+ // ============================================================================
26
+ // Stop Reason
27
+ // ============================================================================
28
+ /**
29
+ * Stop reason enumeration.
30
+ * Defines why model generation stopped.
31
+ *
32
+ * Key distinction:
33
+ * - NATURAL_COMPLETION: Model decided to stop (maps to provider's end_turn, stop, etc.)
34
+ * - EXPLICIT_COMPLETION: Engine/runtime requested the stop (max ticks, abort, etc.)
35
+ *
36
+ * Usage by layer:
37
+ * - ModelStreamEvent (message_end): Model's stop reason (TOOL_USE, MAX_TOKENS, NATURAL_COMPLETION)
38
+ * - OrchestrationStreamEvent (execution): May be EXPLICIT_COMPLETION if engine stopped early
39
+ */
40
+ export var StopReason;
41
+ (function (StopReason) {
42
+ StopReason["MAX_TOKENS"] = "max_tokens";
43
+ StopReason["STOP_SEQUENCE"] = "stop_sequence";
44
+ StopReason["CONTENT_FILTER"] = "content_filter";
45
+ StopReason["TOOL_USE"] = "tool_use";
46
+ StopReason["FUNCTION_CALL"] = "function_call";
47
+ StopReason["UNSPECIFIED"] = "unspecified";
48
+ StopReason["OTHER"] = "other";
49
+ StopReason["STOP"] = "stop";
50
+ StopReason["PAUSED"] = "paused";
51
+ StopReason["FORMAT_ERROR"] = "format_error";
52
+ StopReason["EMPTY_RESPONSE"] = "empty_response";
53
+ StopReason["NO_CONTENT"] = "no_content";
54
+ StopReason["EXPLICIT_COMPLETION"] = "explicit_completion";
55
+ StopReason["NATURAL_COMPLETION"] = "natural_completion";
56
+ StopReason["ERROR"] = "error";
57
+ })(StopReason || (StopReason = {}));
58
+ // ============================================================================
59
+ // Event Type Guards
60
+ // ============================================================================
61
+ /**
62
+ * Check if event is a ModelStreamEvent (model output)
63
+ */
64
+ export function isModelStreamEvent(event) {
65
+ return [
66
+ "content_start",
67
+ "content_delta",
68
+ "content_end",
69
+ "content",
70
+ "reasoning_start",
71
+ "reasoning_delta",
72
+ "reasoning_end",
73
+ "reasoning",
74
+ "message_start",
75
+ "message_end",
76
+ "message",
77
+ "tool_call_start",
78
+ "tool_call_delta",
79
+ "tool_call_end",
80
+ "tool_call",
81
+ "usage",
82
+ "error",
83
+ ].includes(event.type);
84
+ }
85
+ /**
86
+ * Check if event is an OrchestrationStreamEvent (orchestration)
87
+ */
88
+ export function isOrchestrationStreamEvent(event) {
89
+ return [
90
+ "execution_start",
91
+ "execution_end",
92
+ "execution",
93
+ "tick_start",
94
+ "tick_end",
95
+ "tick",
96
+ "tool_result",
97
+ "tool_confirmation_required",
98
+ "tool_confirmation_result",
99
+ "compiled",
100
+ "model_request",
101
+ "model_response",
102
+ "context_update",
103
+ "fork_start",
104
+ "fork_end",
105
+ "spawn_start",
106
+ "spawn_end",
107
+ "engine_error",
108
+ ].includes(event.type);
109
+ }
110
+ /**
111
+ * Check if event is a Fork event
112
+ */
113
+ export function isForkEvent(event) {
114
+ return ["fork_start", "fork_end"].includes(event.type);
115
+ }
116
+ /**
117
+ * Check if event is a Spawn event
118
+ */
119
+ export function isSpawnEvent(event) {
120
+ return ["spawn_start", "spawn_end"].includes(event.type);
121
+ }
122
+ /**
123
+ * Check if event is a delta event (for streaming UI)
124
+ */
125
+ export function isDeltaEvent(event) {
126
+ return ["content_delta", "reasoning_delta", "tool_call_delta"].includes(event.type);
127
+ }
128
+ /**
129
+ * Check if event is a final/complete event
130
+ */
131
+ export function isFinalEvent(event) {
132
+ return ["content", "reasoning", "message", "tool_call", "tick", "execution", "result"].includes(event.type);
133
+ }
134
+ //# sourceMappingURL=streaming.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaming.js","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA+EH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,UAgBX;AAhBD,WAAY,UAAU;IACpB,uCAAyB,CAAA;IACzB,6CAA+B,CAAA;IAC/B,+CAAiC,CAAA;IACjC,mCAAqB,CAAA;IACrB,6CAA+B,CAAA;IAC/B,yCAA2B,CAAA;IAC3B,6BAAe,CAAA;IACf,2BAAa,CAAA;IACb,+BAAiB,CAAA;IACjB,2CAA6B,CAAA;IAC7B,+CAAiC,CAAA;IACjC,uCAAyB,CAAA;IACzB,yDAA2C,CAAA;IAC3C,uDAAyC,CAAA;IACzC,6BAAe,CAAA;AACjB,CAAC,EAhBW,UAAU,KAAV,UAAU,QAgBrB;AA4lBD,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,OAAO;QACL,eAAe;QACf,eAAe;QACf,aAAa;QACb,SAAS;QACT,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,eAAe;QACf,aAAa;QACb,SAAS;QACT,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,OAAO;QACP,OAAO;KACR,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAkB;IAC3D,OAAO;QACL,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,YAAY;QACZ,UAAU;QACV,MAAM;QACN,aAAa;QACb,4BAA4B;QAC5B,0BAA0B;QAC1B,UAAU;QACV,eAAe;QACf,gBAAgB;QAChB,gBAAgB;QAChB,YAAY;QACZ,UAAU;QACV,aAAa;QACb,WAAW;QACX,cAAc;KACf,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAkB;IAElB,OAAO,CAAC,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAkB;IASlB,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAC7F,KAAK,CAAC,IAAI,CACX,CAAC;AACJ,CAAC"}
@@ -0,0 +1,250 @@
1
+ /**
2
+ * Test Fixtures
3
+ *
4
+ * Factory functions for creating test data with sensible defaults.
5
+ * All functions accept partial overrides for flexibility.
6
+ */
7
+ import type { ContentBlock, TextBlock, ImageBlock, ToolUseBlock, ToolResultBlock, ReasoningBlock, CodeBlock } from "../blocks";
8
+ import { BlockType } from "../block-types";
9
+ import type { Message } from "../messages";
10
+ import type { UsageStats } from "../models";
11
+ import type { SessionResultPayload } from "../protocol";
12
+ import { StopReason, type StreamEventBase, type ContentStartEvent, type ContentDeltaEvent, type ContentEndEvent, type ContentEvent, type ReasoningStartEvent, type ReasoningDeltaEvent, type ReasoningEndEvent, type ReasoningEvent, type MessageStartEvent, type MessageEndEvent, type MessageEvent, type ToolCallStartEvent, type ToolCallDeltaEvent, type ToolCallEndEvent, type ToolCallEvent, type StreamErrorEvent, type ExecutionStartEvent, type ExecutionEndEvent, type ExecutionEvent, type TickStartEvent, type TickEndEvent, type TickEvent, type ToolResultEvent, type ToolConfirmationRequiredEvent, type ToolConfirmationResultEvent, type EngineErrorEvent, type ResultStreamEvent, type ForkStartEvent, type ForkEndEvent, type SpawnStartEvent, type SpawnEndEvent, type StreamEvent, type OrchestrationStreamEvent } from "../streaming";
13
+ import type { ToolDefinition, ToolCall, ToolResult, ToolExecutor } from "../tools";
14
+ /**
15
+ * Generate a unique test ID
16
+ */
17
+ export declare function testId(prefix?: string): string;
18
+ /**
19
+ * Reset the ID counter (call in beforeEach)
20
+ */
21
+ export declare function resetTestIds(): void;
22
+ /**
23
+ * Create a text block
24
+ */
25
+ export declare function createTextBlock(text?: string, overrides?: Partial<TextBlock>): TextBlock;
26
+ /**
27
+ * Create an image block with URL source
28
+ */
29
+ export declare function createImageBlock(url?: string, overrides?: Partial<ImageBlock>): ImageBlock;
30
+ /**
31
+ * Create an image block with base64 source
32
+ */
33
+ export declare function createBase64ImageBlock(data?: string, mimeType?: string, overrides?: Partial<ImageBlock>): ImageBlock;
34
+ /**
35
+ * Create a tool use block
36
+ */
37
+ export declare function createToolUseBlock(name?: string, input?: Record<string, unknown>, overrides?: Partial<ToolUseBlock>): ToolUseBlock;
38
+ /**
39
+ * Create a tool result block
40
+ */
41
+ export declare function createToolResultBlock(toolUseId: string, content?: ContentBlock[], overrides?: Partial<ToolResultBlock>): ToolResultBlock;
42
+ /**
43
+ * Create an error tool result block
44
+ */
45
+ export declare function createErrorToolResultBlock(toolUseId: string, errorMessage?: string, overrides?: Partial<ToolResultBlock>): ToolResultBlock;
46
+ /**
47
+ * Create a reasoning block
48
+ */
49
+ export declare function createReasoningBlock(text?: string, overrides?: Partial<ReasoningBlock>): ReasoningBlock;
50
+ /**
51
+ * Create a code block
52
+ */
53
+ export declare function createCodeBlock(text?: string, language?: string, overrides?: Partial<CodeBlock>): CodeBlock;
54
+ /**
55
+ * Create a user message
56
+ */
57
+ export declare function createUserMessage(content?: string | ContentBlock[], overrides?: Partial<Message>): Message;
58
+ /**
59
+ * Create an assistant message
60
+ */
61
+ export declare function createAssistantMessage(content?: string | ContentBlock[], overrides?: Partial<Message>): Message;
62
+ /**
63
+ * Create a system message
64
+ */
65
+ export declare function createSystemMessage(content?: string, overrides?: Partial<Message>): Message;
66
+ /**
67
+ * Create a tool message (tool result)
68
+ */
69
+ export declare function createToolMessage(toolUseId: string, content?: ContentBlock[], overrides?: Partial<Message>): Message;
70
+ /**
71
+ * Create a conversation (array of messages)
72
+ */
73
+ export declare function createConversation(exchanges: Array<{
74
+ user: string;
75
+ assistant: string;
76
+ }>): Message[];
77
+ /**
78
+ * Create a tool definition
79
+ */
80
+ export declare function createToolDefinition(name?: string, overrides?: Partial<ToolDefinition>): ToolDefinition;
81
+ /**
82
+ * Create an agent tool call
83
+ */
84
+ export declare function createToolCall(name?: string, input?: Record<string, unknown>, overrides?: Partial<ToolCall>): ToolCall;
85
+ /**
86
+ * Create an agent tool result
87
+ */
88
+ export declare function createToolResult(toolUseId: string, content?: ContentBlock[], overrides?: Partial<ToolResult>): ToolResult;
89
+ /**
90
+ * Create a StreamEventBase with default values.
91
+ * All StreamEvent types extend this base.
92
+ */
93
+ export declare function createEventBase(tick?: number, overrides?: Partial<StreamEventBase>): StreamEventBase;
94
+ /**
95
+ * Create a content_start event
96
+ */
97
+ export declare function createContentStartEvent(blockType?: BlockType, blockIndex?: number, overrides?: Partial<ContentStartEvent>): ContentStartEvent;
98
+ /**
99
+ * Create a content_delta event
100
+ */
101
+ export declare function createContentDeltaEvent(delta: string, blockType?: BlockType, blockIndex?: number, overrides?: Partial<ContentDeltaEvent>): ContentDeltaEvent;
102
+ /**
103
+ * Create a content_end event
104
+ */
105
+ export declare function createContentEndEvent(blockType?: BlockType, blockIndex?: number, overrides?: Partial<ContentEndEvent>): ContentEndEvent;
106
+ /**
107
+ * Create a content (complete) event
108
+ */
109
+ export declare function createContentEvent(content: ContentBlock, blockIndex?: number, overrides?: Partial<ContentEvent>): ContentEvent;
110
+ /**
111
+ * Create a reasoning_start event
112
+ */
113
+ export declare function createReasoningStartEvent(blockIndex?: number, overrides?: Partial<ReasoningStartEvent>): ReasoningStartEvent;
114
+ /**
115
+ * Create a reasoning_delta event
116
+ */
117
+ export declare function createReasoningDeltaEvent(delta: string, blockIndex?: number, overrides?: Partial<ReasoningDeltaEvent>): ReasoningDeltaEvent;
118
+ /**
119
+ * Create a reasoning_end event
120
+ */
121
+ export declare function createReasoningEndEvent(blockIndex?: number, overrides?: Partial<ReasoningEndEvent>): ReasoningEndEvent;
122
+ /**
123
+ * Create a reasoning (complete) event
124
+ */
125
+ export declare function createReasoningCompleteEvent(reasoning: string, blockIndex?: number, overrides?: Partial<ReasoningEvent>): ReasoningEvent;
126
+ /**
127
+ * Create a message_start event
128
+ */
129
+ export declare function createMessageStartEvent(model?: string, overrides?: Partial<MessageStartEvent>): MessageStartEvent;
130
+ /**
131
+ * Create a message_end event
132
+ */
133
+ export declare function createMessageEndEvent(stopReason?: StopReason, usage?: UsageStats, overrides?: Partial<MessageEndEvent>): MessageEndEvent;
134
+ /**
135
+ * Create a message (complete) event
136
+ */
137
+ export declare function createMessageCompleteEvent(message: Message, stopReason?: StopReason, overrides?: Partial<MessageEvent>): MessageEvent;
138
+ /**
139
+ * Create a tool_call_start event
140
+ */
141
+ export declare function createToolCallStartEvent(name: string, callId?: string, blockIndex?: number, overrides?: Partial<ToolCallStartEvent>): ToolCallStartEvent;
142
+ /**
143
+ * Create a tool_call_delta event
144
+ */
145
+ export declare function createToolCallDeltaEvent(callId: string, delta: string, blockIndex?: number, overrides?: Partial<ToolCallDeltaEvent>): ToolCallDeltaEvent;
146
+ /**
147
+ * Create a tool_call_end event
148
+ */
149
+ export declare function createToolCallEndEvent(callId: string, blockIndex?: number, overrides?: Partial<ToolCallEndEvent>): ToolCallEndEvent;
150
+ /**
151
+ * Create a tool_call (complete) event
152
+ */
153
+ export declare function createToolCallCompleteEvent(name: string, input?: Record<string, unknown>, callId?: string, blockIndex?: number, overrides?: Partial<ToolCallEvent>): ToolCallEvent;
154
+ /**
155
+ * Create a stream error event
156
+ */
157
+ export declare function createStreamErrorEvent(message: string, code?: string, overrides?: Partial<StreamErrorEvent>): StreamErrorEvent;
158
+ /**
159
+ * Create an execution_start event
160
+ */
161
+ export declare function createExecutionStartEvent(executionId?: string, overrides?: Partial<ExecutionStartEvent>): ExecutionStartEvent;
162
+ /**
163
+ * Create an execution_end event
164
+ */
165
+ export declare function createExecutionEndEvent(executionId: string, output?: unknown, overrides?: Partial<ExecutionEndEvent>): ExecutionEndEvent;
166
+ /**
167
+ * Create an execution (complete) event
168
+ */
169
+ export declare function createExecutionCompleteEvent(executionId?: string, output?: unknown, overrides?: Partial<ExecutionEvent>): ExecutionEvent;
170
+ /**
171
+ * Create a session result event.
172
+ */
173
+ export declare function createResultStreamEvent(result?: SessionResultPayload, overrides?: Partial<ResultStreamEvent>): ResultStreamEvent;
174
+ /**
175
+ * Create a tick_start event
176
+ */
177
+ export declare function createTickStartEvent(tickNumber?: number, overrides?: Partial<TickStartEvent>): TickStartEvent;
178
+ /**
179
+ * Create a tick_end event
180
+ */
181
+ export declare function createTickEndEvent(tickNumber?: number, usage?: UsageStats, overrides?: Partial<TickEndEvent>): TickEndEvent;
182
+ /**
183
+ * Create a tick (complete) event
184
+ */
185
+ export declare function createTickCompleteEvent(tickNumber?: number, overrides?: Partial<TickEvent>): TickEvent;
186
+ /**
187
+ * Create a tool_result event
188
+ */
189
+ export declare function createToolResultEvent(callId: string, name: string, result: unknown, executedBy?: ToolExecutor, overrides?: Partial<ToolResultEvent>): ToolResultEvent;
190
+ /**
191
+ * Create an error tool_result event
192
+ */
193
+ export declare function createErrorToolResultEvent(callId: string, name: string, errorMessage: string, executedBy?: ToolExecutor, overrides?: Partial<ToolResultEvent>): ToolResultEvent;
194
+ /**
195
+ * Create a tool_confirmation_required event
196
+ */
197
+ export declare function createToolConfirmationRequiredEvent(callId: string, name: string, input?: Record<string, unknown>, message?: string, overrides?: Partial<ToolConfirmationRequiredEvent>): ToolConfirmationRequiredEvent;
198
+ /**
199
+ * Create a tool_confirmation_result event
200
+ */
201
+ export declare function createToolConfirmationResultEvent(callId: string, confirmed: boolean, always?: boolean, overrides?: Partial<ToolConfirmationResultEvent>): ToolConfirmationResultEvent;
202
+ /**
203
+ * Create an engine_error event
204
+ */
205
+ export declare function createEngineErrorEvent(message: string, code?: string, overrides?: Partial<EngineErrorEvent>): EngineErrorEvent;
206
+ /**
207
+ * Create a fork_start event
208
+ */
209
+ export declare function createForkStartEvent(forkId?: string, parentExecutionId?: string, branches?: string[], strategy?: "race" | "vote" | "all", overrides?: Partial<ForkStartEvent>): ForkStartEvent;
210
+ /**
211
+ * Create a fork_end event
212
+ */
213
+ export declare function createForkEndEvent(forkId: string, parentExecutionId: string, results?: Record<string, unknown>, overrides?: Partial<ForkEndEvent>): ForkEndEvent;
214
+ /**
215
+ * Create a spawn_start event
216
+ */
217
+ export declare function createSpawnStartEvent(spawnId?: string, parentExecutionId?: string, childExecutionId?: string, overrides?: Partial<SpawnStartEvent>): SpawnStartEvent;
218
+ /**
219
+ * Create a spawn_end event
220
+ */
221
+ export declare function createSpawnEndEvent(spawnId: string, parentExecutionId: string, childExecutionId: string, output?: unknown, overrides?: Partial<SpawnEndEvent>): SpawnEndEvent;
222
+ /**
223
+ * Create a sequence of StreamEvents for a simple text response.
224
+ *
225
+ * Follows the pattern: message_start → content_start → content_delta* → content_end → content → message_end → message
226
+ */
227
+ export declare function createTextStreamEventSequence(text: string, chunkSize?: number, tick?: number): StreamEvent[];
228
+ /**
229
+ * Create a sequence of StreamEvents for a tool call.
230
+ *
231
+ * Follows the pattern: message_start → tool_call_start → tool_call_delta* → tool_call_end → tool_call → message_end → message
232
+ */
233
+ export declare function createToolCallEventSequence(toolName: string, toolInput: Record<string, unknown>, tick?: number): StreamEvent[];
234
+ /**
235
+ * Create a sequence of OrchestrationStreamEvents for a Fork operation.
236
+ *
237
+ * Note: Branch-level events are not included - each branch runs as a
238
+ * separate execution with its own stream. Subscribe to those executions
239
+ * directly if you need branch-level observability.
240
+ */
241
+ export declare function createForkEventSequence(branchCount?: number, strategy?: "race" | "vote" | "all", input?: unknown, tick?: number): OrchestrationStreamEvent[];
242
+ /**
243
+ * Create a sequence of OrchestrationStreamEvents for a Spawn operation
244
+ */
245
+ export declare function createSpawnEventSequence(componentName?: string, input?: unknown, output?: unknown, tick?: number): OrchestrationStreamEvent[];
246
+ /**
247
+ * Create a token usage object
248
+ */
249
+ export declare function createUsageStats(overrides?: Partial<UsageStats>): UsageStats;
250
+ //# sourceMappingURL=fixtures.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/testing/fixtures.ts"],"names":[],"mappings":"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"}