@vibes.diy/api-svc 14.3.83 → 14.3.85

package/intern/mercury-first-build-seam.js

@@ -0,0 +1,129 @@
+import { isSseLine } from "@vibes.diy/call-ai-v2";
+import { runCreateVibeTool } from "./agent-build-tools.js";
+import { claimAgentAppContext } from "./agent-request-frame.js";
+import { SERVER_FIRST_BUILD_EVIDENCE_NAME } from "./server-first-build.js";
+export const MERCURY_SEAM_SOURCE = "mercury";
+export async function runMercurySeam(vctx, o) {
+    const record = async (body) => {
+        const written = await o.evidence({
+            kind: "receipt",
+            name: SERVER_FIRST_BUILD_EVIDENCE_NAME,
+            text: JSON.stringify({ ...body, source: MERCURY_SEAM_SOURCE }),
+        });
+        if (written.isErr())
+            vctx.logger.Warn().Err(written).Str("chatId", o.firstTurn.chatId).Msg("mercury-seam-evidence-failed");
+    };
+    const rMercury = await o.pending;
+    if (rMercury.isErr()) {
+        vctx.logger
+            .Warn()
+            .Any("event", { chatId: o.firstTurn.chatId, error: rMercury.Err().message })
+            .Msg("mercury-first-build-fallback");
+        await record({ dispatched: false, reason: "mercury-failed", error: rMercury.Err().message });
+        return { dispatched: false, reason: "mercury-failed" };
+    }
+    const mercury = rMercury.Ok();
+    const summary = {
+        elapsedMs: mercury.elapsedMs,
+        archetype: mercury.shape.archetype,
+        coreAction: mercury.shape.coreAction,
+        skills: mercury.input.skills ?? [],
+    };
+    const createArgs = {
+        actor: o.actor,
+        input: mercury.input,
+        dispatcher: o.dispatcher,
+        firstTurn: o.firstTurn,
+        ...(o.presetColorway === undefined ? {} : { presetColorway: o.presetColorway }),
+    };
+    const first = await runCreateVibeTool(vctx, { ...createArgs, offerAddressRetry: true });
+    const addressRetried = first.isErr() && first.Err().refusal.reason === "address-taken";
+    const r = addressRetried ? await runCreateVibeTool(vctx, createArgs) : first;
+    if (r.isErr()) {
+        vctx.logger
+            .Warn()
+            .Any("event", { chatId: o.firstTurn.chatId, refusal: r.Err().refusal })
+            .Msg("mercury-first-build-create-refused");
+        await record({
+            dispatched: false,
+            reason: "create-refused",
+            refusal: r.Err().refusal,
+            mercury: summary,
+            ...(addressRetried ? { addressRetried: true } : {}),
+        });
+        return { dispatched: false, reason: "create-refused" };
+    }
+    await record({
+        dispatched: true,
+        appSlug: r.Ok().appSlug,
+        receipt: r.Ok(),
+        mercury: summary,
+        ...(addressRetried ? { addressRetried: true } : {}),
+    });
+    vctx.logger
+        .Info()
+        .Any("event", { chatId: r.Ok().chatId, appSlug: r.Ok().appSlug, mercuryMs: mercury.elapsedMs, addressRetried })
+        .Msg("mercury-first-build-dispatched");
+    return {
+        dispatched: true,
+        chatId: r.Ok().chatId,
+        appSlug: r.Ok().appSlug,
+        preamble: mercury.preamble,
+        ...(addressRetried ? { addressRetried: true } : {}),
+    };
+}
+export function mercuryFirstBuildContextLine(preamble) {
+    return ("its first build is running now, started by the platform from the person's own words as this turn began. " +
+        `Your reply this turn already opens with these words, on the person's screen as you start: "${preamble}" ` +
+        "Carry on from them in a sentence at most, and answer from the [build result] when it arrives; " +
+        "its files, versions and settings are readable once it lands.");
+}
+export function mercuryFirstBuildAppContext(messages, o) {
+    return claimAgentAppContext(messages, { ownerHandle: o.ownerHandle, appSlug: o.appSlug }, { firstBuildLine: mercuryFirstBuildContextLine(o.preamble) });
+}
+export function withPreambleFirst(stream, preamble) {
+    let sent = false;
+    return stream.pipeThrough(new TransformStream({
+        transform(msg, controller) {
+            if (sent === false && isSseLine(msg)) {
+                sent = true;
+                controller.enqueue({
+                    ...msg,
+                    chunk: {
+                        id: msg.chunk.id,
+                        provider: msg.chunk.provider,
+                        model: msg.chunk.model,
+                        object: msg.chunk.object,
+                        created: msg.chunk.created,
+                        choices: [
+                            {
+                                index: 0,
+                                delta: { role: "assistant", content: `${preamble}\n\n` },
+                                finish_reason: null,
+                                native_finish_reason: null,
+                            },
+                        ],
+                    },
+                });
+            }
+            controller.enqueue(msg);
+        },
+    }));
+}
+export const MERCURY_DERIVE_FROM_ASK_OVERLAY = `<derive-from-ask>
+The <app-workflow> brief for this app is deliberately thin on records and screens. It fixes what is settled: the person's own words, the ownership archetype and the access shape, which capabilities are loaded, the core action in the person's words, the record names, the seed cast, the look and the title. It leaves the mechanics to you, because you can read the person's message and work out what the app must actually do.
+
+Derive the rest from the verbatim ask before you write code: the fields each named record needs so the screens can show what the person described; the first screen, built around the core action as its biggest control in as few taps as the words allow; every other screen the ask implies and nothing it does not; the calculations, states and transitions the words commit you to — a tally that increments on one tap, a split that shows who owes whom, a feed that refreshes from its source, a timer that fills the screen. Each asked feature is a direct control of its own.
+
+Keep the ownership and access shape exactly as the brief gives it: who owns the object, who is let in, what a visitor sees. Keep the record names and the seed cast; give the seed records exactly the fields your Add writes. A specified ask gets on screen only what it names plus what that needs; a vague ask gets one or two alive defaults. The hints in the brief are hints: where your reading of the ask disagrees with one, the ask wins.
+</derive-from-ask>`;
+export function mercuryBuilderOverlayApplies(o) {
+    return o.instructionVariant === "mercury-recut-first-build" && o.agentDispatched && o.initialTurn;
+}
+export function withMercuryBuilderOverlay(messages) {
+    const at = messages.findIndex((m) => m.role === "system");
+    if (at < 0)
+        return [...messages];
+    return messages.map((m, i) => i === at ? { ...m, content: [...m.content, { type: "text", text: MERCURY_DERIVE_FROM_ASK_OVERLAY }] } : m);
+}
+//# sourceMappingURL=mercury-first-build-seam.js.map

