@12ui/design 0.2.71 → 0.2.73

package/dist/cli-workflow-command.d.ts

@@ -0,0 +1,8 @@
+import { type CliFlags } from './cli-arguments.js';
+import { type WorkflowTransportService } from './workflow-transport.js';
+/** CLI and MCP delegate to one validation and service boundary; neither starts account onboarding. */
+export declare function runWorkflowCommand(command: readonly string[], flags: CliFlags, dependencies?: {
+    service?: WorkflowTransportService;
+    write?: (result: unknown) => void;
+}): Promise<unknown>;
+//# sourceMappingURL=cli-workflow-command.d.ts.map

package/dist/cli-workflow-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-workflow-command.d.ts","sourceRoot":"","sources":["../src/cli-workflow-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAEgB,KAAK,wBAAwB,EACnD,MAAM,yBAAyB,CAAC;AAajC,sGAAsG;AACtG,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,GAAE;IAClG,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAqDxB"}

package/dist/cli-workflow-command.js

@@ -0,0 +1,97 @@
+import { readFile } from 'node:fs/promises';
+import { CliRefusal } from './cli-refusal.js';
+import { dispatchWorkflowAction, WORKFLOW_ACTIONS, WORKFLOW_RECIPE_NAMES, } from './workflow-transport.js';
+const refuse = (message) => { throw new CliRefusal(message, 'workflow_arguments'); };
+const flag = (flags, name, required = false) => {
+    if (flags[name] === undefined && !required)
+        return undefined;
+    if (typeof flags[name] !== 'string' || !flags[name].trim())
+        return refuse(`--${name} requires a non-empty value`);
+    return flags[name].trim();
+};
+const jsonFile = async (file) => {
+    const content = await readFile(file, 'utf8');
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return refuse(`Invalid JSON in ${file}`);
+    }
+};
+/** CLI and MCP delegate to one validation and service boundary; neither starts account onboarding. */
+export async function runWorkflowCommand(command, flags, dependencies = {}) {
+    const action = command[1];
+    const recipe = WORKFLOW_RECIPE_NAMES.includes(action);
+    if (!recipe && !WORKFLOW_ACTIONS.includes(action))
+        return refuse(`Use workflow ${WORKFLOW_ACTIONS.join(', ')}, or a workflow recipe; see 12ui workflow --help.`);
+    const allowed = {
+        prepare: ['workspace', 'key'], execute: ['workspace', 'providers', 'allow-paid', 'session-capabilities', 'trust-codex-config'],
+        register: ['workspace', 'result', 'attempt'], continue: ['workspace'], fail: ['workspace', 'failure', 'attempt'], status: ['workspace'], import: ['workspace', 'media-type', 'role'],
+        capabilities: ['workspace', 'session-capabilities', 'trust-codex-config'],
+        export: ['workspace', 'destination'], capture: ['workspace', 'width', 'height', 'full-page'],
+        layerdoc: ['workspace'],
+    };
+    const extra = Object.keys(flags).filter(name => ![...(allowed[recipe ? 'prepare' : action] ?? []), 'json', 'quiet'].includes(name));
+    if (extra.length)
+        return refuse(`Unsupported workflow flags: ${extra.map(name => '--' + name).join(', ')}`);
+    const workspace = flag(flags, 'workspace', action !== 'capabilities');
+    const argument = command[2];
+    const expected = action === 'capabilities' ? 2 : action === 'status' ? undefined : 3;
+    if ((expected !== undefined && command.length !== expected) || (action === 'status' && ![2, 3].includes(command.length)))
+        return refuse(`Invalid arguments for workflow ${action}; see 12ui workflow ${action} --help.`);
+    const input = { ...(workspace ? { workspace } : {}) };
+    if (flags['trust-codex-config'] !== undefined) {
+        if (flags['trust-codex-config'] !== true)
+            return refuse('--trust-codex-config is a boolean flag');
+        input.trustCodexConfig = true;
+    }
+    if (recipe || action === 'prepare') {
+        input.key = flag(flags, 'key', true);
+        if (recipe) {
+            input.recipe = action;
+            input.input = await jsonFile(argument);
+        }
+        else
+            input.request = await jsonFile(argument);
+    }
+    else if (action === 'execute' || action === 'register' || action === 'continue' || action === 'fail' || action === 'status' || action === 'export' || action === 'layerdoc') {
+        if (argument)
+            input.operationId = argument;
+        if (action === 'register' || action === 'fail')
+            input.attemptNumber = Number(flag(flags, 'attempt', true));
+        if (action === 'register')
+            input.result = await jsonFile(flag(flags, 'result', true));
+        if (action === 'fail')
+            input.failure = await jsonFile(flag(flags, 'failure', true));
+        if (action === 'export')
+            input.destination = flag(flags, 'destination', true);
+    }
+    else if (action === 'capture') {
+        input.url = argument;
+        const width = flag(flags, 'width'), height = flag(flags, 'height');
+        if (width !== undefined || height !== undefined)
+            input.viewport = { width: Number(width ?? 1440), height: Number(height ?? 900) };
+        if (flags['full-page'] !== undefined) {
+            if (flags['full-page'] !== true)
+                return refuse('--full-page is a boolean flag');
+            input.fullPage = true;
+        }
+    }
+    else if (action === 'import') {
+        input.file = argument;
+        for (const [source, target] of [['media-type', 'mediaType'], ['role', 'role']]) {
+            const value = flag(flags, source);
+            if (value)
+                input[target] = value;
+        }
+    }
+    for (const [source, target] of [['providers', 'providers'], ['allow-paid', 'allowPaid'], ['session-capabilities', 'sessionCapabilities']]) {
+        const value = flag(flags, source);
+        if (value !== undefined)
+            input[target] = value.split(',').map(entry => entry.trim());
+    }
+    const result = await dispatchWorkflowAction(recipe ? 'prepare' : action, input, dependencies.service);
+    (dependencies.write ?? (value => console.log(JSON.stringify(value, null, 2))))(result);
+    return result;
+}
+//# sourceMappingURL=cli-workflow-command.js.map

