@volter/live 0.5.211 → 0.5.213

package/BUNDLED_NOTICES

@@ -3,9 +3,9 @@ Bundled license notices
 These notices accompany code incorporated into this package. Separate npm dependencies retain their own licenses.
 
 
-@volter/project@0.5.211
+@volter/project@0.5.213
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/project@0.5.211, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/project@0.5.213, from https://github.com/volter-ai/editor.git
 
 --- packages/project/LICENSE ---
 
@@ -219,13 +219,13 @@ Copyright 2026 Volter AI, Inc.
 
 The project contract was transferred from the Apache-2.0 packages of
 volter-ai/volter-engine and is developed in the public volter-ai/editor
-repository. Original source hashes and revision are recorded in
-provenance/editor-contracts.json. LICENSE contains the Apache-2.0 text.
+repository. Original source revision:
+cf9cb8e22dd7ae5709ed0dd8a46dd6f16d1e4945. LICENSE contains the Apache-2.0 text.
 
 
-@volter/sdk@0.5.211
+@volter/sdk@0.5.213
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/sdk@0.5.211, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/sdk@0.5.213, from https://github.com/volter-ai/editor.git
 
 --- packages/sdk/LICENSE ---
 
@@ -438,16 +438,16 @@ Source: the unmodified npm package @volter/sdk@0.5.211, from https://github.com/
 Copyright 2026 Volter AI, Inc.
 
 Project tool registry, provider execution and related types were transferred
-from the Apache-2.0 SDK package of volter-ai/volter-engine. Original source
-hashes and revision are
-recorded in provenance/editor-server.json.
+from the Apache-2.0 SDK package of volter-ai/volter-engine. The original source
+revision is cf9cb8e22dd7ae5709ed0dd8a46dd6f16d1e4945.
 
 The project output-root policy is Apache-2.0, transferred from the original
-SDK; its exact source is recorded in provenance/editor-server.json.
+SDK at revision cf9cb8e22dd7ae5709ed0dd8a46dd6f16d1e4945.
 
-src/kit/ holds the kit modules integrations share. They were moved here from
-@volter/editor-core's src/ (commits 818f6de1, 94a374b7, 98b22ef6, cb5c1539 and
-the moves after them, all in this repository), where they carried
+The modules integrations share, which sat in src/kit/ and now sit directly
+under src/, were moved here from @volter/editor-core's src/ (commits 818f6de1,
+94a374b7, 98b22ef6, cb5c1539 and the moves after them, all in this repository),
+where they carried
 AGPL-3.0-only as part of the editor package imported from
 volter-ai/volter-engine. They are Volter AI, Inc.'s own work and are licensed
 under Apache-2.0 here. The owner's words are "the runtime should be apache,

package/README.md

@@ -1,20 +1,19 @@
 # Live client
 
-Attach to an existing editor session and drive its documents, Blender commands,
-inspection, history and registered project tools. This package never starts a
-session or runs Blender outside the editor tab.
+Attach to an existing editor session and drive its documents, contributed
+verbs, inspection, history and registered project tools. This package never
+starts a session or runs an integration outside the editor tab.
 
 ```js
 import { connect } from '@volter/live';
 const { editor } = await connect('/path/to/project');
-await editor.blender('blender-status');
+await editor.contributedVerb('<package>-status');
 ```
 
 Connection selection matches the project's canonical path and refuses a missing
-or mismatched session. Gameplay control, recording and game-page automation are
-not part of this modeling release. Runtime JavaScript is bundled for plain Node;
-source and declarations ship alongside it.
-
-Private migration staging: the new product's launcher is not available yet.
-Existing session storage and wire identifiers remain until their producers move
-with them. See the repository WORK.md for the remaining release gates.
+or mismatched session. A session answers only requests that carry its connection
+token, which this package reads from the session's entry in the owner's session
+registry (`~/.volter/editor-sessions.json`); a script's own request to a session
+goes through `sessionFetch` from `@volter/live/registry-format`, which adds it. Runtime JavaScript is bundled for Node; source and
+declarations ship beside it. The running document's registered commands remain
+the authority for the operations an integration exposes.

