Function buildTaskUpdateTool

packages/runtime/src/task-ledger-tools.ts:86–222

(
  store: TaskLedgerStore,
  name: string,
)

}

function buildTaskUpdateTool(
  store: TaskLedgerStore,
  name: string,
): MakaTool<
  {
    id: string;
    status?: (typeof TASK_STATUSES)[number];
    subject?: string;
    blockedReason?: string;
    failureReason?: string;
    completionEvidence?: string;
    explicitReopen?: boolean;
  },
  string
> {
  return {
    name,
    displayName: 'Task Update',
    description:
      'Update a task in the session task ledger by id. Mark tasks in_progress when you start them; ' +
      'blocked, failed, and completed updates require a reason or evidence field. ' +
      'Reopening completed/cancelled tasks requires explicitReopen=true.',
    parameters: z
      .object({
        id: z
          .string()
          .min(1)
          .max(TASK_ID_MAX_CHARS)
          .refine(
            isSafeTaskId,
            'Task reference must be a UUID or short key from the current ledger.',
          )
          .describe('Task UUID or short key.'),
        status: z.enum(TASK_STATUSES).optional().describe('New task status.'),
        subject: z
          .string()
          .trim()
          .min(1)
          .max(TASK_SUBJECT_MAX_CHARS)
          .optional()
          .describe(`Revised task description (max ${TASK_SUBJECT_MAX_CHARS} characters).`),
        blockedReason: z
          .string()
          .trim()
          .min(1)
          .max(TASK_EVIDENCE_MAX_CHARS)
          .optional()
          .describe(
            'Required when setting status to blocked. Explain the external input, dependency, or permission needed.',
          ),
        failureReason: z
          .string()
          .trim()
          .min(1)
          .max(TASK_EVIDENCE_MAX_CHARS)
          .optional()
          .describe(
            'Required when setting status to failed. Explain why the task cannot be completed.',