package/intern/mercury-first-build-seam.js.map

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

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

@@ -0,0 +1,121 @@
+import { Result } from "@adviser/cement";
+import type { CreateVibeToolInput, AppNature } from "@vibes.diy/api-types";
+import type { LLMMessage } from "@vibes.diy/call-ai-v2";
+import type { VibesApiSQLCtx } from "../types.js";
+export declare const MERCURY_FIRST_BUILD_MODEL = "inception/mercury-2.5";
+export declare const MERCURY_FIRST_BUILD_REASONING: {
+    readonly effort: "none";
+};
+export declare const MERCURY_CALL_DEADLINE_MS = 8000;
+export declare const MERCURY_CALL_ATTEMPTS = 2;
+export declare const MERCURY_TRANSIENT_RETRIES = 3;
+export declare const MERCURY_TRANSIENT_BACKOFF_MS = 400;
+export declare const MERCURY_ARCHETYPES: readonly ["personal", "group", "publish", "intake", "open", "toy"];
+export type MercuryArchetype = (typeof MERCURY_ARCHETYPES)[number];
+export declare const MERCURY_FLAGS: readonly ["ai", "composer", "imageGen", "backend", "calendar", "audio", "threeD", "charts", "boardGame", "sensitive"];
+export type MercuryFlag = (typeof MERCURY_FLAGS)[number];
+export interface MercuryShape {
+    readonly archetype: MercuryArchetype;
+    readonly coreAction: string;
+    readonly kind: string;
+    readonly who: string;
+    readonly recordNames: readonly string[];
+    readonly flags: Readonly<Record<MercuryFlag, boolean>>;
+}
+export interface MercuryBriefFields {
+    readonly opening: string;
+    readonly access: string;
+    readonly seed: string;
+    readonly look: string;
+    readonly pairs: readonly {
+        readonly title: string;
+        readonly slug: string;
+    }[];
+    readonly icon: string;
+}
+export type MercuryBriefField = keyof MercuryBriefFields;
+export declare const MERCURY_BRIEF_FIELDS: readonly MercuryBriefField[];
+export declare const MERCURY_SHAPE_SYSTEM = "You classify a person's one-message request for a small web app before a build brief is written. Return only JSON.\n\narchetype, exactly one:\n- personal: one person's own tool (\"for me\", \"my\", \"private\", a tracker, a log, a list, a journal) with no other people named.\n- group: the person names other people who use it with them (we, our, friends, family, team, club, kids, housemates, partner, members, a foursome).\n- publish: the person writes and other people only read (a blog, menu, gallery, portfolio, schedule, zine, \"everyone can read\").\n- intake: strangers or customers submit something without signing up and the person sees the submissions (orders, bookings, requests, sign-ups, replies, reports from the public).\n- open: anyone with the link joins in and adds their own bit (a shared wall, canvas, feed, leaderboard game, community board, swap board, \"anyone can post\").\n- toy: a game, simulator, visual, sound or generator that keeps little or nothing (scores at most).\nTie-breaks: group means other people open the app on their own devices; a calculator, splitter or tool used on one phone \"with friends\" at the table is personal. toy is for games, simulators and visual or sound toys; a tool that analyzes, estimates, designs, counts, tracks or logs stores records and is personal. A \"feed of information\" pulled from the internet is personal with backend true. A test or nonsense phrase is still a request: make the most playful literal app of it (a \"squash bloom soothsayer\" is a fortune teller about squash) and classify that.\n\ncoreAction: the one thing the person does most in this app, as a short verb phrase in their own words (\"tap once per glass\", \"paste the group chat\", \"lasso cows\"). It becomes the biggest control on the first screen.\nkind: 2-6 word noun phrase for the app in the person's own nouns. who: who it is for, 2-8 words.\nrecordNames: 1-5 short singular record type names the app stores (toys may have just \"score\" or none).\nflags, each true only when the request itself needs it:\n- ai: the app must read, write or judge free text or photos with a language model (extract facts from pasted words, answer questions, generate text, chat, analyze a picture, suggest recipes).\n- composer: ai is true AND the person types or pastes their own words or photos as the way records get in.\n- imageGen: the app generates pictures.\n- backend: server work the page cannot do: scheduled reminders or digests, a live feed pulled from outside, secret dealing, email.\n- calendar: dates on a calendar, bookings by slot, recurring events, paystub periods.\n- audio: sound or music playback or synthesis.\n- threeD: 3D graphics, a simulator, a world you move through.\n- charts: heatmaps, graphs, statistics views.\n- boardGame: a turn-based card or board game.\n- sensitive: health, money of real people, kids, or the word private.";
+export declare function mercuryShapeSchema(): Record<string, unknown>;
+export declare function mercuryNonce(): string;
+export declare function mercuryShapeMessages(o: {
+    readonly personWords: string;
+    readonly nonce: string;
+}): LLMMessage[];
+export declare function parseMercuryShape(raw: unknown): Result<MercuryShape>;
+export declare function fixMercuryShape(shape: MercuryShape, personWords: string): MercuryShape;
+export declare const MERCURY_EXEMPLAR_FIELD = "## How to read this field\n\nEvery brief has the same parts, in this order. Below, each part is shown as a SPREAD of alternatives, side by side. Each row is tagged with the ownership archetype it fits:\n\n- [personal]  one person's own tool: private, records keyed to their own object so a friend could be let in later.\n- [group]     a named set of people (friends, family, team, club, housemates): the owner invites them by handle, members read and write; the invite screen is part of this first build.\n- [publish]   the owner writes, everyone reads: a blog, menu, gallery, zine, schedule.\n- [intake]    strangers submit without signing in (orders, bookings, requests, RSVPs); the owner sees and manages what came in.\n- [open]      anyone with the link joins and writes their own bit: a shared wall, a canvas, a leaderboard game. Each person edits what they made.\n- [toy]       a game or visual that keeps little or nothing: scores or a save slot at most.\n\nPick the rows that match the archetype you were given. Take every noun from the person's own words.\n\n## 1. Opening \u2014 one sentence: what it is and who it is for\n\n- [personal] A glaze test notebook for a home potter.\n- [personal] A sourdough starter log for one baker's kitchen.\n- [group]    A tool library for one neighbourhood block, shared by the households on it.\n- [group]    A setlist planner for a four-piece cover band.\n- [publish]  A taco truck menu board the owner updates from their phone and customers read.\n- [publish]  A micro-poetry zine where one editor posts and everyone reads.\n- [intake]   An appointment book for a dog grooming salon: clients book without signing up, the groomer sees every slot.\n- [intake]   A repair drop-off form for a bike shop, with the owner's queue on the other side.\n- [open]     A lost-and-found board for a music festival that anyone with the link can post to.\n- [open]     A wedding photo wall where every guest drops pictures from their phone.\n- [toy]      A hex-grid pong game with a slow-motion ball and a local best score.\n- [toy]      A kaleidoscope you steer with the mouse, with nothing saved.\n\n## 2. Ownership and access \u2014 who owns what, who gets in, who sees what\n\n- [personal] Each signed-in person has their own notebook object (keyed on their handle, named for the app, renameable in settings); glazes and tiles carry the notebook id so a studio mate could be let in later. The creator reads and writes it alone.\n- [personal] The person's own starter log is ready on arrival. Feedings belong to that log; rules key on its creator, so the entries stay theirs, shaped so a housemate could be admitted later.\n- [group]    Each signed-in person starts with their own block library object. Households are let in with the platform's HandleInput invite screen, which writes a membership into the library; members read every tool and write their own loans. The library list shows shared ones with ViewerTag.\n- [group]    The owner's band object holds memberships for the other three players, written by the HandleInput invite screen. Any member adds songs and reorders the set; the creator manages members and deletes songs.\n- [publish]  The owner's menu object is keyed on their handle. Menu items are written by the owner and readable by everyone, signed in or not. Shaped so a co-owner could be let in later.\n- [publish]  One editor owns the zine; poem records are creator-writable and world-readable. Readers see the issues.\n- [intake]   Two sides. Clients book anonymously: anyone, signed in or not, can create a booking record on the salon object and reads back the confirmation they just made. The groomer, signed in as the salon's owner, reads and updates every booking.\n- [intake]   Drop-off requests are created by visitors without accounts; each request is readable by the shop owner (and staff let in later by membership). The public form page shows the visitor their own request.\n- [open]     The owner creates the board and names it for the app. Any visitor with the link reads the whole board and writes their own posts; each poster edits or removes what they wrote, keyed on the record's creator. The board creator can remove anything.\n- [open]     Anyone with the link uploads photos to the wall; everyone reads; a photo is deletable by whoever posted it or the couple who own the wall.\n- [toy]      Each signed-in player keeps a best score record keyed on their handle; a shared Top Scores list shows everyone's best with ViewerTag.\n- [toy]      The toy keeps its state in memory: it opens instantly, with no sign-in and no records.\n\n## 3. Seed cast \u2014 seed.json demo with a named cast, counts and dates near today\n\n- [personal] seed.json demo: the owner's notebook plus 5 glazes (Tenmoku, Shino, Celadon, Chun blue, Ash) and 9 tiles fired between 2026-09-20 and 2026-10-05, two rated 5.\n- [personal] seed.json demo: one starter \"Gus\" born 2026-03-02 with 10 feedings over the last two weeks, rise heights between 3 and 7 cm.\n- [group]    seed.json demo: the owner's library \"Maple Street Tools\" with the owner's own membership plus @priya and @tomas, 8 tools (a ladder, a tile saw, a pressure washer...), two loans out due this week and one returned.\n- [group]    seed.json demo: the band \"Low Tide\" with the owner's membership and three members (@dee, @marco, @sun), 14 songs with keys and bpm, one setlist for a gig dated 2026-10-18.\n- [publish]  seed.json demo: the owner's menu with 6 items across tacos, sides and drinks, one marked sold out, and a note of the day dated 2026-10-07.\n- [intake]   seed.json demo: the owner's salon with 7 bookings spread over 2026-10-07 to 2026-10-11 in mixed statuses, dog names like Biscuit and Juno.\n- [open]     seed.json demo: the festival board with 9 posts from five handles, five lost and four found, two already resolved, dated across the last three days.\n- [toy]      seed.json demo: 6 score records from a small cast including the owner so the Top Scores list opens filled.\n\n## 4. Look note \u2014 one short line: background, accent, card shape, mood\n\n- [personal] Earthy studio: oatmeal background, iron-red accents, chunky rounded tile cards.\n- [personal] Flour-dusted kitchen: warm white, rye brown, a tall rising bar as the hero number.\n- [group]    Workshop pegboard: plywood tones, safety-orange accents, square tool cards with big status chips.\n- [group]    Backstage: near-black, amber stage light accents, setlist rows like gaffer-tape strips.\n- [publish]  Street-food bright: chalkboard dark with chalk-white type and chili-red price tags.\n- [intake]   Clean salon: pale mint, charcoal type, generous slot buttons easy to tap one-handed.\n- [open]     Festival poster: cream paper, bold two-colour print, pinned-note cards with torn edges.\n- [toy]      Neon arcade: deep navy, electric cyan ball, glowing hex outlines.\n\n## 5. Titles, addresses and icon\n\n- pairs: Glaze Ledger / glaze-ledger, Tile Book / tile-book, Kiln Notes / kiln-notes \u2014 icon: a glazed test tile beside a small kiln\n- pairs: Block Tools / block-tools, Maple Street Shelf / maple-street-shelf, Borrow Board / borrow-board \u2014 icon: a hand drill inside a house outline\n- pairs: Truck Board / truck-board, Taco Today / taco-today, Menu Chalk / menu-chalk \u2014 icon: a chalkboard with a taco drawn on it\n- pairs: Groom Book / groom-book, Salon Slots / salon-slots, Paws Diary / paws-diary \u2014 icon: a dog brush beside a clock face\n- pairs: Festival Finds / festival-finds, Lost Tent / lost-tent, Found It / found-it \u2014 icon: a tent peg tied with a ribbon\n- pairs: Hex Pong / hex-pong, Slow Rally / slow-rally, Honey Paddle / honey-paddle \u2014 icon: a hexagonal paddle and a glowing ball";
+export declare const MERCURY_BRIEF_RULES = "You write the settled parts of a build brief for a small web app (React, a local-first database, access rules). The brief is read by a builder, who works out the records, screens and mechanics from the person's own words. Write plain, concrete prose in the app's own nouns, as unformatted text in each JSON string.\n\nThe decisions already made are given in the user message; follow them (archetype, record names, capabilities). The access part matches the archetype: who owns the object, who else is let in, what visitors see. The seed part starts with \"seed.json demo:\" and gives a named cast, counts and dates near today, using the given record names. Take from the field the SHAPE of a part (its length and how a cast, a look or a title is named); every noun comes from the person's words. Each pair is a Title Case title of two or three words and a kebab-case address made from it.";
+export declare function mercuryBriefSchema(fields: readonly MercuryBriefField[]): Record<string, unknown>;
+export declare function mercuryBriefMessages(o: {
+    readonly personWords: string;
+    readonly shape: MercuryShape;
+    readonly fields: readonly MercuryBriefField[];
+    readonly words: readonly string[];
+    readonly today: string;
+    readonly nonce: string;
+}): LLMMessage[];
+export declare function cleanMercuryText(text: string): string;
+export declare function gateMercuryPairs(raw: unknown): Result<{
+    readonly title: string;
+    readonly slug: string;
+}[]>;
+export declare function gateMercuryField(o: {
+    readonly field: Exclude<MercuryBriefField, "pairs">;
+    readonly value: string;
+    readonly shape: MercuryShape;
+}): string[];
+export declare const MERCURY_ACCESS_TAIL: Readonly<Record<MercuryArchetype, string>>;
+export declare function mercuryAccessLine(shape: MercuryShape, access: string): string;
+export declare function mercurySkills(shape: MercuryShape): string[];
+export declare function mercuryNature(shape: MercuryShape): AppNature;
+export declare function mercuryWorkflowLine(shape: MercuryShape): string;
+export declare function assembleMercuryCreateVibe(o: {
+    readonly personWords: string;
+    readonly shape: MercuryShape;
+    readonly fields: MercuryBriefFields;
+}): CreateVibeToolInput;
+export declare const MERCURY_PREAMBLE_SYSTEM = "You speak to the person who asked for an app, just before it is built. Write two or three plain sentences in their own words: what you are making for them, its core action, and the big control on its first screen that does it. That is the whole promise \u2014 the builder works out everything else after you speak. Start with \"I'm making\" or \"I'm building\", and write it as plain sentences to the person.";
+export declare function mercuryPreambleMessages(o: {
+    readonly personWords: string;
+    readonly shape: MercuryShape;
+    readonly enrichedPrompt: string;
+    readonly nonce: string;
+}): LLMMessage[];
+export declare function mercuryPreambleSchema(): Record<string, unknown>;
+export declare function gateMercuryPreamble(o: {
+    readonly text: string;
+    readonly enrichedPrompt: string;
+}): string[];
+export interface MercuryUsage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly total_tokens: number;
+    readonly cost?: number;
+}
+export type MercuryCallName = "shape" | "brief" | "preamble";
+export interface MercuryCallRecord {
+    readonly call: MercuryCallName;
+    readonly ok: boolean;
+    readonly attempts: number;
+    readonly elapsedMs: number;
+    readonly servedModel?: string;
+    readonly usage: readonly MercuryUsage[];
+    readonly error?: string;
+}
+export interface MercuryFirstBuild {
+    readonly input: CreateVibeToolInput;
+    readonly preamble: string;
+    readonly shape: MercuryShape;
+    readonly elapsedMs: number;
+}
+export interface RunMercuryFirstBuildArgs {
+    readonly chatId: string;
+    readonly userId: string;
+    readonly personWords: string;
+    readonly words: readonly string[];
+    readonly deadlineMs?: number;
+    readonly nonce?: () => string;
+    readonly today?: string;
+}
+export declare function runMercuryFirstBuild(vctx: VibesApiSQLCtx, args: RunMercuryFirstBuildArgs): Promise<Result<MercuryFirstBuild>>;