@vibes.diy/api-svc 14.3.107 → 14.3.110

package/intern/build-ledger-read.js

@@ -0,0 +1,220 @@
+import { exception2Result, Result } from "@adviser/cement";
+import { and, desc, eq, gte, inArray, isNull, ne, notInArray, or } from "drizzle-orm/sql/expressions";
+import { isBuildOrigin, isBuildPhase, isBuildSurface, LIST_BUILDS_DEFAULT_LIMIT, LIST_BUILDS_DEFAULT_WINDOW_MS, LIST_BUILDS_MAX_LIMIT, } from "@vibes.diy/api-types";
+import { AGENT_SESSION_RECORD_ID } from "./agent-session-store.js";
+import { readBuildTerminal } from "./agent-session-runtime.js";
+import { readChatAddress } from "./chat-address.js";
+import { classifyTurnError, QUEUE_TIMEOUT_ERROR } from "./turn-error-kind.js";
+import { CONVERSATION_TURN_PHASE } from "./build-ledger-store.js";
+export const BUILD_PROMPT_PREVIEW_CHARS = 80;
+const TURN_ROWS_PER_ITEM = 3;
+export const SETTLED_INTENT_STATUSES = ["done", "drafting", "drafted"];
+export function deriveBuildPhase(input) {
+    switch (input.turnStatus) {
+        case "swept":
+            return { phase: "failed", errorKind: "turn-lost" };
+        case "open":
+            return { phase: input.intentStatus === "agent" ? "deciding" : "building" };
+        case "closed":
+            return closedTurnPhase(input);
+    }
+    switch (input.intentStatus) {
+        case "agent":
+            return { phase: "deciding" };
+        case "agent-awaiting-files":
+        case "awaiting-files":
+            return { phase: "needs-you" };
+        case "parked":
+        case "retrying":
+            return { phase: "queued" };
+        case "failed":
+            return { phase: "failed" };
+        default:
+            return { phase: "requested" };
+    }
+}
+function closedTurnPhase(input) {
+    const terminal = input.terminal;
+    if (terminal?.applied === true)
+        return { phase: "ready" };
+    const errorKind = terminal?.error === undefined ? undefined : classifyTurnError(terminal.error);
+    if (errorKind === "turn-lost")
+        return { phase: "failed", errorKind };
+    if (terminal?.settled === true)
+        return { phase: input.intentStatus === "agent" ? "needs-you" : "unchanged" };
+    if (errorKind === "credits-exhausted")
+        return { phase: "out-of-credits", errorKind };
+    if (errorKind !== undefined)
+        return { phase: "failed", errorKind };
+    return { phase: "unchanged" };
+}
+function intentColumns(vctx) {
+    const t = vctx.sql.tables.mintJobs;
+    return {
+        chatId: t.chatId,
+        ownerHandle: t.ownerHandle,
+        appSlug: t.appSlug,
+        prompt: t.prompt,
+        status: t.status,
+        updated: t.updated,
+        phase: t.phase,
+        phaseSeq: t.phaseSeq,
+        surface: t.surface,
+        origin: t.origin,
+        originChatId: t.originChatId,
+        lastError: t.lastError,
+    };
+}
+function turnColumns(vctx) {
+    const t = vctx.sql.tables.openTurns;
+    return {
+        chatId: t.chatId,
+        promptId: t.promptId,
+        ownerHandle: t.ownerHandle,
+        appSlug: t.appSlug,
+        kind: t.kind,
+        status: t.status,
+        updated: t.updated,
+        phase: t.phase,
+        phaseSeq: t.phaseSeq,
+        errorKind: t.errorKind,
+        fsId: t.fsId,
+    };
+}
+function isBuildTurn(vctx) {
+    const ot = vctx.sql.tables.openTurns;
+    return and(ne(ot.promptId, AGENT_SESSION_RECORD_ID), or(isNull(ot.phase), ne(ot.phase, CONVERSATION_TURN_PHASE)));
+}
+export async function readBuild(vctx, args, readTerminal = readBuildTerminal) {
+    const mj = vctx.sql.tables.mintJobs;
+    const ot = vctx.sql.tables.openTurns;
+    const rTurn = await exception2Result(() => vctx.sql.db
+        .select(turnColumns(vctx))
+        .from(ot)
+        .where(and(eq(ot.userId, args.userId), eq(ot.chatId, args.chatId), isBuildTurn(vctx)))
+        .orderBy(desc(ot.updated))
+        .limit(1));
+    if (rTurn.isErr())
+        return Result.Err(rTurn);
+    const rIntent = await exception2Result(() => vctx.sql.db
+        .select(intentColumns(vctx))
+        .from(mj)
+        .where(and(eq(mj.userId, args.userId), eq(mj.chatId, args.chatId)))
+        .limit(1));
+    if (rIntent.isErr())
+        return Result.Err(rIntent);
+    const turn = rTurn.Ok()[0];
+    const intent = rIntent.Ok()[0];
+    if (turn === undefined && (intent === undefined || SETTLED_INTENT_STATUSES.includes(intent.status))) {
+        return Result.Ok(undefined);
+    }
+    return toItem(vctx, { chatId: args.chatId, turn, intent }, readTerminal);
+}
+export function clampListBuildsLimit(limit) {
+    if (limit === undefined || !Number.isFinite(limit))
+        return LIST_BUILDS_DEFAULT_LIMIT;
+    return Math.min(LIST_BUILDS_MAX_LIMIT, Math.max(1, Math.floor(limit)));
+}
+function windowStart(since, nowMs) {
+    const parsed = since === undefined ? Number.NaN : Date.parse(since);
+    return new Date(Number.isNaN(parsed) ? nowMs - LIST_BUILDS_DEFAULT_WINDOW_MS : parsed).toISOString();
+}
+export async function listBuilds(vctx, args, readTerminal = readBuildTerminal) {
+    const limit = clampListBuildsLimit(args.limit);
+    const since = windowStart(args.since, args.nowMs ?? Date.now());
+    const mj = vctx.sql.tables.mintJobs;
+    const ot = vctx.sql.tables.openTurns;
+    const rTurns = await exception2Result(() => vctx.sql.db
+        .select(turnColumns(vctx))
+        .from(ot)
+        .where(and(eq(ot.userId, args.userId), isBuildTurn(vctx), or(eq(ot.status, "open"), gte(ot.updated, since))))
+        .orderBy(desc(ot.updated))
+        .limit(limit * TURN_ROWS_PER_ITEM));
+    if (rTurns.isErr())
+        return Result.Err(rTurns);
+    const rIntents = await exception2Result(() => vctx.sql.db
+        .select(intentColumns(vctx))
+        .from(mj)
+        .where(and(eq(mj.userId, args.userId), notInArray(mj.status, [...SETTLED_INTENT_STATUSES]), gte(mj.updated, since)))
+        .orderBy(desc(mj.updated))
+        .limit(limit));
+    if (rIntents.isErr())
+        return Result.Err(rIntents);
+    const turnByChat = new Map();
+    for (const row of rTurns.Ok())
+        if (!turnByChat.has(row.chatId))
+            turnByChat.set(row.chatId, row);
+    const intentByChat = new Map(rIntents.Ok().map((row) => [row.chatId, row]));
+    const missing = [...turnByChat.keys()].filter((chatId) => !intentByChat.has(chatId));
+    if (missing.length > 0) {
+        const rMore = await exception2Result(() => vctx.sql.db
+            .select(intentColumns(vctx))
+            .from(mj)
+            .where(and(eq(mj.userId, args.userId), inArray(mj.chatId, missing))));
+        if (rMore.isErr())
+            return Result.Err(rMore);
+        for (const row of rMore.Ok())
+            intentByChat.set(row.chatId, row);
+    }
+    const chats = [...new Set([...turnByChat.keys(), ...intentByChat.keys()])]
+        .map((chatId) => ({ chatId, turn: turnByChat.get(chatId), intent: intentByChat.get(chatId) }))
+        .filter((c) => c.turn !== undefined || (c.intent !== undefined && !SETTLED_INTENT_STATUSES.includes(c.intent.status)))
+        .sort((a, b) => sortKey(b).localeCompare(sortKey(a)))
+        .slice(0, limit);
+    const items = await Promise.all(chats.map((c) => toItem(vctx, c, readTerminal)));
+    const failed = items.find((r) => r.isErr());
+    if (failed !== undefined)
+        return Result.Err(failed.Err());
+    return Result.Ok(items.map((r) => r.Ok()));
+}
+function sortKey(c) {
+    return c.turn?.updated ?? c.intent?.updated ?? "";
+}
+async function toItem(vctx, c, readTerminal) {
+    const { chatId, turn, intent } = c;
+    const live = intent !== undefined && !SETTLED_INTENT_STATUSES.includes(intent.status);
+    const kind = turn === undefined || turn.kind === "first-build" || (turn.kind === "codegen" && live) ? "first-build" : "edit";
+    const owner = turn ?? intent;
+    if (owner === undefined)
+        return Result.Err(`build ledger: no row for ${chatId}`);
+    const stamped = owner.phase !== null && isBuildPhase(owner.phase) ? owner.phase : undefined;
+    let terminal;
+    if (stamped === undefined && turn?.status === "closed") {
+        const rTerminal = await readTerminal(vctx, { chatId, promptId: turn.promptId });
+        if (rTerminal.isErr())
+            return Result.Err(rTerminal);
+        terminal = rTerminal.Ok();
+    }
+    const derived = stamped === undefined
+        ? deriveBuildPhase({ intentStatus: intent?.status, turnStatus: turn?.status, terminal })
+        : { phase: stamped, errorKind: undefined };
+    const rAddress = await readChatAddress(vctx.sql, chatId);
+    if (rAddress.isErr())
+        return Result.Err(rAddress);
+    const address = rAddress.Ok() ?? { ownerHandle: owner.ownerHandle, appSlug: owner.appSlug };
+    const queueTimedOut = turn === undefined && intent?.status === "failed" && intent.lastError === QUEUE_TIMEOUT_ERROR;
+    const errorKind = turn?.errorKind ?? derived.errorKind ?? (queueTimedOut ? QUEUE_TIMEOUT_ERROR : undefined);
+    const fsId = turn?.fsId ?? terminal?.landing?.fsId;
+    const surface = intent?.surface ?? undefined;
+    const origin = intent?.origin ?? undefined;
+    const originChatId = intent?.originChatId ?? undefined;
+    return Result.Ok({
+        chatId,
+        ...(turn === undefined ? {} : { promptId: turn.promptId }),
+        kind,
+        phase: derived.phase,
+        phaseAt: owner.updated,
+        phaseSeq: owner.phaseSeq,
+        ownerHandle: address.ownerHandle,
+        appSlug: address.appSlug,
+        ...(errorKind === undefined || errorKind === null ? {} : { errorKind }),
+        ...(fsId === undefined || fsId === null ? {} : { fsId }),
+        ...(kind === "first-build" && intent !== undefined
+            ? { promptPreview: intent.prompt.slice(0, BUILD_PROMPT_PREVIEW_CHARS) }
+            : {}),
+        ...(isBuildSurface(surface) ? { surface } : {}),
+        origin: isBuildOrigin(origin) ? origin : "prompt",
+        ...(originChatId === undefined || originChatId === null ? {} : { originChatId }),
+    });
+}
+//# sourceMappingURL=build-ledger-read.js.map

