@cursor/july 0.1.51 → 0.1.53

package/dist/internal/cli-slack.js

@@ -1,6 +1,7 @@
 /**
- * `agent-serve slack …` CLI — doctor, destroy/icon, and `create` as a
- * dashboard-wizard launcher (`slack-provision-client.ts`).
+ * `agent-serve slack …` CLI — doctor, destroy/icon, `create` as a
+ * dashboard-wizard launcher (`slack-provision-client.ts`), and
+ * `init --manual` for hand-imported manifests.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -11,10 +12,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { access, chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { access, chmod, readFile, writeFile } from "node:fs/promises";
 import { basename, extname, join, resolve as resolvePath } from "node:path";
-import { buildSlackManifestPair, envPrefixFromName, formatSlackSetupGuide, initSlackChannel, runSlackDoctor, slackEnvKeys, } from "../channels/slack/index.js";
+import { envPrefixFromName, formatSlackSetupGuide, initSlackChannel, runSlackDoctor, slackEnvKeys, } from "../channels/slack/index.js";
 import { resolveDeployAuth } from "./cli-deploy.js";
+import { cmdSlackInit, runSlackManifest } from "./cli-slack-manual.js";
 import { cursorExternalApiUrl } from "./cursor/credentials.js";
 import { slugFromDirectoryName } from "./deploy-client.js";
 import { inferDeployGitSource } from "./deploy-source.js";
@@ -34,6 +36,10 @@ Usage:
                                 [--team <id>] [--json]
   ${CLI} slack icon      <URL-or-FILE> [--dir .] [--slack-team T0123ABCD]
                                 [--prod] [--team <id>] [--json]
+  ${CLI} slack init --manual [--dir .] [--name NAME]
+                                [--prefix PREFIX | --no-prefix] [--channel-posts]
+  ${CLI} slack manifest --env dev|prod|both [--dir .] [--name NAME]
+                                [--print]
   ${CLI} slack doctor [--dir .] [--prefix PREFIX | --no-prefix] [--json]
 
 create/destroy/icon — dedicated Socket Mode app via the Cursor dashboard:
@@ -47,13 +53,14 @@ create/destroy/icon — dedicated Socket Mode app via the Cursor dashboard:
   icon     Set the provisioned app's icon: an https image URL or a local
            png/jpg/gif file (at most 512KB).
 
-\`slack init\` is removed. Use \`slack create\`. Do not paste a manifest
-at api.slack.com.
+\`slack init\` without --manual is not the first-run path. Use \`slack create\`.
+\`slack init --manual\` writes the channel file, manifests to paste at
+api.slack.com, env.example, and setup-status.json.
 
 Env tokens:
   single agent:  SLACK_BOT_TOKEN + SLACK_APP_TOKEN
   multi-agent:   <PREFIX>_SLACK_BOT_TOKEN + <PREFIX>_SLACK_APP_TOKEN
-                 (create default PREFIX from the directory name;
+                 (create / init --manual default PREFIX from the directory name;
                   doctor defaults to it too when those keys are set)
 
 See also: skills/setup-slack/SKILL.md
@@ -79,7 +86,7 @@ export function cmdSlack(subcommand, options) {
             case "init":
                 return cmdSlackInit(options);
             case "manifest":
-                return runManifest(options);
+                return runSlackManifest(options);
             case "doctor":
                 return runDoctor(options);
             default:
@@ -89,57 +96,6 @@ export function cmdSlack(subcommand, options) {
         }
     });
 }
-function cmdSlackInit(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        errStream(options)(`\`slack init\` is removed. Socket Mode apps are created with:
-
-  ${CLI} slack create --dir .
-
-That opens the Cursor dashboard wizard. Do not paste a manifest at api.slack.com.
-`);
-        return 1;
-    });
-}
-function runManifest(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const env = (_a = options.env) !== null && _a !== void 0 ? _a : "both";
-        const dir = resolvePath(options.dir);
-        const name = (_b = options.name) !== null && _b !== void 0 ? _b : basename(dir);
-        const pair = buildSlackManifestPair({
-            name,
-            managedByCursor: false,
-            channelPosts: options.channelPosts === true ? true : undefined,
-        });
-        if (options.print) {
-            if (env === "dev" || env === "both") {
-                process.stdout.write(`${JSON.stringify(pair.dev, null, 2)}\n`);
-            }
-            if (env === "prod" || env === "both") {
-                if (env === "both") {
-                    process.stdout.write("--- prod ---\n");
-                }
-                process.stdout.write(`${JSON.stringify(pair.prod, null, 2)}\n`);
-            }
-            return 0;
-        }
-        const outDir = join(dir, ".agent-serve/slack");
-        yield mkdir(outDir, { recursive: true });
-        const written = [];
-        if (env === "dev" || env === "both") {
-            const path = join(outDir, "manifest.dev.json");
-            yield writeFile(path, `${JSON.stringify(pair.dev, null, 2)}\n`);
-            written.push(path);
-        }
-        if (env === "prod" || env === "both") {
-            const path = join(outDir, "manifest.prod.json");
-            yield writeFile(path, `${JSON.stringify(pair.prod, null, 2)}\n`);
-            written.push(path);
-        }
-        process.stdout.write(`${JSON.stringify({ ok: true, written }, null, 2)}\n`);
-        return 0;
-    });
-}
 function runDoctor(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
@@ -335,7 +291,7 @@ export function cmdSlackCreate(options) {
         }
         let wrote;
         try {
-            wrote = yield scaffoldSlackChannelFiles(options, target);
+            wrote = yield scaffoldSlackChannelFiles(target);
         }
         catch (error) {
             ctx.err(`${describeError(error)}\n`);
@@ -597,7 +553,7 @@ function formatAppList(apps) {
  * Scaffold `agent/channels/slack.ts` when absent. Existing files are
  * never overwritten: initSlackChannel writes with `wx`.
  */
