Function buildTaskListTool

packages/runtime/src/task-ledger-tools.ts:224–280

(store: TaskLedgerStore)

}

function buildTaskListTool(store: TaskLedgerStore): MakaTool<
  {
    status?: (typeof TASK_STATUSES)[number];
    include_terminal?: boolean;
    include_archived?: boolean;
  },
  string
> {
  return {
    name: TASK_LIST_TOOL_NAME,
    displayName: 'Task List',
    description: 'List the current session task ledger in compact form.',
    parameters: z
      .object({
        status: z.enum(TASK_STATUSES).optional().describe('Optional exact status filter.'),
        include_terminal: z
          .boolean()
          .optional()
          .describe('Include terminal tasks. Defaults to true for compatibility.'),
        include_archived: z
          .boolean()
          .optional()
          .describe(
            'Include terminal tasks older than seven days. Defaults to true for compatibility.',
          ),
      })
      .superRefine((input, ctx) => {
        if (
          input.status &&
          isTerminalTaskStatus(input.status) &&
          input.include_terminal === false
        ) {
          ctx.addIssue({
            code: z.ZodIssueCode.custom,
            path: ['include_terminal'],
            message: 'A terminal status filter conflicts with include_terminal=false.',
          });
        }
      }),
    impl: async (input, ctx) => {
      const tasks = filterModelVisibleTaskLedgerTasks(
        await store.list(ctx.sessionId, {
          ...(input.status ? { status: input.status } : {}),
          ...(input.include_terminal !== undefined
            ? { includeTerminal: input.include_terminal }
            : {}),
          ...(input.include_archived !== undefined
            ? { includeArchived: input.include_archived }
            : {}),
        }),
      );
      return tasks.length === 0
        ? 'Task ledger is empty.'
        : `Task ledger total: ${tasks.length}.\n${renderSafeTaskLedgerText(tasks)}`;
    },
  };
}