@dcl-regenesislabs/opendcl 0.2.1-26502482653.commit-5089b10 → 0.2.1

package/README.md

@@ -26,7 +26,7 @@ The result: **more creators building more scenes, faster.**
 ## Features
 
 - **Branded header** — on startup, displays a block-character "Decentraland" ASCII art banner with version and working directory. Falls back to a compact text header on narrow terminals
-- **Multi-provider LLM support** — works with Claude, OpenAI, Google, OpenRouter, and more
+- **Multi-provider LLM support** — works with Claude, OpenAI, Google, Ollama (free/local), OpenRouter, and more
 - **Scene-aware** — automatically detects your project's `scene.json`, SDK version, and entry points
 - **20 built-in skills** — scaffolding, 3D models, interactivity, UI, animations, multiplayer, authoritative server, audio/video, deployment (Genesis City & Worlds), optimization, camera control, lighting, player/avatar, NFT/blockchain, advanced rendering, advanced input, scene runtime, visual feedback, game design
 - **Integrated commands** — `/init` to scaffold, `/preview` to launch the dev server, `/tasks` to manage running processes, `/review` to audit code
@@ -99,7 +99,6 @@ This uses the open [skills](https://github.com/vercel-labs/skills) CLI to copy S
 | `/deploy` | Deploy the scene to Genesis City or a World (auto-detects from scene.json) |
 | `/tasks` | Interactively manage running background processes (preview server, etc.) |
 | `/review` | Review scene code for quality, performance, and SDK7 best practices |
-| `/save-editor` | Apply pending visual editor changes to scene source code |
 | `/explain <concept>` | Explain a Decentraland SDK7 concept (e.g., `/explain tweens`) |
 
 The agent also has a `screenshot` tool it can call automatically to see the running preview. On first use it asks for your permission to open a headless browser. The browser stays open for the entire session — no repeated logins.
@@ -130,7 +129,6 @@ OpenDCL loads domain-specific skills on demand based on what you're asking:
 | `scene-runtime` | Async tasks, fetch, timers, realm info, restricted actions, testing |
 | `visual-feedback` | Use the screenshot tool to see your scene, verify changes, iterate visually |
 | `game-design` | Plan game architecture, scene limits, state management, MVP planning |
-| `editor-gizmo` | Use a visual in-scene editor with translate/rotate gizmos |
 
 ## How It Works
 
@@ -152,7 +150,7 @@ opendcl/
 │   └── scene-context.ts      # Scene detection & context formatting
 ├── extensions/
 │   ├── dcl-context.ts        # Auto-detect scene, inject metadata
-│   ├── dcl-init.ts           # /init command + editor setup
+│   ├── dcl-init.ts           # /init command
 │   ├── dcl-preview.ts        # /preview command
 │   ├── dcl-deploy.ts         # /deploy command
 │   ├── dcl-setup.ts          # /setup command (cloud API provider config)
@@ -161,7 +159,6 @@ opendcl/
 │   ├── dcl-validate.ts       # Post-write TypeScript validation
 │   ├── dcl-screenshot.ts      # screenshot tool (headless Chrome, persistent browser)
 │   ├── dcl-tasks.ts          # /tasks command (process manager)
-│   ├── dcl-editor-save.ts    # /save-editor command (apply visual editor changes)
 │   ├── process-registry.ts   # Shared background process registry
 │   └── permissions/           # Permission gate for dangerous operations
 ├── skills/                   # 20 SKILL.md files (domain expertise)
@@ -234,6 +231,7 @@ OpenDCL supports any provider compatible with pi-coding-agent:
 | Anthropic (Claude) | `ANTHROPIC_API_KEY` | Best quality |
 | OpenAI | `OPENAI_API_KEY` | GPT-4o, o1, etc. |
 | Google | `GOOGLE_API_KEY` | Gemini models |
+| Ollama | — | Free, runs locally |
 | OpenRouter | `OPENROUTER_API_KEY` | Access to many models |
 
 Set the environment variable or enter the key on first run. Switch models anytime with `Ctrl+P`.

package/context/sdk7-cheat-sheet.md

@@ -34,10 +34,6 @@ removeEntityWithChildren(engine, entity)
 
 // Components — CRUD
 Transform.create(entity, { position: Vector3.create(8, 1, 8) })
-// ⚠️ NEVER pass undefined values in Transform fields — the SDK serializer crashes
-// reading .x on undefined. If a field is optional, omit the key entirely:
-//   BAD:  Transform.create(e, { position, rotation })  // rotation may be undefined
-//   GOOD: Transform.create(e, rotation ? { position, rotation } : { position })
 const t = Transform.get(entity)           // read-only, throws if missing
 const t = Transform.getMutable(entity)     // mutable reference
 const t = Transform.getOrNull(entity)      // read-only, returns null if missing

package/dist/index.js

@@ -67,6 +67,10 @@ const extensions = headless
         "dcl-asset-path.ts",
         "dcl-screenshot.ts",
     ];
