@instruktlabs/kiln 1.0.0 → 1.1.0

package/lib/mcp-manifest.js

@@ -0,0 +1,65 @@
+import { localAssetLibrary } from "./assets-node.js";
+import { createLocalToolContext } from "./local-runtime.js";
+import { KILN_RESOURCE_TEMPLATES, KILN_WIDGET_RESOURCE, } from "./mcp-core.js";
+import { createKilnProgramToolRegistry, } from "./tools/registry.js";
+const JSON_SCHEMA_TARGET = 'draft-2020-12';
+function standardJsonSchema(schema, io) {
+    const carrier = schema;
+    const converter = carrier['~standard'].jsonSchema;
+    if (!converter)
+        throw new Error('The registry schema does not implement Standard JSON Schema (zod >= 4.2).');
+    const { $schema: _dialect, ...rest } = converter[io]({ target: JSON_SCHEMA_TARGET });
+    return rest;
+}
+/** The input schema as advertised: an object root first, the rest as converted. */
+export function toolInputJsonSchema(def) {
+    const converted = standardJsonSchema(def.inputSchema, 'input');
+    if (converted['type'] !== undefined && converted['type'] !== 'object')
+        throw new Error(`${def.name}: a tool input schema must describe an object.`);
+    return { type: 'object', ...converted };
+}
+/** One registry definition as one `tools/list` entry, keys in the order the wire has always carried them. */
+export function toolManifestEntry(def) {
+    return {
+        name: def.name,
+        description: def.description,
+        inputSchema: toolInputJsonSchema(def),
+        ...(def.annotations ? { annotations: def.annotations } : {}),
+        ...(def.ui
+            ? {
+                _meta: {
+                    ui: { resourceUri: def.ui.resourceUri, visibility: ['model'] },
+                    'openai/outputTemplate': def.ui.resourceUri,
+                    'ui/resourceUri': def.ui.resourceUri,
+                },
+            }
+            : {}),
+        ...(def.outputSchema
+            ? { outputSchema: { type: 'object', ...standardJsonSchema(def.outputSchema, 'output') } }
+            : {}),
+    };
+}
+/** Which templates a context can serve: asset files need a library, project packages a bundle reader. */
+export function resourceTemplatesFor(context) {
+    return [
+        ...(context.assetLibrary ? [KILN_RESOURCE_TEMPLATES.assetFile] : []),
+        ...(context.projectBundleReader ? [KILN_RESOURCE_TEMPLATES.projectPackage] : []),
+    ];
+}
+export function buildMcpManifest(defs, context) {
+    return {
+        kind: 'kiln.mcp-manifest.v1',
+        tools: defs.map(toolManifestEntry),
+        resources: [KILN_WIDGET_RESOURCE],
+        resourceTemplates: resourceTemplatesFor(context),
+    };
+}
+/**
+ * The manifest the packaged server advertises: the full surface with both
+ * templates, built from a context shaped like the packaged host's but with no
+ * environment of its own, so the file is the same on every machine.
+ */
+export function packagedMcpManifest() {
+    const context = createLocalToolContext({ assetLibrary: localAssetLibrary() }, {});
+    return buildMcpManifest(createKilnProgramToolRegistry(context), context);
+}

package/lib/mcp.d.ts

@@ -0,0 +1,5 @@
+/** Node embedding API. The stdio executable retains its separate lazy entry. */
+export { createKilnMcpServer, createKilnToolHost, kilnMcpToolDefs } from "./mcp-engine.js";
+export type { KilnMcpCompatibilityOptions, KilnToolResult } from "./mcp-engine.js";
+export type { KilnMcpHost, KilnContentBlock, KilnResourceContents } from "./mcp-core.js";
+export type { KilnToolContext, KilnToolDef } from "./tools/registry.js";

package/lib/mcp.js

@@ -0,0 +1,2 @@
+/** Node embedding API. The stdio executable retains its separate lazy entry. */
+export { createKilnMcpServer, createKilnToolHost, kilnMcpToolDefs } from "./mcp-engine.js";

package/lib/render-service-host.js

