@laplace.live/persona-sdk 0.2.0 → 0.3.0

package/README.md

@@ -67,3 +67,16 @@ in Persona). The client reports them via `onWarning` and goes `closed`.
 Treat the token like a password: it grants control of the app, including loading registered
 models and web overlays. The server listens on loopback unless LAN access is enabled in
 Persona's settings.
+
+## Registry and catalog metadata
+
+`model.list` / `asset.list` return refs with provenance and attribution: assets carry
+`origin` (`'bundled'` shipped with the app, `'user'` registered by the user; models carry
+the same as `kind`), and both may carry optional `author` / `url` credits sourced from the
+app's content manifest.
+
+`CatalogItem` is the transport-agnostic content-metadata shape behind pickers: a stable
+`id` (scene refs key off it), an `InventoryKind`, display `name`, and optional
+`thumbnailUrl`, `version`, `author`, `url`, and `download` (payload location + integrity
+for items not yet on disk — Persona will use this to ship bundled content as
+metadata-only rows downloaded from its CDN on demand).

package/dist/methods.d.ts

@@ -59,6 +59,11 @@ export interface InstanceAddRequest {
 export interface InstanceAddResponse {
     instanceId: string;
 }
+export interface InstanceSetModelRequest {
+    instanceId: string;
+    modelId: string;
+}
+export type InstanceSetModelResponse = EmptyResponse;
 export interface InstanceRemoveRequest {
     instanceId: string;
 }
@@ -394,6 +399,11 @@ export interface MethodMap {
         request: InstanceAddRequest;
         response: InstanceAddResponse;
     };
+    /** Swap a model layer's model in place; placement, primary status, and identity carry over. */
+    'instance.setModel': {
+        request: InstanceSetModelRequest;
+        response: InstanceSetModelResponse;
+    };
     /** Removes any scene item — model or object. */
     'instance.remove': {
         request: InstanceRemoveRequest;

package/dist/schemas.d.ts

@@ -64,6 +64,10 @@ export declare const requestSchemas: {
     'instance.add': z.ZodObject<{
         modelId: z.ZodString;
     }, z.core.$strip>;
+    'instance.setModel': z.ZodObject<{
+        instanceId: z.ZodString;
+        modelId: z.ZodString;
+    }, z.core.$strip>;
     'object.add': z.ZodObject<{
         content: z.ZodCustom<ObjectContent, ObjectContent>;
         name: z.ZodOptional<z.ZodString>;

package/dist/schemas.js

@@ -40,6 +40,7 @@ export const requestSchemas = {
     'scene.delete': z.object({ sceneId: nonEmpty }),
     'scene.setShortcut': z.object({ sceneId: nonEmpty, accelerator: nonEmpty.nullable() }),
     'instance.add': z.object({ modelId: nonEmpty }),
+    'instance.setModel': z.object({ instanceId: nonEmpty, modelId: nonEmpty }),
     'object.add': z.object({
         content: z.custom(isRecord, 'content must be an object'),
         name: nonEmpty.optional(),

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 export type ModelFormat = 'live2d' | 'vrm';
 export type ModelKind = 'bundled' | 'user';
+/** Where an item came from: shipped with the app, or added by the user. */
+export type ContentOrigin = 'bundled' | 'user';
 /** A model as the registry lists it. Paths deliberately never cross the wire. */
 export interface ModelRef {
     /** Stable slug, unique per installed model. */
@@ -7,6 +9,10 @@ export interface ModelRef {
     name: string;
     kind: ModelKind;
     format: ModelFormat;
+    /** Creator credit, for attribution in pickers. */
+    author?: string;
+    /** Creator or content homepage (https). */
+    url?: string;
 }
 /** How a registered file is labelled. Wider than an object's content kinds: `.hdr` is only ever an environment map. */
 export type AssetKind = 'image' | 'video' | 'prop' | 'ibl' | 'lut';
@@ -16,7 +22,38 @@ export interface AssetRef {
     name: string;
     /** What the extension makes it — an object created from it starts on this kind. */
     kind: AssetKind;
+    origin: ContentOrigin;
     exists: boolean;
+    /** Creator credit, for attribution in pickers. */
+    author?: string;
+    /** Creator or content homepage (https). */
+    url?: string;
+}
+/** Every content kind the Inventory can list. `pngtuber` is schema-ready before any producer exists. */
+export type InventoryKind = 'live2d' | 'vrm' | 'pngtuber' | 'image' | 'video' | 'prop';
+/**
+ * Content metadata decoupled from any on-disk file — local registry entries and
+ * remote catalog rows both map into it. `id` is stable forever: scene refs key
+ * off it, and it must survive a ship-in-app → download-from-CDN migration.
+ */
+export interface CatalogItem {
+    id: string;
+    kind: InventoryKind;
+    name: string;
+    /** `persona://` for local items; CDN https for metadata-only rows. */
+    thumbnailUrl?: string;
+    /** Payload location + integrity when not on disk; absent = already local. */
+    download?: {
+        url: string;
+        size: number;
+        sha256: string;
+    };
+    /** Content revision, for CDN-side updates of an installed item. */
+    version?: string;
+    /** Creator credit, for attribution in the Inventory row/detail. */
+    author?: string;
+    /** Creator or content homepage (https). */
+    url?: string;
 }
 /** Screen-space placement: pixels from the stage centre, rotation in radians. */
 export interface ScreenPlacement {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript SDK and wire schema for the LAPLACE Persona plugin API",
   "license": "MIT",
   "type": "module",