package/intern/build-ledger-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ledger-read.js","sourceRoot":"","sources":["../../jsr/intern/build-ledger-read.ts"],"names":[],"mappings":"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"}

package/intern/build-ledger-seams.d.ts

@@ -0,0 +1,27 @@
+import type { BuildPhase } from "@vibes.diy/api-types";
+import { type EmitBuildStateCtx } from "./emit-build-state.js";
+export declare function stampTurnOpened(vctx: EmitBuildStateCtx, args: {
+    readonly chatId: string;
+    readonly userId: string;
+    readonly opened: boolean;
+    readonly conversation: boolean;
+}): Promise<void>;
+export declare function erroredTurnPhase(message: string | undefined): {
+    phase: BuildPhase;
+    errorKind: string;
+};
+export declare function stampTurnErrored(vctx: EmitBuildStateCtx, args: {
+    readonly chatId: string;
+    readonly promptId: string;
+    readonly userId: string;
+    readonly conversation: boolean;
+    readonly message: string | undefined;
+}): Promise<void>;
+export declare function stampTurnSettled(vctx: EmitBuildStateCtx, args: {
+    readonly chatId: string;
+    readonly promptId: string;
+    readonly userId: string;
+    readonly conversation: boolean;
+    readonly errored: boolean;
+    readonly fsId: string | undefined;
+}): Promise<void>;

