openxiangda-contracts 2.47.0 → 2.63.0

package/dist/surface.d.ts

@@ -1,4 +1,5 @@
 import type { DataFieldOption } from './field-values.js';
+import type { DataFieldUserCandidates } from './native-compiler/user-candidates.js';
 import type { DataFieldResourceSource } from './references.js';
 import type { DataFieldType, DataRangeBoundary } from './types.js';
 /**
@@ -37,6 +38,7 @@ export interface DataFieldSurface {
     searchable?: boolean;
     sortable?: boolean;
     source?: DataFieldResourceSource;
+    userCandidates?: DataFieldUserCandidates;
     timePrecision?: 'minute' | 'second';
     serial?: {
         prefix?: string;
@@ -141,6 +143,5 @@ export interface DataResourceViewSurface {
         fields: string[];
     }[];
 }
-/** Resolve a named presentation without changing field access or storage facts. */
-export declare function projectDataResourceView(surface: DataResourceSurface, viewCode?: string): DataResourceSurface;
+export { projectDataResourceView } from './native-compiler/resource-view.js';
 //# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

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

package/dist/surface.js

@@ -1,20 +1,2 @@
-/** Resolve a named presentation without changing field access or storage facts. */
-export function projectDataResourceView(surface, viewCode) {
-    if (viewCode === undefined)
-        return surface;
-    const view = surface.views?.find(item => item.code === viewCode);
-    if (!view)
-        throw new Error(`DATA_RESOURCE_VIEW_NOT_FOUND: ${viewCode}`);
-    const sections = new Map(view.sections?.flatMap(section => section.fields.map(code => [code, section.title])));
-    const { views: _views, ...base } = surface;
-    return {
-        ...base, generated: view.generated, list: view.list, form: view.form,
-        detail: view.detail, mobile: view.mobile,
-        fields: Object.fromEntries(Object.entries(surface.fields).map(([code, field]) => {
-            const { section: _section, ...baseField } = field;
-            const section = sections.get(code);
-            return [code, { ...baseField, ...(section ? { section } : {}), list: view.list.fieldOrder?.includes(code) ?? false }];
-        })),
-    };
-}
+export { projectDataResourceView } from './native-compiler/resource-view.js';
 //# sourceMappingURL=surface.js.map

package/dist/surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAgKA,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CAAC,OAA4B,EAAE,QAAiB;IACrF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAU,CAAC,CAAC,CAAC,CAAC;IACxH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3C,OAAO;QACL,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI;QACpE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;QACxC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;YAC9E,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;YAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QACxH,CAAC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAkKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/types.d.ts

@@ -1,7 +1,8 @@
 import { PLATFORM_CAPABILITY_CONTRACT_VERSIONS } from "./native-version.js";
 export { OPENXIANGDA_COMPILER_CONTRACT_VERSION, PLATFORM_CAPABILITY_CONTRACT_VERSIONS } from "./native-version.js";
-import type { DataResourceSurface } from "./surface.js";
+import type { DataFieldSurface, DataResourceSurface } from "./surface.js";
 import type { CascadePathValue, DataFieldOption, DateRangeValue, DepartmentReferenceValue, LabeledValue, ManagedImageValue, ResourceReferenceValue, StableAddressValue, StableLocationValue, StableSignatureValue, UserReferenceValue } from "./field-values.js";
+import type { DataFieldUserCandidates } from './native-compiler/user-candidates.js';
 import type { DataFieldResourceSource } from "./references.js";
 import type { WorkflowBusinessData } from "./workflow-summary.js";
 import type { WorkflowBusinessDetail } from "./workflow-detail.js";
