@zakstam/codex-local-component 0.6.0 → 0.7.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 (36) hide show
  1. package/LLMS.md +103 -0
  2. package/README.md +25 -249
  3. package/dist/host/convex-entry.d.ts +4 -1
  4. package/dist/host/convex-entry.d.ts.map +1 -1
  5. package/dist/host/convex-entry.js +3 -0
  6. package/dist/host/convex-entry.js.map +1 -1
  7. package/dist/host/convexPreset.d.ts +1526 -0
  8. package/dist/host/convexPreset.d.ts.map +1 -0
  9. package/dist/host/convexPreset.js +516 -0
  10. package/dist/host/convexPreset.js.map +1 -0
  11. package/dist/host/convexSlice.d.ts +36 -24
  12. package/dist/host/convexSlice.d.ts.map +1 -1
  13. package/dist/host/convexSlice.js.map +1 -1
  14. package/dist/host/index.d.ts +4 -1
  15. package/dist/host/index.d.ts.map +1 -1
  16. package/dist/host/index.js +3 -0
  17. package/dist/host/index.js.map +1 -1
  18. package/dist/host/surfaceGenerator.d.ts +18 -0
  19. package/dist/host/surfaceGenerator.d.ts.map +1 -0
  20. package/dist/host/surfaceGenerator.js +56 -0
  21. package/dist/host/surfaceGenerator.js.map +1 -0
  22. package/dist/host/surfaceManifest.d.ts +27 -0
  23. package/dist/host/surfaceManifest.d.ts.map +1 -0
  24. package/dist/host/surfaceManifest.js +78 -0
  25. package/dist/host/surfaceManifest.js.map +1 -0
  26. package/dist/host/wrapDefinitions.d.ts +17 -0
  27. package/dist/host/wrapDefinitions.d.ts.map +1 -0
  28. package/dist/host/wrapDefinitions.js +18 -0
  29. package/dist/host/wrapDefinitions.js.map +1 -0
  30. package/docs/CLIENT_AND_REACT_HOOKS.md +92 -0
  31. package/docs/DISPATCH_MANAGED_REFERENCE_HOST.md +59 -0
  32. package/docs/HOST_INTEGRATION.md +81 -0
  33. package/docs/HOST_PRESET_MATRIX.md +72 -0
  34. package/docs/OPERATIONS_AND_ERRORS.md +63 -0
  35. package/docs/RUNTIME_OWNED_REFERENCE_HOST.md +54 -0
  36. package/package.json +8 -3
