@cotal-ai/connector-codex 0.24.0 → 0.26.0

package/dist/agui-map.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Codex rollout records to AG-UI events.
+ *
+ * The durable record is the thread's rollout JSONL, not the app-server notification stream. The
+ * stream cannot make brackets legal across a restart, which is the property the emitter exists to
+ * provide, so the file is the record of truth and the stream is only how the host learns a thread
+ * id.
+ *
+ * Every rollout record is `{timestamp, type, payload}`. `type` is the envelope kind
+ * (`response_item`, `event_msg`, `session_meta`, `turn_context`, `world_state`, `compacted`) and
+ * `payload.type` is the inner kind for the first two. This mapper reads BOTH, because the same
+ * inner name appears under different envelopes and means different things: `agent_message` is an
+ * `event_msg` mirror of an assistant turn AND a `response_item` for inter-agent traffic.
+ *
+ * Derived against a real app-server thread, not against the operator's own
+ * sessions: `originator` is `cotal` there and the primer records ahead of the first turn do not
+ * occur in an operator corpus at all.
+ */
+import { type AguiEvent } from "@cotal-ai/connector-core";
+/** One rollout line. `payload` is `unknown` on purpose: it crosses in from a file this process did
+ *  not write, so every field is checked at the point it is read rather than trusted by its type. */
+export interface CodexRecord {
+    timestamp?: string;
+    type?: string;
+    payload?: unknown;
+}
+export interface CodexMapper {
+    map: (record: CodexRecord) => {
+        runId: string;
+        events: AguiEvent[];
+    } | null;
+    /** Drop a run the record stream never closed, when a turn terminal says it ended. Keyed on the
+     *  id so a newer run opened in between is left alone. */
+    forgetOpenRun: (runId: string) => void;
+}
+/**
+ * @param threadId The native thread id, which is `session_meta.payload.id` and the rollout
+ *  filename key. Passed in rather than read from the file: the caller resolved the path FROM this
+ *  id, so reading it back would make the two independently derivable and let them disagree.
+ * @param mintRunId Injected so a test can make runs deterministic without the mapper owning a
+ *  source of randomness.
+ */
+export declare function createCodexMapper(opts: {
+    threadId: string;
+    mintRunId: () => string;
+}): CodexMapper;
+//# sourceMappingURL=agui-map.d.ts.map

package/dist/agui-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-map.d.ts","sourceRoot":"","sources":["../src/agui-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAcL,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAC;AAElC;oGACoG;AACpG,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E;6DACyD;IACzD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AA+CD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,WAAW,CA2LlG"}

package/dist/agui-rollout.d.ts

@@ -0,0 +1,17 @@
+/** Walk `<root>/sessions` for the one file whose name ends `-<threadId>.jsonl`.
+ *
+ *  Returns `undefined` rather than throwing when nothing matches: `thread/start` writes NOTHING to
+ *  disk on its own, and the host's primer inject is what materializes the file, so a caller that
+ *  arrives in that window has to be able to wait rather than fail. */
+export declare function findRollout(codexHome: string, threadId: string): string | undefined;
+/** {@link findRollout}, retried until the primer has materialized the file.
+ *
+ *  Bounded and loud: a thread whose rollout never appears is a real fault (the emitter would have
+ *  no durable source at all), so this returns `undefined` after the budget rather than waiting
+ *  forever behind a caller that cannot see it is stuck. */
+export declare function waitForRollout(codexHome: string, threadId: string, opts?: {
+    attempts?: number;
+    intervalMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<string | undefined>;
+//# sourceMappingURL=agui-rollout.d.ts.map

package/dist/agui-rollout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-rollout.d.ts","sourceRoot":"","sources":["../src/agui-rollout.ts"],"names":[],"mappings":"AAcA;;;;sEAIsE;AACtE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkDnF;AAED;;;;2DAI2D;AAC3D,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GACvF,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B"}

package/dist/extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAaA,OAAO,EAA2B,KAAK,SAAS,EAAuE,MAAM,gBAAgB,CAAC;AAuG9I,eAAO,MAAM,cAAc,EAAE,SAyH5B,CAAC"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAaA,OAAO,EAA2B,KAAK,SAAS,EAAuE,MAAM,gBAAgB,CAAC;AAkG9I,eAAO,MAAM,cAAc,EAAE,SA6J5B,CAAC"}

package/dist/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAmQA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA6oBlD"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AA8UA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAy3BlD"}