package/dist/cli-workflow-command.js.map

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

package/dist/cli-workspace-command.d.ts

@@ -0,0 +1,25 @@
+import { type CliFlags } from './cli-arguments.js';
+import { startSlateBrowserServer } from './slate-browser-server.js';
+/**
+ * `12ui workspace open [runDir] [--latest] [--wait] [--port N] [--no-open]`: the design workspace as a web page, for
+ * an agent that does not have the workspace's MCP tools (Claude Code, Codex without the plugin, any agent with a shell).
+ *
+ * The 12ui server here does the workspace's own work (Design and Edit run on the detached local runner, exactly as
+ * under `12ui mcp`); no agent is needed to generate. It prints one JSON line with the page's address, so an agent can
+ * open it in its own browser, and opens the system browser unless `--no-open`. With `--wait` it blocks until the
+ * user Selects, or sends a Branch or Convert request, prints ONE JSON line describing that decision and exits 0;
+ * without `--wait` it keeps serving until interrupted and prints a line per decision.
+ */
+export type WorkspaceCommandDependencies = {
+    start?: typeof startSlateBrowserServer;
+    open?: (url: string) => Promise<void>;
+    /** Resolves when the process is asked to stop. */
+    stopped?: () => {
+        promise: Promise<void>;
+        release: () => void;
+    };
+    write?: (line: string) => void;
+    latestRunDir?: () => Promise<string | undefined>;
+};
+export declare const runWorkspaceCommand: (command: readonly string[], flags: CliFlags, dependencies?: WorkspaceCommandDependencies) => Promise<void>;
+//# sourceMappingURL=cli-workspace-command.d.ts.map

