@lumenkey/cli 0.2.3 → 0.3.1

package/dist/core/generation-result.d.ts

@@ -1,19 +1,22 @@
-import type { GenerationJobDetail } from './types.js';
-/** A local save failure must not erase a successful, billable gateway result. */
-export declare function generationResult(detail: GenerationJobDetail, idempotencyKey: string, outputPath?: string, signal?: AbortSignal): Promise<{
-    success: boolean;
-    submitted: boolean;
+import type { GenerationJobDetail, JobStatus } from './types.js';
+export interface DownloadReport {
+    ok: boolean;
+    code?: string;
+    error?: string;
+    httpStatus?: number;
+}
+export interface GenerationSuccess {
+    success: true;
+    /** @deprecated 0.3: use `submission === 'created'`. Boolean as in 0.2.x; never present on failures. */
+    submitted: true;
     jobId: string;
     idempotencyKey: string;
-    status: import("./types.js").JobStatus;
-    jobStatus: import("./types.js").JobStatus;
+    status: JobStatus;
+    jobStatus: JobStatus;
     urls: string[];
     localFile: string | undefined;
-    download: {
-        ok: boolean;
-        code?: string;
-        error?: string;
-        httpStatus?: unknown;
-    } | undefined;
-}>;
+    download: DownloadReport | undefined;
+}
+/** A local save failure must not erase a successful, billable gateway result. */
+export declare function generationResult(detail: GenerationJobDetail, idempotencyKey: string, outputPath?: string, signal?: AbortSignal): Promise<GenerationSuccess>;
 //# sourceMappingURL=generation-result.d.ts.map

