@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.84af65cd215b6ca1

package/dist/ai-service/state-machine/helpers/background-chat-record.js

@@ -0,0 +1,61 @@
+import { getLogger } from "../../../util/logger.js";
+import { recordChatRecordDrop, recordChatRecordFailure, } from "./background-chat-record-metrics.js";
+/**
+ * Persist a chat message without blocking the turn that produced it.
+ *
+ * The server push behind `ChatSessionStore` runs at ~250ms p99 (12s max,
+ * `WS SERVER v1.ai.chat.pushMessage`) and used to be awaited before
+ * generation could start. Instead the write runs in the background and the
+ * server-assigned chatmessageId is applied to FSM context when it resolves —
+ * in practice well before the first LLM call reads it for usage attribution,
+ * since the integration fetch and prompt assembly run in between.
+ *
+ * If a newer prompt has started by the time the write resolves, the id is
+ * dropped: attributing the new turn's LLM usage to the previous turn's chat
+ * message would be worse than attributing it to none. Failures are swallowed
+ * (`ChatSessionStore` already degrades to an empty id) — losing a chat
+ * record must never fail the turn.
+ */
+export function recordChatMessageInBackground(options) {
+    const { clark, record, onRecorded } = options;
+    const turnPromptId = clark.context.promptId;
+    const startedAt = performance.now();
+    const durationMeta = () => ({
+        durationMs: Math.round(performance.now() - startedAt),
+        turnPromptId,
+    });
+    // Promise.resolve().then(record) so a synchronously-throwing or
+    // non-promise-returning record fn still lands in the catch below instead
+    // of propagating into the (intentionally not awaiting) caller.
+    void Promise.resolve()
+        .then(record)
+        .then((chatmessageId) => {
+        getLogger().debug("[chat-record] Chat record write completed", durationMeta());
+        if (!chatmessageId) {
+            getLogger().debug("[chat-record] Server returned no chatmessageId for turn", { turnPromptId });
+            return;
+        }
+        if (clark.context.promptId !== turnPromptId) {
+            recordChatRecordDrop("stale_turn");
+            getLogger().info("[chat-record] Dropping stale chat-record result", {
+                currentPromptId: clark.context.promptId,
+                turnPromptId,
+            });
+            return;
+        }
+        clark.updateContext({ chatmessageId });
+        try {
+            onRecorded?.(chatmessageId);
+        }
+        catch (err) {
+            recordChatRecordFailure("callback_error");
+            getLogger().warn("[chat-record] onRecorded callback threw after successful write", err);
+        }
+    })
+        .catch((err) => {
+        recordChatRecordFailure("record_error");
+        getLogger().debug("[chat-record] Chat record write failed", durationMeta());
+        getLogger().warn("[chat-record] Failed to record chat message", err);
+    });
+}
+//# sourceMappingURL=background-chat-record.js.map

package/dist/ai-service/state-machine/helpers/background-chat-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-chat-record.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/background-chat-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAQ7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAK7C;IACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC;QAC1B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACrD,YAAY;KACb,CAAC,CAAC;IACH,gEAAgE;IAChE,yEAAyE;IACzE,+DAA+D;IAC/D,KAAK,OAAO,CAAC,OAAO,EAAE;SACnB,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;QACtB,SAAS,EAAE,CAAC,KAAK,CACf,2CAA2C,EAC3C,YAAY,EAAE,CACf,CAAC;QACF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,SAAS,EAAE,CAAC,KAAK,CACf,yDAAyD,EACzD,EAAE,YAAY,EAAE,CACjB,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC5C,oBAAoB,CAAC,YAAY,CAAC,CAAC;YACnC,SAAS,EAAE,CAAC,IAAI,CAAC,iDAAiD,EAAE;gBAClE,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;gBACvC,YAAY;aACb,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,UAAU,EAAE,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;YAC1C,SAAS,EAAE,CAAC,IAAI,CACd,gEAAgE,EAChE,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,uBAAuB,CAAC,cAAc,CAAC,CAAC;QACxC,SAAS,EAAE,CAAC,KAAK,CACf,wCAAwC,EACxC,YAAY,EAAE,CACf,CAAC;QACF,SAAS,EAAE,CAAC,IAAI,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/ai-service/state-machine/helpers/change-info.d.ts