package/intern/build-ledger-seams.js

@@ -0,0 +1,65 @@
+import { BUILD_TURN_FROM, LIGHT_MINT_STATUSES } from "./build-ledger-store.js";
+import { scheduleBuildState, stampIntentAndEmit, stampTurnAndEmit } from "./emit-build-state.js";
+import { classifyTurnError } from "./turn-error-kind.js";
+const AGENT_DECIDING_FROM = [null, "requested", "needs-you", "failed", "out-of-credits"];
+export async function stampTurnOpened(vctx, args) {
+    if (args.conversation) {
+        await stampIntentAndEmit(vctx, {
+            chatId: args.chatId,
+            userId: args.userId,
+            phase: "deciding",
+            onlyFrom: AGENT_DECIDING_FROM,
+            onlyStatus: LIGHT_MINT_STATUSES,
+        });
+        return;
+    }
+    if (args.opened)
+        scheduleBuildState(vctx, { chatId: args.chatId, userId: args.userId });
+}
+export function erroredTurnPhase(message) {
+    const errorKind = classifyTurnError(message);
+    return { phase: errorKind === "credits-exhausted" ? "out-of-credits" : "failed", errorKind };
+}
+export async function stampTurnErrored(vctx, args) {
+    const { phase, errorKind } = erroredTurnPhase(args.message);
+    if (args.conversation) {
+        await stampIntentAndEmit(vctx, {
+            chatId: args.chatId,
+            userId: args.userId,
+            phase,
+            onlyFrom: [null, "requested", "deciding", "needs-you"],
+            onlyStatus: LIGHT_MINT_STATUSES,
+        });
+        return;
+    }
+    await stampTurnAndEmit(vctx, {
+        chatId: args.chatId,
+        promptId: args.promptId,
+        userId: args.userId,
+        phase,
+        onlyFrom: BUILD_TURN_FROM,
+        extra: { errorKind },
+    });
+}
+export async function stampTurnSettled(vctx, args) {
+    if (args.conversation) {
+        if (args.errored)
+            return;
+        await stampIntentAndEmit(vctx, {
+            chatId: args.chatId,
+            userId: args.userId,
+            phase: "needs-you",
+            onlyFrom: ["deciding"],
+            onlyStatus: LIGHT_MINT_STATUSES,
+        });
+        return;
+    }
+    await stampTurnAndEmit(vctx, {
+        chatId: args.chatId,
+        promptId: args.promptId,
+        userId: args.userId,
+        onlyFrom: BUILD_TURN_FROM,
+        ...(args.fsId === undefined ? { phase: "unchanged" } : { phase: "ready", extra: { fsId: args.fsId } }),
+    });
+}
+//# sourceMappingURL=build-ledger-seams.js.map

