@12ui/design 0.2.27 → 0.2.28

package/dist/draft-run.js

@@ -1,136 +1,111 @@
-import { createHash } from 'node:crypto';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir } from 'node:fs/promises';
 import path from 'node:path';
 import { downloadCorpusInspiration } from './cli-corpus-run.js';
-import { INSPIRATION_EVIDENCE_FILE, INSPIRATION_MANIFEST_FILE, } from './cli-corpus-types.js';
+import { INSPIRATION_MANIFEST_FILE, } from './cli-corpus-types.js';
 import { loadCorpusReferenceImage } from './cli-corpus-reference-image.js';
-import { draftCandidateKey, draftCorpusKey } from './draft-identity.js';
-import { draftCandidateIdFor, draftCandidatePrompt, promptDigest } from './draft-prompts.js';
-import { DRAFT_CANDIDATE_IDS, draftPaths, writeDraftRecord, } from './draft-workspace.js';
-/**
- * Everything `12ui draft` does before a single image is bought: one corpus
- * search, four references paired one-to-one with four candidates, a generation
- * manifest with derived keys, and a durable record of all of it.
- *
- * This is the step that used to be five screens of skill prose. Each rule it
- * encodes was previously an instruction a model could paraphrase away.
- */
+import { draftCorpusKey } from './draft-identity.js';
+import { hostedDraftRunKey, } from './hosted-draft-identity.js';
+import { DRAFT_CANDIDATE_IDS, writeDraftRecord, } from './draft-workspace.js';
+/** Hosted draft preparation: one corpus search, one service run claim, no local provider. */
 export const DRAFT_CANDIDATE_COUNT = 4;
-/** Retrieval mode is fixed for a draft, and the derived key must say so. */
+export const DRAFT_CANDIDATE_COUNT_MINIMUM = 2;
+export const DRAFT_CANDIDATE_COUNT_MAXIMUM = DRAFT_CANDIDATE_IDS.length;
 const DRAFT_CORPUS_MODE = 'balanced';
-/**
- * The one corpus key a draft run spends against. It lives here rather than
- * inline at the call site because `12ui draft` now derives it a second time,
- * before the run directory exists, to decide whether an incomplete previous
- * directory is the SAME run and can be continued in place.
- */
 export const draftRunCorpusKey = (args) => draftCorpusKey({
     query: args.query,
     mode: DRAFT_CORPUS_MODE,
-    count: DRAFT_CANDIDATE_COUNT,
+    count: args.candidateCount ?? DRAFT_CANDIDATE_COUNT,
     redesignSourceSha256: args.redesignSourceSha256 ?? null,
 });