@@ -0,0 +1,8 @@
+import type { ChatSessionStore } from "../../chat/chat-session-store.js";
+import type { Clark } from "../clark-fsm.js";
+export declare const sendChangeInfoHelper: (clark: Clark, chatSessionStore: ChatSessionStore) => ({ type, filePath, action, }: {
+    type: "pending" | "error" | "ready" | "validated";
+    filePath: string;
+    action?: "create" | "edit" | "delete";
+}) => Promise<void> | undefined;
+//# sourceMappingURL=change-info.d.ts.map

package/dist/ai-service/state-machine/helpers/change-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-info.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/change-info.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAK7C,eAAO,MAAM,oBAAoB,GAC/B,OAAO,KAAK,EACZ,kBAAkB,gBAAgB,MAsB1B,6BAIL;IACD,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;CACvC,8BAmFF,CAAC"}

package/dist/ai-service/state-machine/helpers/change-info.js

@@ -0,0 +1,100 @@
+import { basename } from "node:path";
+import { Paths } from "../../const.js";
+import { matchPath, renderPath } from "../../transform/shared.js";
+import { sendChangeInfoChannel } from "./peer.js";
+const DependencyInfoPath = "package.json/:packageName";
+export const sendChangeInfoHelper = (clark, chatSessionStore) => {
+    const apiPathMatcher = matchPath(Paths.GeneratedApis);
+    const pagePathMatcher = matchPath(Paths.PageIndexes);
+    const dependencyPathMatcher = matchPath(DependencyInfoPath);
+    const sendChangeInfo = sendChangeInfoChannel(clark, chatSessionStore);
+    const push = (info) => {
+        clark.updateContext((context) => ({
+            ...context,
+            generatedChangeInfo: {
+                ...context.generatedChangeInfo,
+                [info.filePath]: info,
+            },
+        }));
+        return sendChangeInfo(info);
+    };
+    if (!clark.context.generatedChangeInfo) {
+        clark.updateContext({
+            generatedChangeInfo: {},
+        });
+    }
+    return ({ type, filePath, action, }) => {
+        const { initialFilePaths } = clark.context;
+        const existingChangeInfo = clark.context.generatedChangeInfo?.[filePath];
+        switch (type) {
+            case "ready":
+            case "validated":
+            case "error": {
+                if (!existingChangeInfo) {
+                    return;
+                }
+                return push({
+                    ...existingChangeInfo,
+                    status: type,
+                });
+            }
+            case "pending": {
+                const { apis } = initialFilePaths ?? {};
+                if (existingChangeInfo) {
+                    return push({
+                        ...existingChangeInfo,
+                        status: "pending",
+                    });
+                }
+                const dependencyPath = dependencyPathMatcher(filePath);
+                if (dependencyPath.matched) {
+                    const { packageName } = dependencyPath.params;
+                    return push({
+                        type: "dependency",
+                        name: packageName,
+                        action: action ?? "create",
+                        status: "pending",
+                        filePath,
+                    });
+                }
+                const pagePath = pagePathMatcher(filePath);
+                if (pagePath.matched) {
+                    const { pageName } = pagePath.params;
+                    return push({
+                        type: "page",
+                        name: pageName,
+                        action: "edit",
+                        status: "pending",
+                        filePath,
+                    });
+                }
+                if (filePath === Paths.AppTheme) {
+                    return push({
+                        type: "theme",
+                        name: "App Theme",
+                        action: "edit",
+                        status: "pending",
+                        filePath,
+                    });
+                }
+                const apiPath = apiPathMatcher(filePath);
+                if (apiPath.matched) {
+                    let { apiName } = apiPath.params;
+                    apiName = basename(apiName, ".ts");
+                    const yamlPath = renderPath(Paths.ApiYamls, {
+                        ...apiPath.params,
+                        apiName,
+                    });
+                    return push({
+                        type: "api",
+                        name: apiName,
+                        action: apis?.includes(yamlPath) ? "edit" : "create",
+                        status: "pending",
+                        filePath,
+                    });
+                }
+            }
+        }
+    };
+};
+//# sourceMappingURL=change-info.js.map

