@vercel/factory 0.0.13 → 0.0.15

package/dist/schema/task.d.mts

@@ -0,0 +1,272 @@
+import { JsonValue } from "./work.mjs";
+import { z } from "zod";
+//#region src/schema/task.d.ts
+/** Descriptive labels used by the reference workflows, not core lifecycle rules. */
+declare const standardTaskKinds: readonly ["coordination", "code_change", "verification", "investigation", "question"];
+/** Standard Task kinds with support for caller-defined vocabulary values. */
+type TaskKind = (typeof standardTaskKinds)[number] | (string & Record<never, never>);
+/** Validates the descriptive, open-vocabulary label attached to a Task. */
+declare const taskKindSchema: z.ZodType<TaskKind>;
+/** Validates the fixed lifecycle state of a Task. */
+declare const taskStateSchema: z.ZodEnum<{
+  queued: "queued";
+  running: "running";
+  stalled: "stalled";
+  verifying: "verifying";
+  succeeded: "succeeded";
+  failed: "failed";
+  needs_human: "needs_human";
+  cancelled: "cancelled";
+}>;
+/** Validates whether a Task requires, received, or was denied human approval. */
+declare const taskApprovalSchema: z.ZodEnum<{
+  required: "required";
+  granted: "granted";
+  denied: "denied";
+}>;
+/** Validates the single-repository scope required by supplied execution adapters. */
+declare const taskExecutionRepositoryIdsSchema: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], null>>;
+/** Validates Task provenance independently from graph parentage. */
+declare const taskOriginSchema: z.ZodObject<{
+  signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+  operator: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Validates the configured coding-harness identifier retained with an execution. */
+declare const harnessSchema: z.ZodString;
+/**
+ * The provider's handle on the current attempt's execution. Opaque to the
+ * lifecycle: Factory records it so the execution can be inspected or
+ * cancelled, never to mirror the provider's own state machine.
+ */
+declare const executionReferenceSchema: z.ZodObject<{
+  provider: z.ZodString;
+  sessionId: z.ZodString;
+  environmentId: z.ZodOptional<z.ZodString>;
+  harness: z.ZodOptional<z.ZodString>;
+  traceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Validates Task-local measured usage and per-turn step deduplication state. */
+declare const taskUsageSchema: z.ZodObject<{
+  costUsd: z.ZodNumber;
+  inputTokens: z.ZodNumber;
+  outputTokens: z.ZodNumber;
+  cacheReadTokens: z.ZodNumber;
+  cacheWriteTokens: z.ZodNumber;
+  steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strict>;
+/** Validates a human question, suggested replies, and any authenticated answer. */
+declare const taskQuestionSchema: z.ZodObject<{
+  text: z.ZodString;
+  options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+  closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+  answer: z.ZodOptional<z.ZodString>;
+  answeredBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Validates the canonical durable snapshot of one unit of workflow work. */
+declare const taskRecordSchema: z.ZodObject<{
+  schemaVersion: z.ZodLiteral<1>;
+  id: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+  repositoryIds: z.ZodReadonly<z.ZodTuple<[z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>], z.ZodType<`repo_${string}`, string, z.core.$ZodTypeInternals<`repo_${string}`, string>>>>;
+  kind: z.ZodType<TaskKind, unknown, z.core.$ZodTypeInternals<TaskKind, unknown>>;
+  area: z.ZodOptional<z.ZodString>;
+  state: z.ZodEnum<{
+    queued: "queued";
+    running: "running";
+    stalled: "stalled";
+    verifying: "verifying";
+    succeeded: "succeeded";
+    failed: "failed";
+    needs_human: "needs_human";
+    cancelled: "cancelled";
+  }>;
+  approval: z.ZodOptional<z.ZodEnum<{
+    required: "required";
+    granted: "granted";
+    denied: "denied";
+  }>>;
+  origin: z.ZodObject<{
+    signalId: z.ZodOptional<z.ZodType<`sig_${string}`, string, z.core.$ZodTypeInternals<`sig_${string}`, string>>>;
+    operator: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>;
+  work: z.ZodObject<{
+    title: z.ZodString;
+    input: z.ZodCustom<JsonValue, JsonValue>;
+    completionCriteria: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    workflow: z.core.$ZodBranded<z.ZodObject<{
+      id: z.ZodString;
+      version: z.ZodNumber;
+    }, z.core.$strict>, "WorkflowBinding", "out">;
+    route: z.ZodOptional<z.core.$ZodBranded<z.ZodObject<{
+      id: z.ZodString;
+      version: z.ZodNumber;
+    }, z.core.$strict>, "AgentRouteBinding", "out">>;
+  }, z.core.$strict>;
+  workResult: z.ZodOptional<z.ZodObject<{
+    output: z.ZodCustom<JsonValue, JsonValue>;
+    completedAt: z.ZodISODateTime;
+  }, z.core.$strict>>;
+  waitingForMessages: z.ZodOptional<z.ZodBoolean>;
+  workflowPhase: z.ZodOptional<z.ZodString>;
+  rootTaskId: z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>;
+  parentTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  parentTaskAttempt: z.ZodOptional<z.ZodNumber>;
+  replyTo: z.ZodObject<{
+    channel: z.ZodString;
+    address: z.ZodString;
+  }, z.core.$strict>;
+  pendingCommunicationReceiptIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>>>;
+  failureReceiptId: z.ZodOptional<z.ZodType<`rcpt_${string}`, string, z.core.$ZodTypeInternals<`rcpt_${string}`, string>>>;
+  attempt: z.ZodNumber;
+  execution: z.ZodOptional<z.ZodObject<{
+    provider: z.ZodString;
+    sessionId: z.ZodString;
+    environmentId: z.ZodOptional<z.ZodString>;
+    harness: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
+  stalledAt: z.ZodOptional<z.ZodISODateTime>;
+  stalledReason: z.ZodOptional<z.ZodString>;
+  needsHumanAction: z.ZodOptional<z.ZodString>;
+  needsHumanNotifiedAt: z.ZodOptional<z.ZodISODateTime>;
+  reservedUsd: z.ZodOptional<z.ZodNumber>;
+  reservedAt: z.ZodOptional<z.ZodISODateTime>;
+  usage: z.ZodOptional<z.ZodObject<{
+    costUsd: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    cacheReadTokens: z.ZodNumber;
+    cacheWriteTokens: z.ZodNumber;
+    steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+  }, z.core.$strict>>;
+  settledUsd: z.ZodOptional<z.ZodNumber>;
+  question: z.ZodOptional<z.ZodObject<{
+    text: z.ZodString;
+    options: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+    closingOptions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    answer: z.ZodOptional<z.ZodString>;
+    answeredBy: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
+  questionTaskId: z.ZodOptional<z.ZodType<`task_${string}`, string, z.core.$ZodTypeInternals<`task_${string}`, string>>>;
+  answerEventIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<`ans_${string}`, string, z.core.$ZodTypeInternals<`ans_${string}`, string>>>>>;
+  changeId: z.ZodOptional<z.ZodType<`chg_${string}`, string, z.core.$ZodTypeInternals<`chg_${string}`, string>>>;
+  reportRef: z.ZodOptional<z.ZodString>;
+  createdAt: z.ZodISODateTime;
+  updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type TaskRecord = z.infer<typeof taskRecordSchema>;
+type SchemaWithOutput<Schema extends z.ZodType, Output> = Omit<Schema, keyof z.ZodType> & z.ZodType<Output, z.input<Schema>>;
+type TaskStateField = "state" | "workResult" | "waitingForMessages" | "failureReceiptId" | "stalledAt" | "stalledReason" | "needsHumanAction" | "needsHumanNotifiedAt";
+type TaskQuestionField = "question" | "questionTaskId" | "parentTaskAttempt" | "parentTaskId";
+type TaskCommon = Omit<TaskRecord, TaskStateField | TaskQuestionField>;
+type TaskIdValue = NonNullable<TaskRecord["parentTaskId"]>;
+type TaskWorkResult = NonNullable<TaskRecord["workResult"]>;
+type TaskWithoutQuestion = {
+  question?: never;
+  questionTaskId?: never;
+  parentTaskAttempt?: never;
+  parentTaskId?: TaskIdValue;
+};
+type TaskWithQuestion<Question extends TaskRecord["question"]> = {
+  question: Question;
+  questionTaskId?: never;
+  parentTaskAttempt?: never;
+  parentTaskId?: TaskIdValue;
+} | {
+  question: Question;
+  questionTaskId?: never;
+  parentTaskAttempt: number;
+  parentTaskId: TaskIdValue;
+};
+type TaskWithLinkedQuestion = {
+  question?: never;
+  questionTaskId: TaskIdValue;
+  parentTaskAttempt?: never;
+  parentTaskId?: TaskIdValue;
+};
+type TaskQuestionContext = TaskWithoutQuestion | TaskWithQuestion<NonNullable<TaskRecord["question"]>> | TaskWithLinkedQuestion;
+type UnansweredTaskQuestion = Omit<NonNullable<TaskRecord["question"]>, "answer" | "answeredBy"> & {
+  answer?: never;
+  answeredBy?: never;
+};
+type InactiveStateFields = {
+  waitingForMessages?: false;
+  needsHumanAction?: never;
+  needsHumanNotifiedAt?: never;
+};
+type UnstalledStateFields = {
+  stalledAt?: never;
+  stalledReason?: never;
+};
+type NonFailedStateFields = {
+  failureReceiptId?: never;
+};
+type InactiveOrdinaryTaskState<State extends "queued" | "verifying" | "cancelled"> = InactiveStateFields & UnstalledStateFields & NonFailedStateFields & {
+  state: State;
+  workResult?: TaskWorkResult;
+};
+type OrdinaryTaskState = InactiveOrdinaryTaskState<"queued"> | InactiveOrdinaryTaskState<"verifying"> | InactiveOrdinaryTaskState<"cancelled"> | (UnstalledStateFields & NonFailedStateFields & {
+  state: "running";
+  waitingForMessages?: boolean;
+  needsHumanAction?: never;
+  needsHumanNotifiedAt?: never;
+  workResult?: TaskWorkResult;
+}) | (InactiveStateFields & NonFailedStateFields & {
+  state: "stalled";
+  stalledAt?: string;
+  stalledReason?: string;
+  workResult?: TaskWorkResult;
+}) | (InactiveStateFields & UnstalledStateFields & {
+  state: "failed";
+  failureReceiptId?: NonNullable<TaskRecord["failureReceiptId"]>;
+  workResult?: TaskWorkResult;
+}) | (InactiveStateFields & UnstalledStateFields & NonFailedStateFields & {
+  state: "succeeded";
+  workResult: TaskWorkResult;
+});
+type NeedsHumanTaskState = UnstalledStateFields & NonFailedStateFields & {
+  state: "needs_human";
+  waitingForMessages?: false;
+  needsHumanAction: string;
+  needsHumanNotifiedAt?: string;
+  workResult?: TaskWorkResult;
+};
+/** Canonical durable snapshot of one explicitly versioned unit of workflow work. */
+type Task = TaskCommon & ((OrdinaryTaskState & TaskQuestionContext) | (NeedsHumanTaskState & (TaskWithQuestion<UnansweredTaskQuestion> | TaskWithLinkedQuestion)));
+/** Validates the canonical durable snapshot of one unit of workflow work. */
+declare const taskSchema: SchemaWithOutput<typeof taskRecordSchema, Task>;
+/** Human approval status recorded on a Task when policy requires a decision. */
+type TaskApproval = z.infer<typeof taskApprovalSchema>;
+/** Signal or operator provenance retained independently from Task graph parentage. */
+type TaskOrigin = z.infer<typeof taskOriginSchema>;
+/** Human question, suggested replies, and optional authenticated answer. */
+type TaskQuestion = z.infer<typeof taskQuestionSchema>;
+/** Fixed lifecycle state controlled through the canonical Task transition table. */
+type TaskState = z.infer<typeof taskStateSchema>;
+/** Task-local measured model usage with idempotent per-step accounting. */
+type TaskUsage = z.infer<typeof taskUsageSchema>;
+/** Opaque provider-owned execution handle for the current Task attempt. */
+type ExecutionReference = z.infer<typeof executionReferenceSchema>;
+/** Succeeded Task narrowed to its required validated workflow result. */
+type SucceededTask = Extract<Task, {
+  state: "succeeded";
+}>;
+/** Human-blocked Task narrowed to its required actionable description. */
+type NeedsHumanTask = Extract<Task, {
+  state: "needs_human";
+}>;
+/** Running Task narrowed to its explicit message-waiting marker. */
+type MessageWaitingTask = Extract<Task, {
+  state: "running";
+}> & {
+  waitingForMessages: true;
+};
+/** Narrows a validated Task after checking its succeeded-state invariant. */
+declare function isSucceededTask(task: Task): task is SucceededTask;
+/** Narrows a validated Task after checking its human-action invariant. */
+declare function isNeedsHumanTask(task: Task): task is NeedsHumanTask;
+/** Narrows a validated Task to running work deliberately waiting for messages. */
+declare function isMessageWaitingTask(task: Task): task is MessageWaitingTask;
+//#endregion
+export { ExecutionReference, MessageWaitingTask, NeedsHumanTask, SucceededTask, Task, TaskApproval, TaskKind, TaskOrigin, TaskQuestion, TaskState, TaskUsage, executionReferenceSchema, harnessSchema, isMessageWaitingTask, isNeedsHumanTask, isSucceededTask, standardTaskKinds, taskApprovalSchema, taskExecutionRepositoryIdsSchema, taskKindSchema, taskOriginSchema, taskQuestionSchema, taskSchema, taskStateSchema, taskUsageSchema };
+//# sourceMappingURL=task.d.mts.map

package/dist/schema/task.mjs

@@ -0,0 +1,199 @@
+import { answerIdSchema, changeIdSchema, receiptIdSchema, repositoryIdSchema, repositoryIdsSchema, signalIdSchema, taskIdSchema } from "./id.mjs";
+import { isoDateTimeSchema, replyToSchema, schemaVersionSchema, usdSchema, vocabularySchema } from "./common.mjs";
+import { taskWorkResultSchema, taskWorkSchema, workflowBindingSchema } from "./work.mjs";
+import { z } from "zod";
+//#region src/schema/task.ts
+/** Descriptive labels used by the reference workflows, not core lifecycle rules. */
+const standardTaskKinds = [
+	"coordination",
+	"code_change",
+	"verification",
+	"investigation",
+	"question"
+];
+/** Validates the descriptive, open-vocabulary label attached to a Task. */
+const taskKindSchema = vocabularySchema.describe("What kind of work this is, e.g. code_change, question, or a registered custom kind.");
+/** Validates the fixed lifecycle state of a Task. */
+const taskStateSchema = z.enum([
+	"queued",
+	"running",
+	"stalled",
+	"verifying",
+	"succeeded",
+	"failed",
+	"needs_human",
+	"cancelled"
+]).describe("Lifecycle state. Transitions are fixed; see taskTransitions.");
+/** Validates whether a Task requires, received, or was denied human approval. */
+const taskApprovalSchema = z.enum([
+	"required",
+	"granted",
+	"denied"
+]).describe("Human approval status. Absent means no approval is needed. Stamped required at creation by policy; granted or denied by an operator.");
+/** Validates the single-repository scope required by supplied execution adapters. */
+const taskExecutionRepositoryIdsSchema = z.tuple([repositoryIdSchema]).readonly().describe("The one repository used to execute a task.");
+/** Validates Task provenance independently from graph parentage. */
+const taskOriginSchema = z.strictObject({
+	signalId: signalIdSchema.optional().describe("Signal that led to this task."),
+	operator: z.string().min(1).optional().describe("Human operator who requested it.")
+}).describe("Task provenance; an empty child creation origin inherits its parent's provenance.");
+/** Validates the configured coding-harness identifier retained with an execution. */
+const harnessSchema = z.string().min(1).describe("Coding harness running inside the execution environment, e.g. claude-code or codex.");
+/**
+* The provider's handle on the current attempt's execution. Opaque to the
+* lifecycle: Factory records it so the execution can be inspected or
+* cancelled, never to mirror the provider's own state machine.
+*/
+const executionReferenceSchema = z.strictObject({
+	provider: z.string().min(1).describe("Execution provider, e.g. eve."),
+	sessionId: z.string().min(1).describe("Provider-side session running this attempt."),
+	environmentId: z.string().min(1).optional().describe("Provider-side execution environment."),
+	harness: harnessSchema.optional(),
+	traceId: z.string().min(1).optional().describe("Provider-side trace for this execution.")
+});
+const tokenCountSchema = z.number().int().nonnegative();
+/** Validates Task-local measured usage and per-turn step deduplication state. */
+const taskUsageSchema = z.strictObject({
+	costUsd: usdSchema.describe("AI Gateway cost summed over recorded steps."),
+	inputTokens: tokenCountSchema,
+	outputTokens: tokenCountSchema,
+	cacheReadTokens: tokenCountSchema,
+	cacheWriteTokens: tokenCountSchema,
+	steps: z.record(z.string().min(1), tokenCountSchema).describe("Highest recorded stepIndex per turnId; steps at or below it are already counted.")
+});
+/** Validates a human question, suggested replies, and any authenticated answer. */
+const taskQuestionSchema = z.strictObject({
+	text: z.string().min(1).describe("The input or action requested from a human before work can resume."),
+	options: z.array(z.string().min(1)).readonly().describe("Suggested replies; free-text is also allowed."),
+	/**
+	* Options (matched case-insensitively, trimmed) whose exact answer means
+	* "this task no longer needs a fresh attempt": the asker judged that no
+	* amount of retrying can succeed once this reply is chosen. Answering with
+	* one of these resolves the parent task instead of requeuing it. Answers
+	* outside this set keep the existing retry behavior.
+	*/
+	closingOptions: z.array(z.string().min(1)).max(20).readonly().optional().describe("Subset of options whose exact answer resolves the task instead of requeuing a fresh attempt."),
+	answer: z.string().min(1).optional(),
+	answeredBy: z.string().min(1).optional().describe("Authenticated operator who answered.")
+});
+/** Validates the canonical durable snapshot of one unit of workflow work. */
+const taskSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: taskIdSchema,
+	repositoryIds: repositoryIdsSchema.describe("Repositories the task concerns."),
+	kind: taskKindSchema,
+	area: z.string().min(1).optional().describe("Workflow-specific area, e.g. onboarding or security."),
+	state: taskStateSchema,
+	approval: taskApprovalSchema.optional(),
+	origin: taskOriginSchema,
+	work: taskWorkSchema.describe("Required versioned workflow contract for this Task."),
+	workResult: taskWorkResultSchema.optional().describe("Validated canonical workflow result."),
+	waitingForMessages: z.boolean().optional().describe("Whether work is waiting for messages; true only while running."),
+	workflowPhase: workflowBindingSchema.shape.id.optional().describe("Workflow-owned lowercase hyphenated or snake_case phase, at most 64 characters."),
+	rootTaskId: taskIdSchema.describe("Root of the task graph; equal to id for a root task."),
+	parentTaskId: taskIdSchema.optional().describe("Single owning parent task; cannot reference the task itself."),
+	parentTaskAttempt: z.number().int().positive().optional().describe("Parent execution attempt that raised this question; a new parent attempt requires a new question."),
+	replyTo: replyToSchema,
+	pendingCommunicationReceiptIds: z.array(receiptIdSchema).readonly().optional().describe("Transition receipts that still need to be projected into the communication outbox."),
+	failureReceiptId: receiptIdSchema.optional().describe("Committed failure receipt for the current failed attempt; independent of delivery bookkeeping."),
+	attempt: z.number().int().min(1).describe("Execution attempt, starting at 1; bumps on retry."),
+	execution: executionReferenceSchema.optional().describe("Execution of the current attempt, recorded at dispatch and replaced on retry."),
+	lastProgressAt: isoDateTimeSchema.optional().describe("Last time the execution demonstrably advanced: dispatch, or a completed model step."),
+	stalledAt: isoDateTimeSchema.optional().describe("When the reconciler marked the task stalled."),
+	stalledReason: z.string().min(1).optional().describe("Why the task was marked stalled."),
+	needsHumanAction: z.string().min(1).optional().describe("Actionable, human-facing description of what a human must do before this task can proceed. Required exactly while state is needs_human; every needs_human transition must carry one."),
+	needsHumanNotifiedAt: isoDateTimeSchema.optional().describe("When Slack confirmed delivery of the needs_human notification for the current needs_human episode. Absent while delivery is still retrying."),
+	reservedUsd: usdSchema.optional().describe("Budget reserved before dispatch."),
+	reservedAt: isoDateTimeSchema.optional().describe("When the reservation was stamped; attributes spend to a budget month."),
+	usage: taskUsageSchema.optional().describe("Measured model usage, accumulated per step by recordUsage and settled into settledUsd."),
+	settledUsd: usdSchema.optional().describe("Measured cost settled after execution. A task settles once and cannot be retried after settlement."),
+	question: taskQuestionSchema.optional(),
+	questionTaskId: taskIdSchema.optional().describe("Open QuestionTask blocking this executable task, stored for direct answer routing."),
+	answerEventIds: z.array(answerIdSchema).readonly().optional().describe("Immutable answer events projected onto this task for direct replay."),
+	changeId: changeIdSchema.optional().describe("Change this executable task concerns or produces."),
+	reportRef: z.string().min(1).optional().describe("Reference to the report artifact an investigation produced."),
+	createdAt: isoDateTimeSchema,
+	updatedAt: isoDateTimeSchema
+}).superRefine((task, ctx) => {
+	if (task.failureReceiptId !== void 0 && task.state !== "failed") ctx.addIssue({
+		code: "custom",
+		path: ["failureReceiptId"],
+		message: "failureReceiptId is only valid while the task is failed"
+	});
+	if (task.state !== "stalled" && (task.stalledAt !== void 0 || task.stalledReason !== void 0)) ctx.addIssue({
+		code: "custom",
+		path: ["stalledAt"],
+		message: "stalledAt and stalledReason are only valid while the task is stalled"
+	});
+	if (task.state === "needs_human" && (task.needsHumanAction === void 0 || task.needsHumanAction.trim() === "")) ctx.addIssue({
+		code: "custom",
+		path: ["needsHumanAction"],
+		message: "needs_human requires a populated, actionable needsHumanAction for a human reader"
+	});
+	if (task.state !== "needs_human" && (task.needsHumanAction !== void 0 || task.needsHumanNotifiedAt !== void 0)) ctx.addIssue({
+		code: "custom",
+		path: ["needsHumanAction"],
+		message: "needsHumanAction and needsHumanNotifiedAt are only valid while the task is needs_human"
+	});
+	if (task.state === "needs_human" && (task.question === void 0 && task.questionTaskId === void 0 || task.question !== void 0 && (task.question.answer !== void 0 || task.question.answeredBy !== void 0))) ctx.addIssue({
+		code: "custom",
+		path: ["question"],
+		message: "needs_human requires an unanswered question or a linked open QuestionTask"
+	});
+	if (task.question !== void 0 && task.questionTaskId !== void 0) ctx.addIssue({
+		code: "custom",
+		path: ["questionTaskId"],
+		message: "A task cannot both ask a question and be blocked by another question"
+	});
+	if (task.parentTaskAttempt !== void 0 && (task.parentTaskId === void 0 || task.question === void 0)) ctx.addIssue({
+		code: "custom",
+		path: ["parentTaskAttempt"],
+		message: "parentTaskAttempt binds a child question to its parent's execution attempt"
+	});
+	if (task.parentTaskId === task.id) ctx.addIssue({
+		code: "custom",
+		path: ["parentTaskId"],
+		message: "parentTaskId cannot reference the task itself"
+	});
+	if (task.parentTaskId === void 0 && task.rootTaskId !== task.id) ctx.addIssue({
+		code: "custom",
+		path: ["rootTaskId"],
+		message: "Root tasks must use their own id as rootTaskId"
+	});
+	if (task.parentTaskId !== void 0 && task.rootTaskId === task.id) ctx.addIssue({
+		code: "custom",
+		path: ["rootTaskId"],
+		message: "Child tasks cannot use their own id as rootTaskId"
+	});
+	if (task.parentTaskId === void 0 && task.origin.signalId === void 0 && task.origin.operator === void 0) ctx.addIssue({
+		code: "custom",
+		path: ["origin"],
+		message: "Root task origin requires a signalId or operator"
+	});
+	if (task.waitingForMessages === true && task.state !== "running") ctx.addIssue({
+		code: "custom",
+		path: ["waitingForMessages"],
+		message: "waitingForMessages can only be true while work is running"
+	});
+	if (task.state === "succeeded" && task.workResult === void 0) ctx.addIssue({
+		code: "custom",
+		path: ["workResult"],
+		message: "Succeeded tasks require a validated workflow result"
+	});
+});
+/** Narrows a validated Task after checking its succeeded-state invariant. */
+function isSucceededTask(task) {
+	return task.state === "succeeded" && task.workResult !== void 0;
+}
+/** Narrows a validated Task after checking its human-action invariant. */
+function isNeedsHumanTask(task) {
+	return task.state === "needs_human" && task.needsHumanAction !== void 0;
+}
+/** Narrows a validated Task to running work deliberately waiting for messages. */
+function isMessageWaitingTask(task) {
+	return task.state === "running" && task.waitingForMessages === true;
+}
+//#endregion
+export { executionReferenceSchema, harnessSchema, isMessageWaitingTask, isNeedsHumanTask, isSucceededTask, standardTaskKinds, taskApprovalSchema, taskExecutionRepositoryIdsSchema, taskKindSchema, taskOriginSchema, taskQuestionSchema, taskSchema, taskStateSchema, taskUsageSchema };
+
+//# sourceMappingURL=task.mjs.map

package/dist/schema/task.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.mjs","names":[],"sources":["../../src/schema/task.ts"],"sourcesContent":["import { z } from \"zod\";\nimport {\n  isoDateTimeSchema,\n  replyToSchema,\n  schemaVersionSchema,\n  usdSchema,\n  vocabularySchema,\n} from \"./common\";\nimport {\n  answerIdSchema,\n  changeIdSchema,\n  receiptIdSchema,\n  repositoryIdSchema,\n  repositoryIdsSchema,\n  signalIdSchema,\n  taskIdSchema,\n} from \"./id\";\nimport { taskWorkResultSchema, taskWorkSchema, workflowBindingSchema } from \"./work\";\n\n/** Descriptive labels used by the reference workflows, not core lifecycle rules. */\nexport const standardTaskKinds = [\n  \"coordination\",\n  \"code_change\",\n  \"verification\",\n  \"investigation\",\n  \"question\",\n] as const;\n\n/** Standard Task kinds with support for caller-defined vocabulary values. */\nexport type TaskKind = (typeof standardTaskKinds)[number] | (string & Record<never, never>);\n\n/** Validates the descriptive, open-vocabulary label attached to a Task. */\nexport const taskKindSchema = vocabularySchema.describe(\n  \"What kind of work this is, e.g. code_change, question, or a registered custom kind.\",\n) as z.ZodType<TaskKind>;\n\n/** Validates the fixed lifecycle state of a Task. */\nexport const taskStateSchema = z\n  .enum([\n    \"queued\",\n    \"running\",\n    \"stalled\",\n    \"verifying\",\n    \"succeeded\",\n    \"failed\",\n    \"needs_human\",\n    \"cancelled\",\n  ])\n  .describe(\"Lifecycle state. Transitions are fixed; see taskTransitions.\");\n\n/** Validates whether a Task requires, received, or was denied human approval. */\nexport const taskApprovalSchema = z\n  .enum([\"required\", \"granted\", \"denied\"])\n  .describe(\n    \"Human approval status. Absent means no approval is needed. Stamped required at creation by policy; granted or denied by an operator.\",\n  );\n\n/** Validates the single-repository scope required by supplied execution adapters. */\nexport const taskExecutionRepositoryIdsSchema = z\n  .tuple([repositoryIdSchema])\n  .readonly()\n  .describe(\"The one repository used to execute a task.\");\n\n/** Validates Task provenance independently from graph parentage. */\nexport const taskOriginSchema = z\n  .strictObject({\n    signalId: signalIdSchema.optional().describe(\"Signal that led to this task.\"),\n    operator: z.string().min(1).optional().describe(\"Human operator who requested it.\"),\n  })\n  .describe(\"Task provenance; an empty child creation origin inherits its parent's provenance.\");\n\n/** Validates the configured coding-harness identifier retained with an execution. */\nexport const harnessSchema = z\n  .string()\n  .min(1)\n  .describe(\"Coding harness running inside the execution environment, e.g. claude-code or codex.\");\n\n/**\n * The provider's handle on the current attempt's execution. Opaque to the\n * lifecycle: Factory records it so the execution can be inspected or\n * cancelled, never to mirror the provider's own state machine.\n */\nexport const executionReferenceSchema = z.strictObject({\n  provider: z.string().min(1).describe(\"Execution provider, e.g. eve.\"),\n  sessionId: z.string().min(1).describe(\"Provider-side session running this attempt.\"),\n  environmentId: z.string().min(1).optional().describe(\"Provider-side execution environment.\"),\n  harness: harnessSchema.optional(),\n  traceId: z.string().min(1).optional().describe(\"Provider-side trace for this execution.\"),\n});\n\nconst tokenCountSchema = z.number().int().nonnegative();\n\n/** Validates Task-local measured usage and per-turn step deduplication state. */\nexport const taskUsageSchema = z.strictObject({\n  costUsd: usdSchema.describe(\"AI Gateway cost summed over recorded steps.\"),\n  inputTokens: tokenCountSchema,\n  outputTokens: tokenCountSchema,\n  cacheReadTokens: tokenCountSchema,\n  cacheWriteTokens: tokenCountSchema,\n  steps: z\n    .record(z.string().min(1), tokenCountSchema)\n    .describe(\"Highest recorded stepIndex per turnId; steps at or below it are already counted.\"),\n});\n\n/** Validates a human question, suggested replies, and any authenticated answer. */\nexport const taskQuestionSchema = z.strictObject({\n  text: z\n    .string()\n    .min(1)\n    .describe(\"The input or action requested from a human before work can resume.\"),\n  options: z\n    .array(z.string().min(1))\n    .readonly()\n    .describe(\"Suggested replies; free-text is also allowed.\"),\n  /**\n   * Options (matched case-insensitively, trimmed) whose exact answer means\n   * \"this task no longer needs a fresh attempt\": the asker judged that no\n   * amount of retrying can succeed once this reply is chosen. Answering with\n   * one of these resolves the parent task instead of requeuing it. Answers\n   * outside this set keep the existing retry behavior.\n   */\n  closingOptions: z\n    .array(z.string().min(1))\n    .max(20)\n    .readonly()\n    .optional()\n    .describe(\n      \"Subset of options whose exact answer resolves the task instead of requeuing a fresh attempt.\",\n    ),\n  answer: z.string().min(1).optional(),\n  answeredBy: z.string().min(1).optional().describe(\"Authenticated operator who answered.\"),\n});\n\n/** Validates the canonical durable snapshot of one unit of workflow work. */\nconst taskRecordSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    id: taskIdSchema,\n    repositoryIds: repositoryIdsSchema.describe(\"Repositories the task concerns.\"),\n    kind: taskKindSchema,\n    area: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Workflow-specific area, e.g. onboarding or security.\"),\n    state: taskStateSchema,\n    approval: taskApprovalSchema.optional(),\n    origin: taskOriginSchema,\n    work: taskWorkSchema.describe(\"Required versioned workflow contract for this Task.\"),\n    workResult: taskWorkResultSchema.optional().describe(\"Validated canonical workflow result.\"),\n    waitingForMessages: z\n      .boolean()\n      .optional()\n      .describe(\"Whether work is waiting for messages; true only while running.\"),\n    workflowPhase: workflowBindingSchema.shape.id\n      .optional()\n      .describe(\"Workflow-owned lowercase hyphenated or snake_case phase, at most 64 characters.\"),\n    rootTaskId: taskIdSchema.describe(\"Root of the task graph; equal to id for a root task.\"),\n    parentTaskId: taskIdSchema\n      .optional()\n      .describe(\"Single owning parent task; cannot reference the task itself.\"),\n    parentTaskAttempt: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe(\n        \"Parent execution attempt that raised this question; a new parent attempt requires a new question.\",\n      ),\n    replyTo: replyToSchema,\n    pendingCommunicationReceiptIds: z\n      .array(receiptIdSchema)\n      .readonly()\n      .optional()\n      .describe(\n        \"Transition receipts that still need to be projected into the communication outbox.\",\n      ),\n    failureReceiptId: receiptIdSchema\n      .optional()\n      .describe(\n        \"Committed failure receipt for the current failed attempt; independent of delivery bookkeeping.\",\n      ),\n    attempt: z.number().int().min(1).describe(\"Execution attempt, starting at 1; bumps on retry.\"),\n    execution: executionReferenceSchema\n      .optional()\n      .describe(\"Execution of the current attempt, recorded at dispatch and replaced on retry.\"),\n    lastProgressAt: isoDateTimeSchema\n      .optional()\n      .describe(\n        \"Last time the execution demonstrably advanced: dispatch, or a completed model step.\",\n      ),\n    stalledAt: isoDateTimeSchema\n      .optional()\n      .describe(\"When the reconciler marked the task stalled.\"),\n    stalledReason: z.string().min(1).optional().describe(\"Why the task was marked stalled.\"),\n    needsHumanAction: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\n        \"Actionable, human-facing description of what a human must do before this task can proceed. Required exactly while state is needs_human; every needs_human transition must carry one.\",\n      ),\n    needsHumanNotifiedAt: isoDateTimeSchema\n      .optional()\n      .describe(\n        \"When Slack confirmed delivery of the needs_human notification for the current needs_human episode. Absent while delivery is still retrying.\",\n      ),\n    reservedUsd: usdSchema.optional().describe(\"Budget reserved before dispatch.\"),\n    reservedAt: isoDateTimeSchema\n      .optional()\n      .describe(\"When the reservation was stamped; attributes spend to a budget month.\"),\n    usage: taskUsageSchema\n      .optional()\n      .describe(\n        \"Measured model usage, accumulated per step by recordUsage and settled into settledUsd.\",\n      ),\n    settledUsd: usdSchema\n      .optional()\n      .describe(\n        \"Measured cost settled after execution. A task settles once and cannot be retried after settlement.\",\n      ),\n    question: taskQuestionSchema.optional(),\n    questionTaskId: taskIdSchema\n      .optional()\n      .describe(\n        \"Open QuestionTask blocking this executable task, stored for direct answer routing.\",\n      ),\n    answerEventIds: z\n      .array(answerIdSchema)\n      .readonly()\n      .optional()\n      .describe(\"Immutable answer events projected onto this task for direct replay.\"),\n    changeId: changeIdSchema\n      .optional()\n      .describe(\"Change this executable task concerns or produces.\"),\n    reportRef: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Reference to the report artifact an investigation produced.\"),\n    createdAt: isoDateTimeSchema,\n    updatedAt: isoDateTimeSchema,\n  })\n  .superRefine((task, ctx) => {\n    if (task.failureReceiptId !== undefined && task.state !== \"failed\") {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"failureReceiptId\"],\n        message: \"failureReceiptId is only valid while the task is failed\",\n      });\n    }\n    if (\n      task.state !== \"stalled\" &&\n      (task.stalledAt !== undefined || task.stalledReason !== undefined)\n    ) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"stalledAt\"],\n        message: \"stalledAt and stalledReason are only valid while the task is stalled\",\n      });\n    }\n    if (\n      task.state === \"needs_human\" &&\n      (task.needsHumanAction === undefined || task.needsHumanAction.trim() === \"\")\n    ) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"needsHumanAction\"],\n        message: \"needs_human requires a populated, actionable needsHumanAction for a human reader\",\n      });\n    }\n    if (\n      task.state !== \"needs_human\" &&\n      (task.needsHumanAction !== undefined || task.needsHumanNotifiedAt !== undefined)\n    ) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"needsHumanAction\"],\n        message:\n          \"needsHumanAction and needsHumanNotifiedAt are only valid while the task is needs_human\",\n      });\n    }\n    if (\n      task.state === \"needs_human\" &&\n      ((task.question === undefined && task.questionTaskId === undefined) ||\n        (task.question !== undefined &&\n          (task.question.answer !== undefined || task.question.answeredBy !== undefined)))\n    ) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"question\"],\n        message: \"needs_human requires an unanswered question or a linked open QuestionTask\",\n      });\n    }\n    if (task.question !== undefined && task.questionTaskId !== undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"questionTaskId\"],\n        message: \"A task cannot both ask a question and be blocked by another question\",\n      });\n    }\n    if (\n      task.parentTaskAttempt !== undefined &&\n      (task.parentTaskId === undefined || task.question === undefined)\n    ) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"parentTaskAttempt\"],\n        message: \"parentTaskAttempt binds a child question to its parent's execution attempt\",\n      });\n    }\n    if (task.parentTaskId === task.id) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"parentTaskId\"],\n        message: \"parentTaskId cannot reference the task itself\",\n      });\n    }\n    if (task.parentTaskId === undefined && task.rootTaskId !== task.id) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"rootTaskId\"],\n        message: \"Root tasks must use their own id as rootTaskId\",\n      });\n    }\n    if (task.parentTaskId !== undefined && task.rootTaskId === task.id) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"rootTaskId\"],\n        message: \"Child tasks cannot use their own id as rootTaskId\",\n      });\n    }\n    if (\n      task.parentTaskId === undefined &&\n      task.origin.signalId === undefined &&\n      task.origin.operator === undefined\n    ) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"origin\"],\n        message: \"Root task origin requires a signalId or operator\",\n      });\n    }\n    if (task.waitingForMessages === true && task.state !== \"running\") {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"waitingForMessages\"],\n        message: \"waitingForMessages can only be true while work is running\",\n      });\n    }\n    if (task.state === \"succeeded\" && task.workResult === undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"workResult\"],\n        message: \"Succeeded tasks require a validated workflow result\",\n      });\n    }\n  });\n\ntype TaskRecord = z.infer<typeof taskRecordSchema>;\ntype SchemaWithOutput<Schema extends z.ZodType, Output> = Omit<Schema, keyof z.ZodType> &\n  z.ZodType<Output, z.input<Schema>>;\ntype TaskStateField =\n  | \"state\"\n  | \"workResult\"\n  | \"waitingForMessages\"\n  | \"failureReceiptId\"\n  | \"stalledAt\"\n  | \"stalledReason\"\n  | \"needsHumanAction\"\n  | \"needsHumanNotifiedAt\";\ntype TaskQuestionField = \"question\" | \"questionTaskId\" | \"parentTaskAttempt\" | \"parentTaskId\";\ntype TaskCommon = Omit<TaskRecord, TaskStateField | TaskQuestionField>;\ntype TaskIdValue = NonNullable<TaskRecord[\"parentTaskId\"]>;\ntype TaskWorkResult = NonNullable<TaskRecord[\"workResult\"]>;\n\ntype TaskWithoutQuestion = {\n  question?: never;\n  questionTaskId?: never;\n  parentTaskAttempt?: never;\n  parentTaskId?: TaskIdValue;\n};\n\ntype TaskWithQuestion<Question extends TaskRecord[\"question\"]> =\n  | {\n      question: Question;\n      questionTaskId?: never;\n      parentTaskAttempt?: never;\n      parentTaskId?: TaskIdValue;\n    }\n  | {\n      question: Question;\n      questionTaskId?: never;\n      parentTaskAttempt: number;\n      parentTaskId: TaskIdValue;\n    };\n\ntype TaskWithLinkedQuestion = {\n  question?: never;\n  questionTaskId: TaskIdValue;\n  parentTaskAttempt?: never;\n  parentTaskId?: TaskIdValue;\n};\n\ntype TaskQuestionContext =\n  | TaskWithoutQuestion\n  | TaskWithQuestion<NonNullable<TaskRecord[\"question\"]>>\n  | TaskWithLinkedQuestion;\n\ntype UnansweredTaskQuestion = Omit<NonNullable<TaskRecord[\"question\"]>, \"answer\" | \"answeredBy\"> & {\n  answer?: never;\n  answeredBy?: never;\n};\n\ntype InactiveStateFields = {\n  waitingForMessages?: false;\n  needsHumanAction?: never;\n  needsHumanNotifiedAt?: never;\n};\n\ntype UnstalledStateFields = {\n  stalledAt?: never;\n  stalledReason?: never;\n};\n\ntype NonFailedStateFields = {\n  failureReceiptId?: never;\n};\n\ntype InactiveOrdinaryTaskState<State extends \"queued\" | \"verifying\" | \"cancelled\"> =\n  InactiveStateFields &\n    UnstalledStateFields &\n    NonFailedStateFields & {\n      state: State;\n      workResult?: TaskWorkResult;\n    };\n\ntype OrdinaryTaskState =\n  | InactiveOrdinaryTaskState<\"queued\">\n  | InactiveOrdinaryTaskState<\"verifying\">\n  | InactiveOrdinaryTaskState<\"cancelled\">\n  | (UnstalledStateFields &\n      NonFailedStateFields & {\n        state: \"running\";\n        waitingForMessages?: boolean;\n        needsHumanAction?: never;\n        needsHumanNotifiedAt?: never;\n        workResult?: TaskWorkResult;\n      })\n  | (InactiveStateFields &\n      NonFailedStateFields & {\n        state: \"stalled\";\n        stalledAt?: string;\n        stalledReason?: string;\n        workResult?: TaskWorkResult;\n      })\n  | (InactiveStateFields &\n      UnstalledStateFields & {\n        state: \"failed\";\n        failureReceiptId?: NonNullable<TaskRecord[\"failureReceiptId\"]>;\n        workResult?: TaskWorkResult;\n      })\n  | (InactiveStateFields &\n      UnstalledStateFields &\n      NonFailedStateFields & {\n        state: \"succeeded\";\n        workResult: TaskWorkResult;\n      });\n\ntype NeedsHumanTaskState = UnstalledStateFields &\n  NonFailedStateFields & {\n    state: \"needs_human\";\n    waitingForMessages?: false;\n    needsHumanAction: string;\n    needsHumanNotifiedAt?: string;\n    workResult?: TaskWorkResult;\n  };\n\n/** Canonical durable snapshot of one explicitly versioned unit of workflow work. */\nexport type Task = TaskCommon &\n  (\n    | (OrdinaryTaskState & TaskQuestionContext)\n    | (NeedsHumanTaskState & (TaskWithQuestion<UnansweredTaskQuestion> | TaskWithLinkedQuestion))\n  );\n\n/** Validates the canonical durable snapshot of one unit of workflow work. */\nexport const taskSchema = taskRecordSchema as SchemaWithOutput<typeof taskRecordSchema, Task>;\n\n/** Human approval status recorded on a Task when policy requires a decision. */\nexport type TaskApproval = z.infer<typeof taskApprovalSchema>;\n/** Signal or operator provenance retained independently from Task graph parentage. */\nexport type TaskOrigin = z.infer<typeof taskOriginSchema>;\n/** Human question, suggested replies, and optional authenticated answer. */\nexport type TaskQuestion = z.infer<typeof taskQuestionSchema>;\n/** Fixed lifecycle state controlled through the canonical Task transition table. */\nexport type TaskState = z.infer<typeof taskStateSchema>;\n/** Task-local measured model usage with idempotent per-step accounting. */\nexport type TaskUsage = z.infer<typeof taskUsageSchema>;\n/** Opaque provider-owned execution handle for the current Task attempt. */\nexport type ExecutionReference = z.infer<typeof executionReferenceSchema>;\n/** Succeeded Task narrowed to its required validated workflow result. */\nexport type SucceededTask = Extract<Task, { state: \"succeeded\" }>;\n/** Human-blocked Task narrowed to its required actionable description. */\nexport type NeedsHumanTask = Extract<Task, { state: \"needs_human\" }>;\n/** Running Task narrowed to its explicit message-waiting marker. */\nexport type MessageWaitingTask = Extract<Task, { state: \"running\" }> & {\n  waitingForMessages: true;\n};\n\n/** Narrows a validated Task after checking its succeeded-state invariant. */\nexport function isSucceededTask(task: Task): task is SucceededTask {\n  return task.state === \"succeeded\" && task.workResult !== undefined;\n}\n\n/** Narrows a validated Task after checking its human-action invariant. */\nexport function isNeedsHumanTask(task: Task): task is NeedsHumanTask {\n  return task.state === \"needs_human\" && task.needsHumanAction !== undefined;\n}\n\n/** Narrows a validated Task to running work deliberately waiting for messages. */\nexport function isMessageWaitingTask(task: Task): task is MessageWaitingTask {\n  return task.state === \"running\" && task.waitingForMessages === true;\n}\n"],"mappings":";;;;;;AAoBA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;AACF;;AAMA,MAAa,iBAAiB,iBAAiB,SAC7C,qFACF;;AAGA,MAAa,kBAAkB,EAC5B,KAAK;CACJ;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,CACD,SAAS,8DAA8D;;AAG1E,MAAa,qBAAqB,EAC/B,KAAK;CAAC;CAAY;CAAW;AAAQ,CAAC,CAAC,CACvC,SACC,sIACF;;AAGF,MAAa,mCAAmC,EAC7C,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAC3B,SAAS,CAAC,CACV,SAAS,4CAA4C;;AAGxD,MAAa,mBAAmB,EAC7B,aAAa;CACZ,UAAU,eAAe,SAAS,CAAC,CAAC,SAAS,+BAA+B;CAC5E,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,kCAAkC;AACpF,CAAC,CAAC,CACD,SAAS,mFAAmF;;AAG/F,MAAa,gBAAgB,EAC1B,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,qFAAqF;;;;;;AAOjG,MAAa,2BAA2B,EAAE,aAAa;CACrD,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,+BAA+B;CACpE,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,6CAA6C;CACnF,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,sCAAsC;CAC3F,SAAS,cAAc,SAAS;CAChC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,yCAAyC;AAC1F,CAAC;AAED,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY;;AAGtD,MAAa,kBAAkB,EAAE,aAAa;CAC5C,SAAS,UAAU,SAAS,6CAA6C;CACzE,aAAa;CACb,cAAc;CACd,iBAAiB;CACjB,kBAAkB;CAClB,OAAO,EACJ,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAC3C,SAAS,kFAAkF;AAChG,CAAC;;AAGD,MAAa,qBAAqB,EAAE,aAAa;CAC/C,MAAM,EACH,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,oEAAoE;CAChF,SAAS,EACN,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACxB,SAAS,CAAC,CACV,SAAS,+CAA+C;;;;;;;;CAQ3D,gBAAgB,EACb,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACxB,IAAI,EAAE,CAAC,CACP,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SACC,8FACF;CACF,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;CACnC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,sCAAsC;AAC1F,CAAC;;AAmWD,MAAa,aAhWY,EACtB,aAAa;CACZ,eAAe;CACf,IAAI;CACJ,eAAe,oBAAoB,SAAS,iCAAiC;CAC7E,MAAM;CACN,MAAM,EACH,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,CAAC,CACV,SAAS,sDAAsD;CAClE,OAAO;CACP,UAAU,mBAAmB,SAAS;CACtC,QAAQ;CACR,MAAM,eAAe,SAAS,qDAAqD;CACnF,YAAY,qBAAqB,SAAS,CAAC,CAAC,SAAS,sCAAsC;CAC3F,oBAAoB,EACjB,QAAQ,CAAC,CACT,SAAS,CAAC,CACV,SAAS,gEAAgE;CAC5E,eAAe,sBAAsB,MAAM,GACxC,SAAS,CAAC,CACV,SAAS,iFAAiF;CAC7F,YAAY,aAAa,SAAS,sDAAsD;CACxF,cAAc,aACX,SAAS,CAAC,CACV,SAAS,8DAA8D;CAC1E,mBAAmB,EAChB,OAAO,CAAC,CACR,IAAI,CAAC,CACL,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SACC,mGACF;CACF,SAAS;CACT,gCAAgC,EAC7B,MAAM,eAAe,CAAC,CACtB,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SACC,oFACF;CACF,kBAAkB,gBACf,SAAS,CAAC,CACV,SACC,gGACF;CACF,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,mDAAmD;CAC7F,WAAW,yBACR,SAAS,CAAC,CACV,SAAS,+EAA+E;CAC3F,gBAAgB,kBACb,SAAS,CAAC,CACV,SACC,qFACF;CACF,WAAW,kBACR,SAAS,CAAC,CACV,SAAS,8CAA8C;CAC1D,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,kCAAkC;CACvF,kBAAkB,EACf,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,CAAC,CACV,SACC,sLACF;CACF,sBAAsB,kBACnB,SAAS,CAAC,CACV,SACC,6IACF;CACF,aAAa,UAAU,SAAS,CAAC,CAAC,SAAS,kCAAkC;CAC7E,YAAY,kBACT,SAAS,CAAC,CACV,SAAS,uEAAuE;CACnF,OAAO,gBACJ,SAAS,CAAC,CACV,SACC,wFACF;CACF,YAAY,UACT,SAAS,CAAC,CACV,SACC,oGACF;CACF,UAAU,mBAAmB,SAAS;CACtC,gBAAgB,aACb,SAAS,CAAC,CACV,SACC,oFACF;CACF,gBAAgB,EACb,MAAM,cAAc,CAAC,CACrB,SAAS,CAAC,CACV,SAAS,CAAC,CACV,SAAS,qEAAqE;CACjF,UAAU,eACP,SAAS,CAAC,CACV,SAAS,mDAAmD;CAC/D,WAAW,EACR,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,SAAS,CAAC,CACV,SAAS,6DAA6D;CACzE,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,aAAa,MAAM,QAAQ;CAC1B,IAAI,KAAK,qBAAqB,KAAA,KAAa,KAAK,UAAU,UACxD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,kBAAkB;EACzB,SAAS;CACX,CAAC;CAEH,IACE,KAAK,UAAU,cACd,KAAK,cAAc,KAAA,KAAa,KAAK,kBAAkB,KAAA,IAExD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,WAAW;EAClB,SAAS;CACX,CAAC;CAEH,IACE,KAAK,UAAU,kBACd,KAAK,qBAAqB,KAAA,KAAa,KAAK,iBAAiB,KAAK,MAAM,KAEzE,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,kBAAkB;EACzB,SAAS;CACX,CAAC;CAEH,IACE,KAAK,UAAU,kBACd,KAAK,qBAAqB,KAAA,KAAa,KAAK,yBAAyB,KAAA,IAEtE,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,kBAAkB;EACzB,SACE;CACJ,CAAC;CAEH,IACE,KAAK,UAAU,kBACb,KAAK,aAAa,KAAA,KAAa,KAAK,mBAAmB,KAAA,KACtD,KAAK,aAAa,KAAA,MAChB,KAAK,SAAS,WAAW,KAAA,KAAa,KAAK,SAAS,eAAe,KAAA,KAExE,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,UAAU;EACjB,SAAS;CACX,CAAC;CAEH,IAAI,KAAK,aAAa,KAAA,KAAa,KAAK,mBAAmB,KAAA,GACzD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,gBAAgB;EACvB,SAAS;CACX,CAAC;CAEH,IACE,KAAK,sBAAsB,KAAA,MAC1B,KAAK,iBAAiB,KAAA,KAAa,KAAK,aAAa,KAAA,IAEtD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,mBAAmB;EAC1B,SAAS;CACX,CAAC;CAEH,IAAI,KAAK,iBAAiB,KAAK,IAC7B,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,cAAc;EACrB,SAAS;CACX,CAAC;CAEH,IAAI,KAAK,iBAAiB,KAAA,KAAa,KAAK,eAAe,KAAK,IAC9D,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,YAAY;EACnB,SAAS;CACX,CAAC;CAEH,IAAI,KAAK,iBAAiB,KAAA,KAAa,KAAK,eAAe,KAAK,IAC9D,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,YAAY;EACnB,SAAS;CACX,CAAC;CAEH,IACE,KAAK,iBAAiB,KAAA,KACtB,KAAK,OAAO,aAAa,KAAA,KACzB,KAAK,OAAO,aAAa,KAAA,GAEzB,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,QAAQ;EACf,SAAS;CACX,CAAC;CAEH,IAAI,KAAK,uBAAuB,QAAQ,KAAK,UAAU,WACrD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,oBAAoB;EAC3B,SAAS;CACX,CAAC;CAEH,IAAI,KAAK,UAAU,eAAe,KAAK,eAAe,KAAA,GACpD,IAAI,SAAS;EACX,MAAM;EACN,MAAM,CAAC,YAAY;EACnB,SAAS;CACX,CAAC;AAEL,CAiIwB;;AAwB1B,SAAgB,gBAAgB,MAAmC;CACjE,OAAO,KAAK,UAAU,eAAe,KAAK,eAAe,KAAA;AAC3D;;AAGA,SAAgB,iBAAiB,MAAoC;CACnE,OAAO,KAAK,UAAU,iBAAiB,KAAK,qBAAqB,KAAA;AACnE;;AAGA,SAAgB,qBAAqB,MAAwC;CAC3E,OAAO,KAAK,UAAU,aAAa,KAAK,uBAAuB;AACjE"}