@clidey/whodb-sdk 0.127.1 → 0.127.3

package/README.md

@@ -33,6 +33,16 @@ await users.createMany(rows, { idempotencyKey: 'import-42' });
 await users.update('u_123', { plan: 'pro' });
 const orders = await users.followLink('u_123', 'orders');
 
+// Behavior-managed workflow:
+const order = whodb.ontology('Order');
+const capabilities = await order.capabilities('order_123');
+await order.previewAction('approve', 'order_123', { note: 'Looks good' });
+await order.action('approve', 'order_123', { note: 'Looks good' }, {
+  expectedVersion: capabilities.recordVersion ?? undefined,
+  idempotencyKey: 'approve-order-123',
+});
+const history = await order.actionExecutions('order_123');
+
 // Iterate everything, page by page:
 for await (const page of users.list({ pageSize: 500 }).pages()) {
   console.log(page.rows.length);

package/dist/client.d.ts

@@ -17,9 +17,9 @@ import type { OntologyObjectType, PlatformSource } from './generated/types.js';
  */
 export declare class WhoDB {
     /** SHA-256 of the platform manifest this SDK release was generated from. */
-    static readonly manifestHash = "4b84678f5fe7d777fbd4c4b2a93dff64f4c8951978ce68006ddc3a0e25c6942f";
+    static readonly manifestHash = "3cc0e6ed8d6e928e57d0acaec664df395c36307c8425124270d4a4efa7bfb7a7";
     /** This SDK package's version. */
-    static readonly version = "0.127.1";
+    static readonly version = "0.127.3";
     private readonly transport;
     private readonly httpTransport;
     private readonly filesHandle;

package/dist/generated/hydration.js

@@ -1,4 +1,4 @@
-// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 3cc0e6ed8d6e)
 /** Column-type → coercion kind rules shared across all SDK languages. */
 export const hydrationRules = {
     "int": "int",

package/dist/generated/manifest.d.ts

@@ -7,6 +7,6 @@ export declare const embeddedManifest: Record<string, {
     note?: string;
 }>;
 /** SHA-256 of the platform-manifest.json this SDK was generated from. */
-export declare const manifestHash = "4b84678f5fe7d777fbd4c4b2a93dff64f4c8951978ce68006ddc3a0e25c6942f";
+export declare const manifestHash = "3cc0e6ed8d6e928e57d0acaec664df395c36307c8425124270d4a4efa7bfb7a7";
 /** Manifest protocol version this SDK understands. */
 export declare const manifestProtocolVersion = "1";

package/dist/generated/manifest.js

@@ -1,4 +1,4 @@
-// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 3cc0e6ed8d6e)
 /** Per-operation versioning-policy state embedded at generation time. */
 export const embeddedManifest = {
     "OntologyEntities": {
@@ -34,6 +34,18 @@ export const embeddedManifest = {
     "OntologyFastLookups": {
         "kind": "Query"
     },
+    "OntologyRecordCapabilities": {
+        "kind": "Query"
+    },
+    "PreviewOntologyAction": {
+        "kind": "Query"
+    },
+    "ExecuteOntologyAction": {
+        "kind": "Mutation"
+    },
+    "OntologyActionExecutions": {
+        "kind": "Query"
+    },
     "OntologyAddRow": {
         "kind": "Mutation"
     },
@@ -75,6 +87,6 @@ export const embeddedManifest = {
     }
 };
 /** SHA-256 of the platform-manifest.json this SDK was generated from. */
-export const manifestHash = '4b84678f5fe7d777fbd4c4b2a93dff64f4c8951978ce68006ddc3a0e25c6942f';
+export const manifestHash = '3cc0e6ed8d6e928e57d0acaec664df395c36307c8425124270d4a4efa7bfb7a7';
 /** Manifest protocol version this SDK understands. */
 export const manifestProtocolVersion = '1';

package/dist/generated/operations.d.ts

@@ -1,16 +1,16 @@
 import type { Transport } from '../transport.js';
-import type { Column, Dataset, DatasetQueryResult, OntologyAddRowsResult, OntologyAggregateMetricInput, OntologyCreateRowInput, OntologyDescribeInput, OntologyDescription, OntologyFastLookup, OntologyObjectType, OntologyQueryInput, OntologySimilarInput, OntologySimilarityResult, OntologyStatsResult, Organization, PlatformSource, Project, QueryDatasetInput, RecordInput, RowsResult, SortCondition, SourceObject, SourceObjectKind, SourceObjectRefInput, StatusResponse, WhereCondition, Workspace } from './types.js';
+import type { Column, Dataset, DatasetQueryResult, ExecuteOntologyActionInput, ExecuteOntologyActionResult, OntologyActionExecution, OntologyActionPreview, OntologyAddRowsResult, OntologyAggregateMetricInput, OntologyCreateRowInput, OntologyDescribeInput, OntologyDescription, OntologyFastLookup, OntologyObjectType, OntologyQueryInput, OntologyRecordCapabilities, OntologySimilarInput, OntologySimilarityResult, OntologyStatsResult, Organization, PlatformSource, PreviewOntologyActionInput, Project, QueryDatasetInput, RecordInput, RowsResult, SortCondition, SourceObject, SourceObjectKind, SourceObjectRefInput, StatusResponse, WhereCondition, Workspace } from './types.js';
 export interface OntologyEntitiesVars {
     projectId: string;
 }
-export declare const OntologyEntitiesDocument = "query OntologyEntities($projectId: ID!) { OntologyEntities(projectId: $projectId) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName } } }";
+export declare const OntologyEntitiesDocument = "query OntologyEntities($projectId: ID!) { OntologyEntities(projectId: $projectId) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName targetKind targetReferenceId } } }";
 /** Generated wire call for Query OntologyEntities. */
 export declare function ontologyEntities(transport: Transport, vars: OntologyEntitiesVars): Promise<Array<OntologyObjectType>>;
 export interface OntologyEntityVars {
     projectId: string;
     id: string;
 }
-export declare const OntologyEntityDocument = "query OntologyEntity($projectId: ID!, $id: ID!) { OntologyEntity(projectId: $projectId, id: $id) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName } } }";
+export declare const OntologyEntityDocument = "query OntologyEntity($projectId: ID!, $id: ID!) { OntologyEntity(projectId: $projectId, id: $id) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName targetKind targetReferenceId } } }";
 /** Generated wire call for Query OntologyEntity. */
 export declare function ontologyEntity(transport: Transport, vars: OntologyEntityVars): Promise<OntologyObjectType>;
 export interface OntologyDescribeVars {
@@ -95,6 +95,35 @@ export interface OntologyFastLookupsVars {
 export declare const OntologyFastLookupsDocument = "query OntologyFastLookups($projectId: ID!, $entityId: ID!) { OntologyFastLookups(projectId: $projectId, entityId: $entityId) { id entityId displayName fields status reason createdAt updatedAt } }";
 /** Generated wire call for Query OntologyFastLookups. */
 export declare function ontologyFastLookups(transport: Transport, vars: OntologyFastLookupsVars): Promise<Array<OntologyFastLookup>>;
+export interface OntologyRecordCapabilitiesVars {
+    projectId: string;
+    ontologyId: string;
+    recordKey?: string | null;
+}
+export declare const OntologyRecordCapabilitiesDocument = "query OntologyRecordCapabilities($projectId: ID!, $ontologyId: ID!, $recordKey: String) { OntologyRecordCapabilities(projectId: $projectId, ontologyId: $ontologyId, recordKey: $recordKey) { behaviorVersion recordVersion currentState readableProperties writableProperties actions { apiName allowed denialCode } } }";
+/** Generated wire call for Query OntologyRecordCapabilities. */
+export declare function ontologyRecordCapabilities(transport: Transport, vars: OntologyRecordCapabilitiesVars): Promise<OntologyRecordCapabilities>;
+export interface PreviewOntologyActionVars {
+    input: PreviewOntologyActionInput;
+}
+export declare const PreviewOntologyActionDocument = "query PreviewOntologyAction($input: PreviewOntologyActionInput!) { PreviewOntologyAction(input: $input) { allowed denialCode proposedChanges emittedEvents } }";
+/** Generated wire call for Query PreviewOntologyAction. */
+export declare function previewOntologyAction(transport: Transport, vars: PreviewOntologyActionVars): Promise<OntologyActionPreview>;
+export interface ExecuteOntologyActionVars {
+    input: ExecuteOntologyActionInput;
+}
+export declare const ExecuteOntologyActionDocument = "mutation ExecuteOntologyAction($input: ExecuteOntologyActionInput!) { ExecuteOntologyAction(input: $input) { executionId allowed denialCode recordChanges recordVersion emittedEventIds validationErrors } }";
+/** Generated wire call for Mutation ExecuteOntologyAction. */
+export declare function executeOntologyAction(transport: Transport, vars: ExecuteOntologyActionVars): Promise<ExecuteOntologyActionResult>;
+export interface OntologyActionExecutionsVars {
+    projectId: string;
+    ontologyId: string;
+    recordKey: string;
+    limit?: number | null;
+}
+export declare const OntologyActionExecutionsDocument = "query OntologyActionExecutions($projectId: ID!, $ontologyId: ID!, $recordKey: String!, $limit: Int) { OntologyActionExecutions(projectId: $projectId, ontologyId: $ontologyId, recordKey: $recordKey, limit: $limit) { id ontologyId recordKey actionName behaviorVersionId actorId status resultSummary createdAt } }";
+/** Generated wire call for Query OntologyActionExecutions. */
+export declare function ontologyActionExecutions(transport: Transport, vars: OntologyActionExecutionsVars): Promise<Array<OntologyActionExecution>>;
 export interface OntologyAddRowVars {
     projectId: string;
     entityId: string;
@@ -132,7 +161,7 @@ export declare function ontologyDeleteRow(transport: Transport, vars: OntologyDe
 export interface ProjectDatasetsVars {
     projectId: string;
 }
-export declare const ProjectDatasetsDocument = "query ProjectDatasets($projectId: ID!) { ProjectDatasets(projectId: $projectId) { id projectId sourceId name description schema { name type isNullable isPrimary } schemaMode ownerId rowCount sizeBytes createdAt updatedAt } }";
+export declare const ProjectDatasetsDocument = "query ProjectDatasets($projectId: ID!) { ProjectDatasets(projectId: $projectId) { id projectId sourceId name description schema { name type isNullable isPrimary } schemaMode storageMode ownerId rowCount sizeBytes createdAt updatedAt } }";
 /** Generated wire call for Query ProjectDatasets. */
 export declare function projectDatasets(transport: Transport, vars: ProjectDatasetsVars): Promise<Array<Dataset>>;
 export interface QueryDatasetVars {

package/dist/generated/operations.js

@@ -1,11 +1,11 @@
-// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
-export const OntologyEntitiesDocument = "query OntologyEntities($projectId: ID!) { OntologyEntities(projectId: $projectId) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName } } }";
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 3cc0e6ed8d6e)
+export const OntologyEntitiesDocument = "query OntologyEntities($projectId: ID!) { OntologyEntities(projectId: $projectId) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName targetKind targetReferenceId } } }";
 /** Generated wire call for Query OntologyEntities. */
 export async function ontologyEntities(transport, vars) {
     const data = await transport.execute('OntologyEntities', OntologyEntitiesDocument, vars);
     return data['OntologyEntities'];
 }
-export const OntologyEntityDocument = "query OntologyEntity($projectId: ID!, $id: ID!) { OntologyEntity(projectId: $projectId, id: $id) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName } } }";
+export const OntologyEntityDocument = "query OntologyEntity($projectId: ID!, $id: ID!) { OntologyEntity(projectId: $projectId, id: $id) { id projectId apiName displayName pluralDisplayName description primaryKey sourceId tableName schemaName storageMode provisioningStatus embeddingEnabled embeddingProperties status icon color createdAt updatedAt properties { id apiName displayName description columnName dataType arrayElementType isRequired visibility isSearchable isSortable isEditOnly sortOrder } links { id apiName targetOntologyApiName cardinality foreignKeyProperty targetForeignKeyProperty joinTable sourceColumnInJoinTable targetColumnInJoinTable displayName pluralDisplayName reverseDisplayName targetKind targetReferenceId } } }";
 /** Generated wire call for Query OntologyEntity. */
 export async function ontologyEntity(transport, vars) {
     const data = await transport.execute('OntologyEntity', OntologyEntityDocument, vars);
@@ -65,6 +65,30 @@ export async function ontologyFastLookups(transport, vars) {
     const data = await transport.execute('OntologyFastLookups', OntologyFastLookupsDocument, vars);
     return data['OntologyFastLookups'];
 }
+export const OntologyRecordCapabilitiesDocument = "query OntologyRecordCapabilities($projectId: ID!, $ontologyId: ID!, $recordKey: String) { OntologyRecordCapabilities(projectId: $projectId, ontologyId: $ontologyId, recordKey: $recordKey) { behaviorVersion recordVersion currentState readableProperties writableProperties actions { apiName allowed denialCode } } }";
+/** Generated wire call for Query OntologyRecordCapabilities. */
+export async function ontologyRecordCapabilities(transport, vars) {
+    const data = await transport.execute('OntologyRecordCapabilities', OntologyRecordCapabilitiesDocument, vars);
+    return data['OntologyRecordCapabilities'];
+}
+export const PreviewOntologyActionDocument = "query PreviewOntologyAction($input: PreviewOntologyActionInput!) { PreviewOntologyAction(input: $input) { allowed denialCode proposedChanges emittedEvents } }";
+/** Generated wire call for Query PreviewOntologyAction. */
+export async function previewOntologyAction(transport, vars) {
+    const data = await transport.execute('PreviewOntologyAction', PreviewOntologyActionDocument, vars);
+    return data['PreviewOntologyAction'];
+}
+export const ExecuteOntologyActionDocument = "mutation ExecuteOntologyAction($input: ExecuteOntologyActionInput!) { ExecuteOntologyAction(input: $input) { executionId allowed denialCode recordChanges recordVersion emittedEventIds validationErrors } }";
+/** Generated wire call for Mutation ExecuteOntologyAction. */
+export async function executeOntologyAction(transport, vars) {
+    const data = await transport.execute('ExecuteOntologyAction', ExecuteOntologyActionDocument, vars);
+    return data['ExecuteOntologyAction'];
+}
+export const OntologyActionExecutionsDocument = "query OntologyActionExecutions($projectId: ID!, $ontologyId: ID!, $recordKey: String!, $limit: Int) { OntologyActionExecutions(projectId: $projectId, ontologyId: $ontologyId, recordKey: $recordKey, limit: $limit) { id ontologyId recordKey actionName behaviorVersionId actorId status resultSummary createdAt } }";
+/** Generated wire call for Query OntologyActionExecutions. */
+export async function ontologyActionExecutions(transport, vars) {
+    const data = await transport.execute('OntologyActionExecutions', OntologyActionExecutionsDocument, vars);
+    return data['OntologyActionExecutions'];
+}
 export const OntologyAddRowDocument = "mutation OntologyAddRow($projectId: ID!, $entityId: ID!, $values: [RecordInput!]!) { OntologyAddRow(projectId: $projectId, entityId: $entityId, values: $values) { Status } }";
 /** Generated wire call for Mutation OntologyAddRow. */
 export async function ontologyAddRow(transport, vars) {
@@ -89,7 +113,7 @@ export async function ontologyDeleteRow(transport, vars) {
     const data = await transport.execute('OntologyDeleteRow', OntologyDeleteRowDocument, vars);
     return data['OntologyDeleteRow'];
 }
-export const ProjectDatasetsDocument = "query ProjectDatasets($projectId: ID!) { ProjectDatasets(projectId: $projectId) { id projectId sourceId name description schema { name type isNullable isPrimary } schemaMode ownerId rowCount sizeBytes createdAt updatedAt } }";
+export const ProjectDatasetsDocument = "query ProjectDatasets($projectId: ID!) { ProjectDatasets(projectId: $projectId) { id projectId sourceId name description schema { name type isNullable isPrimary } schemaMode storageMode ownerId rowCount sizeBytes createdAt updatedAt } }";
 /** Generated wire call for Query ProjectDatasets. */
 export async function projectDatasets(transport, vars) {
     const data = await transport.execute('ProjectDatasets', ProjectDatasetsDocument, vars);

package/dist/generated/surface.d.ts

@@ -101,6 +101,38 @@ export declare const surface: {
             readonly rename: {};
             readonly paginated: null;
         };
+        readonly capabilities: {
+            readonly operation: "OntologyRecordCapabilities";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly previewAction: {
+            readonly operation: "PreviewOntologyAction";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly action: {
+            readonly operation: "ExecuteOntologyAction";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
+        readonly actionExecutions: {
+            readonly operation: "OntologyActionExecutions";
+            readonly autofill: {
+                readonly projectId: "$project";
+            };
+            readonly rename: {};
+            readonly paginated: null;
+        };
         readonly create: {
             readonly operation: "OntologyAddRow";
             readonly autofill: {

package/dist/generated/surface.js

@@ -1,4 +1,4 @@
-// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 3cc0e6ed8d6e)
 /** Facade surface mapping generated from sdk/spec/surface.yaml. */
 export const surface = {
     "ontology": {
@@ -102,6 +102,38 @@ export const surface = {
             "rename": {},
             "paginated": null
         },
+        "capabilities": {
+            "operation": "OntologyRecordCapabilities",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "previewAction": {
+            "operation": "PreviewOntologyAction",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "action": {
+            "operation": "ExecuteOntologyAction",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
+        "actionExecutions": {
+            "operation": "OntologyActionExecutions",
+            "autofill": {
+                "projectId": "$project"
+            },
+            "rename": {},
+            "paginated": null
+        },
         "create": {
             "operation": "OntologyAddRow",
             "autofill": {

package/dist/generated/types.d.ts

@@ -1,3 +1,4 @@
+export type ActionExecutionStatus = 'committed' | 'failed' | 'denied';
 export interface AtomicWhereCondition {
     ColumnType: string;
     Key: string;
@@ -30,6 +31,7 @@ export interface Dataset {
     description: string;
     schema: Array<ColumnDef>;
     schemaMode: string;
+    storageMode: string;
     ownerId: string;
     rowCount: number;
     sizeBytes: number;
@@ -41,6 +43,46 @@ export interface DatasetQueryResult {
     rows: Array<Array<string>>;
     total: number;
 }
+export interface ExecuteOntologyActionInput {
+    projectId: string;
+    ontologyId: string;
+    recordKey?: string | null;
+    action: string;
+    values: unknown;
+    expectedVersion?: number | null;
+    idempotencyKey?: string | null;
+}
+export interface ExecuteOntologyActionResult {
+    executionId: string;
+    allowed: boolean;
+    denialCode?: string | null;
+    recordChanges?: unknown | null;
+    recordVersion?: number | null;
+    emittedEventIds?: Array<string> | null;
+    validationErrors?: Array<string> | null;
+}
+export interface OntologyActionCapability {
+    apiName: string;
+    allowed: boolean;
+    denialCode?: string | null;
+}
+export interface OntologyActionExecution {
+    id: string;
+    ontologyId: string;
+    recordKey: string;
+    actionName: string;
+    behaviorVersionId: string;
+    actorId: string;
+    status: ActionExecutionStatus;
+    resultSummary?: unknown | null;
+    createdAt: unknown;
+}
+export interface OntologyActionPreview {
+    allowed: boolean;
+    denialCode?: string | null;
+    proposedChanges?: unknown | null;
+    emittedEvents?: Array<string> | null;
+}
 export interface OntologyAddRowsResult {
     inserted: number;
     ids: Array<string>;
@@ -111,6 +153,8 @@ export interface OntologyLink {
     displayName: string;
     pluralDisplayName: string;
     reverseDisplayName: string;
+    targetKind: string;
+    targetReferenceId?: string | null;
 }
 export type OntologyLinkCardinality = 'ONE_TO_ONE' | 'ONE_TO_MANY' | 'MANY_TO_ONE' | 'MANY_TO_MANY';
 export interface OntologyObjectType {
@@ -181,6 +225,14 @@ export interface OntologyQuerySortInput {
     field: string;
     desc?: boolean | null;
 }
+export interface OntologyRecordCapabilities {
+    behaviorVersion: number;
+    recordVersion?: number | null;
+    currentState?: string | null;
+    readableProperties: Array<string>;
+    writableProperties: Array<string>;
+    actions: Array<OntologyActionCapability>;
+}
 export interface OntologySimilarInput {
     entityId: string;
     rowId: string;
@@ -230,6 +282,13 @@ export interface PlatformSource {
     ingestionError: string;
     eventsReceived: string;
 }
+export interface PreviewOntologyActionInput {
+    projectId: string;
+    ontologyId: string;
+    recordKey?: string | null;
+    action: string;
+    values: unknown;
+}
 export interface Project {
     id: string;
     orgId: string;

package/dist/generated/types.js

@@ -1,2 +1,2 @@
-// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 4b84678f5fe7)
+// GENERATED by sdk/tools/generate-core.mjs — DO NOT EDIT (manifest 3cc0e6ed8d6e)
 export {};

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export type { Row } from './hydrate.js';
 export type { Page } from './pagination.js';
 export { ListCall } from './pagination.js';
 export { OntologyHandle } from './ontology.js';
+export type { ActionOptions } from './ontology.js';
 export { DatasetHandle } from './dataset.js';
 export { SourceHandle } from './source.js';
 export { FilesHandle } from './files.js';

package/dist/index.js

@@ -1,3 +1,18 @@
+/*
+ * Copyright 2026 Clidey, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 export { WhoDB } from './client.js';
 export { IpcTransport } from './transport-ipc.js';
 export { apiKeyProvider, tokenProvider, cliProvider } from './auth.js';

package/dist/ontology.d.ts

@@ -1,5 +1,5 @@
 import type { Transport } from './transport.js';
-import type { OntologyDescription, OntologyFastLookup, OntologyObjectType, OntologyStatsResult, OntologySimilarInput, OntologySimilarityResult, OntologyQueryInput, OntologyQuerySortInput, OntologyAggregateMetricInput, WhereCondition, SortCondition, OntologyAddRowsResult } from './generated/types.js';
+import type { OntologyDescription, OntologyFastLookup, OntologyObjectType, OntologyStatsResult, OntologySimilarInput, OntologySimilarityResult, OntologyQueryInput, OntologyQuerySortInput, OntologyAggregateMetricInput, WhereCondition, SortCondition, OntologyAddRowsResult, ExecuteOntologyActionResult, OntologyActionExecution, OntologyActionPreview, OntologyRecordCapabilities } from './generated/types.js';
 import { type Row } from './hydrate.js';
 import { ListCall } from './pagination.js';
 /** Options for list-shaped ontology reads. `where` is a JSON filter object
@@ -20,6 +20,11 @@ export interface AggregateOptions {
     sort?: SortCondition[];
     pageSize?: number;
 }
+/** Concurrency and retry controls for a named ontology action. */
+export interface ActionOptions {
+    expectedVersion?: number;
+    idempotencyKey?: string;
+}
 /**
  * OntologyHandle is the `whodb.ontology("User")` facade: reads and record
  * writes for one ontology entity, addressed by apiName. Entity metadata is
@@ -60,6 +65,14 @@ export declare class OntologyHandle {
     }): ListCall;
     /** Lists the entity's fast lookups. */
     fastLookups(): Promise<OntologyFastLookup[]>;
+    /** Computes the current actor's readable fields and allowed actions. */
+    capabilities(recordKey?: string | number): Promise<OntologyRecordCapabilities>;
+    /** Dry-runs a named action without persisting records, effects, or events. */
+    previewAction(action: string, recordKey: string | number | null, values?: Record<string, unknown>): Promise<OntologyActionPreview>;
+    /** Executes a named action with full behavior enforcement. */
+    action(action: string, recordKey: string | number | null, values?: Record<string, unknown>, options?: ActionOptions): Promise<ExecuteOntologyActionResult>;
+    /** Lists recent named-action executions for one record. */
+    actionExecutions(recordKey: string | number, limit?: number): Promise<OntologyActionExecution[]>;
     /** Inserts one record. Values are field name/value pairs. */
     create(values: Record<string, unknown>): Promise<void>;
     /** Inserts many records; idempotencyKey makes safe retries possible. */

package/dist/ontology.js

@@ -1,3 +1,18 @@
+/*
+ * Copyright 2026 Clidey, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import * as ops from './generated/operations.js';
 import { hydrateRows, propertyTypesOf } from './hydrate.js';
 import { ListCall } from './pagination.js';
@@ -183,6 +198,57 @@ export class OntologyHandle {
             entityId: entity.id,
         });
     }
+    /** Computes the current actor's readable fields and allowed actions. */
+    async capabilities(recordKey) {
+        const entity = await this.entityMeta();
+        warnIfFlagged('OntologyRecordCapabilities');
+        return ops.ontologyRecordCapabilities(this.transport, {
+            projectId: await this.projectId(),
+            ontologyId: entity.id,
+            recordKey: recordKey === undefined ? null : String(recordKey),
+        });
+    }
+    /** Dry-runs a named action without persisting records, effects, or events. */
+    async previewAction(action, recordKey, values = {}) {
+        const entity = await this.entityMeta();
+        warnIfFlagged('PreviewOntologyAction');
+        return ops.previewOntologyAction(this.transport, {
+            input: {
+                projectId: await this.projectId(),
+                ontologyId: entity.id,
+                recordKey: recordKey === null ? null : String(recordKey),
+                action,
+                values,
+            },
+        });
+    }
+    /** Executes a named action with full behavior enforcement. */
+    async action(action, recordKey, values = {}, options = {}) {
+        const entity = await this.entityMeta();
+        warnIfFlagged('ExecuteOntologyAction');
+        return ops.executeOntologyAction(this.transport, {
+            input: {
+                projectId: await this.projectId(),
+                ontologyId: entity.id,
+                recordKey: recordKey === null ? null : String(recordKey),
+                action,
+                values,
+                expectedVersion: options.expectedVersion ?? null,
+                idempotencyKey: options.idempotencyKey ?? null,
+            },
+        });
+    }
+    /** Lists recent named-action executions for one record. */
+    async actionExecutions(recordKey, limit = 50) {
+        const entity = await this.entityMeta();
+        warnIfFlagged('OntologyActionExecutions');
+        return ops.ontologyActionExecutions(this.transport, {
+            projectId: await this.projectId(),
+            ontologyId: entity.id,
+            recordKey: String(recordKey),
+            limit,
+        });
+    }
     /** Inserts one record. Values are field name/value pairs. */
     async create(values) {
         const entity = await this.entityMeta();

package/dist/transport-ipc.js

@@ -1,3 +1,18 @@
+/*
+ * Copyright 2026 Clidey, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import { request as httpRequest } from 'node:http';
 import { NotFoundError, PlatformError, TransportCapabilityError } from './errors.js';
 /**
@@ -131,6 +146,35 @@ export class IpcTransport {
             pageSize: variables.pageSize,
             offset: variables.pageOffset,
         }),
+        OntologyRecordCapabilities: async (variables) => this.post('/capabilities', {
+            entity: await this.entityName(String(variables.ontologyId)),
+            recordKey: variables.recordKey,
+        }),
+        PreviewOntologyAction: async (variables) => {
+            const input = variables.input ?? {};
+            return this.post('/preview_action', {
+                entity: await this.entityName(String(input.ontologyId)),
+                action: input.action,
+                recordKey: input.recordKey,
+                values: input.values,
+            });
+        },
+        ExecuteOntologyAction: async (variables) => {
+            const input = variables.input ?? {};
+            return this.post('/action', {
+                entity: await this.entityName(String(input.ontologyId)),
+                action: input.action,
+                recordKey: input.recordKey,
+                values: input.values,
+                expectedVersion: input.expectedVersion,
+                idempotencyKey: input.idempotencyKey,
+            });
+        },
+        OntologyActionExecutions: async (variables) => this.post('/action_executions', {
+            entity: await this.entityName(String(variables.ontologyId)),
+            recordKey: variables.recordKey,
+            limit: variables.limit,
+        }),
         OntologyAddRow: async (variables) => {
             await this.post('/create', {
                 entity: await this.entityName(String(variables.entityId)),

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * SDK_VERSION is stamped by the release workflow (sync-versions.mjs) and used
  * only for the User-Agent header — the SDK's sole telemetry.
  */
-export declare const SDK_VERSION = "0.127.1";
+export declare const SDK_VERSION = "0.127.3";

package/dist/version.js

@@ -2,4 +2,4 @@
  * SDK_VERSION is stamped by the release workflow (sync-versions.mjs) and used
  * only for the User-Agent header — the SDK's sole telemetry.
  */
-export const SDK_VERSION = '0.127.1';
+export const SDK_VERSION = '0.127.3';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clidey/whodb-sdk",
-  "version": "0.127.1",
+  "version": "0.127.3",
   "description": "Official WhoDB platform SDK — ontology, datasets, and sources as in-code function APIs",
   "license": "Apache-2.0",
   "type": "module",