@shoalrun/cli 0.1.0-beta.1 → 1.1.0

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

@@ -0,0 +1,34 @@
+---
+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.ContentAnchor.exportedId
+
+**Property** `shoalrun.content.ContentAnchor.exportedId`
+
+```typescript
+exportedId: string
+```
+
+**Type: **`string`
+
+Required

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

@@ -0,0 +1,34 @@
+---
+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.ContentAnchor.id
+
+**Property** `shoalrun.content.ContentAnchor.id`
+
+```typescript
+id: string
+```
+
+**Type: **`string`
+
+Required

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

@@ -0,0 +1,34 @@
+---
+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.ContentAnchor.title
+
+**Property** `shoalrun.content.ContentAnchor.title`
+
+```typescript
+title?: string | undefined
+```
+
+**Type: **`string | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentanchor.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.ContentAnchor
+
+**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/all.md#shoalrun-content-contentanchor-exportedid) | `string`              | Required           | —           |
+| [`id`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentanchor-id)                 | `string`              | Required           | —           |
+| [`title`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentanchor-title)           | `string \| undefined` | Optional           | —           |

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

@@ -0,0 +1,34 @@
+---
+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.ContentAsset.mediaType
+
+**Property** `shoalrun.content.ContentAsset.mediaType`
+
+```typescript
+mediaType: string
+```
+
+**Type: **`string`
+
+Required

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

@@ -0,0 +1,40 @@
+---
+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.ContentAsset
+
+**Type** `shoalrun.content.ContentAsset`
+
+```typescript
+type ContentAsset = ContentFile & {
+    mediaType: string;
+};
+```
+
+A content-addressed file with its declared media type.
+
+### Fields
+
+| Name                                                                                                        | Type     | Required / default | Description |
+| ----------------------------------------------------------------------------------------------------------- | -------- | ------------------ | ----------- |
+| [`mediaType`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentasset-mediatype) | `string` | Required           | —           |

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

@@ -0,0 +1,34 @@
+---
+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.ContentDeliveryError.code
+
+**Property** `shoalrun.content.ContentDeliveryError.code`
+
+```typescript
+readonly code: ContentErrorCode
+```
+
+**Type: **[`ContentErrorCode`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contenterrorcode)
+
+Required

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentdeliveryerror.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.ContentDeliveryError
+
+**Class** `shoalrun.content.ContentDeliveryError`
+
+```typescript
+class ContentDeliveryError extends Error
+```
+
+Delivery failure with a machine-readable code and a human-readable message.
+
+### Constructor
+
+```typescript
+new ContentDeliveryError(code: ContentErrorCode, message: string): ContentDeliveryError
+```
+
+**Bases: **`Error`
+
+### Fields
+
+| Name                                                                                                      | Type                                                                                                         | Required / default | Description |
+| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------ | ----------- |
+| [`code`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliveryerror-code) | [`ContentErrorCode`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contenterrorcode) | Required           | —           |

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentdeliverylimits-manifestbytes.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.ContentDeliveryLimits.manifestBytes
+
+**Property** `shoalrun.content.ContentDeliveryLimits.manifestBytes`
+
+```typescript
+manifestBytes?: number | undefined
+```
+
+Maximum manifest or REST inventory bytes. Defaults to 5,000,000.
+
+**Type: **`number | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentdeliverylimits-resourcebytes.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.ContentDeliveryLimits.resourceBytes
+
+**Property** `shoalrun.content.ContentDeliveryLimits.resourceBytes`
+
+```typescript
+resourceBytes?: number | undefined
+```
+
+Maximum bytes for an individual representation. Defaults to 8,000,000.
+
+**Type: **`number | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentdeliverylimits-resources.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.ContentDeliveryLimits.resources
+
+**Property** `shoalrun.content.ContentDeliveryLimits.resources`
+
+```typescript
+resources?: number | undefined
+```
+
+Maximum resource count in the inventory. Defaults to 10,000.
+
+**Type: **`number | undefined`
+
+Optional

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentdeliverylimits.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.ContentDeliveryLimits
+
+**Type** `shoalrun.content.ContentDeliveryLimits`
+
+```typescript
+type ContentDeliveryLimits = {
+    manifestBytes?: number;
+    resourceBytes?: number;
+    resources?: number;
+};
+```
+
+Positive safe-integer bounds applied when opening and reading content.
+
+### Fields
+
+| Name                                                                                                                         | Type                  | Required / default | Description                                                            |
+| ---------------------------------------------------------------------------------------------------------------------------- | --------------------- | ------------------ | ---------------------------------------------------------------------- |
+| [`manifestBytes`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits-manifestbytes) | `number \| undefined` | Optional           | Maximum manifest or REST inventory bytes. Defaults to 5,000,000.       |
+| [`resourceBytes`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits-resourcebytes) | `number \| undefined` | Optional           | Maximum bytes for an individual representation. Defaults to 8,000,000. |
+| [`resources`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentdeliverylimits-resources)         | `number \| undefined` | Optional           | Maximum resource count in the inventory. Defaults to 10,000.           |

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

@@ -0,0 +1,32 @@
+---
+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.ContentErrorCode
+
+**Type** `shoalrun.content.ContentErrorCode`
+
+```typescript
+type ContentErrorCode = 'invalid_manifest' | 'not_found' | 'unsupported_format' | 'stale_revision' | 'network_error' | 'invalid_content' | 'disposed';
+```
+
+Stable error categories raised by content-source validation and reads.

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

@@ -0,0 +1,34 @@
+---
+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.ContentFile.bytes
+
+**Property** `shoalrun.content.ContentFile.bytes`
+
+```typescript
+bytes: number
+```
+
+**Type: **`number`
+
+Required

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

@@ -0,0 +1,34 @@
+---
+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.ContentFile.digest
+
+**Property** `shoalrun.content.ContentFile.digest`
+
+```typescript
+digest: string
+```
+
+**Type: **`string`
+
+Required

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

@@ -0,0 +1,34 @@
+---
+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.ContentFile.path
+
+**Property** `shoalrun.content.ContentFile.path`
+
+```typescript
+path: string
+```
+
+**Type: **`string`
+
+Required

package/agent-docs/content-delivery/sdk/all.sections/shoalrun-content-contentfile.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.ContentFile
+
+**Type** `shoalrun.content.ContentFile`
+
+```typescript
+type ContentFile = {
+    path: string;
+    bytes: number;
+    digest: string;
+};
+```
+
+Export-relative file path, byte length, and SHA-256 digest.
+
+### Fields
+
+| Name                                                                                                 | Type     | Required / default | Description |
+| ---------------------------------------------------------------------------------------------------- | -------- | ------------------ | ----------- |
+| [`bytes`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentfile-bytes)   | `number` | Required           | —           |
+| [`digest`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentfile-digest) | `string` | Required           | —           |
+| [`path`](https://www.shoalrun.com/content-delivery/sdk/all.md#shoalrun-content-contentfile-path)     | `string` | Required           | —           |