package/intern/build-ledger-seams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ledger-seams.js","sourceRoot":"","sources":["../../jsr/intern/build-ledger-seams.ts"],"names":[],"mappings":"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"}

package/intern/build-ledger-store.d.ts

@@ -0,0 +1,43 @@
+import { Result } from "@adviser/cement";
+import { type SQL } from "drizzle-orm";
+import { type BuildPhase } from "@vibes.diy/api-types";
+import type { VibesApiTables, VibesSqlite } from "@vibes.diy/api-sql";
+export interface BuildLedgerSql {
+    readonly db: VibesSqlite;
+    readonly tables: VibesApiTables;
+}
+export declare const CONVERSATION_TURN_PHASE: BuildPhase;
+export declare const BUILD_TURN_FROM: readonly (BuildPhase | null)[];
+export declare const LIGHT_MINT_STATUSES: readonly string[];
+export declare function intentPhaseForStatus(status: string): BuildPhase | undefined;
+export declare function bornIntentPhase(status: string): BuildPhase;
+export type PhaseStamp = {
+    readonly won: true;
+    readonly phaseSeq: number;
+} | {
+    readonly won: false;
+};
+export type PhaseGuard = readonly (BuildPhase | null)[];
+export declare function stampIntentPhase(sql: BuildLedgerSql, args: {
+    readonly chatId: string;
+    readonly phase: BuildPhase;
+    readonly onlyFrom?: PhaseGuard;
+    readonly onlyStatus?: readonly string[];
+    readonly nowMs?: number;
+}): Promise<Result<PhaseStamp>>;
+export interface TurnPhaseExtra {
+    readonly errorKind?: string;
+    readonly fsId?: string;
+    readonly submitId?: string;
+}
+export declare function stampTurnPhase(sql: BuildLedgerSql, args: {
+    readonly chatId: string;
+    readonly promptId: string;
+    readonly phase: BuildPhase;
+    readonly onlyFrom?: PhaseGuard;
+    readonly extra?: TurnPhaseExtra;
+    readonly nowMs?: number;
+}): Promise<Result<PhaseStamp>>;
+export declare function intentHandoffValues(tables: VibesApiTables, chatId: string): {
+    phaseSeq: SQL;
+};