package/dist/ai-service/state-machine/helpers/change-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-info.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/change-info.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/state-machine/helpers/classification.d.ts

@@ -0,0 +1,5 @@
+import type { Clark } from "../clark-fsm.js";
+export declare const classificationHelper: (_clark: Clark) => {
+    isFullAppOrBroadUpdate: () => boolean;
+};
+//# sourceMappingURL=classification.d.ts.map

package/dist/ai-service/state-machine/helpers/classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/classification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,oBAAoB,GAAI,QAAQ,KAAK;kCACb,OAAO;CAc3C,CAAC"}

package/dist/ai-service/state-machine/helpers/classification.js

@@ -0,0 +1,13 @@
+export const classificationHelper = (_clark) => {
+    const isFullAppOrBroadUpdate = () => {
+        const classification = null; // disable for now
+        return (!classification ||
+            classification === "broad_edit" ||
+            classification === "full_app_gen" ||
+            classification === "unknown");
+    };
+    return {
+        isFullAppOrBroadUpdate,
+    };
+};
+//# sourceMappingURL=classification.js.map

package/dist/ai-service/state-machine/helpers/classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/classification.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAa,EAAE,EAAE;IACpD,MAAM,sBAAsB,GAAG,GAAY,EAAE;QAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,kBAAkB;QAE/C,OAAO,CACL,CAAC,cAAc;YACf,cAAc,KAAK,YAAY;YAC/B,cAAc,KAAK,cAAc;YACjC,cAAc,KAAK,SAAS,CAC7B,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,sBAAsB;KACvB,CAAC;AACJ,CAAC,CAAC"}

package/dist/ai-service/state-machine/helpers/context-id.d.ts

@@ -0,0 +1,4 @@
+import type { ContextId } from "../../llm/context-v2/types.js";
+import type { Clark, ClarkStateHandlerParams } from "../clark-fsm.js";
+export declare function getContextId(clark: Clark, services: Pick<ClarkStateHandlerParams, "applicationId"> & Partial<Pick<ClarkStateHandlerParams, "organizationId">>, name?: string): ContextId;
+//# sourceMappingURL=context-id.d.ts.map

package/dist/ai-service/state-machine/helpers/context-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-id.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/context-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAAC,EAC1D,IAAI,GAAE,MAAe,GACpB,SAAS,CAiBX"}

package/dist/ai-service/state-machine/helpers/context-id.js

@@ -0,0 +1,18 @@
+import { parseJwt } from "../../util/parse-jwt.js";
+//* Get or create a ContextId for the current conversation context. */
+export function getContextId(clark, services, name = "main") {
+    const userId = parseJwt(clark.context.jwt)?.userId;
+    if (!userId) {
+        throw new Error("Cannot get context ID: JWT is missing or has no userId. " +
+            "This indicates a bug - JWT should be set in AgentPlanning and preserved across state transitions.");
+    }
+    return {
+        appId: services.applicationId,
+        ...(services.organizationId
+            ? { organizationId: services.organizationId }
+            : {}),
+        userId,
+        name,
+    };
+}
+//# sourceMappingURL=context-id.js.map

package/dist/ai-service/state-machine/helpers/context-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-id.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/context-id.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAC1B,KAAY,EACZ,QAC0D,EAC1D,OAAe,MAAM;IAErB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,0DAA0D;YACxD,mGAAmG,CACtG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,aAAa;QAC7B,GAAG,CAAC,QAAQ,CAAC,cAAc;YACzB,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;QACP,MAAM;QACN,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/ai-service/state-machine/helpers/fetch-with-reconnect-retry.d.ts

