@bitmagic/asset-core 0.1.0

package/dist/terminal-failure.d.ts

@@ -0,0 +1,152 @@
+/**
+ * The terminal-failure contract between game-play-agent and its clients.
+ *
+ * Import path matters: this module is deliberately dependency-free and is
+ * published as the `@bitmagic/asset-core/terminal-failure` subpath. Browser
+ * consumers (Creator) MUST import that subpath rather than the package root —
+ * the root barrel re-exports the asset generators, which drag in zod, the
+ * forger client, and node http helpers.
+ *
+ * A "terminal failure" is the single reason an operation stopped without
+ * delivering what the user asked for. Exactly one is produced per failed
+ * operation, and it travels on both the live edit stream and the reconnect /
+ * replay stream so a client that dropped off mid-run learns the same reason as
+ * one that stayed connected.
+ *
+ * Why this lives in a shared package rather than being duplicated: the previous
+ * hand-maintained copies drifted in production — the creator's error union grew
+ * an `insufficient_sparks` member that the agent's never had, so the agent could
+ * not emit the value the client was waiting for. One enum is enforced by the
+ * compiler; two are enforced by memory.
+ *
+ * What the wire carries is FACTS (code + structured detail). What the wire does
+ * NOT carry is copy — no title, no user-facing message, no `retryable` flag.
+ * Presentation is derived from `code` by the client, so an old agent can never
+ * dictate new product copy and a new code cannot ship without the client
+ * deciding how to say it.
+ */
+/**
+ * Every way an operation can terminally fail.
+ *
+ * The organising rule is **one code per distinct remedy**, not one per stack
+ * trace. `spark_floor_reached` and `spark_service_unavailable` are separate
+ * because only the first is fixed by buying sparks; `stream_malformed` and
+ * `agent_internal_error` are separate because the second is our bug and should
+ * be reported rather than retried forever.
+ *
+ * Adding a member is a four-step change — see
+ * `game-play-agent/docs/terminal-failures.md`. The client's presentation table
+ * is asserted exhaustive against this array, so a missing entry fails the build
+ * rather than shipping an unexplained error.
+ */
+export declare const TERMINAL_FAILURE_CODES: readonly ["spark_floor_reached", "spark_service_unavailable", "provider_rate_limited", "provider_unavailable", "context_overflow", "agent_timeout", "stream_malformed", "agent_internal_error", "agent_unavailable", "operation_not_found", "connection_lost", "setup_failed", "changes_rolled_back", "no_changes_applied", "user_cancelled"];
+export type TerminalFailureCode = (typeof TERMINAL_FAILURE_CODES)[number];
+/**
+ * Structured facts about a failure, discriminated by the same `code` as the
+ * envelope. Only codes with facts worth acting on have an arm; the rest carry
+ * no detail. Keeping the discriminator on the detail itself means a narrowed
+ * `detail` stays type-safe when passed around on its own.
+ */
+export type TerminalFailureDetail = {
+    readonly code: 'spark_floor_reached';
+    readonly balance: number;
+    readonly floor: number;
+    readonly shortfall?: number;
+} | {
+    readonly code: 'spark_service_unavailable';
+    readonly failureCount: number;
+    readonly lastStatus?: number;
+} | {
+    readonly code: 'provider_rate_limited';
+    readonly statusCode?: number;
+    readonly provider?: string;
+} | {
+    readonly code: 'provider_unavailable';
+    readonly statusCode?: number;
+    readonly provider?: string;
+} | {
+    readonly code: 'agent_timeout';
+    readonly timeoutSec: number;
+    readonly extended: boolean;
+} | {
+    readonly code: 'agent_unavailable';
+    readonly source: 'reaper' | 'disk-restore' | 'reconnect';
+    readonly lastEventAgeMs?: number;
+} | {
+    readonly code: 'setup_failed';
+    readonly step?: string;
+} | {
+    readonly code: 'changes_rolled_back';
+    readonly gate: 'type-check' | 'world-json';
+    readonly errors: readonly string[];
+} | {
+    readonly code: 'no_changes_applied';
+    readonly subReason: 'zero-tools' | 'replayed-recap' | 'tools-but-no-files';
+};
+/** Current envelope version. Bump only on a breaking field change. */
+export declare const TERMINAL_FAILURE_VERSION = 1;
+/**
+ * A terminal failure, described once, at the moment it is known.
+ */
+export interface TerminalFailure {
+    /** Envelope version. An unrecognised value degrades to `agent_internal_error`. */
+    readonly v: number;
+    /** The discriminator. The only field a UI should branch on. */
+    readonly code: TerminalFailureCode;
+    /**
+     * The operation id, which is also the edit session id. Always present:
+     * it is what a user quotes in a bug report and what fetches the session log.
+     */
+    readonly operationId: string;
+    /**
+     * Raw, untranslated, developer-facing text. Belongs in a "technical details"
+     * block and in analytics. Never use it as a title or as the primary message —
+     * it is frequently a provider error string.
+     */
+    readonly technical: string;
+    /** ISO-8601 instant the failure was decided. */
+    readonly at: string;
+    /** Per-code structured facts, when the code has any. */
+    readonly detail?: TerminalFailureDetail;
+}
+/**
+ * The pre-contract error union that clients already understand.
+ *
+ * Kept on the wire alongside the envelope so a Creator build from before this
+ * contract — and the mobile handler, which reads `errorType` directly — keeps
+ * working unchanged. Derived from `code` via {@link legacyErrorTypeFor} rather
+ * than computed independently, so the two can no longer disagree.
+ */
+export type LegacyErrorType = 'rate_limit' | 'timeout' | 'api_error' | 'context_overflow' | 'stream_error' | 'insufficient_sparks';
+export declare function legacyErrorTypeFor(code: TerminalFailureCode): LegacyErrorType;
+export declare function isTerminalFailureCode(value: unknown): value is TerminalFailureCode;
+/** Inputs to {@link buildTerminalFailure}. `at` is injectable so tests are deterministic. */
+export interface BuildTerminalFailureInput {
+    readonly code: TerminalFailureCode;
+    readonly operationId: string;
+    readonly technical: string;
+    readonly detail?: TerminalFailureDetail;
+    readonly at?: string;
+}
+/**
+ * Construct an envelope. The only supported way to make one — callers that
+ * classify domain errors (thrown values, spark state, outcome gates) should do
+ * so in their own layer and funnel the result through here.
+ */
+export declare function buildTerminalFailure(input: BuildTerminalFailureInput): TerminalFailure;
+/**
+ * Parse an envelope received over the wire.
+ *
+ * Returns `null` only when there is no envelope to parse (absent or not an
+ * object). Anything that IS an envelope but carries an unknown `code` or
+ * version is degraded to `agent_internal_error` with `technical` preserved,
+ * rather than dropped — a client that silently discarded an error it did not
+ * recognise would reintroduce exactly the blank-error problem this contract
+ * exists to remove.
+ *
+ * `onDegraded` is called when that happens so the caller can log it. It is a
+ * parameter rather than a `console` call because this package is consumed in
+ * both a browser bundle and a pino-logging server.
+ */
+export declare function parseTerminalFailure(value: unknown, onDegraded?: (reason: string) => void): TerminalFailure | null;
+//# sourceMappingURL=terminal-failure.d.ts.map