package/intern/build-ledger-store.js

@@ -0,0 +1,78 @@
+import { exception2Result, Result } from "@adviser/cement";
+import { and, eq, inArray, isNull, notInArray, or } from "drizzle-orm/sql/expressions";
+import { sql as sqlExpr } from "drizzle-orm";
+import { TERMINAL_BUILD_PHASES } from "@vibes.diy/api-types";
+export const CONVERSATION_TURN_PHASE = "deciding";
+export const BUILD_TURN_FROM = [null, "building"];
+export const LIGHT_MINT_STATUSES = ["agent", "agent-unfired", "agent-awaiting-files"];
+export function intentPhaseForStatus(status) {
+    switch (status) {
+        case "parked":
+            return "queued";
+        case "failed":
+            return "failed";
+        case "awaiting-files":
+        case "agent-awaiting-files":
+            return "needs-you";
+        default:
+            return undefined;
+    }
+}
+export function bornIntentPhase(status) {
+    return intentPhaseForStatus(status) ?? "requested";
+}
+function phaseGuard(column, onlyFrom) {
+    if (onlyFrom === undefined) {
+        return or(isNull(column), notInArray(column, [...TERMINAL_BUILD_PHASES]));
+    }
+    const named = onlyFrom.filter((p) => p !== null);
+    const allowsNull = onlyFrom.includes(null);
+    const arms = [...(named.length === 0 ? [] : [inArray(column, named)]), ...(allowsNull ? [isNull(column)] : [])];
+    return arms.length === 0 ? sqlExpr `1 = 0` : or(...arms);
+}
+function toStamp(rows) {
+    const row = rows[0];
+    return row === undefined ? { won: false } : { won: true, phaseSeq: row.phaseSeq };
+}
+export async function stampIntentPhase(sql, args) {
+    const t = sql.tables.mintJobs;
+    const statusGuard = args.onlyStatus === undefined ? undefined : inArray(t.status, [...args.onlyStatus]);
+    const r = await exception2Result(() => sql.db
+        .update(t)
+        .set({
+        phase: args.phase,
+        phaseSeq: sqlExpr `${t.phaseSeq} + 1`,
+        updated: new Date(args.nowMs ?? Date.now()).toISOString(),
+    })
+        .where(and(eq(t.chatId, args.chatId), phaseGuard(t.phase, args.onlyFrom), statusGuard))
+        .returning({ phaseSeq: t.phaseSeq }));
+    if (r.isErr())
+        return Result.Err(r);
+    return Result.Ok(toStamp(r.Ok()));
+}
+export async function stampTurnPhase(sql, args) {
+    const t = sql.tables.openTurns;
+    const extra = args.extra ?? {};
+    const r = await exception2Result(() => sql.db
+        .update(t)
+        .set({
+        phase: args.phase,
+        phaseSeq: sqlExpr `${t.phaseSeq} + 1`,
+        updated: new Date(args.nowMs ?? Date.now()).toISOString(),
+        ...(extra.errorKind === undefined ? {} : { errorKind: extra.errorKind }),
+        ...(extra.fsId === undefined ? {} : { fsId: extra.fsId }),
+        ...(extra.submitId === undefined ? {} : { submitId: extra.submitId }),
+    })
+        .where(and(eq(t.chatId, args.chatId), eq(t.promptId, args.promptId), phaseGuard(t.phase, args.onlyFrom)))
+        .returning({ phaseSeq: t.phaseSeq }));
+    if (r.isErr())
+        return Result.Err(r);
+    return Result.Ok(toStamp(r.Ok()));
+}
+export function intentHandoffValues(tables, chatId) {
+    const mj = tables.mintJobs;
+    return {
+        phaseSeq: sqlExpr `coalesce((select ${mj.phaseSeq} from ${mj} where ${mj.chatId} = ${chatId}), 0) + 1`,
+    };
+}
+//# sourceMappingURL=build-ledger-store.js.map

