@shoalrun/cli 0.1.0-beta.1 → 1.1.0

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ContentResult.revision
+
+**Property** `shoalrun.content.ContentResult.revision`
+
+```typescript
+revision: string
+```
+
+Revision shared by this response and its opened content snapshot.
+
+**Type: **`string`
+
+Required

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

@@ -0,0 +1,48 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## 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/all.md#shoalrun-content-contentresult-content)               | `string`                                                                                                                             | Required           | Validated UTF-8 HTML or Markdown text.                              |
+| [`format`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresult-format)                 | [`ContentFormat`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentformat)                               | Required           | Representation actually returned by the source.                     |
+| [`representation`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresult-representation) | `Readonly<`[`ContentRepresentation`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentrepresentation)`>` | Required           | File, media type, anchors, and typed links for the selected format. |
+| [`resource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresult-resource)             | `Readonly<`[`ContentResource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresource)`>`             | Required           | Inventory entry that was selected by the requested reference.       |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresult-revision)             | `string`                                                                                                                             | Required           | Revision shared by this response and its opened content snapshot.   |

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ContentSnapshot.dispose
+
+**Method** `shoalrun.content.ContentSnapshot.dispose`
+
+```typescript
+dispose(): void
+```
+
+Cancel pending requests and prevent subsequent reads or inventory access.
+
+### Returns
+
+`void`

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

@@ -0,0 +1,45 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ContentSnapshot.get
+
+**Method** `shoalrun.content.ContentSnapshot.get`
+
+```typescript
+get(ref: ContentRef, options: { format: ContentFormat; signal?: AbortSignal; }): Promise<ContentResult>
+```
+
+Fetch one available representation of a stable content reference.
+
+### Parameters
+
+| Parameter | Type / default                                                                                                                                | Description                                                |
+| --------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| `ref`     | [`ContentRef`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentref)                                              | Page, section, or named snippet instance in this snapshot. |
+| `options` | `{ format: `[`ContentFormat`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentformat)`; signal?: AbortSignal; }` | Required format and an optional signal for this read.      |
+
+### Returns
+
+`Promise<`[`ContentResult`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresult)`>`
+
+Validated representation text with its routing and revision metadata.

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

@@ -0,0 +1,38 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ContentSnapshot.list
+
+**Method** `shoalrun.content.ContentSnapshot.list`
+
+```typescript
+list(): readonly Readonly<ContentResource>[]
+```
+
+List the resources in the opened inventory without fetching their bodies.
+
+### Returns
+
+`readonly Readonly<`[`ContentResource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresource)`>[]`
+
+Read-only resource entries for this publication and revision.

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ContentSnapshot.publication
+
+**Property** `shoalrun.content.ContentSnapshot.publication`
+
+```typescript
+readonly publication: Readonly<ContentPublication>
+```
+
+Publication shared by every resource available from this snapshot.
+
+**Type:&#x20;**`Readonly<`[`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentpublication)`>`
+
+Required

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ContentSnapshot.revision
+
+**Property** `shoalrun.content.ContentSnapshot.revision`
+
+```typescript
+readonly revision: string
+```
+
+Content digest identifying this inventory revision.
+
+**Type: **`string`
+
+Required

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

@@ -0,0 +1,47 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## 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/all.md#shoalrun-content-contentsnapshot-publication) | `Readonly<`[`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentpublication)`>` | Required           | Publication shared by every resource available from this snapshot. |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentsnapshot-revision)       | `string`                                                                                                                       | Required           | Content digest identifying this inventory revision.                |
+
+### Methods
+
+| Name                                                                                                       | Kind     | Description                                                               |
+| ---------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------- |
+| [`dispose`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentsnapshot-dispose) | `method` | Cancel pending requests and prevent subsequent reads or inventory access. |
+| [`get`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentsnapshot-get)         | `method` | Fetch one available representation of a stable content reference.         |
+| [`list`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentsnapshot-list)       | `method` | List the resources in the opened inventory without fetching their bodies. |

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ManifestContentSourceOptions.fetch
+
+**Property** `shoalrun.content.ManifestContentSourceOptions.fetch`
+
+```typescript
+fetch?: ((input: RequestInfo | URL, init?: RequestInit) => Promise<Response>) | undefined
+```
+
+Fetch implementation. Defaults to globalThis.fetch.
+
+**Type:&#x20;**`((input: RequestInfo | URL, init?: RequestInit) => Promise<Response>) | undefined`
+
+Optional

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ManifestContentSourceOptions.limits
+
+**Property** `shoalrun.content.ManifestContentSourceOptions.limits`
+
+```typescript
+limits?: ContentDeliveryLimits | undefined
+```
+
+Inventory and representation bounds.
+
+**Type: **[`ContentDeliveryLimits`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits)` | undefined`
+
+Optional

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ManifestContentSourceOptions.manifestUrl
+
+**Property** `shoalrun.content.ManifestContentSourceOptions.manifestUrl`
+
+```typescript
+manifestUrl: string | URL
+```
+
+Manifest URL; a browser resolves relative URLs against its current location.
+
+**Type: **`string | URL`
+
+Required

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

@@ -0,0 +1,36 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## shoalrun.content.ManifestContentSourceOptions.signal
+
+**Property** `shoalrun.content.ManifestContentSourceOptions.signal`
+
+```typescript
+signal?: AbortSignal | undefined
+```
+
+Cancel the opening request. Use get's signal to cancel an individual read.
+
+**Type: **`AbortSignal | undefined`
+
+Optional

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

@@ -0,0 +1,46 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## 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/all.md#shoalrun-content-manifestcontentsourceoptions-fetch)             | `((input: RequestInfo \| URL, init?: RequestInit) => Promise<Response>) \| undefined`                                                 | Optional           | Fetch implementation. Defaults to globalThis.fetch.                          |
+| [`limits`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-manifestcontentsourceoptions-limits)           | [`ContentDeliveryLimits`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits)` \| undefined` | Optional           | Inventory and representation bounds.                                         |
+| [`manifestUrl`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-manifestcontentsourceoptions-manifesturl) | `string \| URL`                                                                                                                       | Required           | Manifest URL; a browser resolves relative URLs against its current location. |
+| [`signal`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-manifestcontentsourceoptions-signal)           | `AbortSignal \| undefined`                                                                                                            | Optional           | Cancel the opening request. Use get's signal to cancel an individual read.   |

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

@@ -0,0 +1,48 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## 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/all.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/all.md#shoalrun-content-contentmount)
+
+Rewritten anchors, typed links, and an unmount handle.

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

@@ -0,0 +1,54 @@
+---
+id: reference.content-sdk.complete
+title: Complete content client reference
+summary: Public exports from @shoalrun/cli/content, with signatures and JSDoc
+  from TypeScript declarations.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/all
+---
+
+# Complete content client reference
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Reference](https://www.shoalrun.com/.well-known/shoalrun/navigation/reference-tab-50f26fe22670.txt) (ID: reference-tab). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Reference](https://www.shoalrun.com/cli.md) > Content delivery > TypeScript symbols > Complete reference
+
+**Updated: 2026-11-07.**
+
+Parent page: [Full Markdown page](/content-delivery/sdk/all.md)
+
+## 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/all.md#shoalrun-content-manifestcontentsourceoptions) | Manifest URL, request implementation, cancellation, and limits. |
+
+### Returns
+
+`Promise<`[`ContentSnapshot`](https://www.shoalrun.com/content-delivery/sdk/all.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();
+```