@@ -224,7 +224,7 @@ export async function startLocalRenderService(dir = renderServiceDir(), environm
             // that listener a bounded health warmup, and join only after full verification.
             // A failed spawn has no such race; absent/unknown never count as success.
             if (spawnError || (exitedAt !== undefined && Date.now() - exitedAt >= 1500))
-                throw new Error(`render service exited during startup${spawnError ? `: ${spawnError.message}` : ''}${stderr.trim() ? `: ${stderr.trim().split('\n').slice(-3).join(' ')}` : windowsLaunch ? '; launch the renderer manually to inspect native-driver errors' : ''}`);
+                throw new Error(`render service exited during startup${spawnError ? `: ${spawnError.message}` : ''}${stderr.trim() ? `: ${stderr.trim()}` : windowsLaunch ? '; launch the renderer manually to inspect native-driver errors' : ''}`);
             await new Promise((done) => setTimeout(done, 250));
         }
         throw new Error(`render service health is unknown after ${budget}ms; inspect with \`kiln service reprobe\``);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruktlabs/kiln",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Create and refine procedural 3D assets with JavaScript, image feedback, and reusable source revisions.",
   "license": "MIT",
   "author": "Matthew Kissinger",
@@ -83,6 +83,14 @@
       "types": "./lib/tools/registry.d.ts",
       "import": "./lib/tools/registry.js"
     },
+    "./tools/input": {
+      "types": "./lib/tools/actions.d.ts",
+      "import": "./lib/tools/actions.js"
+    },
+    "./mcp": {
+      "types": "./lib/mcp.d.ts",
+      "import": "./lib/mcp.js"
+    },
     "./arena": {
       "types": "./lib/arena/index.d.ts",
       "import": "./lib/arena/index.js"
@@ -115,6 +123,10 @@
       "types": "./lib/views/index.d.ts",
       "import": "./lib/views/index.js"
     },
+    "./views/port": {
+      "types": "./lib/views/port.d.ts",
+      "import": "./lib/views/port.js"
+    },
     "./validation": {
       "types": "./lib/validation.d.ts",
       "import": "./lib/validation.js"
@@ -207,6 +219,10 @@
       "types": "./lib/discovery/index.d.ts",
       "import": "./lib/discovery/index.js"
     },
+    "./discovery/portable": {
+      "types": "./lib/discovery/portable.d.ts",
+      "import": "./lib/discovery/portable.js"
+    },
     "./metrics": {
       "types": "./lib/metrics.d.ts",
       "import": "./lib/metrics.js"
@@ -253,6 +269,9 @@
     "plugins/kiln-engine/",
     ".mcp.json",
     "scripts/create-workspace.mjs",
+    "scripts/workspace-config.mjs",
+    "scripts/workspace-project.mjs",
+    "scripts/workspace-transaction.mjs",
     "scripts/package-plugin.mjs",
     "render-service/src/",
     "render-service/package.json",
@@ -327,10 +346,12 @@
     "acorn": "^8.18.0",
     "acorn-walk": "^8.3.5",
     "gltf-validator": "2.0.0-dev.3.10",
+    "jsonc-parser": "3.3.1",
     "manifold-3d": "^3.5.4",
     "minisearch": "7.2.0",
     "pngjs": "7.0.0",
     "sharp": "^0.35.5",
+    "smol-toml": "1.9.0",
     "three": "0.186.1",
     "three-subdivide": "1.1.5",
     "xatlasjs": "^0.2.0",

package/plugin.json

@@ -2,7 +2,7 @@
   "name": "kiln",
   "displayName": "Kiln",
   "description": "Build and revise 3D assets with your coding agent. Write JavaScript, inspect selected views, edit saved source revisions, and export GLB files locally.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "license": "MIT",
   "homepage": "https://github.com/instruktlabs/kiln",
   "keywords": [

package/plugins/kiln-engine/.claude-plugin/plugin.json

@@ -1,9 +1,10 @@
 {
   "name": "kiln-engine",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Set up a local Kiln workspace to create, inspect and revise editable 3D assets with Claude Code or Codex.",
   "author": {
-    "name": "Instrukt Labs"
+    "name": "Instrukt Labs",
+    "email": "support@instruktlabs.com"
   },
   "homepage": "https://github.com/instruktlabs/kiln",
   "repository": "https://github.com/instruktlabs/kiln",
@@ -14,5 +15,10 @@
     "gltf",
     "asset-generation",
     "gamedev"
-  ]
+  ],
+  "icon": "./.claude-plugin/icon.png",
+  "documentationUrl": "https://github.com/instruktlabs/kiln/tree/main/plugins/kiln-engine",
+  "supportUrl": "https://github.com/instruktlabs/kiln/blob/main/plugins/kiln-engine/README.md#support-and-security",
+  "privacyPolicyUrl": "https://github.com/instruktlabs/kiln/blob/main/docs/local-plugin-privacy.md",
+  "termsOfServiceUrl": "https://github.com/instruktlabs/kiln/blob/main/LICENSE"
 }