package/dist/asset-library.d.ts

@@ -0,0 +1,98 @@
+/**
+ * THE ASSET LIBRARY, as the session's `/__editor/asset-library/*` routes answer it (editor-core's
+ * `server/asset-library-routes.ts`, which takes these shapes from here): search a source, list an asset's files, and
+ * download one into the project. `editor.assetLibrary` reaches it through `EditorClient`, so a request carries the
+ * session's connection token as every other one does.
+ */
+import type { EditorClient } from './client.js';
+/** An asset as a search answers it. */
+export interface OnlineAsset {
+    id: string;
+    source: 'polyhaven' | 'ambientcg' | 'local';
+    name: string;
+    type: 'model' | 'animation' | 'source' | 'hdri' | 'texture' | 'material';
+    thumbnailUrl: string;
+    categories: string[];
+    tags: string[];
+    downloadCount?: number;
+    license?: string;
+    author?: string;
+    sourceUrl?: string;
+    cloudHosted?: boolean;
+    variantId?: string;
+    variantCount?: number;
+    sizeBytes?: number;
+    animationCount?: number;
+    deliveryKinds?: ('local-ssd' | 'cloud' | 'remote')[];
+    addedAt?: string;
+    capabilities?: {
+        previewable: boolean;
+        importable: boolean;
+        runtimeReady: boolean;
+        animated: boolean;
+        deliveryAvailable: boolean;
+        health: 'healthy' | 'source-only' | 'unsupported';
+    };
+}
+/** One file of an asset that can be downloaded (`files`); `download` takes it with the asset. */
+export interface AssetFileOption {
+    label: string;
+    format: string;
+    url: string;
+    sizeBytes?: number;
+    /** Additional files that must be downloaded alongside the main URL (GLTF includes). */
+    includes?: {
+        relativePath: string;
+        url: string;
+        size: number;
+    }[];
+}
+/** `GET /search`'s query. `type` is the kind the source names (`model`, `hdri`, …; `all` in the local catalog). */
+export interface AssetSearchQuery {
+    source: OnlineAsset['source'];
+    type: string;
+    q?: string;
+    category?: string;
+    offset?: number;
+    limit?: number;
+}
+/** `POST /download`'s body: the asset and the file `files` offered for it. `license` is the search result's, which the
+ *  route records for a remote source; the local catalog's own license is recorded whatever is passed. */
+export interface AssetDownloadRequest {
+    source: OnlineAsset['source'];
+    id: string;
+    name: string;
+    url: string;
+    format: string;
+    includes?: AssetFileOption['includes'];
+    license?: string;
+}
+/** What a download answers: the file's path under the project's `public/`, the provenance operation that wrote it, and
+ *  `ledgerError` when the asset and its license could not be recorded in `.volter/assets.json`. */
+export interface AssetDownloadResult {
+    ok: true;
+    path: string;
+    provenanceOperationId?: string;
+    ledgerError?: string;
+    alreadyExists?: boolean;
+}
+/** `editor.assetLibrary`: the routes, one call each. */
+export declare class LiveAssetLibrary {
+    #private;
+    constructor(client: EditorClient);
+    /** Search one source: `{ assets, total }`, each asset with its tags, license, author and source address. */
+    search(query: AssetSearchQuery): Promise<{
+        assets: OnlineAsset[];
+        total: number;
+    }>;
+    /** The files an asset can be downloaded as. */
+    files(asset: {
+        source: OnlineAsset['source'];
+        id: string;
+    }): Promise<{
+        files: AssetFileOption[];
+    }>;
+    /** Download one file of an asset into the project's `public/asset-library/`, recording the asset and its license in
+     *  the project's `.volter/assets.json`. */
+    download(request: AssetDownloadRequest): Promise<AssetDownloadResult>;
+}

package/dist/asset-library.js

@@ -0,0 +1,7 @@
+import {
+  LiveAssetLibrary
+} from "./chunk-B2HUWFTT.js";
+export {
+  LiveAssetLibrary
+};
+//# sourceMappingURL=asset-library.js.map