+// Conditionally load dcl-setup-ollama (hidden by default, enable with ENABLE_OLLAMA_SETUP=true)
+if (!headless && process.env.ENABLE_OLLAMA_SETUP === "true") {
+    extensions.push("dcl-setup-ollama.ts");
+}
 for (const ext of extensions) {
     args.push("-e", join(extDir, ext));
 }
@@ -86,6 +90,14 @@ if (!isDev()) {
 }
 // InteractiveMode patches — only needed for terminal UI, skip in headless mode
 if (!headless) {
+    // Suppress pi's generic "No models available" warning — our dcl-setup-ollama
+    // extension shows a more helpful message that mentions /setup-ollama.
+    const _showWarning = InteractiveMode.prototype.showWarning;
+    InteractiveMode.prototype.showWarning = function (msg) {
+        if (msg.startsWith("No models available"))
+            return;
+        _showWarning.call(this, msg);
+    };
     // Suppress pi's "What's New" changelog notification on startup — it shows pi's
     // own version/changes, which confuses OpenDCL users.
     InteractiveMode.prototype.getChangelogForDisplay = function () {

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

@@ -3,40 +3,24 @@
  *
  * Registers the `init` tool (LLM-callable) and `/init` command that scaffolds
  * a new Decentraland scene project using `npx @dcl/sdk-commands init`.
- * After scaffolding, triggers the editor-gizmo skill to set up the visual editor.
- * On session start, prompts the user to enable the editor if a scene exists but lacks it.
  */
 
 import type { ExtensionFactory } from "@mariozechner/pi-coding-agent";
 import { Type } from "@sinclair/typebox";
 import { join } from "node:path";
 import { readFile, writeFile } from "node:fs/promises";
-import { fileExists, findSceneRoot } from "./scene-utils.js";
-
-function triggerEditorSkill(pi: { sendMessage(msg: unknown, opts?: unknown): void }) {
-  pi.sendMessage(
-    {
-      customType: "editor-setup",
-      content: "Scene initialized (dependencies not yet installed). Now set up the visual editor by following the editor-gizmo skill.",
-      display: true,
-    },
-    { triggerTurn: true }
-  );
-}
+import { fileExists } from "./scene-utils.js";
 
 async function initScene(
   cwd: string,
-  pi: {
-    exec(cmd: string, args: string[], opts?: unknown): Promise<{ code: number; stdout: string; stderr: string }>;
-    sendMessage(msg: unknown, opts?: unknown): void;
-  }
+  pi: { exec(cmd: string, args: string[], opts?: unknown): Promise<{ code: number; stdout: string; stderr: string }> }
 ): Promise<{ message: string; isError?: boolean }> {
   if (await fileExists(join(cwd, "scene.json"))) {
     return { message: "A scene.json already exists in this directory. Aborting to prevent overwriting.", isError: true };
   }
 
   try {
-    const result = await pi.exec("npx", ["@dcl/sdk-commands", "init", "--yes", "--skip-install"], {
+    const result = await pi.exec("npx", ["@dcl/sdk-commands", "init", "--yes"], {
       cwd,
       timeout: 180000,
     });
@@ -52,23 +36,7 @@ async function initScene(
       } catch {
         // Non-fatal: scene was still initialized successfully
       }
-
-      // Append OpenDCL build artifacts to .gitignore so they don't get committed.
-      // main.crdt is generated from main-entities.ts at bundle time.
-      try {
-        const ignorePath = join(cwd, ".gitignore");
-        let existing = "";
-        try { existing = await readFile(ignorePath, "utf-8"); } catch {}
-        if (!existing.split(/\r?\n/).includes("main.crdt")) {
-          const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
-          await writeFile(ignorePath, existing + sep + "main.crdt\n");
-        }
-      } catch {
-        // Non-fatal: scene still works without .gitignore updates
-      }
-
-      triggerEditorSkill(pi);
-      return { message: "Scene initialized! Setting up visual editor..." };
+      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 };
     }
@@ -82,7 +50,7 @@ const extension: ExtensionFactory = (pi) => {
     name: "init",
     label: "Init Scene",
     description:
-      "Initialize a new Decentraland SDK7 scene with visual editor. Scaffolds scene.json, package.json, tsconfig.json, src/index.ts, and the __editor/ directory. Use when user wants to create or start a new scene.",
+      "Initialize a new Decentraland SDK7 scene. Scaffolds scene.json, package.json, tsconfig.json, and src/index.ts. Use when user wants to create or start a new scene.",
     parameters: Type.Object({}),
     async execute(_id, _params, _signal, _onUpdate, ctx) {
       const result = await initScene(ctx.cwd, pi);
@@ -92,7 +60,7 @@ const extension: ExtensionFactory = (pi) => {
   });
 
   pi.registerCommand("init", {
-    description: "Initialize a new Decentraland scene project with visual editor",
+    description: "Initialize a new Decentraland scene project in the current directory",
     handler: async (_args, ctx) => {
       ctx.ui.notify("Initializing new Decentraland scene...", "info");
       const result = await initScene(ctx.cwd, pi);
@@ -100,26 +68,6 @@ const extension: ExtensionFactory = (pi) => {
       if (!result.isError) await ctx.reload();
     },
   });
-
-  // Prompt on session start if scene exists but editor is not installed
-  let editorPromptShown = false;
-  pi.on("before_agent_start", async (_event, ctx) => {
-    if (editorPromptShown) return;
-    editorPromptShown = true;
-
-    const sceneRoot = await findSceneRoot(ctx.cwd);
-    if (!sceneRoot) return;
-
-    if (await fileExists(join(sceneRoot, "src", "__editor", "state.ts"))) return;
-
-    const enable = await ctx.ui.confirm(
-      "Visual Editor",
-      "Enable the visual editor for this scene?"
-    );
-    if (!enable) return;
-
-    triggerEditorSkill(pi);
-  });
 };
 
 export default extension;

package/extensions/dcl-setup-ollama.ts

@@ -0,0 +1,312 @@
+/**
+ * DCL Setup Ollama Extension
+ *
+ * Registers the /setup-ollama command that walks users through
+ * model selection and configuration for a free local LLM setup.
+ * On session start, nudges users who have no provider configured.
+ */
+
+import type { ExtensionFactory } from "@mariozechner/pi-coding-agent";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
+
+interface OllamaProvider {
+  baseUrl?: string;
+  api?: string;
+  apiKey?: string;
+  models?: { id: string }[];
+}
+
+const API_KEY_ENV_VARS = [
+  "ANTHROPIC_API_KEY",
+  "OPENAI_API_KEY",
+  "GOOGLE_API_KEY",
+  "OPENROUTER_API_KEY",
+];
+
+export const OLLAMA_MODELS = [
+  { id: "qwen2.5-coder:32b", label: "qwen2.5-coder:32b (Recommended — best coding benchmarks, ~18GB)" },
+  { id: "qwen3-coder:30b", label: "qwen3-coder:30b (Latest Alibaba coder, 256K context, ~19GB)" },
+  { id: "devstral:24b", label: "devstral:24b (Mistral coding agent model, ~14GB)" },
+  { id: "glm-4.7-flash", label: "glm-4.7-flash (Reasoning + code generation, ~25GB)" },
+];
+
+async function readJsonFile<T>(path: string, fallback: T): Promise<T> {
+  try {
+    const content = await readFile(path, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return fallback;
+  }
+}
+
+async function writeJsonFile(path: string, data: unknown): Promise<void> {
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+
+export async function writeModelsConfig(modelsPath: string, modelId: string): Promise<void> {
+  const config = await readJsonFile<{ providers?: Record<string, unknown> }>(modelsPath, {});
+  config.providers ??= {};
+
+  const ollama = config.providers.ollama as OllamaProvider | undefined;
+  if (ollama) {
+    ollama.models ??= [];
+    if (!ollama.models.some((m) => m.id === modelId)) {
+      ollama.models.push({ id: modelId });
+    }
+  } else {
+    config.providers.ollama = {
+      baseUrl: "http://localhost:11434/v1",
+      api: "openai-completions",
+      apiKey: "ollama",
+      models: [{ id: modelId }],
+    };
+  }
+
+  await writeJsonFile(modelsPath, config);
+}
+
+export async function setDefaultModel(settingsPath: string, provider: string, modelId: string): Promise<void> {
+  const settings = await readJsonFile<Record<string, unknown>>(settingsPath, {});
+
+  settings.defaultProvider = provider;
+  settings.defaultModel = modelId;
+
+  await writeJsonFile(settingsPath, settings);
+}
+
+export async function isProviderConfigured(): Promise<boolean> {
+  if (API_KEY_ENV_VARS.some((v) => process.env[v])) {
+    return true;
+  }
+
+  const configDir = join(homedir(), ".opendcl", "agent");
+
+  const modelsConfig = await readJsonFile<{ providers?: Record<string, unknown> }>(join(configDir, "models.json"), {});
+  if (modelsConfig.providers != null && Object.keys(modelsConfig.providers).length > 0) {
+    return true;
+  }
+
+  const authConfig = await readJsonFile<Record<string, unknown>>(join(configDir, "auth.json"), {});
+  return Object.keys(authConfig).length > 0;
+}
+
+export function parseOllamaList(output: string): string[] {
+  const lines = output.split(/\r?\n/).filter((l) => l.trim());
+  // Skip header line (starts with "NAME")
+  const dataLines = lines.filter((l) => !l.startsWith("NAME"));
+  return dataLines
+    .map((l) => l.split(/\s+/)[0])
+    .filter(Boolean)
+    .map((name) => name.replace(/:latest$/, ""));
+}
+
+export async function removeOllamaModel(
+  modelsPath: string,
+  settingsPath: string,
+  modelId: string,
+): Promise<void> {
+  const config = await readJsonFile<{ providers?: Record<string, unknown> }>(modelsPath, {});
+  const ollama = config.providers?.ollama as OllamaProvider | undefined;
+  if (ollama?.models) {
+    ollama.models = ollama.models.filter((m) => m.id !== modelId);
+    if (ollama.models.length === 0) {
+      delete config.providers!.ollama;
+    }
+    await writeJsonFile(modelsPath, config);
+  }
+
+  const settings = await readJsonFile<Record<string, unknown>>(settingsPath, {});
+  if (settings.defaultProvider === "ollama" && settings.defaultModel === modelId) {
+    delete settings.defaultProvider;
+    delete settings.defaultModel;
+    await writeJsonFile(settingsPath, settings);
+  }
+}
+
+/**
+ * Run ollama commands through the user's login shell so the full PATH is used.
+ * (pi.exec without shell won't find binaries added by installers to profile files.)
+ */
+function ollamaExec(pi: Parameters<ExtensionFactory>[0], args: string, timeout = 10000) {
+  const shell = process.env.SHELL || "/bin/sh";
+  return pi.exec(shell, ["-lc", `ollama ${args}`], { timeout }).catch(() => null);
+}
+
+function stripAnsi(text: string): string {
+  return text.replace(/\x1b\[[\x30-\x3f]*[\x20-\x2f]*[\x40-\x7e]/g, "");
+}
+
+/**
+ * Extract a clean, human-readable progress line from raw ollama pull output.
+ * Ollama outputs ANSI-heavy terminal UI — this strips escape codes and
+ * picks the most informative line (percentage progress > phase labels).
+ */
+export function extractPullProgress(raw: string): string | null {
+  const clean = stripAnsi(raw);
+  const lines = clean.split(/\r\n|\r|\n/).map((l) => l.trim()).filter(Boolean);
+  // Prefer the line with download percentage (e.g. "pulling abc123:  45%  8 GB/18 GB  12 MB/s")
+  const progress = lines.findLast((l) => /\d+%/.test(l));
+  if (progress) return progress;
+  // Fall back to phase lines like "pulling manifest", "verifying sha256 digest"
+  const phase = lines.findLast((l) => /^(pulling|verifying|writing|success)/.test(l));
+  return phase ?? null;
+}
+
+/**
+ * Pull a model with streaming progress via spawn.
+ * Throttles notifications to avoid UI spam (one update every 2 seconds max).
+ */
+export function ollamaPull(
+  modelId: string,
+  onProgress: (line: string) => void,
+): Promise<{ success: boolean; error?: string }> {
+  return new Promise((resolve) => {
+    const shell = process.env.SHELL || "/bin/sh";
+    const child = spawn(shell, ["-lc", `ollama pull ${modelId}`], {
+      stdio: "pipe",
+    });
+
+    let lastNotify = 0;
+    let lastLine = "";
+    let errorOutput = "";
+
+    function handleData(data: Buffer): void {
+      const text = data.toString();
+      errorOutput += text;
+      const line = extractPullProgress(text);
+      if (!line) return;
+      lastLine = line;
+      const now = Date.now();
+      if (now - lastNotify >= 2000) {
+        lastNotify = now;
+        onProgress(line);
+      }
+    }
+
+    child.stdout?.on("data", handleData);
+    child.stderr?.on("data", handleData);
+
+    child.on("error", (err) => {
+      resolve({ success: false, error: err.message });
+    });
+
+    child.on("exit", (code) => {
+      if (lastLine) onProgress(lastLine);
+      if (code === 0) {
+        resolve({ success: true });
+      } else {
+        resolve({ success: false, error: stripAnsi(errorOutput).slice(-500) });
+      }
+    });
+  });
+}
+
+const extension: ExtensionFactory = (pi) => {
+  pi.on("session_start", async (_event, ctx) => {
+    if (!(await isProviderConfigured())) {
+      ctx.ui.notify(
+        "Get started by running /setup to configure a cloud provider",
+        "warning",
+      );
+      return;
+    }
+
+    const configDir = join(homedir(), ".opendcl", "agent");
+    const settingsPath = join(configDir, "settings.json");
+    const settings = await readJsonFile<Record<string, unknown>>(settingsPath, {});
+    if (settings.defaultProvider !== "ollama") return;
+
+    const defaultModel = settings.defaultModel as string | undefined;
+    if (!defaultModel) return;
+
+    const listResult = await ollamaExec(pi, "list");
+    if (!listResult || listResult.code !== 0) return;
+
+    const installed = parseOllamaList(listResult.stdout || "");
+    if (installed.includes(defaultModel)) return;
+
+    const modelsPath = join(configDir, "models.json");
+    await removeOllamaModel(modelsPath, settingsPath, defaultModel);
+    ctx.ui.notify(
+      `Model '${defaultModel}' is no longer installed in Ollama. Run /setup-ollama to configure a new model.`,
+      "warning",
+    );
+  });
+
+  pi.registerCommand("setup-ollama", {
+    description: "Configure Ollama as your free local LLM provider",
+    handler: async (_args, ctx) => {
+      const configDir = join(homedir(), ".opendcl", "agent");
+
+      const versionResult = await ollamaExec(pi, "--version");
+      if (!versionResult || versionResult.code !== 0) {
+        ctx.ui.notify("Ollama is not installed. Download it from https://ollama.com then run /setup-ollama again.", "warning");
+        return;
+      }
+
+      const listResult = await ollamaExec(pi, "list");
+      if (!listResult || listResult.code !== 0) {
+        ctx.ui.notify("Ollama is installed but not running. Start it with 'ollama serve', then run /setup-ollama again.", "warning");
+        return;
+      }
+
+      const installed = parseOllamaList(listResult.stdout || "");
+      const theme = ctx.ui.theme;
+      const sorted = [...OLLAMA_MODELS].sort((a, b) => {
+        const aInstalled = installed.includes(a.id) ? 0 : 1;
+        const bInstalled = installed.includes(b.id) ? 0 : 1;
+        return aInstalled - bInstalled;
+      });
+      const labels = sorted.map((m) =>
+        installed.includes(m.id)
+          ? `${m.label} ${theme.fg("success", "● ready")}`
+          : `${m.label} ${theme.fg("dim", "○ needs download")}`,
+      );
+
+      const selected = await ctx.ui.select("Which model do you want to use?", labels);
+      if (!selected) {
+        ctx.ui.notify("Setup cancelled.", "info");
+        return;
+      }
+
+      const model = sorted.find((m) => selected.startsWith(m.label));
+      if (!model) {
+        ctx.ui.notify("Invalid selection.", "error");
+        return;
+      }
+
+      const alreadyInstalled = installed.includes(model.id);
+      if (!alreadyInstalled) {
+        ctx.ui.setStatus("pull", `Pulling ${model.id}...`);
+        const pullResult = await ollamaPull(model.id, (line) => {
+          ctx.ui.setStatus("pull", line);
+        });
+        ctx.ui.setStatus("pull", undefined);
+        if (!pullResult.success) {
+          ctx.ui.notify(`Failed to pull model: ${pullResult.error || "unknown error"}`, "error");
+          return;
+        }
+      }
+      ctx.ui.notify("Model ready.", "info");
+
+      const modelsPath = join(configDir, "models.json");
+      await writeModelsConfig(modelsPath, model.id);
+
+      const settingsPath = join(configDir, "settings.json");
+      await setDefaultModel(settingsPath, "ollama", model.id);
+
+      ctx.ui.notify(
+        `Ollama configured: ${model.id}. Reloading...`,
+        "info",
+      );
+      await ctx.reload();
+      return;
+    },
+  });
+};
+
+export default extension;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl-regenesislabs/opendcl",
-  "version": "0.2.1-26502482653.commit-5089b10",
+  "version": "0.2.1",
   "description": "AI coding assistant for Decentraland SDK7 scene development",
   "type": "module",
   "bin": {
@@ -48,7 +48,8 @@
     "url": "git+https://github.com/dcl-regenesislabs/opendcl.git"
   },
   "dependencies": {
-    "@mariozechner/pi-coding-agent": "^0.62.0",
+    "@mariozechner/pi-coding-agent": "^0.73.1",
+    "@sinclair/typebox": "0.34.48",
     "playwright-core": "^1.58.2"
   },
   "devDependencies": {
@@ -71,5 +72,5 @@
     "prompts/",
     "context/"
   ],
-  "commit": "5089b101116c01ab32e68795fd6c020d0d509efe"
+  "commit": "96d9b973a1059d26e9b7b972add8b62f4ea08dd3"
 }