Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(vscode-3d): make the extension Marketplace-ready with working README links, a leaner vsix, and owner publish steps
nirholas2c78c6fa7c9a
diff --git a/marketing/growth/opportunities.csv b/marketing/growth/opportunities.csvindex 215adab3d..6e5c96859 100644--- a/marketing/growth/opportunities.csv+++ b/marketing/growth/opportunities.csv@@ -20,7 +20,7 @@"P2","15","OpenAI share-your-story","existing-partner","not_started","Submit a founder story after Showcase submission with measurable product outcomes","Owner","2026-10-09","marketing/openai-select-partner/partnership-and-gpt-briefing.md","A human story about making 3D creation accessible through OpenAI products","Submission confirmation or editorial contact","https://openai.com/form/share-your-story/","2026-09-15""P2","15","NVIDIA GTC 2027 startup route","existing-member","pavilion_invite_only_cfp_watching","Keep the member profile and NVIDIA demo current for invite-only Pavilion review; monitor the separate public CFP weekly","Owner","2026-10-01","docs/nvidia-visibility-map.md","A browser digital-human demo for agentic AI and media audiences","Submission ID or pavilion acceptance","https://www.nvidia.com/gtc/","2026-09-15""P2","14","QuickNode startup spotlight","existing-program","not_started","Send a one-page RPC failover field note and request a founder spotlight","Owner","2026-10-09","docs/solana.md","A practical reliability story with a production QuickNode integration","Published QuickNode-domain story or social post","https://www.quicknode.com/startup-program","2026-09-15"-"P0","18","VS Code Marketplace: three.ws 3D","installable-distribution","ready_to_package","Resolve publisher identity; package, test, inspect, and publish","Engineering+Owner","2026-09-25","packages/vscode-3d","A complete 3D workflow inside a Microsoft-owned developer surface","Live Marketplace URL and activated install","https://code.visualstudio.com/api/working-with-extensions/publishing-extension","2026-09-15"+"P0","18","VS Code Marketplace: three.ws 3D","installable-distribution","ready_to_publish","Publisher threews already exists and is verified; packaged vsix (15 files, 694 KB) passes 71 tests and installs into VS Code 1.138. Owner: create a Marketplace Manage PAT, vsce login threews, npm run publish:marketplace, then OVSX_PAT=<token> npm run publish:openvsx (packages/vscode-3d/PUBLISHING.md)","Owner","2026-09-25","packages/vscode-3d","A complete 3D workflow inside a Microsoft-owned developer surface","Live Marketplace URL and activated install","https://code.visualstudio.com/api/working-with-extensions/publishing-extension","2026-09-17""P1","17","Comfy Registry and Manager","installable-distribution","submission_ready","Owner: create Registry publisher `threews` and API key, then run `comfy node publish` from integrations/comfyui/three_ws_nodes (steps in integrations/comfyui/SUBMITTING.md)","Owner","2026-10-02","integrations/comfyui","Working Forge nodes available through the native manager","Live Registry URL and first completed generation","https://docs.comfy.org/registry/publishing","2026-09-17""P1","16","Blender Extensions","installable-distribution","compliance_needed","Honor online-access setting; add manifest; package and submit","Engineering+Owner","2026-10-09","integrations/blender","A working Forge add-on on Blender's own discovery surface","Live Extension URL and first completed generation","https://developer.blender.org/docs/handbook/extensions/addon_guidelines/","2026-09-15""P0","20","three.ws agent starter template and Codespaces","owned-product-loop","live_template_unverified","Live at https://github.com/nirholas/threews-agent-starter as a template; open a fresh Codespace and confirm port 4173 renders the live agent before linking it from campaigns","Owner","2026-09-21","satellites/agent-starter","A first avatar rendered before a newcomer must clone or understand the monorepo","Live template URL plus template uses Codespaces starts and successful first renders","https://docs.github.com/en/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template","2026-09-16"diff --git a/packages/vscode-3d/.vscodeignore b/packages/vscode-3d/.vscodeignoreindex 59078ac7a..810bddd9c 100644--- a/packages/vscode-3d/.vscodeignore+++ b/packages/vscode-3d/.vscodeignore@@ -7,3 +7,6 @@ build.mjs**/*.map**/tsconfig.jsonnode_modules/**+package-lock.json+PUBLISHING.md+*.vsixdiff --git a/packages/vscode-3d/PUBLISHING.md b/packages/vscode-3d/PUBLISHING.mdnew file mode 100644index 000000000..22bd26130--- /dev/null+++ b/packages/vscode-3d/PUBLISHING.md@@ -0,0 +1,154 @@+# Publishing three.ws 3D++How to release `threews.vscode-3d` to the+[Visual Studio Marketplace](https://marketplace.visualstudio.com/vscode) and to+[Open VSX](https://open-vsx.org) (the registry VSCodium, Cursor, Windsurf,+Gitpod and other VS Code forks install from). Official references:+[Publishing Extensions](https://code.visualstudio.com/api/working-with-extensions/publishing-extension)+and the [Open VSX publishing guide](https://github.com/eclipse/openvsx/wiki/Publishing-Extensions).++This file is excluded from the `.vsix` by `.vscodeignore`.++## Where things stand++- **Publisher identity is resolved.** `package.json` declares+ `"publisher": "threews"`. That publisher already exists on the Visual Studio+ Marketplace (display name "three.ws", verified, with another three.ws+ extension live under it), so no new publisher has to be created. The+ `threews` namespace also already exists on Open VSX.+- **The package is ready.** `npm run package` builds a production bundle and+ writes `vscode-3d-0.2.0.vsix`: 15 files, about 694 KB. It has been installed+ into a real VS Code 1.138.0 server build with+ `code-server --install-extension`, and `--list-extensions` reports+ `[email protected]`.+- **What only the owner has:** a Marketplace token for the `threews` publisher+ and an Open VSX token for the `threews` namespace. Neither is stored on this+ machine.++## 0. Preflight (one minute)++```bash+cd packages/vscode-3d+npm ci+npm test # 71 tests, must all pass+npm run package # builds and writes vscode-3d-<version>.vsix+npx --yes @vscode/vsce ls --no-dependencies # the exact file list that ships+```++The list must be `CHANGELOG.md`, `LICENSE`, `README.md`, `package.json`,+`dist/extension.cjs`, `media/icon.png`, `media/cube.svg`, `media/viewer.css`,+`media/viewer.js`, and the four decoder files under `media/vendor/`. Anything+else (sources, tests, source maps, `node_modules`) means `.vscodeignore` has+regressed. Delete the `.vsix` afterwards; it is gitignored and never committed.++Marketplace rules the package already satisfies, worth keeping when editing:+the icon is a 128x128 PNG (SVG icons are rejected), the README uses only+absolute `https` links and no SVG images, `repository`, `bugs`, `homepage`,+`license`, `pricing`, `galleryBanner`, `categories` and `keywords` are set, and+`engines.vscode` matches `@types/vscode`. A version can be published only once:+bump `version` in `package.json` and add a `CHANGELOG.md` section for every+release after 0.2.0.++## 1. Visual Studio Marketplace++### 1a. Get access to the `threews` publisher++1. Sign in at <https://marketplace.visualstudio.com/manage> with the Microsoft+ account that owns the `threews` publisher. If you are a different account,+ the owner adds you under **threews > Members** with the **Contributor** role.+2. Only if the publisher were ever missing: **Create publisher** on the same+ page, ID `threews`, name `three.ws`. The ID must equal the `publisher` field.++### 1b. Create a Personal Access Token++1. Open <https://dev.azure.com>. Any Azure DevOps organization under the same+ Microsoft account works; create one if the account has none.+2. User settings (top right) > **Personal access tokens** > **New Token**.+3. **Organization: All accessible organizations.** A token scoped to one+ organization fails with a 401 at publish time.+4. **Scopes: Custom defined > Show all scopes > Marketplace > Manage.**+5. Pick an expiry, create, and copy the token.++### 1c. Log in and publish++```bash+cd packages/vscode-3d+npx --yes @vscode/vsce login threews # paste the token when prompted+npx --yes @vscode/vsce verify-pat threews # optional sanity check+npm run publish:marketplace+```++`publish:marketplace` runs `vsce publish --no-dependencies`, which runs the+production build (`vscode:prepublish`), packages, and uploads. The bundles+already contain every runtime dependency, so `--no-dependencies` is correct.++Non-interactive alternative: `VSCE_PAT=<token> npm run publish:marketplace`.+If the account signs in through Microsoft Entra ID instead of a token:+`az login`, then `npx --yes @vscode/vsce publish --no-dependencies --azure-credential`.++## 2. Open VSX (free second listing)++1. Sign in at <https://open-vsx.org> with the GitHub account that is a member of+ the `threews` namespace (the account that published the existing three.ws+ extension there). The Eclipse Foundation publisher agreement must be signed+ under **Settings**; it already is if that account published before.+2. **Settings > Access Tokens > Generate New Token**, copy it.+3. Publish:++```bash+cd packages/vscode-3d+OVSX_PAT=<token> npm run publish:openvsx+```++`publish:openvsx` runs `ovsx publish --no-dependencies`, which builds and+packages the same way. To upload the exact file already published to the+Marketplace instead: `npx --yes ovsx publish vscode-3d-0.2.0.vsix -p <token>`.++The namespace is currently unverified on Open VSX, so the listing shows a+warning badge. To remove it, claim the namespace by opening an issue at+<https://github.com/EclipseFdn/open-vsx.org/issues> (template "Claim namespace+ownership"). This is optional and does not block publishing.++## 3. Verify the release++Marketplace listings pass an automated scan first, usually within a few+minutes, before the page and install work.++```bash+# Marketplace: the gallery API returns the published version+curl -s -X POST 'https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery' \+ -H 'Content-Type: application/json' \+ -H 'Accept: application/json;api-version=7.2-preview.1' \+ -d '{"filters":[{"criteria":[{"filterType":7,"value":"threews.vscode-3d"}]}],"flags":1}' \+ | grep -o '"version":"[^"]*"' | head -1++# Open VSX: the registry API returns the published version+curl -s https://open-vsx.org/api/threews/vscode-3d | grep -o '"version":"[^"]*"'++# A real install into a clean profile+code --user-data-dir /tmp/vsc3d-profile --extensions-dir /tmp/vsc3d-ext \+ --install-extension threews.vscode-3d+code --user-data-dir /tmp/vsc3d-profile --extensions-dir /tmp/vsc3d-ext \+ --list-extensions --show-versions+```++Then check by hand:++1. <https://marketplace.visualstudio.com/items?itemName=threews.vscode-3d>+ shows the icon, the dark banner, the README with working links, and the+ changelog tab.+2. <https://open-vsx.org/extension/threews/vscode-3d> shows the same.+3. In VS Code, open any `.glb` (for example a model from+ <https://three.ws>): it renders in the **three.ws 3D Viewer** tab, the+ **three.ws 3D** activity bar icon lists workspace models, and+ **3D: Generate a Model from Text** returns a model.++## 4. After the first publish++- In `docs/vscode.md`, replace the "not on the Marketplace yet" install section+ with the Marketplace and Open VSX install, matching this package's README.+- Add a `data/changelog.json` entry announcing the listing (tags `feature`,+ `sdk`) and run `npm run build:pages` from the repository root.+- Set the "VS Code Marketplace: three.ws 3D" row in+ `marketing/growth/opportunities.csv` to `live`, with the listing URL as+ evidence.diff --git a/packages/vscode-3d/README.md b/packages/vscode-3d/README.mdindex 64f69f9bc..320919246 100644--- a/packages/vscode-3d/README.md+++ b/packages/vscode-3d/README.md@@ -95,22 +95,31 @@ platform's own inspectors, and generation calls the live studio API.## Install-From the workspace root:+Search for **three.ws 3D** in the Extensions view, or install it by ID:```bash-cd packages/vscode-3d-npm install-npm run build+code --install-extension threews.vscode-3d```-Then press <kbd>F5</kbd> in VS Code with `packages/vscode-3d` open to launch an-Extension Development Host, or build a `.vsix` and install it:+It is listed on the+[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=threews.vscode-3d)+and, for VSCodium, Cursor, Windsurf and other Open VSX editors, on+[Open VSX](https://open-vsx.org/extension/threews/vscode-3d).++To build it from source instead:```bash+git clone https://github.com/nirholas/three.ws.git+cd three.ws/packages/vscode-3d+npm installnpm run packagecode --install-extension vscode-3d-0.2.0.vsix```+For development, open `packages/vscode-3d` in VS Code and press <kbd>F5</kbd> to+launch an Extension Development Host. Maintainers: releasing a new version is+covered in [PUBLISHING.md](https://github.com/nirholas/three.ws/blob/main/packages/vscode-3d/PUBLISHING.md).+## Use itOpen any `.glb` or `.gltf` in the explorer. That is the whole setup: the viewer@@ -229,13 +238,13 @@ and real committed GLBs.## Related-- [`docs/vscode.md`](../../docs/vscode.md) walks through the whole workflow.-- [`@three-ws/vscode-x402`](../vscode-x402) is the sibling extension for paying+- [`docs/vscode.md`](https://github.com/nirholas/three.ws/blob/main/docs/vscode.md) walks through the whole workflow.+- [`@three-ws/vscode-x402`](https://github.com/nirholas/three.ws/tree/main/packages/vscode-x402) is the sibling extension for payingx402 endpoints from the editor.-- [`docs/embedding.md`](../../docs/embedding.md) documents every `<agent-3d>`+- [`docs/embedding.md`](https://github.com/nirholas/three.ws/blob/main/docs/embedding.md) documents every `<agent-3d>`attribute the diagnostics and completions know.-- [`@three-ws/glb-diff`](../glb-diff) is the structural differ behind the+- [`@three-ws/glb-diff`](https://github.com/nirholas/three.ws/tree/main/packages/glb-diff) is the structural differ behind thecompare command, also available as a CLI for CI.-- [`@three-ws/glb-tools`](../glb-tools) does inspection and baking from the shell.+- [`@three-ws/glb-tools`](https://github.com/nirholas/three.ws/tree/main/packages/glb-tools) does inspection and baking from the shell.Apache-2.0. Built by [three.ws](https://three.ws).diff --git a/packages/vscode-3d/build.mjs b/packages/vscode-3d/build.mjsindex 9a87cab4e..def16afd6 100644--- a/packages/vscode-3d/build.mjs+++ b/packages/vscode-3d/build.mjs@@ -21,9 +21,10 @@ const watch = process.argv.includes('--watch');const threeLibs = dirname(dirname(require.resolve('three/examples/jsm/libs/basis/basis_transcoder.js')));// Only what the loaders fetch at runtime: the Draco encoder alone is a megabyte-// of dead weight in the .vsix.+// of dead weight in the .vsix. DRACOLoader takes the pure-JS decoder+// (draco_decoder.js) only when WebAssembly is missing, and every VS Code webview+// has it (the CSP grants 'wasm-unsafe-eval'), so only the wasm pair ships.const DECODERS = [- ['draco/gltf/draco_decoder.js', 'draco/draco_decoder.js'],['draco/gltf/draco_decoder.wasm', 'draco/draco_decoder.wasm'],['draco/gltf/draco_wasm_wrapper.js', 'draco/draco_wasm_wrapper.js'],['basis/basis_transcoder.js', 'basis/basis_transcoder.js'],diff --git a/packages/vscode-3d/package.json b/packages/vscode-3d/package.jsonindex 8b6ca72fa..ea28568e9 100644--- a/packages/vscode-3d/package.json+++ b/packages/vscode-3d/package.json@@ -5,6 +5,7 @@"version": "0.2.0","publisher": "threews","license": "Apache-2.0",+ "pricing": "Free","homepage": "https://three.ws","repository": {"type": "git",@@ -386,6 +387,8 @@"watch": "node build.mjs --watch","test": "node build.mjs && node --test \"test/*.test.mjs\"","package": "npx --yes @vscode/vsce package --no-dependencies",+ "publish:marketplace": "npx --yes @vscode/vsce publish --no-dependencies",+ "publish:openvsx": "npx --yes ovsx publish --no-dependencies","vscode:prepublish": "node build.mjs --production"},"dependencies": {