@@ -54,6 +55,8 @@ export declare const SCHEMA_VERSIONS: {
     readonly nativeScopeValuePage: "openxiangda.native-scope-value-page/v2";
     readonly dataFieldSourceQuery: "openxiangda.data-field-source-query/v2";
     readonly dataFieldSourcePage: "openxiangda.data-field-source-page/v2";
+    readonly userCandidatesQuery: "openxiangda.user-candidates-query/v2";
+    readonly userCandidatesPage: "openxiangda.user-candidates-page/v2";
     readonly dataRef: "openxiangda.data-ref/v2";
     readonly dataResource: "openxiangda.data-resource/v2";
     readonly dataQuery: "openxiangda.data-query/v2";
@@ -106,6 +109,7 @@ export declare const SCHEMA_VERSIONS: {
     readonly workflowAssigneeRequest: "openxiangda.workflow-assignee-request/v2.1";
     readonly workflowAssigneeResponse: "openxiangda.workflow-assignee-response/v2";
     readonly businessProcessCommit: "openxiangda.business-process.commit/v2";
+    readonly businessProcessCommandWithData: "openxiangda.business-process-command-with-data/v2";
     readonly standardProcessCommit: "openxiangda.standard-process.commit/v2";
     readonly businessProcessCommand: "openxiangda.business-process.command/v2";
     readonly businessProcessReceipt: "openxiangda.business-process-receipt/v2";
@@ -324,6 +328,8 @@ export interface CurrentInitiatorDirectorySnapshot {
     userId: string;
     displayName?: string;
     employeeNumber?: string | null;
+    /** Only present when a verified current-initiator operation declares phone. */
+    phone?: string | null;
     primaryDepartment?: {
         value: string;
         label: string;
@@ -335,7 +341,7 @@ export interface CurrentInitiatorDirectorySnapshot {
     snapshotRevision: Sha256Digest;
     resolvedAt: IsoDateTime;
 }
-export interface SelectedUserDirectorySnapshot extends Omit<CurrentInitiatorDirectorySnapshot, "schemaVersion"> {
+export interface SelectedUserDirectorySnapshot extends Omit<CurrentInitiatorDirectorySnapshot, "schemaVersion" | "phone"> {
     schemaVersion: "openxiangda.selected-user-directory-snapshot/v2";
 }
 /** Query hints only; revalidate the selected member in the committing transaction. */
@@ -422,6 +428,16 @@ export interface NativeScopeDimensionApplicability {
     roleCodes: string[];
     unrestrictedRoleCodes: string[];
     rules: NativeScopeDimensionApplicabilityRule[];
+    /** Scoped candidate fields are independent of CRUD policy applicability. */
+    candidateFields?: Array<{
+        dataLogicalRevisionId: string;
+        resourceCode: string;
+        fieldCode: string;
+        roleCode: string;
+        operation: string;
+    }>;
+    /** Effective scoped workflow duties; does not grant ordinary data access. */
+    workflowBindings?: Array<Pick<WorkflowRoleReference, 'workflowCode' | 'nodeId' | 'roleCode' | 'definitionVersion' | 'bindingVersion' | 'configurationRevision' | 'source' | 'contexts'>>;
 }
 export interface NativeAuthorizationManagementScopeDimension {
     code: string;
@@ -1007,6 +1023,11 @@ export interface DataFieldSourceLaunchBinding {
     workflowCode: string;
     operationCode: string;
 }
+export interface DataRecordEditInput {
+    operationCode: string;
+    recordId: string;
+    expectedRevision: number;
+}
 export interface DataFieldSourceQuery {
     schemaVersion: typeof SCHEMA_VERSIONS.dataFieldSourceQuery;
     operation: "create" | "update";
@@ -1016,6 +1037,7 @@ export interface DataFieldSourceQuery {
     bindings?: Record<string, unknown>;
     /** 正式流程发起意图；平台核验字段绑定和动作能力，目标仍按当前用户读取。 */
     launch?: DataFieldSourceLaunchBinding;
+    action?: DataRecordEditInput;
 }
 export interface DataFieldSourcePage {
     schemaVersion: typeof SCHEMA_VERSIONS.dataFieldSourcePage;
@@ -1027,6 +1049,50 @@ export interface DataFieldSourcePage {
     items: ResourceReferenceValue[];
     nextCursor: string | null;
 }
+/** Candidate scope is owned by the field declaration and saved record/task. */
+export interface UserCandidateSearch {
+    schemaVersion: typeof SCHEMA_VERSIONS.userCandidatesQuery;
+    keyword?: string;
+    cursor?: string;
+    selectedIds?: string[];
+}
+export type DataFieldUserCandidateQuery = UserCandidateSearch & {
+    launch?: DataFieldSourceLaunchBinding;
+    action?: DataRecordEditInput;
+} & ({
+    operation: 'create';
+    recordId?: never;
+    expectedRevision?: never;
+} | {
+    operation: 'update';
+    recordId: string;
+    expectedRevision: number;
+});
+export interface WorkflowTaskUserCandidateQuery extends UserCandidateSearch {
+    expectedRevision: number;
+    expectedTaskVersion: number;
+}
+export interface UserCandidatePage {
+    schemaVersion: typeof SCHEMA_VERSIONS.userCandidatesPage;
+    resourceCode: string;
+    fieldCode: string;
+    environmentHeadRevision: number;
+    recordRevision?: number;
+    evaluatedAt: IsoDateTime;
+    items: Array<{
+        value: string;
+        label: string;
+    }>;
+    selected: Array<{
+        value: string;
+        label: string;
+        status: 'valid';
+    } | {
+        value: string;
+        status: 'invalid';
+    }>;
+    nextCursor: string | null;
+}
 export interface DataRef {
     schemaVersion: typeof SCHEMA_VERSIONS.dataRef;
     appCode: string;
@@ -1047,6 +1113,8 @@ export interface DataFieldDefinition {
     options?: DataFieldOption[];
     /** Dynamic same-application source for resource-reference fields. */
     source?: DataFieldResourceSource;
+    /** Authoritative role membership constraint for user references. */
+    userCandidates?: DataFieldUserCandidates;
     maxLength?: number;
     precision?: number;
     scale?: number;
@@ -1121,6 +1189,10 @@ export type DataUniqueKeyCondition = {
     fieldCode: string;
     operator: 'in' | 'notIn';
     values: string[];
+} | {
+    fieldCode: string;
+    operator: 'eq' | 'ne';
+    value: boolean;
 };
 export interface DataUniqueKey {
     code: string;
@@ -1143,6 +1215,23 @@ export interface DataResource {
     invariants?: DataResourceInvariant[];
     decimalReservationLifecycle?: DataDecimalReservationLifecycle;
     uniqueKeys?: DataUniqueKey[];
+    /** Explicit business-viewer history policy; absence and empty read disable it. */
+    workflowHistory?: {
+        read: string[];
+    };
+    /** Independent same-membership record printing policy; omission disables it. */
+    recordPrint?: {
+        read: string[];
+    };
+    /** Independent same-membership collaboration; omission disables comments. */
+    recordComments?: {
+        read: string[];
+        create: string[];
+    };
+    /** Explicit same-membership authority to delete a record and its workflow. */
+    recordDeletion?: {
+        delete: string[];
+    };
     /** Default UI metadata projected with the authoritative Data Resource. */
     surface?: DataResourceSurface;
     capabilities: {
@@ -1158,6 +1247,74 @@ export interface DataResource {
     createdAt?: IsoDateTime;
     updatedAt?: IsoDateTime;
 }
+/** Platform-owned append-only comment, independent of business edits and workflow opinions. */
+/** Explicit record permission; opaque previews never expose another instance or its participants. */
+export interface DataRecordDeletionPreview {
+    schemaVersion: 'openxiangda.data-record-deletion-preview/v1';
+    resourceCode: string;
+    resourceName: string;
+    recordId: string;
+    appVersionId: string;
+    environmentHeadRevision: number;
+    recordRevision: number;
+    affectedRecords: number;
+    workflowCount: number;
+    pendingLaunchCount: number;
+    cancelledTaskCount: number;
+    canCommit: boolean;
+    blocker?: 'pending_launch' | 'multiple_workflows' | 'owned_workflow';
+    receiptOwner?: 'native-transaction' | 'workflow-command';
+    previewToken?: string;
+    expiresAt?: IsoDateTime;
+}
+export interface DataRecordDeletionMutation {
+    schemaVersion: 'openxiangda.data-record-deletion-request/v1';
+    previewToken: string;
+    idempotencyKey: string;
+    reason: string;
+}
+/** Projection over an existing Native transaction or Workflow command receipt. */
+export interface DataRecordDeletionReceipt {
+    schemaVersion: 'openxiangda.data-record-deletion-receipt/v1';
+    resourceCode: string;
+    recordId: string;
+    idempotencyKey: string;
+    receiptOwner: 'native-transaction' | 'workflow-command';
+    receiptId: string;
+    deleted: boolean;
+    replayed: boolean;
+    errorCode?: string;
+}
+export interface DataRecordComment {
+    id: string;
+    body: string;
+    authorUserId: string;
+    isOwn: boolean;
+    createdAt: IsoDateTime;
+    appVersionId: string;
+    environmentHeadRevision: number;
+}
+export interface DataRecordCommentPage {
+    schemaVersion: 'openxiangda.data-record-comments/v1';
+    resourceCode: string;
+    recordId: string;
+    items: DataRecordComment[];
+    nextCursor: string | null;
+    limit: number;
+}
+export interface DataRecordCommentMutation {
+    schemaVersion: 'openxiangda.data-record-comment-create/v1';
+    body: string;
+    idempotencyKey: string;
+}
+export interface DataRecordCommentReceipt {
+    schemaVersion: 'openxiangda.data-record-comment-receipt/v1';
+    resourceCode: string;
+    recordId: string;
+    idempotencyKey: string;
+    comment: DataRecordComment;
+    replayed: boolean;
+}
 export type DataQueryOperator = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "contains" | "startsWith" | "endsWith" | "in" | "between" | "has" | "hasAny" | "hasAll" | "overlaps" | "containedBy" | "jsonContains" | "isEmpty" | "isNotEmpty";
 export type DataWhere = {
     and: DataWhere[];
@@ -1231,6 +1388,22 @@ export interface DataBatchQueryResult<T extends Record<string, unknown> = Record
     schemaVersion: typeof SCHEMA_VERSIONS.dataBatchQueryResult;
     results: DataBatchQueryItemResult<T>[];
 }
+/** A bounded current-user print projection, without commands or permission metadata. */
+export interface DataRecordPrint {
+    schemaVersion: "openxiangda.data-record-print/v1";
+    resourceCode: string;
+    resourceName: string;
+    recordId: string;
+    viewCode?: string;
+    viewName?: string;
+    appVersionId: string;
+    environmentHeadRevision: number;
+    preparedAt: IsoDateTime;
+    fields: Array<Pick<DataFieldSurface, "label" | "type" | "widget" | "section" | "options" | "rangeBoundary" | "timePrecision"> & {
+        code: string;
+    }>;
+    data: Record<string, unknown>;
+}
 export interface DataRecord<T extends Record<string, unknown> = Record<string, unknown>> {
     schemaVersion: typeof SCHEMA_VERSIONS.dataRecord;
     resourceCode: string;
@@ -1541,7 +1714,7 @@ export interface CloudEvent<TData extends Record<string, unknown> = Record<strin
 }
 export declare const DATA_EVENT_TYPES_V2: readonly ["openxiangda.data.record.created.v2", "openxiangda.data.record.updated.v2", "openxiangda.data.record.deleted.v2"];
 export type DataEventTypeV2 = (typeof DATA_EVENT_TYPES_V2)[number];
-export declare const WORKFLOW_EVENT_TYPES_V2: readonly ["openxiangda.workflow.step.requested.v2", "openxiangda.workflow.step.result_received.v2", "openxiangda.workflow.step.completed.v2", "openxiangda.workflow.step.continuation_failed.v2", "openxiangda.workflow.instance.started.v2", "openxiangda.workflow.instance.completed.v2", "openxiangda.workflow.instance.rejected.v2", "openxiangda.workflow.instance.returned.v2", "openxiangda.workflow.instance.resumed.v2", "openxiangda.workflow.instance.withdrawn.v2", "openxiangda.workflow.instance.terminated.v2", "openxiangda.workflow.instance.cc_added.v2", "openxiangda.workflow.task.created.v2", "openxiangda.workflow.task.assigned.v2", "openxiangda.workflow.task.assignment_pending.v2", "openxiangda.workflow.task.assignment_resolution_failed.v2", "openxiangda.workflow.task.approved.v2", "openxiangda.workflow.task.completed.v2", "openxiangda.workflow.task.rejected.v2", "openxiangda.workflow.task.returned.v2", "openxiangda.workflow.task.resubmitted.v2", "openxiangda.workflow.task.transferred.v2", "openxiangda.workflow.task.reassigned.v2", "openxiangda.workflow.task.delegated.v2", "openxiangda.workflow.task.assignee_added.v2", "openxiangda.workflow.task.cancelled.v2", "openxiangda.workflow.participant.activated.v2", "openxiangda.workflow.participant.completed.v2", "openxiangda.workflow.participant.rejected.v2", "openxiangda.workflow.participant.returned.v2", "openxiangda.workflow.participant.transferred.v2", "openxiangda.workflow.participant.reassigned.v2", "openxiangda.workflow.participant.delegated.v2", "openxiangda.workflow.participant.added.v2", "openxiangda.workflow.participant.suspended.v2", "openxiangda.workflow.participant.resumed.v2", "openxiangda.workflow.participant.cancelled.v2"];
+export declare const WORKFLOW_EVENT_TYPES_V2: readonly ["openxiangda.workflow.node.skipped.v2", "openxiangda.workflow.step.requested.v2", "openxiangda.workflow.step.result_received.v2", "openxiangda.workflow.step.completed.v2", "openxiangda.workflow.step.continuation_failed.v2", "openxiangda.workflow.instance.started.v2", "openxiangda.workflow.instance.completed.v2", "openxiangda.workflow.instance.rejected.v2", "openxiangda.workflow.instance.returned.v2", "openxiangda.workflow.instance.resumed.v2", "openxiangda.workflow.instance.withdrawn.v2", "openxiangda.workflow.instance.terminated.v2", "openxiangda.workflow.instance.cc_added.v2", "openxiangda.workflow.task.created.v2", "openxiangda.workflow.task.assigned.v2", "openxiangda.workflow.task.assignment_pending.v2", "openxiangda.workflow.task.assignment_resolution_failed.v2", "openxiangda.workflow.task.approved.v2", "openxiangda.workflow.task.completed.v2", "openxiangda.workflow.task.rejected.v2", "openxiangda.workflow.task.returned.v2", "openxiangda.workflow.task.resubmitted.v2", "openxiangda.workflow.task.transferred.v2", "openxiangda.workflow.task.reassigned.v2", "openxiangda.workflow.task.delegated.v2", "openxiangda.workflow.task.assignee_added.v2", "openxiangda.workflow.task.cancelled.v2", "openxiangda.workflow.participant.activated.v2", "openxiangda.workflow.participant.completed.v2", "openxiangda.workflow.participant.rejected.v2", "openxiangda.workflow.participant.returned.v2", "openxiangda.workflow.participant.transferred.v2", "openxiangda.workflow.participant.reassigned.v2", "openxiangda.workflow.participant.delegated.v2", "openxiangda.workflow.participant.added.v2", "openxiangda.workflow.participant.suspended.v2", "openxiangda.workflow.participant.resumed.v2", "openxiangda.workflow.participant.cancelled.v2"];
 export type WorkflowEventTypeV2 = (typeof WORKFLOW_EVENT_TYPES_V2)[number];
 export type EventProducerKind = "data" | "app" | "workflow" | "timer" | "date" | "system";
 export interface EventCatalogEntry {
@@ -1839,6 +2012,10 @@ export interface WorkflowApprovalNode {
     title: string;
     binding: string;
     mode: WorkflowApprovalMode;
+    /** Code-owned. Omitted means block; skip requires a verified empty supported source. */
+    emptyPolicy?: "block" | "skip";
+    /** Code-owned. Only a direct active initiator seat can be automatically approved. */
+    initiatorApprovalPolicy?: "manual" | "auto_approve";
     onApprove: string;
     onReject: string;
     allowedOperations?: WorkflowCommand[];
@@ -1858,7 +2035,7 @@ export type WorkflowConfigurableOperation = 'approve' | 'reject' | 'return' | 't
 export type WorkflowConfigurableAssigneeProvider = 'fixed_users' | 'app_role' | 'app_role_in_scope';
 export interface WorkflowNodeOperationPolicy {
     label?: string;
-    /** Only approve/reject have comments; existing required reasons stay required. */
+    /** Approve defaults to false, reject to true; explicit false is code-owned. Other required reasons stay required. */
     commentRequired?: boolean;
 }
 export interface WorkflowApprovalAdministration {
@@ -1904,7 +2081,11 @@ export interface WorkflowDefinition {
     title: string;
     acceptedCommandDeactivationPolicy: "finish-pinned" | "cancel-on-deactivate";
     subject: WorkflowSubjectDefinition;
+    commandHandlers?: import('./native-compiler/workflow-business-command.js').WorkflowCommandHandlers;
+    launchPreflight?: import('./native-compiler/workflow-launch-preflight.js').WorkflowLaunchPreflight;
     instanceCommands?: WorkflowInstanceCommandPolicies;
+    /** Code-owned, frozen at rejection using the subject's last successful business writer. */
+    rejectionNotification?: import('./native-compiler/workflow-rejection-notification.js').WorkflowRejectionNotification;
     startAt: string;
     inputSchema: Record<string, unknown> & {
         type: "object";
@@ -1928,7 +2109,8 @@ export interface WorkflowDefinition {
 }
 export interface WorkflowInstanceCommandPolicies {
     withdraw?: {
-        beforeFact: string;
+        beforeFact?: string;
+        reasonRequired?: boolean;
     };
     terminate?: {
         capability: string;
@@ -1944,6 +2126,8 @@ export interface WorkflowSubjectDefinition {
 export type WorkflowBindingProvider = "fixed_users" | "initiator" | "input_users" | "form_field_users" | "department_supervisor" | "app_role" | "app_role_in_scope" | "business_relation" | "previous_node_actor" | "initiator_select" | "application_provider";
 export interface WorkflowBindingEntry {
     provider: WorkflowBindingProvider;
+    /** Reference to the constrained subject field; role/scope remain declared once. */
+    candidateField?: string;
     users?: string[];
     inputPath?: string;
     departmentIdFrom?: string;
@@ -2045,9 +2229,11 @@ export interface WorkflowRoleReference {
     configurationRevision: number;
     contexts: Array<'active' | 'in_flight'>;
     source: 'default_binding' | 'node_override' | 'routing_source';
-    provider: 'app_role' | 'app_role_in_scope';
+    provider: 'app_role' | 'app_role_in_scope' | 'form_field_users';
     routingSourceCode?: string;
     scopeDimensionCode?: string;
+    candidateField?: string;
+    dataLogicalRevisionId?: string;
 }
 export interface WorkflowRoleReferencePage {
     schemaVersion: typeof SCHEMA_VERSIONS.workflowRoleReferencePage;
@@ -2127,6 +2313,8 @@ export interface WorkflowNodeConfigurations {
             title: string;
             binding?: WorkflowBindingEntry;
             mode?: WorkflowApprovalMode;
+            emptyPolicy?: "block" | "skip";
+            initiatorApprovalPolicy?: "manual" | "auto_approve";
             allowedOperations?: WorkflowCommand[];
             operationPolicy?: Partial<Record<WorkflowConfigurableOperation, WorkflowNodeOperationPolicy>>;
             fieldPolicy?: WorkflowApprovalNode['fieldPolicy'];
@@ -2140,6 +2328,8 @@ export interface WorkflowNodeConfigurations {
             binding?: WorkflowBindingEntry;
             bindingDigest?: string;
             mode?: WorkflowApprovalMode;
+            emptyPolicy?: "block" | "skip";
+            initiatorApprovalPolicy?: "manual" | "auto_approve";
             allowedOperations?: WorkflowCommand[];
             operationPolicy?: Partial<Record<WorkflowConfigurableOperation, WorkflowNodeOperationPolicy>>;
             fieldPolicy?: WorkflowApprovalNode['fieldPolicy'];
@@ -2621,6 +2811,8 @@ export interface WorkflowOperationSurface {
         method: "POST";
         href: string;
         idempotencyRequired: boolean;
+        /** Fixed Workflow handler; shared client uses the current immutable app operation surface. */
+        operationCode?: string;
     };
     refresh: string[];
 }
@@ -2679,6 +2871,36 @@ export interface WorkflowCommandInput {
     idempotencyKey: string;
     input?: Record<string, unknown>;
 }
+/** Original Workflow authority and exact subject CAS from the shared Surface client. */
+export interface WorkflowBusinessCommandInvocation extends WorkflowCommandInput {
+    workflowCode: string;
+    target: {
+        kind: 'task';
+        id: string;
+        command: 'approve' | 'reject';
+    } | {
+        kind: 'instance';
+        id: string;
+        command: 'withdraw';
+    };
+    recordId: string;
+    expectedRevision: number;
+}
+/** A verified Named Action combines business effects with the original Workflow decision. */
+export interface BusinessProcessCommandWithData {
+    schemaVersion: typeof SCHEMA_VERSIONS.businessProcessCommandWithData;
+    environmentKey: DeploymentEnvironment;
+    workflow: WorkflowBusinessCommandInvocation;
+    subject: {
+        fromOperation: string;
+    };
+    data: BusinessProcessCommit['data'];
+    expectedTransition: {
+        status: 'running' | 'approved' | 'rejected' | 'withdrawn';
+        outcome: string | null;
+        currentNodeId: string | null;
+    };
+}
 /**
  * Result returned by a task or instance Workflow command.
  *
@@ -2758,7 +2980,7 @@ export interface WorkflowTimelineFlowItem {
     nodeId: string | null;
     kind: "start" | WorkflowNode["kind"];
     title: string;
-    status: "completed" | "active" | "waiting" | "returned" | "cancelled" | "error";
+    status: "completed" | "skipped" | "active" | "waiting" | "returned" | "cancelled" | "error";
     startedAt: IsoDateTime | null;
     completedAt: IsoDateTime | null;
     assignees: Array<{
@@ -2788,7 +3010,7 @@ export interface WorkflowTimelineItem {
     severity: "normal" | "admin" | "security";
     createdAt: IsoDateTime;
 }
-export type WorkflowTimelineDisplayStatus = "completed" | "active" | "waiting" | "returned" | "rejected" | "withdrawn" | "terminated" | "cancelled" | "error";
+export type WorkflowTimelineDisplayStatus = "completed" | "skipped" | "active" | "waiting" | "returned" | "rejected" | "withdrawn" | "terminated" | "cancelled" | "error";
 export interface WorkflowTimelineDisplayOperation {
     id: string;
     operation: string;
@@ -2817,6 +3039,62 @@ export interface WorkflowTimelineDisplayEntry {
 export interface WorkflowTimelineDisplay {
     entries: WorkflowTimelineDisplayEntry[];
 }
+/** Read-only business history. No facts, raw log detail, tokens or role seats. */
+export interface WorkflowRecordHistoryPerson {
+    userId: string;
+    displayName: string;
+    status: string;
+    outcome: string | null;
+    comment: string | null;
+    completedAt: IsoDateTime | null;
+}
+export interface WorkflowRecordHistoryVisit {
+    id: string;
+    nodeId: string;
+    nodeKind: string;
+    title: string;
+    status: string;
+    enteredAt: IsoDateTime | null;
+    completedAt: IsoDateTime | null;
+    people: WorkflowRecordHistoryPerson[];
+}
+export interface WorkflowRecordHistoryOperation {
+    id: string;
+    nodeVisitId: string | null;
+    operation: string;
+    operationLabel: string;
+    actor: {
+        userId: string;
+        displayName: string;
+    };
+    actingForUserId: string | null;
+    reason: string | null;
+    occurredAt: IsoDateTime | null;
+}
+export interface WorkflowRecordHistory {
+    schemaVersion: 'openxiangda.workflow-record-history/v1';
+    resourceCode: string;
+    recordId: string;
+    recordRevision: number;
+    environmentKey: 'preproduction' | 'production';
+    instance: {
+        id: string;
+        workflowCode: string;
+        version: number;
+        definitionVersionId: string;
+        definitionDigest: string;
+        status: string;
+        eventSequence: number;
+        startedAt: IsoDateTime | null;
+        completedAt: IsoDateTime | null;
+    };
+    visits: WorkflowRecordHistoryVisit[];
+    items: WorkflowRecordHistoryOperation[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
 export interface WorkflowTimeline {
     engineVersion: "2.0";
     instanceId: string;