-/**
- * The corpus reference's own declared labels, kept as provenance for the
- * selection record. Never used as prompt text — see `draft-prompts.ts`.
- */
-const referenceLabel = (item) => {
-    const label = (item.description ?? '').trim() || (item.uiType ?? '').trim();
-    return label.length > 160 ? `${label.slice(0, 159)}…` : label;
-};
-const readInspirationItems = async (referencesDir) => {
-    try {
-        const evidence = JSON.parse(await readFile(path.join(referencesDir, INSPIRATION_EVIDENCE_FILE), 'utf8'));
-        return Object.fromEntries((evidence.response?.items ?? []).map((item) => [
-            item.id,
-            { uiType: item.uiType ?? null, description: item.description ?? null },
-        ]));
-    }
-    catch {
-        // Provenance labels are a convenience; their absence never blocks a run.
-        return {};
+const draftSlotFor = (index) => String.fromCharCode('a'.charCodeAt(0) + index);
+const assertClaimedSlots = (expected, actual) => {
+    const expectedSlots = expected.map((candidate) => candidate.slot);
+    const actualSlots = actual.candidates.map((candidate) => candidate.slot);
+    if (JSON.stringify(expectedSlots) !== JSON.stringify(actualSlots)) {
+        throw new Error(`Hosted draft ${actual.id} returned slots ${actualSlots.join(', ') || '(none)'};`
+            + ` expected ${expectedSlots.join(', ')}`);
     }
 };
 export const prepareDraftRun = async (input) => {
     const now = input.now ?? (() => new Date());
     const manifest = await downloadCorpusInspiration({
         client: input.client,
-        request: { q: input.query, mode: DRAFT_CORPUS_MODE, k: DRAFT_CANDIDATE_COUNT },
+        request: { q: input.query, mode: DRAFT_CORPUS_MODE, k: input.candidateCount },
         outDir: input.paths.referencesDir,
         origin: input.origin,
         idempotencyKey: draftRunCorpusKey({
             query: input.query,
+            candidateCount: input.candidateCount,
             redesignSourceSha256: input.redesignSource?.sha256 ?? null,
         }),
-        // A redesign conditions RETRIEVAL on the existing screen; whether it also
-        // conditions generation is the difference between the two modes below.
         ...(input.redesignSource
             ? { referenceImage: await loadCorpusReferenceImage(input.redesignSource.path) }
             : {}),
         now,
     });
     const references = [...manifest.references].sort((left, right) => left.ordinal - right.ordinal);
-    if (references.length < DRAFT_CANDIDATE_COUNT) {
+    if (references.length < input.candidateCount) {
         throw new Error(`The corpus returned ${references.length} reference(s) for this query and a draft needs`
-            + ` ${DRAFT_CANDIDATE_COUNT}. Broaden the query and run 12ui draft again; nothing has been`
-            + ' generated, so nothing has been bought.');
+            + ` ${input.candidateCount}. Broaden the concept and run 12ui draft again; no hosted image`
+            + ' slot has been dispatched.');
     }
-    const labels = await readInspirationItems(input.paths.referencesDir);
-    // A reskin conditions every candidate on the source and takes its diversity
-    // from nothing else; the other modes pair one corpus image per candidate.
     const reskin = input.mode === 'structure-preserving-reskin';
-    const referenceMode = reskin ? 'preserve-structure' : 'inspiration';
-    const prompt = draftCandidatePrompt({ query: input.query, mode: input.mode });
+    const requestCandidates = DRAFT_CANDIDATE_IDS
+        .slice(0, input.candidateCount)
+        .map((_id, index) => reskin
+        ? { slot: draftSlotFor(index), useReferenceImage: true }
+        : { slot: draftSlotFor(index), referenceId: references[index].id });
+    let referenceImage;
+    if (reskin) {
+        if (!input.redesignSource)
+            throw new Error('A reskin requires --redesign-source');
+        const loaded = await loadCorpusReferenceImage(input.redesignSource.path);
+        referenceImage = {
+            data: Buffer.from(loaded.input.bytes).toString('base64'),
+            mediaType: loaded.input.mediaType,
+            sha256: loaded.evidence.sha256,
+        };
+    }
+    const hostedMode = reskin ? 'preserve-structure' : 'inspiration';
+    const idempotencyKey = hostedDraftRunKey({
+        concept: input.query,
+        aspect: input.aspect,
+        mode: hostedMode,
+        candidates: requestCandidates,
+        ...(referenceImage ? { referenceImageSha256: referenceImage.sha256 } : {}),
+    });
+    const hosted = await input.hostedClient.startCreateRun({
+        concept: input.query,
+        aspect: input.aspect,
+        mode: hostedMode,
+        candidates: requestCandidates,
+        ...(referenceImage ? { referenceImage } : {}),
+    }, idempotencyKey);
+    assertClaimedSlots(requestCandidates, hosted);
     await mkdir(input.paths.candidatesDir, { recursive: true });
-    const candidates = DRAFT_CANDIDATE_IDS.map((id, index) => {
+    const candidates = DRAFT_CANDIDATE_IDS
+        .slice(0, input.candidateCount)
+        .map((id, index) => {
         const reference = references[index];
-        const generationReference = reskin && input.redesignSource
-            ? { path: input.redesignSource.path, sha256: input.redesignSource.sha256 }
-            : { path: reference.file, sha256: reference.sha256 };
+        const serviceCandidate = hosted.candidates[index];
         return {
             id,
-            direction: referenceLabel(labels[reference.id] ?? {}),
-            prompt,
-            promptSha256: promptDigest(prompt),
+            slot: serviceCandidate.slot,
+            direction: serviceCandidate.direction,
             outputPath: path.join(input.paths.candidatesDir, `${id}.png`),
-            idempotencyKey: draftCandidateKey({
-                query: input.query,
-                candidateId: id,
-                // In a reskin every candidate shares the source, so the paired corpus
-                // reference still distinguishes the four purchases.
-                referenceSha256: reference.sha256,
-                aspect: input.aspect,
-                referenceMode,
-            }),
-            referenceId: reference.id,
-            referencePath: generationReference.path,
-            referenceSha256: generationReference.sha256,
+            referenceId: reskin ? null : reference.id,
+            referencePath: reskin ? input.redesignSource.path : reference.file,
+            referenceSha256: reskin ? input.redesignSource.sha256 : reference.sha256,
         };
     });
-    const batchManifest = {
-        version: 1,
-        projectRoot: input.projectRoot,
-        provider: input.provider,
-        aspect: input.aspect,
-        referenceMode,
-        candidates: candidates.map((candidate) => ({
-            id: candidate.id,
-            prompt: candidate.prompt,
-            reference: path.relative(input.paths.runDir, candidate.referencePath),
-            out: path.relative(input.paths.runDir, candidate.outputPath),
-            idempotencyKey: candidate.idempotencyKey,
-        })),
-    };
-    const serialized = `${JSON.stringify(batchManifest, null, 2)}\n`;
-    await writeFile(input.paths.generationManifest, serialized, { encoding: 'utf8', mode: 0o600 });
     const record = {
-        version: 1,
+        version: 2,
         createdAt: now().toISOString(),
         runDir: input.paths.runDir,
         query: input.query,
         mode: input.mode,
         aspect: input.aspect,
-        referenceMode,
+        referenceMode: reskin ? 'preserve-structure' : 'inspiration',
         origin: input.origin,
         redesignSource: input.redesignSource
             ? { path: input.redesignSource.path, sha256: input.redesignSource.sha256 }
@@ -149,16 +124,13 @@ export const prepareDraftRun = async (input) => {
                 aspect: reference.aspect,
             })),
         },
-        generation: {
-            manifestPath: input.paths.generationManifest,
-            manifestSha256: createHash('sha256').update(serialized).digest('hex'),
-            provider: input.provider,
+        hosted: {
+            runId: hosted.id,
+            idempotencyKey,
             candidates,
         },
     };
     await writeDraftRecord(input.paths.draftRecord, record);
     return record;
 };
-export const draftRunPaths = draftPaths;
-export { draftCandidateIdFor };
 //# sourceMappingURL=draft-run.js.map

package/dist/draft-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"draft-run.js","sourceRoot":"","sources":["../src/draft-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"draft-run.js","sourceRoot":"","sources":["../src/draft-run.ts"],"names":[],"mappings":"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"}

package/dist/draft-workspace.d.ts

@@ -12,10 +12,11 @@
 export declare const DRAFT_RECORD_FILENAME = "draft.json";
 export declare const DRAFT_REFERENCES_DIRECTORY = "references";
 export declare const DRAFT_CANDIDATES_DIRECTORY = "candidates";
-export declare const DRAFT_GENERATION_MANIFEST = "generation.json";
-export declare const DRAFT_SELECTION_FILENAME = "selection.json";
+export declare const DRAFT_DISPATCH_ATTEMPT_FILENAME = "draft.dispatch.json";
+export declare const DRAFT_COMPLETION_FILENAME = "draft.complete.json";
+export declare const DRAFT_LOG_FILENAME = "draft.log";
 export declare const DRAFT_BRANCH_DIRECTORY = "branch";
-export declare const DRAFT_CANDIDATE_IDS: readonly ["A", "B", "C", "D"];
+export declare const DRAFT_CANDIDATE_IDS: readonly ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P"];
 export type DraftCandidateId = typeof DRAFT_CANDIDATE_IDS[number];
 export type DraftMode = 'new-interface' | 'exploratory-redesign' | 'structure-preserving-reskin';
 /** `Editorial architecture homepage` -> `editorial-architecture-homepage`. */
@@ -24,9 +25,10 @@ export type DraftPaths = {
     runDir: string;
     referencesDir: string;
     candidatesDir: string;
-    generationManifest: string;
     draftRecord: string;
-    selection: string;
+    dispatchAttempt: string;
+    completion: string;
+    log: string;
     branchDir: string;
 };
 export declare const draftPaths: (runDir: string) => DraftPaths;
@@ -37,22 +39,17 @@ export declare const createDraftWorkspace: (args: {
 }) => Promise<DraftPaths>;
 export type DraftCandidateRecord = {
     id: DraftCandidateId;
-    /**
-     * What steered this candidate — the corpus reference's own declared labels,
-     * recorded as provenance. It is never written into the prompt: the image is
-     * the direction, and describing it back to the model would flatten it.
-     */
+    /** Stable lower-case slot used by the hosted create API. */
+    slot: string;
+    /** Service-derived, visibly grounded direction. */
     direction: string;
-    prompt: string;
-    promptSha256: string;
     outputPath: string;
-    idempotencyKey: string;
     referenceId: string | null;
     referencePath: string;
     referenceSha256: string;
 };
 export type DraftRecord = {
-    version: 1;
+    version: 2;
     createdAt: string;
     runDir: string;
     query: string;
@@ -78,13 +75,24 @@ export type DraftRecord = {
             aspect: string;
         }[];
     };
-    generation: {
-        manifestPath: string;
-        manifestSha256: string;
-        provider: 'auto' | 'codex' | 'openai';
+    hosted: {
+        runId: string;
+        idempotencyKey: string;
         candidates: DraftCandidateRecord[];
     };
 };
+export type DraftCompletionRecord = {
+    version: 1;
+    runId: string;
+    completedAt: string;
+    candidates: {
+        slot: string;
+        path: string;
+        sha256: string;
+        bytes: number;
+    }[];
+};
 export declare const writeDraftRecord: (file: string, record: DraftRecord) => Promise<void>;
+export declare const writeDraftCompletion: (file: string, record: DraftCompletionRecord) => Promise<void>;
 export declare const readDraftRecord: (file: string) => Promise<DraftRecord | undefined>;
 //# sourceMappingURL=draft-workspace.d.ts.map

package/dist/draft-workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draft-workspace.d.ts","sourceRoot":"","sources":["../src/draft-workspace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"draft-workspace.d.ts","sourceRoot":"","sources":["../src/draft-workspace.ts"],"names":[],"mappings":"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"}

package/dist/draft-workspace.js

@@ -15,10 +15,14 @@ import path from 'node:path';
 export const DRAFT_RECORD_FILENAME = 'draft.json';
 export const DRAFT_REFERENCES_DIRECTORY = 'references';
 export const DRAFT_CANDIDATES_DIRECTORY = 'candidates';
-export const DRAFT_GENERATION_MANIFEST = 'generation.json';
-export const DRAFT_SELECTION_FILENAME = 'selection.json';
+export const DRAFT_DISPATCH_ATTEMPT_FILENAME = 'draft.dispatch.json';
+export const DRAFT_COMPLETION_FILENAME = 'draft.complete.json';
+export const DRAFT_LOG_FILENAME = 'draft.log';
 export const DRAFT_BRANCH_DIRECTORY = 'branch';
-export const DRAFT_CANDIDATE_IDS = ['A', 'B', 'C', 'D'];
+export const DRAFT_CANDIDATE_IDS = [
+    'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H',
+    'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
+];
 /** `Editorial architecture homepage` -> `editorial-architecture-homepage`. */
 export const draftSlug = (query) => {
     const slug = query
@@ -39,9 +43,10 @@ export const draftPaths = (runDir) => {
         runDir: resolved,
         referencesDir: path.join(resolved, DRAFT_REFERENCES_DIRECTORY),
         candidatesDir: path.join(resolved, DRAFT_CANDIDATES_DIRECTORY),
-        generationManifest: path.join(resolved, DRAFT_GENERATION_MANIFEST),
         draftRecord: path.join(resolved, DRAFT_RECORD_FILENAME),
-        selection: path.join(resolved, DRAFT_SELECTION_FILENAME),
+        dispatchAttempt: path.join(resolved, DRAFT_DISPATCH_ATTEMPT_FILENAME),
+        completion: path.join(resolved, DRAFT_COMPLETION_FILENAME),
+        log: path.join(resolved, DRAFT_LOG_FILENAME),
         branchDir: path.join(resolved, DRAFT_BRANCH_DIRECTORY),
     };
 };
@@ -53,6 +58,12 @@ export const createDraftWorkspace = async (args) => {
 export const writeDraftRecord = async (file, record) => {
     await writeFile(file, `${JSON.stringify(record, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
 };
+export const writeDraftCompletion = async (file, record) => {
+    await writeFile(file, `${JSON.stringify(record, null, 2)}\n`, {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+};
 export const readDraftRecord = async (file) => {
     try {
         return JSON.parse(await readFile(file, 'utf8'));

package/dist/draft-workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"draft-workspace.js","sourceRoot":"","sources":["../src/draft-workspace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"draft-workspace.js","sourceRoot":"","sources":["../src/draft-workspace.ts"],"names":[],"mappings":"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"}

package/dist/hosted-draft-identity.d.ts

@@ -0,0 +1,20 @@
+/** Stable identity for one service-owned draft purchase. */
+export declare const HOSTED_DRAFT_WORKFLOW_REVISION = "hosted-draft-v1";
+export type HostedDraftCandidateSpecInput = {
+    slot: string;
+    direction?: string;
+    referenceId?: string;
+    useReferenceImage?: boolean;
+};
+/**
+ * The same hosted request always claims the same run, however its candidate
+ * objects happened to be ordered or spaced by the caller.
+ */
+export declare const hostedDraftRunKey: (args: {
+    concept: string;
+    aspect: string;
+    mode?: string;
+    candidates: readonly HostedDraftCandidateSpecInput[];
+    referenceImageSha256?: string;
+}) => string;
+//# sourceMappingURL=hosted-draft-identity.d.ts.map

package/dist/hosted-draft-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-draft-identity.d.ts","sourceRoot":"","sources":["../src/hosted-draft-identity.ts"],"names":[],"mappings":"AAEA,4DAA4D;AAC5D,eAAO,MAAM,8BAA8B,oBAAoB,CAAC;AAEhE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,KAAG,MAcO,CAAC"}

package/dist/hosted-draft-identity.js

@@ -0,0 +1,30 @@
+import { createHash } from 'node:crypto';
+/** Stable identity for one service-owned draft purchase. */
+export const HOSTED_DRAFT_WORKFLOW_REVISION = 'hosted-draft-v1';
+const shortDigest = (value, characters = 32) => (createHash('sha256').update(value).digest('hex').slice(0, characters));
+const canonicalCandidate = (candidate) => [
+    candidate.slot,
+    candidate.direction ?? '',
+    candidate.referenceId ?? '',
+    candidate.useReferenceImage === true ? 'upload' : '',
+].join('\0');
+/**
+ * The same hosted request always claims the same run, however its candidate
+ * objects happened to be ordered or spaced by the caller.
+ */
+export const hostedDraftRunKey = (args) => [
+    'draft',
+    'hosted-v1',
+    shortDigest([
+        args.concept,
+        args.aspect,
+        args.mode ?? 'inspiration',
+        args.referenceImageSha256 ?? '',
+        [...args.candidates]
+            .sort((left, right) => left.slot.localeCompare(right.slot))
+            .map(canonicalCandidate)
+            .join('\u0001'),
+        HOSTED_DRAFT_WORKFLOW_REVISION,
+    ].join('\u0002')),
+].join(':');
+//# sourceMappingURL=hosted-draft-identity.js.map

package/dist/hosted-draft-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-draft-identity.js","sourceRoot":"","sources":["../src/hosted-draft-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,iBAAiB,CAAC;AAShE,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,UAAU,GAAG,EAAE,EAAU,EAAE,CAAC,CAC9D,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CACtE,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,SAAwC,EAAU,EAAE,CAAC;IAC/E,SAAS,CAAC,IAAI;IACd,SAAS,CAAC,SAAS,IAAI,EAAE;IACzB,SAAS,CAAC,WAAW,IAAI,EAAE;IAC3B,SAAS,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;CACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAMjC,EAAU,EAAE,CAAC;IACZ,OAAO;IACP,WAAW;IACX,WAAW,CAAC;QACV,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,IAAI,IAAI,aAAa;QAC1B,IAAI,CAAC,oBAAoB,IAAI,EAAE;QAC/B,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;aACjB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAC1D,GAAG,CAAC,kBAAkB,CAAC;aACvB,IAAI,CAAC,QAAQ,CAAC;QACjB,8BAA8B;KAC/B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;CAClB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/hosted-draft-run.d.ts

@@ -0,0 +1,60 @@
+import type { BranchRunEnvelope, TwelveUiBranchClient } from './branch-client.js';
+/** One hosted draft image, generated by the service rather than this machine. */
+export declare const HOSTED_DRAFT_CANDIDATE_DURATION_SECONDS: 150;
+export type HostedDraftCounts = {
+    pending: number;
+    dispatched: number;
+    succeeded: number;
+    failed: number;
+};
+export declare const summarizeHostedDraftRun: (run: BranchRunEnvelope) => HostedDraftCounts;
+export declare const hostedDraftRunIsSettled: (run: BranchRunEnvelope) => boolean;
+type HostedDraftDispatchClient = Pick<TwelveUiBranchClient, 'getRun' | 'dispatchScreen'>;
+export type HostedDraftDispatchResult = {
+    run: BranchRunEnvelope;
+    dispatched: string[];
+    failures: {
+        slot: string;
+        error: string;
+    }[];
+};
+/**
+ * Dispatch only slots which have never started.
+ *
+ * `dispatched`, `succeeded`, and `failed` are all durable service states. A
+ * resume observes them and never posts those slots again; the service remains
+ * the paid-effect and ledger authority.
+ */
+export declare const dispatchHostedDraftSlots: (args: {
+    client: HostedDraftDispatchClient;
+    runId: string;
+}) => Promise<HostedDraftDispatchResult>;
+type HostedDraftReadClient = Pick<TwelveUiBranchClient, 'getRun'>;
+export declare const waitForHostedDraftRun: (args: {
+    client: HostedDraftReadClient;
+    run: BranchRunEnvelope;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    now?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+    onProgress?: (run: BranchRunEnvelope) => void;
+}) => Promise<BranchRunEnvelope>;
+type HostedDraftDownloadClient = Pick<TwelveUiBranchClient, 'downloadScreen'>;
+export type HostedDraftCandidatePath = {
+    slot: string;
+    outputPath: string;
+};
+export type HostedDraftDownloadedFile = {
+    slot: string;
+    path: string;
+    sha256: string;
+    bytes: number;
+};
+/** Download settled service images without overwriting a changed local artifact. */
+export declare const downloadHostedDraftCandidates: (args: {
+    client: HostedDraftDownloadClient;
+    run: BranchRunEnvelope;
+    candidates: readonly HostedDraftCandidatePath[];
+}) => Promise<HostedDraftDownloadedFile[]>;
+export {};
+//# sourceMappingURL=hosted-draft-run.d.ts.map

package/dist/hosted-draft-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-draft-run.d.ts","sourceRoot":"","sources":["../src/hosted-draft-run.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAG5B,iFAAiF;AACjF,eAAO,MAAM,uCAAuC,KAEnD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,KAAK,iBAAiB,KAAG,iBAIhE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,KAAK,iBAAiB,KAAG,OAGhE,CAAC;AAEF,KAAK,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,gBAAgB,CAAC,CAAC;AAEzF,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,iBAAiB,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAU,MAAM;IACnD,MAAM,EAAE,yBAAyB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,yBAAyB,CAqBpC,CAAC;AAEF,KAAK,qBAAqB,GAAG,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB,GAAU,MAAM;IAChD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,GAAG,EAAE,iBAAiB,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC/C,KAAG,OAAO,CAAC,iBAAiB,CAY5B,CAAC;AAEF,KAAK,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;AAE9E,MAAM,MAAM,wBAAwB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5E,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAsBF,oFAAoF;AACpF,eAAO,MAAM,6BAA6B,GAAU,MAAM;IACxD,MAAM,EAAE,yBAAyB,CAAC;IAClC,GAAG,EAAE,iBAAiB,CAAC;IACvB,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACjD,KAAG,OAAO,CAAC,yBAAyB,EAAE,CAoBtC,CAAC"}