-function scaffoldSlackChannelFiles(options, target) {
+function scaffoldSlackChannelFiles(target) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const channelFile = "agent/channels/slack.ts";
@@ -605,23 +561,16 @@ function scaffoldSlackChannelFiles(options, target) {
             return [];
         }
         try {
-            // Pass the resolved name/prefix so the channel file and the env keys
-            // share one derivation.
             const result = yield initSlackChannel({
                 dir: target.dir,
                 name: target.name,
                 envPrefix: (_a = target.envPrefix) !== null && _a !== void 0 ? _a : "",
-                channelPosts: options.channelPosts,
             });
             return result.files;
         }
         catch (error) {
             if (isErrnoException(error) && error.code === "EEXIST") {
-                // The channel file is written first, so it exists by the time a
-                // later pre-existing file aborts the scaffold.
-                return (yield fileExists(join(target.dir, channelFile)))
-                    ? [channelFile]
-                    : [];
+                return [channelFile];
             }
             throw error;
         }

package/dist/internal/deploy-client.d.ts

@@ -15,29 +15,26 @@ export type DeploymentProgress = "queued" | "preparing" | "creating" | "building
 export declare const TERMINAL_DEPLOY_STATUSES: ReadonlySet<DeploymentStatus>;
 /**
  * What gets deployed. Today the control plane builds the engine itself from
- * a git ref (or serves the static placeholder when no repo is given), so the
- * only member is the slug/git-ref shape. When artifact-based deploys ship
- * ("build locally + upload"), add an `{ kind: "artifact", ... }` member here
- * and a branch in {@link AgentServeDeployClient.deploy} — the command
- * surface and everything downstream stays unchanged.
+ * a git ref, so the only member is the slug/git-ref shape. When
+ * artifact-based deploys ship ("build locally + upload"), add an
+ * `{ kind: "artifact", ... }` member here and a branch in
+ * {@link AgentServeDeployClient.deploy} — the command surface and everything
+ * downstream stays unchanged.
  */
 export type DeploySource = {
     kind: "git-ref";
-    /** Omit for the control-plane static engine (`static-http-200`). */
-    gitRepoUrl?: string;
+    gitRepoUrl: string;
     gitRef?: string;
     agentPath?: string;
     /** Repos whose SCM events the deployed engine pulls (`owner/name`). */
     cursorEventRepos?: string[];
     /**
-     * Egress allowlist for the engine pod. Only valid on repo-backed
-     * deploys — the backend 400s when set on a static deploy.
+     * Egress allowlist for the engine pod.
      */
     egressAllowedDomains?: string[];
     /**
      * `/v1/channels/…` subtrees the stable alias serves WITHOUT
      * `X-Agent-Alias-Token` (channels authored with `publicEndpoint()`).
-     * Only valid on repo-backed deploys.
      */
     publicRoutePaths?: string[];
 };

package/dist/internal/deploy-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-client.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,gBAAgB,CAKjE,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAIF,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOtE;AAED,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM;IAJrC,YACE,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;IACvB,oEAAoE;IAC3D,iBAAiB,CAAC,EAAE,MAAM,YAAA,EAIpC;CACF;AASD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAC/C,MAAM,GAAG,SAAS,CAOpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC;AA6JD,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,YAAY,OAAO,EAAE,6BAA6B,EAMjD;IAED,yEAAyE;IACnE,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,YAAY,CAAC;KACtB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyC1B;IAEK,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAOrE;IAEK,aAAa,CAAC,IAAI,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAO5B;IAEK,cAAc,CAAC,IAAI,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAOxB;IAEK,gBAAgB,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,cAAc,CAAC,CAO1B;IAED,sEAAsE;IAChE,gBAAgB,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlB;IAED;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BpB;IAED,gEAAgE;IAC1D,WAAW,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAOxB;IAED,yDAAyD;IACnD,YAAY,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;IAED;;;;OAIG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlB;IAED;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsBxE;IAED,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpC;IAED;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;YAEa,OAAO;CAyCtB"}
+{"version":3,"file":"deploy-client.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-client.ts"],"names":[],"mappings":"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"}