package/dist/asset-library.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/chunk-7WKVJGHZ.js

@@ -0,0 +1,15 @@
+// src/installed-package.ts
+import { existsSync, realpathSync } from "node:fs";
+import { dirname, join } from "node:path";
+function installedPackageDir(fromDir, name) {
+  for (let dir = fromDir; ; dir = dirname(dir)) {
+    const candidate = join(dir, "node_modules", ...name.split("/"));
+    if (existsSync(join(candidate, "package.json"))) return realpathSync(candidate);
+    if (dirname(dir) === dir) return null;
+  }
+}
+
+export {
+  installedPackageDir
+};
+//# sourceMappingURL=chunk-7WKVJGHZ.js.map

package/dist/chunk-7WKVJGHZ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/installed-package.ts"],
+  "sourcesContent": ["import { existsSync, realpathSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\n/**\n * The real directory of installed package `name` as Node finds it from `fromDir`: up the `node_modules` folders, or\n * null when none holds it. It is found by its folder rather than by resolving `<name>/package.json`, which fails for a\n * package whose `exports` does not list that file (`@volter/sdk`).\n */\nexport function installedPackageDir(fromDir: string, name: string): string | null {\n  for (let dir = fromDir; ; dir = dirname(dir)) {\n    const candidate = join(dir, 'node_modules', ...name.split('/'));\n    if (existsSync(join(candidate, 'package.json'))) return realpathSync(candidate);\n    if (dirname(dir) === dir) return null;\n  }\n}\n"],
+  "mappings": ";AAAA,SAAS,YAAY,oBAAoB;AACzC,SAAS,SAAS,YAAY;AAOvB,SAAS,oBAAoB,SAAiB,MAA6B;AAChF,WAAS,MAAM,WAAW,MAAM,QAAQ,GAAG,GAAG;AAC5C,UAAM,YAAY,KAAK,KAAK,gBAAgB,GAAG,KAAK,MAAM,GAAG,CAAC;AAC9D,QAAI,WAAW,KAAK,WAAW,cAAc,CAAC,EAAG,QAAO,aAAa,SAAS;AAC9E,QAAI,QAAQ,GAAG,MAAM,IAAK,QAAO;AAAA,EACnC;AACF;",
+  "names": []
+}

package/dist/chunk-B2HUWFTT.js

@@ -0,0 +1,25 @@
+// src/asset-library.ts
+var LiveAssetLibrary = class {
+  #client;
+  constructor(client) {
+    this.#client = client;
+  }
+  /** Search one source: `{ assets, total }`, each asset with its tags, license, author and source address. */
+  async search(query) {
+    return this.#client.assetLibraryRequest("GET", "search", query);
+  }
+  /** The files an asset can be downloaded as. */
+  async files(asset) {
+    return this.#client.assetLibraryRequest("GET", "files", asset);
+  }
+  /** Download one file of an asset into the project's `public/asset-library/`, recording the asset and its license in
+   *  the project's `.volter/assets.json`. */
+  async download(request) {
+    return this.#client.assetLibraryRequest("POST", "download", request);
+  }
+};
+
+export {
+  LiveAssetLibrary
+};
+//# sourceMappingURL=chunk-B2HUWFTT.js.map