package/LLMS.md ADDED
@@ -0,0 +1,103 @@
1
+ # LLMS: Canonical Consumer Integration (Single Path)
2
+
3
+ Canonical default: runtime-owned host integration (`dispatchManaged: false`).
4
+
5
+ ## Hard Rule
6
+
7
+ - Follow this file as the only default implementation strategy.
8
+ - Do not implement dispatch-managed orchestration unless explicitly requested.
9
+ - Do not handwrite host wrapper surfaces; generate them.
10
+ - Always use app-generated Convex types from `./_generated/api` and `./_generated/server`.
11
+
12
+ ## Required Implementation Steps
13
+
14
+ 1. Install package dependencies.
15
+
16
+ ```bash
17
+ pnpm add @zakstam/codex-local-component convex
18
+ ```
19
+
20
+ 2. Mount the component in `convex/convex.config.ts`.
21
+
22
+ ```ts
23
+ import { defineApp } from "convex/server";
24
+ import codexLocal from "@zakstam/codex-local-component/convex.config";
25
+
26
+ const app = defineApp();
27
+ app.use(codexLocal);
28
+
29
+ export default app;
30
+ ```
31
+
32
+ 3. Generate host surfaces from the canonical manifest.
33
+
34
+ ```bash
35
+ pnpm run host:generate
36
+ ```
37
+
38
+ 4. Keep host files in this split:
39
+
40
+ - `convex/chat.generated.ts`: generated preset wrappers (do not edit)
41
+ - `convex/chat.extensions.ts`: app-owned custom endpoints
42
+ - `convex/chat.ts`: stable entrypoint (`export *` from generated + extensions)
43
+
44
+ 5. Use runtime-owned host preset behavior only.
45
+
46
+ - Generated wrappers are based on `defineRuntimeOwnedHostSlice(...)`.
47
+ - Runtime startup must be explicit runtime-owned:
48
+
49
+ ```ts
50
+ await runtime.start({
51
+ actor,
52
+ sessionId,
53
+ dispatchManaged: false,
54
+ threadStrategy: "start",
55
+ });
56
+ ```
57
+
58
+ 6. Start turns through `runtime.sendTurn(text)`.
59
+
60
+ - Do not call `startClaimedTurn` in the canonical path.
61
+
62
+ 7. Validate host wiring during startup.
63
+
64
+ - Query `chat.validateHostWiring` once at process boot.
65
+ - Fail fast if `ok` is `false`.
66
+
67
+ 8. Use canonical host query/mutation endpoints in React hooks.
68
+
69
+ - `useCodexMessages` -> `chat.listThreadMessagesForHooks`
70
+ - `useCodexTurn` -> `chat.listTurnMessagesForHooks`
71
+ - `useCodexApprovals` -> `chat.listPendingApprovalsForHooks` + `chat.respondApprovalForHooks`
72
+ - `useCodexComposer` -> `chat.enqueueTurnDispatch`
73
+
74
+ ## Required Consumer Commands
75
+
76
+ From repo root (or equivalent monorepo command wrappers):
77
+
78
+ ```bash
79
+ pnpm run host:generate
80
+ pnpm run host:check
81
+ ```
82
+
83
+ From each host app:
84
+
85
+ ```bash
86
+ pnpm run dev:convex:once
87
+ pnpm run wiring:smoke
88
+ pnpm run typecheck
89
+ ```
90
+
91
+ ## Required Host Surface Ownership
92
+
93
+ - Generated surface owns preset endpoint exports.
94
+ - Extensions file owns only app-specific endpoints.
95
+ - Entrypoint file owns only re-exports.
96
+
97
+ If an endpoint belongs to preset behavior, add it in the package preset/manifest and regenerate. Do not manually patch generated host files.
98
+
99
+ ## Advanced Appendix (Non-Default)
100
+
101
+ Dispatch-managed orchestration is advanced and non-default. Reference only when explicitly requested:
102
+
103
+ - `docs/DISPATCH_MANAGED_REFERENCE_HOST.md`
package/README.md CHANGED
@@ -2,7 +2,9 @@
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/%40zakstam%2Fcodex-local-component)](https://www.npmjs.com/package/@zakstam/codex-local-component)
4
4
 
5
- Convex component for Codex integrations where Codex runs locally on the user's machine (desktop/CLI), while thread state, messages, approvals, and stream recovery live in Convex.
5
+ Convex component for Codex integrations where Codex runs locally while thread state, messages, approvals, and replay are persisted in Convex.
6
+
7
+ Canonical default: runtime-owned host integration (`dispatchManaged: false`).
6
8
 
7
9
  ## Install
8
10
 
@@ -12,214 +14,25 @@ pnpm add @zakstam/codex-local-component convex
12
14
 
13
15
  React hooks require `react` peer dependency (`^18` or `^19`).
14
16
 
15
- ## Integration Contract (Read First)
16
-
17
- 1. Always use generated Convex types from your app:
18
- - `./_generated/api`
19
- - `./_generated/server`
20
- 2. Mount the component once with `app.use(codexLocal)`.
21
- 3. In Convex server files, use `@zakstam/codex-local-component/host/convex` helper exports.
22
- 4. Treat `actor` (`tenantId`, `userId`, `deviceId`) as trusted server identity, not untrusted client input.
23
- 5. Before ingesting events on startup/reconnect, call `sync.ensureSession`.
24
- 6. For runtime ingest, prefer `sync.ingestSafe` (`ingestBatchMixed` uses this).
25
- 7. Runtime dispatch ownership must be explicit:
26
- - `dispatchManaged: false` -> runtime orchestrates via `sendTurn`
27
- - `dispatchManaged: true` -> external worker orchestrates and runtime executes via `startClaimedTurn`
28
- 8. Convex-deployed code should not import `@zakstam/codex-local-component/protocol/parser` (Ajv runtime validation). Use host wrappers and `protocol/events`-based helpers only.
29
-
30
- ## Golden Path
31
-
32
- ### 1) Mount the component
33
-
34
- ```ts
35
- // convex/convex.config.ts
36
- import { defineApp } from "convex/server";
37
- import codexLocal from "@zakstam/codex-local-component/convex.config";
38
-
39
- const app = defineApp();
40
- app.use(codexLocal);
41
-
42
- export default app;
43
- ```
44
-
45
- Run `npx convex dev` once so `components.codexLocal.*` is generated.
46
-
47
- ### 2) Add host wrappers (`convex/chat.ts`)
48
-
49
- ```ts
50
- import { paginationOptsValidator } from "convex/server";
51
- import { v } from "convex/values";
52
- import { mutation, query } from "./_generated/server";
53
- import { components } from "./_generated/api";
54
- import {
55
- enqueueTurnDispatchForActor,
56
- ensureSession as ensureSessionHandler,
57
- ensureThreadByCreate,
58
- ingestBatchMixed,
59
- listThreadMessagesForHooksForActor,
60
- vHostEnqueueTurnDispatchResult,
61
- vHostActorContext,
62
- vHostEnsureSessionResult,
63
- vHostIngestSafeResult,
64
- vHostLifecycleInboundEvent,
65
- vHostStreamArgs,
66
- vHostStreamInboundEvent,
67
- vHostSyncRuntimeOptions,
68
- } from "@zakstam/codex-local-component/host/convex";
69
-
70
- const SERVER_ACTOR = {
71
- tenantId: process.env.ACTOR_TENANT_ID ?? "demo-tenant",
72
- userId: process.env.ACTOR_USER_ID ?? "demo-user",
73
- deviceId: process.env.ACTOR_DEVICE_ID ?? "server-device",
74
- };
75
-
76
- export const ensureThread = mutation({
77
- args: { actor: vHostActorContext, threadId: v.string() },
78
- handler: async (ctx, args) => ensureThreadByCreate(ctx, components.codexLocal, args),
79
- });
80
-
81
- export const enqueueTurnDispatch = mutation({
82
- args: {
83
- actor: vHostActorContext,
84
- threadId: v.string(),
85
- turnId: v.string(),
86
- idempotencyKey: v.string(),
87
- input: v.array(
88
- v.object({
89
- type: v.string(),
90
- text: v.optional(v.string()),
91
- url: v.optional(v.string()),
92
- path: v.optional(v.string()),
93
- }),
94
- ),
95
- },
96
- returns: vHostEnqueueTurnDispatchResult,
97
- handler: async (ctx, args) =>
98
- enqueueTurnDispatchForActor(ctx, components.codexLocal, args),
99
- });
100
-
101
- export const ensureSession = mutation({
102
- args: { actor: vHostActorContext, sessionId: v.string(), threadId: v.string() },
103
- returns: vHostEnsureSessionResult,
104
- handler: async (ctx, args) => ensureSessionHandler(ctx, components.codexLocal, args),
105
- });
106
-
107
- export const ingestBatch = mutation({
108
- args: {
109
- actor: vHostActorContext,
110
- sessionId: v.string(),
111
- threadId: v.string(),
112
- deltas: v.array(v.union(vHostStreamInboundEvent, vHostLifecycleInboundEvent)),
113
- runtime: v.optional(vHostSyncRuntimeOptions),
114
- },
115
- returns: vHostIngestSafeResult,
116
- handler: async (ctx, args) => ingestBatchMixed(ctx, components.codexLocal, args),
117
- });
118
-
119
- export const listThreadMessagesForHooks = query({
120
- args: {
121
- actor: vHostActorContext,
122
- threadId: v.string(),
123
- paginationOpts: paginationOptsValidator,
124
- streamArgs: vHostStreamArgs,
125
- runtime: v.optional(vHostSyncRuntimeOptions),
126
- },
127
- handler: async (ctx, args) =>
128
- listThreadMessagesForHooksForActor(ctx, components.codexLocal, {
129
- actor: SERVER_ACTOR,
130
- threadId: args.threadId,
131
- paginationOpts: args.paginationOpts,
132
- streamArgs: args.streamArgs,
133
- runtime: args.runtime,
134
- }),
135
- });
136
- ```
137
-
138
- ### 3) Run bridge loop (desktop/CLI process)
139
-
140
- ```ts
141
- import { randomUUID } from "node:crypto";
142
- import { ConvexHttpClient } from "convex/browser";
143
- import { CodexLocalBridge } from "@zakstam/codex-local-component/bridge";
144
- import { api } from "../convex/_generated/api.js";
145
-
146
- const convex = new ConvexHttpClient(process.env.CONVEX_URL!);
147
- const actor = { tenantId: "demo", userId: "demo", deviceId: "local-1" };
148
- const sessionId = randomUUID();
149
- let threadId: string | null = null;
150
-
151
- const bridge = new CodexLocalBridge(
152
- { cwd: process.cwd() },
153
- {
154
- onEvent: async (event) => {
155
- if (!threadId) {
156
- threadId = event.threadId;
157
- await convex.mutation(api.chat.ensureThread, { actor, threadId });
158
- await convex.mutation(api.chat.ensureSession, { actor, sessionId, threadId });
159
- }
17
+ ## Canonical Implementation
160
18
 
161
- await convex.mutation(api.chat.ingestBatch, {
162
- actor,
163
- sessionId,
164
- threadId: event.threadId,
165
- deltas: [event],
166
- });
167
- },
168
- onGlobalMessage: async () => {
169
- // handle non-thread protocol messages (auth/config/etc)
170
- },
171
- onProtocolError: async ({ error, line }) => {
172
- console.error("protocol error", error.message, line);
173
- },
174
- },
175
- );
19
+ Use one source of truth for implementation steps:
176
20
 
177
- bridge.start();
178
- ```
179
-
180
- ### 4) Wire React hooks
181
-
182
- ```tsx
183
- import { useCodexMessages } from "@zakstam/codex-local-component/react";
184
- import { api } from "../convex/_generated/api";
185
-
186
- const actor = { tenantId: "demo", userId: "demo", deviceId: "web-1" };
187
-
188
- export function Chat({ threadId }: { threadId: string }) {
189
- const messages = useCodexMessages(
190
- api.chat.listThreadMessagesForHooks,
191
- { actor, threadId },
192
- { initialNumItems: 30, stream: true },
193
- );
194
-
195
- return (
196
- <div>
197
- {messages.results.map((msg) => (
198
- <div key={msg._id}>{msg.text}</div>
199
- ))}
200
- </div>
201
- );
202
- }
203
- ```
204
-
205
- ## Required Query Contract for `useCodexMessages`
206
-
207
- Your host query must:
208
-
209
- - accept `threadId`, `paginationOpts`, optional `streamArgs`
210
- - return durable paginated messages plus optional `streams`
211
-
212
- `streamArgs`:
21
+ - `./LLMS.md`
213
22
 
214
- - `{ kind: "list", startOrder?: number }`
215
- - `{ kind: "deltas", cursors: Array<{ streamId: string; cursor: number }> }`
23
+ That file is the normative, single-path consumer strategy.
216
24
 
217
- Delta stream response shape includes:
25
+ ## Quickstart Summary
218
26
 
219
- - `streams`
220
- - `deltas`
221
- - `streamWindows` (`ok | rebased | stale`)
222
- - `nextCheckpoints`
27
+ 1. Mount component in `convex/convex.config.ts` with `app.use(codexLocal)`.
28
+ 2. Generate host surfaces with `pnpm run host:generate`.
29
+ 3. Keep host split:
30
+ - `convex/chat.generated.ts` (generated)
31
+ - `convex/chat.extensions.ts` (app-owned)
32
+ - `convex/chat.ts` (re-exports)
33
+ 4. Start runtime in runtime-owned mode (`dispatchManaged: false`).
34
+ 5. Call `chat.validateHostWiring` at startup.
35
+ 6. Use `@zakstam/codex-local-component/react` hooks against canonical host endpoints.
223
36
 
224
37
  ## Package Import Paths
225
38
 
@@ -231,54 +44,17 @@ Delta stream response shape includes:
231
44
  - `@zakstam/codex-local-component/app-server`
232
45
  - `@zakstam/codex-local-component/protocol`
233
46
 
234
- ## Dispatch v0.5 Canonical Mode
47
+ ## Docs Map
235
48
 
236
- Use one orchestration owner per runtime instance:
237
-
238
- - Runtime-owned mode: `createCodexHostRuntime(...).start({ dispatchManaged: false, ... })` and call `sendTurn(text)`.
239
- - External dispatch mode: `start({ dispatchManaged: true, ... })`, enqueue/claim via dispatch wrappers, then call `startClaimedTurn({ dispatchId, claimToken, turnId, inputText })`.
240
-
241
- Guardrail: mixing both APIs in one mode throws explicit runtime error codes (`E_RUNTIME_DISPATCH_*`).
242
-
243
- Reference guides:
244
-
245
- - `docs/RUNTIME_OWNED_REFERENCE_HOST.md` for `dispatchManaged: false`.
246
- - `docs/DISPATCH_MANAGED_REFERENCE_HOST.md` for `dispatchManaged: true`.
247
-
248
- ## Implemented
249
-
250
- - Initialization handshake
251
- - Thread lifecycle (create, resolve, resume, fork, archive, rollback)
252
- - Turn lifecycle (start, interrupt, idempotency)
253
- - Streamed event ingest and replay with cursor-based sync
254
- - Session lifecycle (`ensureSession`, heartbeat, recovery)
255
- - Account/Auth API surface (`account/read`, `account/login/start`, `account/login/cancel`, `account/logout`, `account/rateLimits/read`)
256
- - Command execution and file change approval flows
257
- - Tool user input flow
258
- - Dynamic tool call response flow
259
- - ChatGPT auth-token refresh response flow (`account/chatgptAuthTokens/refresh`)
260
- - Multi-device stream checkpoints with TTL cleanup
261
-
262
- ## Not Implemented Yet
263
-
264
- - Config management API surface
265
- - MCP management API surface
266
- - Core runtime utility APIs (`command/exec`, `model/list`, `review/start`)
267
- - Skill/App discovery and configuration APIs
268
- - Feedback API
269
- - Collaboration mode listing
270
-
271
- ## Docs
272
-
273
- - `docs/HOST_INTEGRATION.md`
274
- - `docs/RUNTIME_OWNED_REFERENCE_HOST.md`
275
- - `docs/DISPATCH_MANAGED_REFERENCE_HOST.md`
276
- - `docs/CLIENT_AND_REACT_HOOKS.md`
277
- - `docs/OPERATIONS_AND_ERRORS.md`
49
+ - Canonical implementation: `./LLMS.md`
50
+ - Host details (aligned to canonical path): `docs/HOST_INTEGRATION.md`
51
+ - Client and hooks contracts: `docs/CLIENT_AND_REACT_HOOKS.md`
52
+ - Operations and errors: `docs/OPERATIONS_AND_ERRORS.md`
53
+ - Reference matrix: `docs/HOST_PRESET_MATRIX.md`
54
+ - Advanced appendix (non-default): `docs/DISPATCH_MANAGED_REFERENCE_HOST.md`
55
+ - Runtime-owned reference details: `docs/RUNTIME_OWNED_REFERENCE_HOST.md`
278
56
 
279
57
  ## Type Safety Checks
280
58
 
281
59
  - `pnpm --filter @zakstam/codex-local-component run typecheck`
282
60
  - `pnpm --filter @zakstam/codex-local-component run check:unsafe-types`
283
-
284
- `check:unsafe-types` fails on handwritten-source `any` usage and on new casts outside `scripts/unsafe-cast-allowlist.txt` (generated files excluded).
@@ -1,4 +1,7 @@
1
+ export { defineDispatchManagedHostSlice, defineRuntimeOwnedHostSlice, type CodexHostSliceFeatures, type CodexHostSliceIngestMode, type CodexHostSliceProfile, type CodexHostSliceThreadMode, type DefineDispatchManagedHostSliceOptions, type DefineRuntimeOwnedHostSliceOptions, type DispatchManagedHostDefinitions, type RuntimeOwnedHostDefinitions, } from "./convexPreset.js";
2
+ export { wrapHostDefinitions } from "./wrapDefinitions.js";
3
+ export { HOST_PRESET_DEFINITIONS, HOST_SURFACE_MANIFEST, type HostSurfaceProfile, type HostSurfaceMutationKey, type HostSurfaceQueryKey, } from "./surfaceManifest.js";
1
4
  export { ingestBatchSafe, listThreadMessagesForHooks, listThreadReasoningForHooks, type HostInboundLifecycleEvent, type HostInboundStreamDelta, type HostMessagesForHooksArgs, type HostReasoningForHooksArgs, type HostStreamArgs, type HostSyncRuntimeOptions, } from "./convex.js";
2
5
  export { normalizeInboundDeltas, type NormalizedInboundDelta, type NormalizedInboundLifecycleEvent, type NormalizedInboundStreamDelta, } from "./normalizeInboundDeltas.js";
3
- export { computeDataHygiene, computeDurableHistoryStats, computePersistenceStats, enqueueTurnDispatchForActor, claimNextTurnDispatchForActor, markTurnDispatchStartedForActor, markTurnDispatchCompletedForActor, markTurnDispatchFailedForActor, cancelTurnDispatchForActor, getTurnDispatchStateForActor, dispatchObservabilityForActor, dataHygiene, durableHistoryStats, ensureSession, ensureThreadByCreate, ensureThreadByResolve, ingestBatchMixed, ingestBatchStreamOnly, ingestEventMixed, ingestEventStreamOnly, interruptTurnForHooksForActor, isStreamStatSummary, listPendingApprovalsForHooksForActor, listPendingServerRequestsForHooksForActor, listThreadMessagesForHooksForActor, listThreadReasoningForHooksForActor, listTurnMessagesForHooksForActor, persistenceStats, respondApprovalForHooksForActor, resolvePendingServerRequestForHooksForActor, threadSnapshot, upsertPendingServerRequestForHooksForActor, vHostActorContext, vHostDataHygiene, vHostDurableHistoryStats, vHostDispatchStatus, vHostDispatchObservability, vHostEnqueueTurnDispatchResult, vHostClaimedTurnDispatch, vHostTurnDispatchState, vHostTurnInput, vHostEnsureSessionResult, vHostInboundEvent, vHostIngestSafeResult, vHostLifecycleInboundEvent, vHostPersistenceStats, vHostStreamArgs, vHostStreamInboundEvent, vHostSyncRuntimeOptions, type HostActorContext, } from "./convexSlice.js";
6
+ export { computeDataHygiene, computeDurableHistoryStats, computePersistenceStats, enqueueTurnDispatchForActor, claimNextTurnDispatchForActor, markTurnDispatchStartedForActor, markTurnDispatchCompletedForActor, markTurnDispatchFailedForActor, cancelTurnDispatchForActor, getTurnDispatchStateForActor, dispatchObservabilityForActor, dataHygiene, durableHistoryStats, ensureSession, ensureThreadByCreate, ensureThreadByResolve, ingestBatchMixed, ingestBatchStreamOnly, ingestEventMixed, ingestEventStreamOnly, interruptTurnForHooksForActor, isStreamStatSummary, listPendingApprovalsForHooksForActor, listPendingServerRequestsForHooksForActor, listThreadMessagesForHooksForActor, listThreadReasoningForHooksForActor, listTurnMessagesForHooksForActor, persistenceStats, respondApprovalForHooksForActor, resolvePendingServerRequestForHooksForActor, threadSnapshot, upsertPendingServerRequestForHooksForActor, vHostActorContext, vHostDataHygiene, vHostDurableHistoryStats, vHostDispatchStatus, vHostDispatchObservability, vHostEnqueueTurnDispatchResult, vHostClaimedTurnDispatch, vHostTurnDispatchState, vHostTurnInput, vHostEnsureSessionResult, vHostInboundEvent, vHostIngestSafeResult, vHostLifecycleInboundEvent, vHostPersistenceStats, vHostStreamArgs, vHostStreamInboundEvent, vHostSyncRuntimeOptions, type CodexHostComponentRefs, type CodexHostComponentsInput, type HostActorContext, } from "./convexSlice.js";
4
7
  //# sourceMappingURL=convex-entry.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"convex-entry.d.ts","sourceRoot":"","sources":["../../src/host/convex-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,oCAAoC,EACpC,yCAAyC,EACzC,kCAAkC,EAClC,mCAAmC,EACnC,gCAAgC,EAChC,gBAAgB,EAChB,+BAA+B,EAC/B,2CAA2C,EAC3C,cAAc,EACd,0CAA0C,EAC1C,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"convex-entry.d.ts","sourceRoot":"","sources":["../../src/host/convex-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,qCAAqC,EAC1C,KAAK,kCAAkC,EACvC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,GACjC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,oCAAoC,EACpC,yCAAyC,EACzC,kCAAkC,EAClC,mCAAmC,EACnC,gCAAgC,EAChC,gBAAgB,EAChB,+BAA+B,EAC/B,2CAA2C,EAC3C,cAAc,EACd,0CAA0C,EAC1C,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC"}
@@ -1,3 +1,6 @@
1
+ export { defineDispatchManagedHostSlice, defineRuntimeOwnedHostSlice, } from "./convexPreset.js";
2
+ export { wrapHostDefinitions } from "./wrapDefinitions.js";
3
+ export { HOST_PRESET_DEFINITIONS, HOST_SURFACE_MANIFEST, } from "./surfaceManifest.js";
1
4
  export { ingestBatchSafe, listThreadMessagesForHooks, listThreadReasoningForHooks, } from "./convex.js";
2
5
  export { normalizeInboundDeltas, } from "./normalizeInboundDeltas.js";
3
6
  export { computeDataHygiene, computeDurableHistoryStats, computePersistenceStats, enqueueTurnDispatchForActor, claimNextTurnDispatchForActor, markTurnDispatchStartedForActor, markTurnDispatchCompletedForActor, markTurnDispatchFailedForActor, cancelTurnDispatchForActor, getTurnDispatchStateForActor, dispatchObservabilityForActor, dataHygiene, durableHistoryStats, ensureSession, ensureThreadByCreate, ensureThreadByResolve, ingestBatchMixed, ingestBatchStreamOnly, ingestEventMixed, ingestEventStreamOnly, interruptTurnForHooksForActor, isStreamStatSummary, listPendingApprovalsForHooksForActor, listPendingServerRequestsForHooksForActor, listThreadMessagesForHooksForActor, listThreadReasoningForHooksForActor, listTurnMessagesForHooksForActor, persistenceStats, respondApprovalForHooksForActor, resolvePendingServerRequestForHooksForActor, threadSnapshot, upsertPendingServerRequestForHooksForActor, vHostActorContext, vHostDataHygiene, vHostDurableHistoryStats, vHostDispatchStatus, vHostDispatchObservability, vHostEnqueueTurnDispatchResult, vHostClaimedTurnDispatch, vHostTurnDispatchState, vHostTurnInput, vHostEnsureSessionResult, vHostInboundEvent, vHostIngestSafeResult, vHostLifecycleInboundEvent, vHostPersistenceStats, vHostStreamArgs, vHostStreamInboundEvent, vHostSyncRuntimeOptions, } from "./convexSlice.js";
@@ -1 +1 @@
1
- {"version":3,"file":"convex-entry.js","sourceRoot":"","sources":["../../src/host/convex-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,GAO5B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,GAIvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,oCAAoC,EACpC,yCAAyC,EACzC,kCAAkC,EAClC,mCAAmC,EACnC,gCAAgC,EAChC,gBAAgB,EAChB,+BAA+B,EAC/B,2CAA2C,EAC3C,cAAc,EACd,0CAA0C,EAC1C,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"convex-entry.js","sourceRoot":"","sources":["../../src/host/convex-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,GAS5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GAItB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,GAO5B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,GAIvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,EAC7B,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,oCAAoC,EACpC,yCAAyC,EACzC,kCAAkC,EAClC,mCAAmC,EACnC,gCAAgC,EAChC,gBAAgB,EAChB,+BAA+B,EAC/B,2CAA2C,EAC3C,cAAc,EACd,0CAA0C,EAC1C,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,GAIxB,MAAM,kBAAkB,CAAC"}