@@ -0,0 +1,7 @@
+import type { ReconnectablePeer } from "./stable-peer.js";
+interface FetchWithReconnectRetryOptions {
+    reconnectBudgetMs: number;
+}
+export declare function fetchWithReconnectRetry<T>(peer: ReconnectablePeer | undefined, fetcher: () => Promise<T>, options: FetchWithReconnectRetryOptions): Promise<T>;
+export {};
+//# sourceMappingURL=fetch-with-reconnect-retry.d.ts.map

package/dist/ai-service/state-machine/helpers/fetch-with-reconnect-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-reconnect-retry.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/fetch-with-reconnect-retry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,UAAU,8BAA8B;IACtC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,IAAI,EAAE,iBAAiB,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,CAAC,CAAC,CA6CZ"}

package/dist/ai-service/state-machine/helpers/fetch-with-reconnect-retry.js

@@ -0,0 +1,38 @@
+import { getLogger } from "../../../util/logger.js";
+import { isGuardedPeerUnavailableError } from "../../util/call-peer.js";
+import { RpcTimeoutError } from "../../util/rpc-timeout.js";
+import { isPeerUnavailableError } from "./stable-peer.js";
+export async function fetchWithReconnectRetry(peer, fetcher, options) {
+    const generation = peer?.connectionGeneration;
+    try {
+        return await fetcher();
+    }
+    catch (err) {
+        const refusedBeforeDispatch = isGuardedPeerUnavailableError(err);
+        const shouldRetry = err instanceof RpcTimeoutError || isPeerUnavailableError(err);
+        if (!shouldRetry || !peer)
+            throw err;
+        // If a newer generation already arrived while the original request was
+        // in-flight, invalidation becomes a no-op and the retry uses that fresh
+        // peer immediately instead of closing it.
+        const timedOutGeneration = generation ?? peer.connectionGeneration;
+        const operationName = err instanceof RpcTimeoutError ? err.operationName : "browser RPC";
+        const errorDescription = err instanceof RpcTimeoutError
+            ? `${err.operationName} timed out after ${err.timeoutMs}ms`
+            : refusedBeforeDispatch
+                ? "browser RPC refused because no peer route was available"
+                : "browser RPC dropped by transport close";
+        getLogger().warn(`[fetch-with-reconnect-retry] ${errorDescription}; waiting up to ${options.reconnectBudgetMs}ms for peer reconnect before retrying`);
+        peer.invalidateConnection(timedOutGeneration);
+        const reconnected = await peer.whenConnectedAfter(timedOutGeneration, options.reconnectBudgetMs);
+        if (!reconnected) {
+            getLogger().warn(`[fetch-with-reconnect-retry] peer did not reconnect within ${options.reconnectBudgetMs}ms; rethrowing original error for ${operationName}`);
+            throw err;
+        }
+        getLogger().info(`[fetch-with-reconnect-retry] peer reconnected; retrying ${operationName}`);
+        // The retry is a second dispatch. Callers must keep the fetcher
+        // idempotent; `fetchIntegrations` upserts, so a duplicate is harmless.
+        return await fetcher();
+    }
+}
+//# sourceMappingURL=fetch-with-reconnect-retry.js.map

