@aippy/runtime 0.4.2-dev.5 → 0.4.2-dev.8

package/README.md

@@ -127,6 +127,12 @@ const image = await generateImage({
 console.log(image.image?.base64);
 ```
 
+`@aippy/runtime/ai` also exports internal-test Viggle generation with automatic recovery and
+`listViggleModels` for the current user's project history. Project ticket keys
+are resolved by the backend; applications do not settle tickets or pass SKU
+constants. Availability depends on the matching backend/shared MiniStore
+contracts and project configuration. See the [AI module](./src/ai/README.md).
+
 ### Ministore (Internal Test Only)
 
 `@aippy/runtime/ministore` provides project entitlement catalogs, holdings,

package/dist/ai/index.d.ts

@@ -41,5 +41,6 @@ export type { AippyOpenAIConfig } from './openai';
 export { aippyChatConfig, type AippyUseChatOptions, type AippyUIConfig, type AippyChatConfig, UI_CHAT_ENDPOINT, } from './ui';
 export { DEFAULT_BASE_URL, DEFAULT_UI_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_CHAT_SYSTEM, resolveOpenAIConfig, resolveUIConfig, } from './shared';
 export { normalizeError } from './errors';
-export { generateCharacter3D, generateMotion, type GenerateCharacter3DInput, type GenerateMotionInput, type ViggleAsset, } from './viggle/generate';
+export { generateCharacter3D, generateMotion, createViggleRequestId, resumeViggleGeneration, ViggleGenerationError, type GenerateCharacter3DInput, type GenerateMotionInput, type ViggleAsset, type ViggleKind, type ViggleStage, type ResumeViggleGenerationInput, } from './viggle/generate';
+export { listViggleModels, type ListViggleModelsOptions, type ViggleModel, type ViggleModelValue, type ViggleModelsPage, } from './viggle/models';
 export { type AIConfig, type AIConfigValue, type AIConfigItem, type NumberAIConfigItem, type BooleanAIConfigItem, type TextAIConfigItem, type EnumAIConfigItem, type AIConfigError, type AIConfigValues, validateAIConfig, parseAIConfig, loadAIConfig, getAIConfigValue, sendAIConfigToContainer, createAIConfig, } from './config';

package/dist/ai/index.js

@@ -1,22 +1,26 @@
-import { D as o, d as r, e as i, c as n, U as A, a as C, b as g, j as I, g as f, h as t, i as _, l as E, n as T, p as U, r as p, f as D, s as l, v as L } from "../helper-CSe2sxu6.js";
+import { D as o, d as r, e as i, c as n, U as g, V as A, a as t, b as C, o as l, i as I, g as f, h as E, m as _, l as T, k as U, n as p, p as D, r as d, f as L, j as V, s as m, v } from "../helper-CQZmdyi3.js";
 import "../bridge-K3HqQwdj.js";
 export {
   o as DEFAULT_BASE_URL,
   r as DEFAULT_CHAT_MODEL,
   i as DEFAULT_CHAT_SYSTEM,
   n as DEFAULT_UI_BASE_URL,
-  A as UI_CHAT_ENDPOINT,
-  C as aippyAIProvider,
-  g as aippyChatConfig,
-  I as createAIConfig,
+  g as UI_CHAT_ENDPOINT,
+  A as ViggleGenerationError,
+  t as aippyAIProvider,
+  C as aippyChatConfig,
+  l as createAIConfig,
+  I as createViggleRequestId,
   f as generateCharacter3D,
-  t as generateMotion,
+  E as generateMotion,
   _ as getAIConfigValue,
-  E as loadAIConfig,
-  T as normalizeError,
-  U as parseAIConfig,
-  p as resolveOpenAIConfig,
-  D as resolveUIConfig,
-  l as sendAIConfigToContainer,
-  L as validateAIConfig
+  T as listViggleModels,
+  U as loadAIConfig,
+  p as normalizeError,
+  D as parseAIConfig,
+  d as resolveOpenAIConfig,
+  L as resolveUIConfig,
+  V as resumeViggleGeneration,
+  m as sendAIConfigToContainer,
+  v as validateAIConfig
 };

package/dist/ai/viggle/generate.d.ts

@@ -1,26 +1,67 @@
-export interface GenerateCharacter3DInput {
-    /** File from `<input type="file">`. The backend stores it and calls Viggle. */
+import { AISDKError } from 'ai';
+export type ViggleKind = 'character' | 'motion';
+export type ViggleStage = 'authorize' | 'create' | 'poll' | 'resume';
+interface GenerationOptions {
+    /** Optional explicit idempotency key. Normal calls manage recovery internally. */
+    requestId?: string;
+    signal?: AbortSignal;
+}
+export interface GenerateCharacter3DInput extends GenerationOptions {
     image?: Blob;
     imageUrl?: string;
     prompt?: string;
-    signal?: AbortSignal;
 }
-export interface GenerateMotionInput {
+export interface GenerateMotionInput extends GenerationOptions {
     text: string;
     durationSeconds?: number;
-    signal?: AbortSignal;
+}
+export interface ResumeViggleGenerationInput extends GenerationOptions {
+    jobId: string;
+    kind: ViggleKind;
 }
 export interface ViggleAsset {
     url: string;
     thumbnailUrl?: string;
+    jobId: string;
+    requestId: string;
+    kind: ViggleKind;
+    /** Prepaid jobs are delivered only after the coupon consume is confirmed. */
+    billingState?: string;
+}
+interface Handle {
+    requestId?: string;
+    jobId?: string;
+    jobConfirmed?: boolean;
+    kind: ViggleKind;
+    stage: ViggleStage;
+    persist?: () => void;
+    clear?: () => void;
+}
+/** Recovery is automatic on the next call with the same input. Handles remain available for diagnostics and explicit recovery. */
+export declare class ViggleGenerationError extends AISDKError {
+    readonly requestId?: string;
+    readonly jobId?: string;
+    /** True only after the backend confirmed that this job was persisted. */
+    readonly jobConfirmed: boolean;
+    readonly kind: ViggleKind;
+    readonly stage: ViggleStage;
+    readonly reason: string;
+    readonly httpStatus?: number;
+    readonly activeJob?: {
+        jobId: string;
+        kind: ViggleKind;
+        requestId: string;
+        sameInput: boolean;
+    };
+    constructor(message: string, handle: Handle, reason: string, cause?: unknown, httpStatus?: number, activeJob?: ViggleGenerationError['activeJob']);
 }
-/**
- * Create a rigged `.vsplat` character and wait until its CDN URL is ready.
- * Call this from a user gesture. The request goes to the Aippy backend.
- */
+/** One key per user action. A retry of the same action must reuse the key. */
+export declare function createViggleRequestId(): string;
+/** Persist a job, use/buy its project ticket, then wait for confirmed fulfillment. */
 export declare function generateCharacter3D(input: GenerateCharacter3DInput): Promise<ViggleAsset>;
-/**
- * Create a 441-joint GLB motion from text and wait until its CDN URL is ready.
- * Call this from a user gesture. The request goes to the Aippy backend.
- */
+/** Generate a 441-joint GLB motion; quantity is one priced generation coupon. */
 export declare function generateMotion(input: GenerateMotionInput): Promise<ViggleAsset>;
+/** Explicit user action: recover a job with GET only, including consent/recharge. */
+export declare function resumeViggleGeneration(input: ResumeViggleGenerationInput): Promise<ViggleAsset>;
+export declare function viggleScope(signal: AbortSignal): () => void;
+export {};

package/dist/ai/viggle/models.d.ts

@@ -0,0 +1,46 @@
+import { ViggleKind } from './generate';
+export interface ListViggleModelsOptions {
+    kind?: ViggleKind;
+    /** Opaque decimal record ID; keep as a string. */
+    cursor?: string;
+    /** Raw records per page, 1–50; default 20. Filtered pages can be empty. */
+    limit?: number;
+    signal?: AbortSignal;
+}
+export interface ViggleModelValue {
+    schemaVersion: 1;
+    source: 'aisdk.viggle';
+    jobId: string;
+    provider: 'viggle';
+    kind: ViggleKind;
+    durationSeconds?: number;
+    asset: {
+        url: string;
+        format: 'vsplat' | 'glb';
+        thumbnailUrl?: string;
+    };
+    generatedAt: string;
+}
+export interface ViggleModel {
+    recordId: string;
+    benefitKey: string;
+    bizOrderNo: string;
+    jobId: string;
+    kind: ViggleKind;
+    url: string;
+    thumbnailUrl?: string;
+    durationSeconds?: number;
+    generatedAt: string;
+    consumedAt: string;
+    /** Original consumed-item value snapshot; independent of job retention. */
+    value: ViggleModelValue;
+}
+export interface ViggleModelsPage {
+    models: ViggleModel[];
+    nextCursor: string;
+}
+/** Read successful model records for the authenticated user/current project.
+ * Product keys are resolved by the backend, including retired products.
+ * This call never authorizes, recharges, purchases, generates or consumes.
+ */
+export declare function listViggleModels(options?: ListViggleModelsOptions): Promise<ViggleModelsPage>;

package/dist/ai/viggle/recovery.d.ts

@@ -0,0 +1,12 @@
+export interface SavedGeneration {
+    requestId: string;
+    jobId?: string;
+}
+export declare function inputDigest(input: unknown): Promise<string>;
+/** Hints only: server ownership, input binding, CAS and purchase authorization
+ * remain authoritative. Never persist prompts, images, tokens or billing data. */
+export declare function recoveryKey(kind: string, digest: string): string | undefined;
+export declare function readGeneration(key?: string): SavedGeneration | undefined;
+export declare function saveGeneration(key: string | undefined, saved: SavedGeneration): void;
+export declare function clearGeneration(key: string | undefined, requestId: string): void;
+export declare function singleGeneration<T>(key: string | undefined, run: () => Promise<T>, signal: AbortSignal): Promise<T>;

package/dist/{container-message-D4RX93q2.js → container-message-D_fZlguH.js}

@@ -1,5 +1,5 @@
 import { g as o, a as i } from "./bridge-K3HqQwdj.js";
-const r = "0.4.2-dev.5", c = {
+const r = "0.4.2-dev.8", c = {
   version: r
 }, a = c.version, p = "@aippy/runtime";
 function u() {

package/dist/core/index.js

@@ -1,7 +1,7 @@
 import { D as r, g as s, m as o } from "../config-B0A7gHQM.js";
 import { _ as t, r as i } from "../bridge-K3HqQwdj.js";
 import { A as R, a as E, E as c, b as m, c as A } from "../errors-B3bDbQbD.js";
-import { S as f, V as g, c as l, a as y, g as _, s as d } from "../container-message-D4RX93q2.js";
+import { S as f, V as g, c as l, a as y, g as _, s as d } from "../container-message-D_fZlguH.js";
 import { A as D, C as O, R as F, a as I, p as S } from "../runtime-CmoG3v2m.js";
 export {
   D as AippyRuntime,