Run your first task
Go from API key to a completed Run.
Build a programmable Runbook
Combine exact primitives with bounded agent steps.
Explore the REST API
Review authentication, resources, statuses, and public endpoints.
Use the TypeScript SDK
Author typed Runbooks and poll durable Runs.
Two resources
Runbooks
Runbooks
Reusable, versioned definitions containing exact primitive steps and bounded agent steps. Published revisions are immutable once selected by a Run.
Runs
Runs
One execution of a published Runbook revision or an ad-hoc task. Runs provide durable status, results, errors, and cancellation.
Local and cloud execution
UseexecutionTarget: "local" when work needs a paired Infragrid Desktop and
its approved applications. Use cloud for supported managed browser
primitives. The Runbook definition stays provider-neutral.
Durable by default
Every accepted Run receives an ID immediately. Use it to recover status after a process restart, wait for a terminal result, or cancel work. Mutation requests can carry an idempotency key so safe retries recover the original resource.The unscoped TypeScript package is in preview from the
infragrid repository.
Existing Python and MCP releases retain their current contracts until their Runbook migration is complete.Security boundary
Workspace API keys are server credentials. Never ship anig_live_ key in
browser JavaScript, URLs, logs, or source control. Starting a Run is not blanket
approval for later external writes or destructive computer actions.