@dcl-regenesislabs/opendcl 0.1.0-22239132687.commit-eccf1dd → 0.1.0-22312642473.commit-ea3ce8c

package/dist/compact-tool-renderers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Compact tool output renderers for built-in tools (write, read).
+ *
+ * Pi-coding-agent's built-in renderer shows verbose output: write shows 10 lines
+ * of file content, read shows 10 lines of preview. This module provides compact
+ * alternatives that reduce terminal noise when the agent writes/reads many files.
+ *
+ * These are wired in via a monkey-patch on InteractiveMode.getRegisteredToolDefinition
+ * in src/index.ts — they provide renderCall/renderResult without replacing execution logic.
+ */
+import { Text } from "@mariozechner/pi-tui";
+import type { Theme } from "@mariozechner/pi-coding-agent";
+/** Partial tool definition — only the fields ToolExecutionComponent checks */
+interface CompactToolDef {
+    name: string;
+    renderCall?: (args: Record<string, unknown>, theme: Theme) => Text;
+    renderResult?: (result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: unknown;
+    }, options: {
+        expanded: boolean;
+        isPartial: boolean;
+    }, theme: Theme) => Text;
+}
+/**
+ * Returns a partial tool definition with compact renderCall/renderResult
+ * for supported built-in tools, or undefined for tools we don't override.
+ */
+export declare function getCompactToolDefinition(toolName: string): CompactToolDef | undefined;
+export {};
+//# sourceMappingURL=compact-tool-renderers.d.ts.map

package/dist/compact-tool-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-tool-renderers.d.ts","sourceRoot":"","sources":["../src/compact-tool-renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAiB3D,8EAA8E;AAC9E,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnE,YAAY,CAAC,EAAE,CACb,MAAM,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EAC9E,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAClD,KAAK,EAAE,KAAK,KACT,IAAI,CAAC;CACX;AA0FD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAErF"}

package/dist/compact-tool-renderers.js

