Start session - Automate.ax

anthropic.startSession starts a Claude agent session without waiting for a turn to finish.

Example

automations/anthropic-start-session.automation.ts

import { automation, onInvocation, withPrerequisites } from "automate.ax"
import { anthropic } from "automate.ax/anthropic"

export default automation("Start session", () => {
  withPrerequisites(onInvocation(), () => {
    anthropic.startSession({
      agent: "agent-id",
      environmentId: "environment-id",
      initialEvents: [
        {
          type: "user.message",
          content: [{ type: "text", text: "Review the repository." }],
        },
      ],
    })
  })
})

Inputs

Requires agent and environmentId. Optional fields include initialEvents (maximum 50), budget, resources, vaultIds, title, and metadata. Budgets use whole-cent USD strings. Inputs use public camelCase names and accept signals.

Output and behavior

Returns the new session immediately. Use runAgent for durable first-turn completion. Anthropic requests time out before the action lease and provider mutations are not retried after an uncertain response unless stated otherwise.