@pascal-app/core 1.1.0 → 1.1.2

package/dist/agent-operations/asset-catalog.d.ts

@@ -1,4 +1,4 @@
-import type { AssetInput } from '../schema/index.js';
+import type { CatalogAsset } from './catalog-asset.js';
 import type { AgentContext, SceneNodes } from './types.js';
 /** One search of an item library: its words (none lists the library), a category, at most `limit` hits. */
 export type AssetSearchQuery = {
@@ -8,7 +8,7 @@ export type AssetSearchQuery = {
 };
 export type AssetSearchResult = {
     /** The best hits first, at most the query's limit. */
-    items: AssetInput[];
+    items: CatalogAsset[];
     /** Every item the query matches. */
     total: number;
     /** The categories of every match, most first, where the host counts them: a cut search names them to narrow by. */
@@ -24,23 +24,30 @@ export type AssetSearchResult = {
  */
 export type AssetCatalogSource = {
     search(query: AssetSearchQuery): Promise<AssetSearchResult>;
-    byId(ids: readonly string[]): Promise<AssetInput[]>;
+    byId(ids: readonly string[]): Promise<CatalogAsset[]>;
+    /**
+     * Makes the scripted items a call is about to place renderable in the scene's project (their
+     * GLB, script and images are the library's until copied there). Throws when they cannot be.
+     */
+    bring?(items: readonly CatalogAsset[]): Promise<void>;
 };
 /** What a host's agent tools place from: every item (a built-in list), or a source it searches. */
-export type AssetCatalog = readonly AssetInput[] | AssetCatalogSource;
+export type AssetCatalog = readonly CatalogAsset[] | AssetCatalogSource;
 export declare const isAssetCatalogSource: (catalog: AssetCatalog) => catalog is AssetCatalogSource;
 /**
- * Items in the order search_assets lists them for `text` (`rank`); items that rank alike keep the
- * order they came in. A host that finds hits its own way (a database's fusion) orders them so too.
+ * Items in the order search_assets lists them for `text` (`rank`): those the query names first (by
+ * name or category), and among them the scripted ones before plain GLBs, whatever their rank, as
+ * their params let the agent fit them to the room; then by rank. Items that rank alike keep the order they came in. A
+ * host that finds hits its own way (a database's fusion) orders them so too.
  */
-export declare function rankAssets(items: readonly AssetInput[], text: string): AssetInput[];
+export declare function rankAssets<T extends CatalogAsset>(items: readonly T[], text: string): T[];
 /**
  * A search of a list held whole: the items whose name, id, category or tags hold every word of
  * the query, best first (`rankAssets`, then by name), with the categories of all of them.
  */
-export declare function searchAssetList(items: readonly AssetInput[], { text, category, limit }: AssetSearchQuery): AssetSearchResult;
+export declare function searchAssetList(items: readonly CatalogAsset[], { text, category, limit }: AssetSearchQuery): AssetSearchResult;
 /** A list served as a source: searched as `searchAssetList` does, items by id. */
-export declare function assetCatalogSource(items: readonly AssetInput[]): AssetCatalogSource;
+export declare function assetCatalogSource(items: readonly CatalogAsset[]): AssetCatalogSource;
 /** The key of a search in `catalogSearches`: its words, category and limit. */
 export declare const assetSearchKey: ({ text, category, limit }: AssetSearchQuery) => string;
 /** The searches a `search_assets` input runs, one per query, as its operation reads them. */
@@ -48,16 +55,19 @@ export declare function assetSearchesOf(input: unknown): AssetSearchQuery[];
 /**
  * What a call reads of the library, alone or in a batch: the searches of `search_assets`, and the
  * ids the others look up — the items placed or viewed, furnish_room's set for its room type, the
- * catalog items a paint with no role finishes (their models list the surfaces).
+ * catalog items a paint with no role finishes (their models list the surfaces). `placing` is those
+ * of the ids the call may place.
  */
 export declare function catalogReads(nodes: SceneNodes, tool: string, input: unknown): {
     ids: string[];
+    placing: string[];
     searches: AssetSearchQuery[];
 };
 /**
  * What a call reads of the host's library, read before it as the operations are sync. A list is
  * handed over whole. A source answers the call's searches (`catalogSearches`) and gives the items
- * the call names (`catalog`), so a call that names none reads nothing.
+ * the call names (`catalog`), so a call that names none reads nothing; the scripted items it may
+ * place are brought into the scene's project first (`bring`).
  */
 export declare function readCatalog(nodes: SceneNodes, tool: string, input: unknown, catalog: AssetCatalog): Promise<Pick<AgentContext, 'catalog' | 'catalogSearches'>>;
 //# sourceMappingURL=asset-catalog.d.ts.map

package/dist/agent-operations/asset-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-catalog.d.ts","sourceRoot":"","sources":["../../src/agent-operations/asset-catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,2GAA2G;AAC3G,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAElF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sDAAsD;IACtD,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,mHAAmH;IACnH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC/C,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3D,IAAI,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;CACpD,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,SAAS,UAAU,EAAE,GAAG,kBAAkB,CAAA;AAErE,eAAO,MAAM,oBAAoB,YAAa,YAAY,KAAG,OAAO,IAAI,kBAC/C,CAAA;AA4DzB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAKnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,EAAE,IAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAC/C,iBAAiB,CAiBnB;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,kBAAkB,CAMnF;AAED,+EAA+E;AAC/E,eAAO,MAAM,cAAc,8BAAoC,gBAAgB,KAAG,MACjC,CAAA;AAKjD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAalE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAqCjD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAe5D"}
+{"version":3,"file":"asset-catalog.d.ts","sourceRoot":"","sources":["../../src/agent-operations/asset-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,2GAA2G;AAC3G,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAElF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sDAAsD;IACtD,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,mHAAmH;IACnH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC/C,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3D,IAAI,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IACrD;;;OAGG;IACH,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,kBAAkB,CAAA;AAEvE,eAAO,MAAM,oBAAoB,YAAa,YAAY,KAAG,OAAO,IAAI,kBAC/C,CAAA;AA+DzB;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAUzF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,EAAE,IAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAC/C,iBAAiB,CAiBnB;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,kBAAkB,CAMrF;AAED,+EAA+E;AAC/E,eAAO,MAAM,cAAc,8BAAoC,gBAAgB,KAAG,MACjC,CAAA;AAKjD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAalE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,CA2CpE;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAiB5D"}

package/dist/agent-operations/asset-catalog.js

@@ -54,14 +54,22 @@ function rank(item, query) {
                         : 6);
     return [Math.max(0, ...ranks), ranks.reduce((sum, value) => sum + value, 0)];
 }
+/** The weakest word rank that still says what the item is: its name's words, or its category's. */
+const NAMED = 3;
 /**
- * Items in the order search_assets lists them for `text` (`rank`); items that rank alike keep the
- * order they came in. A host that finds hits its own way (a database's fusion) orders them so too.
+ * Items in the order search_assets lists them for `text` (`rank`): those the query names first (by
+ * name or category), and among them the scripted ones before plain GLBs, whatever their rank, as
+ * their params let the agent fit them to the room; then by rank. Items that rank alike keep the order they came in. A
+ * host that finds hits its own way (a database's fusion) orders them so too.
  */
 export function rankAssets(items, text) {
+    const tier = (item, [weakest]) => weakest > NAMED ? 2 : item.script ? 0 : 1;
     return items
-        .map((item) => ({ item, rank: rank(item, text) }))
-        .sort((a, b) => a.rank[0] - b.rank[0] || a.rank[1] - b.rank[1])
+        .map((item) => {
+        const itemRank = rank(item, text);
+        return { item, rank: itemRank, tier: tier(item, itemRank) };
+    })
+        .sort((a, b) => a.tier - b.tier || a.rank[0] - b.rank[0] || a.rank[1] - b.rank[1])
         .map(({ item }) => item);
 }
 /**
@@ -115,10 +123,12 @@ export function assetSearchesOf(input) {
 /**
  * What a call reads of the library, alone or in a batch: the searches of `search_assets`, and the
  * ids the others look up — the items placed or viewed, furnish_room's set for its room type, the
- * catalog items a paint with no role finishes (their models list the surfaces).
+ * catalog items a paint with no role finishes (their models list the surfaces). `placing` is those
+ * of the ids the call may place.
  */
 export function catalogReads(nodes, tool, input) {
     const ids = new Set();
+    const placing = new Set();
     const searches = [];
     const visit = (name, args) => {
         switch (name) {
@@ -141,15 +151,19 @@ export function catalogReads(nodes, tool, input) {
                 const roomType = String(args.roomType);
                 for (const id of Object.hasOwn(FURNISH_ROOM_ASSETS, roomType)
                     ? FURNISH_ROOM_ASSETS[roomType]
-                    : [])
+                    : []) {
                     ids.add(id);
+                    placing.add(id);
+                }
                 return;
             }
         }
         if (typeof name !== 'string')
             return;
-        for (const id of placedAssets(name, args))
+        for (const id of placedAssets(name, args)) {
             ids.add(id);
+            placing.add(id);
+        }
         for (const { targets } of roleLessPaints(name, args))
             for (const target of targets) {
                 const node = typeof target === 'string' ? nodes[target] : undefined;
@@ -158,21 +172,25 @@ export function catalogReads(nodes, tool, input) {
             }
     };
     visit(tool, asRecord(input));
-    return { ids: [...ids], searches };
+    return { ids: [...ids], placing: [...placing], searches };
 }
 /**
  * What a call reads of the host's library, read before it as the operations are sync. A list is
  * handed over whole. A source answers the call's searches (`catalogSearches`) and gives the items
- * the call names (`catalog`), so a call that names none reads nothing.
+ * the call names (`catalog`), so a call that names none reads nothing; the scripted items it may
+ * place are brought into the scene's project first (`bring`).
  */
 export async function readCatalog(nodes, tool, input, catalog) {
     if (!isAssetCatalogSource(catalog))
         return { catalog };
-    const { ids, searches } = catalogReads(nodes, tool, input);
+    const { ids, placing, searches } = catalogReads(nodes, tool, input);
     const [items, answers] = await Promise.all([
         ids.length ? catalog.byId(ids) : [],
         Promise.all(searches.map((query) => catalog.search(query))),
     ]);
+    const scripted = items.filter((item) => item.script && placing.includes(item.id));
+    if (scripted.length && catalog.bring)
+        await catalog.bring(scripted);
     return {
         catalog: items,
         ...(searches.length && {

package/dist/agent-operations/asset-views.d.ts

@@ -1,4 +1,3 @@
-import type { AssetInput } from '../schema/index.js';
 import type { AgentContext, AgentOperation, SceneNodes } from './types.js';
 /**
  * What a host read about one catalog item before the call, as the operations are sync: its
@@ -14,9 +13,15 @@ export type AssetViewFacts = {
 type ViewAssetsInput = {
     ids: string[];
 };
-/** The item a host reads: `id` keys its facts, `src` is its model, `thumbnail` its picture. */
-export type AssetViewSubject = Pick<AssetInput, 'id' | 'src'> & {
+/**
+ * The item a host reads: `id` keys its facts, `src` is its model, `thumbnail` its picture. An item
+ * built from a script names its `surfaces` (its manifest's slots), so its model is not read.
+ */
+export type AssetViewSubject = {
+    id: string;
+    src?: string;
     thumbnail?: string;
+    surfaces?: readonly string[];
 };
 /**
  * The names of a GLB's paintable surfaces (its `slot_<id>` materials, as the renderer and the

package/dist/agent-operations/asset-views.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-views.d.ts","sourceRoot":"","sources":["../../src/agent-operations/asset-views.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAExC,+FAA+F;AAC/F,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAStF;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GACxD,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACvE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1C,CAAA;AAkCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,SAAiB,EACjB,UAAuC,EACvC,aAAa,GACd,GAAE;IACD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACpD,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD,GAAG,WAAW,CAyBnB;AAED,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAI5C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,CAyCtE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,EAAE,CAarF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GACrC;IAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAgBrD;AAWD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,eAAe,CAyCtD,CAAA"}
+{"version":3,"file":"asset-views.d.ts","sourceRoot":"","sources":["../../src/agent-operations/asset-views.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAExC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B,CAAA;AASD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GACxD,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBnB;AAED,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACvE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1C,CAAA;AAkCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,SAAiB,EACjB,UAAuC,EACvC,aAAa,GACd,GAAE;IACD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACpD,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD,GAAG,WAAW,CAyBnB;AAED,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAI5C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,CA6CtE;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,EAAE,CAarF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GACrC;IAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA8BrD;AAWD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,eAAe,CAyCtD,CAAA"}

package/dist/agent-operations/asset-views.js

@@ -116,7 +116,11 @@ export function createAssetViewLoader(io) {
     return async (subjects, { pictures = true } = {}) => {
         const entries = await Promise.all(subjects.map(async (subject) => {
             const [surface, picture] = await Promise.allSettled([
-                subject.src ? surfacesOf(subject.src) : Promise.reject(new Error('it has no model')),
+                subject.surfaces
+                    ? [...subject.surfaces]
+                    : subject.src
+                        ? surfacesOf(subject.src)
+                        : Promise.reject(new Error('it has no model')),
                 pictures && subject.thumbnail
                     ? io.picture(subject.thumbnail)
                     : Promise.reject(new Error(pictures ? 'it has no picture' : 'not asked')),
@@ -165,7 +169,14 @@ export function assetViewNeeds(nodes, tool, input, context) {
     if (tool === 'view_assets') {
         const ids = input?.ids;
         const wanted = new Set(Array.isArray(ids) ? ids : []);
-        return { subjects: catalog.filter((item) => wanted.has(item.id)), pictures: true };
+        return {
+            subjects: catalog
+                .filter((item) => wanted.has(item.id))
+                .map(({ id, src, thumbnail, script }) => script
+                ? { id, thumbnail, surfaces: script.manifest.slots.map((slot) => slot.id) }
+                : { id, src, thumbnail }),
+            pictures: true,
+        };
     }
     const subjects = new Map();
     for (const { targets } of roleLessPaints(tool, input))
@@ -174,7 +185,12 @@ export function assetViewNeeds(nodes, tool, input, context) {
             if (node?.type !== 'item' || !node.asset?.id)
                 continue;
             const entry = catalog.find((item) => item.id === node.asset.id);
-            if (entry?.src)
+            if (entry?.script)
+                subjects.set(entry.id, {
+                    id: entry.id,
+                    surfaces: entry.script.manifest.slots.map((slot) => slot.id),
+                });
+            else if (entry?.src)
                 subjects.set(entry.id, { id: entry.id, src: entry.src });
         }
     return { subjects: [...subjects.values()], pictures: false };

package/dist/agent-operations/batch.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { AgentOperation } from './types.js';
+import type { AgentOperation, AgentOperationSteps } from './types.js';
 type BatchInput = {
     calls: {
         tool: string;
@@ -16,7 +16,9 @@ type Contract = {
  * merged into one set — one undo step, one write on either surface. The user: the model spent a
  * round trip per step on what could be serialised (deleting balcony walls one by one, the same
  * build on every floor). Pre-check and operation refusals follow the same per-call policy.
+ * It stops after each call, and where a call that runs in steps (`stepped`) does, so a host that
+ * can let other work run meanwhile does (`AGENT_OPERATIONS.run_batch` runs it through in one go).
  */
-export declare function createBatchOperation(operations: Readonly<Record<string, AgentOperation<never>>>, contracts: readonly Contract[]): AgentOperation<BatchInput>;
+export declare function createBatchSteps(operations: Readonly<Record<string, AgentOperation<never>>>, contracts: readonly Contract[], stepped?: Readonly<Record<string, AgentOperationSteps<never>>>): AgentOperationSteps<BatchInput>;
 export {};
 //# sourceMappingURL=batch.d.ts.map

package/dist/agent-operations/batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/agent-operations/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAA;AAE3D,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAA;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B,CAAA;AACD,KAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;CAAE,CAAA;AA8BlE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAC3D,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,cAAc,CAAC,UAAU,CAAC,CAoF5B"}
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/agent-operations/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAgB,MAAM,SAAS,CAAA;AAEhF,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAA;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B,CAAA;AACD,KAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAA;CAAE,CAAA;AA8BlE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,EAC3D,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAM,GACjE,mBAAmB,CAAC,UAAU,CAAC,CAqFjC"}

package/dist/agent-operations/batch.js

@@ -21,9 +21,11 @@ function prepareCall(call, index, operations, contracts) {
  * merged into one set — one undo step, one write on either surface. The user: the model spent a
  * round trip per step on what could be serialised (deleting balcony walls one by one, the same
  * build on every floor). Pre-check and operation refusals follow the same per-call policy.
+ * It stops after each call, and where a call that runs in steps (`stepped`) does, so a host that
+ * can let other work run meanwhile does (`AGENT_OPERATIONS.run_batch` runs it through in one go).
  */
-export function createBatchOperation(operations, contracts) {
-    return (nodes, { calls, onRefusal = 'stop' }, context) => {
+export function createBatchSteps(operations, contracts, stepped = {}) {
+    return function* (nodes, { calls, onRefusal = 'stop' }, context) {
         let working = nodes;
         let workingContext = context;
         let kept;
@@ -36,10 +38,10 @@ export function createBatchOperation(operations, contracts) {
                     catalog: workingContext.catalog,
                 });
                 const { operation, input } = prepareCall(call, index, operations, contracts);
-                const { result, changes } = operation(working, input, {
-                    ...workingContext,
-                    batchCall: index,
-                });
+                const callContext = { ...workingContext, batchCall: index };
+                const { result, changes } = Object.hasOwn(stepped, call.tool)
+                    ? yield* stepped[call.tool](working, input, callContext)
+                    : operation(working, input, callContext);
                 if (changes) {
                     sets.push(changes);
                     working = applySceneChanges(working, changes);
@@ -78,6 +80,7 @@ export function createBatchOperation(operations, contracts) {
                     error: error.message,
                 });
             }
+            yield;
         }
         const applied = reports.filter((report) => report.status === 'ok').length;
         const merged = mergeSceneChanges(sets);

package/dist/agent-operations/catalog-asset.d.ts

@@ -0,0 +1,15 @@
+import type { AssetInput, GeometryScriptSource } from '../schema/index.js';
+/**
+ * A library item as the agent tools read and place it. A scripted one (a three.js recipe) carries
+ * the script it was built from: placed with it, the item keeps its params, so add_object can
+ * resize or rework it afterwards, where a plain GLB is fixed.
+ */
+export type CatalogAsset = AssetInput & {
+    script?: GeometryScriptSource;
+};
+/** The item node fields a catalog entry places as: its asset, and its script as the node's source. */
+export declare function catalogItemFields({ script, ...asset }: CatalogAsset): {
+    asset: AssetInput;
+    source?: GeometryScriptSource;
+};
+//# sourceMappingURL=catalog-asset.d.ts.map

package/dist/agent-operations/catalog-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-asset.d.ts","sourceRoot":"","sources":["../../src/agent-operations/catalog-asset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEjE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IAAE,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAAE,CAAA;AAEzE,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG;IACrE,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAC9B,CAEA"}

package/dist/agent-operations/catalog-asset.js

@@ -0,0 +1,4 @@
+/** The item node fields a catalog entry places as: its asset, and its script as the node's source. */
+export function catalogItemFields({ script, ...asset }) {
+    return { asset, ...(script && { source: script }) };
+}