@@ -0,0 +1,102 @@
+/**
+ * Compact tool output renderers for built-in tools (write, read).
+ *
+ * Pi-coding-agent's built-in renderer shows verbose output: write shows 10 lines
+ * of file content, read shows 10 lines of preview. This module provides compact
+ * alternatives that reduce terminal noise when the agent writes/reads many files.
+ *
+ * These are wired in via a monkey-patch on InteractiveMode.getRegisteredToolDefinition
+ * in src/index.ts — they provide renderCall/renderResult without replacing execution logic.
+ */
+import { Text } from "@mariozechner/pi-tui";
+import { homedir } from "node:os";
+/** Shorten absolute paths to tilde notation (mirrors pi's internal shortenPath) */
+function shortenPath(path) {
+    const home = homedir();
+    if (path.startsWith(home)) {
+        return `~${path.slice(home.length)}`;
+    }
+    return path;
+}
+/** Replace tabs with spaces for consistent rendering */
+function replaceTabs(text) {
+    return text.replace(/\t/g, "    ");
+}
+const READ_PREVIEW_LINES = 5;
+const writeRenderer = {
+    name: "write",
+    renderCall(args, theme) {
+        const rawPath = typeof args.path === "string" ? args.path : null;
+        const content = typeof args.content === "string" ? args.content : null;
+        const path = rawPath !== null ? shortenPath(rawPath) : null;
+        const invalidArg = theme.fg("error", "[invalid arg]");
+        let text = theme.fg("toolTitle", theme.bold("write")) +
+            " " +
+            (path === null ? invalidArg : path ? theme.fg("accent", path) : theme.fg("toolOutput", "..."));
+        if (content !== null) {
+            const lines = content.split("\n").length;
+            const chars = content.length;
+            text += theme.fg("muted", ` (${chars} chars, ${lines} lines)`);
+        }
+        return new Text(text, 0, 0);
+    },
+};
+const readRenderer = {
+    name: "read",
+    renderCall(args, theme) {
+        const rawPath = typeof args.path === "string" ? args.path : null;
+        const path = rawPath !== null ? shortenPath(rawPath) : null;
+        const offset = args.offset;
+        const limit = args.limit;
+        const invalidArg = theme.fg("error", "[invalid arg]");
+        let pathDisplay = path === null ? invalidArg : path ? theme.fg("accent", path) : theme.fg("toolOutput", "...");
+        if (offset !== undefined || limit !== undefined) {
+            const startLine = offset ?? 1;
+            const endLine = limit !== undefined ? startLine + limit - 1 : "";
+            pathDisplay += theme.fg("warning", `:${startLine}${endLine ? `-${endLine}` : ""}`);
+        }
+        return new Text(theme.fg("toolTitle", theme.bold("read")) + " " + pathDisplay, 0, 0);
+    },
+    renderResult(result, { expanded }, theme) {
+        const textBlocks = result.content?.filter((c) => c.type === "text") || [];
+        const output = textBlocks.map((c) => c.text || "").join("\n");
+        if (!output)
+            return new Text("", 0, 0);
+        const lines = output.split("\n");
+        const maxLines = expanded ? lines.length : READ_PREVIEW_LINES;
+        const displayLines = lines.slice(0, maxLines);
+        const remaining = lines.length - maxLines;
+        let text = displayLines.map((line) => theme.fg("toolOutput", replaceTabs(line))).join("\n");
+        if (remaining > 0) {
+            text += theme.fg("muted", `\n... (${remaining} more lines, ctrl+o to expand)`);
+        }
+        const details = result.details;
+        const truncation = details?.truncation;
+        if (truncation?.truncated) {
+            if (truncation.firstLineExceedsLimit) {
+                text += "\n" + theme.fg("warning", "[First line exceeds size limit]");
+            }
+            else if (truncation.truncatedBy === "lines") {
+                text +=
+                    "\n" +
+                        theme.fg("warning", `[Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines]`);
+            }
+            else {
+                text += "\n" + theme.fg("warning", `[Truncated: ${truncation.outputLines} lines shown]`);
+            }
+        }
+        return new Text(text, 0, 0);
+    },
+};
+const renderers = new Map([
+    ["write", writeRenderer],
+    ["read", readRenderer],
+]);
+/**
+ * Returns a partial tool definition with compact renderCall/renderResult
+ * for supported built-in tools, or undefined for tools we don't override.
+ */
+export function getCompactToolDefinition(toolName) {
+    return renderers.get(toolName);
+}
+//# sourceMappingURL=compact-tool-renderers.js.map

package/dist/compact-tool-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-tool-renderers.js","sourceRoot":"","sources":["../src/compact-tool-renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,mFAAmF;AACnF,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAaD,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,aAAa,GAAmB;IACpC,IAAI,EAAE,OAAO;IACb,UAAU,CAAC,IAAI,EAAE,KAAK;QACpB,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACvE,MAAM,IAAI,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAEtD,IAAI,IAAI,GACN,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,GAAG;YACH,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;QAEjG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACzC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;YAC7B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,WAAW,KAAK,SAAS,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC;AAEF,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,IAAI,EAAE,KAAK;QACpB,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,MAAM,IAAI,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2B,CAAC;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAEtD,IAAI,WAAW,GACb,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAE/F,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,WAAW,IAAI,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,GAAG,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QAE1C,IAAI,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5F,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,SAAS,gCAAgC,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAA8C,CAAC;QACtE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAiD,CAAC;QAC9E,IAAI,UAAU,EAAE,SAAS,EAAE,CAAC;YAC1B,IAAI,UAAU,CAAC,qBAAqB,EAAE,CAAC;gBACrC,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;YACxE,CAAC;iBAAM,IAAI,UAAU,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;gBAC9C,IAAI;oBACF,IAAI;wBACJ,KAAK,CAAC,EAAE,CACN,SAAS,EACT,uBAAuB,UAAU,CAAC,WAAW,OAAO,UAAU,CAAC,UAAU,SAAS,CACnF,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,UAAU,CAAC,WAAW,eAAe,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAyB;IAChD,CAAC,OAAO,EAAE,aAAa,CAAC;IACxB,CAAC,MAAM,EAAE,YAAY,CAAC;CACvB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@
  */
 import { main, InteractiveMode } from "@mariozechner/pi-coding-agent";
 import { isDev } from "./utils.js";
