@happyvertical/smrt-content 0.43.9 → 0.44.0

package/agents/content-list.md

@@ -43,6 +43,75 @@ visible with their error and retry affordance, so error recovery cannot report
 success or refresh as though the action applied. The tracker is exported from
 `@happyvertical/smrt-content/svelte` for the bulk-action slice to reuse rather
 than creating a second pending-state machine.
+## Cross-page bulk workflows (#2453)
+
+Server-backed lists can opt into one shared preview/apply workflow contract for
+human and agent callers. The browser integration is exported from
+`@happyvertical/smrt-content/svelte`; the principal-bound adapter is exported
+from `@happyvertical/smrt-content/server`.
+
+The supported workflows are move to trash, mark draft, submit for review,
+publish, archive, restore, automated review, body formatting, categorization,
+and optimization. Applications inject body-formatting and optimization
+handlers because those AI pipelines are application-owned; the content package
+does not guess a model or rewrite policy.
+
+Important invariants:
+
+- `all-matching` is the canonical server query plus its query fingerprint and
+  exact count. It is never expanded from the IDs loaded in the browser.
+- Preview is read-only and returns the resolved scope, exact count,
+  representative labels, eligibility outcomes, and consequences. Apply uses
+  the opaque preview token and an idempotency key.
+- Apply resolves the query again under the same principal and tenant scope,
+  rechecks tool/operation authorization and eligibility, and compares the
+  aggregate `updated_at` row revision. Every content save also includes that
+  revision in its database `UPDATE`, so an edit racing the final write fails
+  atomically instead of being overwritten. Application formatting/optimization
+  handlers mutate the supplied object but must not call `save()`; the adapter
+  owns the guarded save. Query, count, membership, or row drift returns a stale
+  failure before mutation.
+- Publication-producing workflows require every read used to construct their
+  version snapshot, including `contentassets:read` and `assets:read`. Keep those
+  explicit catalog assertions in sync with `ContentVersion.createSnapshot()`;
+  they are the authorization boundary on adapters without PostgreSQL RLS.
+- Workflow queries must project `id`, `title`, `status`, and `updated_at` so the
+  server can bind labels, eligibility, and row revisions. The standard
+  ContentList query projection already includes them; a host-supplied projection
+  override must retain them.
+- The default workflow cap is 200 rows across explicit, current-page, and
+  all-matching scopes. Set the same `maxSelectionSize` on the server adapter and
+  browser workflow binding when overriding it. The UI does not offer
+  all-matching selection above that cap, and the server returns
+  `limit_exceeded` for forged or agent requests above it.
+- Automated review, formatting, and optimization are background actions. A
+  successful apply returns a job ID; the queue callback repeats the guarded
+  apply, and idempotency prevents duplicate execution. Hosts must supply
+  `resolveDeferredPrincipal` to re-resolve the complete live persona/TenantAgent
+  binding before queued mutations; missing, mismatched, or incomplete bindings
+  fail closed. Hosts can configure the
+  authenticated `jobStatusPath` transport (or supply `client.status`) so the
+  list can keep an identical intent locked while queued/running, reconcile
+  terminal row outcomes, and unlock a failed or cancelled intent for retry.
+  Selection controls are disabled while a status request is in flight, and the
+  captured intent is rechecked before any returned outcomes are reconciled.
+- Foreground results report accepted, skipped, and failed rows separately. The
+  client clears only accepted IDs; a failed request never reports success or
+  clears selection.
+
+`createContentListWorkflowTransport()` supplies the default JSON transport.
+Hosts that already have an RPC layer can instead provide a structural workflow
+client with the same `preview(request)` and `apply(request)` methods, plus the
+optional `status(jobId)` method when background progress is shown. Both paths
+must terminate at the same `createContentListActionAdapter()` instance used by
+agent actions; separate human-only mutation handlers would bypass the shared
+preview and authorization contract.
+
+The server adapter also requires a `workflowStorage` capability declaration.
+PostgreSQL, SQLite, ordinary DuckDB, and non-immediate exported-file modes are
+supported. JSON's default/immediate mode and DuckDB `writeStrategy:
+'immediate'` fail before adapter setup because those SDK modes export writes
+before the surrounding transaction commits and cannot roll the file back.
 
 ## ContentList migration (#2451)
 

package/dist/chunks/content-corrections-BxfA3tW1.js

@@ -0,0 +1,107 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { SmrtCollection, SmrtObject, crossPackageRef, foreignKey, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/content-correction.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var ContentCorrection = class extends SmrtObject {
+	contentId = "";
+	contentVersionId = "";
+	factId = "";
+	replacementFactId = "";
+	correctionType = "fact";
+	status = "draft";
+	summary = "";
+	incorrectText = "";
+	correctedText = "";
+	publicNote = "";
+	metadata = "";
+	tenantId = null;
+	publishedAt = null;
+	createdAt = /* @__PURE__ */ new Date();
+	updatedAt = /* @__PURE__ */ new Date();
+	constructor(options = {}) {
+		super(options);
+		if (options.contentId) this.contentId = options.contentId;
+		if (options.contentVersionId !== void 0) this.contentVersionId = options.contentVersionId;
+		if (options.factId !== void 0) this.factId = options.factId;
+		if (options.replacementFactId !== void 0) this.replacementFactId = options.replacementFactId;
+		if (options.correctionType !== void 0) this.correctionType = options.correctionType;
+		if (options.status !== void 0) this.status = options.status;
+		if (options.summary !== void 0) this.summary = options.summary;
+		if (options.incorrectText !== void 0) this.incorrectText = options.incorrectText;
+		if (options.correctedText !== void 0) this.correctedText = options.correctedText;
+		if (options.publicNote !== void 0) this.publicNote = options.publicNote;
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.publishedAt !== void 0) this.publishedAt = options.publishedAt;
+		if (options.createdAt) this.createdAt = options.createdAt;
+		if (options.updatedAt) this.updatedAt = options.updatedAt;
+		if (options.metadata !== void 0) this.metadata = typeof options.metadata === "string" ? options.metadata : JSON.stringify(options.metadata);
+	}
+	getMetadata() {
+		try {
+			return this.metadata ? JSON.parse(this.metadata) : {};
+		} catch {
+			return {};
+		}
+	}
+};
+__decorateClass([foreignKey("Content", { required: true })], ContentCorrection.prototype, "contentId", 2);
+__decorateClass([foreignKey("ContentVersion")], ContentCorrection.prototype, "contentVersionId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-facts:Fact")], ContentCorrection.prototype, "factId", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-facts:Fact")], ContentCorrection.prototype, "replacementFactId", 2);
+__decorateClass([tenantId({ nullable: true })], ContentCorrection.prototype, "tenantId", 2);
+ContentCorrection = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "content_corrections",
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	mcp: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	cli: true
+})], ContentCorrection);
+//#endregion
+//#region src/content-corrections.ts
+var content_corrections_exports = /* @__PURE__ */ __exportAll({ ContentCorrectionCollection: () => ContentCorrectionCollection });
+var ContentCorrectionCollection = class extends SmrtCollection {
+	static _itemClass = ContentCorrection;
+	async listForContent(contentId) {
+		return this.list({
+			where: { contentId },
+			orderBy: "created_at DESC"
+		});
+	}
+	async getPublishedForContent(contentId) {
+		return this.list({
+			where: {
+				contentId,
+				status: "published"
+			},
+			orderBy: "published_at DESC"
+		});
+	}
+	async issue(options) {
+		if (!options) return this.create({});
+		return this.create({
+			...options,
+			metadata: typeof options.metadata === "string" ? options.metadata : options.metadata ? JSON.stringify(options.metadata) : void 0
+		});
+	}
+};
+//#endregion
+export { content_corrections_exports as n, ContentCorrection as r, ContentCorrectionCollection as t };
+
+//# sourceMappingURL=content-corrections-BxfA3tW1.js.map

package/dist/chunks/content-corrections-BxfA3tW1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-corrections-BxfA3tW1.js","names":[],"sources":["../../src/content-correction.ts","../../src/content-corrections.ts"],"sourcesContent":["import type { SmrtObjectOptions } from '@happyvertical/smrt-core';\nimport {\n  crossPackageRef,\n  foreignKey,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport type {\n  ContentCorrectionStatus,\n  ContentCorrectionType,\n} from './content-governance';\n\nexport interface ContentCorrectionOptions extends SmrtObjectOptions {\n  contentId?: string;\n  contentVersionId?: string;\n  factId?: string;\n  replacementFactId?: string;\n  correctionType?: ContentCorrectionType;\n  status?: ContentCorrectionStatus;\n  summary?: string;\n  incorrectText?: string;\n  correctedText?: string;\n  publicNote?: string;\n  metadata?: string | Record<string, unknown>;\n  tenantId?: string | null;\n  publishedAt?: Date | null;\n  createdAt?: Date;\n  updatedAt?: Date;\n}\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'content_corrections',\n  api: { include: ['list', 'get', 'create', 'update'] },\n  mcp: { include: ['list', 'get', 'create', 'update'] },\n  cli: true,\n})\nexport class ContentCorrection extends SmrtObject {\n  @foreignKey('Content', { required: true })\n  contentId = '';\n\n  @foreignKey('ContentVersion')\n  contentVersionId = '';\n\n  @crossPackageRef('@happyvertical/smrt-facts:Fact')\n  factId = '';\n\n  @crossPackageRef('@happyvertical/smrt-facts:Fact')\n  replacementFactId = '';\n  correctionType: ContentCorrectionType = 'fact';\n  status: ContentCorrectionStatus = 'draft';\n  summary = '';\n  incorrectText = '';\n  correctedText = '';\n  publicNote = '';\n  metadata = '';\n\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  publishedAt: Date | null = null;\n  createdAt = new Date();\n  updatedAt = new Date();\n\n  constructor(options: ContentCorrectionOptions = {}) {\n    super(options);\n    if (options.contentId) this.contentId = options.contentId;\n    if (options.contentVersionId !== undefined)\n      this.contentVersionId = options.contentVersionId;\n    if (options.factId !== undefined) this.factId = options.factId;\n    if (options.replacementFactId !== undefined)\n      this.replacementFactId = options.replacementFactId;\n    if (options.correctionType !== undefined)\n      this.correctionType = options.correctionType;\n    if (options.status !== undefined) this.status = options.status;\n    if (options.summary !== undefined) this.summary = options.summary;\n    if (options.incorrectText !== undefined)\n      this.incorrectText = options.incorrectText;\n    if (options.correctedText !== undefined)\n      this.correctedText = options.correctedText;\n    if (options.publicNote !== undefined) this.publicNote = options.publicNote;\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.publishedAt !== undefined)\n      this.publishedAt = options.publishedAt;\n    if (options.createdAt) this.createdAt = options.createdAt;\n    if (options.updatedAt) this.updatedAt = options.updatedAt;\n\n    if (options.metadata !== undefined) {\n      this.metadata =\n        typeof options.metadata === 'string'\n          ? options.metadata\n          : JSON.stringify(options.metadata);\n    }\n  }\n\n  getMetadata(): Record<string, unknown> {\n    try {\n      return this.metadata ? JSON.parse(this.metadata) : {};\n    } catch {\n      return {};\n    }\n  }\n}\n","import { SmrtCollection } from '@happyvertical/smrt-core';\nimport { ContentCorrection } from './content-correction';\n\nexport class ContentCorrectionCollection extends SmrtCollection<ContentCorrection> {\n  static readonly _itemClass = ContentCorrection;\n\n  async listForContent(contentId: string): Promise<ContentCorrection[]> {\n    return this.list({\n      where: { contentId },\n      orderBy: 'created_at DESC',\n    });\n  }\n\n  async getPublishedForContent(\n    contentId: string,\n  ): Promise<ContentCorrection[]> {\n    return this.list({\n      where: { contentId, status: 'published' },\n      orderBy: 'published_at DESC',\n    });\n  }\n\n  async issue(\n    options: ConstructorParameters<typeof ContentCorrection>[0],\n  ): Promise<ContentCorrection> {\n    if (!options) {\n      return this.create({});\n    }\n\n    return this.create({\n      ...options,\n      metadata:\n        typeof options.metadata === 'string'\n          ? options.metadata\n          : options.metadata\n            ? JSON.stringify(options.metadata)\n            : undefined,\n    });\n  }\n}\n"],"mappings":"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"}