@elevasis/sdk 1.46.0 → 1.47.0

package/dist/test-utils/index.js

@@ -8656,16 +8656,22 @@ createAdapter("artifacts", [
 ]);
 
 // src/worker/adapters/content.ts
-createAdapter("content", [
+var METHODS = [
   "createItem",
   "getItem",
   "listItems",
   "updateItem",
   "createAttempt",
   "listAttempts",
+  "updateAttempt",
+  "createSourceAsset",
+  "getSourceAsset",
+  "listSourceAssets",
+  "updateSourceAsset",
   "createDistribution",
   "updateDistribution"
-]);
+];
+createAdapter("content", METHODS);
 
 // src/worker/adapters/pdf.ts
 createAdapter("pdf", ["render", "renderToBuffer"]);
@@ -27742,6 +27748,11 @@ var mockContent = (overrides) => createMockAdapter(
     "updateItem",
     "createAttempt",
     "listAttempts",
+    "updateAttempt",
+    "createSourceAsset",
+    "getSourceAsset",
+    "listSourceAssets",
+    "updateSourceAsset",
     "createDistribution",
     "updateDistribution"
   ],

package/dist/worker/index.d.ts

@@ -2482,6 +2482,7 @@ type Database = {
             activities: {
                 Row: {
                     activity_type: string;
+                    actor_api_key_id: string | null;
                     actor_id: string | null;
                     actor_type: string | null;
                     created_at: string;
@@ -2498,6 +2499,7 @@ type Database = {
                 };
                 Insert: {
                     activity_type: string;
+                    actor_api_key_id?: string | null;
                     actor_id?: string | null;
                     actor_type?: string | null;
                     created_at?: string;
@@ -2514,6 +2516,7 @@ type Database = {
                 };
                 Update: {
                     activity_type?: string;
+                    actor_api_key_id?: string | null;
                     actor_id?: string | null;
                     actor_type?: string | null;
                     created_at?: string;
@@ -2529,6 +2532,13 @@ type Database = {
                     title?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "activities_actor_api_key_id_fkey";
+                        columns: ["actor_api_key_id"];
+                        isOneToOne: false;
+                        referencedRelation: "api_keys";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "activities_actor_id_fkey";
                         columns: ["actor_id"];
@@ -2616,6 +2626,7 @@ type Database = {
             api_keys: {
                 Row: {
                     created_at: string | null;
+                    created_by: string | null;
                     id: string;
                     key_hash: string;
                     last_used_at: string | null;
@@ -2624,6 +2635,7 @@ type Database = {
                 };
                 Insert: {
                     created_at?: string | null;
+                    created_by?: string | null;
                     id?: string;
                     key_hash: string;
                     last_used_at?: string | null;
@@ -2632,6 +2644,7 @@ type Database = {
                 };
                 Update: {
                     created_at?: string | null;
+                    created_by?: string | null;
                     id?: string;
                     key_hash?: string;
                     last_used_at?: string | null;
@@ -2639,6 +2652,13 @@ type Database = {
                     organization_id?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "api_keys_created_by_fkey";
+                        columns: ["created_by"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "api_keys_organization_id_fkey";
                         columns: ["organization_id"];
@@ -2966,6 +2986,7 @@ type Database = {
                     organization_id: string;
                     payload: Json;
                     source_execution_id: string | null;
+                    status: string;
                     step_key: string | null;
                 };
                 Insert: {
@@ -2977,6 +2998,7 @@ type Database = {
                     organization_id: string;
                     payload?: Json;
                     source_execution_id?: string | null;
+                    status: string;
                     step_key?: string | null;
                 };
                 Update: {
@@ -2988,6 +3010,7 @@ type Database = {
                     organization_id?: string;
                     payload?: Json;
                     source_execution_id?: string | null;
+                    status?: string;
                     step_key?: string | null;
                 };
                 Relationships: [
@@ -3139,6 +3162,7 @@ type Database = {
                     kind: string;
                     metadata: Json;
                     organization_id: string;
+                    payload: Json;
                     processing_state: Json;
                     storage_path: string | null;
                     title: string;
@@ -3152,6 +3176,7 @@ type Database = {
                     kind: string;
                     metadata?: Json;
                     organization_id: string;
+                    payload?: Json;
                     processing_state?: Json;
                     storage_path?: string | null;
                     title: string;
@@ -3165,6 +3190,7 @@ type Database = {
                     kind?: string;
                     metadata?: Json;
                     organization_id?: string;
+                    payload?: Json;
                     processing_state?: Json;
                     storage_path?: string | null;
                     title?: string;
@@ -9778,6 +9804,20 @@ declare const ProjectSchemas: {
     }, z.core.$strip>;
 };
 
+/**
+ * `'running'` is the only in-flight value; every other member is terminal.
+ * Added 2026-08-14 (the step-state model): a producer writes `'running'`
+ * when it starts a step and patches the same row to a terminal status when
+ * the step finishes (`updateAttempt`) — see `CreateContentItemAttemptRequestSchema`
+ * / `UpdateContentItemAttemptRequestSchema` below.
+ */
+declare const ContentStepStatusSchema: z.ZodEnum<{
+    error: "error";
+    success: "success";
+    running: "running";
+    no_result: "no_result";
+    skipped: "skipped";
+}>;
 /** D18: `pipeline_id` is an OM ontology id (free text), not a UUID. */
 declare const ContentPipelineIdSchema: z.ZodString;
 /** `content:catalog/status` entries. Free text, model-owned. */
@@ -9812,9 +9852,13 @@ declare const ContentItemResponseSchema: z.ZodObject<{
         status: z.ZodEnum<{
             error: "error";
             success: "success";
+            running: "running";
             no_result: "no_result";
             skipped: "skipped";
         }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
         data: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$loose>>;
     reviewedAt: z.ZodNullable<z.ZodString>;
@@ -9842,9 +9886,13 @@ declare const ContentItemListResponseSchema: z.ZodObject<{
             status: z.ZodEnum<{
                 error: "error";
                 success: "success";
+                running: "running";
                 no_result: "no_result";
                 skipped: "skipped";
             }>;
+            attemptId: z.ZodString;
+            executionId: z.ZodNullable<z.ZodString>;
+            attemptedAt: z.ZodString;
             data: z.ZodOptional<z.ZodUnknown>;
         }, z.core.$loose>>;
         reviewedAt: z.ZodNullable<z.ZodString>;
@@ -9866,6 +9914,13 @@ declare const ContentItemAttemptResponseSchema: z.ZodObject<{
     contentItemId: z.ZodString;
     attemptNumber: z.ZodNumber;
     stepKey: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        error: "error";
+        success: "success";
+        running: "running";
+        no_result: "no_result";
+        skipped: "skipped";
+    }>;
     payload: z.ZodUnknown;
     sourceExecutionId: z.ZodNullable<z.ZodString>;
     createdBy: z.ZodNullable<z.ZodString>;
@@ -9878,12 +9933,45 @@ declare const ContentItemAttemptListResponseSchema: z.ZodObject<{
         contentItemId: z.ZodString;
         attemptNumber: z.ZodNumber;
         stepKey: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            error: "error";
+            success: "success";
+            running: "running";
+            no_result: "no_result";
+            skipped: "skipped";
+        }>;
         payload: z.ZodUnknown;
         sourceExecutionId: z.ZodNullable<z.ZodString>;
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+declare const ContentSourceAssetResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    kind: z.ZodString;
+    title: z.ZodString;
+    externalUrl: z.ZodNullable<z.ZodString>;
+    storagePath: z.ZodNullable<z.ZodString>;
+    durationSeconds: z.ZodNullable<z.ZodNumber>;
+    metadata: z.ZodUnknown;
+    payload: z.ZodUnknown;
+    processingState: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<{
+            error: "error";
+            success: "success";
+            running: "running";
+            no_result: "no_result";
+            skipped: "skipped";
+        }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$loose>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
 declare const ContentDistributionResponseSchema: z.ZodObject<{
     id: z.ZodString;
     organizationId: z.ZodString;
@@ -9899,9 +9987,13 @@ declare const ContentDistributionResponseSchema: z.ZodObject<{
         status: z.ZodEnum<{
             error: "error";
             success: "success";
+            running: "running";
             no_result: "no_result";
             skipped: "skipped";
         }>;
+        attemptId: z.ZodString;
+        executionId: z.ZodNullable<z.ZodString>;
+        attemptedAt: z.ZodString;
         data: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$loose>>;
     publishMethod: z.ZodNullable<z.ZodString>;
@@ -9913,6 +10005,7 @@ declare const ContentDistributionResponseSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+type ContentStepStatus = z.infer<typeof ContentStepStatusSchema>;
 type ContentPipelineId = z.infer<typeof ContentPipelineIdSchema>;
 type ContentItemStatus = z.infer<typeof ContentItemStatusSchema>;
 type ContentPillar = z.infer<typeof ContentPillarSchema>;
@@ -9924,6 +10017,7 @@ type ContentItemResponse = z.infer<typeof ContentItemResponseSchema>;
 type ContentItemListResponse = z.infer<typeof ContentItemListResponseSchema>;
 type ContentItemAttemptResponse = z.infer<typeof ContentItemAttemptResponseSchema>;
 type ContentItemAttemptListResponse = z.infer<typeof ContentItemAttemptListResponseSchema>;
+type ContentSourceAssetResponse = z.infer<typeof ContentSourceAssetResponseSchema>;
 type ContentDistributionResponse = z.infer<typeof ContentDistributionResponseSchema>;
 
 /**
@@ -10956,6 +11050,13 @@ type ContentToolMap = {
             /** Which step this attempt implements. Stored as-is; NULL when omitted. */
             stepKey?: string | null;
             sourceExecutionId?: string | null;
+            /**
+             * The status the row is created with. Optional so a producer starting a
+             * step can write `'running'` before doing the work -- the "write-at-start"
+             * half of write-at-start/patch-at-end. Omitted, the column's own default
+             * applies, which is why a producer that means `'running'` must say so.
+             */
+            status?: ContentStepStatus;
         };
         result: ContentItemAttemptResponse;
     };
@@ -10966,6 +11067,69 @@ type ContentToolMap = {
         };
         result: ContentItemAttemptListResponse;
     };
+    /**
+     * Patch an existing attempt to its terminal status -- the "patch-at-end"
+     * half of write-at-start/patch-at-end (see `ContentStepStatus`'s
+     * `'running'` value). `attemptNumber`, `stepKey`, and `sourceExecutionId`
+     * are immutable once written; only `status` and `payload` change here.
+     */
+    updateAttempt: {
+        params: {
+            attemptId: string;
+            status?: ContentStepStatus;
+            payload?: ContentPayloadEnvelope;
+        };
+        result: ContentItemAttemptResponse;
+    };
+    /**
+     * Insert a new `content_source_assets` row. `payload` is an open envelope
+     * (D5, content-source-asset-write-path.mdx) -- per-`kind` field membership
+     * is declared in the OM catalog, not enforced by this transport type.
+     */
+    createSourceAsset: {
+        params: {
+            kind: string;
+            title: string;
+            externalUrl?: string | null;
+            storagePath?: string | null;
+            durationSeconds?: number | null;
+            metadata?: Record<string, unknown>;
+            payload?: ContentPayloadEnvelope;
+        };
+        result: ContentSourceAssetResponse;
+    };
+    /** Fetch a single source asset by id, org-scoped. */
+    getSourceAsset: {
+        params: {
+            sourceAssetId: string;
+        };
+        result: ContentSourceAssetResponse | null;
+    };
+    /** Query source assets -- e.g. a producer picking material for the next item. */
+    listSourceAssets: {
+        params: {
+            kind?: string;
+            limit?: number;
+            offset?: number;
+        };
+        result: {
+            data: ContentSourceAssetResponse[];
+        };
+    };
+    /** Update a source asset's mutable fields. */
+    updateSourceAsset: {
+        params: {
+            sourceAssetId: string;
+            kind?: string;
+            title?: string;
+            externalUrl?: string | null;
+            storagePath?: string | null;
+            durationSeconds?: number | null;
+            metadata?: Record<string, unknown>;
+            payload?: ContentPayloadEnvelope;
+        };
+        result: ContentSourceAssetResponse;
+    };
     /** Insert a `content_distributions` row for one platform/format target. */
     createDistribution: {
         params: {
@@ -12470,16 +12634,38 @@ declare const artifacts: TypedAdapter<ArtifactsToolMap>;
  * Content Platform Tool Adapter
  *
  * Typed wrapper over platform.call() for the content System's producer
- * surface (`content_items`, `content_item_attempts`, `content_distributions`).
- * Singleton export -- no credential needed (platform tool).
+ * surface (`content_items`, `content_item_attempts`, `content_distributions`,
+ * `content_source_assets`). Singleton export -- no credential needed
+ * (platform tool).
  *
  * `organizationId` is injected server-side by the dispatcher -- never sent
  * from the SDK. There is deliberately no `updateProcessingState` method:
  * `content_items.processing_state` and `content_distributions.processing_state`
  * are not writable through this adapter (content-pipeline execution plan
  * Decision 4, enforced by omission).
+ *
+ * `createAttempt.sourceExecutionId` is `string | null | undefined` on the
+ * underlying `ContentToolMap` (it is nullable for a future non-execution
+ * caller), but this adapter narrows it to a **required** `string` for
+ * producer-authored attempts -- the SDK-layer analog of `organizationId`
+ * never appearing in the params type at all. A worker always has its own
+ * `context.executionId` available, so requiring it here is a compile-time
+ * guarantee that a workflow cannot forget it, matching the step-state
+ * model's write-at-start/patch-at-end contract (see `mock-pipeline-shared.ts`).
+ *
+ * `createAttempt.status` is a real field on `ContentToolMap` -- a producer
+ * starting a step sends `'running'` and the dispatcher forwards it. It was
+ * briefly missing from both the tool map and the dispatcher's forward, which
+ * meant a create-time status was accepted by the Zod schema and then dropped,
+ * landing the row on the column default. Both were closed on 2026-08-15.
  */
 
+/** The content adapter's public shape -- `TypedAdapter<ContentToolMap>` with `createAttempt` narrowed. */
+type ContentAdapter = Omit<TypedAdapter<ContentToolMap>, 'createAttempt'> & {
+    createAttempt: (params: Omit<ContentToolMap['createAttempt']['params'], 'sourceExecutionId'> & {
+        sourceExecutionId: string;
+    }) => Promise<ContentToolMap['createAttempt']['result']>;
+};
 /**
  * Typed content adapter for the content pipeline's producer surface.
  *
@@ -12488,10 +12674,17 @@ declare const artifacts: TypedAdapter<ArtifactsToolMap>;
  * import { content } from '@elevasis/sdk/worker'
  *
  * const item = await content.createItem({ title: 'Draft', pipelineId: 'long-form-to-shorts' })
- * const attempt = await content.createAttempt({ contentItemId: item.id, payload: { body: '...' } })
+ * const attempt = await content.createAttempt({
+ *   contentItemId: item.id,
+ *   stepKey: 'clip-proposal',
+ *   status: 'running',
+ *   payload: {},
+ *   sourceExecutionId: context.executionId
+ * })
+ * const settled = await content.updateAttempt({ attemptId: attempt.id, status: 'success', payload: { body: '...' } })
  * ```
  */
-declare const content: TypedAdapter<ContentToolMap>;
+declare const content: ContentAdapter;
 
 /**
  * Typed PDF adapter for document rendering.

package/dist/worker/index.js

@@ -6815,16 +6815,22 @@ var artifacts = createAdapter("artifacts", [
 ]);
 
 // src/worker/adapters/content.ts
-var content = createAdapter("content", [
+var METHODS14 = [
   "createItem",
   "getItem",
   "listItems",
   "updateItem",
   "createAttempt",
   "listAttempts",
+  "updateAttempt",
+  "createSourceAsset",
+  "getSourceAsset",
+  "listSourceAssets",
+  "updateSourceAsset",
   "createDistribution",
   "updateDistribution"
-]);
+];
+var content = createAdapter("content", METHODS14);
 
 // src/worker/adapters/pdf.ts
 var pdf = createAdapter("pdf", ["render", "renderToBuffer"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.46.0",
+  "version": "1.47.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -55,9 +55,9 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.61.0",
-    "@repo/typescript-config": "0.0.0",
-    "@repo/eslint-config": "0.0.0"
+    "@repo/core": "0.62.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
   },
   "scripts": {
     "lint": "eslint src --max-warnings 0",

package/reference/_navigation.md

@@ -194,7 +194,7 @@ Universal scaffold documentation for all SDK projects. Source locations are co-l
 | Gate by System or Admin | `scaffold/recipes/gate-by-feature-or-admin.md` | Decision table and recipes for gating routes, sidebar entries, and UI elements with AccessGuard and the unified Access Model. |
 | Build and Extend CRM | `scaffold/recipes/extend-crm.md` | Map the CRM platform primitives available to SDK projects: shared UI pages, sidebar composition, data hooks, action definitions, workflow adapters, System Interfaces, and org-model extension boundaries. |
 | Build and Extend Lead Gen | `scaffold/recipes/extend-lead-gen.md` | Map the lead-gen platform primitives available to SDK projects: shared UI pages, provider-injected Organization Model config, data hooks, list/member state, artifacts, workflow adapters, System Interfaces, and tenant-owned extension boundaries. |
-| Build and Extend Content | `scaffold/recipes/extend-content.md` | Map the content platform primitives available to SDK projects: pipeline and step catalogs, shared review/pipeline/distribution pages, data hooks, the content workflow adapter, artifacts as rules documents, and org-model extension boundaries. |
+| Build and Extend Content | `scaffold/recipes/extend-content.md` | Map the content platform primitives available to SDK projects: pipeline and step catalogs, shared review/pipeline/distribution pages, data hooks, the content workflow adapter, and org-model extension boundaries. |
 | Customize CRM Actions | `scaffold/recipes/customize-crm-actions.md` | Add, hide, or replace CRM deal action buttons in a template-derived project, and override default platform action workflows with project-owned implementations. |
 | Customize Knowledge Browser | `scaffold/recipes/customize-knowledge-browser.md` | Author knowledge nodes and customize the Knowledge Browser in a template-derived project -- from zero-config authoring through sidebar composition, custom dispatchers, and direct query access. |
 | Query the Knowledge Graph | `scaffold/recipes/query-the-knowledge-graph.md` | Use the `knowledge:*` CLI subcommands on `elevasis-sdk` (external projects) and `elevasis` (monorepo) to browse, inspect, and traverse the OrganizationModel knowledge graph via six mount axes. |
@@ -280,7 +280,7 @@ Docs-site pages indexed: 38.
 
 | Page | Location | Description |
 | --- | --- | --- |
-| CLI Management Commands | `sdk/cli-management.mdx` | elevasis-sdk management commands -- project, note, acquisition, client, agent, session, queue, schedule, om, ui, and skill subcommand families |
+| CLI Management Commands | `sdk/cli-management.mdx` | elevasis-sdk management commands -- project, note, acquisition, client, agent, session, queue, schedule, om, ui, skill, and content subcommand families |
 | CLI Reference | `sdk/cli.mdx` | Core elevasis-sdk CLI commands -- validate, deploy, execute, inspect resources, manage credentials, rename, and enumerate the command catalog |
 | Concepts Reference | `sdk/concepts.mdx` | Plain-English explanations of Elevasis SDK concepts -- glossary, workflow analogies, Zod schemas, execution model, platform tools, and design decisions |
 | When to Reach for the define* Builders | `sdk/define-builders.mdx` | defineWorkflow, defineStep, defineContract, defineResource, and defineTopology exist for two different reasons -- this page teaches which reason applies before you pick a builder over a plain object literal. |

package/reference/packages/core/src/content/README.md

@@ -1,18 +1,23 @@
 # @elevasis/core/content
 
-Content pipeline API schemas and platform-content typed interfaces. Browser-safe (no Node APIs).
+Content pipeline API schemas, platform-content typed interfaces, and the pure placement helpers the API, the CLI, and the Command Center all share. Browser-safe (no Node APIs).
+
+The helpers live here rather than in `@repo/ui` because they have three consumers and only one of them is a React app. `packages/sdk` has no `@repo/ui` dependency, so a CLI board would have needed its own copy of the placement rule — and two copies of a rule like this diverge. That is not hypothetical: the open-review-gate predicate was inline in the `/queue` handler, was about to be hand-copied into review validation and the review page, and had already produced a live wrong answer before it was consolidated into `review-gates.ts` on 2026-08-15. `derive-board.ts` and `item-identity.ts` moved here the same day for the same reason; `@repo/ui` re-exports both from `features/content/board/`.
 
 ## Surface
 
-| Export                                                                                                                                         | Purpose                                                                                                                                                                 |
-| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ContentItemResponseSchema`, `CreateContentItemRequestSchema`, `UpdateContentItemRequestSchema`                                                | `content_items` transport shape. `processingState` is intentionally absent from create/update — factory-write-only.                                                     |
-| `ContentProcessingStateSchema`                                                                                                                 | `{ stepKey: { status, data? } }`, keyed by `ContentStepKeySchema` — a content-specific key, not lead-gen's `LeadGenStageKeySchema`.                                     |
-| `ContentPayloadEnvelopeSchema`                                                                                                                 | The producer's immutable emission stored in `payload`. Never edited — `body` is the human's canonical text.                                                             |
-| `ReviewContentItemRequestSchema`                                                                                                               | Approve, or reject with a required `rejectReason`. Writes `reviewed_at` / `reviewed_by`.                                                                                |
-| `ContentItemAttemptResponseSchema`, `CreateContentItemAttemptRequestSchema`                                                                    | `content_item_attempts` transport shape. No `attemptNumber` field on create — the API service assigns it inside the write. `stepKey` is producer-supplied and nullable. |
-| `ContentDistributionResponseSchema`, `CreateContentDistributionRequestSchema`, `UpdateContentDistributionRequestSchema`                        | `content_distributions` transport shape, including the manual-publish fields (`publishMethod`, `platformPostId`, `platformUrl`).                                        |
-| `PlatformContent`, `YouTubeContent`, `LinkedInContent`, `InstagramContent`, `XContent`, `AnyPlatformContent`, `PlatformContentMap`, `Platform` | Typed interfaces for platform-specific content stored in `content_distributions.platform_content`.                                                                      |
+| Export                                                                                                                                         | Purpose                                                                                                                                                                                         |
+| ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ContentItemResponseSchema`, `CreateContentItemRequestSchema`, `UpdateContentItemRequestSchema`                                                | `content_items` transport shape. `processingState` is intentionally absent from create/update — factory-write-only.                                                                             |
+| `ContentProcessingStateSchema`                                                                                                                 | `{ stepKey: { status, data? } }`, keyed by `ContentStepKeySchema` — a content-specific key, not lead-gen's `LeadGenStageKeySchema`.                                                             |
+| `ContentPayloadEnvelopeSchema`                                                                                                                 | The producer's immutable emission stored in `payload`. Never edited — `body` is the human's canonical text.                                                                                     |
+| `ReviewContentItemRequestSchema`                                                                                                               | Approve, or reject with a required `rejectReason`. Writes `reviewed_at` / `reviewed_by`.                                                                                                        |
+| `ContentItemAttemptResponseSchema`, `CreateContentItemAttemptRequestSchema`                                                                    | `content_item_attempts` transport shape. No `attemptNumber` field on create — the API service assigns it inside the write. `stepKey` is producer-supplied and nullable.                         |
+| `ContentDistributionResponseSchema`, `CreateContentDistributionRequestSchema`, `UpdateContentDistributionRequestSchema`                        | `content_distributions` transport shape, including the manual-publish fields (`publishMethod`, `platformPostId`, `platformUrl`).                                                                |
+| `PlatformContent`, `YouTubeContent`, `LinkedInContent`, `InstagramContent`, `XContent`, `AnyPlatformContent`, `PlatformContentMap`, `Platform` | Typed interfaces for platform-specific content stored in `content_distributions.platform_content`.                                                                                              |
+| `isOpenContentReviewGate`, `getOpenContentReviewGates`                                                                                         | The one predicate deciding whether a `processing_state` entry is an open, unreviewed `queued` gate. Consumed by the `/queue` handler, `reviewItem`'s `stepKey` validation, and the review page. |
+| `deriveContentBoard`, `ContentBoard`, `ContentBoardCard`, `ContentBoardColumn`, `ContentBoardGate`                                             | Placement: `(items, pipeline, now)` to columns, gates, waiting counts, plus the `done` and `unplaced` buckets. Pure. Consumed by the Command Center board and `elevasis-sdk content:board`.     |
+| `getContentItemIdentity`                                                                                                                       | Names an item for display when `title` cannot — first non-blank line of `body`, then the first string payload field, then `title`, then `'Untitled'`.                                           |
 
 ## Step catalog reconciliation