package/dist/cli-workspace-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-workspace-command.d.ts","sourceRoot":"","sources":["../src/cli-workspace-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAQ5E,OAAO,EAAE,uBAAuB,EAA2B,MAAM,2BAA2B,CAAC;AAG7F;;;;;;;;;GASG;AAEH,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,OAAO,uBAAuB,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM;QAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAChE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD,CAAC;AAwCF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,QAAQ,EACf,eAAc,4BAAiC,KAC9C,OAAO,CAAC,IAAI,CA4Cd,CAAC"}

package/dist/cli-workspace-command.js

@@ -0,0 +1,95 @@
+import { booleanFlag, stringFlag } from './cli-arguments.js';
+import { openBrowser } from './cli-open-browser.js';
+import { CliRefusal } from './cli-refusal.js';
+import { usageRefusal } from './cli-usage.js';
+import { readCorpusConfig } from './config.js';
+import { findLatestSlateRunDir } from './mcp-slate-latest.js';
+import { resolveSlateRunDir } from './mcp-slate-run.js';
+import { startSlateBrowserServer } from './slate-browser-server.js';
+import { lazyCorpus } from './slate-corpus.js';
+const ALLOWED_FLAGS = new Set(['wait', 'no-open', 'latest', 'port', 'origin', 'api-key']);
+const stopSignals = () => {
+    let release = () => undefined;
+    const promise = new Promise((resolve) => {
+        const stop = () => { resolve(); };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+        release = () => { process.off('SIGINT', stop); process.off('SIGTERM', stop); };
+    });
+    return { promise, release };
+};
+const portOf = (flags) => {
+    const given = stringFlag(flags, 'port');
+    if (given === undefined)
+        return 0;
+    const port = Number(given);
+    if (!/^\d+$/u.test(given) || port < 1 || port > 65_535) {
+        throw usageRefusal({ reason: `--port must be a whole number from 1 to 65535, not ${JSON.stringify(given)}.`, code: 'workspace_port_invalid', verb: ['workspace', 'open'] });
+    }
+    return port;
+};
+const resolveRunDir = async (target, flags, latest) => {
+    if (target !== undefined && booleanFlag(flags, 'latest')) {
+        throw usageRefusal({ reason: 'Give a run directory or --latest, not both.', code: 'workspace_target_conflict', verb: ['workspace', 'open'] });
+    }
+    const chosen = target ?? await latest();
+    if (chosen === undefined) {
+        throw new CliRefusal('No finished 12ui draft run was found. Start one with `12ui draft --concept "<product, audience, surface, goal, personality>"`, or name a run directory.', 'workspace_no_run');
+    }
+    try {
+        return await resolveSlateRunDir(chosen);
+    }
+    catch (error) {
+        throw new CliRefusal(error instanceof Error ? error.message : String(error), 'workspace_run_invalid');
+    }
+};
+export const runWorkspaceCommand = async (command, flags, dependencies = {}) => {
+    if (command[1] !== 'open' || command.length > 3) {
+        throw usageRefusal({ reason: '12ui workspace has one action, open, and takes at most one run directory.', code: 'workspace_arguments', verb: ['workspace', 'open'] });
+    }
+    const unknown = Object.keys(flags).filter((name) => !ALLOWED_FLAGS.has(name));
+    if (unknown.length > 0) {
+        throw usageRefusal({ reason: `12ui workspace open does not take --${unknown[0]}.`, code: 'workspace_flag_unknown', verb: ['workspace', 'open'] });
+    }
+    const wait = booleanFlag(flags, 'wait');
+    const write = dependencies.write ?? ((line) => { process.stdout.write(`${line}\n`); });
+    const runDir = await resolveRunDir(command[2]?.trim() || undefined, flags, dependencies.latestRunDir ?? (() => findLatestSlateRunDir({ cwd: process.cwd() })));
+    const port = portOf(flags);
+    let settle = () => undefined;
+    const first = new Promise((resolve) => { settle = resolve; });
+    const stop = (dependencies.stopped ?? stopSignals)();
+    let session;
+    try {
+        session = await (dependencies.start ?? startSlateBrowserServer)({
+            runDir,
+            ...(port > 0 ? { port } : {}),
+            ending: wait,
+            context: {
+                cwd: process.cwd(),
+                corpus: lazyCorpus(() => readCorpusConfig({ origin: stringFlag(flags, 'origin'), apiKey: stringFlag(flags, 'api-key') })),
+            },
+            onDecision: (decision) => { if (wait)
+                settle(decision);
+            else
+                write(JSON.stringify(decision)); },
+        });
+        write(JSON.stringify({ workspace: 'ready', url: session.url, runDir: session.runDir, wait }));
+        if (!booleanFlag(flags, 'no-open')) {
+            await (dependencies.open ?? openBrowser)(session.url).catch((error) => {
+                console.error(`Could not open the browser (${error instanceof Error ? error.message : String(error)}). Open the address above.`);
+            });
+        }
+        const outcome = await Promise.race([first, stop.promise.then(() => undefined)]);
+        if (outcome)
+            write(JSON.stringify(outcome));
+        else if (wait) {
+            process.exitCode = 130;
+            console.error('Stopped before a decision was made in the workspace.');
+        }
+    }
+    finally {
+        stop.release();
+        await session?.close();
+    }
+};
+//# sourceMappingURL=cli-workspace-command.js.map

