@happyvertical/smrt-content 0.43.8 → 0.43.10

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-content",
-  "packageVersion": "0.43.8",
+  "packageVersion": "0.43.10",
   "objects": {
     "@happyvertical/smrt-content:ContentAsset": {
       "name": "contentasset",
@@ -5532,6 +5532,20 @@
           "isStatic": false,
           "isPublic": true
         },
+        "withTransaction": {
+          "name": "withTransaction",
+          "async": true,
+          "parameters": [
+            {
+              "name": "operation",
+              "type": "Function",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<T>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "initialize": {
           "name": "initialize",
           "async": true,
@@ -5627,11 +5641,31 @@
         "save": {
           "name": "save",
           "async": true,
-          "parameters": [],
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
           "returnType": "any",
           "isStatic": false,
           "isPublic": true
         },
+        "claimRevision": {
+          "name": "claimRevision",
+          "async": true,
+          "parameters": [
+            {
+              "name": "expectedUpdatedAt",
+              "type": "Date | string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
         "classifyConstraintError": {
           "name": "classifyConstraintError",
           "async": false,
@@ -7222,6 +7256,20 @@
           "isStatic": false,
           "isPublic": true
         },
+        "withTransaction": {
+          "name": "withTransaction",
+          "async": true,
+          "parameters": [
+            {
+              "name": "operation",
+              "type": "Function",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<T>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "initialize": {
           "name": "initialize",
           "async": true,
@@ -7317,11 +7365,31 @@
         "save": {
           "name": "save",
           "async": true,
-          "parameters": [],
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
           "returnType": "any",
           "isStatic": false,
           "isPublic": true
         },
+        "claimRevision": {
+          "name": "claimRevision",
+          "async": true,
+          "parameters": [
+            {
+              "name": "expectedUpdatedAt",
+              "type": "Date | string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
         "classifyConstraintError": {
           "name": "classifyConstraintError",
           "async": false,
@@ -8941,6 +9009,20 @@
           "isStatic": false,
           "isPublic": true
         },
+        "withTransaction": {
+          "name": "withTransaction",
+          "async": true,
+          "parameters": [
+            {
+              "name": "operation",
+              "type": "Function",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<T>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "initialize": {
           "name": "initialize",
           "async": true,
@@ -9036,11 +9118,31 @@
         "save": {
           "name": "save",
           "async": true,
-          "parameters": [],
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
           "returnType": "any",
           "isStatic": false,
           "isPublic": true
         },
+        "claimRevision": {
+          "name": "claimRevision",
+          "async": true,
+          "parameters": [
+            {
+              "name": "expectedUpdatedAt",
+              "type": "Date | string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
         "classifyConstraintError": {
           "name": "classifyConstraintError",
           "async": false,
@@ -11097,6 +11199,20 @@
           "isStatic": false,
           "isPublic": true
         },
+        "withTransaction": {
+          "name": "withTransaction",
+          "async": true,
+          "parameters": [
+            {
+              "name": "operation",
+              "type": "Function",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<T>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "initialize": {
           "name": "initialize",
           "async": true,
@@ -11192,11 +11308,31 @@
         "save": {
           "name": "save",
           "async": true,
-          "parameters": [],
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
           "returnType": "any",
           "isStatic": false,
           "isPublic": true
         },
+        "claimRevision": {
+          "name": "claimRevision",
+          "async": true,
+          "parameters": [
+            {
+              "name": "expectedUpdatedAt",
+              "type": "Date | string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
         "classifyConstraintError": {
           "name": "classifyConstraintError",
           "async": false,
@@ -13018,6 +13154,7 @@
   },
   "moduleType": "smrt",
   "smrtDependencies": [
+    "@happyvertical/smrt-agents",
     "@happyvertical/smrt-assets",
     "@happyvertical/smrt-chat",
     "@happyvertical/smrt-core",

package/dist/server/content-list-actions.d.ts

@@ -0,0 +1,123 @@
+import { PrincipalRun } from '@happyvertical/smrt-agents';
+import { createDataSurfaceActionAdapter, DataSurfaceActionAdapter, DataSurfaceActionStateStore, DataSurfaceBackgroundQueue, DataSurfaceServerActionContext, DataSurfaceServerActionRequest } from '@happyvertical/smrt-agents/server';
+import { DataQueryRequest } from '@happyvertical/smrt-types';
+import { DataSurfaceActionResult, DataSurfaceDescriptor, DataSurfaceIdentity, DataSurfaceJsonObject, DataSurfaceJsonValue } from '@happyvertical/smrt-ui/data';
+import { ContentBodyFormat } from '../body-format.js';
+import { Content } from '../content.js';
+import { ContentQueryCollection, ContentQueryScope } from '../content-query.js';
+export declare const CONTENT_LIST_WORKFLOW_IDS: readonly ["move-to-trash", "mark-draft", "submit-review", "publish", "archive", "restore", "automated-review", "format-body", "categorize", "optimize"];
+export type ContentListWorkflowId = (typeof CONTENT_LIST_WORKFLOW_IDS)[number];
+export type ContentListWorkflowExecution = 'foreground' | 'background';
+export type ContentListWorkflowConfirmation = 'required' | 'none';
+export interface ContentListWorkflowDescriptor {
+    id: ContentListWorkflowId;
+    label: string;
+    description: string;
+    selectionScopes: Array<'current-page' | 'explicit-ids' | 'all-matching'>;
+    sensitivity: 'public' | 'sensitive';
+    confirmation: ContentListWorkflowConfirmation;
+    execution: ContentListWorkflowExecution;
+    inputSchema: DataSurfaceJsonObject | null;
+    eligibility: string[];
+    permissionRequirements: {
+        tool: string;
+        operations: Array<{
+            id: string;
+            collection: string;
+            action: string;
+        }>;
+    };
+    consequences: string[];
+    partialResult: {
+        statuses: Array<'accepted' | 'skipped' | 'failed'>;
+        preservesFailedSelection: true;
+    };
+}
+export declare const CONTENT_LIST_WORKFLOWS: readonly ContentListWorkflowDescriptor[];
+export interface ContentListActionTarget {
+    /** Canonical query sent to the content query endpoint. Required except for explicit IDs. */
+    query?: DataQueryRequest;
+    /** Count visible at selection time; drift fails the preview/apply. */
+    expectedCount: number;
+}
+export interface ContentListActionRequest extends DataSurfaceServerActionRequest {
+    actionId: ContentListWorkflowId;
+    target: ContentListActionTarget;
+}
+export interface ContentListActionCollection extends ContentQueryCollection {
+    get(filter: string | Record<string, unknown>): Promise<Content | null>;
+}
+/**
+ * Persistence-free copy supplied to host format/optimize handlers.
+ *
+ * Only the explicitly copied mutable fields are applied back to Content before
+ * the adapter's revision-guarded save. Identity, tenancy, lifecycle state,
+ * relationship IDs, database handles, and Content persistence methods are
+ * deliberately absent.
+ */
+export interface ContentListWorkflowDraft {
+    readonly contentId: string;
+    readonly tenantId: string | null;
+    readonly type: string | null;
+    readonly variant: string | null;
+    readonly status: Content['status'];
+    readonly state: Content['state'];
+    fileKey: string | null;
+    author: string | null;
+    name: string;
+    title: string;
+    description: string | null;
+    body: string;
+    bodyFormat: ContentBodyFormat | null;
+    publish_date: Date | null;
+    url: string | null;
+    source: string | null;
+    original_url: string | null;
+    language: string | null;
+    tags: string[];
+    category: string | null;
+    metadata: Record<string, unknown>;
+    thumbnailAssetId: string | null;
+}
+export interface ContentListWorkflowHandlers {
+    /** Mutate a persistence-free draft; the adapter applies it by revision CAS. */
+    formatBody?: (content: ContentListWorkflowDraft, payload: DataSurfaceJsonValue | undefined, run: PrincipalRun) => Promise<void>;
+    /** Mutate a persistence-free draft; the adapter applies it by revision CAS. */
+    optimize?: (content: ContentListWorkflowDraft, payload: DataSurfaceJsonValue | undefined, run: PrincipalRun) => Promise<void>;
+}
+export interface ContentListWorkflowStorage {
+    adapterType: 'sqlite' | 'postgres' | 'duckdb' | 'json';
+    writeStrategy?: 'immediate' | 'manual' | 'none';
+}
+export declare class UnsupportedContentListWorkflowStorageError extends Error {
+    readonly code = "UNSUPPORTED_CONTENT_LIST_WORKFLOW_STORAGE";
+    constructor(storage: ContentListWorkflowStorage);
+}
+export declare function assertContentListWorkflowStorageSupported(storage: ContentListWorkflowStorage): void;
+export interface ContentListActionAdapterOptions {
+    /** Public adapter capability contract; validated before any workflow state is created. */
+    workflowStorage: ContentListWorkflowStorage;
+    state: DataSurfaceActionStateStore;
+    collection(run: PrincipalRun): ContentListActionCollection | Promise<ContentListActionCollection>;
+    /** Trusted site/organization narrowing, applied in addition to tenant context. */
+    scope?: (run: PrincipalRun) => ContentQueryScope | undefined | Promise<ContentQueryScope | undefined>;
+    /** Server-owned mounted/catalog revision. Defaults to zero for standalone endpoints. */
+    revision?: (run: PrincipalRun, identity: DataSurfaceIdentity) => number | Promise<number>;
+    authorize?: (workflow: ContentListWorkflowId, run: PrincipalRun) => boolean | Promise<boolean>;
+    handlers?: ContentListWorkflowHandlers;
+    backgroundQueue?: DataSurfaceBackgroundQueue;
+    descriptor?: DataSurfaceDescriptor;
+    maxSelectionSize?: number;
+    representativeLimit?: number;
+    tokenTtlMs?: number;
+    /** Test/host seam for principal execution; production defaults to executeAsPrincipal. */
+    runAsPrincipal?: typeof import('@happyvertical/smrt-agents').executeAsPrincipal;
+    /** Resolve the live persona/TenantAgent binding before a queued mutation. */
+    resolveDeferredPrincipal?: Parameters<typeof createDataSurfaceActionAdapter>[0]['resolveDeferredPrincipal'];
+}
+export interface ContentListActionAdapter extends DataSurfaceActionAdapter {
+    preview(request: ContentListActionRequest, context: DataSurfaceServerActionContext): Promise<DataSurfaceActionResult>;
+    apply(request: ContentListActionRequest, context: DataSurfaceServerActionContext): Promise<DataSurfaceActionResult>;
+}
+export declare function createContentListActionAdapter(options: ContentListActionAdapterOptions): ContentListActionAdapter;
+//# sourceMappingURL=content-list-actions.d.ts.map

package/dist/server/content-list-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-list-actions.d.ts","sourceRoot":"","sources":["../../src/server/content-list-actions.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+declare function startServer(): Promise<{
+    shutdown: () => Promise<void>;
+}>;
+export * from './server/content-list-actions.js';
+export { startServer };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,wBAAwB,CAAC;AAGhC,iBAAe,WAAW;;GA+BzB;AAOD,cAAc,kCAAkC,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,CAAC"}