package/dist/terminal-failure.d.ts.map

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

package/dist/terminal-failure.js

@@ -0,0 +1,203 @@
+/**
+ * The terminal-failure contract between game-play-agent and its clients.
+ *
+ * Import path matters: this module is deliberately dependency-free and is
+ * published as the `@bitmagic/asset-core/terminal-failure` subpath. Browser
+ * consumers (Creator) MUST import that subpath rather than the package root —
+ * the root barrel re-exports the asset generators, which drag in zod, the
+ * forger client, and node http helpers.
+ *
+ * A "terminal failure" is the single reason an operation stopped without
+ * delivering what the user asked for. Exactly one is produced per failed
+ * operation, and it travels on both the live edit stream and the reconnect /
+ * replay stream so a client that dropped off mid-run learns the same reason as
+ * one that stayed connected.
+ *
+ * Why this lives in a shared package rather than being duplicated: the previous
+ * hand-maintained copies drifted in production — the creator's error union grew
+ * an `insufficient_sparks` member that the agent's never had, so the agent could
+ * not emit the value the client was waiting for. One enum is enforced by the
+ * compiler; two are enforced by memory.
+ *
+ * What the wire carries is FACTS (code + structured detail). What the wire does
+ * NOT carry is copy — no title, no user-facing message, no `retryable` flag.
+ * Presentation is derived from `code` by the client, so an old agent can never
+ * dictate new product copy and a new code cannot ship without the client
+ * deciding how to say it.
+ */
+/**
+ * Every way an operation can terminally fail.
+ *
+ * The organising rule is **one code per distinct remedy**, not one per stack
+ * trace. `spark_floor_reached` and `spark_service_unavailable` are separate
+ * because only the first is fixed by buying sparks; `stream_malformed` and
+ * `agent_internal_error` are separate because the second is our bug and should
+ * be reported rather than retried forever.
+ *
+ * Adding a member is a four-step change — see
+ * `game-play-agent/docs/terminal-failures.md`. The client's presentation table
+ * is asserted exhaustive against this array, so a missing entry fails the build
+ * rather than shipping an unexplained error.
+ */
+export const TERMINAL_FAILURE_CODES = [
+    /** Balance fell below the mid-processing floor. Buying sparks fixes it. */
+    'spark_floor_reached',
+    /** The billing service could not be reached. The user's balance is fine. */
+    'spark_service_unavailable',
+    /** Upstream model provider rate-limited us. */
+    'provider_rate_limited',
+    /** Upstream model provider returned 5xx / was unavailable. */
+    'provider_unavailable',
+    /** Accumulated thread history exceeded the model's context window. */
+    'context_overflow',
+    /** Our own watchdog stopped the run. */
+    'agent_timeout',
+    /** The model stream itself was malformed — a genuine protocol failure. */
+    'stream_malformed',
+    /** An unhandled exception escaped the agent. Our bug; cite the operationId. */
+    'agent_internal_error',
+    /** The agent process died or was evicted mid-run (OOM, restart, reaper). */
+    'agent_unavailable',
+    /** The operation aged out and can no longer be resumed. */
+    'operation_not_found',
+    /** The client could not re-establish the stream after retrying. */
+    'connection_lost',
+    /** Failed before the agent started; nothing was spent. */
+    'setup_failed',
+    /** Edits were produced and then discarded by an outcome gate. */
+    'changes_rolled_back',
+    /** The run completed but produced no edits at all. */
+    'no_changes_applied',
+    /** The user stopped it. Terminal, but deliberately silent. */
+    'user_cancelled',
+];
+/** Current envelope version. Bump only on a breaking field change. */
+export const TERMINAL_FAILURE_VERSION = 1;
+/**
+ * Map a code onto the legacy union. Exhaustive by construction: adding a code
+ * without a legacy value is a compile error, not a runtime surprise.
+ *
+ * Note `spark_service_unavailable` deliberately maps to `api_error`, not
+ * `insufficient_sparks`. A billing outage used to be reported to users as "out
+ * of sparks" with a Buy button that could not possibly help.
+ */
+const LEGACY_ERROR_TYPE = {
+    spark_floor_reached: 'insufficient_sparks',
+    spark_service_unavailable: 'api_error',
+    provider_rate_limited: 'rate_limit',
+    provider_unavailable: 'api_error',
+    context_overflow: 'context_overflow',
+    agent_timeout: 'timeout',
+    stream_malformed: 'stream_error',
+    agent_internal_error: 'stream_error',
+    agent_unavailable: 'stream_error',
+    operation_not_found: 'stream_error',
+    connection_lost: 'stream_error',
+    setup_failed: 'stream_error',
+    changes_rolled_back: 'stream_error',
+    no_changes_applied: 'stream_error',
+    // Never emitted as an error frame; present only to keep the map total.
+    user_cancelled: 'stream_error',
+};
+export function legacyErrorTypeFor(code) {
+    return LEGACY_ERROR_TYPE[code];
+}
+export function isTerminalFailureCode(value) {
+    return typeof value === 'string' && TERMINAL_FAILURE_CODES.includes(value);
+}
+/**
+ * Construct an envelope. The only supported way to make one — callers that
+ * classify domain errors (thrown values, spark state, outcome gates) should do
+ * so in their own layer and funnel the result through here.
+ */
+export function buildTerminalFailure(input) {
+    const failure = {
+        v: TERMINAL_FAILURE_VERSION,
+        code: input.code,
+        operationId: input.operationId,
+        technical: input.technical,
+        at: input.at ?? new Date().toISOString(),
+        ...(input.detail ? { detail: input.detail } : {}),
+    };
+    return failure;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Required fields per detail arm, by name and primitive type.
+ *
+ * Only the REQUIRED fields are listed — optional ones are passed through
+ * untouched. This exists so a malformed detail is dropped rather than handed to
+ * presentation copy, where a missing `balance` would render as the literal
+ * string "undefined" in front of a user. Codes with no arm are absent.
+ */
+const REQUIRED_DETAIL_FIELDS = {
+    spark_floor_reached: [['balance', 'number'], ['floor', 'number']],
+    spark_service_unavailable: [['failureCount', 'number']],
+    agent_timeout: [['timeoutSec', 'number'], ['extended', 'boolean']],
+    agent_unavailable: [['source', 'string']],
+    changes_rolled_back: [['gate', 'string'], ['errors', 'array']],
+    no_changes_applied: [['subReason', 'string']],
+};
+function detailMatchesCode(code, detail) {
+    if (detail.code !== code)
+        return false;
+    const required = REQUIRED_DETAIL_FIELDS[code];
+    if (!required)
+        return true;
+    return required.every(([field, kind]) => kind === 'array' ? Array.isArray(detail[field]) : typeof detail[field] === kind);
+}
+/**
+ * Parse an envelope received over the wire.
+ *
+ * Returns `null` only when there is no envelope to parse (absent or not an
+ * object). Anything that IS an envelope but carries an unknown `code` or
+ * version is degraded to `agent_internal_error` with `technical` preserved,
+ * rather than dropped — a client that silently discarded an error it did not
+ * recognise would reintroduce exactly the blank-error problem this contract
+ * exists to remove.
+ *
+ * `onDegraded` is called when that happens so the caller can log it. It is a
+ * parameter rather than a `console` call because this package is consumed in
+ * both a browser bundle and a pino-logging server.
+ */
+export function parseTerminalFailure(value, onDegraded) {
+    if (!isRecord(value))
+        return null;
+    const operationId = typeof value.operationId === 'string' ? value.operationId : '';
+    const technical = typeof value.technical === 'string' ? value.technical : '';
+    const at = typeof value.at === 'string' ? value.at : new Date().toISOString();
+    const version = typeof value.v === 'number' ? value.v : TERMINAL_FAILURE_VERSION;
+    if (!isTerminalFailureCode(value.code) || version !== TERMINAL_FAILURE_VERSION) {
+        onDegraded?.(`unrecognised terminal failure (code=${String(value.code)}, v=${String(value.v)}) — degrading to agent_internal_error`);
+        return {
+            v: TERMINAL_FAILURE_VERSION,
+            code: 'agent_internal_error',
+            operationId,
+            technical: technical || `Unrecognised failure code: ${String(value.code)}`,
+            at,
+        };
+    }
+    let detail;
+    if (isRecord(value.detail)) {
+        if (detailMatchesCode(value.code, value.detail)) {
+            detail = value.detail;
+        }
+        else {
+            // The code is still trustworthy, so keep the failure and drop only the
+            // facts. Silently keeping malformed detail is what puts "undefined" in
+            // front of a user.
+            onDegraded?.(`terminal failure ${value.code} carried a malformed detail — dropping it`);
+        }
+    }
+    return {
+        v: TERMINAL_FAILURE_VERSION,
+        code: value.code,
+        operationId,
+        technical,
+        at,
+        ...(detail ? { detail } : {}),
+    };
+}
+//# sourceMappingURL=terminal-failure.js.map

package/dist/terminal-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-failure.js","sourceRoot":"","sources":["../src/terminal-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,2EAA2E;IAC3E,qBAAqB;IACrB,4EAA4E;IAC5E,2BAA2B;IAC3B,+CAA+C;IAC/C,uBAAuB;IACvB,8DAA8D;IAC9D,sBAAsB;IACtB,sEAAsE;IACtE,kBAAkB;IAClB,wCAAwC;IACxC,eAAe;IACf,0EAA0E;IAC1E,kBAAkB;IAClB,+EAA+E;IAC/E,sBAAsB;IACtB,4EAA4E;IAC5E,mBAAmB;IACnB,2DAA2D;IAC3D,qBAAqB;IACrB,mEAAmE;IACnE,iBAAiB;IACjB,0DAA0D;IAC1D,cAAc;IACd,iEAAiE;IACjE,qBAAqB;IACrB,sDAAsD;IACtD,oBAAoB;IACpB,8DAA8D;IAC9D,gBAAgB;CACR,CAAC;AAqBX,sEAAsE;AACtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AA2C1C;;;;;;;GAOG;AACH,MAAM,iBAAiB,GAA2D;IAChF,mBAAmB,EAAE,qBAAqB;IAC1C,yBAAyB,EAAE,WAAW;IACtC,qBAAqB,EAAE,YAAY;IACnC,oBAAoB,EAAE,WAAW;IACjC,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,SAAS;IACxB,gBAAgB,EAAE,cAAc;IAChC,oBAAoB,EAAE,cAAc;IACpC,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,cAAc;IACnC,eAAe,EAAE,cAAc;IAC/B,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,cAAc;IACnC,kBAAkB,EAAE,cAAc;IAClC,uEAAuE;IACvE,cAAc,EAAE,cAAc;CAC/B,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAAyB;IAC1D,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,sBAA4C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,MAAM,OAAO,GAAoB;QAC/B,CAAC,EAAE,wBAAwB;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAsH;IAChJ,mBAAmB,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjE,yBAAyB,EAAE,CAAC,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACvD,aAAa,EAAE,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAClE,iBAAiB,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9D,kBAAkB,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;CAC9C,CAAC;AAEF,SAAS,iBAAiB,CAAC,IAAyB,EAAE,MAA+B;IACnF,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CACtC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAChF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,UAAqC;IAErC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC;IAEjF,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,wBAAwB,EAAE,CAAC;QAC/E,UAAU,EAAE,CACV,uCAAuC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,uCAAuC,CACvH,CAAC;QACF,OAAO;YACL,CAAC,EAAE,wBAAwB;YAC3B,IAAI,EAAE,sBAAsB;YAC5B,WAAW;YACX,SAAS,EAAE,SAAS,IAAI,8BAA8B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;YAC1E,EAAE;SACH,CAAC;IACJ,CAAC;IAED,IAAI,MAAyC,CAAC;IAC9C,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAChD,MAAM,GAAG,KAAK,CAAC,MAA0C,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,uEAAuE;YACvE,uEAAuE;YACvE,mBAAmB;YACnB,UAAU,EAAE,CAAC,oBAAoB,KAAK,CAAC,IAAI,2CAA2C,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,OAAO;QACL,CAAC,EAAE,wBAAwB;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW;QACX,SAAS;QACT,EAAE;QACF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * A single change to world.json, returned as DATA rather than applied.
+ *
+ * Returning patches instead of writing them is what lets one generator serve
+ * both the pod-backed web lane (which writes into a session directory) and the
+ * CLI lane (which writes a local file).
+ *
+ * `set`/`push` address paths inside `worldProfileData`; `setRoot`/`pushRoot`
+ * address paths from the JSON root.
+ */
+export interface DataWorldPatch {
+    type: 'set' | 'push' | 'setRoot' | 'pushRoot';
+    path: string[];
+    value: unknown;
+    /**
+     * Suppress the game reload this write would otherwise trigger. Use when a
+     * later patch in the same batch is the authoritative one that should own the
+     * single reload.
+     */
+    skipReload?: boolean;
+}
+/**
+ * Replace the array item matching `matchKeys`, or append when none matches.
+ *
+ * `matchKeys` names fields **of `value`**: `matchKeys: ['id']` means "the item
+ * whose `id` equals `value.id`". Every upsert in this codebase is field
+ * equality, so naming the fields is enough — the host builds the predicate
+ * from this data via `buildUpsertPredicate`, and the function itself never
+ * crosses a serialization boundary. That is what makes upsert expressible in a
+ * patch a CLI process can receive as JSON.
+ *
+ * Upsert-by-id is what makes regenerating an asset UPGRADE every placed
+ * instance instead of duplicating it — emitting a plain `pushRoot` instead is a
+ * behaviour change, not a workaround.
+ *
+ * Every `matchKeys` field must be a primitive (string, number, boolean, bigint,
+ * symbol, or null) on `value`. `buildUpsertPredicate` compares with `===`, so a
+ * matchKey naming an object- or array-valued field (e.g. `['position']`,
+ * `['fitBox']`) would compare by reference against a freshly-constructed
+ * `value` and never match — silently degrading the upsert into an append on
+ * every regeneration. `validateWorldPatch` rejects such patches.
+ */
+export interface UpsertRootPatch {
+    type: 'upsertRoot';
+    path: string[];
+    matchKeys: string[];
+    value: unknown;
+    skipReload?: boolean;
+}
+export type WorldPatch = DataWorldPatch | UpsertRootPatch;
+/**
+ * The logging surface a generator needs. Structurally satisfied by a pino
+ * logger, so game-play-agent passes its own `createLogger(...)` result directly.
+ * asset-core never constructs a logger itself.
+ *
+ * Each method carries pino's two call shapes. The object-first overload matters
+ * for errors: `warn({ err }, msg)` serializes the Error with its stack as a
+ * structured field, where `warn(\`${err.message}\`)` throws the stack away and
+ * leaves nothing for a log query to key on.
+ */
+export interface CoreLogger {
+    info(message: string, ...rest: unknown[]): void;
+    info(context: Record<string, unknown>, message: string): void;
+    warn(message: string, ...rest: unknown[]): void;
+    warn(context: Record<string, unknown>, message: string): void;
+    error(message: string, ...rest: unknown[]): void;
+    error(context: Record<string, unknown>, message: string): void;
+}
+/** The subset of the Asset Forger client that generators depend on. */
+export interface ForgerClient {
+    hasCredentials(): boolean;
+    getMissingCredentialsMessage(): string;
+    post<T = unknown>(endpoint: string, payload: unknown, loggerName: string): Promise<T>;
+    postJobAndWait<T = unknown>(jobsEndpoint: string, payload: unknown, loggerName: string): Promise<T>;
+}
+/** Everything a generator needs from its host. No filesystem, no framework. */
+export interface GenerateDeps {
+    forger: ForgerClient;
+    /** Human-readable progress line. The web lane forwards it to the SSE stream. */
+    onProgress: (message: string) => void;
+    logger: CoreLogger;
+}
+/** Fields every generator result carries. Generators extend this with their own. */
+export interface AssetResultBase {
+    success: boolean;
+    message: string;
+    patches: WorldPatch[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,cAAc,IAAI,OAAO,CAAC;IAC1B,4BAA4B,IAAI,MAAM,CAAC;IACvC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtF,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrG;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,gFAAgF;IAChF,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,9 @@
+import type { ZodError } from 'zod';
+/**
+ * Render a zod failure as one line naming each offending field.
+ *
+ * Generators return this through `fail()`, so a caller in either lane gets the
+ * same actionable message — the field name is what makes it actionable.
+ */
+export declare function formatZodIssues(error: ZodError): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAIvD"}

package/dist/validation.js

@@ -0,0 +1,12 @@
+/**
+ * Render a zod failure as one line naming each offending field.
+ *
+ * Generators return this through `fail()`, so a caller in either lane gets the
+ * same actionable message — the field name is what makes it actionable.
+ */
+export function formatZodIssues(error) {
+    return error.issues
+        .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+        .join('; ');
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,OAAO,KAAK,CAAC,MAAM;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;SACvE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/world-patch.d.ts

@@ -0,0 +1,25 @@
+import type { UpsertRootPatch, WorldPatch } from './types.js';
+/** Narrow a patch to the upsert kind. */
+export declare function isUpsertRootPatch(patch: WorldPatch): patch is UpsertRootPatch;
+/**
+ * Check a patch's internal consistency. Returns an error message, or null when
+ * the patch is well-formed.
+ *
+ * The absent-or-undefined rule is not decoration: with `matchKeys: ['id']` and a
+ * `value` whose `id` is missing or explicitly `undefined`, a naive predicate
+ * matches the first item that ALSO lacks an id, silently overwriting an
+ * unrelated asset. Absent and explicit-`undefined` are treated identically
+ * because `JSON.stringify` drops `undefined`-valued keys: a patch built
+ * in-process with `value: { id: undefined }` would validate here but arrive in
+ * the CLI lane with no `id` key at all — checking `in` alone would accept the
+ * patch in one lane and reject the identical patch in the other.
+ */
+export declare function validateWorldPatch(patch: WorldPatch): string | null;
+/**
+ * The equality predicate an upsert patch describes: an item matches when every
+ * key in `matchKeys` is present on it and equal to the same field of `value`.
+ *
+ * Call `validateWorldPatch` first — this assumes a well-formed patch.
+ */
+export declare function buildUpsertPredicate(patch: UpsertRootPatch): (item: unknown) => boolean;
+//# sourceMappingURL=world-patch.d.ts.map

package/dist/world-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-patch.d.ts","sourceRoot":"","sources":["../src/world-patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,IAAI,eAAe,CAE7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CA6BnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CASvF"}

package/dist/world-patch.js

@@ -0,0 +1,59 @@
+/** Narrow a patch to the upsert kind. */
+export function isUpsertRootPatch(patch) {
+    return patch.type === 'upsertRoot';
+}
+/**
+ * Check a patch's internal consistency. Returns an error message, or null when
+ * the patch is well-formed.
+ *
+ * The absent-or-undefined rule is not decoration: with `matchKeys: ['id']` and a
+ * `value` whose `id` is missing or explicitly `undefined`, a naive predicate
+ * matches the first item that ALSO lacks an id, silently overwriting an
+ * unrelated asset. Absent and explicit-`undefined` are treated identically
+ * because `JSON.stringify` drops `undefined`-valued keys: a patch built
+ * in-process with `value: { id: undefined }` would validate here but arrive in
+ * the CLI lane with no `id` key at all — checking `in` alone would accept the
+ * patch in one lane and reject the identical patch in the other.
+ */
+export function validateWorldPatch(patch) {
+    if (!isUpsertRootPatch(patch))
+        return null;
+    const where = `upsertRoot at ${patch.path.join('.')}`;
+    if (patch.matchKeys.length === 0) {
+        return `${where}: matchKeys must not be empty`;
+    }
+    const { value } = patch;
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return `${where}: value must be a non-null object to match on its fields`;
+    }
+    const record = value;
+    const missing = patch.matchKeys.filter((key) => !(key in record) || record[key] === undefined);
+    if (missing.length > 0) {
+        return `${where}: matchKeys [${missing.join(', ')}] absent or undefined on value — matching on undefined would overwrite an unrelated item`;
+    }
+    const nonPrimitive = patch.matchKeys.filter((key) => {
+        const v = record[key];
+        return v !== null && (typeof v === 'object' || typeof v === 'function');
+    });
+    if (nonPrimitive.length > 0) {
+        return `${where}: matchKeys [${nonPrimitive.join(', ')}] are non-primitive on value — reference equality would append a duplicate instead of replacing the existing item`;
+    }
+    return null;
+}
+/**
+ * The equality predicate an upsert patch describes: an item matches when every
+ * key in `matchKeys` is present on it and equal to the same field of `value`.
+ *
+ * Call `validateWorldPatch` first — this assumes a well-formed patch.
+ */
+export function buildUpsertPredicate(patch) {
+    const target = patch.value;
+    const keys = patch.matchKeys;
+    return (item) => {
+        if (typeof item !== 'object' || item === null)
+            return false;
+        const record = item;
+        return keys.every((key) => key in record && record[key] === target[key]);
+    };
+}
+//# sourceMappingURL=world-patch.js.map

package/dist/world-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-patch.js","sourceRoot":"","sources":["../src/world-patch.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,OAAO,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,KAAK,GAAG,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAEtD,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,KAAK,+BAA+B,CAAC;IACjD,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,GAAG,KAAK,0DAA0D,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,gBAAgB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,0FAA0F,CAAC;IAC9I,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAClD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,KAAK,gBAAgB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,mHAAmH,CAAC;IAC5K,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAsB;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAgC,CAAC;IACtD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAE7B,OAAO,CAAC,IAAa,EAAW,EAAE;QAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,MAAM,GAAG,IAA+B,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}