@metamesh/cli 0.17.0 → 0.19.0

package/dist/docs/guides/agent-authoring.md

@@ -2,12 +2,17 @@
 
 Use the CLI to find installed docs, check TypeScript, capture a model, and inspect measurements and rendered views.
 
-Use the `metamesh` CLI to look up the installed API, check TypeScript, generate a model, and inspect
-the captured result. It runs trusted local source with your ordinary Node permissions. Its
-disposable child process is not a security sandbox.
+Use the `metamesh` CLI to build a model and check what it actually produced. You or your agent can
+look up the installed API, check TypeScript, run the model, and inspect measurements and views of
+the captured result. The CLI runs trusted local source with your ordinary Node permissions. Its
+disposable child process isn't a security sandbox.
 
 ## Install and discover the environment
 
+Use Node.js 24 or newer. The package APIs publish ES modules only. TypeScript API consumers
+use TypeScript 6.0 or newer with `strict` checking and `NodeNext` or `Bundler` resolution;
+the CLI includes its source-checking compiler.
+
 Install Modeling for your model code and the CLI for the local authoring workflow:
 
 ```bash
@@ -19,13 +24,12 @@ pnpm exec metamesh setup
 
 `environment` reports project-resolved versions, documentation locations, available capabilities,
 and `authoringProtocolVersion: 1`. An agent integration should check that protocol value before
-using the commands. Missing packages, mismatched releases, or an unsupported protocol need an
-environment fix before authoring.
+using the commands. Fix missing packages, mismatched releases, or an unsupported protocol before
+authoring.
 
 Add the Generator SDK as a direct dependency when defining Generators, and Testkit when writing
-automated tests.
-Ordinary models need only Modeling and the CLI as direct dependencies. Keep installed MetaMesh
-packages on matching releases.
+automated tests. Ordinary models need only Modeling and the CLI as direct dependencies. Keep
+installed MetaMesh packages on matching releases.
 
 | Component                 | Responsibility                                                                                |
 | ------------------------- | --------------------------------------------------------------------------------------------- |
@@ -44,10 +48,10 @@ pnpm exec metamesh docs search "cylinder"
 pnpm exec metamesh docs show modeling/reference/model/cylinder
 ```
 