package/dist/chunk-B2HUWFTT.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/asset-library.ts"],
+  "sourcesContent": ["/**\n * THE ASSET LIBRARY, as the session's `/__editor/asset-library/*` routes answer it (editor-core's\n * `server/asset-library-routes.ts`, which takes these shapes from here): search a source, list an asset's files, and\n * download one into the project. `editor.assetLibrary` reaches it through `EditorClient`, so a request carries the\n * session's connection token as every other one does.\n */\nimport type { EditorClient } from './client.js';\n\n/** An asset as a search answers it. */\nexport interface OnlineAsset {\n  id: string;\n  source: 'polyhaven' | 'ambientcg' | 'local';\n  name: string;\n  type: 'model' | 'animation' | 'source' | 'hdri' | 'texture' | 'material';\n  thumbnailUrl: string;\n  categories: string[];\n  tags: string[];\n  downloadCount?: number;\n  license?: string;\n  author?: string;\n  sourceUrl?: string;\n  cloudHosted?: boolean;\n  variantId?: string;\n  variantCount?: number;\n  sizeBytes?: number;\n  animationCount?: number;\n  deliveryKinds?: ('local-ssd' | 'cloud' | 'remote')[];\n  addedAt?: string;\n  capabilities?: {\n    previewable: boolean;\n    importable: boolean;\n    runtimeReady: boolean;\n    animated: boolean;\n    deliveryAvailable: boolean;\n    health: 'healthy' | 'source-only' | 'unsupported';\n  };\n}\n\n/** One file of an asset that can be downloaded (`files`); `download` takes it with the asset. */\nexport interface AssetFileOption {\n  label: string;\n  format: string;\n  url: string;\n  sizeBytes?: number;\n  /** Additional files that must be downloaded alongside the main URL (GLTF includes). */\n  includes?: { relativePath: string; url: string; size: number }[];\n}\n\n/** `GET /search`'s query. `type` is the kind the source names (`model`, `hdri`, \u2026; `all` in the local catalog). */\nexport interface AssetSearchQuery {\n  source: OnlineAsset['source'];\n  type: string;\n  q?: string;\n  category?: string;\n  offset?: number;\n  limit?: number;\n}\n\n/** `POST /download`'s body: the asset and the file `files` offered for it. `license` is the search result's, which the\n *  route records for a remote source; the local catalog's own license is recorded whatever is passed. */\nexport interface AssetDownloadRequest {\n  source: OnlineAsset['source'];\n  id: string;\n  name: string;\n  url: string;\n  format: string;\n  includes?: AssetFileOption['includes'];\n  license?: string;\n}\n\n/** What a download answers: the file's path under the project's `public/`, the provenance operation that wrote it, and\n *  `ledgerError` when the asset and its license could not be recorded in `.volter/assets.json`. */\nexport interface AssetDownloadResult {\n  ok: true;\n  path: string;\n  provenanceOperationId?: string;\n  ledgerError?: string;\n  alreadyExists?: boolean;\n}\n\n/** `editor.assetLibrary`: the routes, one call each. */\nexport class LiveAssetLibrary {\n  readonly #client: EditorClient;\n\n  constructor(client: EditorClient) {\n    this.#client = client;\n  }\n\n  /** Search one source: `{ assets, total }`, each asset with its tags, license, author and source address. */\n  async search(query: AssetSearchQuery): Promise<{ assets: OnlineAsset[]; total: number }> {\n    return this.#client.assetLibraryRequest('GET', 'search', query);\n  }\n\n  /** The files an asset can be downloaded as. */\n  async files(asset: { source: OnlineAsset['source']; id: string }): Promise<{ files: AssetFileOption[] }> {\n    return this.#client.assetLibraryRequest('GET', 'files', asset);\n  }\n\n  /** Download one file of an asset into the project's `public/asset-library/`, recording the asset and its license in\n   *  the project's `.volter/assets.json`. */\n  async download(request: AssetDownloadRequest): Promise<AssetDownloadResult> {\n    return this.#client.assetLibraryRequest('POST', 'download', request);\n  }\n}\n"],
+  "mappings": ";AAiFO,IAAM,mBAAN,MAAuB;AAAA,EACnB;AAAA,EAET,YAAY,QAAsB;AAChC,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA,EAGA,MAAM,OAAO,OAA4E;AACvF,WAAO,KAAK,QAAQ,oBAAoB,OAAO,UAAU,KAAK;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,MAAM,OAA6F;AACvG,WAAO,KAAK,QAAQ,oBAAoB,OAAO,SAAS,KAAK;AAAA,EAC/D;AAAA;AAAA;AAAA,EAIA,MAAM,SAAS,SAA6D;AAC1E,WAAO,KAAK,QAAQ,oBAAoB,QAAQ,YAAY,OAAO;AAAA,EACrE;AACF;",
+  "names": []
+}