@shoalrun/cli 1.0.0 → 1.1.0

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

@@ -0,0 +1,44 @@
+---
+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.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/all.md#shoalrun-content-restcontentsourceoptions) | REST mount, exact publication, optional revision, and request settings. |
+
+### Returns
+
+`Promise<`[`ContentSnapshot`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentsnapshot)`>`
+
+A snapshot with the same list/get/dispose interface as the manifest source.

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-restcontentsourceoptions-baseurl.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.RestContentSourceOptions.baseUrl
+
+**Property** `shoalrun.content.RestContentSourceOptions.baseUrl`
+
+```typescript
+baseUrl: string | URL
+```
+
+REST mount URL, such as /content/v1. Browser requests must use the application's origin.
+
+**Type: **`string | URL`
+
+Required

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-restcontentsourceoptions-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.RestContentSourceOptions.fetch
+
+**Property** `shoalrun.content.RestContentSourceOptions.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-restcontentsourceoptions-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.RestContentSourceOptions.limits
+
+**Property** `shoalrun.content.RestContentSourceOptions.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-restcontentsourceoptions-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.RestContentSourceOptions.publication
+
+**Property** `shoalrun.content.RestContentSourceOptions.publication`
+
+```typescript
+publication: ContentPublication
+```
+
+Exact publication to request; include product for a product-scoped source.
+
+**Type: **[`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentpublication)
+
+Required

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-restcontentsourceoptions-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.RestContentSourceOptions.revision
+
+**Property** `shoalrun.content.RestContentSourceOptions.revision`
+
+```typescript
+revision?: string | undefined
+```
+
+Expected inventory revision. Omit it to open the current revision.
+
+**Type: **`string | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-restcontentsourceoptions-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.RestContentSourceOptions.signal
+
+**Property** `shoalrun.content.RestContentSourceOptions.signal`
+
+```typescript
+signal?: AbortSignal | undefined
+```
+
+Cancel the inventory-opening request.
+
+**Type: **`AbortSignal | undefined`
+
+Optional

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

@@ -0,0 +1,50 @@
+---
+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.RestContentSourceOptions
+
+**Type** `shoalrun.content.RestContentSourceOptions`
+
+```typescript
+type RestContentSourceOptions = {
+    baseUrl: string | URL;
+    publication: ContentPublication;
+    revision?: string;
+    fetch?: typeof globalThis.fetch;
+    signal?: AbortSignal;
+    limits?: ContentDeliveryLimits;
+};
+```
+
+Options for a REST inventory and its revision-pinned resource reads.
+
+### Fields
+
+| Name                                                                                                                        | Type                                                                                                                                  | Required / default | Description                                                                              |
+| --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------- |
+| [`baseUrl`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-restcontentsourceoptions-baseurl)         | `string \| URL`                                                                                                                       | Required           | REST mount URL, such as /content/v1. Browser requests must use the application's origin. |
+| [`fetch`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-restcontentsourceoptions-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-restcontentsourceoptions-limits)           | [`ContentDeliveryLimits`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits)` \| undefined` | Optional           | Inventory and representation bounds.                                                     |
+| [`publication`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-restcontentsourceoptions-publication) | [`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentpublication)                      | Required           | Exact publication to request; include product for a product-scoped source.               |
+| [`revision`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-restcontentsourceoptions-revision)       | `string \| undefined`                                                                                                                 | Optional           | Expected inventory revision. Omit it to open the current revision.                       |
+| [`signal`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-restcontentsourceoptions-signal)           | `AbortSignal \| undefined`                                                                                                            | Optional           | Cancel the inventory-opening request.                                                    |

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-validatecontentmanifest.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.validateContentManifest
+
+**Function** `shoalrun.content.validateContentManifest`
+
+```typescript
+validateContentManifest(value: any, maxResources?: number, maxResourceBytes?: number): asserts value is ContentManifest
+```
+
+Validate a parsed manifest's shape, identities, paths, and resource bounds.
+This assertion narrows the value but doesn't verify fetched file bytes or trust in a host.
+
+### Parameters
+
+| Parameter          | Type / default        | Description                                                   |
+| ------------------ | --------------------- | ------------------------------------------------------------- |
+| `value`            | `any`                 | Parsed JSON manifest to validate.                             |
+| `maxResources`     | `number \| undefined` | Maximum allowed resource count; defaults to 10,000.           |
+| `maxResourceBytes` | `number \| undefined` | Maximum declared representation bytes; defaults to 8,000,000. |
+
+### Returns
+
+`void`

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

@@ -0,0 +1,65 @@
+---
+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
+
+**Module** `shoalrun.content`
+
+### Functions
+
+| Name                                                                                                                           | Kind       | Description                                                                                                                                                                                                                                   |
+| ------------------------------------------------------------------------------------------------------------------------------ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`contentRefKey`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentrefkey)                         | `function` | Serialize a reference to a deterministic key without including publication scope.                                                                                                                                                             |
+| [`contentResourceKey`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresourcekey)               | `function` | Public identity only: independent of publication, revision, and export filenames.                                                                                                                                                             |
+| [`mountContent`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-mountcontent)                           | `function` | 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. |
+| [`openManifestContentSource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-openmanifestcontentsource) | `function` | 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.                      |
+| [`openRestContentSource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-openrestcontentsource)         | `function` | Open a REST inventory and pin subsequent resource reads to its revision.                                                                                                                                                                      |
+| [`validateContentManifest`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-validatecontentmanifest)     | `function` | Validate a parsed manifest's shape, identities, paths, and resource bounds. This assertion narrows the value but doesn't verify fetched file bytes or trust in a host.                                                                        |
+
+### Members
+
+| Name                                                                                                                                 | Kind        | Description                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`ContentAnchor`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentanchor)                               | `type`      | Mapping from a canonical document fragment to its exported HTML ID.                                                                                            |
+| [`ContentAsset`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentasset)                                 | `type`      | A content-addressed file with its declared media type.                                                                                                         |
+| [`ContentDeliveryError`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliveryerror)                 | `class`     | Delivery failure with a machine-readable code and a human-readable message.                                                                                    |
+| [`ContentDeliveryLimits`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits)               | `type`      | Positive safe-integer bounds applied when opening and reading content.                                                                                         |
+| [`ContentErrorCode`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contenterrorcode)                         | `type`      | Stable error categories raised by content-source validation and reads.                                                                                         |
+| [`ContentFile`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentfile)                                   | `type`      | Export-relative file path, byte length, and SHA-256 digest.                                                                                                    |
+| [`ContentFormat`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentformat)                               | `type`      | Portable representations a content client can request.                                                                                                         |
+| [`ContentLink`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentlink)                                   | `type`      | Classified link and optional resource identity for application routing.                                                                                        |
+| [`ContentManifest`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentmanifest)                           | `type`      | One validated, content-addressed export inventory.                                                                                                             |
+| [`ContentMount`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentmount)                                 | `type`      | Handles and rewritten routing metadata for one mounted HTML instance.                                                                                          |
+| [`ContentPublication`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentpublication)                     | `type`      | Exact documentation publication selected by a content source.                                                                                                  |
+| [`ContentRef`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentref)                                     | `type`      | Stable identity of a page, a section within a page, or a named snippet instance. A reference is scoped to the publication and revision of the opened snapshot. |
+| [`ContentRepresentation`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentrepresentation)               | `type`      | One portable format, including its file metadata, anchors, and typed links.                                                                                    |
+| [`ContentResource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresource)                           | `type`      | Inventory entry describing one exported document, section, or snippet instance.                                                                                |
+| [`ContentRestEntry`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentrestentry)                         | `type`      | One resource inventory entry with its REST lookup key.                                                                                                         |
+| [`ContentRestError`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresterror)                         | `type`      | JSON error envelope returned by the content REST service.                                                                                                      |
+| [`ContentRestErrorCode`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresterrorcode)                 | `type`      | Error categories used by the content REST protocol.                                                                                                            |
+| [`ContentRestList`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentrestlist)                           | `type`      | Revision-scoped inventory envelope returned by the content REST service.                                                                                       |
+| [`ContentRestResource`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentrestresource)                   | `type`      | Revision-scoped metadata envelope for a single content resource.                                                                                               |
+| [`ContentResult`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentresult)                               | `type`      | A fetched representation together with the metadata needed to render or route it.                                                                              |
+| [`ContentSnapshot`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentsnapshot)                           | `interface` | A client pinned to one immutable inventory revision and publication.                                                                                           |
+| [`ManifestContentSourceOptions`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-manifestcontentsourceoptions) | `type`      | Configuration for opening a static content-export manifest.                                                                                                    |
+| [`RestContentSourceOptions`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-restcontentsourceoptions)         | `type`      | Options for a REST inventory and its revision-pinned resource reads.                                                                                           |

package/agent-docs/content-delivery/sdk/content-anchor/exported-id.md

@@ -0,0 +1,25 @@
+---
+id: reference.content-sdk.ContentAnchor.exportedId
+title: exportedId
+summary: "property: shoalrun.content.ContentAnchor.exportedId"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/content-anchor/exported-id
+---
+
+# exportedId
+
+> 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.**
+
+**Property** `shoalrun.content.ContentAnchor.exportedId`
+
+```typescript
+exportedId: string
+```
+
+**Type: **`string`
+
+Required

package/agent-docs/content-delivery/sdk/content-anchor/id.md

@@ -0,0 +1,25 @@
+---
+id: reference.content-sdk.ContentAnchor.id
+title: id
+summary: "property: shoalrun.content.ContentAnchor.id"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/content-anchor/id
+---
+
+# id
+
+> 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.**
+
+**Property** `shoalrun.content.ContentAnchor.id`
+
+```typescript
+id: string
+```
+
+**Type: **`string`
+
+Required

package/agent-docs/content-delivery/sdk/content-anchor/title.md

@@ -0,0 +1,25 @@
+---
+id: reference.content-sdk.ContentAnchor.title
+title: title
+summary: "property: shoalrun.content.ContentAnchor.title"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/content-anchor/title
+---
+
+# title
+
+> 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.**
+
+**Property** `shoalrun.content.ContentAnchor.title`
+
+```typescript
+title?: string | undefined
+```
+
+**Type: **`string | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/content-anchor.md

@@ -0,0 +1,71 @@
+---
+id: reference.content-sdk.ContentAnchor
+title: ContentAnchor
+summary: Mapping from a canonical document fragment to its exported HTML ID.
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/content-anchor
+---
+
+# ContentAnchor
+
+> 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.**
+
+**Type** `shoalrun.content.ContentAnchor`
+
+```typescript
+type ContentAnchor = {
+    id: string;
+    exportedId: string;
+    title?: string;
+};
+```
+
+Mapping from a canonical document fragment to its exported HTML ID.
+
+## Fields
+
+| Name                                                                                                                      | Type                  | Required / default | Description |
+| ------------------------------------------------------------------------------------------------------------------------- | --------------------- | ------------------ | ----------- |
+| [`exportedId`](https://www.shoalrun.com/content-delivery/sdk/content-anchor.md#shoalrun-content-contentanchor-exportedid) | `string`              | Required           | —           |
+| [`id`](https://www.shoalrun.com/content-delivery/sdk/content-anchor.md#shoalrun-content-contentanchor-id)                 | `string`              | Required           | —           |
+| [`title`](https://www.shoalrun.com/content-delivery/sdk/content-anchor.md#shoalrun-content-contentanchor-title)           | `string \| undefined` | Optional           | —           |
+
+## shoalrun.content.ContentAnchor.exportedId
+
+**Property** `shoalrun.content.ContentAnchor.exportedId`
+
+```typescript
+exportedId: string
+```
+
+**Type: **`string`
+
+Required
+
+## shoalrun.content.ContentAnchor.id
+
+**Property** `shoalrun.content.ContentAnchor.id`
+
+```typescript
+id: string
+```
+
+**Type: **`string`
+
+Required
+
+## shoalrun.content.ContentAnchor.title
+
+**Property** `shoalrun.content.ContentAnchor.title`
+
+```typescript
+title?: string | undefined
+```
+
+**Type: **`string | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/content-asset/media-type.md

@@ -0,0 +1,25 @@
+---
+id: reference.content-sdk.ContentAsset.mediaType
+title: mediaType
+summary: "property: shoalrun.content.ContentAsset.mediaType"
+type: code-reference
+area: publishing
+subarea: publishing-content-delivery
+canonical: /content-delivery/sdk/content-asset/media-type
+---
+
+# mediaType
+
+> 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.**
+
+**Property** `shoalrun.content.ContentAsset.mediaType`
+
+```typescript
+mediaType: string
+```
+
+**Type: **`string`
+
+Required