package/dist/ai-service/state-machine/helpers/fetch-with-reconnect-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-reconnect-retry.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/fetch-with-reconnect-retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAO1D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAmC,EACnC,OAAyB,EACzB,OAAuC;IAEvC,MAAM,UAAU,GAAG,IAAI,EAAE,oBAAoB,CAAC;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,qBAAqB,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,WAAW,GACf,GAAG,YAAY,eAAe,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI;YAAE,MAAM,GAAG,CAAC;QACrC,uEAAuE;QACvE,wEAAwE;QACxE,0CAA0C;QAC1C,MAAM,kBAAkB,GAAG,UAAU,IAAI,IAAI,CAAC,oBAAoB,CAAC;QACnE,MAAM,aAAa,GACjB,GAAG,YAAY,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;QACrE,MAAM,gBAAgB,GACpB,GAAG,YAAY,eAAe;YAC5B,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,oBAAoB,GAAG,CAAC,SAAS,IAAI;YAC3D,CAAC,CAAC,qBAAqB;gBACrB,CAAC,CAAC,yDAAyD;gBAC3D,CAAC,CAAC,wCAAwC,CAAC;QAEjD,SAAS,EAAE,CAAC,IAAI,CACd,gCAAgC,gBAAgB,mBAAmB,OAAO,CAAC,iBAAiB,uCAAuC,CACpI,CAAC;QAEF,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAC/C,kBAAkB,EAClB,OAAO,CAAC,iBAAiB,CAC1B,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC,IAAI,CACd,8DAA8D,OAAO,CAAC,iBAAiB,qCAAqC,aAAa,EAAE,CAC5I,CAAC;YACF,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,SAAS,EAAE,CAAC,IAAI,CACd,2DAA2D,aAAa,EAAE,CAC3E,CAAC;QACF,gEAAgE;QAChE,uEAAuE;QACvE,OAAO,MAAM,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/ai-service/state-machine/helpers/headless-turn-lifecycle.d.ts

@@ -0,0 +1,27 @@
+import type { TracedEventEmitter } from "@superblocksteam/shared";
+import type { AiServiceEvents } from "../../types.js";
+import type { StablePeer } from "./stable-peer.js";
+/**
+ * Tie a headless turn's routing to the life of the generation it asked for.
+ *
+ * A gateway peer holds its socket open past the end of its turn, so the socket
+ * closing is too late a signal: whatever the user starts in the browser next
+ * would be routed to it. The generation's own signals are the right boundary.
+ *
+ * Terminal signals are emitted *before* the generation-state push that carries
+ * them, so this only marks the turn settled — {@link StablePeer.settleTurn}
+ * defers the release until that push has gone out, or the turn's caller would
+ * never learn the work finished. `generationFailed` carries no id, so the
+ * generation running when it fires identifies it.
+ *
+ * `generationStarted` carries the generation's id but not which request asked
+ * for it, so that comes off the context the prompt set on its way in — for a
+ * prompt with a `requestId` it is that id, which is the same value the gateway
+ * holds as its turn correlator. Without it a turn cannot tell its own
+ * generation from one the user started in the browser moments earlier.
+ *
+ * Shared with the tests that drive the real terminal path, so the wiring under
+ * test is the wiring that ships.
+ */
+export declare function bindHeadlessTurnLifecycle(signals: TracedEventEmitter<AiServiceEvents>, peer: StablePeer, currentGenerationId: () => string | undefined, currentRequestKey: () => string | undefined): void;
+//# sourceMappingURL=headless-turn-lifecycle.d.ts.map

package/dist/ai-service/state-machine/helpers/headless-turn-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-turn-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/headless-turn-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC5C,IAAI,EAAE,UAAU,EAChB,mBAAmB,EAAE,MAAM,MAAM,GAAG,SAAS,EAC7C,iBAAiB,EAAE,MAAM,MAAM,GAAG,SAAS,GAC1C,IAAI,CAUN"}

package/dist/ai-service/state-machine/helpers/headless-turn-lifecycle.js