package/dist/core/generation-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation-result.d.ts","sourceRoot":"","sources":["../../src/core/generation-result.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,iFAAiF;AACjF,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;YAI/G,OAAO;eAAS,MAAM;gBAAU,MAAM;qBAAe,OAAO;;GAUjF"}
+{"version":3,"file":"generation-result.d.ts","sourceRoot":"","sources":["../../src/core/generation-result.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,cAAc;IAAG,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AAEnG,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,uGAAuG;IACvG,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;CACtC;AAED,iFAAiF;AACjF,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAajK"}

package/dist/core/generation-result.js

@@ -1,5 +1,5 @@
 import { assertJobResult, downloadFile } from './poller.js';
-import { errorResult } from './error-result.js';
+import { failure } from './outcome.js';
 /** A local save failure must not erase a successful, billable gateway result. */
 export async function generationResult(detail, idempotencyKey, outputPath, signal) {
     assertJobResult(detail, true);
@@ -12,9 +12,8 @@ export async function generationResult(detail, idempotencyKey, outputPath, signa
             download = { ok: true };
         }
         catch (error) {
-            const failure = errorResult(error);
-            download = { ok: false, code: failure.code, error: failure.error,
-                ...(failure.httpStatus === undefined ? {} : { httpStatus: failure.httpStatus }) };
+            const saved = failure(error);
+            download = { ok: false, code: saved.code, error: saved.error, ...(saved.httpStatus === undefined ? {} : { httpStatus: saved.httpStatus }) };
         }
     }
     return { success: true, submitted: true, jobId: detail.jobId, idempotencyKey, status: detail.status, jobStatus: detail.status, urls, localFile, download };

package/dist/core/generation-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"generation-result.js","sourceRoot":"","sources":["../../src/core/generation-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA2B,EAAE,cAAsB,EAAE,UAAmB,EAAE,MAAoB;IACnI,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzI,IAAI,SAA6B,CAAC;IAClC,IAAI,QAA0F,CAAC;IAC/F,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YAAC,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAAC,QAAQ,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAAC,CAAC;QACpG,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,QAAQ,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;gBAC9D,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC7J,CAAC"}
+{"version":3,"file":"generation-result.js","sourceRoot":"","sources":["../../src/core/generation-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAkBvC,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA2B,EAAE,cAAsB,EAAE,UAAmB,EAAE,MAAoB;IACnI,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzI,IAAI,SAA6B,CAAC;IAClC,IAAI,QAAoC,CAAC;IACzC,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YAAC,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAAC,QAAQ,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAAC,CAAC;QACpG,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,QAAQ,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;QAC9I,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC7J,CAAC"}

package/dist/core/generation.d.ts

@@ -0,0 +1,124 @@
+import { LumenKeyClient } from './client.js';
+import { type GenerationSuccess } from './generation-result.js';
+import { type DryRunPreview } from './generation-input.js';
+import { type JobSuccess, type Outcome, type QuoteSuccess, type Success, type WaitSuccess } from './outcome.js';
+import { type OutputPathPolicy } from './output-path.js';
+import type { GenerationJobDetail, GenerationQuoteResponse } from './types.js';
+export type GenerationEvent = {
+    type: 'quoting';
+    modelId: string;
+    kind: 'video' | 'image';
+} | {
+    type: 'quoted';
+    quote: GenerationQuoteResponse;
+} | {
+    type: 'submitting';
+    quoteId: string;
+    credits: number;
+    idempotencyKey: string;
+    resubmit: boolean;
+} | {
+    type: 'job_created';
+    jobId: string;
+    idempotencyKey: string;
+    quoteId: string;
+} | {
+    type: 'polling';
+    jobId: string;
+} | {
+    type: 'progress';
+    detail: GenerationJobDetail;
+} | {
+    type: 'downloading';
+    jobId: string;
+    kind: 'video' | 'image';
+}
+/** A fact about the pending-submission journal the user should see on stderr (also returned as `detail`). */
+ | {
+    type: 'notice';
+    text: string;
+};
+export interface GenerationRequest {
+    kind: 'video' | 'image';
+    modelId: string;
+    /** Caller-supplied fields; undefined values are ignored and only catalog-declared fields are sent. */
+    fields: Record<string, unknown>;
+    /** Extra key=value pairs. */
+    pairs: string[];
+    dryRun?: boolean;
+    confirm?: boolean;
+    idempotencyKey?: string;
+    maxCredits?: number;
+    /** Surface spelling of the spending-cap option, used in its error text. */
+    capLabel?: string;
+    projectId?: string;
+    outputPath?: string;
+    /** How a relative outputPath is treated; defaults to the CLI's cwd resolution. */
+    outputPathPolicy?: OutputPathPolicy;
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    onEvent?: (event: GenerationEvent) => void;
+    /** Overrides the home directory holding the pending-submission journal; tests only. */
+    home?: string;
+}
+export interface GenerationCompleted extends GenerationSuccess {
+    submission: 'created';
+    /** True when a recorded submission was re-sent instead of quoting anew. */
+    resumed: boolean;
+    quoteId: string;
+    /** Journal facts worth knowing even though the job was created (records seen but not resumed, a record that could not be removed). */
+    detail?: string;
+    job: GenerationJobDetail;
+    videoUrl?: string;
+    imageUrl?: string;
+}
+export type GenerationOutcome = Outcome<DryRunPreview | QuoteSuccess | GenerationCompleted>;
+/**
+ * The nine gateway codes produced *only inside* the create step of `POST /v1/generation-jobs`. The
+ * server checks the idempotency record before that step, so a replay of an earlier unknown
+ * submission that is refused with one of these proves the earlier attempt never created a job (it
+ * would have been replayed instead). Source: `F:/光钥/docs/knowledge/hk-zh-idempotency-contract.md`
+ * (2026-10-12, corrected the same day; read from byte-identical copies of the live compiled server;
+ * not HTTP-tested). Every other refusal of a replay — authentication, rate limiting, body
+ * validation, any 5xx including 500 INTERNAL_ERROR — happens before the create step or is a
+ * catch-all, and says nothing about whether the first attempt committed.
+ *
+ * `COUNTRY_NOT_SUPPORTED` (403) is deliberately absent although the create step can produce it too:
+ * the authentication guard that runs before the idempotency lookup — the API-key check on the public
+ * route and the session check on the console route — refuses with the same code based on the request's
+ * country header. The client cannot tell which of the two places answered, so a replay refused with it
+ * proves nothing about the first attempt; the submission stays `unknown` and the record is kept.
+ */
+export declare const REPLAY_SETTLING_CODES: readonly string[];
+/**
+ * quote -> confirm -> create job -> poll -> finish, for every surface. Never throws: every
+ * exit is an Outcome, and once the job POST has been attempted every exit names the
+ * idempotency key, the quote and whether the submission is known to have happened.
+ */
+export declare function runGeneration(client: LumenKeyClient, req: GenerationRequest): Promise<GenerationOutcome>;
+export interface ResumeRequest {
+    idempotencyKey: string;
+    outputPath?: string;
+    outputPathPolicy?: OutputPathPolicy;
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    onEvent?: (event: GenerationEvent) => void;
+    home?: string;
+}
+/**
+ * `tasks resume <key>` / `lumenkey_resume_submission`: re-send a recorded submission verbatim.
+ * No catalog projection runs — a delisted or changed model cannot block recovering an existing job.
+ * Same sender binding, same 23-hour window, same replay classification, same envelope (`resumed: true`).
+ */
+export declare function resumeSubmission(client: LumenKeyClient, req: ResumeRequest): Promise<Outcome<GenerationCompleted>>;
+export declare function readJob(client: LumenKeyClient, jobId: string): Promise<Outcome<JobSuccess>>;
+export interface WaitRequest {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare function waitJob(client: LumenKeyClient, jobId: string, req?: WaitRequest): Promise<Outcome<WaitSuccess>>;
+export type { Success };
+//# sourceMappingURL=generation.d.ts.map

package/dist/core/generation.d.ts.map

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

package/dist/core/generation.js

@@ -0,0 +1,316 @@
+import crypto from 'node:crypto';
+import { assertIdempotencyKey, LumenKeyError, validateJobId } from './client.js';
+import { assertWaitOptions, pollJob } from './poller.js';
+import { waitForJob } from './wait.js';
+import { generationResult } from './generation-result.js';
+import { buildGenerationInput, dryRunPreview } from './generation-input.js';
+import { quoteCreditLimitError } from './credit-cap.js';
+import { failure, jobOutcome, quoteOutcome, waitOutcome } from './outcome.js';
+import { replayConflictAdvice, replaySettledAdvice, resumeCommandText, ui } from './locale.js';
+import { resolveOutputPath } from './output-path.js';
+import os from 'node:os';
+import { ageMs, ageText, assertJournalWritable, canonical, findInputPolicyConflict, findResumablePendingSubmission, forgetPendingSubmission, isExpired, markPendingSubmissionUnknown, processAlive, rememberPendingSubmission, sameSender, takePendingSubmission } from './submission-journal.js';
+/**
+ * The nine gateway codes produced *only inside* the create step of `POST /v1/generation-jobs`. The
+ * server checks the idempotency record before that step, so a replay of an earlier unknown
+ * submission that is refused with one of these proves the earlier attempt never created a job (it
+ * would have been replayed instead). Source: `F:/光钥/docs/knowledge/hk-zh-idempotency-contract.md`
+ * (2026-10-12, corrected the same day; read from byte-identical copies of the live compiled server;
+ * not HTTP-tested). Every other refusal of a replay — authentication, rate limiting, body
+ * validation, any 5xx including 500 INTERNAL_ERROR — happens before the create step or is a
+ * catch-all, and says nothing about whether the first attempt committed.
+ *
+ * `COUNTRY_NOT_SUPPORTED` (403) is deliberately absent although the create step can produce it too:
+ * the authentication guard that runs before the idempotency lookup — the API-key check on the public
+ * route and the session check on the console route — refuses with the same code based on the request's
+ * country header. The client cannot tell which of the two places answered, so a replay refused with it
+ * proves nothing about the first attempt; the submission stays `unknown` and the record is kept.
+ */
+export const REPLAY_SETTLING_CODES = Object.freeze([
+    'QUOTE_NOT_AVAILABLE',
+    'QUOTE_ALREADY_CONSUMED',
+    'INSUFFICIENT_CREDITS',
+    'SPENDING_LIMIT_EXCEEDED',
+    'ROUTE_PREFERENCE_MISMATCH',
+    'QUOTE_ROUTE_AUTHORITY_INVALID',
+    'MODEL_NOT_AVAILABLE',
+    'ACCOUNT_NOT_ELIGIBLE',
+    'RESTRICTED_GENERATION_DISABLED',
+]);
+/**
+ * What a failed job POST proves. First attempt: the server writes record, hold and job in one
+ * transaction, so a business-coded 4xx (IDEMPOTENCY_CONFLICT included: *this* attempt created
+ * nothing) means `none`; transport loss, timeout, malformed 2xx and every 5xx mean `unknown`.
+ * Replay of a recorded submission: only REPLAY_SETTLING_CODES settle it as `none`.
+ */
+function classifyCreateFailure(error, replay) {
+    if (!(error instanceof LumenKeyError))
+        return 'unknown';
+    if (replay)
+        return REPLAY_SETTLING_CODES.includes(error.code) ? 'none' : 'unknown';
+    // A 4xx without a parsed business code (HTML from a proxy) is not an answer from the gateway's create step.
+    return error.status !== undefined && error.status >= 400 && error.status < 500 && error.code !== 'API_REQUEST_FAILED' ? 'none' : 'unknown';
+}
+/** Same code/status/billing, more specific recovery text. */
+function withAdvice(error, advice) {
+    return new LumenKeyError(error.code, error.status, error.retryAfterMs, `${error.publicMessage} ${advice}`, error.billing);
+}
+/**
+ * record (unless resuming) → POST → classify → journal → poll → finish. Shared by the generate
+ * commands and by `tasks resume`, so there is exactly one place that decides what a failed or
+ * successful POST means for the record and for the user's next step.
+ */
+async function submitAndFinish(client, plan, journal) {
+    const { ctx, emit, notices, note } = journal;
+    const { quoteId, credits, projectId, input, idempotencyKey, pending } = plan;
+    ctx.idempotencyKey = idempotencyKey;
+    ctx.quoteId = quoteId;
+    ctx.resumed = Boolean(pending);
+    ctx.recordedAt = pending?.createdAt;
+    if (!pending) {
+        ctx.recordedAt = new Date().toISOString();
+        rememberPendingSubmission({ ...plan.identity, idempotencyKey, quoteId, projectId, kind: plan.kind, modelId: plan.modelId, input, callerInput: plan.callerInput, credits, createdAt: ctx.recordedAt }, plan.home);
+    }
+    emit({ type: 'submitting', quoteId, credits, idempotencyKey, resubmit: Boolean(pending) });
+    ctx.submission = 'unknown';
+    const journalNote = (error) => note(error instanceof Error ? error.message : String(error));
+    let created;
+    try {
+        created = await client.createJob({ quoteId, projectId, input }, idempotencyKey);
+    }
+    catch (error) {
+        ctx.submission = classifyCreateFailure(error, Boolean(pending));
+        if (ctx.submission === 'none') {
+            // Definite for this attempt: remove our own record (compare-then-unlink; a sibling's record under the same key survives).
+            try {
+                forgetPendingSubmission(idempotencyKey, quoteId, plan.home);
+            }
+            catch (journalError) {
+                journalNote(journalError);
+            }
+        }
+        else {
+            // Make the record resumable without the key, and let the advice describe what is really on disk:
+            // marked and still inside the window → a rerun resumes; marked but already past the window → it will not;
+            // gone → the ledger; could not be marked → the resume command reaches an in-flight record.
+            try {
+                const marked = markPendingSubmissionUnknown(idempotencyKey, plan.home);
+                ctx.recovery = !marked ? 'ledger' : isExpired(marked) ? 'expired' : 'rerun';
+            }
+            catch (journalError) {
+                ctx.recovery = 'resume-command';
+                journalNote(journalError);
+            }
+        }
+        if (notices.length)
+            ctx.detail = notices.join(' ');
+        if (pending && error instanceof LumenKeyError) {
+            if (error.code === 'QUOTE_NOT_AVAILABLE')
+                throw withAdvice(error, replaySettledAdvice());
+            if (error.code === 'IDEMPOTENCY_CONFLICT')
+                throw withAdvice(error, replayConflictAdvice());
+        }
+        throw error;
+    }
+    // The job exists: say so before touching the journal; a failed delete can never replace this outcome.
+    ctx.submission = 'created';
+    ctx.jobId = created.jobId;
+    emit({ type: 'job_created', jobId: created.jobId, idempotencyKey, quoteId });
+    try {
+        forgetPendingSubmission(idempotencyKey, quoteId, plan.home);
+    }
+    catch (journalError) {
+        journalNote(journalError);
+    }
+    if (notices.length)
+        ctx.detail = notices.join(' ');
+    emit({ type: 'polling', jobId: created.jobId });
+    const detail = await pollJob(client, created.jobId, {
+        initialIntervalMs: plan.intervalMs, timeoutMs: plan.timeoutMs, signal: plan.signal,
+        onProgress: row => emit({ type: 'progress', detail: row }),
+    });
+    if (plan.outputPath)
+        emit({ type: 'downloading', jobId: created.jobId, kind: plan.kind });
+    const result = await generationResult(detail, idempotencyKey, plan.outputPath, plan.signal);
+    return { ok: true, ...result, submission: 'created', resumed: Boolean(pending), quoteId, job: detail,
+        ...(notices.length ? { detail: notices.join(' ') } : {}),
+        ...(plan.kind === 'video' ? { videoUrl: result.urls[0] } : { imageUrl: result.urls[0] }) };
+}
+function newJournal(ctx, onEvent) {
+    const emit = (event) => onEvent?.(event);
+    const notices = [];
+    return { ctx, emit, notices, note: text => { notices.push(text); emit({ type: 'notice', text }); } };
+}
+/** A record of another account or gateway: send nothing, leave it to its owner. */
+function assertOwnRecord(record, identity, suppliedKey) {
+    if (!sameSender(record, identity)) {
+        throw Object.assign(new LumenKeyError('SUBMISSION_CREDENTIALS_MISMATCH'), { idempotencyKey: suppliedKey ?? record.idempotencyKey, quoteId: record.quoteId });
+    }
+}
+/** Past the resumable window the gateway may have dropped its record; a replay could be misread as "never created". */
+function assertNotExpired(record) {
+    if (isExpired(record))
+        throw Object.assign(new LumenKeyError('SUBMISSION_RECORD_EXPIRED'), { idempotencyKey: record.idempotencyKey, quoteId: record.quoteId });
+}
+function pendingRecordRemainsNote(pending) {
+    return ui(`A pending submission with idempotency key ${pending.idempotencyKey} (quote ${pending.quoteId}, ${pending.credits} credits) is still recorded and was not re-sent; raise the cap or check your job list and balance.`, `幂等键 ${pending.idempotencyKey} 的待确认提交（报价 ${pending.quoteId}，${pending.credits} 算力点）仍有记录且未重发；请提高上限，或核对任务列表与余额。`);
+}
+/**
+ * quote -> confirm -> create job -> poll -> finish, for every surface. Never throws: every
+ * exit is an Outcome, and once the job POST has been attempted every exit names the
+ * idempotency key, the quote and whether the submission is known to have happened.
+ */
+export async function runGeneration(client, req) {
+    const ctx = {};
+    const journal = newJournal(ctx, req.onEvent);
+    const { emit, note } = journal;
+    const capLabel = req.capLabel ?? '--max-credits';
+    try {
+        // Once a confirm is requested, every outcome says what happened to the submission.
+        if (req.confirm)
+            ctx.submission = 'none';
+        client.requireKey();
+        if (req.idempotencyKey !== undefined)
+            assertIdempotencyKey(req.idempotencyKey);
+        assertWaitOptions(req.intervalMs, req.timeoutMs);
+        // Resolve the save path before anything billable so a bad path cannot cost a quote or a job.
+        const outputPath = req.outputPath === undefined ? undefined : resolveOutputPath(req.outputPath, req.outputPathPolicy ?? 'resolve-cwd');
+        const built = await buildGenerationInput(client, req.modelId, req.fields, req.pairs);
+        if (req.dryRun)
+            return { ok: true, ...dryRunPreview(req.modelId, built.input, built.model, req.confirm) };
+        // Recovery instead of a new quote under a new fingerprint:
+        // - an explicit key with a pending record (any state) re-sends that record unchanged;
+        // - otherwise an unconfirmed record for exactly this sender, model and input is resumed — even when
+        //   a *different* explicit key was supplied, because a script that mints a key per attempt is still
+        //   retrying the same submission; the supplied key is then not used and the outcome says so.
+        // Records are bound to the account and gateway that created them.
+        const identity = req.confirm ? client.senderIdentity() : undefined;
+        // Prove the journal is writable before buying a quote, so a refused submission never orphans one.
+        if (req.confirm)
+            assertJournalWritable(req.home);
+        let pending;
+        if (req.confirm && identity) {
+            // Preserve the explicit-key expiry notice before the policy scan sweeps old records.
+            // No request is sent here; the changed-input guard still runs before replay or a new quote.
+            if (req.idempotencyKey !== undefined) {
+                const taken = takePendingSubmission(req.idempotencyKey, req.home);
+                pending = taken.record;
+                if (taken.discarded)
+                    note(ui(`An earlier submission recorded under idempotency key ${req.idempotencyKey} ${ageText(taken.discarded)} is older than 48 hours and can no longer be verified from here; its record was discarded. Check your job list and balance if that submission matters before continuing under this key.`, `幂等键 ${req.idempotencyKey} 下${ageText(taken.discarded)}记录的一次提交已超过 48 小时，无法再从这里核实，记录已丢弃。若那次提交重要，请先核对任务列表与余额，再继续使用该键。`));
+            }
+            const changed = findInputPolicyConflict(identity, req.modelId, built.input, built.callerInput, built.defaults, req.home, built.legacyCallerInput);
+            if (changed) {
+                // No quote, no POST, no rewritten journal. The explicit recovery verb alone replays the
+                // historical body, and keeps its existing sender binding and 23-hour safety window.
+                const advice = isExpired(changed) ? ui('Its replay window has expired; check your job list and balance instead of retrying it.', '该记录已超过安全重放窗口，请核对任务列表和余额，不要重新提交。') : ui(`Use ${resumeCommandText(changed.idempotencyKey, 'en')} to recover the recorded body verbatim.`, `请用 ${resumeCommandText(changed.idempotencyKey, 'zh')} 原样恢复已有提交。`);
+                throw Object.assign(new LumenKeyError('SUBMISSION_INPUT_POLICY_CHANGED', undefined, undefined, ui(`Catalog defaults or client input rules changed an unconfirmed submission (key ${changed.idempotencyKey}, quote ${changed.quoteId}). No new quote or job was sent. ${advice}`, `目录默认值或客户端入参规则使待确认提交的输入发生变化（键 ${changed.idempotencyKey}，报价 ${changed.quoteId}）。没有发送新报价或新任务。${advice}`)), { ...(req.idempotencyKey !== undefined ? { idempotencyKey: req.idempotencyKey } : {}), pendingIdempotencyKey: changed.idempotencyKey,
+                    pendingQuoteId: changed.quoteId, pendingRecordedAt: changed.createdAt, pendingAgeSeconds: Math.floor(ageMs(changed) / 1000) });
+            }
+            if (!pending) {
+                const lookup = findResumablePendingSubmission(identity, req.modelId, canonical(built.input), req.home);
+                for (const text of lookup.notices)
+                    note(text);
+                if (lookup.record && req.idempotencyKey !== undefined) {
+                    // An explicit key means "this is a distinct request": the client neither overrides it nor creates a second
+                    // identical job while an identical submission is unconfirmed. Refuse, and name the pending record structurally.
+                    const pendingRecord = lookup.record;
+                    throw Object.assign(new LumenKeyError('SUBMISSION_PENDING_IDENTICAL', undefined, undefined, ui(`An identical submission is already recorded and unconfirmed under idempotency key ${pendingRecord.idempotencyKey} (quote ${pendingRecord.quoteId}, recorded ${ageText(pendingRecord)}). Nothing was sent under key ${req.idempotencyKey}. Settle it first with ${resumeCommandText(pendingRecord.idempotencyKey, 'en')}; a second identical job cannot be created until then, or until the record expires 23 hours after it was recorded.`, `已有一次相同的提交以幂等键 ${pendingRecord.idempotencyKey} 记录且结果未确认（报价 ${pendingRecord.quoteId}，记录于${ageText(pendingRecord)}）。没有用键 ${req.idempotencyKey} 发送任何内容。请先运行 ${resumeCommandText(pendingRecord.idempotencyKey, 'zh')} 处理它；在它处理完或记录后 23 小时过期之前，无法创建第二个相同的任务。`)), { idempotencyKey: req.idempotencyKey, pendingIdempotencyKey: pendingRecord.idempotencyKey, pendingQuoteId: pendingRecord.quoteId, pendingRecordedAt: pendingRecord.createdAt, pendingAgeSeconds: Math.floor(ageMs(pendingRecord) / 1000) });
+                }
+                pending = lookup.record;
+            }
+        }
+        if (pending && identity) {
+            assertOwnRecord(pending, identity, req.idempotencyKey);
+            assertNotExpired(pending);
+        }
+        let quoteId;
+        let credits;
+        let projectId;
+        let input;
+        if (pending) {
+            if (pending.modelId !== req.modelId || canonical(pending.input) !== canonical(built.input)) {
+                throw Object.assign(new LumenKeyError('SUBMISSION_RETRY_MISMATCH', undefined, undefined, ui(`This idempotency key belongs to a pending submission with a different model or input. Nothing was submitted. Recorded: model ${pending.modelId}, input ${canonical(pending.input)}. Given: model ${req.modelId}, input ${canonical(built.input)}. To re-send the recorded submission as recorded (for example after a catalog change), run ${resumeCommandText(pending.idempotencyKey, 'en')}.`, `该幂等键对应一条待确认的提交，但模型或输入与这次不同。没有提交任何任务。记录：模型 ${pending.modelId}，输入 ${canonical(pending.input)}。这次：模型 ${req.modelId}，输入 ${canonical(built.input)}。要原样重发记录的提交（例如目录变更后），请运行 ${resumeCommandText(pending.idempotencyKey, 'zh')}。`)), { idempotencyKey: pending.idempotencyKey, quoteId: pending.quoteId });
+            }
+            ({ quoteId, credits, projectId, input } = pending);
+            if (req.maxCredits !== undefined && credits > req.maxCredits) {
+                throw Object.assign(quoteCreditLimitError(capLabel), { idempotencyKey: pending.idempotencyKey, quoteId, detail: pendingRecordRemainsNote(pending) });
+            }
+        }
+        else {
+            emit({ type: 'quoting', modelId: req.modelId, kind: req.kind });
+            const quote = await client.getQuote({ modelId: req.modelId, input: built.input });
+            emit({ type: 'quoted', quote });
+            if (req.maxCredits !== undefined && quote.credits > req.maxCredits)
+                throw quoteCreditLimitError(capLabel);
+            if (!req.confirm)
+                return quoteOutcome(quote);
+            quoteId = quote.quoteId;
+            credits = quote.credits;
+            projectId = client.resolveProjectId(req.projectId);
+            input = built.input;
+        }
+        return await submitAndFinish(client, {
+            kind: req.kind, modelId: req.modelId, quoteId, credits, projectId, input, callerInput: built.callerInput, pending,
+            idempotencyKey: pending?.idempotencyKey ?? req.idempotencyKey ?? crypto.randomUUID(),
+            identity: identity, outputPath, intervalMs: req.intervalMs, timeoutMs: req.timeoutMs, signal: req.signal, home: req.home,
+        }, journal);
+    }
+    catch (error) {
+        return failure(error, ctx);
+    }
+}
+/**
+ * `tasks resume <key>` / `lumenkey_resume_submission`: re-send a recorded submission verbatim.
+ * No catalog projection runs — a delisted or changed model cannot block recovering an existing job.
+ * Same sender binding, same 23-hour window, same replay classification, same envelope (`resumed: true`).
+ */
+export async function resumeSubmission(client, req) {
+    const ctx = { submission: 'none', resumed: true };
+    const journal = newJournal(ctx, req.onEvent);
+    try {
+        client.requireKey();
+        assertIdempotencyKey(req.idempotencyKey);
+        assertWaitOptions(req.intervalMs, req.timeoutMs);
+        const outputPath = req.outputPath === undefined ? undefined : resolveOutputPath(req.outputPath, req.outputPathPolicy ?? 'resolve-cwd');
+        const identity = client.senderIdentity();
+        assertJournalWritable(req.home);
+        const taken = takePendingSubmission(req.idempotencyKey, req.home);
+        if (!taken.record) {
+            throw Object.assign(new LumenKeyError('SUBMISSION_RECORD_NOT_FOUND', undefined, undefined, taken.discarded
+                ? ui(`${ui('No pending submission is recorded under this idempotency key for this account and gateway.', '这个账号和网关下没有以该幂等键记录的待确认提交。')} An earlier record under this key (${ageText(taken.discarded)}) was older than 48 hours and was discarded; check your job list and balance.`, `这个账号和网关下没有以该幂等键记录的待确认提交。该键下更早的记录（${ageText(taken.discarded)}）已超过 48 小时并被丢弃；请核对任务列表与余额。`)
+                : undefined), { idempotencyKey: req.idempotencyKey });
+        }
+        const record = taken.record;
+        assertOwnRecord(record, identity, req.idempotencyKey);
+        assertNotExpired(record);
+        if (record.state === 'in-flight' && record.hostname === os.hostname() && record.pid !== process.pid && processAlive(record.pid)) {
+            journal.note(ui(`The process that recorded this submission (pid ${record.pid}) is still alive; resuming anyway. The same key and body are re-sent, so the gateway replays or refuses and never creates a second job.`, `记录这次提交的进程（pid ${record.pid}）仍在运行；仍然继续接续。重发的是同一个键和请求体，网关只会回放或拒绝，不会创建第二个任务。`));
+        }
+        return await submitAndFinish(client, {
+            kind: record.kind, modelId: record.modelId, quoteId: record.quoteId, credits: record.credits, projectId: record.projectId, input: record.input, pending: record,
+            idempotencyKey: record.idempotencyKey, identity, outputPath, intervalMs: req.intervalMs, timeoutMs: req.timeoutMs, signal: req.signal, home: req.home,
+        }, journal);
+    }
+    catch (error) {
+        return failure(error, ctx);
+    }
+}
+export async function readJob(client, jobId) {
+    try {
+        validateJobId(jobId);
+        return jobOutcome(await client.getJob(jobId));
+    }
+    catch (error) {
+        return failure(error);
+    }
+}
+export async function waitJob(client, jobId, req = {}) {
+    try {
+        validateJobId(jobId);
+        return waitOutcome(await waitForJob(client, jobId, req));
+    }
+    catch (error) {
+        return failure(error, { jobId });
+    }
+}
+//# sourceMappingURL=generation.js.map

package/dist/core/generation.js.map

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

package/dist/core/locale.d.ts

@@ -19,8 +19,29 @@ export declare function idempotencyKeyMessages(lang?: Lang): {
 };
 export declare function ui(en: string, zh: string, lang?: Lang): string;
 export declare function waitTimeoutDetail(jobId: string, timeoutMs: number, lang?: Lang): string;
+export declare function waitInterruptedDetail(jobId: string, lang?: Lang): string;
+/**
+ * A job POST was sent but no well-formed answer came back: the gateway may hold a job and credits
+ * for this key. The recovery step depends on what is actually on disk: a record marked unknown is
+ * resumed by rerunning; a record still in flight needs the explicit key; no record means the ledger.
+ */
+export type UnknownRecovery = 'rerun' | 'resume-command' | 'expired' | 'ledger';
+/** Local display only; recovery's machine deadline stays ISO UTC in the outcome. */
+export declare function submissionUnknownMessage(recovery: UnknownRecovery, deadline?: Date, lang?: Lang): string;
+/** The recovery verb on both surfaces, named wherever a keyless rerun will not do. */
+export declare function resumeCommandText(idempotencyKey: string, lang?: Lang): string;
+export declare function submissionUnknownAdvice(idempotencyKey: string, recovery?: UnknownRecovery, recordedAt?: string, lang?: Lang): string;
+/** A replay was refused inside the gateway's create step, which is only reached when no job exists for the key. */
+export declare function replaySettledAdvice(lang?: Lang): string;
+/** A replay met a record for the same key with a different body: the earlier job exists, but this client cannot see it. */
+export declare function replayConflictAdvice(lang?: Lang): string;
+/** Chat requests are replayed by key, so the safe retry is the identical request with the same key. */
+export declare function chatRetryAdvice(idempotencyKey: string, lang?: Lang): string;
+export declare function downloadPathNotAbsoluteDetail(lang?: Lang): string;
 export declare function jobStatusText(status: string, lang?: Lang): string;
 export declare function blankPromptSentence(kind: 'flag' | 'field' | 'user', lang?: Lang): string;
+/** Surface-neutral: neither a CLI flag nor an MCP field is named. */
+export declare function promptRequiredSentence(lang?: Lang): string;
 export declare function spendingCapSentence(label: string, lang?: Lang): string;
 export declare function quoteCapSentence(label: string, lang?: Lang): string;
 export declare function internalUpstreamError(text: string): boolean;

package/dist/core/locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/core/locale.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AA8L/B,wBAAgB,QAAQ,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,MAAM,GAAG,SAAS,CASnF;AAUD,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAQ9G;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAG9E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAI1F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAIxF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,GAAE,IAAoB,GAAG,MAAM,CAI9E;AAID,0GAA0G;AAC1G,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAKvF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAIrF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAW5I;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAoB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQpH;AAED,wBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAE7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAOtG;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAOhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CASvG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAIrF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAoB,GAAG,MAAM,CAIlF;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/core/locale.ts"],"names":[],"mappings":"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"}