@zakstam/codex-local-component 0.7.0 → 0.7.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 (122) hide show
  1. package/LLMS.md +8 -0
  2. package/dist/component/_generated/api.d.ts +42 -0
  3. package/dist/component/_generated/api.d.ts.map +1 -1
  4. package/dist/component/_generated/api.js.map +1 -1
  5. package/dist/component/_generated/component.d.ts +279 -126
  6. package/dist/component/_generated/component.d.ts.map +1 -1
  7. package/dist/component/approvals.d.ts +2 -6
  8. package/dist/component/approvals.d.ts.map +1 -1
  9. package/dist/component/approvals.js +8 -7
  10. package/dist/component/approvals.js.map +1 -1
  11. package/dist/component/dispatch.d.ts +7 -21
  12. package/dist/component/dispatch.d.ts.map +1 -1
  13. package/dist/component/dispatch.js +21 -20
  14. package/dist/component/dispatch.js.map +1 -1
  15. package/dist/component/ingest/applyApprovals.d.ts.map +1 -1
  16. package/dist/component/ingest/applyApprovals.js +3 -2
  17. package/dist/component/ingest/applyApprovals.js.map +1 -1
  18. package/dist/component/ingest/applyMessages.d.ts.map +1 -1
  19. package/dist/component/ingest/applyMessages.js +8 -7
  20. package/dist/component/ingest/applyMessages.js.map +1 -1
  21. package/dist/component/ingest/applyStreams.d.ts.map +1 -1
  22. package/dist/component/ingest/applyStreams.js +13 -12
  23. package/dist/component/ingest/applyStreams.js.map +1 -1
  24. package/dist/component/ingest/applyTurns.d.ts.map +1 -1
  25. package/dist/component/ingest/applyTurns.js +8 -7
  26. package/dist/component/ingest/applyTurns.js.map +1 -1
  27. package/dist/component/ingest/checkpoints.d.ts.map +1 -1
  28. package/dist/component/ingest/checkpoints.js +10 -13
  29. package/dist/component/ingest/checkpoints.js.map +1 -1
  30. package/dist/component/ingest/index.d.ts.map +1 -1
  31. package/dist/component/ingest/index.js +3 -2
  32. package/dist/component/ingest/index.js.map +1 -1
  33. package/dist/component/ingest/postIngest.d.ts.map +1 -1
  34. package/dist/component/ingest/postIngest.js +2 -1
  35. package/dist/component/ingest/postIngest.js.map +1 -1
  36. package/dist/component/ingest/sessionGuard.d.ts.map +1 -1
  37. package/dist/component/ingest/sessionGuard.js +5 -14
  38. package/dist/component/ingest/sessionGuard.js.map +1 -1
  39. package/dist/component/ingest/stateCache.d.ts +1 -1
  40. package/dist/component/ingest/stateCache.d.ts.map +1 -1
  41. package/dist/component/ingest/stateCache.js +8 -8
  42. package/dist/component/ingest/stateCache.js.map +1 -1
  43. package/dist/component/ingest/types.d.ts +2 -4
  44. package/dist/component/ingest/types.d.ts.map +1 -1
  45. package/dist/component/messages.d.ts +2 -6
  46. package/dist/component/messages.d.ts.map +1 -1
  47. package/dist/component/messages.js +4 -3
  48. package/dist/component/messages.js.map +1 -1
  49. package/dist/component/reasoning.d.ts +1 -3
  50. package/dist/component/reasoning.d.ts.map +1 -1
  51. package/dist/component/reasoning.js +3 -2
  52. package/dist/component/reasoning.js.map +1 -1
  53. package/dist/component/schema.d.ts +116 -122
  54. package/dist/component/schema.d.ts.map +1 -1
  55. package/dist/component/schema.js +74 -78
  56. package/dist/component/schema.js.map +1 -1
  57. package/dist/component/scope.d.ts +4 -0
  58. package/dist/component/scope.d.ts.map +1 -0
  59. package/dist/component/scope.js +6 -0
  60. package/dist/component/scope.js.map +1 -0
  61. package/dist/component/serverRequests.d.ts +3 -9
  62. package/dist/component/serverRequests.d.ts.map +1 -1
  63. package/dist/component/serverRequests.js +11 -10
  64. package/dist/component/serverRequests.js.map +1 -1
  65. package/dist/component/sessions.d.ts +1 -1
  66. package/dist/component/sessions.js +3 -3
  67. package/dist/component/sessions.js.map +1 -1
  68. package/dist/component/streamStats.d.ts +4 -4
  69. package/dist/component/streamStats.d.ts.map +1 -1
  70. package/dist/component/streamStats.js +10 -10
  71. package/dist/component/streamStats.js.map +1 -1
  72. package/dist/component/streams.d.ts +3 -3
  73. package/dist/component/streams.js +18 -18
  74. package/dist/component/streams.js.map +1 -1
  75. package/dist/component/sync.d.ts +4 -12
  76. package/dist/component/sync.d.ts.map +1 -1
  77. package/dist/component/sync.js +1 -1
  78. package/dist/component/sync.js.map +1 -1
  79. package/dist/component/syncIngest.d.ts +1 -3
  80. package/dist/component/syncIngest.d.ts.map +1 -1
  81. package/dist/component/syncReplay.d.ts +1 -3
  82. package/dist/component/syncReplay.d.ts.map +1 -1
  83. package/dist/component/syncReplay.js +11 -12
  84. package/dist/component/syncReplay.js.map +1 -1
  85. package/dist/component/threads.d.ts +7 -21
  86. package/dist/component/threads.d.ts.map +1 -1
  87. package/dist/component/threads.js +35 -34
  88. package/dist/component/threads.js.map +1 -1
  89. package/dist/component/turns.d.ts +2 -6
  90. package/dist/component/turns.d.ts.map +1 -1
  91. package/dist/component/turns.js +9 -8
  92. package/dist/component/turns.js.map +1 -1
  93. package/dist/component/turnsInternal.d.ts +1 -1
  94. package/dist/component/turnsInternal.js +3 -3
  95. package/dist/component/turnsInternal.js.map +1 -1
  96. package/dist/component/types.d.ts +4 -10
  97. package/dist/component/types.d.ts.map +1 -1
  98. package/dist/component/types.js +1 -3
  99. package/dist/component/types.js.map +1 -1
  100. package/dist/component/utils.d.ts.map +1 -1
  101. package/dist/component/utils.js +8 -11
  102. package/dist/component/utils.js.map +1 -1
  103. package/dist/host/convexPreset.d.ts +90 -194
  104. package/dist/host/convexPreset.d.ts.map +1 -1
  105. package/dist/host/convexSlice.d.ts +10 -16
  106. package/dist/host/convexSlice.d.ts.map +1 -1
  107. package/dist/host/convexSlice.js +2 -4
  108. package/dist/host/convexSlice.js.map +1 -1
  109. package/dist/host/runtime.d.ts +1 -3
  110. package/dist/host/runtime.d.ts.map +1 -1
  111. package/dist/host/runtime.js +1 -1
  112. package/dist/host/runtime.js.map +1 -1
  113. package/dist/host/surfaceGenerator.d.ts +0 -2
  114. package/dist/host/surfaceGenerator.d.ts.map +1 -1
  115. package/dist/host/surfaceGenerator.js +2 -2
  116. package/dist/host/surfaceGenerator.js.map +1 -1
  117. package/docs/CLIENT_AND_REACT_HOOKS.md +7 -0
  118. package/docs/DISPATCH_MANAGED_REFERENCE_HOST.md +6 -1
  119. package/docs/HOST_INTEGRATION.md +8 -0
  120. package/docs/OPERATIONS_AND_ERRORS.md +0 -1
  121. package/docs/RUNTIME_OWNED_REFERENCE_HOST.md +5 -0
  122. package/package.json +1 -1