+import { getCompactToolDefinition } from "./compact-tool-renderers.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
@@ -70,6 +71,17 @@ InteractiveMode.prototype.showWarning = function (msg) {
         return;
     _showWarning.call(this, msg);
 };
+// Compact tool output — override built-in write/read renderers to reduce terminal noise.
+// When a built-in tool has no custom renderCall/renderResult, pi shows verbose output.
+// By returning compact renderers from getRegisteredToolDefinition, the ToolExecutionComponent
+// uses them instead (see shouldUseBuiltInRenderer() in tool-execution.js).
+const _getToolDef = InteractiveMode.prototype.getRegisteredToolDefinition;
+InteractiveMode.prototype.getRegisteredToolDefinition = function (toolName) {
+    const original = _getToolDef.call(this, toolName);
+    if (original)
+        return original;
+    return getCompactToolDefinition(toolName);
+};
 main(args).catch((err) => {
     console.error("OpenDCL fatal error:", err);
     process.exit(1);

package/dist/index.js.map

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

package/extensions/dcl-init.ts

@@ -19,13 +19,13 @@ async function initScene(
   }
 
   try {
-    const result = await pi.exec("npx", ["@dcl/sdk-commands", "init", "--skip-install"], {
+    const result = await pi.exec("npx", ["@dcl/sdk-commands", "init"], {
       cwd,
-      timeout: 60000,
+      timeout: 180000,
     });
 
     if (result.code === 0) {
-      return { message: "Scene initialized! Run 'npm install' to install dependencies, then use the preview tool to start." };
+      return { message: "Scene initialized and dependencies installed! Use the preview tool to start." };
     } else {
       return { message: `Init failed (exit code ${result.code}): ${result.stderr || result.stdout}`, isError: true };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl-regenesislabs/opendcl",
-  "version": "0.1.0-22239132687.commit-eccf1dd",
+  "version": "0.1.0-22312642473.commit-ea3ce8c",
   "description": "AI coding assistant for Decentraland SDK7 scene development",
   "type": "module",
   "bin": {
@@ -61,5 +61,5 @@
     "prompts/",
     "context/"
   ],
-  "commit": "eccf1ddf7568056584700b927142426e95be390d"
+  "commit": "ea3ce8ca6234b519b29fc8e807ce51402ff3033f"
 }

package/prompts/system.md

@@ -16,7 +16,7 @@ You are **OpenDCL**, an AI coding assistant specialized in Decentraland SDK7 sce
 ### Architecture
 - **Entity-Component System (ECS)**: Scenes are built with entities (IDs), components (data), and systems (logic).
 - **Runtime**: Sandboxed QuickJS — **no** Node.js APIs (`fs`, `http`, `path`, `process` are unavailable).
-- **Imports**: Use `@dcl/sdk/ecs`, `@dcl/sdk/math`, `@dcl/sdk/react-ecs` — never `~system/` or internal paths.
+- **Imports**: Use `@dcl/sdk/ecs`, `@dcl/sdk/math`, `@dcl/sdk/react-ecs` for most APIs. Use `~system/RestrictedActions` for player actions (emotes, teleport, external URLs) and `~system/Runtime` for world time, realm info, and scene info.
 - **Entry point**: `export function main() {}` in `src/index.ts` — the engine calls this on scene load.
 
 ### Scene Constraints
@@ -56,18 +56,16 @@ engine.addSystem((dt: number) => {
 
 **UI with React-ECS:**
 ```tsx
-import ReactEcs, { UiEntity, Label, Button } from '@dcl/sdk/react-ecs'
-
-function MyUI() {
-  return (
-    <UiEntity uiTransform={{ width: 200, height: 50, positionType: 'absolute' }}>
-      <Label value="Hello" fontSize={18} />
-    </UiEntity>
-  )
-}
+import ReactEcs, { ReactEcsRenderer, UiEntity, Label, Button } from '@dcl/sdk/react-ecs'
+
+const MyUI = () => (
+  <UiEntity uiTransform={{ width: 200, height: 50, positionType: 'absolute' }}>
+    <Label value="Hello" fontSize={18} />
+  </UiEntity>
+)
 
 export function setupUi() {
-  ReactEcs.setUiRenderer(MyUI)
+  ReactEcsRenderer.setUiRenderer(MyUI)
 }
 ```
 
@@ -97,9 +95,9 @@ scene-project/
 
 ### Empty Folder (No scene.json)
 1. Ask the user what they want to build.
-2. **Use the `init` tool first** — this uses the official SDK scaffolding to create scene.json, package.json, tsconfig.json, and src/index.ts with the correct, up-to-date configuration. Never create these files manually.
+2. **Use the `init` tool first** — this uses the official SDK scaffolding to create scene.json, package.json, tsconfig.json, and src/index.ts with the correct, up-to-date configuration, and installs dependencies. Never create these files manually.
 3. After init completes, customize `scene.json` (title, description, parcels) and `src/index.ts` (scene code) based on what the user wants.
-4. Run `npm install`, then use the `preview` tool to start the preview server.
+4. Use the `preview` tool to start the preview server.
 
 ### Existing Scene
 1. Read scene.json and src/index.ts to understand the project.
@@ -110,9 +108,13 @@ scene-project/
 - Always position objects within the scene boundaries (based on parcels).
 - Use `Vector3.create()` and `Quaternion.fromEulerDegrees()` for transforms.
 - For 3D models, use `GltfContainer.create(entity, { src: 'models/myModel.glb' })`.
+- `GltfContainer` only works with **local files** — never use external URLs for the `src` field. Always download models into the scene's `models/` directory first.
 - Place `.glb` files in a `models/` directory, textures in `images/`.
 - After writing TypeScript, use the `preview` tool to start the preview server.
-- If the user asks about 3D models, reference the open-source-3D-assets catalog in `context/open-source-3d-assets.md`.
+- **Proactively suggest 3D assets**: When building a scene, always check both asset catalogs for free models that match the user's theme:
+  - `context/open-source-3d-assets.md` — 991 CC0 models from Polygonal Mind (nature, medieval, cyberpunk, sci-fi, etc.)
+  - `context/asset-packs-catalog.md` — 2,700+ models from the official Decentraland Creator Hub (furniture, structures, decorations, etc.)
+  - Download matching models with `curl -o models/filename.glb "URL"` before referencing them in code.
 
 ## Tools & Commands
 

package/skills/add-3d-models/SKILL.md

@@ -93,16 +93,40 @@ GltfContainer.create(child, { src: 'models/hat.glb' })
 
 ## Free 3D Models
 
-For free CC0-licensed 3D models suitable for Decentraland, read the catalog at:
-`context/open-source-3d-assets.md` (in the opendcl repo root). If unavailable locally, fetch from:
-https://raw.githubusercontent.com/dcl-regenesislabs/opendcl/main/context/open-source-3d-assets.md
+Always check both asset catalogs before suggesting the user create or find their own models.
 
-This catalog contains 991+ models organized by themed collections (Cyberpunk, Medieval, MomusPark, etc.) with direct download URLs.
+### Creator Hub Asset Packs (2,700+ models)
 
-When the user asks for 3D models:
-1. Read the open-source-3d-assets.md file
-2. Suggest models that match their description
-3. Show them how to download and add the model to their scene
+Read `context/asset-packs-catalog.md` for official Decentraland models across 12 themed packs (Cyberpunk, Fantasy, Gallery, Sci-fi, Western, Pirates, etc.) with furniture, structures, decorations, nature, and more.
+
+To use a Creator Hub model:
+```bash
+# Download from catalog
+mkdir -p models
+curl -o models/arcade_machine.glb "https://builder-items.decentraland.org/contents/bafybei..."
+```
+```typescript
+// Reference in code — must be a local file path
+GltfContainer.create(entity, { src: 'models/arcade_machine.glb' })
+```
+
+### Open Source CC0 Models (991 models)
+
+Read `context/open-source-3d-assets.md` for free CC0-licensed models from Polygonal Mind, organized by 18 themed collections (MomusPark, Medieval Fair, Cyberpunk, Sci-fi, etc.) with direct GitHub download URLs.
+
+```bash
+curl -o models/tree.glb "https://raw.githubusercontent.com/ToxSam/cc0-models-Polygonal-Mind/main/projects/momuspark/Tree_01_Art.glb"
+```
+
+### How to suggest models
+
+1. Read both catalog files
+2. Search for models matching the user's description/theme
+3. Suggest specific models with download commands
+4. Download selected models into the scene's `models/` directory
+5. Reference them in code with local paths
+
+> **Important**: `GltfContainer` only works with **local files**. Never use external URLs for the model `src` field. Always download models into `models/` first.
 
 ## Model Best Practices
 

package/skills/add-interactivity/SKILL.md

@@ -79,26 +79,46 @@ GltfContainer.create(entity, {
 
 ## Trigger Areas (Proximity Detection)
 
-Detect when the player enters or exits an area:
+Detect when the player enters, exits, or stays inside an area:
 
 ```typescript
-import { engine, Transform, TriggerArea, TriggerAreaResult } from '@dcl/sdk/ecs'
+import { engine, Transform, TriggerArea } from '@dcl/sdk/ecs'
+import { triggerAreaEventsSystem } from '@dcl/sdk/ecs'
 import { Vector3 } from '@dcl/sdk/math'
 
-const trigger = engine.addEntity()
-Transform.create(trigger, { position: Vector3.create(8, 0, 8) })
+const area = engine.addEntity()
+TriggerArea.setBox(area) // or TriggerArea.setSphere(area)
+Transform.create(area, {
+  position: Vector3.create(8, 0, 8),
+  scale: Vector3.create(4, 4, 4) // Size the area via Transform.scale
+})
 
-TriggerArea.create(trigger, {
-  area: Vector3.create(4, 4, 4) // 4x4x4 meter box
+// Register enter/exit/stay events
+triggerAreaEventsSystem.onTriggerEnter(area, (event) => {
+  console.log('Entity entered trigger:', event.trigger.entity)
 })
 
-// System to check trigger
-engine.addSystem(() => {
-  const result = TriggerAreaResult.getOrNull(trigger)
-  if (result && result.isTriggered) {
-    // Player is inside the trigger area
-  }
+triggerAreaEventsSystem.onTriggerExit(area, () => {
+  console.log('Entity exited trigger')
 })
+
+triggerAreaEventsSystem.onTriggerStay(area, () => {
+  // Called every frame while an entity is inside
+})
+```
+
+By default, trigger areas react to the player layer. Use `ColliderLayer` to restrict which entities activate the area:
+
+```typescript
+import { ColliderLayer, MeshCollider } from '@dcl/sdk/ecs'
+
+// Area that only reacts to custom layers
+TriggerArea.setBox(area, ColliderLayer.CL_CUSTOM1 | ColliderLayer.CL_CUSTOM2)
+
+// Mark a moving entity to activate the area
+const mover = engine.addEntity()
+Transform.create(mover, { position: Vector3.create(8, 0, 8) })
+MeshCollider.setBox(mover, ColliderLayer.CL_CUSTOM1)
 ```
 
 ## Raycasting

package/skills/advanced-rendering/SKILL.md

@@ -137,10 +137,10 @@ Material.setPbrMaterial(entity, {
 ### Emissive (Glow Effects)
 
 ```typescript
-// Glowing material
+// Glowing material (emissiveColor uses Color3, not Color4)
 Material.setPbrMaterial(entity, {
   albedoColor: Color4.create(0, 0, 0, 1),
-  emissiveColor: Color4.create(0, 1, 0, 1),  // Green glow
+  emissiveColor: Color3.create(0, 1, 0),  // Green glow
   emissiveIntensity: 2.0
 })
 
@@ -163,33 +163,24 @@ Material.setPbrMaterial(entity, {
 })
 ```
 
-## GltfNodeModifiers
+## GltfContainer Visibility Masks
 
-Override visibility or materials on specific nodes within a GLTF model:
+Control visibility and collision of specific mesh layers within a GLTF model using collision masks:
 
 ```typescript
-import { engine, Transform, GltfContainer, GltfNodeModifiers, Material } from '@dcl/sdk/ecs'
-import { Vector3, Color4 } from '@dcl/sdk/math'
+import { engine, Transform, GltfContainer, ColliderLayer } from '@dcl/sdk/ecs'
+import { Vector3 } from '@dcl/sdk/math'
 
 const model = engine.addEntity()
-GltfContainer.create(model, { src: 'models/myModel.glb' })
 Transform.create(model, { position: Vector3.create(4, 0, 4) })
 
-// Override material of the entire model (empty path = whole model)
-GltfNodeModifiers.create(model, {
-  modifiers: [
-    {
-      path: '',  // empty string = all nodes
-      materialOverride: Material.setPbrMaterial(model, {
-        albedoColor: Color4.Red()
-      })
-    }
-  ]
+GltfContainer.create(model, {
+  src: 'models/myModel.glb',
+  visibleMeshesCollisionMask: ColliderLayer.CL_PHYSICS | ColliderLayer.CL_POINTER,
+  invisibleMeshesCollisionMask: ColliderLayer.CL_PHYSICS
 })
 ```
 
-Use node paths to target specific parts of a model for visibility or material changes.
-
 ## VisibilityComponent
 
 Show or hide entities without removing them:

package/skills/audio-video/SKILL.md

@@ -122,16 +122,16 @@ VideoPlayer.create(screen, {
   playing: true,
   loop: true,
   volume: 0.5,
-  playbackRate: 1.0
+  playbackRate: 1.0,
+  position: 0  // Start time in seconds
 })
 
-// Set material to show the video texture
-Material.setPbrMaterial(screen, {
-  texture: Material.Texture.Video({ videoPlayerEntity: screen }),
-  roughness: 1,
-  emissiveColor: { r: 1, g: 1, b: 1 },
-  emissiveIntensity: 1,
-  emissiveTexture: Material.Texture.Video({ videoPlayerEntity: screen })
+// Create video texture
+const videoTexture = Material.Texture.Video({ videoPlayerEntity: screen })
+
+// Basic material (recommended — better performance)
+Material.setBasicMaterial(screen, {
+  texture: videoTexture
 })
 ```
 
@@ -150,6 +150,50 @@ VideoPlayer.getMutable(screen).volume = 0.8
 VideoPlayer.getMutable(screen).src = 'https://example.com/other.mp4'
 ```
 
+### Enhanced Video Material (PBR)
+
+For a brighter, emissive video screen:
+
+```typescript
+import { Color3 } from '@dcl/sdk/math'
+
+const videoTexture = Material.Texture.Video({ videoPlayerEntity: screen })
+Material.setPbrMaterial(screen, {
+  texture: videoTexture,
+  roughness: 1.0,
+  specularIntensity: 0,
+  metallic: 0,
+  emissiveTexture: videoTexture,
+  emissiveIntensity: 0.6,
+  emissiveColor: Color3.White()
+})
+```
+
+### Video Events
+
+Monitor video playback state:
+
+```typescript
+import { videoEventsSystem, VideoState } from '@dcl/sdk/ecs'
+
+videoEventsSystem.registerVideoEventsEntity(screen, (videoEvent) => {
+  switch (videoEvent.state) {
+    case VideoState.VS_PLAYING:
+      console.log('Video started playing')
+      break
+    case VideoState.VS_PAUSED:
+      console.log('Video paused')
+      break
+    case VideoState.VS_READY:
+      console.log('Video ready to play')
+      break
+    case VideoState.VS_ERROR:
+      console.log('Video error occurred')
+      break
+  }
+})
+```
+
 ## Spatial Audio
 
 Audio in Decentraland is **spatial by default** — it gets louder as the player approaches the audio source entity and quieter as they move away. The position is determined by the entity's `Transform`.