package/dist/cli-workspace-command.js.map

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

package/dist/config.d.ts

@@ -2,7 +2,13 @@ export type ConversionConfig = {
     origin: string;
     apiKey: string;
 };
+/** Public retrieval accepts the same configuration, with no credential required. */
+export type CorpusConfig = {
+    origin: string;
+    apiKey?: string;
+};
 export declare const normalizeConversionOrigin: (value: string) => string;
 export declare const hasConfiguredConversionCredential: (apiKeyOverride?: string) => boolean;
+export declare const readCorpusConfig: (overrides?: Partial<CorpusConfig>) => CorpusConfig;
 export declare const readConversionConfig: (overrides?: Partial<ConversionConfig>) => ConversionConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,MAezD,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,iBAAiB,MAAM,KACtB,OAIF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,YAAW,OAAO,CAAC,gBAAgB,CAAM,KAAG,gBAkBhF,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,MAezD,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,iBAAiB,MAAM,KACtB,OAIF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,YAAW,OAAO,CAAC,YAAY,CAAM,KAAG,YAmBxE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,YAAW,OAAO,CAAC,gBAAgB,CAAM,KAAG,gBAMhF,CAAC"}

package/dist/config.js

@@ -23,9 +23,11 @@ export const hasConfiguredConversionCredential = (apiKeyOverride) => {
         return true;
     return readStoredConversionCredentialsSync() !== null;
 };