-The [standalone model example](https://metamesh.studio/docs/develop/standalone-model) is a short starting point.
-Use the [construction map](https://metamesh.studio/docs/develop/geometry-package#choose-a-modeling-path) to choose an
-approach, or search for a shape or symbol and read its recipe or reference. Search matches distinct
-words in titles, headings, keywords, and summaries. Exact titles, IDs, and imports take priority;
+Start with the [standalone model example](https://metamesh.studio/docs/develop/standalone-model), or use the
+[construction map](https://metamesh.studio/docs/develop/geometry-recipes#choose-a-technique) to choose an approach
+for your shape. You can also search for a shape or symbol and read its recipe or reference.
+Search matches distinct words in titles, headings, keywords, and summaries. Exact titles, IDs, and imports take priority;
 equally complete intent matches favor guides.
 
 Documentation is resolved from the selected project through package exports. No global installation
@@ -63,7 +67,7 @@ covers authoring and verification; `metamesh-docs` covers documentation. Both ar
 Use a reviewed skill snapshot provided by your project or installed through your agent's skill
 tooling. The printed GitHub installation source must be published before that command can work;
 a skill is optional for the CLI workflow below. Skills teach the process. The installed npm
-documentation owns exact signatures, import paths, units, lifecycle, and availability.
+documentation supplies exact signatures, import paths, units, execution rules, and availability.
 
 Project instructions should require environment discovery, relevant documentation lookup, source
 checking and execution, then measurement inspection and useful rendered views from that same run.
@@ -72,8 +76,8 @@ targeting another directory so every step resolves the same installation.
 
 ## Model entries
 
-A model entry default-exports an ordinary `ModelProgram`. It imports the real package; Studio's
-virtual `@metamesh/project` module is not available in local Node projects.
+A model entry default-exports a `ModelProgram` and imports the installed package directly.
+Studio's virtual `@metamesh/project` module isn't available in local Node projects.
 
 
 
@@ -83,7 +87,7 @@ import { box, cylinder, generate } from "@metamesh/modeling";
 export default generate<Record<never, never>>(({ part }) => {
   const body = box({ size: [30, 20, 6] });
   const bore = cylinder({ height: 8, radius: 3, sizing: "face" });
-  return part("plate", body.subtract([bore]));
+  return part("plate", body.subtract(bore));
 });
 ```
 
@@ -92,27 +96,27 @@ export default generate<Record<never, never>>(({ part }) => {
 Save this as `model.ts`, then check and run it:
 
 ```bash
-pnpm exec metamesh check model.ts --kind model
-pnpm exec metamesh run model.ts --kind model --export-3mf
+pnpm exec metamesh typecheck model.ts --kind model
+pnpm exec metamesh run model.ts --kind model
 ```
 
-Both commands perform semantic TypeScript checking. They use the nearest project TypeScript
-configuration, or an explicit `--tsconfig`, with strict checking enforced. Ordinary local imports
-and installed dependencies are supported. `check` does not evaluate your source.
+Both commands check TypeScript types using the nearest project TypeScript configuration, or an
+explicit `--tsconfig`, with strict checking enforced. You can use ordinary local imports and
+installed dependencies. `typecheck` doesn't evaluate your source.
 
 Use `--params values.json` for a model's JSON parameter map; the default is `{}`. Models do not
 receive injected Generator services. A standalone module can prepare licensed local fonts before
 constructing its synchronous generation program.
 
-For standalone font provenance, also pass `--font-fixtures fonts.json`. The CLI verifies those local
+To record which local fonts you used, also pass `--font-fixtures fonts.json`. The CLI verifies those
 bytes and records their declared font selections and immutable revisions in the capture; the model
 still prepares its own fonts and receives no injected services. Arbitrary filesystem or network
-reads are not intercepted, so their asset identities cannot be inferred. The source fingerprint
+reads aren't intercepted, so the CLI can't infer their asset identities. The source fingerprint
 covers bundled source, while fixture descriptors provide explicit asset provenance.
 
 ## Generator entries
 
-Install the Generator contract layer in addition to Modeling and the CLI:
+Install the Generator SDK alongside Modeling and the CLI to define controls and package metadata:
 
 ```bash
 pnpm add @metamesh/generator-sdk
@@ -147,8 +151,8 @@ and assertion parameter IDs. It declares the ordinary Modeling program and packa
 the host still owns normalization, asset preparation, execution, and cleanup.
 
 ```bash
-pnpm exec metamesh check generator.ts --kind generator
-pnpm exec metamesh run generator.ts --kind generator --params values.json
+pnpm exec metamesh typecheck generator.ts --kind generator
+pnpm exec metamesh run generator.ts --kind generator --overrides values.json
 ```
 
 Generator runs merge declared defaults with explicit overrides, then validate strictly. Unknown
@@ -167,15 +171,17 @@ run directory reported by that command as `RUN_DIRECTORY` below:
 ```bash
 pnpm exec metamesh inspect RUN_DIRECTORY
 pnpm exec metamesh inspect RUN_DIRECTORY --part plate
+pnpm exec metamesh export RUN_DIRECTORY --format 3mf --output plate.3mf
 pnpm exec metamesh browser install
 pnpm exec metamesh render RUN_DIRECTORY
 pnpm exec metamesh render RUN_DIRECTORY --views top --format webp --transparent
 ```
 
-Inspection reads finalized part IDs, placements, colors, measurements, diagnostics, and execution
-provenance. Rendering uses the same captured buffers without rerunning the model. Captures remain
+Inspection reads the completed model's part IDs, placements, colors, measurements, diagnostics,
+and execution provenance. Rendering uses the same captured buffers without rerunning the model,
+so the dimensions you inspect and the views you render belong to the same result. Captures remain
 usable after the engine session is disposed or the directory moves. Corrupt or incomplete
-artifacts reject.
+artifacts are rejected.
 
 Rendering requires the separately installed pinned Chromium. It is never downloaded implicitly;
 checking, generation, and inspection work without it. Standard orthographic views are isometric,
@@ -183,9 +189,10 @@ front, top, and right. The default is an isometric 1024 × 1024 PNG on a neutral
 lossless; PNG and WebP both support explicit transparent output. Images record their run, camera,
 renderer, and browser versions. Compare pixels only within the pinned capture environment.
 
-`--export-3mf` exports that run's finalized snapshot. A failed attempt never exposes an older
-successful result as its output. Match the captured parameters and source fingerprint to the
-revision you intended to verify.
+`export` reads the completed capture and writes `3mf`, `stl`, or `glb` without rerunning source.
+The required `--output` selects the destination file; the result reports format limitations as
+structured diagnostics. A failed attempt never exposes an older successful result as its output.
+Match the captured parameters and source fingerprint to the revision you intended to verify.
 
 ## Test models
 
@@ -195,35 +202,50 @@ Install Testkit separately when you want assertions and fixtures for your existi
 pnpm add -D @metamesh/testkit
 ```
 
-Use `createGeneratorTestRunner(definition, runtime)` for a Generator's persistent generation
-session. `runner.withModel(parameters, callback)` awaits assertions and disposes its snapshot in
-`finally`; invalid output throws structured `GenerationError` diagnostics. Dispose the runner
-separately to release its session and caches. Testkit's `withModel(program, parameters, callback)`
-does the same for an ordinary `ModelProgram` and also disposes its temporary session; its optional
-fourth argument accepts session policy, prepared services, and a test-owned engine.
+Use `await runModel(({ part }) => part("body", box({ size: 2 })))` for a one-off model, or
+pass an existing program directly with `await runModel(program, parameters)`. Use
+`await runModel({ definition, runtime }, parameters)` for a Generator. The returned result remains
+usable after the helper releases its temporary session; no cleanup is required.
+For cached Generators, exercise representative edits through
+`createGeneratorTestRunner(definition, runtime, { verifyCache: true })` and its `run` method.
+One-shot tests and declaration checks do not verify reuse across edits. Use `cache: false` for
+an uncached output baseline; keep prepared services stable when testing reuse in the same session.
+Callbacks run synchronously and return a part or an array of parts. Declare typed inline inputs
+with `runModel<Parameters, Services>(callback, parameters, options)`, or reuse a
+`GenerateCallback<Parameters, Services>`. Parameterless callbacks and Generator defaults can omit parameters. Options stay in the third
+argument: use `undefined` for omitted parameters when supplying a test-owned engine, generation
+policy, prepared model services, or a Generator's asynchronous `prepareServices` adapter.
+
+For Generator integration tests, import the definition and default runtime from the real entry
+point instead of repeating its input resolution and builder calls. Use direct callbacks to isolate
+construction, reconstruct a mesh, or deliberately bypass schema validation.
 
-Use `runner.execute` when a test needs explicit snapshot ownership or the discriminated invalid
-result. Handle `type: "invalid"` before reading a generated `model`, and dispose each successful
-snapshot separately. Unexpected execution or malformed-output errors reject in either path.
+Use `createGeneratorTestRunner(definition, runtime)` for a Generator's persistent generation
+session. `runner.run(parameters)` normalizes inputs, prepares assets, and returns a discriminated
+result. Handle `type: "invalid"`
+before reading a generated `model`. Successful results remain usable after later runs and runner
+disposal. Dispose the runner to release its session and caches. Use `engine.createSession(program, options)`
+for repeated plain-model edits or cache tests and dispose the session in `finally`; its returned
+results also remain usable. Unexpected execution or malformed-output errors reject.
 
 The runner normalizes saved values. To probe deliberately invalid typed inputs without that
-recovery, call `runner.validate(parameters, { normalize: false })`. Validation checks declarations
+recovery, call `runner.check(parameters, { validateInput: false })`. Validation checks declarations
 and reached assertions without finalizing output; execute representative valid combinations too.
 The CLI's strict overrides serve a different purpose: they reject invalid or unknown values
 before execution instead of recovering saved state.
 
-| Helper                         | What to check                                                      |
-| ------------------------------ | ------------------------------------------------------------------ |
-| `expectSerializableDefinition` | Strict definition parsing and a canonical JSON round trip          |
-| `expectValidDefaults`          | Strict parameter decoding and agreement with defaults              |
-| `expectValidPresets`           | Serializable preset metadata; execute presets for domain rules     |
-| `expectValidParts`             | Part metadata, closed oriented topology, and native reconstruction |
-| `expectMeshMeasurements`       | Bounds, area, signed volume, and connected-component count         |
-
-Compare physical measurements with explicit absolute tolerances; bounds use millimetres, area
-square millimetres, and volume cubic millimetres. Component counts are exact. Rendered views
-complement those assertions. A valid solid alone does not prove a suitable fit or manufacturable
-wall thickness.
+| Helper                   | What to check                                                      |
+| ------------------------ | ------------------------------------------------------------------ |
+| `assertValidDefinition`  | Strict definition parsing and a canonical JSON round trip          |
+| `assertValidDefaults`    | Strict parameter decoding and agreement with defaults              |
+| `assertValidPresets`     | Serializable preset metadata; execute presets for domain rules     |
+| `assertValidParts`       | Part metadata, closed oriented topology, and native reconstruction |
+| `assertMeshMeasurements` | Bounds, area, signed volume, and connected-component count         |
+
+Compare physical measurements with explicit absolute tolerances: bounds use millimetres, area
+square millimetres, and volume cubic millimetres. Component counts are exact. Use rendered views
+alongside those assertions to check the shape. A valid solid alone doesn't prove a suitable fit or
+manufacturable wall thickness.
 
 For Font controls, supply the runner's `prepareServices` option using checked-in licensed bytes.
 `prepareFontTestServices` from `@metamesh/testkit/fonts` verifies immutable font revisions and

package/dist/docs/guides/package.md

@@ -1,71 +1,107 @@
 # `@metamesh/cli`
 
-Check, execute, inspect, and render trusted local MetaMesh source. The `metamesh` executable and
-Node-only `/authoring` functions use the production engine and version-matched installed documentation.
+Check and run MetaMesh models from your terminal. Save generated geometry, inspect its dimensions,
+and render previews from the same result. The `metamesh` command also reads documentation for
+your installed packages, and its tools are available through a Node.js API.
 
 > **Preview:** `0.x` minor releases may break compatibility. Patches remain compatible within the
 > same minor line.
 
 ## Installation
 
-Install the same exact release of each MetaMesh package in the project where you author models:
+Install matching Modeling and CLI releases in your authoring project:
 
 ```bash
 pnpm add @metamesh/modeling
 pnpm add -D @metamesh/cli
 ```
 
-Add `@metamesh/generator-sdk` when your source defines Generators. Add `@metamesh/testkit` as a
-development dependency when importing testing helpers. CLI internally reuses Testkit font fixtures
-and its SDK contracts; neither package needs to be directly declared for standalone model authoring.
-The compiler, bundler, Three renderer, and Playwright belong to CLI; Testkit does not install them.
-Chromium is installed separately and never downloaded by checking or generation.
+The executable and Node API require Node.js 24 or newer. The API publishes ES modules only.
+TypeScript source and API consumers need TypeScript 6.0 or newer with `strict` checking and
+`NodeNext` or `Bundler` module resolution. The CLI includes its source-checking compiler.
+
+Add the [Generator SDK](https://github.com/JasonKoolman/metamesh/blob/main/packages/generator-sdk/README.md)
+to author Generators, or [Testkit](https://github.com/JasonKoolman/metamesh/blob/main/packages/testkit/README.md)
+to import testing helpers directly. Standalone models need neither as a direct dependency.
+Only rendering needs Chromium; checking, generation, and inspection work without a browser.
 
 ## Local workflow
 
+Save this plate with a through hole as `model.ts`:
+
+```ts
+import { box, cylinder, generate } from "@metamesh/modeling";
+
+export default generate(({ part }) => {
+  const plate = box({ size: [30, 20, 6] });
+  const bore = cylinder({ height: 8, radius: 3, sizing: "face" });
+  return part("plate", plate.subtract(bore));
+});
+```
+
+From the same project, discover the installed packages, check the source, and capture a run:
+
 ```bash
 pnpm exec metamesh environment --json
+pnpm exec metamesh docs search "sweep"
 pnpm exec metamesh docs show modeling/guide/concepts
-pnpm exec metamesh docs search "extrude"
-pnpm exec metamesh docs show TOPIC_ID
-pnpm exec metamesh check model.ts --kind model
+pnpm exec metamesh typecheck model.ts --kind model
 pnpm exec metamesh run model.ts --kind model
 pnpm exec metamesh inspect RUN_DIRECTORY
+pnpm exec metamesh export RUN_DIRECTORY --format 3mf --output plate.3mf
+```
+
+Replace `RUN_DIRECTORY` with the path reported by `run`. Export that capture as 3MF, STL, or GLB.
+Commands resolve packages and paths from the current project; use `--project PATH`
+to select another. `environment` reports package versions, local documentation, and the supported
+authoring protocol. Version mismatches fail before generation.
+
+Local model entries default-export a `ModelProgram` created with Modeling's `generate` helper.
+For Generators, use `--kind generator` with a named `definition` export and a default Generator
+module. Local entries import from the installed packages; Studio's virtual `@metamesh/project`
+module is unavailable here.
+
+Use `--params values.json` for a standalone model's complete input map, or
+`--overrides values.json` for a Generator. Generator overrides merge with defaults and undergo
+strict validation. Standalone model parameters pass through directly. The Node API uses the
+matching `params` and `overrides` fields, selected by `kind`.
+
+## Authoring tools
+
+| Command                     | Purpose                                                                    |
+| --------------------------- | -------------------------------------------------------------------------- |
+| `environment`               | Discover project-local packages, capabilities, and documentation.          |
+| `docs search` / `docs show` | Find and read exact-version guides and API references offline.             |
+| `typecheck`                 | Check TypeScript and entry-point export types without executing the model. |
+| `run`                       | Check and execute source, then capture geometry and diagnostics.           |
+| `export`                    | Save a capture as STL, 3MF, or GLB.                                        |
+| `inspect`                   | Read captured parts, bounds, measurements, and diagnostics.                |
+| `render`                    | Create standard views from a capture.                                      |
+| `setup`                     | Print skill installation and project-instruction guidance.                 |
+
+`run` executes source in a disposable child process with a 30-second default deadline and saves
+attempts under `.metamesh/runs`. Each capture records the source identity, effective parameters,
+and geometry hashes. `inspect`, `export`, and `render` validate the saved buffers and read that same result
+without rerunning the source.
+
+Source runs with your account's permissions. The child process is not a security sandbox; run
+source you trust. Use `--json` for structured stdout; author logs are bounded and sent to stderr.
+Exit codes are 0 for success, 1 for source or generation failure, and 2 for invocation, environment,
+artifact, or tooling failure. Each command's `--help` lists its options and limits.
+
+## Render a capture
+
+Install the CLI's pinned Chromium version, then choose views of the captured model:
+
+```bash
 pnpm exec metamesh browser install
 pnpm exec metamesh render RUN_DIRECTORY --views isometric,front,top,right
 ```
 
-`environment` reports `authoringProtocolVersion: 1`, installed package versions, capabilities,
-and documentation manifest paths. Mixed package versions or stale documentation fail before
-generation. Commands resolve packages and relative paths from the current project; pass
-`--project PATH` to select another project explicitly. `TOPIC_ID` comes from documentation search;
-`RUN_DIRECTORY` comes from a successful run.
-
-The concepts guide starts with a compact construction map. Search matches distinct words in
-titles, guide headings, keywords, and summaries. Exact titles, topic IDs, and import paths take
-priority; equally complete intent matches favor guides over reference entries.
-
-`run` includes semantic TypeScript checking and executes in a disposable child process with a
-30-second default deadline. It saves each attempt beneath `.metamesh/runs` with source identity,
-parameters, diagnostics, measurements, and hashed geometry buffers. `inspect` and `render` validate
-those captured buffers without importing the original source. Use `--json` for one structured stdout
-result; bounded author logs go to stderr. Exit codes are 0 for success, 1 for source or generation
-failure, and 2 for invocation, environment, artifact, or tooling failure. This executes trusted local
-code and is not a security sandbox.
-
-For Generators, use `--kind generator`. Entries named-export `definition` and default-export the
-Generator module envelope. Defaults merge with `--params parameters.json`, then strict validation
-rejects unknown or invalid overrides. Standalone model entries default-export a `ModelProgram` and
-receive no injected services. Both support normal local imports and installed dependencies; Studio's
-virtual `@metamesh/project` module is unavailable.
-
-Use `--help` on each command for parameters, fonts, resource limits, export, and image options.
-`metamesh setup` prints installation guidance for `metamesh-developer` from the canonical
-`metamesh-studio/metamesh-skills` repository and a project-instruction suggestion without modifying
-files. Its printed GitHub installation command becomes usable when that repository is published;
-the skill supplies the workflow, while installed package documentation supplies exact API facts.
-
-## Programmatic API and documentation
+Rendering supports PNG and lossless WebP, transparent backgrounds, and standard orthographic views.
+Checking and generation never download a browser.
+
+## Node API and agent workflows
 
 ```ts
 import { inspectCapturedRun, runAuthoringSource } from "@metamesh/cli/authoring";
@@ -76,16 +112,22 @@ if (result.success) {
 }
 ```
 
-Resolve `@metamesh/cli/docs/manifest.json` for the installed Markdown reference, or run
-`pnpm exec metamesh docs show cli/guide/agent-authoring` for the complete authoring workflow.
-The [authoring guide source](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/content/docs/develop/agent-authoring.mdx)
-also covers local font fixtures, artifacts, rendering, and agent integration. Until the public
-documentation site launches, use installed documentation, repository sources, or
-[run the docs locally](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/README.md#local-use).
+`@metamesh/cli/authoring` also exposes environment discovery, documentation lookup, source checking,
+export, and rendering.
+
+For coding agents, `metamesh setup` prints skill installation and project-instruction guidance
+without changing files. The portable `metamesh-developer` skill describes the authoring workflow
+and uses installed package documentation for API details.
+Install a reviewed skill snapshot from the canonical `metamesh-studio/metamesh-skills` repository
+or its local checkout when public installation is unavailable.
+
+## Documentation
 
-The reusable authoring functions and command implementation stay in this package; geometry and
-Generator contracts retain their existing owners. Testing assertions and font-fixture adapters
-remain in Testkit.
+Resolve `@metamesh/cli/docs/manifest.json` for exact-version Markdown guidance and API references,
+or run `pnpm exec metamesh docs show cli/guide/agent-authoring`. The
+[authoring guide](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/content/docs/develop/agent-authoring.mdx)
+covers entry contracts, parameters, fonts, captures, and rendering. See
+[Contributing](https://github.com/JasonKoolman/metamesh/blob/main/CONTRIBUTING.md) for package development.
 
 ## License
 

package/dist/docs/manifest.json

@@ -1,7 +1,7 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/cli",
-  "packageVersion": "0.17.0",
+  "packageVersion": "0.19.0",
   "documents": [
     {
       "id": "cli/guide/agent-authoring",
@@ -236,6 +236,48 @@
         "CapturedRunManifest"
       ]
     },
+    {
+      "id": "cli/reference/authoring/CaptureExportFormat",
+      "title": "CaptureExportFormat",
+      "summary": "Supported completed-model file formats.",
+      "path": "reference/authoring/CaptureExportFormat.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CaptureExportFormat"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CaptureExportOptions",
+      "title": "CaptureExportOptions",
+      "summary": "File delivery for one validated captured run; original author source is never executed.",
+      "path": "reference/authoring/CaptureExportOptions.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CaptureExportOptions"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CaptureExportResult",
+      "title": "CaptureExportResult",
+      "summary": "Completed file plus source identity and structured serializer diagnostics.",
+      "path": "reference/authoring/CaptureExportResult.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CaptureExportResult"
+      ]
+    },
     {
       "id": "cli/reference/authoring/checkAuthoringSource",
       "title": "checkAuthoringSource",
@@ -334,6 +376,20 @@
         "DocumentationSearchResult"
       ]
     },
+    {
+      "id": "cli/reference/authoring/exportCapturedRun",
+      "title": "exportCapturedRun",
+      "summary": "Streams a captured model to an atomically published file using the public mesh writers.",
+      "path": "reference/authoring/exportCapturedRun.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "exportCapturedRun"
+      ]
+    },
     {
       "id": "cli/reference/authoring/inspectCapturedRun",
       "title": "inspectCapturedRun",

package/dist/docs/reference/authoring/AUTHORING_PROTOCOL_VERSION.md

@@ -2,7 +2,7 @@
 
 Version of the CLI authoring protocol, independent of package SemVer and engine compatibility.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 AUTHORING_PROTOCOL_VERSION = 1

package/dist/docs/reference/authoring/AuthoringDiagnostic.md

@@ -2,7 +2,7 @@
 
 A structured issue with optional source location, parameter association, and geometry context.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** A structured issue with optional source location, parameter association, and geometry context. */

package/dist/docs/reference/authoring/AuthoringEnvironment.md

@@ -2,7 +2,7 @@
 
 The selected project's supported protocol, matching package releases, and available workflows.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** The selected project's supported protocol, matching package releases, and available workflows. */

package/dist/docs/reference/authoring/AuthoringError.md

@@ -2,7 +2,7 @@
 
 A classified authoring exception retaining its workflow phase, stable code, and exit status.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** A classified authoring exception retaining its workflow phase, stable code, and exit status. */

package/dist/docs/reference/authoring/AuthoringFailure-type.md

@@ -2,7 +2,7 @@
 
 An unsuccessful command outcome; a failure directory does not establish a complete capture.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** An unsuccessful command outcome; a failure directory does not establish a complete capture. */

package/dist/docs/reference/authoring/AuthoringKind.md

@@ -2,7 +2,7 @@
 
 Selects a standalone ModelProgram entry or an SDK Generator module with a definition.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** Selects a standalone ModelProgram entry or an SDK Generator module with a definition. */

package/dist/docs/reference/authoring/AuthoringPhase.md

@@ -2,9 +2,9 @@
 
 The workflow stage that rejected an invocation, source, asset, or captured artifact.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** The workflow stage that rejected an invocation, source, asset, or captured artifact. */
-export type AuthoringPhase = "invocation" | "environment" | "check" | "parameters" | "assets" | "bundle" | "execute" | "artifact" | "render";
+export type AuthoringPhase = "invocation" | "environment" | "check" | "parameters" | "assets" | "bundle" | "execute" | "artifact" | "render" | "export";
 ```

package/dist/docs/reference/authoring/CaptureExportFormat.md

@@ -0,0 +1,10 @@
+# CaptureExportFormat
+
+Supported completed-model file formats.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
+
+```ts
+/** Supported completed-model file formats. */
+export type CaptureExportFormat = ExportFormat;
+```

package/dist/docs/reference/authoring/CaptureExportOptions.md

@@ -0,0 +1,17 @@
+# CaptureExportOptions
+
+File delivery for one validated captured run; original author source is never executed.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
+
+```ts
+/** File delivery for one validated captured run; original author source is never executed. */
+export interface CaptureExportOptions {
+    readonly format: CaptureExportFormat;
+    /** Destination with the selected format's extension; its parent directory must already exist. */
+    readonly output: string;
+    /** Optional document title; defaults to the output filename without its extension. */
+    readonly name?: string;
+    readonly signal?: AbortSignal;
+}
+```

package/dist/docs/reference/authoring/CaptureExportResult.md

@@ -0,0 +1,15 @@
+# CaptureExportResult
+
+Completed file plus source identity and structured serializer diagnostics.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
+
+```ts
+/** Completed file plus source identity and structured serializer diagnostics. */
+export interface CaptureExportResult extends ExportReport {
+    readonly path: string;
+    readonly format: CaptureExportFormat;
+    readonly runId: string;
+    readonly sourceFingerprint: string;
+}
+```

package/dist/docs/reference/authoring/CapturedBuffer.md

@@ -2,7 +2,7 @@
 
 A captured file's relative path, byte length, and SHA-256 integrity digest.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.17.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
 
 ```ts
 /** A captured file's relative path, byte length, and SHA-256 integrity digest. */