@vibes.diy/api-svc 14.3.83 → 14.3.84

package/intern/first-brief.d.ts

@@ -0,0 +1,58 @@
+import { type Result } from "@adviser/cement";
+import { type LLMMessage, type SseStreamMsg, type ToolDefinition } from "@vibes.diy/call-ai-v2";
+import type { AgentEvidence } from "@vibes.diy/api-types";
+import type { VibesApiSQLCtx } from "../types.js";
+export type FirstBriefSkip = "no-create-call" | "create-refused";
+export declare function firstBriefTurnEligible(t: {
+    readonly wakeTurn: boolean;
+    readonly topLevel: boolean;
+    readonly personWords: string;
+    readonly linkedUrls: number;
+}): boolean;
+export declare function firstBriefTools(definitions: readonly ToolDefinition[]): ToolDefinition[];
+export declare function withFirstBriefLine(messages: readonly LLMMessage[], words: readonly string[]): LLMMessage[];
+export declare function withSeededAddressWordsLine(messages: readonly LLMMessage[], words: readonly string[]): LLMMessage[];
+export declare function withoutFirstBriefLine(messages: readonly LLMMessage[]): LLMMessage[];
+export declare const FIRST_BRIEF_CONTINUE_NOTE = "[platform] Your reply above has reached the person, and every tool is yours again for the rest of this turn. Carry on from it as you would in any turn: finish with offer_options when options fit, and keep what you already said as said.";
+export declare function withFirstBriefContinueNote(messages: readonly LLMMessage[]): LLMMessage[];
+export interface FirstBriefUsage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly total_tokens: number;
+    readonly cost?: number;
+}
+export interface FirstBriefRound {
+    readonly servedModel?: string;
+    readonly called: boolean;
+    readonly elapsedMs: number;
+    readonly usage: readonly FirstBriefUsage[];
+}
+export declare function observeFirstBriefRound(stream: ReadableStream<SseStreamMsg>, o: {
+    readonly startedAt: number;
+    readonly now: () => number;
+    readonly onEnd: (round: FirstBriefRound) => Promise<void>;
+}): ReadableStream<SseStreamMsg>;
+export declare function recordFirstBriefRow(vctx: VibesApiSQLCtx, o: {
+    readonly chatId: string;
+    readonly userId: string;
+    readonly model: string;
+    readonly round: FirstBriefRound;
+}): Promise<void>;
+export type FirstBriefOutcome = {
+    readonly dispatched: true;
+    readonly appSlug: string;
+    readonly addressRetried?: true;
+} | {
+    readonly dispatched: false;
+    readonly reason: FirstBriefSkip;
+    readonly refusal?: string;
+    readonly addressRetried?: true;
+};
+export declare function recordFirstBriefOutcome(vctx: VibesApiSQLCtx, o: {
+    readonly chatId: string;
+    readonly model: string;
+    readonly round: FirstBriefRound | undefined;
+    readonly outcome: FirstBriefOutcome;
+    readonly evidence: (e: AgentEvidence) => Promise<Result<void>>;
+}): Promise<void>;
+export declare function firstBriefOutcomeFromReceipt(text: string): FirstBriefOutcome;

package/intern/first-brief.js