package/intern/build-ledger-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ledger-store.js","sourceRoot":"","sources":["../../jsr/intern/build-ledger-store.ts"],"names":[],"mappings":"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"}

package/intern/emit-build-state.d.ts

@@ -0,0 +1,21 @@
+import type { UserNotifyEvent } from "@vibes.diy/api-types";
+import type { VibesApiSQLCtx } from "../types.js";
+import { stampIntentPhase, stampTurnPhase, type PhaseStamp } from "./build-ledger-store.js";
+export interface EmitBuildStateCtx {
+    readonly sql: VibesApiSQLCtx["sql"];
+    readonly logger: VibesApiSQLCtx["logger"];
+    notifyUser?(userId: string, evt: UserNotifyEvent, senderConnId: string): Promise<void>;
+    waitUntil?(promise: Promise<unknown>): void;
+}
+export interface BuildStateTarget {
+    readonly chatId: string;
+    readonly userId?: string;
+}
+export declare function emitBuildState(vctx: EmitBuildStateCtx, target: BuildStateTarget): Promise<boolean>;
+export declare function scheduleBuildState(vctx: EmitBuildStateCtx, target: BuildStateTarget): void;
+export declare function stampIntentAndEmit(vctx: EmitBuildStateCtx, args: Parameters<typeof stampIntentPhase>[1] & {
+    readonly userId?: string;
+}): Promise<PhaseStamp>;
+export declare function stampTurnAndEmit(vctx: EmitBuildStateCtx, args: Parameters<typeof stampTurnPhase>[1] & {
+    readonly userId: string;
+}): Promise<PhaseStamp>;

package/intern/emit-build-state.js

@@ -0,0 +1,72 @@
+import { exception2Result, Result } from "@adviser/cement";
+import { eq } from "drizzle-orm/sql/expressions";
+import { readBuild } from "./build-ledger-read.js";
+import { stampIntentPhase, stampTurnPhase } from "./build-ledger-store.js";
+import { followGuestPrincipal } from "./guest-principal-owner.js";
+async function ownerOf(vctx, target) {
+    if (target.userId !== undefined)
+        return Result.Ok(await followGuestPrincipal(vctx, target.userId));
+    const mj = vctx.sql.tables.mintJobs;
+    const r = await exception2Result(() => vctx.sql.db.select({ userId: mj.userId }).from(mj).where(eq(mj.chatId, target.chatId)).limit(1));
+    if (r.isErr())
+        return Result.Err(r);
+    return Result.Ok(r.Ok()[0]?.userId);
+}
+export async function emitBuildState(vctx, target) {
+    const notifyUser = vctx.notifyUser?.bind(vctx);
+    if (notifyUser === undefined)
+        return false;
+    const r = await exception2Result(async () => {
+        const rUser = await ownerOf(vctx, target);
+        if (rUser.isErr())
+            throw rUser.Err();
+        const userId = rUser.Ok();
+        if (userId === undefined)
+            return false;
+        const rItem = await readBuild(vctx, { userId, chatId: target.chatId });
+        if (rItem.isErr())
+            throw rItem.Err();
+        const build = rItem.Ok();
+        if (build === undefined)
+            return false;
+        await notifyUser(userId, { type: "vibes.diy.evt-build-state", build }, "");
+        return true;
+    });
+    if (r.isErr()) {
+        vctx.logger.Warn().Err(r).Str("chatId", target.chatId).Msg("build-state-emit-failed");
+        return false;
+    }
+    return r.Ok();
+}
+export function scheduleBuildState(vctx, target) {
+    if (vctx.notifyUser === undefined)
+        return;
+    const p = emitBuildState(vctx, target);
+    if (vctx.waitUntil !== undefined)
+        vctx.waitUntil(p);
+    else
+        void p;
+}
+function logLost(vctx, chatId, phase, err) {
+    vctx.logger.Warn().Err(err).Str("chatId", chatId).Str("phase", phase).Msg("build-phase-stamp-failed");
+    return { won: false };
+}
+export async function stampIntentAndEmit(vctx, args) {
+    const { userId, ...stamp } = args;
+    const r = await stampIntentPhase(vctx.sql, stamp);
+    if (r.isErr())
+        return logLost(vctx, args.chatId, args.phase, r.Err());
+    if (r.Ok().won)
+        scheduleBuildState(vctx, { chatId: args.chatId, ...(userId === undefined ? {} : { userId }) });
+    return r.Ok();
+}
+export async function stampTurnAndEmit(vctx, args) {
+    const { userId, ...stamp } = args;
+    const r = await stampTurnPhase(vctx.sql, stamp);
+    if (r.isErr())
+        return logLost(vctx, args.chatId, args.phase, r.Err());
+    if (r.Ok().won)
+        scheduleBuildState(vctx, { chatId: args.chatId, userId });
+    return r.Ok();
+}
+//# sourceMappingURL=emit-build-state.js.map

