import {z} from 'zod' export type CreateApiApiHumanTasksTaskIdExternalUserUserIdArgs = {taskId: string, userId: string, overrideAssignment?: boolean | undefined, withTemplate?: boolean | undefined}; export type CreateApiApiHumanTasksTaskIdExternalUserUserIdOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const humanTaskUser = z.object({user: z.string().optional(), userType: z.enum(["EXTERNAL_USER", "EXTERNAL_GROUP", "CONDUCTOR_USER", "CONDUCTOR_GROUP"]).optional()}); export const humanTaskAssignment = z.object({assignee: humanTaskUser.optional(), slaMinutes: z.number().int().optional()}); export const tag = z.object({key: z.string().optional(), type: z.string().optional(), value: z.string().optional()}); export const humanTaskTemplate = z.object({createTime: z.number().int().optional(), createdBy: z.string().optional(), jsonSchema: z.record(z.string(), z.object({})), name: z.string(), ownerApp: z.string().optional(), tags: z.array(tag).optional(), templateUI: z.record(z.string(), z.object({})), updateTime: z.number().int().optional(), updatedBy: z.string().optional(), version: z.number().int()}); export const cacheConfig = z.object({key: z.string().optional(), ttlInSecond: z.number().int().optional()}); export const schemaDef = z.object({createTime: z.number().int().optional(), createdBy: z.string().optional(), data: z.record(z.string(), z.object({})).optional(), externalRef: z.string().optional(), name: z.string(), ownerApp: z.string().optional(), type: z.enum(["JSON", "AVRO", "PROTOBUF"]), updateTime: z.number().int().optional(), updatedBy: z.string().optional(), version: z.number().int()}); export const rateLimitConfig = z.object({concurrentExecLimit: z.number().int().optional(), policy: z.enum(["QUEUE", "REJECT"]).optional(), rateLimitKey: z.string().optional()}); export const stateChangeEvent = z.object({payload: z.record(z.string(), z.object({})).optional(), type: z.string()}); export const subWorkflowParams = z.object({idempotencyKey: z.string().optional(), idempotencyStrategy: z.enum(["FAIL", "RETURN_EXISTING", "FAIL_ON_RUNNING"]).optional(), name: z.string().optional(), priority: z.object({}).optional(), taskToDomain: z.record(z.string(), z.string()).optional(), version: z.number().int().optional(), workflowDefinition: z.object({}).optional()}); export const taskDef = z.object({backoffJitterMs: z.number().int().gte(0).optional(), backoffScaleFactor: z.number().int().gte(1).optional(), baseType: z.string().optional(), concurrentExecLimit: z.number().int().optional(), createTime: z.number().int().optional(), createdBy: z.string().optional(), description: z.string().optional(), enforceSchema: z.boolean().optional(), executionNameSpace: z.string().optional(), inputKeys: z.array(z.string()).optional(), inputSchema: schemaDef.optional(), inputTemplate: z.record(z.string(), z.object({})).optional(), isolationGroupId: z.string().optional(), maxRetryDelaySeconds: z.number().int().gte(0).optional(), name: z.string().min(1).optional(), outputKeys: z.array(z.string()).optional(), outputSchema: schemaDef.optional(), ownerApp: z.string().optional(), ownerEmail: z.string().optional(), pollTimeoutSeconds: z.number().int().gte(0).optional(), rateLimitFrequencyInSeconds: z.number().int().optional(), rateLimitPerFrequency: z.number().int().optional(), responseTimeoutSeconds: z.number().int().gte(1).optional(), retryCount: z.number().int().gte(0).optional(), retryDelaySeconds: z.number().int().optional(), retryLogic: z.enum(["FIXED", "EXPONENTIAL_BACKOFF", "LINEAR_BACKOFF"]).optional(), runtimeMetadata: z.array(z.string()).optional(), taskStatusListenerEnabled: z.boolean().optional(), timeoutPolicy: z.enum(["RETRY", "TIME_OUT_WF", "ALERT_ONLY"]).optional(), timeoutSeconds: z.number().int(), totalTimeoutSeconds: z.number().int().gte(0).optional(), updateTime: z.number().int().optional(), updatedBy: z.string().optional()}); export const workflowTask: z.ZodType = z.object({asyncComplete: z.boolean().optional(), cacheConfig: cacheConfig.optional(), caseExpression: z.string().optional(), caseValueParam: z.string().optional(), decisionCases: z.record(z.string(), z.array(z.lazy(() => workflowTask))).optional(), defaultCase: z.array(z.lazy(() => workflowTask)).optional(), defaultExclusiveJoinTask: z.array(z.string()).optional(), description: z.string().optional(), dynamicForkJoinTasksParam: z.string().optional(), dynamicForkTasksInputParamName: z.string().optional(), dynamicForkTasksParam: z.string().optional(), dynamicTaskNameParam: z.string().optional(), evaluatorType: z.string().optional(), expression: z.string().optional(), forkTasks: z.array(z.array(z.lazy(() => workflowTask))).optional(), inputParameters: z.record(z.string(), z.object({})).optional(), items: z.string().optional(), joinMode: z.enum(["SYNC", "ASYNC"]).optional(), joinOn: z.array(z.string()).optional(), joinStatus: z.string().optional(), loopCondition: z.string().optional(), loopOver: z.array(z.lazy(() => workflowTask)).optional(), metadata: z.record(z.string(), z.object({})).optional(), name: z.string().min(1).optional(), onStateChange: z.record(z.string(), z.array(stateChangeEvent)).optional(), optional: z.boolean().optional(), permissive: z.boolean().optional(), rateLimited: z.boolean().optional(), retryCount: z.number().int().optional(), scriptExpression: z.string().optional(), sink: z.string().optional(), startDelay: z.number().int().optional(), subWorkflowParam: subWorkflowParams.optional(), taskDefinition: taskDef.optional(), taskReferenceName: z.string().min(1).optional(), type: z.string().optional(), workflowTaskType: z.enum(["SIMPLE", "DYNAMIC", "FORK_JOIN", "FORK_JOIN_DYNAMIC", "DECISION", "SWITCH", "JOIN", "DO_WHILE", "SUB_WORKFLOW", "START_WORKFLOW", "EVENT", "WAIT", "HUMAN", "USER_DEFINED", "HTTP", "LAMBDA", "INLINE", "EXCLUSIVE_JOIN", "TERMINATE", "KAFKA_PUBLISH", "JSON_JQ_TRANSFORM", "SET_VARIABLE", "NOOP", "LLM_TEXT_COMPLETE", "LLM_CHAT_COMPLETE", "LLM_INDEX_TEXT", "LLM_SEARCH_INDEX", "LLM_GENERATE_EMBEDDINGS", "LLM_STORE_EMBEDDINGS", "LLM_GET_EMBEDDINGS", "LIST_MCP_TOOLS", "CALL_MCP_TOOL", "PULL_WORKFLOW_MESSAGES", "AGENT", "GET_AGENT_CARD", "CANCEL_AGENT"]).optional()}); export const workflowDef = z.object({cacheConfig: cacheConfig.optional(), createTime: z.number().int().optional(), createdBy: z.string().optional(), description: z.string().optional(), enforceSchema: z.boolean().optional(), failureWorkflow: z.string().optional(), failureWorkflowVersion: z.number().int().optional(), inputParameters: z.array(z.string()).optional(), inputSchema: schemaDef.optional(), inputTemplate: z.record(z.string(), z.object({})).optional(), maskedFields: z.array(z.string()).optional(), metadata: z.record(z.string(), z.object({})).optional(), name: z.string().min(1).optional(), outputParameters: z.record(z.string(), z.object({})).optional(), outputSchema: schemaDef.optional(), ownerApp: z.string().optional(), ownerEmail: z.string().optional(), rateLimitConfig: rateLimitConfig.optional(), restartable: z.boolean().optional(), schemaVersion: z.number().int().gte(2).lte(2).optional(), tasks: z.array(workflowTask), timeoutPolicy: z.enum(["TIME_OUT_WF", "ALERT_ONLY"]).optional(), timeoutSeconds: z.number().int(), updateTime: z.number().int().optional(), updatedBy: z.string().optional(), variables: z.record(z.string(), z.object({})).optional(), version: z.number().int().optional(), workflowStatusListenerEnabled: z.boolean().optional(), workflowStatusListenerSink: z.string().optional()}); export const startWorkflowRequest = z.object({correlationId: z.string().optional(), createdBy: z.string().optional(), externalInputPayloadStoragePath: z.string().optional(), idempotencyKey: z.string().optional(), idempotencyStrategy: z.enum(["FAIL", "RETURN_EXISTING", "FAIL_ON_RUNNING"]).optional(), input: z.record(z.string(), z.object({})).optional(), name: z.string(), priority: z.number().int().gte(0).lte(99).optional(), taskToDomain: z.record(z.string(), z.string()).optional(), version: z.number().int().optional(), workflowDef: workflowDef.optional()}); export const humanTaskTrigger = z.object({startWorkflowRequest: startWorkflowRequest.optional(), triggerType: z.enum(["ASSIGNEE_CHANGED", "CLAIMANT_CHANGED", "PENDING", "IN_PROGRESS", "ASSIGNED", "COMPLETED", "TIMED_OUT"]).optional()}); export const userFormTemplate = z.object({name: z.string().optional(), version: z.number().int().optional()}); export const humanTaskDefinition = z.object({assignmentCompletionStrategy: z.enum(["LEAVE_OPEN", "TERMINATE"]).optional(), assignments: z.array(humanTaskAssignment).optional(), autoClaim: z.boolean().optional(), displayName: z.string().optional(), fullTemplate: humanTaskTemplate.optional(), taskTriggers: z.array(humanTaskTrigger).optional(), userFormTemplate: userFormTemplate.optional()}); export const humanTaskEntry = z.object({assignee: humanTaskUser.optional(), claimant: humanTaskUser.optional(), createdBy: z.string().optional(), createdOn: z.number().int().optional(), definitionName: z.string().optional(), displayName: z.string().optional(), humanTaskDef: humanTaskDefinition.optional(), input: z.record(z.string(), z.object({})).optional(), output: z.record(z.string(), z.object({})).optional(), ownerApp: z.string().optional(), state: z.enum(["PENDING", "ASSIGNED", "IN_PROGRESS", "COMPLETED", "TIMED_OUT", "DELETED"]).optional(), taskId: z.string().optional(), taskRefName: z.string().optional(), updatedBy: z.string().optional(), updatedOn: z.number().int().optional(), workflowId: z.string().optional(), workflowName: z.string().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Claim a task to an external user * * POST /api/human/tasks/{taskId}/externalUser/{userId} */ export const createApiApiHumanTasksTaskIdExternalUserUserId = async (args: CreateApiApiHumanTasksTaskIdExternalUserUserIdArgs, options?: CreateApiApiHumanTasksTaskIdExternalUserUserIdOptions) => { const {baseUrl = "https://developer.orkescloud.com", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.overrideAssignment != null) query.append("overrideAssignment", String(args.overrideAssignment)) if (args.withTemplate != null) query.append("withTemplate", String(args.withTemplate)) if (apiKey !== undefined) headers.set("X-Authorization", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/api/human/tasks/${encodeURIComponent(String(args.taskId))}/externalUser/${encodeURIComponent(String(args.userId))}${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(humanTaskEntry, await res.json()) };