package/LLMS.md CHANGED
@@ -2,6 +2,14 @@
2
2
 
3
3
  Canonical default: runtime-owned host integration (`dispatchManaged: false`).
4
4
 
5
+ ## Actor Scope Contract
6
+
7
+ - Actor payload is `actor: { userId?: string }`.
8
+ - `userId` is optional:
9
+ - when present, data access is scoped to that user.
10
+ - when omitted, data access is scoped to anonymous-only rows.
11
+ - Do not send tenant/device identifiers.
12
+
5
13
  ## Hard Rule
6
14
 
7
15
  - Follow this file as the only default implementation strategy.
@@ -9,9 +9,30 @@
9
9
  import type * as approvals from "../approvals.js";
10
10
  import type * as dispatch from "../dispatch.js";
11
11
  import type * as index from "../index.js";
12
+ import type * as ingest_applyApprovals from "../ingest/applyApprovals.js";
13
+ import type * as ingest_applyMessages from "../ingest/applyMessages.js";
14
+ import type * as ingest_applyStreams from "../ingest/applyStreams.js";
15
+ import type * as ingest_applyTurns from "../ingest/applyTurns.js";
16
+ import type * as ingest_checkpoints from "../ingest/checkpoints.js";
17
+ import type * as ingest_index from "../ingest/index.js";
18
+ import type * as ingest_normalize from "../ingest/normalize.js";
19
+ import type * as ingest_postIngest from "../ingest/postIngest.js";
20
+ import type * as ingest_sessionGuard from "../ingest/sessionGuard.js";
21
+ import type * as ingest_stateCache from "../ingest/stateCache.js";
22
+ import type * as ingest_types from "../ingest/types.js";
23
+ import type * as messages from "../messages.js";
24
+ import type * as pagination from "../pagination.js";
25
+ import type * as reasoning from "../reasoning.js";
26
+ import type * as scope from "../scope.js";
27
+ import type * as serverRequests from "../serverRequests.js";
12
28
  import type * as sessions from "../sessions.js";