package/plugins/kiln-engine/PRIVACY.md

@@ -0,0 +1,100 @@
+# Kiln local plugin privacy
+
+Draft for owner review before directory submission. Updated 7 October 2026.
+
+This notice covers the `kiln-engine` local plugin maintained by Instrukt Labs and
+the local workspace it sets up. It does not cover the separate hosted Kiln service
+or your coding assistant's account and conversation history. The local plugin does
+not require a Kiln account, an email address, payment details or a model API key.
+
+## What stays on your computer
+
+Setup reads its public package/version pin, locates Node and npm, and checks the
+workspace and runtime directories you select. It installs the engine in a persistent
+data directory outside the plugin cache. Paths can contain your device account
+name; paths, package identity and file hashes appear in local configuration,
+installation records and command results returned to your assistant.
+
+When adding Kiln to an existing project, setup reads the selected client's
+configuration and records ownership of Kiln's own entries. It preserves unrelated
+settings and existing project instructions. A recoverable setup transaction
+temporarily copies the affected files into private local recovery storage outside
+the project. Those copies can contain credentials already present in the client's
+configuration. They are not uploaded, printed or added to the workspace manifest.
+This storage uses filesystem permissions; Kiln does not encrypt these snapshots.
+
+Your workspace and configured asset libraries hold authored JavaScript, material
+files, asset names, metadata, previews and GLBs. Local tools read and write the
+work you ask them to handle and return requested source, images and results to
+your coding assistant. Avoid putting personal or confidential information in a
+source file, asset name or tool argument unless you intend your assistant to see it.
+
+The local plugin does not send these assets to an Instrukt Labs service or add
+analytics reporting. Your assistant can send prompts and tool results to its own
+provider. That processing, and any assistant history or backups, follows the
+assistant's settings and privacy policy. Kiln does not control those copies.
+
+## Network access and other services
+
+- Installing or updating the marketplace/plugin contacts GitHub through your
+  coding assistant or Git. Setup downloads the exact engine version and its
+  dependencies through npm using `https://registry.npmjs.org`. Those services
+  receive download requests and ordinary connection information, including your
+  IP address. No asset upload is part of setup.
+- npm runs with lifecycle scripts, audit and funding requests disabled. It can
+  still use your existing npm configuration and inherited environment, including
+  registry authentication you already configured. Kiln does not request an npm
+  login or registry token for this public package, copy credentials into the
+  plugin, or promise to strip npm's normal credential configuration. npm also
+  writes to its normal cache and log directories.
+- CPU rendering is local. An optional local render service stays on your machine.
+  If you explicitly configure a renderer on another machine, Kiln sends the GLB
+  and capture settings to that chosen endpoint and uses its configured
+  authentication. Review that operator's privacy and retention practices first.
+- Opening documentation, filing a GitHub issue or contacting support uses the
+  service you choose. Information in a public issue is public; it is not private
+  telemetry from your local workspace.
+
+Relevant service policies: [npm](https://docs.npmjs.com/policies/privacy/),
+[GitHub](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement),
+[Claude](https://www.anthropic.com/legal/privacy) and
+[OpenAI](https://openai.com/policies/privacy-policy/). Other assistants and optional
+renderer operators provide their own policies.
+
+## Retention and deletion
+
+Local source, saved assets, runtime installations and workspace configuration
+remain until you delete them. Uninstalling the plugin removes neither your assets
+nor its separately installed engine. Plugin updates also leave existing
+workspaces on their installed engine until you request a managed upgrade.
+
+Setup removes recovery snapshots after a successful transaction or completed
+recovery. Interrupted setup can leave them until recovery succeeds or you resolve
+the interruption. The default location is
+`%LOCALAPPDATA%/InstruktLabs/Kiln/setup-transactions` on Windows, or
+`$XDG_DATA_HOME/instruktlabs/kiln/setup-transactions` elsewhere, falling back to
+`~/.local/share/instruktlabs/kiln/setup-transactions`. Use the setup helper's
+`--recover` operation before retrying an interrupted change. Do not upload recovery
+files to a public issue or delete them while setup or recovery is active.
+
+There is no automatic seven-day expiry for local work; that is a separate hosted
+service policy. Remove selected local work using Kiln's library controls or your
+filesystem, and manage independent exports, backups, npm caches and assistant
+histories through their respective applications. Preserve copies you want before
+deleting a workspace or runtime.
+
+## Support and security
+
+Contact [support@instruktlabs.com](mailto:support@instruktlabs.com) for privacy
+questions, deletion requests concerning information you sent to support, or
+private security reports. Support receives only what you send, including your
+email address and message. Support mail is forwarded through Cloudflare to the
+maintainer's Google inbox; see [Cloudflare's privacy policy](https://www.cloudflare.com/privacypolicy/)
+and [Google's privacy policy](https://policies.google.com/privacy). We use support
+correspondence to handle the request; this is not an automatic local-plugin alert
+or a mailing-list signup.
+
+Do not send passwords, tokens, recovery codes or private assets with a bug report.
+Sanitize logs and paths before posting publicly. Instrukt Labs cannot remotely
+access or erase your local workspace, your assistant's copies or a renderer
+operator's records through this plugin.

package/plugins/kiln-engine/README.md

@@ -1,25 +1,110 @@
-# Kiln Engine local plugin
+# Kiln local plugin
 
-Version 1.0.0, published by Instrukt Labs under the MIT license.
+Plugin version 1.1.0, maintained by Instrukt Labs under the MIT license.
+This plugin pins engine 1.1.0. Registry setup requires that exact version
+to be published. Use a published release tag for normal installation or a reviewed
+local archive for development qualification. The installation ID remains
+`kiln-engine@instruktlabs`.
 
-Ask your coding agent to set up a Kiln workspace. The setup skill installs
-`@instruktlabs/kiln@1.0.0` with npm and creates a separate asset workspace.
-Use a supported Node.js installation with npm; no Bun, engine clone or separate
-model API key is required. The workspace's START.md explains how to reopen it.
+Set up Kiln in an existing project or a new asset workspace, then create and revise
+editable 3D assets with your coding agent. Use a supported Node.js installation
+with npm. No Bun, engine checkout, Kiln account or separate model API key is needed.
+The plugin requires a local shell and filesystem; Claude chat and Cowork are not
+supported by this local bundle.
 
-The plugin registers setup only. The workspace supplies the authoring skills
-and one local MCP server, `kiln_workspace`. Open Claude Code in that workspace;
-launch Codex there with `node codex.mjs`. Accept the host's ordinary trust prompts
-and verify live tool discovery before authoring.
+## Install
+
+For Claude Code:
+
+```sh
+claude plugin marketplace add instruktlabs/kiln
+claude plugin install kiln-engine@instruktlabs
+```
+
+For Codex:
+
+```sh
+codex plugin marketplace add instruktlabs/kiln
+codex plugin add kiln-engine@instruktlabs
+```
+
+Restart or reload your coding agent's plugins as its installation message directs.
+Then ask it to set up a Kiln workspace. The maintained setup skill runs this
+plugin's `bin/kiln-setup-workspace.mjs` with Node, installs
+`@instruktlabs/kiln@1.1.0` outside the project and configures your chosen
+workspace. The same initializer supports existing projects and new workspaces.
+
+The plugin registers setup only. The workspace supplies authoring skills and one
+local MCP server, `kiln_workspace`. Open Claude Code in that workspace or launch
+Codex there with `codex`. For headless Codex execution, use
+`node codex.mjs "TASK"` with an explicit prompt. Read `.kiln/START.md` after
+adoption or `START.md` in a legacy workspace, accept the host's ordinary trust
+prompts and verify live tool discovery before authoring.
+
+## Setup examples
+
+1. **Create:** “Set up a new Kiln workspace in an empty directory outside this
+   checkout, using my current coding agent. Verify its tools before I author an
+   asset.” The installer downloads the pinned engine when needed, creates the
+   selected workspace and keeps its engine in a separate runtime store. npm also
+   uses its normal cache and log directories.
+2. **Adopt:** “Add Kiln to this project without replacing my instructions or other
+   MCP settings. Show the planned changes first.” Use `--adopt --check` to
+   preview, then `--adopt` to apply. Read `.kiln/AGENTS.md` alongside the
+   project's instructions. Repeat with another supported `--harness` to add
+   that integration around the same saved assets. The engine's adapter list is
+   included in `runtime.json`; it does not imply this plugin can be installed
+   in every listed client. Published engine 1.0.0 does not support adoption.
+3. **Check:** “Check my existing Kiln workspace without changing it.” The helper's
+   `--check` mode reports whether managed files and the installed engine are
+   current. A missing runtime is reported without installing one.
+4. **Upgrade:** “Upgrade my managed Kiln workspace while preserving my sources,
+   saved assets and customizations.” Stop the workspace's harness session first.
+   The helper's `--upgrade` mode uses the pinned engine and refuses conflicts
+   rather than replacing customized managed files.
 
 The engine installation and your assets stay outside the disposable plugin cache.
-Plugin removal or updating its cached files does not delete them. An existing
-workspace remains on its installed engine until an explicit managed upgrade.
-Read [setup and upgrade guidance](skills/kiln-setup-workspace/references/plugin-install.md).
+Removing or updating the plugin does not delete them. Existing workspaces stay on
+their installed engine until an explicit managed upgrade. Read the
+[setup and upgrade guide](skills/kiln-setup-workspace/references/plugin-install.md)
+for paths, repair and failure recovery.
+
+## Execution and network access
+
+The setup skill asks your coding agent to execute a bundled Node installer. That
+installer runs npm with lifecycle scripts disabled and invokes Kiln's workspace
+generator. It does this before the workspace MCP server exists; it does not
+silently install a global MCP server or grant itself shell permissions.
+
+Adoption and managed project updates temporarily keep recovery copies outside
+the project. Client configuration can already contain credentials, so these
+private copies may too. They are removed after successful setup or recovery;
+interrupted transactions retain them. See [local privacy](PRIVACY.md) for the
+storage location and protection limits. Use `--recover` before retrying an
+interrupted project update.
+
+Marketplace installation and updates contact `https://github.com`. First engine
+installation and dependency downloads use `https://registry.npmjs.org`. npm can
+use your existing npm configuration and environment. No npm login or token is
+required for this public package. Normal local asset work does not upload your
+assets to Instrukt Labs. Tool results can enter your coding assistant's model
+context; its provider handles those copies.
+
+CPU rendering is local. Material appearance needs a compatible local renderer or
+one you explicitly configure on another machine; a remote renderer receives the
+GLB and requested capture settings. Follow the setup skill's renderer checks.
+The separate hosted Kiln integration has its own authentication and privacy notice.
+
+## Support and security
+
+Send private security or privacy questions to
+[support@instruktlabs.com](mailto:support@instruktlabs.com). Never include
+passwords, tokens, recovery codes or private assets in public issues. For a normal
+bug report, provide the plugin and engine versions, operating system and a small
+sanitized reproduction at [GitHub issues](https://github.com/instruktlabs/kiln/issues).
 
-CPU rendering is available locally. Material appearance requires a qualified
-renderer; follow the setup skill's renderer checks rather than assuming GPU support.
-Hosted ChatGPT access is a separate integration, and this local bundle is not a
-public OpenAI directory submission.
+If setup fails, retain the error, check Node/npm and network access, and follow the
+setup guide. Do not delete an unfamiliar runtime or another installer's lock.
 
-[Source and issues](https://github.com/instruktlabs/kiln)
+[Local privacy notice](PRIVACY.md) · [MIT license](LICENSE) ·
+[Source](https://github.com/instruktlabs/kiln)

package/plugins/kiln-engine/{scripts/setup-workspace.mjs → bin/kiln-setup-workspace.mjs}

@@ -232,14 +232,15 @@ async function installRuntime(data, pin, archive, archiveHash, options) {
 
 export async function setupPluginWorkspace(options = {}) {
   const harness = options.harness || 'claude';
-  if (!['claude', 'codex'].includes(harness)) throw new Error('Choose harness claude or codex.');
   const mode = options.mode || 'create';
-  if (!['create', 'check', 'upgrade', 'repair'].includes(mode))
+  if (!['create', 'check', 'upgrade', 'repair', 'recover'].includes(mode))
     throw new Error('Unknown workspace setup mode.');
+  if (mode === 'recover' && (options.adopt || options.skills))
+    throw new Error('Use --recover alone before retrying setup.');
   if (!options.directory) throw new Error('Provide a workspace directory.');
   if (
     options.skills &&
-    (mode !== 'create' ||
+    ((mode !== 'create' && !(mode === 'check' && options.adopt)) ||
       !Array.isArray(options.skills) ||
       options.skills.some((name) => !['compose', 'batch'].includes(name)))
   )
@@ -251,6 +252,18 @@ export async function setupPluginWorkspace(options = {}) {
   if (pin.name !== packageName) throw new Error(`The plugin must pin package ${packageName}.`);
   if (typeof pin.version !== 'string' || !exactVersion.test(pin.version))
     throw new Error('The plugin runtime needs an exact stable, rc.N or dev.N version.');
+  // New bundles derive adapters from their pinned engine's initializer. Keep the
+  // original two-client contract for older bundles that have no capability list.
+  const harnesses = pin.harnesses === undefined ? ['claude', 'codex'] : pin.harnesses;
+  if (
+    !Array.isArray(harnesses) ||
+    !harnesses.length ||
+    harnesses.some((name) => typeof name !== 'string' || !/^[a-z][a-z0-9-]{0,63}$/.test(name)) ||
+    new Set(harnesses).size !== harnesses.length
+  )
+    throw new Error('Invalid workspace harness capabilities in the plugin runtime pin.');
+  if (!harnesses.includes(harness))
+    throw new Error(`Choose a supported workspace harness: ${harnesses.join(', ')}.`);
   const directory = await canonical(options.directory);
   const data = await canonical(options.dataDirectory || defaultDataDirectory());
   for (const [a, b] of [
@@ -260,7 +273,7 @@ export async function setupPluginWorkspace(options = {}) {
   ])
     if (inside(a, b) || inside(b, a))
       throw new Error('Keep workspace, runtime data and plugin cache in separate directories.');
-  if (mode === 'create' && (await exists(directory))) {
+  if (mode === 'create' && !options.adopt && (await exists(directory))) {
     if (!(await lstat(directory)).isDirectory() || (await readdir(directory)).length)
       throw new Error(
         'The workspace destination must be an empty directory; no existing files were changed.',
@@ -273,13 +286,22 @@ export async function setupPluginWorkspace(options = {}) {
     { name: pin.name, version: pin.version },
     archive,
     archiveHash,
-    { ...options, mode },
+    { ...options, mode: mode === 'recover' ? 'check' : mode },
   );
-  const { createWorkspace } = await import(
+  const { createWorkspace, workspaceSetupCapabilities } = await import(
     pathToFileURL(join(runtime, 'scripts/create-workspace.mjs')).href
   );
+  if (options.adopt && workspaceSetupCapabilities?.projectAdoption !== 1)
+    throw new Error(
+      'The pinned engine does not support project adoption. Use a plugin release that pins a supporting engine; no project files were changed.',
+    );
+  if (mode === 'recover' && workspaceSetupCapabilities?.recovery !== 1)
+    throw new Error(
+      'The pinned engine does not support project recovery. No project files were changed.',
+    );
   const workspace = await createWorkspace(directory, harness, {
     installation: runtime,
+    ...(options.adopt ? { adopt: true } : {}),
     ...(mode === 'create' ? {} : { [mode]: true }),
     ...(options.skills ? { skills: options.skills } : {}),
   });
@@ -302,9 +324,13 @@ export function parseSetupArguments(args) {
   };
   while (values.length) {
     const flag = values.shift();
-    if (['--check', '--upgrade', '--repair'].includes(flag)) {
-      if (result.mode) throw new Error('Choose only one of --check, --upgrade or --repair.');
+    if (['--check', '--upgrade', '--repair', '--recover'].includes(flag)) {
+      if (result.mode)
+        throw new Error('Choose only one of --check, --upgrade, --repair or --recover.');
       result.mode = flag.slice(2);
+    } else if (flag === '--adopt') {
+      if (result.adopt) throw new Error('Repeated option --adopt.');
+      result.adopt = true;
     } else if (Object.hasOwn(valueFlags, flag)) {
       const value = values.shift();
       if (!value || value.startsWith('--')) throw new Error(`Missing value for ${flag}.`);
@@ -312,6 +338,8 @@ export function parseSetupArguments(args) {
       result[valueFlags[flag]] = flag === '--skills' ? value.split(',') : value;
     } else throw new Error(`Unknown option ${flag}.`);
   }
+  if (result.mode === 'recover' && (result.adopt || result.skills))
+    throw new Error('Use --recover alone before retrying setup.');
   return result;
 }
 
@@ -323,7 +351,7 @@ if (
     const options = parseSetupArguments(process.argv.slice(2));
     if (options.help)
       console.log(
-        'Usage: node scripts/setup-workspace.mjs <directory> [--harness claude|codex] [--skills compose,batch]\n       node scripts/setup-workspace.mjs <managed-workspace> --check|--upgrade|--repair\nOptions: --data-dir <persistent-directory>, --archive <qualification.tgz>, --npm-cli <npm-cli.js>',
+        'Usage: node bin/kiln-setup-workspace.mjs <directory> [--harness NAME] [--skills compose,batch]\n       node bin/kiln-setup-workspace.mjs <project-or-new-workspace> --adopt [--check]\n       node bin/kiln-setup-workspace.mjs <managed-workspace> --check|--upgrade|--repair|--recover\nOptions: --data-dir <persistent-directory>, --archive <qualification.tgz>, --npm-cli <npm-cli.js>\nWorkspace adapters are declared by the pinned engine in runtime.json.',
       );
     else {
       const result = await setupPluginWorkspace(options);

package/plugins/kiln-engine/package-provenance.json

@@ -1,15 +1,22 @@
 {
   "schemaVersion": 1,
   "kind": "kiln-local-plugin",
-  "engineVersion": "1.0.0",
+  "pluginVersion": "1.1.0",
+  "engineVersion": "1.1.0",
+  "executables": [
+    "bin/kiln-setup-workspace.mjs"
+  ],
   "files": {
-    ".claude-plugin/plugin.json": "sha256:c40c7eafed4c0822faef83178633f3bf3449311220f709d5155aed4a9c74cd6b",
+    ".claude-plugin/icon.png": "sha256:b4b651c402793b7e27cab780f04b14f80daec6d0cd5b7e4e90313930581a54e9",
+    ".claude-plugin/plugin.json": "sha256:189394253cf57f988fd82b31dad05012d693615a50126eebb29bab3e80e3a2a9",
+    "bin/kiln-setup-workspace.mjs": "sha256:3d9a30236919a6ca91acb6b26f808cec442e6edc3dd88fe010645b010d76e838",
     "LICENSE": "sha256:cdba278ebf1d6de618869936226bf03be4887179c128efc7aaa13d22034826a5",
-    "plugin.json": "sha256:f80ecc90d141adf45e5fadfe5092c325e9174f02b364c1e0059cd5bd345eaaf1",
-    "README.md": "sha256:3a9482e4e8e47b8ef7fb27d2d880253397a7f903b7ccdd64794995fd3075d2dd",
-    "runtime.json": "sha256:18129a1d310c468aeba0966792940242f0359ab14c41a4c9ef240310d07d3bd2",
-    "scripts/setup-workspace.mjs": "sha256:0936f482a213706cf1576da11e57d40993b90f42b486f262e55d38d8d27b2e4d",
-    "skills/kiln-setup-workspace/references/plugin-install.md": "sha256:84f4ce4c9620aae1e6b37a6a04f5c874feae507c9e7a2f24fe62e48bbe6c09bd",
-    "skills/kiln-setup-workspace/SKILL.md": "sha256:9dbcb66514e21ea11b097bb1cd4b27b616834ded3e8182ea804f370add37a69f"
+    "plugin.json": "sha256:428ab085c6257ccc0e2dec3c7d4f9b6e02db0024a5f0b355410a30d6282dcd1d",
+    "PRIVACY.md": "sha256:5f58d981667e40441e21c2dec411f269a9a67a6141cec61976d27088fb12573b",
+    "README.md": "sha256:6a7fc436113f7493c884b2c495629351b01b2cd7e82e7b808f3abe73b9eb9af4",
+    "runtime.json": "sha256:253f76044dcc162295ca760ff584d1d6894068357c727a56b077b44278f38eb3",
+    "skills/kiln-setup-workspace/references/plugin-install.md": "sha256:c338fb792e7fad0364c3e1a13c94c506afa1395489ec1b6e83b36d04728935fb",
+    "skills/kiln-setup-workspace/references/renderer-setup.md": "sha256:b743b1b2827fa814385990e1e5b849391cb427413e9c016d273aa19cebd46031",
+    "skills/kiln-setup-workspace/SKILL.md": "sha256:65ed926b3503a33f4fe793e84e4a045ce36e3967f0e6b340e456a15dd010ce54"
   }
 }

package/plugins/kiln-engine/plugin.json

@@ -1,10 +1,11 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "kiln-engine",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Set up a local Kiln workspace to create, inspect and revise editable 3D assets with Claude Code or Codex.",
   "author": {
-    "name": "Instrukt Labs"
+    "name": "Instrukt Labs",
+    "email": "support@instruktlabs.com"
   },
   "homepage": "https://github.com/instruktlabs/kiln",
   "repository": "https://github.com/instruktlabs/kiln",
@@ -19,10 +20,14 @@
   "extensions": {
     "com.openai": {
       "interface": {
-        "displayName": "Kiln Engine",
+        "displayName": "Kiln",
         "shortDescription": "Create editable 3D assets in a local workspace",
         "longDescription": "Install the pinned Kiln engine and set up a workspace with local MCP tools and maintained authoring skills. Your coding agent supplies the model.",
         "developerName": "Instrukt Labs",
+        "websiteURL": "https://github.com/instruktlabs/kiln/tree/main/plugins/kiln-engine",
+        "supportURL": "https://github.com/instruktlabs/kiln/blob/main/plugins/kiln-engine/README.md#support-and-security",
+        "privacyPolicyURL": "https://github.com/instruktlabs/kiln/blob/main/docs/local-plugin-privacy.md",
+        "termsOfServiceURL": "https://github.com/instruktlabs/kiln/blob/main/LICENSE",
         "category": "Developer Tools",
         "capabilities": [
           "Read",
@@ -30,7 +35,8 @@
         ],
         "defaultPrompt": [
           "Set up a Kiln workspace for this coding agent.",
-          "Check and upgrade my existing Kiln workspace."
+          "Check my existing Kiln workspace without changing it.",
+          "Upgrade my managed Kiln workspace while preserving my assets."
         ]
       }
     }

package/plugins/kiln-engine/runtime.json

@@ -1,4 +1,13 @@
 {
   "name": "@instruktlabs/kiln",
-  "version": "1.0.0"
+  "version": "1.1.0",
+  "harnesses": [
+    "claude",
+    "codex",
+    "opencode",
+    "hermes",
+    "agy",
+    "copilot",
+    "cursor-agent"
+  ]
 }