@@ -0,0 +1,168 @@
+import { exception2Result } from "@adviser/cement";
+import { type } from "arktype";
+import { isSseEnd, isSseLine, } from "@vibes.diy/call-ai-v2";
+import { FIRST_BRIEF_ROUND_TAG, firstBriefRoundInstruction, SEEDED_ADDRESS_WORDS_TAG, seededAddressWordsInstruction, } from "./instruction-variant.js";
+import { SERVER_FIRST_BUILD_EVIDENCE_NAME } from "./server-first-build.js";
+const CREATE_VIBE = "create_vibe";
+export function firstBriefTurnEligible(t) {
+    return t.wakeTurn === false && t.topLevel === false && t.personWords.length > 0 && t.linkedUrls === 0;
+}
+export function firstBriefTools(definitions) {
+    return definitions.filter((d) => d.function.name === CREATE_VIBE);
+}
+const ROUND_ONE_LINE_TAGS = [FIRST_BRIEF_ROUND_TAG, SEEDED_ADDRESS_WORDS_TAG];
+function isRoundOneLine(part) {
+    return (typeof part === "object" &&
+        part !== null &&
+        part.type === "text" &&
+        typeof part.text === "string" &&
+        ROUND_ONE_LINE_TAGS.some((tag) => part.text.startsWith(tag)));
+}
+function withRoundOneLine(messages, text) {
+    let at = -1;
+    messages.forEach((m, i) => {
+        if (m.role === "system")
+            at = i;
+    });
+    if (at < 0)
+        return [...messages];
+    return messages.map((m, i) => {
+        if (i !== at || m.role !== "system" || Array.isArray(m.content) === false)
+            return m;
+        return { ...m, content: [...m.content, { type: "text", text }] };
+    });
+}
+export function withFirstBriefLine(messages, words) {
+    return withRoundOneLine(messages, firstBriefRoundInstruction(words));
+}
+export function withSeededAddressWordsLine(messages, words) {
+    return withRoundOneLine(messages, seededAddressWordsInstruction(words));
+}
+export function withoutFirstBriefLine(messages) {
+    return messages.map((m) => {
+        if (m.role !== "system" || Array.isArray(m.content) === false || m.content.some(isRoundOneLine) === false)
+            return m;
+        return { ...m, content: m.content.filter((part) => isRoundOneLine(part) === false) };
+    });
+}
+export const FIRST_BRIEF_CONTINUE_NOTE = "[platform] Your reply above has reached the person, and every tool is yours again for the rest of this turn. Carry on from it as you would in any turn: finish with offer_options when options fit, and keep what you already said as said.";
+export function withFirstBriefContinueNote(messages) {
+    return [...messages, { role: "user", content: [{ type: "text", text: FIRST_BRIEF_CONTINUE_NOTE }] }];
+}
+const usageShape = type({ prompt_tokens: "number", completion_tokens: "number", total_tokens: "number", "cost?": "number" });
+function readUsage(raw) {
+    const u = usageShape(raw);
+    if (u instanceof type.errors)
+        return undefined;
+    return {
+        prompt_tokens: u.prompt_tokens,
+        completion_tokens: u.completion_tokens,
+        total_tokens: u.total_tokens,
+        ...(u.cost === undefined ? {} : { cost: u.cost }),
+    };
+}
+export function observeFirstBriefRound(stream, o) {
+    let servedModel;
+    let ended = false;
+    const names = new Map();
+    return stream.pipeThrough(new TransformStream({
+        async transform(msg, controller) {
+            if (isSseLine(msg)) {
+                if (msg.chunk.model.length > 0)
+                    servedModel = msg.chunk.model;
+                for (const choice of msg.chunk.choices) {
+                    for (const delta of choice.delta.tool_calls ?? []) {
+                        const name = delta.function?.name;
+                        if (name !== undefined)
+                            names.set(delta.index, (names.get(delta.index) ?? "") + name);
+                    }
+                }
+            }
+            else if (isSseEnd(msg) && ended === false) {
+                ended = true;
+                await o.onEnd({
+                    ...(servedModel === undefined ? {} : { servedModel }),
+                    called: [...names.values()].includes(CREATE_VIBE),
+                    elapsedMs: o.now() - o.startedAt,
+                    usage: msg.usages.flatMap((u) => {
+                        const read = readUsage(u);
+                        return read === undefined ? [] : [read];
+                    }),
+                });
+            }
+            controller.enqueue(msg);
+        },
+    }));
+}
+export async function recordFirstBriefRow(vctx, o) {
+    const zero = { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+    const rInsert = await exception2Result(() => vctx.sql.db.insert(vctx.sql.tables.promptContexts).values({
+        userId: o.userId,
+        chatId: o.chatId,
+        promptId: vctx.sthis.nextId(12).str,
+        nethash: vctx.netHash(),
+        promptTokens: 0,
+        completionTokens: 0,
+        totalTokens: 0,
+        ref: {
+            type: "prompt.usage.sql",
+            usage: { given: [], calculated: zero },
+            model: o.model,
+            step: "first-brief",
+            firstBrief: {
+                ...(o.round.servedModel === undefined ? {} : { servedModel: o.round.servedModel }),
+                called: o.round.called,
+                elapsedMs: o.round.elapsedMs,
+                usage: o.round.usage.map((u) => ({ ...u })),
+            },
+        },
+        created: new Date().toISOString(),
+    }));
+    if (rInsert.isErr()) {
+        vctx.logger.Warn().Err(rInsert).Str("chatId", o.chatId).Msg("first-brief-row-failed");
+    }
+}
+export async function recordFirstBriefOutcome(vctx, o) {
+    const brief = {
+        model: o.model,
+        ...(o.round?.servedModel === undefined ? {} : { servedModel: o.round.servedModel }),
+        ...(o.round === undefined ? {} : { called: o.round.called, elapsedMs: o.round.elapsedMs }),
+    };
+    const written = await o.evidence({
+        kind: "receipt",
+        name: SERVER_FIRST_BUILD_EVIDENCE_NAME,
+        text: JSON.stringify({ ...o.outcome, brief }),
+    });
+    if (written.isErr())
+        vctx.logger.Warn().Err(written).Str("chatId", o.chatId).Msg("first-brief-evidence-failed");
+    if (o.outcome.dispatched) {
+        vctx.logger
+            .Info()
+            .Any("event", {
+            chatId: o.chatId,
+            appSlug: o.outcome.appSlug,
+            ...(o.outcome.addressRetried === true ? { addressRetried: true } : {}),
+            briefMs: o.round?.elapsedMs,
+            servedModel: o.round?.servedModel,
+        })
+            .Msg("first-brief-dispatched");
+    }
+    else {
+        vctx.logger
+            .Warn()
+            .Any("event", { chatId: o.chatId, reason: o.outcome.reason, servedModel: o.round?.servedModel })
+            .Msg(o.outcome.reason === "no-create-call" ? "first-brief-no-create" : "first-brief-create-refused");
+    }
+}
+const createReceipt = type({ "ok?": "boolean", "appSlug?": "string", "reason?": "string" });
+export function firstBriefOutcomeFromReceipt(text) {
+    const rJson = exception2Result(() => JSON.parse(text));
+    const body = rJson.isOk() ? createReceipt(rJson.Ok()) : undefined;
+    if (body === undefined || body instanceof type.errors)
+        return { dispatched: false, reason: "create-refused" };
+    if (body.ok === false || body.appSlug === undefined) {
+        return { dispatched: false, reason: "create-refused", ...(body.reason === undefined ? {} : { refusal: body.reason }) };
+    }
+    return { dispatched: true, appSlug: body.appSlug };
+}
+//# sourceMappingURL=first-brief.js.map

package/intern/first-brief.js.map

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

package/intern/first-build-classifier.d.ts

@@ -0,0 +1,88 @@
+import { Result } from "@adviser/cement";
+import { AppNature, type CreateVibeToolInput } from "@vibes.diy/api-types";
+import type { VibesApiSQLCtx } from "../types.js";
+export declare const FIRST_BUILD_CLASSIFIER_MODEL = "google/gemini-3.5-flash-lite";
+export declare const FIRST_BUILD_CLASSIFIER_REASONING: {
+    readonly effort: "minimal";
+};
+export declare const FIRST_BUILD_CLASSIFIER_TIMEOUT_MS = 3000;
+export declare const SERVER_FIRST_BUILD_ACCESS_SKILL = "access";
+export declare function firstBuildSkillMenu(opts: {
+    readonly poufBlocks: boolean;
+}): Promise<string>;
+export declare function firstBuildClassifierMessage(personWords: string, skillMenu: string): string;
+export declare const firstBuildClassifierSchema: {
+    readonly name: "first_build";
+    readonly required: readonly ["build", "skills", "pairs", "iconDescription", "nature", "noAccessControl"];
+    readonly properties: {
+        readonly build: {
+            readonly type: "boolean";
+        };
+        readonly skills: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly pairs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly iconDescription: {
+            readonly type: "string";
+        };
+        readonly nature: {
+            readonly type: "string";
+            readonly enum: readonly ["sensitive", "collaborative", "open"];
+        };
+        readonly noAccessControl: {
+            readonly type: "boolean";
+        };
+    };
+};
+export interface FirstBuildUsage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly total_tokens: number;
+    readonly cost?: number;
+}
+export interface FirstBuildVerdict {
+    readonly build: boolean;
+    readonly skills: readonly string[];
+    readonly pairs: readonly {
+        readonly title: string;
+        readonly slug: string;
+    }[];
+    readonly iconDescription?: string;
+    readonly nature?: AppNature;
+    readonly noAccessControl: boolean;
+    readonly model: string;
+    readonly usage?: FirstBuildUsage;
+    readonly elapsedMs: number;
+}
+export declare function parseFirstBuildVerdict(raw: unknown, meta: {
+    readonly model: string;
+    readonly usage?: FirstBuildUsage;
+    readonly elapsedMs: number;
+}): Result<FirstBuildVerdict>;
+export declare function serverFirstBuildBrief(personWords: string, o: {
+    readonly noAccessControl: boolean;
+}): string;
+export declare function createVibeInputFromVerdict(personWords: string, verdict: FirstBuildVerdict): CreateVibeToolInput;
+export interface ClassifyFirstBuildArgs {
+    readonly chatId: string;
+    readonly userId: string;
+    readonly personWords: string;
+    readonly timeoutMs?: number;
+}
+export declare function classifyFirstBuild(vctx: VibesApiSQLCtx, args: ClassifyFirstBuildArgs): Promise<Result<FirstBuildVerdict>>;