29
+ import type * as streamStats from "../streamStats.js";
13
30
  import type * as streams from "../streams.js";
14
31
  import type * as sync from "../sync.js";
32
+ import type * as syncHelpers from "../syncHelpers.js";
33
+ import type * as syncIngest from "../syncIngest.js";
34
+ import type * as syncReplay from "../syncReplay.js";
35
+ import type * as syncRuntime from "../syncRuntime.js";
15
36
  import type * as threads from "../threads.js";
16
37
  import type * as turns from "../turns.js";
17
38
  import type * as turnsInternal from "../turnsInternal.js";
@@ -22,9 +43,30 @@ declare const fullApi: ApiFromModules<{
22
43
  approvals: typeof approvals;
23
44
  dispatch: typeof dispatch;
24
45
  index: typeof index;
46
+ "ingest/applyApprovals": typeof ingest_applyApprovals;
47
+ "ingest/applyMessages": typeof ingest_applyMessages;
48
+ "ingest/applyStreams": typeof ingest_applyStreams;
49
+ "ingest/applyTurns": typeof ingest_applyTurns;
50
+ "ingest/checkpoints": typeof ingest_checkpoints;
51
+ "ingest/index": typeof ingest_index;
52
+ "ingest/normalize": typeof ingest_normalize;
53
+ "ingest/postIngest": typeof ingest_postIngest;
54
+ "ingest/sessionGuard": typeof ingest_sessionGuard;
55
+ "ingest/stateCache": typeof ingest_stateCache;
56
+ "ingest/types": typeof ingest_types;
57
+ messages: typeof messages;
58
+ pagination: typeof pagination;
59
+ reasoning: typeof reasoning;
60
+ scope: typeof scope;
61
+ serverRequests: typeof serverRequests;
25
62
  sessions: typeof sessions;
63
+ streamStats: typeof streamStats;
26
64
  streams: typeof streams;
27
65
  sync: typeof sync;
66
+ syncHelpers: typeof syncHelpers;
67
+ syncIngest: typeof syncIngest;
68
+ syncReplay: typeof syncReplay;
69
+ syncRuntime: typeof syncRuntime;
28
70
  threads: typeof threads;
29
71
  turns: typeof turns;
30
72
  turnsInternal: typeof turnsInternal;
@@ -1 +1 @@
1
- {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,KAAK,aAAa,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,QAAA,MAAM,OAAO,EAAE,cAAc,CAAC;IAC5B,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB,CAAiB,CAAC;AAEnB;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,EAAE,SAAS,CACzB,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CACjB,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAC9B,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnB,CAAC;AAElB,eAAO,MAAM,UAAU,EAAqC,EAAE,CAAC"}
1
+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAmBH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,OAAO,GAYR,MAAa,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAGZ,MAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAGjB,MAAa,CAAC;AAElB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAmB,CAAC"}
1
+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAwCH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,OAAO,GAiCR,MAAa,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAGZ,MAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAGjB,MAAa,CAAC;AAElB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAmB,CAAC"}
@@ -22,9 +22,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
22
22
  approvals: {
23
23
  listPending: FunctionReference<"query", "internal", {
24
24
  actor: {
25
- deviceId: string;
26
- tenantId: string;
27
- userId: string;
25
+ userId?: string;
28
26
  };
29
27
  paginationOpts: {
30
28
  cursor: string | null;
@@ -38,9 +36,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
38
36
  }, any, Name>;
39
37
  respond: FunctionReference<"mutation", "internal", {
40
38
  actor: {
41
- deviceId: string;
42
- tenantId: string;
43
- userId: string;
39
+ userId?: string;
44
40
  };
45
41
  decision: "accepted" | "declined";
46
42
  itemId: string;
@@ -49,75 +45,217 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
49
45
  }, null, Name>;
50
46
  };
51
47
  dispatch: {
52
- enqueueTurnDispatch: FunctionReference<"mutation", "internal", Record<string, unknown>, {
48
+ cancelTurnDispatch: FunctionReference<"mutation", "internal", {
49
+ actor: {
50
+ userId?: string;
51
+ };
52
+ claimToken?: string;
53
+ dispatchId: string;
54
+ reason: string;
55
+ threadId: string;
56
+ }, null, Name>;
57
+ claimNextTurnDispatch: FunctionReference<"mutation", "internal", {
58
+ actor: {
59
+ userId?: string;
60
+ };
61
+ claimOwner: string;
62
+ leaseMs?: number;
63
+ threadId: string;
64
+ }, null | {
65
+ attemptCount: number;
66
+ claimToken: string;
67
+ dispatchId: string;
68
+ idempotencyKey: string;
69
+ inputText: string;
70
+ leaseExpiresAt: number;
71
+ turnId: string;
72
+ }, Name>;
73
+ enqueueTurnDispatch: FunctionReference<"mutation", "internal", {
74
+ actor: {
75
+ userId?: string;
76
+ };
77
+ dispatchId?: string;
78
+ idempotencyKey: string;
79
+ input: Array<{
80
+ path?: string;
81
+ text?: string;
82
+ type: string;
83
+ url?: string;
84
+ }>;
85
+ threadId: string;
86
+ turnId: string;
87
+ }, {
53
88
  accepted: boolean;
54
89
  dispatchId: string;
55
90
  status: "queued" | "claimed" | "started" | "completed" | "failed" | "cancelled";
56
91
  turnId: string;
57
92
  }, Name>;
58
- claimNextTurnDispatch: FunctionReference<"mutation", "internal", Record<string, unknown>, {
93
+ getTurnDispatchState: FunctionReference<"query", "internal", {
94
+ actor: {
95
+ userId?: string;
96
+ };
97
+ dispatchId?: string;
98
+ threadId: string;
99
+ turnId?: string;
100
+ }, null | {
59
101
  attemptCount: number;
60
- claimToken: string;
102
+ cancelledAt?: number;
103
+ claimOwner?: string;
104
+ claimToken?: string;
105
+ completedAt?: number;
106
+ createdAt: number;
61
107
  dispatchId: string;
108
+ failureCode?: string;
109
+ failureReason?: string;
62
110
  idempotencyKey: string;
63
111
  inputText: string;
64
112
  leaseExpiresAt: number;
113
+ runtimeThreadId?: string;
114
+ runtimeTurnId?: string;
115
+ startedAt?: number;
116
+ status: "queued" | "claimed" | "started" | "completed" | "failed" | "cancelled";
117
+ turnId: string;
118
+ updatedAt: number;
119
+ }, Name>;
120
+ markTurnCompleted: FunctionReference<"mutation", "internal", {
121
+ actor: {
122
+ userId?: string;
123
+ };
124
+ claimToken: string;
125
+ dispatchId: string;
126
+ threadId: string;
127
+ }, null, Name>;
128
+ markTurnFailed: FunctionReference<"mutation", "internal", {
129
+ actor: {
130
+ userId?: string;
131
+ };
132
+ claimToken: string;
133
+ code?: string;
134
+ dispatchId: string;
135
+ reason: string;
136
+ threadId: string;
137
+ }, null, Name>;
138
+ markTurnStarted: FunctionReference<"mutation", "internal", {
139
+ actor: {
140
+ userId?: string;
141
+ };
142
+ claimToken: string;
143
+ dispatchId: string;
144
+ runtimeThreadId?: string;
145
+ runtimeTurnId?: string;
146
+ threadId: string;
147
+ }, null, Name>;
148
+ };
149
+ messages: {
150
+ getByTurn: FunctionReference<"query", "internal", {
151
+ actor: {
152
+ userId?: string;
153
+ };
154
+ threadId: string;
155
+ turnId: string;
156
+ }, Array<{
157
+ completedAt?: number;
158
+ createdAt: number;
159
+ error?: string;
160
+ messageId: string;
161
+ orderInTurn: number;
162
+ payloadJson: string;
163
+ role: "user" | "assistant" | "system" | "tool";
164
+ sourceItemType: string;
165
+ status: "streaming" | "completed" | "failed" | "interrupted";
166
+ text: string;
65
167
  turnId: string;
66
- } | null, Name>;
67
- markTurnStarted: FunctionReference<"mutation", "internal", Record<string, unknown>, null, Name>;
68
- markTurnCompleted: FunctionReference<"mutation", "internal", Record<string, unknown>, null, Name>;
69
- markTurnFailed: FunctionReference<"mutation", "internal", Record<string, unknown>, null, Name>;
70
- cancelTurnDispatch: FunctionReference<"mutation", "internal", Record<string, unknown>, null, Name>;
71
- getTurnDispatchState: FunctionReference<"query", "internal", Record<string, unknown>, unknown, Name>;
168
+ updatedAt: number;
169
+ }>, Name>;
170
+ listByThread: FunctionReference<"query", "internal", {
171
+ actor: {
172
+ userId?: string;
173
+ };
174
+ paginationOpts: {
175
+ cursor: string | null;
176
+ endCursor?: string | null;
177
+ id?: number;
178
+ maximumBytesRead?: number;
179
+ maximumRowsRead?: number;
180
+ numItems: number;
181
+ };
182
+ threadId: string;
183
+ }, any, Name>;
72
184
  };
73
- sync: {
74
- heartbeat: FunctionReference<"mutation", "internal", {
185
+ reasoning: {
186
+ listByThread: FunctionReference<"query", "internal", {
75
187
  actor: {
76
- deviceId: string;
77
- tenantId: string;
78
- userId: string;
188
+ userId?: string;
189
+ };
190
+ includeRaw?: boolean;
191
+ paginationOpts: {
192
+ cursor: string | null;
193
+ endCursor?: string | null;
194
+ id?: number;
195
+ maximumBytesRead?: number;
196
+ maximumRowsRead?: number;
197
+ numItems: number;
79
198
  };
80
- lastEventCursor: number;
81
- sessionId: string;
199
+ threadId: string;
200
+ }, any, Name>;
201
+ };
202
+ serverRequests: {
203
+ listPending: FunctionReference<"query", "internal", {
204
+ actor: {
205
+ userId?: string;
206
+ };
207
+ limit?: number;
208
+ threadId?: string;
209
+ }, any, Name>;
210
+ resolve: FunctionReference<"mutation", "internal", {
211
+ actor: {
212
+ userId?: string;
213
+ };
214
+ requestId: string | number;
215
+ resolvedAt: number;
216
+ responseJson?: string;
217
+ status: "answered" | "expired";
82
218
  threadId: string;
83
219
  }, null, Name>;
220
+ upsertPending: FunctionReference<"mutation", "internal", {
221
+ actor: {
222
+ userId?: string;
223
+ };
224
+ itemId: string;
225
+ method: "item/commandExecution/requestApproval" | "item/fileChange/requestApproval" | "item/tool/requestUserInput" | "item/tool/call";
226
+ payloadJson: string;
227
+ questionsJson?: string;
228
+ reason?: string;
229
+ requestId: string | number;
230
+ requestedAt: number;
231
+ threadId: string;
232
+ turnId: string;
233
+ }, null, Name>;
234
+ };
235
+ sync: {
84
236
  ensureSession: FunctionReference<"mutation", "internal", {
85
237
  actor: {
86
- deviceId: string;
87
- tenantId: string;
88
- userId: string;
238
+ userId?: string;
89
239
  };
90
240
  lastEventCursor: number;
91
241
  sessionId: string;
92
242
  threadId: string;
93
243
  }, {
94
244
  sessionId: string;
95
- status: "active" | "created";
245
+ status: "created" | "active";
96
246
  threadId: string;
97
247
  }, Name>;
98
- replay: FunctionReference<"query", "internal", {
248
+ heartbeat: FunctionReference<"mutation", "internal", {
99
249
  actor: {
100
- deviceId: string;
101
- tenantId: string;
102
- userId: string;
250
+ userId?: string;
103
251
  };
104
- runtime?: {
105
- finishedStreamDeleteDelayMs?: number;
106
- maxDeltasPerRequestRead?: number;
107
- maxDeltasPerStreamRead?: number;
108
- saveStreamDeltas?: boolean;
109
- };
110
- streamCursorsById: Array<{
111
- cursor: number;
112
- streamId: string;
113
- }>;
252
+ lastEventCursor: number;
253
+ sessionId: string;
114
254
  threadId: string;
115
- }, any, Name>;
255
+ }, null, Name>;
116
256
  ingest: FunctionReference<"mutation", "internal", {
117
257
  actor: {
118
- deviceId: string;
119
- tenantId: string;
120
- userId: string;
258
+ userId?: string;
121
259
  };
122
260
  lifecycleEvents: Array<{
123
261
  createdAt: number;
@@ -128,9 +266,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
128
266
  type: "lifecycle_event";
129
267
  }>;
130
268
  runtime?: {
269
+ exposeRawReasoningDeltas?: boolean;
131
270
  finishedStreamDeleteDelayMs?: number;
132
271
  maxDeltasPerRequestRead?: number;
133
272
  maxDeltasPerStreamRead?: number;
273
+ saveReasoningDeltas?: boolean;
134
274
  saveStreamDeltas?: boolean;
135
275
  };
136
276
  sessionId: string;
@@ -155,9 +295,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
155
295
  }, Name>;
156
296
  ingestSafe: FunctionReference<"mutation", "internal", {
157
297
  actor: {
158
- deviceId: string;
159
- tenantId: string;
160
- userId: string;
298
+ userId?: string;
161
299
  };
162
300
  ensureLastEventCursor?: number;
163
301
  lifecycleEvents: Array<{
@@ -169,9 +307,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
169
307
  type: "lifecycle_event";
170
308
  }>;
171
309
  runtime?: {
310
+ exposeRawReasoningDeltas?: boolean;
172
311
  finishedStreamDeleteDelayMs?: number;
173
312
  maxDeltasPerRequestRead?: number;
174
313
  maxDeltasPerStreamRead?: number;
314
+ saveReasoningDeltas?: boolean;
175
315
  saveStreamDeltas?: boolean;
176
316
  };
177
317
  sessionId: string;
@@ -193,7 +333,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
193
333
  streamId: string;
194
334
  }>;
195
335
  errors: Array<{
196
- code: "OUT_OF_ORDER" | "REPLAY_GAP" | "SESSION_DEVICE_MISMATCH" | "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "UNKNOWN";
336
+ code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
197
337
  message: string;
198
338
  recoverable: boolean;
199
339
  }>;
@@ -203,81 +343,63 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
203
343
  sessionId: string;
204
344
  threadId: string;
205
345
  };
206
- status: "ok" | "partial" | "rejected" | "session_recovered";
346
+ status: "ok" | "partial" | "session_recovered" | "rejected";
207
347
  }, Name>;
208
348
  listCheckpoints: FunctionReference<"query", "internal", {
209
349
  actor: {
210
- deviceId: string;
211
- tenantId: string;
212
- userId: string;
350
+ userId?: string;
213
351
  };
214
352
  threadId: string;
215
- }, Array<{
216
- cursor: number;
217
- streamId: string;
218
- }>, Name>;
219
- upsertCheckpoint: FunctionReference<"mutation", "internal", {
353
+ }, any, Name>;
354
+ replay: FunctionReference<"query", "internal", {
220
355
  actor: {
221
- deviceId: string;
222
- tenantId: string;
223
- userId: string;
356
+ userId?: string;
224
357
  };
225
- cursor: number;
226
- streamId: string;
358
+ runtime?: {
359
+ exposeRawReasoningDeltas?: boolean;
360
+ finishedStreamDeleteDelayMs?: number;
361
+ maxDeltasPerRequestRead?: number;
362
+ maxDeltasPerStreamRead?: number;
363
+ saveReasoningDeltas?: boolean;
364
+ saveStreamDeltas?: boolean;
365
+ };
366
+ streamCursorsById: Array<{
367
+ cursor: number;
368
+ streamId: string;
369
+ }>;
227
370
  threadId: string;
228
- }, {
229
- ok: true;
230
- }, Name>;
371
+ }, any, Name>;
231
372
  resumeReplay: FunctionReference<"query", "internal", {
232
373
  actor: {
233
- deviceId: string;
234
- tenantId: string;
235
- userId: string;
374
+ userId?: string;
236
375
  };
237
376
  fromCursor: number;
238
377
  runtime?: {
378
+ exposeRawReasoningDeltas?: boolean;
239
379
  finishedStreamDeleteDelayMs?: number;
240
380
  maxDeltasPerRequestRead?: number;
241
381
  maxDeltasPerStreamRead?: number;
382
+ saveReasoningDeltas?: boolean;
242
383
  saveStreamDeltas?: boolean;
243
384
  };
244
385
  threadId: string;
245
386
  turnId: string;
246
387
  }, any, Name>;
247
- };
248
- messages: {
249
- listByThread: FunctionReference<"query", "internal", {
250
- actor: {
251
- deviceId: string;
252
- tenantId: string;
253
- userId: string;
254
- };
255
- paginationOpts: {
256
- cursor: string | null;
257
- endCursor?: string | null;
258
- id?: number;
259
- maximumBytesRead?: number;
260
- maximumRowsRead?: number;
261
- numItems: number;
262
- };
263
- threadId: string;
264
- }, any, Name>;
265
- getByTurn: FunctionReference<"query", "internal", {
388
+ upsertCheckpoint: FunctionReference<"mutation", "internal", {
266
389
  actor: {
267
- deviceId: string;
268
- tenantId: string;
269
- userId: string;
390
+ userId?: string;
270
391
  };
392
+ cursor: number;
393
+ streamId: string;
271
394
  threadId: string;
272
- turnId: string;
273
- }, any, Name>;
395
+ }, {
396
+ ok: true;
397
+ }, Name>;
274
398
  };
275
399
  threads: {
276
400
  create: FunctionReference<"mutation", "internal", {
277
401
  actor: {
278
- deviceId: string;
279
- tenantId: string;
280
- userId: string;
402
+ userId?: string;
281
403
  };
282
404
  cwd?: string;
283
405
  localThreadId?: string;
@@ -285,30 +407,71 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
285
407
  personality?: string;
286
408
  threadId: string;
287
409
  }, any, Name>;
288
- getState: FunctionReference<"query", "internal", {
410
+ getExternalMapping: FunctionReference<"query", "internal", {
289
411
  actor: {
290
- deviceId: string;
291
- tenantId: string;
292
- userId: string;
412
+ userId?: string;
293
413
  };
294
414
  threadId: string;
295
- }, any, Name>;
296
- getExternalMapping: FunctionReference<"query", "internal", {
415
+ }, null | {
416
+ externalThreadId: string;
417
+ threadId: string;
418
+ }, Name>;
419
+ getState: FunctionReference<"query", "internal", {
297
420
  actor: {
298
- deviceId: string;
299
- tenantId: string;
300
- userId: string;
421
+ userId?: string;
301
422
  };
302
423
  threadId: string;
303
424
  }, {
304
- externalThreadId: string;
425
+ activeStreams: Array<{
426
+ state: string;
427
+ streamId: string;
428
+ }>;
429
+ allStreams: Array<{
430
+ state: string;
431
+ streamId: string;
432
+ }>;
433
+ dispatches: Array<{
434
+ attemptCount: number;
435
+ claimOwner?: string;
436
+ createdAt: number;
437
+ dispatchId: string;
438
+ failureCode?: string;
439
+ failureReason?: string;
440
+ leaseExpiresAt: number;
441
+ status: "queued" | "claimed" | "started" | "completed" | "failed" | "cancelled";
442
+ turnId: string;
443
+ updatedAt: number;
444
+ }>;
445
+ pendingApprovals: Array<{
446
+ itemId: string;
447
+ kind: string;
448
+ reason?: string;
449
+ }>;
450
+ recentMessages: Array<{
451
+ createdAt: number;
452
+ messageId: string;
453
+ role: "user" | "assistant" | "system" | "tool";
454
+ status: "streaming" | "completed" | "failed" | "interrupted";
455
+ text: string;
456
+ turnId: string;
457
+ }>;
458
+ streamStats: Array<{
459
+ deltaCount: number;
460
+ latestCursor: number;
461
+ state: "streaming" | "finished" | "aborted";
462
+ streamId: string;
463
+ }>;
305
464
  threadId: string;
306
- } | null, Name>;
465
+ threadStatus: string;
466
+ turns: Array<{
467
+ startedAt: number;
468
+ status: string;
469
+ turnId: string;
470
+ }>;
471
+ }, Name>;
307
472
  list: FunctionReference<"query", "internal", {
308
473
  actor: {
309
- deviceId: string;
310
- tenantId: string;
311
- userId: string;
474
+ userId?: string;
312
475
  };
313
476
  paginationOpts: {
314
477
  cursor: string | null;
@@ -321,9 +484,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
321
484
  }, any, Name>;
322
485
  resolve: FunctionReference<"mutation", "internal", {
323
486
  actor: {
324
- deviceId: string;
325
- tenantId: string;
326
- userId: string;
487
+ userId?: string;
327
488
  };
328
489
  cwd?: string;
329
490
  externalThreadId?: string;
@@ -337,20 +498,16 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
337
498
  }, Name>;
338
499
  resolveByExternalId: FunctionReference<"query", "internal", {
339
500
  actor: {
340
- deviceId: string;
341
- tenantId: string;
342
- userId: string;
501
+ userId?: string;
343
502
  };
344
503
  externalThreadId: string;
345
- }, {
504
+ }, null | {
346
505
  externalThreadId: string;
347
506
  threadId: string;
348
- } | null, Name>;
507
+ }, Name>;
349
508
  resume: FunctionReference<"mutation", "internal", {
350
509
  actor: {
351
- deviceId: string;
352
- tenantId: string;
353
- userId: string;
510
+ userId?: string;
354
511
  };
355
512
  threadId: string;
356
513
  }, any, Name>;
@@ -358,9 +515,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
358
515
  turns: {
359
516
  interrupt: FunctionReference<"mutation", "internal", {
360
517
  actor: {
361
- deviceId: string;
362
- tenantId: string;
363
- userId: string;
518
+ userId?: string;
364
519
  };
365
520
  reason?: string;
366
521
  threadId: string;
@@ -368,9 +523,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
368
523
  }, null, Name>;
369
524
  start: FunctionReference<"mutation", "internal", {
370
525
  actor: {
371
- deviceId: string;
372
- tenantId: string;
373
- userId: string;
526
+ userId?: string;
374
527
  };
375
528
  idempotencyKey: string;
376
529
  input: Array<{