@@ -0,0 +1,34 @@
+/**
+ * Tie a headless turn's routing to the life of the generation it asked for.
+ *
+ * A gateway peer holds its socket open past the end of its turn, so the socket
+ * closing is too late a signal: whatever the user starts in the browser next
+ * would be routed to it. The generation's own signals are the right boundary.
+ *
+ * Terminal signals are emitted *before* the generation-state push that carries
+ * them, so this only marks the turn settled — {@link StablePeer.settleTurn}
+ * defers the release until that push has gone out, or the turn's caller would
+ * never learn the work finished. `generationFailed` carries no id, so the
+ * generation running when it fires identifies it.
+ *
+ * `generationStarted` carries the generation's id but not which request asked
+ * for it, so that comes off the context the prompt set on its way in — for a
+ * prompt with a `requestId` it is that id, which is the same value the gateway
+ * holds as its turn correlator. Without it a turn cannot tell its own
+ * generation from one the user started in the browser moments earlier.
+ *
+ * Shared with the tests that drive the real terminal path, so the wiring under
+ * test is the wiring that ships.
+ */
+export function bindHeadlessTurnLifecycle(signals, peer, currentGenerationId, currentRequestKey) {
+    signals.on("generationStarted", (generationId) => {
+        peer.attachTurnGeneration(generationId, currentRequestKey());
+    });
+    signals.on("generationCompleted", (_producedDraft, generationId) => {
+        peer.settleTurn(generationId);
+    });
+    signals.on("generationFailed", () => {
+        peer.settleTurn(currentGenerationId());
+    });
+}
+//# sourceMappingURL=headless-turn-lifecycle.js.map

package/dist/ai-service/state-machine/helpers/headless-turn-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-turn-lifecycle.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/headless-turn-lifecycle.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA4C,EAC5C,IAAgB,EAChB,mBAA6C,EAC7C,iBAA2C;IAE3C,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,YAAY,EAAE,EAAE;QAC/C,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,EAAE;QACjE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAClC,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ai-service/state-machine/helpers/peer.d.ts

@@ -1,5 +1,85 @@
+import type { AiChangeInfoPush, AiChatMessage, EditorClientMethods } from "@superblocksteam/library-shared/types";
+import type { ChatSessionStore } from "../../chat/chat-session-store.js";
 import type { Clark } from "../clark-fsm.js";
-import type { EditorClientMethods } from "@superblocksteam/library-shared/types";
-export declare const sendUserMessageChannel: (clark: Clark) => (payload: Parameters<EditorClientMethods["aiPushMessage"]>[0]) => undefined;
-export declare const sendUserCompletionChannel: (clark: Clark) => (payload: Parameters<EditorClientMethods["aiSetCompleted"]>[0]) => Promise<undefined>;
+/**
+ * Result of {@link sendInteractiveMessageChannel}.
+ *
+ * - `success: true` — payload was delivered to the peer.
+ *   - `recoverable: true` indicates the channel cleared a stale
+ *     `activeInteractiveMessage` left behind by a lifecycle path that
+ *     did not clean it up. Callers can surface this if they want to log
+ *     or annotate the recovery.
+ * - `success: false` with `displaced: true` — another interactive
+ *   prompt is genuinely in flight (the user is currently looking at
+ *   it). The new payload was NOT delivered. Callers should not retry
+ *   silently; the agent loop should transition to `AwaitingUser` and
+ *   the model should be given a structured signal it can act on
+ *   instead of looping the same tool.
+ * - `success: false` with `peerDisconnected: true` — the payload could
+ *   not be delivered because the editor peer was unavailable or
+ *   disconnected during the push.
+ */
+type SendInteractiveMessageResult = {
+    success: true;
+    recoverable?: boolean;
+    alreadyActive?: boolean;
+} | {
+    success: false;
+    displaced?: boolean;
+    deferred?: boolean;
+    peerDisconnected?: boolean;
+    message: string;
+};
+export declare const sendInteractiveMessageChannel: (clark: Clark, chatSessionStore: ChatSessionStore) => (payload: AiChatMessage, delay?: number, immediate?: boolean, options?: {
+    deferIfActive?: boolean;
+    recoverStaleOnce?: {
+        isStale: (active: {
+            id: string;
+            payload: AiChatMessage;
+        }) => boolean;
+    };
+}) => Promise<SendInteractiveMessageResult>;
+export declare const flushDeferredInteractiveMessage: (clark: Clark, chatSessionStore: ChatSessionStore) => Promise<boolean>;
+/**
+ * Options for {@link sendUserMessageChannel}.
+ *
+ * `persistBeforeDeliver` is best-effort ordering, NOT a durability guarantee.
+ * When `true`, the queued operation awaits `recordAssistant` before calling
+ * `aiPushMessage`.  On write failure we log and continue to peer delivery —
+ * the message is NOT guaranteed persisted when it reaches the client.
+ *
+ * Use this when the caller needs ordering (for example, to beat a downstream
+ * full-reload that re-reads messages from the server) and can tolerate silent
+ * loss if persistence fails.  Do NOT use it as a "durable send" primitive.
+ */
+type SendUserMessageOptions = {
+    persistBeforeDeliver?: boolean;
+};
+/**
+ * Result of {@link sendUserMessageChannel}.
+ *
+ * - `success: true` — payload was delivered to the peer within the push
+ *   bound ({@link PEER_PUSH_TIMEOUT_MS}).
+ * - `success: false` with `peerDisconnected: true` — there was no peer, the
+ *   peer's transport closed mid-push, or the push exceeded the bound (a
+ *   half-open peer that never acks). Callers must not await this channel
+ *   unbounded; the bound is enforced here so a half-open peer cannot hang
+ *   the caller.
+ */
+type SendUserMessageResult = {
+    success: true;
+} | {
+    success: false;
+    peerDisconnected: true;
+    message: string;
+};
+export declare const sendUserMessageChannel: (clark: Clark, chatSessionStore: ChatSessionStore) => (payload: AiChatMessage, delay?: number, immediate?: boolean, { persistBeforeDeliver }?: SendUserMessageOptions) => Promise<SendUserMessageResult>;
+export declare const sendUserGenerationStateChannel: (clark: Clark) => (payload: Parameters<EditorClientMethods["aiSetGenerationState"]>[0]) => Promise<void>;
+/**
+ * Clears the pendingToolPermissionRequest from the FSM context and notifies the
+ * UI so it removes any stale permission prompt from the chat.
+ */
+export declare const clearPendingToolPermissionRequest: (clark: Clark, reason?: string) => void;
+export declare const sendChangeInfoChannel: (clark: Clark, chatSessionStore: ChatSessionStore) => (payload: AiChangeInfoPush, delay?: number) => Promise<void>;
+export {};
 //# sourceMappingURL=peer.d.ts.map