package/intern/first-build-classifier.js

@@ -0,0 +1,241 @@
+import { Result, exception2Result } from "@adviser/cement";
+import { callAI } from "call-ai";
+import { type } from "arktype";
+import { AppNature } from "@vibes.diy/api-types";
+import { getLlmCatalog } from "@vibes.diy/prompts";
+import { isPoufBlockSkill, poufLookFor } from "./pouf-look-flag.js";
+import { GROUP_READY_SHAPE, INVITE_SCREEN_WHEN, KNOWN_VALUES_DIRECT_CONTROLS, SEED_DEMO_RULE, } from "./agent-session-instruction.js";
+export const FIRST_BUILD_CLASSIFIER_MODEL = "google/gemini-3.5-flash-lite";
+export const FIRST_BUILD_CLASSIFIER_REASONING = { effort: "minimal" };
+export const FIRST_BUILD_CLASSIFIER_TIMEOUT_MS = 3_000;
+const ALWAYS_PRESENT_SKILLS = new Set(["fireproof", "image-gen", "use-vibe", "use-viewer"]);
+export const SERVER_FIRST_BUILD_ACCESS_SKILL = "access";
+const SKILL_LINE_MAX_CHARS = 110;
+function shortDescription(description) {
+    const flat = description.replace(/\s+/g, " ").trim();
+    if (flat.length <= SKILL_LINE_MAX_CHARS)
+        return flat;
+    const cut = flat.slice(0, SKILL_LINE_MAX_CHARS);
+    const space = cut.lastIndexOf(" ");
+    return `${space > 40 ? cut.slice(0, space) : cut}…`;
+}
+export async function firstBuildSkillMenu(opts) {
+    const catalog = await getLlmCatalog();
+    return catalog
+        .filter((c) => ALWAYS_PRESENT_SKILLS.has(c.name) === false && c.name !== SERVER_FIRST_BUILD_ACCESS_SKILL)
+        .filter((c) => opts.poufBlocks || isPoufBlockSkill(c.name) === false)
+        .map((c) => `- ${c.name}: ${shortDescription(c.description)}`)
+        .join("\n");
+}
+export function firstBuildClassifierMessage(personWords, skillMenu) {
+    return [
+        "Read one message a person sent to an app builder and fill the schema.",
+        "build: true when the message describes an app, tool, game, page, tracker or anything else to make — however short. " +
+            "build: false for a greeting, a question about the builder itself, or a message that names nothing to make.",
+        "skills: the names from the list below that the app needs, exactly as written; an empty list when none fit. " +
+            '"backend" for schedules, email, fetching, notifications and server work; ' +
+            '"callai" for record intake by sentence, a chat reply, a suggestion or any text the page asks the model for itself. ' +
+            "Access rules ride every build already.",
+        "noAccessControl: true only when the message itself asks for no access control, a single-user app or no sharing; false otherwise.",
+        "pairs: three title/slug pairs ranked by fit — a Title Case title of one to four words, and a kebab-case slug made from it.",
+        "iconDescription: one short line naming what the app's icon shows, such as 'a fox on a record player'.",
+        'nature: "sensitive" for private record-keeping (a diary, health, money), "open" for a light toy anyone can play with, "collaborative" for everything else.',
+        "",
+        "Skills:",
+        skillMenu,
+        "",
+        "Message:",
+        personWords,
+    ].join("\n");
+}
+export const firstBuildClassifierSchema = {
+    name: "first_build",
+    required: ["build", "skills", "pairs", "iconDescription", "nature", "noAccessControl"],
+    properties: {
+        build: { type: "boolean" },
+        skills: { type: "array", items: { type: "string" } },
+        pairs: {
+            type: "array",
+            items: { type: "object", properties: { title: { type: "string" }, slug: { type: "string" } } },
+        },
+        iconDescription: { type: "string" },
+        nature: { type: "string", enum: ["sensitive", "collaborative", "open"] },
+        noAccessControl: { type: "boolean" },
+    },
+};
+const firstBuildParsed = type({
+    build: "boolean",
+    "skills?": "string[]",
+    "pairs?": type({ "title?": "string", "slug?": "string" }).array(),
+    "iconDescription?": "string",
+    "nature?": "string",
+    "noAccessControl?": "boolean",
+});
+export function parseFirstBuildVerdict(raw, meta) {
+    const parsed = firstBuildParsed(raw);
+    if (parsed instanceof type.errors)
+        return Result.Err(`first-build classifier: schema validation failed: ${parsed.summary}`);
+    const pairs = (parsed.pairs ?? []).flatMap((p) => {
+        const title = (p.title ?? "").trim();
+        const slug = (p.slug ?? "").trim();
+        return title.length > 0 && slug.length > 0 ? [{ title, slug }] : [];
+    });
+    const icon = (parsed.iconDescription ?? "").trim();
+    const nature = AppNature(parsed.nature);
+    return Result.Ok({
+        build: parsed.build,
+        skills: (parsed.skills ?? []).map((s) => s.trim()).filter((s) => s.length > 0),
+        pairs,
+        ...(icon.length === 0 ? {} : { iconDescription: icon }),
+        ...(nature instanceof type.errors ? {} : { nature }),
+        noAccessControl: parsed.noAccessControl === true,
+        model: meta.model,
+        ...(meta.usage === undefined ? {} : { usage: meta.usage }),
+        elapsedMs: meta.elapsedMs,
+    });
+}
+export function serverFirstBuildBrief(personWords, o) {
+    return [
+        ...(o.noAccessControl
+            ? []
+            : [
+                `This first build is group-ready: ${GROUP_READY_SHAPE}`,
+                `${INVITE_SCREEN_WHEN}; every other first build leaves it as an option for later.`,
+            ]),
+        `Sample content: ${SEED_DEMO_RULE}`,
+        KNOWN_VALUES_DIRECT_CONTROLS,
+        `The person asked: "${personWords}". Plan the app from their words.`,
+    ].join("\n");
+}
+function serverFirstBuildSkills(verdict) {
+    const picked = verdict.skills.filter((s) => s !== SERVER_FIRST_BUILD_ACCESS_SKILL);
+    if (verdict.noAccessControl)
+        return picked;
+    return verdict.skills.includes(SERVER_FIRST_BUILD_ACCESS_SKILL)
+        ? [...verdict.skills]
+        : [...picked, SERVER_FIRST_BUILD_ACCESS_SKILL];
+}
+export function createVibeInputFromVerdict(personWords, verdict) {
+    return {
+        prompt: personWords,
+        enrichedPrompt: serverFirstBuildBrief(personWords, { noAccessControl: verdict.noAccessControl }),
+        skills: serverFirstBuildSkills(verdict),
+        pairs: verdict.pairs.map((p) => ({ ...p })),
+        ...(verdict.iconDescription === undefined ? {} : { iconDescription: verdict.iconDescription }),
+        ...(verdict.nature === undefined ? {} : { nature: verdict.nature }),
+    };
+}
+function numberField(o, key) {
+    const v = o[key];
+    return typeof v === "number" && Number.isFinite(v) ? v : undefined;
+}
+function readEcho(json, echo) {
+    if (typeof json !== "object" || json === null)
+        return;
+    const body = json;
+    if (typeof body.model === "string")
+        echo.model = body.model;
+    const usage = body.usage;
+    if (typeof usage !== "object" || usage === null)
+        return;
+    const u = usage;
+    const prompt = numberField(u, "prompt_tokens");
+    const completion = numberField(u, "completion_tokens");
+    if (prompt === undefined || completion === undefined)
+        return;
+    const cost = numberField(u, "cost");
+    echo.usage = {
+        prompt_tokens: prompt,
+        completion_tokens: completion,
+        total_tokens: numberField(u, "total_tokens") ?? prompt + completion,
+        ...(cost === undefined ? {} : { cost }),
+    };
+}
+function classifierFetch(inner, signal, echo) {
+    return async (input, init) => {
+        const body = typeof init?.body === "string" ? init.body : undefined;
+        const rBody = body === undefined ? undefined : exception2Result(() => JSON.parse(body));
+        const patchedBody = rBody !== undefined && rBody.isOk()
+            ? JSON.stringify({ ...rBody.Ok(), reasoning: { ...FIRST_BUILD_CLASSIFIER_REASONING }, usage: { include: true } })
+            : body;
+        const res = await inner(input, { ...init, ...(patchedBody === undefined ? {} : { body: patchedBody }), signal });
+        const rJson = await exception2Result(() => res.clone().json());
+        if (rJson.isOk())
+            readEcho(rJson.Ok(), echo);
+        return res;
+    };
+}
+export async function classifyFirstBuild(vctx, args) {
+    return exception2Result(() => classify(vctx, args));
+}
+async function classify(vctx, args) {
+    if (args.personWords.trim().length === 0)
+        return Result.Err("first-build classifier: no words to classify");
+    if (vctx.billing.enforceEnabled) {
+        const rCheck = await vctx.billing.checkCredits({ userId: args.userId });
+        if (rCheck.isOk() && rCheck.Ok().allowed === false)
+            return Result.Err("first-build classifier: no credits remaining");
+    }
+    const message = firstBuildClassifierMessage(args.personWords, await firstBuildSkillMenu({ poufBlocks: poufLookFor(vctx, args.userId) }));
+    const timeoutMs = args.timeoutMs ?? FIRST_BUILD_CLASSIFIER_TIMEOUT_MS;
+    const controller = new AbortController();
+    const echo = {};
+    const startedAt = Date.now();
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            reject(new Error(`first-build classifier timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    const rCall = await exception2Result(() => Promise.race([
+        callAI(message, {
+            model: FIRST_BUILD_CLASSIFIER_MODEL,
+            endpoint: vctx.params.llm.url,
+            apiKey: vctx.params.llm.apiKey,
+            mock: { fetch: classifierFetch(vctx.inferenceFetch, controller.signal, echo) },
+            skipRetry: true,
+            schema: { ...firstBuildClassifierSchema, required: [...firstBuildClassifierSchema.required] },
+        }),
+        timeout,
+    ])).finally(() => clearTimeout(timer));
+    const elapsedMs = Date.now() - startedAt;
+    if (rCall.isErr())
+        return Result.Err(rCall);
+    const served = echo.model ?? FIRST_BUILD_CLASSIFIER_MODEL;
+    await recordFirstClassifyRow(vctx, { chatId: args.chatId, userId: args.userId, model: served, usage: echo.usage });
+    const raw = rCall.Ok();
+    if (typeof raw !== "string")
+        return Result.Err("first-build classifier: callAI returned non-string");
+    const rParsed = exception2Result(() => JSON.parse(raw));
+    if (rParsed.isErr())
+        return Result.Err(`first-build classifier: JSON parse failed: ${rParsed.Err().message}`);
+    return parseFirstBuildVerdict(rParsed.Ok(), {
+        model: served,
+        ...(echo.usage === undefined ? {} : { usage: echo.usage }),
+        elapsedMs,
+    });
+}
+async function recordFirstClassifyRow(vctx, o) {
+    const zero = { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 };
+    const rInsert = await exception2Result(() => vctx.sql.db.insert(vctx.sql.tables.promptContexts).values({
+        userId: o.userId,
+        chatId: o.chatId,
+        promptId: vctx.sthis.nextId(12).str,
+        nethash: vctx.netHash(),
+        promptTokens: 0,
+        completionTokens: 0,
+        totalTokens: 0,
+        ref: {
+            type: "prompt.usage.sql",
+            usage: { given: o.usage === undefined ? [] : [{ ...o.usage, model: o.model }], calculated: zero },
+            model: o.model,
+            step: "first-classify",
+        },
+        created: new Date().toISOString(),
+    }));
+    if (rInsert.isErr()) {
+        vctx.logger.Warn().Err(rInsert).Str("chatId", o.chatId).Msg("first-build-classify-row-failed");
+    }
+}
+//# sourceMappingURL=first-build-classifier.js.map

package/intern/first-build-classifier.js.map

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

package/intern/instruction-variant.d.ts

@@ -1,9 +1,37 @@
 import { Result } from "@adviser/cement";
 import type { VibesApiSQLCtx } from "../types.js";
-export declare const INSTRUCTION_VARIANTS: readonly ["direct-write"];
+export declare const INSTRUCTION_VARIANTS: readonly ["direct-write", "pre-staged-reply", "fast-first-turn", "server-first-build", "fast-server-first-build", "fast-first-turn-full-brief", "opus-server-first-build", "seeded-address-words", "no-first-brief"];
 export type InstructionVariant = (typeof INSTRUCTION_VARIANTS)[number];
+export declare function variantForTurn(variant: InstructionVariant | undefined, turn: {
+    readonly firstTurn: boolean;
+}): InstructionVariant | undefined;
 export declare function admitInstructionVariant(requested: unknown, ownerHandle: string | undefined): Result<InstructionVariant | undefined>;
 export declare const DIRECT_WRITE_VARIANT_INSTRUCTION = "<direct-write-session>\nIn this conversation you write the app's code yourself. You are its builder as well as the person's\nguide, so every file the app has is one you wrote and committed, and each change reaches the app as\nyour own commit.\n\nA new app starts with create_vibe carrying codegen: false, together with the fields you always fill:\nprompt, pairs, iconDescription, skills and nature. It answers `created`: the app has its\naddress, name, icon and look, and its files are yours to write. Then write App.jsx with write_file \u2014\nthe complete, working app with every feature wired, following the builder brief below \u2014 and, in the\nsame pass, access.js with the app's record rules and backend.js when it needs server work. Run\nvalidate, fix what it reports and validate again until it comes back clean, then commit_version. Its\n[commit result] is the moment the app is saved, and the reply that says the app is ready follows it.\n\nThe record rules are part of your first pass: the group shape the base instruction describes is an\naccess.js you write beside App.jsx, with the can gates in App.jsx itself, and the invite screen there\ntoo when the ask names other people, sharing or a group. The\nfirst touch of access.js or backend.js hands you the guide index for that file; read the section\nyou need at its offset.\n\nA later change takes the same shape: read the files it touches, edit_file or write_file, validate\nuntil clean, commit_version, then answer from the [commit result]. A reshape, a new screen and a\none-word fix all travel this way. set_app_style still owns the app's look setting.\n\nThe <builder-brief> below is exactly what the platform's builder is taught about writing an app\nhere: the React rules, the house look and its tokens, and the Fireproof, callAI, ImgGen, useVibe\nand useViewer APIs. It is your reference for App.jsx. Where it describes emitting fenced code\nblocks, a title and a feature list, your equivalent is the write_file call; where it closes a\nturn with an improvement question, your own reply rules apply. Any other capability in the\ncatalog reads as /skills/<name>.md with read_file (for example /skills/three-js.md).\n</direct-write-session>";
+export declare const PRE_STAGED_REPLY_VARIANT_INSTRUCTION = "<pre-staged-reply>\nOn this first build your reply comes in two parts, one on each side of the build.\n\nWhen create_vibe answers `building`, describe the app the person is about to open, in present\ntense and in the person's own terms, with a little room to explain: what the app is and who it is\nfor; its screens and the main things the person does on each; and its access rules in plain\nwords \u2014 who can see it, who can add or change things, and what someone opening a shared link\ngets. It describes the app itself; the build's arrival is the result's to announce. Then stop\nspeaking: the build owns the next step, and the options belong to the second part.\n\nWhen the [build result] arrives, the description is already on the person's screen, so the\nsecond part starts from what is new. When the result differs from the description \u2014 a field that\ncame out missing, an access rule that came out another way \u2014 say so in one sentence; when it\nmatches, go straight to the options. Then offer two or three concrete next features for this app\nas options, offered with offer_options as the turn's last call so they arrive as chips the person\ncan tap rather than as prose: each one something this app could do next that the person did not\nmention. The description stands as written: the second part carries no restatement of it and no line\nconfirming the app matches it.\n\nThe base rule holds across both parts: saved, done, ready, in and live belong to the second\npart, written after the result arrives.\n</pre-staged-reply>";
+export declare const FAST_FIRST_TURN_AGENT_MODEL = "~anthropic/claude-sonnet-latest";
+export declare const FAST_FIRST_TURN_REASONING: {
+    readonly effort: "none";
+};
+export interface FastFirstTurnLevers {
+    readonly model: string;
+    readonly reasoning: {
+        readonly effort: "none";
+    };
+}
+export declare function serverFirstBuildArmed(variant: InstructionVariant | undefined, firstTurn: boolean): boolean;
+export declare function firstBriefArmed(variant: InstructionVariant | undefined, firstTurn: boolean, defaultOn: boolean): boolean;
+export declare const AGENT_FIRST_BRIEF_ENV = "AGENT_FIRST_BRIEF";
+export declare function agentFirstBriefEnabled(flag: string | undefined): boolean;
+export declare const FIRST_BRIEF_ROUND_TAG = "<first-brief-round>";
+export declare const FIRST_BRIEF_WORD_COUNT = 5;
+export declare function addressWordsSentence(words: readonly string[]): string;
+export declare function firstBriefRoundInstruction(words: readonly string[]): string;
+export declare function seededAddressWordsArmed(variant: InstructionVariant | undefined, firstTurn: boolean): boolean;
+export declare const SEEDED_ADDRESS_WORDS_TAG = "<seeded-address-words>";
+export declare function seededAddressWordsInstruction(words: readonly string[]): string;
+export declare function fastFirstTurnLevers(variant: InstructionVariant | undefined, firstTurn: boolean): FastFirstTurnLevers | undefined;
+export declare const FAST_FIRST_TURN_VARIANT_INSTRUCTION = "<fast-first-turn>\nThis first turn moves quickly. The person's own sentence travels to the builder in full as\ncreate_vibe's prompt, so the brief you add stays short: enrichedPrompt is two or three sentences\nnaming the screens and the actions on them, and the builder reads the person's own words for the\nrest. The skills list carries the capability choices \u2014 name each capability the ask needs there.\nCall create_vibe as your first action, then tell the person in a sentence or two what is on its way.\n</fast-first-turn>";
+export declare const FAST_FIRST_TURN_ENRICHED_PROMPT_DESCRIPTION: string;
 export declare function renderDirectWriteVariant(builderBrief: string): string;
 export declare function loadDirectWriteBuilderBrief(vctx: VibesApiSQLCtx, model: string, userId: string | undefined): Promise<Result<string>>;
 export declare function agentSystemContent(variantText?: string, extraText?: string): {