package/dist/internal/deploy-client.js

@@ -227,9 +227,7 @@ export class AgentServeDeployClient {
             }
             // Only the git-ref member exists today; a future artifact member would
             // upload the build first and post a different body from this branch.
-            const body = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ teamId: args.teamId, slug: args.slug }, (args.source.gitRepoUrl === undefined
-                ? {}
-                : { gitRepoUrl: args.source.gitRepoUrl })), (args.source.gitRef === undefined
+            const body = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ teamId: args.teamId, slug: args.slug, gitRepoUrl: args.source.gitRepoUrl }, (args.source.gitRef === undefined
                 ? {}
                 : { gitRef: args.source.gitRef })), (args.source.agentPath === undefined
                 ? {}

package/dist/internal/deploy-source.d.ts

@@ -30,7 +30,7 @@ export declare function httpsGitRepoUrlFromRemote(remote: string): string | unde
 export declare function agentPathRelativeToGitRoot(dir: string, gitRoot: string): string | undefined;
 /**
  * Probe the git checkout containing `dir` for deploy source fields.
- * Missing pieces stay undefined (static deploy / server defaults).
+ * Missing pieces stay undefined.
  */
 export declare function inferDeployGitSource(dir: string, options?: {
     git?: GitRunner;

package/dist/internal/deploy-source.js

@@ -103,7 +103,7 @@ export function agentPathRelativeToGitRoot(dir, gitRoot) {
 }
 /**
  * Probe the git checkout containing `dir` for deploy source fields.
- * Missing pieces stay undefined (static deploy / server defaults).
+ * Missing pieces stay undefined.
  */
 export function inferDeployGitSource(dir, options) {
     return __awaiter(this, void 0, void 0, function* () {

package/dist/internal/event-log.d.ts

@@ -1,8 +1,12 @@
 /**
- * Durable, replayable per-session event log. Events are held in memory for
- * live fan-out and appended to `events.ndjson` for durability; on process
- * restart the file is hydrated back so streams can replay from any
- * `startIndex`.
+ * Durable, replayable per-session event log. `events.ndjson` is the source
+ * of truth. The process keeps `nextIndex`, live subscribers, and a short
+ * unflushed tail — not a cache of the full transcript. Replay reads the
+ * file on demand; live streams subscribe first, then catch up by index.
+ *
+ * Hosted engines mint thousands of sessions (one per PR under
+ * agentic-owners). Retaining every streamed tool output in RAM for the
+ * process lifetime is what OOM'd those engines at the ~4 GB heap cap.
  */
 import type { SessionEvent, SessionEventPayload } from "../types.js";
 export type AppendableEvent = SessionEventPayload & {
@@ -12,46 +16,62 @@ export declare class SessionEventLog {
     private readonly sessionId;
     private readonly filePath;
     private readonly onPersistError;
-    private readonly events;
+    private nextIndex;
     private readonly listeners;
     private persistChain;
+    /** Appended events whose `appendFile` has not finished. */
+    private readonly inflight;
+    /**
+     * In-process patches (cloud cost backfill) that are not rewritten to
+     * `events.ndjson`. Applied on read.
+     */
+    private readonly replacements;
     private constructor();
     static open(args: {
         sessionId: string;
         filePath: string;
         onPersistError?: (error: unknown) => void;
     }): Promise<SessionEventLog>;
-    private hydrate;
+    private readNextIndex;
     get count(): number;
     /**
-     * In-process residency vs recorded length. Today those are the same
-     * (`events` is the cache). A later change can drop the cache and keep
-     * `eventsTotal` as the durable count while `eventsRetained` shrinks to
-     * the unflushed tail.
+     * In-process residency vs recorded length. `eventsTotal` is the durable
+     * count (`nextIndex`). `eventsRetained` is the unflushed tail — the
+     * transcript is not cached after `appendFile` lands.
      */
     memoryStats(): {
         eventsRetained: number;
         eventsTotal: number;
     };
     /**
-     * Assign the next index, record the event, and fan out to live
-     * subscribers. Ordering is synchronous; file persistence is chained in
-     * the background and awaited by {@link flush}.
+     * Assign the next index and fan out to live subscribers. Ordering is
+     * synchronous; file persistence is chained in the background and awaited
+     * by {@link flush}. The event is not retained after the write lands.
      */
     append(payload: AppendableEvent): SessionEvent;
+    private dropInflight;
     /** Wait for pending file writes (used on close). */
     flush(): Promise<void>;
-    snapshot(startIndex?: number): SessionEvent[];
     /**
-     * Replace one already-recorded event in memory. Used to backfill usage/cost
-     * onto historical `turn.completed` rows without rewriting `events.ndjson`.
-     * Live subscribers are not notified — patch before opening a replay stream.
+     * Read recorded events from `startIndex`. Does not retain the result on
+     * the log; callers own the returned array.
+     */
+    snapshot(startIndex?: number): Promise<SessionEvent[]>;
+    /**
+     * Replace one already-recorded event in this process. Used to backfill
+     * usage/cost onto historical `turn.completed` rows without rewriting
+     * `events.ndjson`. Live subscribers are not notified — patch before
+     * opening a replay stream.
      */
     replace(index: number, event: SessionEvent): boolean;
     subscribe(listener: (event: SessionEvent) => void): () => void;
     /**
      * NDJSON stream: replays recorded events from `startIndex`, then follows
      * live events until the consumer cancels.
+     *
+     * Subscribe first (buffer live events), then read the file, then drain
+     * the buffer by index so an async file read cannot drop or duplicate
+     * events that arrive during catch-up.
      */
     stream(startIndex?: number): ReadableStream<Uint8Array>;
 }

package/dist/internal/event-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../src/internal/event-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAPjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,YAAY,CAAoC;IAExD,OAAO,eAIH;IAEJ,OAAa,IAAI,CAAC,IAAI,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KAC3C,GAAG,OAAO,CAAC,eAAe,CAAC,CAQ3B;YAEa,OAAO;IAmBrB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;OAKG;IACH,WAAW,IAAI;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAG7D;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,CAsB7C;IAED,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED,QAAQ,CAAC,UAAU,SAAI,GAAG,YAAY,EAAE,CAEvC;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAUnD;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAK7D;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,SAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CA0BjD;CACF;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,4DAA4D;AAC5D,qBAAa,aAAa;IAKtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+C;IACpE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,YACmB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAC/C,cAAc,GAAE,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,KACX,IAAe,EAClB;IAEJ,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmB/C;IAED,WAAW,IAAI,mBAAmB,CAajC;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9B;CACF"}
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../src/internal/event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAqDxE,qBAAa,eAAe;IAaxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAdjC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,YAAY,CAAoC;IACxD,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAEhE,OAAO,eAIH;IAEJ,OAAa,IAAI,CAAC,IAAI,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KAC3C,GAAG,OAAO,CAAC,eAAe,CAAC,CAQ3B;YAEa,aAAa;IAU3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,WAAW,IAAI;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAK7D;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,CA2B7C;IAED,OAAO,CAAC,YAAY;IAWpB,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED;;;OAGG;IACG,QAAQ,CAAC,UAAU,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBtD;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAMnD;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAK7D;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,SAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAiDjD;CACF;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,4DAA4D;AAC5D,qBAAa,aAAa;IAKtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+C;IACpE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,YACmB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAC/C,cAAc,GAAE,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,KACX,IAAe,EAClB;IAEJ,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmB/C;IAED,WAAW,IAAI,mBAAmB,CAajC;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9B;CACF"}