Agent SDK reference - TypeScript changedagent-sdk/typescript
Upstream edited this page at 28 Oct 2026 19:51 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 28 Oct 2026 20:07 UTC.
Upstream edited
Recorded here
Lines+15added
Lines−6removed
From line
4,702
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits124to this page, all time
The whole hunk
from line 4702, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 4702
47024702 humanSchedule: string;
47034703 recurring: boolean;
47044704 durable?: boolean; // true when persisted to .claude/scheduled_tasks.json; false when session-only
4705 nextFireAt?: number;
47054706};
47064707```
47074708
4708Returns the job ID and a human-readable description of the schedule.
4709Returns the job ID, a human-readable schedule, and the next run time. `nextFireAt` gives it in epoch milliseconds, with [jitter](https://code.claude.com/docs/en/scheduled-tasks.md#jitter) already applied, so it's when the job is set to run. The field requires TypeScript Agent SDK v0.3.299 or later and Claude Code v2.1.299 or later.
47094710
47104711### CronDelete
47114712
from line 4733
47324733 prompt: string;
47334734 recurring?: boolean;
47344735 durable?: boolean;
4736 nextFireAt?: number;
47354737 }[];
47364738};
47374739```
from line 4740
47384740
47394741Returns the scheduled cron jobs: durable jobs from `.claude/scheduled_tasks.json` and session-only jobs from the current session. A session-only job carries `durable: false`; jobs read from disk omit the field.
47404742
4743`nextFireAt` is the job's next run time in epoch milliseconds, [jitter](https://code.claude.com/docs/en/scheduled-tasks.md#jitter) included. No value is earlier than the `CronList` call: a job whose time [passed without a run](https://code.claude.com/docs/en/scheduled-tasks.md#how-scheduled-tasks-run) carries the call's time. The field requires TypeScript Agent SDK v0.3.299 or later and Claude Code v2.1.299 or later.
4744
47414745### ScheduleWakeup
47424746
47434747**Tool name:** `ScheduleWakeup`
from line 4842
48384842 truncated?: boolean;
48394843 total?: number;
48404844 total_at_least?: true;
4841 scope?: "shared" | "all";
4842 };
4843```
4844
4845Returns the published page's `url` and the local `path` that was published for the publish action, with `updated` set to true when the publish redeployed an existing artifact, and `warnings` carrying any publish-time advisories. The list action returns the `artifacts` rows instead, with `truncated` set when more artifacts exist than the requested limit. On listings whose scope isn't `"mine"`, each row carries `rel` marking whether the user owns the artifact or it was shared with them, and the output's `scope` records which non-default scope produced the listing; both are absent on default listings.
4846
4847A list result also reports `total`, the number of artifacts that match the listed scope, inc
4845 sc
No line in this hunk matches that.