package/intern/emit-build-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-build-state.js","sourceRoot":"","sources":["../../jsr/intern/emit-build-state.ts"],"names":[],"mappings":"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"}

package/intern/ensure-chat-id.d.ts

@@ -1,8 +1,9 @@
 import { VibesApiSQLCtx } from "../types.js";
 import { Result } from "@adviser/cement";
 import { type MintDecision } from "./mint-decision.js";
+import { type IntentLedgerFields } from "./mint-job-store.js";
 import { type GenerationVariety, type VarietyPin } from "@vibes.diy/prompts";
-import { type AppNature, ReqOpenChat, ReqWithVerifiedAuth, type Style } from "@vibes.diy/api-types";
+import { type AppNature, ReqOpenChat, ReqWithVerifiedAuth, type Style, type BuildSurface } from "@vibes.diy/api-types";
 export declare const DRY_RUN_PLACEHOLDER_HANDLE = "dry-run-preview";
 export declare const DRY_RUN_PLACEHOLDER_APP_SLUG = "dry-run-preview";
 export declare function preAllocEligible(req: {
@@ -33,7 +34,11 @@ export interface EnsureChatIdOpts {
     readonly decision?: MintDecision;
     readonly lightMint?: boolean;
     readonly lightMintUnfired?: boolean;
+    readonly ledger?: IntentLedgerFields;
 }
+export declare function intentSurface(ctx: Pick<VibesApiSQLCtx, "client">, req: {
+    readonly surface?: BuildSurface;
+}): BuildSurface | undefined;
 export declare function ensureChatId(ctx: VibesApiSQLCtx, req: ReqWithVerifiedAuth<ReqOpenChat>, opts?: EnsureChatIdOpts): Promise<Result<EnsureChatIdPResult>>;
 export declare function agentChatIdFor(userId: string, ownerHandle: string): string;
 export declare function writePreAllocActiveEntries(ctx: VibesApiSQLCtx, { userId, ownerHandle, appSlug, title, skills, iconDescription, theme, enrichedPrompt, privacySensitive, nature, variety, varietyPinned, textureNote, style, colorTheme, stylePinned, }: {

package/intern/ensure-chat-id.js

@@ -102,6 +102,11 @@ export function resolveStylePin(raw, themeSlug) {
     const checked = validateColorwayPinForLook(raw, themeSlug);
     return checked.ok ? Result.Ok(checked.slug) : Result.Err(checked.message);
 }
+export function intentSurface(ctx, req) {
+    if (req.surface !== undefined)
+        return req.surface;
+    return ctx.client?.kind === "cli" ? "cli" : undefined;
+}
 export async function ensureChatId(ctx, req, opts = {}) {
     if (req.firstBuildRequestId === undefined)
         return ensureChatIdInternal(ctx, req, opts);
@@ -301,7 +306,10 @@ async function ensureChatIdInternal(ctx, req, opts = {}) {
             if (preAllocEligible(req)) {
                 const mintPrompt = req.prompt;
                 const lightMintStatus = opts.lightMintUnfired === true ? "agent-unfired" : "agent";
+                const surface = opts.ledger?.surface ?? intentSurface(ctx, req);
+                const ledger = { ...opts.ledger, ...(surface === undefined ? {} : { surface }) };
                 mintJobOrder = upsertPendingMintJob(ctx, {
+                    ledger,
                     chatId,
                     userId,
                     ownerHandle,