@artu-ai/compliance-sdk 0.13.2 → 0.13.4

package/dist/resources/workflow-executions.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Workflow Executions Resource
+ *
+ * Read-only resource manager for workflow execution records.
+ */
+import type { ListOptions, NodeDataResponse, PaginatedResponse, WorkflowExecutionFilter } from "@artu-ai/shared";
+import { WorkflowExecution } from "../models/WorkflowExecution";
+import { ReadOnlyResource } from "./base";
+/**
+ * Read-only resource manager for workflow executions.
+ *
+ * By default, every execution is recorded regardless of outcome.
+ * The React SDK's `WorkflowExecutionsTable` defaults to showing only
+ * matched executions (`matched: { eq: true }`) to reduce noise.
+ * When using the SDK directly, pass the filter explicitly to get
+ * the same behaviour:
+ *
+ * @example
+ * ```typescript
+ * // List only matched executions (recommended default)
+ * const { data } = await sdk.workflows.executions.list({
+ *   filter: { matched: true },
+ * });
+ *
+ * // List all executions (including non-matched) for debugging
+ * const { data: all } = await sdk.workflows.executions.list({
+ *   filter: { workflowId: { eq: workflowId } },
+ * });
+ *
+ * // Retrieve a single execution
+ * const execution = await sdk.workflows.executions.retrieve(executionId);
+ * ```
+ */
+export declare class WorkflowExecutionsResource extends ReadOnlyResource<WorkflowExecution, WorkflowExecutionFilter> {
+    /**
+     * Retrieve a workflow execution by ID.
+     */
+    retrieve(id: string): Promise<WorkflowExecution>;
+    /**
+     * List workflow executions with optional filtering and pagination.
+     */
+    list(options?: ListOptions<WorkflowExecutionFilter, never>): Promise<PaginatedResponse<WorkflowExecution>>;
+    /**
+     * Count workflow executions matching the given filter.
+     */
+    count(filter?: WorkflowExecutionFilter): Promise<number>;
+    /**
+     * Get paginated data rows from a node output in a workflow execution.
+     *
+     * Returns the actual data that flowed through a specific node output handle
+     * during workflow execution, loaded from the stored Parquet snapshot.
+     *
+     * @example
+     * ```typescript
+     * const data = await sdk.workflows.executions.getNodeData({
+     *   executionId: "exec_123",
+     *   nodeId: "node_abc",
+     *   handle: "output",
+     *   limit: 50,
+     *   offset: 0,
+     * });
+     * if (data) {
+     *   console.log(data.columns);   // ["id", "name", "amount"]
+     *   console.log(data.rows);      // [{ id: "1", name: "...", amount: 100 }, ...]
+     *   console.log(data.totalRows); // 42
+     * }
+     * ```
+     */
+    getNodeData(input: {
+        executionId: string;
+        nodeId: string;
+        handle: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<NodeDataResponse | null>;
+}
+//# sourceMappingURL=workflow-executions.d.ts.map

package/dist/resources/workflow-executions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executions.d.ts","sourceRoot":"","sources":["../../src/resources/workflow-executions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,iBAAiB,EAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB,CAC/D,iBAAiB,EACjB,uBAAuB,CACvB;IACA;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOtD;;OAEG;IACG,IAAI,CACT,OAAO,CAAC,EAAE,WAAW,CAAC,uBAAuB,EAAE,KAAK,CAAC,GACnD,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAkBhD;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM9D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,WAAW,CAAC,KAAK,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAKpC"}

package/dist/resources/workflow-executions.js

@@ -0,0 +1,88 @@
+/**
+ * Workflow Executions Resource
+ *
+ * Read-only resource manager for workflow execution records.
+ */
+import { WorkflowExecution, } from "../models/WorkflowExecution";
+import { ReadOnlyResource } from "./base";
+/**
+ * Read-only resource manager for workflow executions.
+ *
+ * By default, every execution is recorded regardless of outcome.
+ * The React SDK's `WorkflowExecutionsTable` defaults to showing only
+ * matched executions (`matched: { eq: true }`) to reduce noise.
+ * When using the SDK directly, pass the filter explicitly to get
+ * the same behaviour:
+ *
+ * @example
+ * ```typescript
+ * // List only matched executions (recommended default)
+ * const { data } = await sdk.workflows.executions.list({
+ *   filter: { matched: true },
+ * });
+ *
+ * // List all executions (including non-matched) for debugging
+ * const { data: all } = await sdk.workflows.executions.list({
+ *   filter: { workflowId: { eq: workflowId } },
+ * });
+ *
+ * // Retrieve a single execution
+ * const execution = await sdk.workflows.executions.retrieve(executionId);
+ * ```
+ */
+export class WorkflowExecutionsResource extends ReadOnlyResource {
+    /**
+     * Retrieve a workflow execution by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.workflows.executions.retrieve.query({ id }));
+        return new WorkflowExecution(response);
+    }
+    /**
+     * List workflow executions with optional filtering and pagination.
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.workflows.executions.list.query({
+            filter: options?.filter,
+            limit: options?.limit,
+            offset: options?.offset,
+            cursor: options?.cursor,
+            includeTotalCount: options?.includeTotalCount,
+        }));
+        return {
+            data: response.data.map((item) => new WorkflowExecution(item)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Count workflow executions matching the given filter.
+     */
+    async count(filter) {
+        return this.execute(() => this.trpc.workflows.executions.count.query({ filter }));
+    }
+    /**
+     * Get paginated data rows from a node output in a workflow execution.
+     *
+     * Returns the actual data that flowed through a specific node output handle
+     * during workflow execution, loaded from the stored Parquet snapshot.
+     *
+     * @example
+     * ```typescript
+     * const data = await sdk.workflows.executions.getNodeData({
+     *   executionId: "exec_123",
+     *   nodeId: "node_abc",
+     *   handle: "output",
+     *   limit: 50,
+     *   offset: 0,
+     * });
+     * if (data) {
+     *   console.log(data.columns);   // ["id", "name", "amount"]
+     *   console.log(data.rows);      // [{ id: "1", name: "...", amount: 100 }, ...]
+     *   console.log(data.totalRows); // 42
+     * }
+     * ```
+     */
+    async getNodeData(input) {
+        return this.execute(() => this.trpc.workflows.executions.getNodeData.query(input));
+    }
+}

package/dist/resources/workflow-templates.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Workflow Templates Resource
+ *
+ * Resource manager for workflow templates — reusable workflow blueprints.
+ */
+import type { CreateWorkflowTemplateFromWorkflowInput, CreateWorkflowTemplateInput, ImportWorkflowTemplateInput, ListOptions, PaginatedResponse, UpdateWorkflowTemplateInput, WorkflowTemplateFilter } from "@artu-ai/shared";
+import { Workflow } from "../models/Workflow";
+import { WorkflowTemplate } from "../models/WorkflowTemplate";
+import { BaseResource } from "./base";
+export declare class WorkflowTemplatesResource extends BaseResource<WorkflowTemplate, CreateWorkflowTemplateInput, UpdateWorkflowTemplateInput, WorkflowTemplateFilter> {
+    /**
+     * Create a new workflow template from scratch.
+     */
+    create(data: CreateWorkflowTemplateInput): Promise<WorkflowTemplate>;
+    /**
+     * Create a workflow template from an existing workflow.
+     */
+    createFromWorkflow(data: CreateWorkflowTemplateFromWorkflowInput): Promise<WorkflowTemplate>;
+    /**
+     * Retrieve a workflow template by ID.
+     */
+    retrieve(id: string): Promise<WorkflowTemplate>;
+    /**
+     * Update a workflow template.
+     */
+    update(id: string, data: UpdateWorkflowTemplateInput): Promise<WorkflowTemplate>;
+    /**
+     * Delete a workflow template (soft delete).
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * List workflow templates with optional filtering and pagination.
+     */
+    list(options?: ListOptions<WorkflowTemplateFilter, never>): Promise<PaginatedResponse<WorkflowTemplate>>;
+    /**
+     * Count workflow templates matching the given filter.
+     */
+    count(filter?: WorkflowTemplateFilter): Promise<number>;
+    /**
+     * Import a workflow template — creates a new workflow in the test environment.
+     */
+    import(data: ImportWorkflowTemplateInput): Promise<Workflow>;
+    /**
+     * Submit a workflow template for review.
+     * Sets visibility to pending_review. An approver must call approve() to make it published.
+     */
+    publish(id: string): Promise<WorkflowTemplate>;
+    /**
+     * Unpublish a workflow template (make visible only to owning org).
+     */
+    unpublish(id: string): Promise<WorkflowTemplate>;
+}
+//# sourceMappingURL=workflow-templates.d.ts.map

package/dist/resources/workflow-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-templates.d.ts","sourceRoot":"","sources":["../../src/resources/workflow-templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,uCAAuC,EACvC,2BAA2B,EAC3B,2BAA2B,EAC3B,WAAW,EACX,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,QAAQ,EAAqB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACN,gBAAgB,EAEhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,qBAAa,yBAA0B,SAAQ,YAAY,CAC1D,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,CACtB;IACA;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ1E;;OAEG;IACG,kBAAkB,CACvB,IAAI,EAAE,uCAAuC,GAC3C,OAAO,CAAC,gBAAgB,CAAC;IAW5B;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOrD;;OAEG;IACG,MAAM,CACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,2BAA2B,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAQ5B;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACG,IAAI,CACT,OAAO,CAAC,EAAE,WAAW,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAClD,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAkB/C;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7D;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQlE;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOpD;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMtD"}

package/dist/resources/workflow-templates.js

@@ -0,0 +1,93 @@
+/**
+ * Workflow Templates Resource
+ *
+ * Resource manager for workflow templates — reusable workflow blueprints.
+ */
+import { createWorkflowTemplateFromWorkflowInputSchema, createWorkflowTemplateInputSchema, updateWorkflowTemplateInputSchema, } from "@artu-ai/shared";
+import { Workflow } from "../models/Workflow";
+import { WorkflowTemplate, } from "../models/WorkflowTemplate";
+import { BaseResource } from "./base";
+export class WorkflowTemplatesResource extends BaseResource {
+    /**
+     * Create a new workflow template from scratch.
+     */
+    async create(data) {
+        const validated = this.validate(createWorkflowTemplateInputSchema, data);
+        const response = await this.execute(() => this.trpc.workflowTemplates.create.mutate(validated));
+        return new WorkflowTemplate(response);
+    }
+    /**
+     * Create a workflow template from an existing workflow.
+     */
+    async createFromWorkflow(data) {
+        const validated = this.validate(createWorkflowTemplateFromWorkflowInputSchema, data);
+        const response = await this.execute(() => this.trpc.workflowTemplates.createFromWorkflow.mutate(validated));
+        return new WorkflowTemplate(response);
+    }
+    /**
+     * Retrieve a workflow template by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.workflowTemplates.retrieve.query({ id }));
+        return new WorkflowTemplate(response);
+    }
+    /**
+     * Update a workflow template.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateWorkflowTemplateInputSchema, data);
+        const response = await this.execute(() => this.trpc.workflowTemplates.update.mutate({ id, ...validated }));
+        return new WorkflowTemplate(response);
+    }
+    /**
+     * Delete a workflow template (soft delete).
+     */
+    async delete(id) {
+        await this.execute(() => this.trpc.workflowTemplates.delete.mutate({ id }));
+    }
+    /**
+     * List workflow templates with optional filtering and pagination.
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.workflowTemplates.list.query({
+            filter: options?.filter,
+            limit: options?.limit,
+            offset: options?.offset,
+            cursor: options?.cursor,
+            includeTotalCount: options?.includeTotalCount,
+        }));
+        return {
+            data: response.data.map((item) => new WorkflowTemplate(item)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Count workflow templates matching the given filter.
+     */
+    async count(filter) {
+        return this.execute(() => this.trpc.workflowTemplates.count.query({ filter }));
+    }
+    /**
+     * Import a workflow template — creates a new workflow in the test environment.
+     */
+    async import(data) {
+        const { templateId, ...rest } = data;
+        const response = await this.execute(() => this.trpc.workflowTemplates.import.mutate({ id: templateId, ...rest }));
+        return new Workflow(response);
+    }
+    /**
+     * Submit a workflow template for review.
+     * Sets visibility to pending_review. An approver must call approve() to make it published.
+     */
+    async publish(id) {
+        const response = await this.execute(() => this.trpc.workflowTemplates.publish.mutate({ id }));
+        return new WorkflowTemplate(response);
+    }
+    /**
+     * Unpublish a workflow template (make visible only to owning org).
+     */
+    async unpublish(id) {
+        const response = await this.execute(() => this.trpc.workflowTemplates.unpublish.mutate({ id }));
+        return new WorkflowTemplate(response);
+    }
+}

package/dist/resources/workflow-variables.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Workflow Variables Resource
+ *
+ * Resource manager for workflow variables (thresholds, config values).
+ * Variables store configurable values for workflows and use $VARIABLE_NAME syntax.
+ */
+import type { CreateWorkflowVariableInput, ListOptions, PaginatedResponse, SystemVariableFilter, UpdateWorkflowVariableInput, WorkflowVariableFilter, WorkflowVariableHistoryFilter } from "@artu-ai/shared";
+import { SystemVariable, WorkflowVariable } from "../models/WorkflowVariable";
+import { BaseResource } from "./base";
+/**
+ * Resource manager for workflow variables.
+ *
+ * Variables store configurable threshold and configuration values for workflows.
+ * They use $VARIABLE_NAME syntax and can be referenced in workflow conditions.
+ *
+ * @example
+ * ```typescript
+ * // List all variables
+ * const { data: variables } = await sdk.workflows.variables.list();
+ *
+ * // Create a new variable
+ * const variable = await sdk.workflows.variables.create({
+ *   name: "$MEX_AVI_THRESHOLD",
+ *   value: 16000,
+ *   description: "Threshold for AVI reporting",
+ *   effectiveDate: "2025-01-01",
+ * });
+ *
+ * // Update a variable
+ * await sdk.workflows.variables.update(variable.id, { value: 20000 });
+ * ```
+ */
+export declare class WorkflowVariablesResource extends BaseResource<WorkflowVariable, CreateWorkflowVariableInput, UpdateWorkflowVariableInput, WorkflowVariableFilter> {
+    /**
+     * Create a new workflow variable.
+     */
+    create(data: CreateWorkflowVariableInput): Promise<WorkflowVariable>;
+    /**
+     * Retrieve a workflow variable by ID.
+     */
+    retrieve(id: string): Promise<WorkflowVariable>;
+    /**
+     * Update a workflow variable.
+     */
+    update(id: string, data: UpdateWorkflowVariableInput): Promise<WorkflowVariable>;
+    /**
+     * Delete a workflow variable.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * List workflow variables with optional filtering and pagination.
+     */
+    list(options?: ListOptions<WorkflowVariableFilter, never>): Promise<PaginatedResponse<WorkflowVariable>>;
+    /**
+     * Count workflow variables matching the given filter.
+     */
+    count(filter?: WorkflowVariableFilter): Promise<number>;
+    /**
+     * List system-defined workflow variables with optional filtering and pagination.
+     * These are application-level variables available to all organizations.
+     */
+    listSystem(options?: ListOptions<SystemVariableFilter, never>): Promise<PaginatedResponse<SystemVariable>>;
+    /**
+     * List all entries for a workflow variable name (history).
+     * Returns all effectiveDate entries, sorted by effectiveDate DESC.
+     */
+    listHistory(name: string, options?: ListOptions<WorkflowVariableHistoryFilter, never>): Promise<PaginatedResponse<WorkflowVariable>>;
+    /**
+     * List all entries for a system variable name (history).
+     * Returns all effectiveDate entries, sorted by effectiveDate DESC.
+     */
+    listSystemHistory(name: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PaginatedResponse<SystemVariable>>;
+}
+//# sourceMappingURL=workflow-variables.d.ts.map

package/dist/resources/workflow-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-variables.d.ts","sourceRoot":"","sources":["../../src/resources/workflow-variables.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,2BAA2B,EAC3B,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACtB,6BAA6B,EAC7B,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACN,cAAc,EAEd,gBAAgB,EAEhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,yBAA0B,SAAQ,YAAY,CAC1D,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,CACtB;IACA;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ1E;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOrD;;OAEG;IACG,MAAM,CACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,2BAA2B,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAW5B;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC;;OAEG;IACG,IAAI,CACT,OAAO,CAAC,EAAE,WAAW,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAClD,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAkB/C;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7D;;;OAGG;IACG,UAAU,CACf,OAAO,CAAC,EAAE,WAAW,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAChD,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAkB7C;;;OAGG;IACG,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,CAAC,6BAA6B,EAAE,KAAK,CAAC,GACzD,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAqB/C;;;OAGG;IACG,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;CAgB7C"}

package/dist/resources/workflow-variables.js

@@ -0,0 +1,141 @@
+/**
+ * Workflow Variables Resource
+ *
+ * Resource manager for workflow variables (thresholds, config values).
+ * Variables store configurable values for workflows and use $VARIABLE_NAME syntax.
+ */
+import { createWorkflowVariableInputSchema, updateWorkflowVariableInputSchema, } from "@artu-ai/shared";
+import { SystemVariable, WorkflowVariable, } from "../models/WorkflowVariable";
+import { BaseResource } from "./base";
+/**
+ * Resource manager for workflow variables.
+ *
+ * Variables store configurable threshold and configuration values for workflows.
+ * They use $VARIABLE_NAME syntax and can be referenced in workflow conditions.
+ *
+ * @example
+ * ```typescript
+ * // List all variables
+ * const { data: variables } = await sdk.workflows.variables.list();
+ *
+ * // Create a new variable
+ * const variable = await sdk.workflows.variables.create({
+ *   name: "$MEX_AVI_THRESHOLD",
+ *   value: 16000,
+ *   description: "Threshold for AVI reporting",
+ *   effectiveDate: "2025-01-01",
+ * });
+ *
+ * // Update a variable
+ * await sdk.workflows.variables.update(variable.id, { value: 20000 });
+ * ```
+ */
+export class WorkflowVariablesResource extends BaseResource {
+    /**
+     * Create a new workflow variable.
+     */
+    async create(data) {
+        const validated = this.validate(createWorkflowVariableInputSchema, data);
+        const response = await this.execute(() => this.trpc.workflows.variables.create.mutate(validated));
+        return new WorkflowVariable(response);
+    }
+    /**
+     * Retrieve a workflow variable by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.workflows.variables.retrieve.query({ id }));
+        return new WorkflowVariable(response);
+    }
+    /**
+     * Update a workflow variable.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateWorkflowVariableInputSchema, data);
+        const response = await this.execute(() => this.trpc.workflows.variables.update.mutate({
+            id,
+            ...validated,
+        }));
+        return new WorkflowVariable(response);
+    }
+    /**
+     * Delete a workflow variable.
+     */
+    async delete(id) {
+        await this.execute(() => this.trpc.workflows.variables.delete.mutate({ id }));
+    }
+    /**
+     * List workflow variables with optional filtering and pagination.
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.workflows.variables.list.query({
+            filter: options?.filter,
+            limit: options?.limit,
+            offset: options?.offset,
+            cursor: options?.cursor,
+            includeTotalCount: options?.includeTotalCount,
+        }));
+        return {
+            data: response.data.map((item) => new WorkflowVariable(item)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Count workflow variables matching the given filter.
+     */
+    async count(filter) {
+        return this.execute(() => this.trpc.workflows.variables.count.query({ filter }));
+    }
+    /**
+     * List system-defined workflow variables with optional filtering and pagination.
+     * These are application-level variables available to all organizations.
+     */
+    async listSystem(options) {
+        const response = await this.execute(() => this.trpc.workflows.variables.listSystem.query({
+            filter: options?.filter,
+            limit: options?.limit,
+            offset: options?.offset,
+            cursor: options?.cursor,
+            includeTotalCount: options?.includeTotalCount,
+        }));
+        return {
+            data: response.data.map((item) => new SystemVariable(item)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * List all entries for a workflow variable name (history).
+     * Returns all effectiveDate entries, sorted by effectiveDate DESC.
+     */
+    async listHistory(name, options) {
+        const response = await this.execute(() => this.trpc.workflows.variables.listHistory.query({
+            name,
+            options: options
+                ? {
+                    filter: options.filter,
+                    limit: options.limit,
+                    offset: options.offset,
+                }
+                : undefined,
+        }));
+        return {
+            data: response.data.map((item) => new WorkflowVariable(item)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * List all entries for a system variable name (history).
+     * Returns all effectiveDate entries, sorted by effectiveDate DESC.
+     */
+    async listSystemHistory(name, options) {
+        const response = await this.execute(() => this.trpc.workflows.variables.listSystemHistory.query({
+            name,
+            options: options
+                ? { limit: options.limit, offset: options.offset }
+                : undefined,
+        }));
+        return {
+            data: response.data.map((item) => new SystemVariable(item)),
+            pagination: response.pagination,
+        };
+    }
+}