@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.
- package/LLMS.md +103 -0
- package/README.md +25 -249
- package/dist/host/convex-entry.d.ts +4 -1
- package/dist/host/convex-entry.d.ts.map +1 -1
- package/dist/host/convex-entry.js +3 -0
- package/dist/host/convex-entry.js.map +1 -1
- package/dist/host/convexPreset.d.ts +1526 -0
- package/dist/host/convexPreset.d.ts.map +1 -0
- package/dist/host/convexPreset.js +516 -0
- package/dist/host/convexPreset.js.map +1 -0
- package/dist/host/convexSlice.d.ts +36 -24
- package/dist/host/convexSlice.d.ts.map +1 -1
- package/dist/host/convexSlice.js.map +1 -1
- package/dist/host/index.d.ts +4 -1
- package/dist/host/index.d.ts.map +1 -1
- package/dist/host/index.js +3 -0
- package/dist/host/index.js.map +1 -1
- package/dist/host/surfaceGenerator.d.ts +18 -0
- package/dist/host/surfaceGenerator.d.ts.map +1 -0
- package/dist/host/surfaceGenerator.js +56 -0
- package/dist/host/surfaceGenerator.js.map +1 -0
- package/dist/host/surfaceManifest.d.ts +27 -0
- package/dist/host/surfaceManifest.d.ts.map +1 -0
- package/dist/host/surfaceManifest.js +78 -0
- package/dist/host/surfaceManifest.js.map +1 -0
- package/dist/host/wrapDefinitions.d.ts +17 -0
- package/dist/host/wrapDefinitions.d.ts.map +1 -0
- package/dist/host/wrapDefinitions.js +18 -0
- package/dist/host/wrapDefinitions.js.map +1 -0
- package/docs/CLIENT_AND_REACT_HOOKS.md +92 -0
- package/docs/DISPATCH_MANAGED_REFERENCE_HOST.md +59 -0
- package/docs/HOST_INTEGRATION.md +81 -0
- package/docs/HOST_PRESET_MATRIX.md +72 -0
- package/docs/OPERATIONS_AND_ERRORS.md +63 -0
- package/docs/RUNTIME_OWNED_REFERENCE_HOST.md +54 -0
- 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
|
[](https://www.npmjs.com/package/@zakstam/codex-local-component)
|
|
4
4
|
|
|
5
|
-
Convex component for Codex integrations where Codex runs locally
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
215
|
-
- `{ kind: "deltas", cursors: Array<{ streamId: string; cursor: number }> }`
|
|
23
|
+
That file is the normative, single-path consumer strategy.
|
|
216
24
|
|
|
217
|
-
|
|
25
|
+
## Quickstart Summary
|
|
218
26
|
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
- `
|
|
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
|
-
##
|
|
47
|
+
## Docs Map
|
|
235
48
|
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
-
|
|
239
|
-
-
|
|
240
|
-
|
|
241
|
-
|
|
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,
|
|
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"}
|