@shoalrun/cli 0.1.0-beta.1 → 1.1.0

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentrepresentation.md

@@ -0,0 +1,39 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentRepresentation
+
+**Type** `shoalrun.content.ContentRepresentation`
+
+```typescript
+type ContentRepresentation = ContentAsset & {
+    anchors: ContentAnchor[];
+    links: ContentLink[];
+};
+```
+
+One portable format, including its file metadata, anchors, and typed links.
+
+### Fields
+
+| Name                                                                                         | Type                                                                                                           | Required / default | Description |
+| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------ | ----------- |
+| [`anchors`](https://www.shoalrun.com/content-delivery/sdk/content-representation/anchors.md) | [`ContentAnchor`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentanchor)`[]` | Required           | —           |
+| [`links`](https://www.shoalrun.com/content-delivery/sdk/content-representation/links.md)     | [`ContentLink`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentlink)`[]`     | Required           | —           |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentresource.md

@@ -0,0 +1,62 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentResource
+
+**Type** `shoalrun.content.ContentResource`
+
+```typescript
+type ContentResource = {
+    ref: ContentRef;
+    publication: ContentPublication;
+    title: string;
+    summary: string;
+    type: string;
+    canonicalUrl?: string;
+    source?: {
+        documentId?: string;
+        snippetId?: string;
+        valuesDigest?: string;
+    };
+    representations: Partial<Record<ContentFormat, ContentRepresentation>>;
+    assets: string[];
+    externalDependencies: Array<{
+        url: string;
+        kind: 'image';
+    }>;
+};
+```
+
+Inventory entry describing one exported document, section, or snippet instance.
+
+### Fields
+
+| Name                                                                                                              | Type                                                                                                                                                                                                                                                          | Required / default | Description                                                           |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | --------------------------------------------------------------------- |
+| [`assets`](https://www.shoalrun.com/content-delivery/sdk/content-resource/assets.md)                              | `string[]`                                                                                                                                                                                                                                                    | Required           | —                                                                     |
+| [`canonicalUrl`](https://www.shoalrun.com/content-delivery/sdk/content-resource/canonical-url.md)                 | `string \| undefined`                                                                                                                                                                                                                                         | Optional           | —                                                                     |
+| [`externalDependencies`](https://www.shoalrun.com/content-delivery/sdk/content-resource/external-dependencies.md) | `{ url: string; kind: "image"; }[]`                                                                                                                                                                                                                           | Required           | —                                                                     |
+| [`publication`](https://www.shoalrun.com/content-delivery/sdk/content-resource/publication.md)                    | [`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentpublication)                                                                                                                                          | Required           | Exact product, channel, version, and documentation language.          |
+| [`ref`](https://www.shoalrun.com/content-delivery/sdk/content-resource/ref.md)                                    | [`ContentRef`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentref)                                                                                                                                                          | Required           | Stable identity used by ContentSnapshot.get.                          |
+| [`representations`](https://www.shoalrun.com/content-delivery/sdk/content-resource/representations.md)            | `Partial<Record<`[`ContentFormat`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentformat)`, `[`ContentRepresentation`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentrepresentation)`>>` | Required           | Available portable formats and their files, anchors, and typed links. |
+| [`source`](https://www.shoalrun.com/content-delivery/sdk/content-resource/source.md)                              | `{ documentId?: string; snippetId?: string; valuesDigest?: string; } \| undefined`                                                                                                                                                                            | Optional           | —                                                                     |
+| [`summary`](https://www.shoalrun.com/content-delivery/sdk/content-resource/summary.md)                            | `string`                                                                                                                                                                                                                                                      | Required           | Short explanation of the resource's purpose.                          |
+| [`title`](https://www.shoalrun.com/content-delivery/sdk/content-resource/title.md)                                | `string`                                                                                                                                                                                                                                                      | Required           | Human-readable resource title.                                        |
+| [`type`](https://www.shoalrun.com/content-delivery/sdk/content-resource/type.md)                                  | `string`                                                                                                                                                                                                                                                      | Required           | Authored document type, or section/snippet for a selected resource.   |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentresourcekey.md

@@ -0,0 +1,39 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.contentResourceKey
+
+**Function** `shoalrun.content.contentResourceKey`
+
+```typescript
+contentResourceKey(ref: ContentRef): string
+```
+
+Public identity only: independent of publication, revision, and export filenames.
+
+### Parameters
+
+| Parameter | Type / default                                                                                       | Description |
+| --------- | ---------------------------------------------------------------------------------------------------- | ----------- |
+| `ref`     | [`ContentRef`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentref) | —           |
+
+### Returns
+
+`string`

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentrestentry.md

@@ -0,0 +1,39 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentRestEntry
+
+**Type** `shoalrun.content.ContentRestEntry`
+
+```typescript
+type ContentRestEntry = {
+    key: string;
+    resource: ContentResource;
+};
+```
+
+One resource inventory entry with its REST lookup key.
+
+### Fields
+
+| Name                                                                                       | Type                                                                                                           | Required / default | Description |
+| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ------------------ | ----------- |
+| [`key`](https://www.shoalrun.com/content-delivery/sdk/content-rest-entry/key.md)           | `string`                                                                                                       | Required           | —           |
+| [`resource`](https://www.shoalrun.com/content-delivery/sdk/content-rest-entry/resource.md) | [`ContentResource`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentresource) | Required           | —           |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentresterror.md

@@ -0,0 +1,40 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentRestError
+
+**Type** `shoalrun.content.ContentRestError`
+
+```typescript
+type ContentRestError = {
+    error: {
+        code: ContentRestErrorCode;
+        message: string;
+    };
+};
+```
+
+JSON error envelope returned by the content REST service.
+
+### Fields
+
+| Name                                                                                 | Type                                                                                                                                                     | Required / default | Description |
+| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----------- |
+| [`error`](https://www.shoalrun.com/content-delivery/sdk/content-rest-error/error.md) | `{ code: `[`ContentRestErrorCode`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentresterrorcode)`; message: string; }` | Required           | —           |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentresterrorcode.md

@@ -0,0 +1,29 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentRestErrorCode
+
+**Type** `shoalrun.content.ContentRestErrorCode`
+
+```typescript
+type ContentRestErrorCode = 'invalid_request' | 'not_found' | 'unsupported_format' | 'stale_revision' | 'method_not_allowed' | 'internal_error';
+```
+
+Error categories used by the content REST protocol.

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentrestlist.md

@@ -0,0 +1,43 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentRestList
+
+**Type** `shoalrun.content.ContentRestList`
+
+```typescript
+type ContentRestList = {
+    schemaVersion: 1 | 2;
+    revision: string;
+    publication: ContentPublication;
+    resources: ContentRestEntry[];
+};
+```
+
+Revision-scoped inventory envelope returned by the content REST service.
+
+### Fields
+
+| Name                                                                                                 | Type                                                                                                                 | Required / default | Description |
+| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------ | ----------- |
+| [`publication`](https://www.shoalrun.com/content-delivery/sdk/content-rest-list/publication.md)      | [`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentpublication) | Required           | —           |
+| [`resources`](https://www.shoalrun.com/content-delivery/sdk/content-rest-list/resources.md)          | [`ContentRestEntry`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentrestentry)`[]` | Required           | —           |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/content-rest-list/revision.md)            | `string`                                                                                                             | Required           | —           |
+| [`schemaVersion`](https://www.shoalrun.com/content-delivery/sdk/content-rest-list/schema-version.md) | `1 \| 2`                                                                                                             | Required           | —           |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentrestresource.md

@@ -0,0 +1,45 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentRestResource
+
+**Type** `shoalrun.content.ContentRestResource`
+
+```typescript
+type ContentRestResource = {
+    schemaVersion: 1 | 2;
+    revision: string;
+    publication: ContentPublication;
+    key: string;
+    resource: ContentResource;
+};
+```
+
+Revision-scoped metadata envelope for a single content resource.
+
+### Fields
+
+| Name                                                                                                     | Type                                                                                                                 | Required / default | Description |
+| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------ | ----------- |
+| [`key`](https://www.shoalrun.com/content-delivery/sdk/content-rest-resource/key.md)                      | `string`                                                                                                             | Required           | —           |
+| [`publication`](https://www.shoalrun.com/content-delivery/sdk/content-rest-resource/publication.md)      | [`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentpublication) | Required           | —           |
+| [`resource`](https://www.shoalrun.com/content-delivery/sdk/content-rest-resource/resource.md)            | [`ContentResource`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentresource)       | Required           | —           |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/content-rest-resource/revision.md)            | `string`                                                                                                             | Required           | —           |
+| [`schemaVersion`](https://www.shoalrun.com/content-delivery/sdk/content-rest-resource/schema-version.md) | `1 \| 2`                                                                                                             | Required           | —           |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentresult.md

@@ -0,0 +1,45 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentResult
+
+**Type** `shoalrun.content.ContentResult`
+
+```typescript
+type ContentResult = {
+    resource: Readonly<ContentResource>;
+    representation: Readonly<ContentRepresentation>;
+    format: ContentFormat;
+    content: string;
+    revision: string;
+};
+```
+
+A fetched representation together with the metadata needed to render or route it.
+
+### Fields
+
+| Name                                                                                               | Type                                                                                                                                     | Required / default | Description                                                         |
+| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------- |
+| [`content`](https://www.shoalrun.com/content-delivery/sdk/content-result/content.md)               | `string`                                                                                                                                 | Required           | Validated UTF-8 HTML or Markdown text.                              |
+| [`format`](https://www.shoalrun.com/content-delivery/sdk/content-result/format.md)                 | [`ContentFormat`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentformat)                               | Required           | Representation actually returned by the source.                     |
+| [`representation`](https://www.shoalrun.com/content-delivery/sdk/content-result/representation.md) | `Readonly<`[`ContentRepresentation`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentrepresentation)`>` | Required           | File, media type, anchors, and typed links for the selected format. |
+| [`resource`](https://www.shoalrun.com/content-delivery/sdk/content-result/resource.md)             | `Readonly<`[`ContentResource`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentresource)`>`             | Required           | Inventory entry that was selected by the requested reference.       |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/content-result/revision.md)             | `string`                                                                                                                                 | Required           | Revision shared by this response and its opened content snapshot.   |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-contentsnapshot.md

@@ -0,0 +1,44 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ContentSnapshot
+
+**Interface** `shoalrun.content.ContentSnapshot`
+
+```typescript
+interface ContentSnapshot
+```
+
+A client pinned to one immutable inventory revision and publication.
+
+### Fields
+
+| Name                                                                                           | Type                                                                                                                               | Required / default | Description                                                        |
+| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------ |
+| [`publication`](https://www.shoalrun.com/content-delivery/sdk/content-snapshot/publication.md) | `Readonly<`[`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentpublication)`>` | Required           | Publication shared by every resource available from this snapshot. |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/content-snapshot/revision.md)       | `string`                                                                                                                           | Required           | Content digest identifying this inventory revision.                |
+
+### Methods
+
+| Name                                                                                   | Kind     | Description                                                               |
+| -------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------- |
+| [`dispose`](https://www.shoalrun.com/content-delivery/sdk/content-snapshot/dispose.md) | `method` | Cancel pending requests and prevent subsequent reads or inventory access. |
+| [`get`](https://www.shoalrun.com/content-delivery/sdk/content-snapshot/get.md)         | `method` | Fetch one available representation of a stable content reference.         |
+| [`list`](https://www.shoalrun.com/content-delivery/sdk/content-snapshot/list.md)       | `method` | List the resources in the opened inventory without fetching their bodies. |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-manifestcontentsourceoptions.md

@@ -0,0 +1,43 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.ManifestContentSourceOptions
+
+**Type** `shoalrun.content.ManifestContentSourceOptions`
+
+```typescript
+type ManifestContentSourceOptions = {
+    manifestUrl: string | URL;
+    fetch?: typeof globalThis.fetch;
+    signal?: AbortSignal;
+    limits?: ContentDeliveryLimits;
+};
+```
+
+Configuration for opening a static content-export manifest.
+
+### Fields
+
+| Name                                                                                                           | Type                                                                                                                                      | Required / default | Description                                                                  |
+| -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------------------------------------------------------- |
+| [`fetch`](https://www.shoalrun.com/content-delivery/sdk/manifest-content-source-options/fetch.md)              | `((input: RequestInfo \| URL, init?: RequestInit) => Promise<Response>) \| undefined`                                                     | Optional           | Fetch implementation. Defaults to globalThis.fetch.                          |
+| [`limits`](https://www.shoalrun.com/content-delivery/sdk/manifest-content-source-options/limits.md)            | [`ContentDeliveryLimits`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentdeliverylimits)` \| undefined` | Optional           | Inventory and representation bounds.                                         |
+| [`manifestUrl`](https://www.shoalrun.com/content-delivery/sdk/manifest-content-source-options/manifest-url.md) | `string \| URL`                                                                                                                           | Required           | Manifest URL; a browser resolves relative URLs against its current location. |
+| [`signal`](https://www.shoalrun.com/content-delivery/sdk/manifest-content-source-options/signal.md)            | `AbortSignal \| undefined`                                                                                                                | Optional           | Cancel the opening request. Use get's signal to cancel an individual read.   |

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-mountcontent.md

@@ -0,0 +1,45 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.mountContent
+
+**Function** `shoalrun.content.mountContent`
+
+```typescript
+mountContent(container: Element, result: ContentResult, options?: { instanceId?: string; signal?: AbortSignal; }): ContentMount
+```
+
+Mount trusted compiler HTML with instance-specific anchor and accessibility IDs.
+This is not a sanitizer. The result must come from trusted compiler output.
+The mount replaces the container's children and rewrites local routing metadata.
+
+### Parameters
+
+| Parameter   | Type / default                                                                                             | Description                                                        |
+| ----------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| `container` | `Element`                                                                                                  | DOM element receiving the content.                                 |
+| `result`    | [`ContentResult`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentresult) | A validated HTML representation; Markdown results aren't accepted. |
+| `options`   | `{ instanceId?: string; signal?: AbortSignal; } \| undefined`                                              | Optional unique instance ID and cancellation signal.               |
+
+### Returns
+
+[`ContentMount`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentmount)
+
+Rewritten anchors, typed links, and an unmount handle.

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-openmanifestcontentsource.md

@@ -0,0 +1,51 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.openManifestContentSource
+
+**Function** `shoalrun.content.openManifestContentSource`
+
+```typescript
+openManifestContentSource(options: ManifestContentSourceOptions): Promise<ContentSnapshot>
+```
+
+Open and validate one immutable static manifest revision.
+The caller owns trust in the compiler output and host. Browser URLs must use
+the application's origin. Requests reject redirects and unexpected content types.
+
+### Parameters
+
+| Parameter | Type / default                                                                                                                           | Description                                                     |
+| --------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| `options` | [`ManifestContentSourceOptions`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-manifestcontentsourceoptions) | Manifest URL, request implementation, cancellation, and limits. |
+
+### Returns
+
+`Promise<`[`ContentSnapshot`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentsnapshot)`>`
+
+A revision-pinned snapshot for listing and reading exported resources.
+
+### Examples
+
+```typescript
+const snapshot = await openManifestContentSource({ manifestUrl: '/help/manifest.json' });
+const page = await snapshot.get({ kind: 'page', documentId: 'guide.start' }, { format: 'markdown' });
+snapshot.dispose();
+```

package/agent-docs/content-delivery/sdk/exports.sections/shoalrun-content-openrestcontentsource.md

@@ -0,0 +1,41 @@
+---
+id: reference.content-sdk.exports
+title: shoalrun.content
+summary: "module: shoalrun.content"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/exports
+---
+
+# shoalrun.content
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+**Updated: 2026-09-27.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/exports.md)
+
+**Module** `shoalrun.content`
+
+## shoalrun.content.openRestContentSource
+
+**Function** `shoalrun.content.openRestContentSource`
+
+```typescript
+openRestContentSource(options: RestContentSourceOptions): Promise<ContentSnapshot>
+```
+
+Open a REST inventory and pin subsequent resource reads to its revision.
+
+### Parameters
+
+| Parameter | Type / default                                                                                                                   | Description                                                             |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `options` | [`RestContentSourceOptions`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-restcontentsourceoptions) | REST mount, exact publication, optional revision, and request settings. |
+
+### Returns
+
+`Promise<`[`ContentSnapshot`](https://www.shoalrun.com/content-delivery/sdk/exports.md#shoalrun-content-contentsnapshot)`>`
+
+A snapshot with the same list/get/dispose interface as the manifest source.