-export const readConversionConfig = (overrides = {}) => {
+export const readCorpusConfig = (overrides = {}) => {
     const configuredApiKey = overrides.apiKey ?? process.env.TWELVE_UI_API_KEY;
-    const stored = configuredApiKey?.trim() ? null : readStoredConversionCredentialsSync();
+    // An explicit empty key opts out of stored credentials. Invalid supplied
+    // credentials are never silently retried as anonymous requests.
+    const stored = configuredApiKey !== undefined ? null : readStoredConversionCredentialsSync();
     const origin = normalizeConversionOrigin(overrides.origin
         ?? process.env.TWELVE_UI_ORIGIN
         ?? stored?.origin
@@ -33,9 +35,15 @@ export const readConversionConfig = (overrides = {}) => {
     const apiKey = (configuredApiKey
         ?? stored?.apiKey
         ?? '').trim();
-    if (!apiKey) {
+    // Keep an explicit empty key in the resolved config so passing it to a
+    // client cannot accidentally rediscover stored credentials on a second read.
+    return { origin, apiKey };
+};
+export const readConversionConfig = (overrides = {}) => {
+    const config = readCorpusConfig(overrides);
+    if (!config.apiKey) {
         throw new MissingTwelveUiCredentialError();
     }
-    return { origin, apiKey };
+    return { origin: config.origin, apiKey: config.apiKey };
 };
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAO1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAU,EAAE;IACjE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,cAAuB,EACd,EAAE;IACX,MAAM,gBAAgB,GAAG,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACzE,IAAI,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,mCAAmC,EAAE,KAAK,IAAI,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,YAAuC,EAAE,EAAoB,EAAE;IAClG,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC3E,MAAM,MAAM,GAAG,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC;IACvF,MAAM,MAAM,GAAG,yBAAyB,CACtC,SAAS,CAAC,MAAM;WACX,OAAO,CAAC,GAAG,CAAC,gBAAgB;WAC5B,MAAM,EAAE,MAAM;WACd,kBAAkB,CACxB,CAAC;IACF,MAAM,MAAM,GAAG,CACb,gBAAgB;WACX,MAAM,EAAE,MAAM;WACd,EAAE,CACR,CAAC,IAAI,EAAE,CAAC;IACT,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,8BAA8B,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAU1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAU,EAAE;IACjE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,cAAuB,EACd,EAAE;IACX,MAAM,gBAAgB,GAAG,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACzE,IAAI,gBAAgB,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,mCAAmC,EAAE,KAAK,IAAI,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAmC,EAAE,EAAgB,EAAE;IACtF,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC3E,yEAAyE;IACzE,gEAAgE;IAChE,MAAM,MAAM,GAAG,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC;IAC7F,MAAM,MAAM,GAAG,yBAAyB,CACtC,SAAS,CAAC,MAAM;WACX,OAAO,CAAC,GAAG,CAAC,gBAAgB;WAC5B,MAAM,EAAE,MAAM;WACd,kBAAkB,CACxB,CAAC;IACF,MAAM,MAAM,GAAG,CACb,gBAAgB;WACX,MAAM,EAAE,MAAM;WACd,EAAE,CACR,CAAC,IAAI,EAAE,CAAC;IACT,uEAAuE;IACvE,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,YAAuC,EAAE,EAAoB,EAAE;IAClG,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,8BAA8B,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC,CAAC"}

package/dist/corpus-access.d.ts

@@ -0,0 +1,11 @@
+/** Standalone retrieval defaults to the bounded embedding search. Hosted draft
+ * orchestration keeps its separately selected reference-search policy. */
+export declare const DEFAULT_CORPUS_MODE: "balanced";
+export declare const PUBLIC_CORPUS_MAX_COUNT = 24;
+export declare const assertPublicCorpusRequest: (input: {
+    k?: number;
+    seed?: number;
+    browseId?: string;
+    mode?: string;
+}, apiKey?: string) => void;
+//# sourceMappingURL=corpus-access.d.ts.map

package/dist/corpus-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-access.d.ts","sourceRoot":"","sources":["../src/corpus-access.ts"],"names":[],"mappings":"AAAA;0EAC0E;AAC1E,eAAO,MAAM,mBAAmB,EAAG,UAAmB,CAAC;AACvD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,yBAAyB,GACpC,OAAO;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,SAAS,MAAM,KACd,IAWF,CAAC"}

package/dist/corpus-access.js

@@ -0,0 +1,18 @@
+/** Standalone retrieval defaults to the bounded embedding search. Hosted draft
+ * orchestration keeps its separately selected reference-search policy. */
+export const DEFAULT_CORPUS_MODE = 'balanced';
+export const PUBLIC_CORPUS_MAX_COUNT = 24;
+export const assertPublicCorpusRequest = (input, apiKey) => {
+    if (apiKey?.trim())
+        return;
+    if (input.mode === 'hedge') {
+        throw new TypeError('Hedge search requires an account for hosted planning. Choose balanced, direct, or adventurer, or plan locally and search those directions.');
+    }
+    if (input.k !== undefined && input.k > PUBLIC_CORPUS_MAX_COUNT) {
+        throw new RangeError(`Public corpus retrieval accepts at most ${PUBLIC_CORPUS_MAX_COUNT} references per request; reduce the count.`);
+    }
+    if (input.seed !== undefined || input.browseId !== undefined) {
+        throw new TypeError('Public corpus retrieval does not accept seed or browseId; omit these account-specific controls.');
+    }
+};
+//# sourceMappingURL=corpus-access.js.map

package/dist/corpus-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-access.js","sourceRoot":"","sources":["../src/corpus-access.ts"],"names":[],"mappings":"AAAA;0EAC0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAmB,CAAC;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAsE,EACtE,MAAe,EACT,EAAE;IACR,IAAI,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO;IAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CAAC,4IAA4I,CAAC,CAAC;IACpK,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,GAAG,uBAAuB,EAAE,CAAC;QAC/D,MAAM,IAAI,UAAU,CAAC,2CAA2C,uBAAuB,4CAA4C,CAAC,CAAC;IACvI,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC7D,MAAM,IAAI,SAAS,CAAC,iGAAiG,CAAC,CAAC;IACzH,CAAC;AACH,CAAC,CAAC"}

package/dist/corpus-client.d.ts

@@ -1,4 +1,4 @@
-import { type ConversionConfig } from './config.js';
+import { type CorpusConfig } from './config.js';
 import { type ReferenceSearchAdjustment, type InspirationMode } from './reference-search-mode.js';
 export type CorpusTrack = 'r-track' | 'logo-track';
 export type CorpusAspect = 'portrait' | 'landscape' | 'square';
@@ -19,10 +19,9 @@ export type CorpusQuality = {
 export type CorpusInspirationRequest = {
     q: string;
     /**
-     * The mode the caller names. Absent, `inspire()` resolves it through
-     * `referenceSearchMode`: the default for a text query, and
-     * `REFERENCE_IMAGE_SEARCH_MODE` when `options.referenceImage` is passed,
-     * because the corpus refuses a hedge query that carries an image.
+     * The mode the caller names. Absent, `inspire()` uses balanced for standalone retrieval. Hosted
+     * draft orchestration passes its own mode explicitly. Hedge cannot carry
+     * `options.referenceImage`.
      */
     mode?: InspirationMode;
     k?: number;
@@ -102,9 +101,9 @@ export type CorpusLogoSearchItem = {
     height: number;
     styleTags: string[];
     description: string | null;
-    styleSimilarity: number;
-    contentSimilarity: number;
-    relevance: number;
+    styleSimilarity?: number;
+    contentSimilarity?: number;
+    relevance?: number;
 };
 export type CorpusLogoSearchResponse = {
     version: 'logo-bar-a-query-v1';
@@ -119,7 +118,8 @@ export type CorpusLogoSearchResponse = {
 export type CorpusReference = {
     referenceId: string;
     track: CorpusTrack;
-    quality: CorpusQuality;
+    /** Available to authenticated accounts; omitted from public metadata. */
+    quality?: CorpusQuality;
     aspect: CorpusAspect;
     width: number;
     height: number;
@@ -161,7 +161,7 @@ export type CorpusStatus = {
     draftReferenceMode?: 'balanced' | 'hedge';
 };
 export declare const CORPUS_QUERY_IDEMPOTENCY_REVISION: "corpus-query-idempotency-v2";
-export type CorpusClientOptions = Partial<ConversionConfig> & {
+export type CorpusClientOptions = Partial<CorpusConfig> & {
     fetch?: typeof globalThis.fetch;
 };
 export declare class TwelveUiCorpusClient {
@@ -170,7 +170,7 @@ export declare class TwelveUiCorpusClient {
     inspire(input: CorpusInspirationRequest, options: {
         idempotencyKey: string;
         referenceImage?: CorpusReferenceImageInput;
-        /** Replay an existing durable request without changing its paid identity. */
+        /** Replay an existing durable request without changing its identity. */
         preserveRecordedRequest?: boolean;
         signal?: AbortSignal;
     }): Promise<CorpusInspirationResponse>;

package/dist/corpus-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corpus-client.d.ts","sourceRoot":"","sources":["../src/corpus-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"corpus-client.d.ts","sourceRoot":"","sources":["../src/corpus-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAOlE,OAAO,EAA+C,KAAK,yBAAyB,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE/I,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAC/D,eAAO,MAAM,kBAAkB,iDAAkD,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAChE;;;;GAIG;AACH,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC;AACpC,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACxG,MAAM,MAAM,wBAAwB,GAAG;IACrC,CAAC,EAAE,MAAM,CAAC;IACV;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,MAAM,MAAM,6BAA6B,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AACtF,eAAO,MAAM,gCAAgC,UAAY,CAAC;AAC1D,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AACF,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACpE,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;;;OAQG;IACH,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG;IACtC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACtD,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;AACnE,MAAM,MAAM,uBAAuB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,wBAAwB,EAAE,OAAO,iCAAiC,CAAC;IACnE;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAG,6BAAsC,CAAC;AAExF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAE,CAAC;AAE9F,qBAAa,oBAAoB;;gBAMnB,OAAO,GAAE,mBAAwB;IAKvC,OAAO,CACX,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,yBAAyB,CAAC;QAC3C,wEAAwE;QACxE,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,OAAO,CAAC,yBAAyB,CAAC;IA0E/B,WAAW,CACf,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACxD,OAAO,CAAC,wBAAwB,CAAC;IAmB9B,MAAM,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IASrE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAMjH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CAqDvG"}

package/dist/corpus-client.js

@@ -1,5 +1,7 @@
 import { createHash } from 'node:crypto';
-import { readConversionConfig } from './config.js';
+import { readCorpusConfig } from './config.js';
+import { assertPublicCorpusRequest, DEFAULT_CORPUS_MODE } from './corpus-access.js';
+import { corpusRateLimitGuidance, corpusRetryAfterSeconds } from './corpus-retry-guidance.js';
 import { declareClientVersion } from './client-version.js';
 import { appendClientAuthGuidance } from './client-auth-guidance.js';
 import { CorpusRequestError, corpusResponseDiagnostic } from './corpus-request-error.js';
@@ -21,13 +23,14 @@ export class TwelveUiCorpusClient {
     #queryIdempotencyPreflight;
     #queryIdempotencyRevision;
     constructor(options = {}) {
-        this.#config = readConversionConfig(options);
+        this.#config = readCorpusConfig(options);
         this.#fetch = options.fetch ?? globalThis.fetch;
     }
     async inspire(input, options) {
         const idempotencyKey = normalizeOptionalIdempotencyKey(options.idempotencyKey, 'idempotencyKey');
         if (!idempotencyKey)
             throw new TypeError('idempotencyKey is required');
+        assertPublicCorpusRequest(input, this.#config.apiKey);
         if (input.seed !== undefined
             && (!Number.isInteger(input.seed) || input.seed < 0 || input.seed > MAX_CORPUS_INSPIRE_SEED)) {
             throw new RangeError(`seed must be an integer between 0 and ${MAX_CORPUS_INSPIRE_SEED}`);
@@ -37,7 +40,7 @@ export class TwelveUiCorpusClient {
         // sent a hedge query carrying an image and earned the corpus's 400 for an
         // SDK consumer even after the CLI stopped doing it.
         const resolution = resolveReferenceSearch({
-            ...(input.mode !== undefined ? { override: input.mode } : {}),
+            override: input.mode ?? DEFAULT_CORPUS_MODE,
             referenceImage: Boolean(options.referenceImage), flag: 'mode', query: input.q,
         });
         const mode = options.preserveRecordedRequest ? referenceSearchMode({
@@ -93,6 +96,7 @@ export class TwelveUiCorpusClient {
         const idempotencyKey = normalizeOptionalIdempotencyKey(options.idempotencyKey, 'idempotencyKey');
         if (!idempotencyKey)
             throw new TypeError('idempotencyKey is required');
+        assertPublicCorpusRequest(input, this.#config.apiKey);
         if (input.k !== undefined && (!Number.isInteger(input.k) || input.k < 1 || input.k > 60)) {
             throw new RangeError('k must be an integer between 1 and 60');
         }
@@ -138,7 +142,7 @@ export class TwelveUiCorpusClient {
             const status = await this.status(signal ? { signal } : {});
             if (status.queryIdempotencyRevision !== CORPUS_QUERY_IDEMPOTENCY_REVISION) {
                 throw new Error(`12UI Worker does not support ${CORPUS_QUERY_IDEMPOTENCY_REVISION};`
-                    + ' refusing a paid corpus request');
+                    + ' refusing a corpus request');
             }
         })();
         const preflight = this.#queryIdempotencyPreflight;
@@ -153,14 +157,21 @@ export class TwelveUiCorpusClient {
     }
     async #request(path, init) {
         const headers = new Headers(init.headers);
-        headers.set('authorization', `Bearer ${this.#config.apiKey}`);
+        if (this.#config.apiKey)
+            headers.set('authorization', `Bearer ${this.#config.apiKey}`);
         headers.set('accept', 'application/json, image/webp');
         declareClientVersion(headers);
         const response = await this.#fetch(`${this.#config.origin}${path}`, { ...init, headers });
         if (!response.ok) {
             const detail = await response.text().catch(() => '');
             const diagnostic = corpusResponseDiagnostic(response, detail, 'http', this.#config.apiKey);
-            throw new CorpusRequestError(appendClientAuthGuidance(`12UI corpus request failed (${response.status}): ${diagnostic.body.slice(0, 500)}`, response.status), response.status, { diagnostic });
+            const retryAfterSeconds = corpusRetryAfterSeconds(response.headers.get('retry-after'));
+            let message = `12UI corpus request failed (${response.status}): ${diagnostic.body.slice(0, 500)}`;
+            if (response.status === 429)
+                message += ` ${corpusRateLimitGuidance(retryAfterSeconds)}`;
+            else if (this.#config.apiKey)
+                message = appendClientAuthGuidance(message, response.status);
+            throw new CorpusRequestError(message, response.status, { diagnostic, retryAfterSeconds });
         }
         return response;
     }

package/dist/corpus-client.js.map

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

package/dist/corpus-inspiration-failure.d.ts

@@ -1,5 +1,5 @@
 export declare const INSPIRATION_FAILURE_FILE = "inspire-failures.jsonl";
-/** Describe the answer we actually received without guessing whether paid work ran. */
+/** Describe the answer we actually received without guessing whether retrieval ran. */
 export declare const recordCorpusInspirationFailure: (args: {
     error: unknown;
     outDir: string;

package/dist/corpus-inspiration-failure.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { CorpusRequestError, safeCorpusDetail } from './corpus-request-error.js';
 const shellQuote = (value) => `'${value.replaceAll("'", "'\"'\"'")}'`;
 export const INSPIRATION_FAILURE_FILE = 'inspire-failures.jsonl';
-/** Describe the answer we actually received without guessing whether paid work ran. */
+/** Describe the answer we actually received without guessing whether retrieval ran. */
 export const recordCorpusInspirationFailure = async (args) => {
     const http = args.error instanceof CorpusRequestError ? args.error : undefined;
     const code = http?.diagnostic?.errorCode;
@@ -17,7 +17,7 @@ export const recordCorpusInspirationFailure = async (args) => {
     const replayed = http?.diagnostic?.headers['x-12ui-idempotent-replay'] === 'true';
     const invalidInput = http?.status === 400 || http?.status === 422;
     const guidance = classification === 'pending' || classification === 'ambiguous' || classification === 'transport_uncertain'
-        ? `The paid outcome is not confirmed. Preserve this attempt and resume with the same identity: ${resume}.`
+        ? `The retrieval outcome is not confirmed. Preserve this attempt and resume with the same identity: ${resume}.`
         : code === 'idempotency_conflict'
             ? 'The service reports a different request under this identity. Inspect the recorded attempt and service query before continuing; do not blindly retry.'
             : http?.status === 401 || http?.status === 403