Function createProgressToolEntries

packages/core/src/progress/actions.ts:24–169

(
  getCurrentUser: () => string,
)

}

export function createProgressToolEntries(
  getCurrentUser: () => string,
): Record<string, ActionEntry> {
  return {
    "manage-progress": {
      tool: {
        description: `Manage long-running task progress visible to the user. Use this whenever a task will take more than a few seconds so the user can watch status in the runs tray.

Actions:
• "start" — Begin tracking a new task. Returns a runId to pass to subsequent calls. Params: title (required), step (optional initial step text), metadataJson (optional JSON string with link/thread/artifact info).
• "update" — Report progress on a running task. Call frequently during long loops. Params: runId (required), percent (optional 0–100), step (optional current step text). Omitted fields stay unchanged.
• "complete" — Mark a task as finished. Params: runId (required), status (required: "succeeded" | "failed" | "cancelled"), step (optional final step text). Pairs well with \`notify\` to tell the user the outcome.
• "list" — List the user's recent runs. Use when the user asks "what is still running" or "what did you do earlier". Params: active (optional boolean, filter to in-progress only), limit (optional number, default 20, max 200).`,
        parameters: {
          type: "object" as const,
          properties: {
            action: {
              type: "string",
              enum: ["start", "update", "complete", "list"],
              description:
                'The operation to perform: "start" a new run, "update" progress, "complete" a run, or "list" recent runs.',
            },
            title: {
              type: "string",
              description:
                '[start] Short human-readable title, e.g. "Triage 128 unread emails".',
            },
            step: {
              type: "string",
              description:
                '[start/update/complete] Step description, e.g. "Fetching inbox" or "Drafting reply 23/100".',
            },
            metadataJson: {
              type: "string",
              description:
                "[start] Optional JSON metadata: link, thread id, artifact path, etc.",
            },
            runId: {
              type: "string",
              description:
                '[update/complete] The id returned by a "start" action.',
            },
            percent: {
              type: "number",
              description:
                "[update] Progress 0–100. Omit if the task has no known upper bound.",
            },
            status: {
              type: "string",
              enum: ["succeeded", "failed", "cancelled"],
              description: "[complete] Terminal status for the run.",
            },
            active: {
              type: "boolean",
              description:
                "[list] When true, only return runs still in progress.",
            },
            limit: {