package/dist/ai-service/state-machine/helpers/peer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/peer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,eAAO,MAAM,sBAAsB,GAChC,OAAO,KAAK,MACZ,SAAS,UAAU,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,cAE5D,CAAC;AAEJ,eAAO,MAAM,yBAAyB,GACnC,OAAO,KAAK,MACN,SAAS,UAAU,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,uBAEnE,CAAC"}
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/peer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,uCAAuC,CAAC;AAI/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAwH7C;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,4BAA4B,GAC7B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjE;IACE,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,EACZ,kBAAkB,gBAAgB,MAIhC,SAAS,aAAa,EACtB,cAAS,EACT,mBAAiB,EACjB,UAAS;IACP,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,aAAa,CAAA;SAAE,KAAK,OAAO,CAAC;KACtE,CAAC;CACE,KACL,OAAO,CAAC,4BAA4B,CA0FxC,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,OAAO,KAAK,EACZ,kBAAkB,gBAAgB,KACjC,OAAO,CAAC,OAAO,CAcjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,KAAK,sBAAsB,GAAG;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,KAAK,qBAAqB,GACtB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,gBAAgB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAWhE,eAAO,MAAM,sBAAsB,GACjC,OAAO,KAAK,EACZ,kBAAkB,gBAAgB,MAIhC,SAAS,aAAa,EACtB,cAAS,EACT,mBAAiB,EACjB,2BAAkC,sBAA2B,KAC5D,OAAO,CAAC,qBAAqB,CAgEjC,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,OAAO,KAAK,MAEvD,SAAS,UAAU,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,kBA6DtE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,KAAK,EACZ,eAAsB,SAmCvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,KAAK,EACZ,kBAAkB,gBAAgB,MAGpB,SAAS,gBAAgB,EAAE,cAAS,kBAgBnD,CAAC"}