github-actions[bot]
86ef3c4979
📚 Publish docs / publish (push) Has been cancelled
🚀 Publish Trigger.dev Docker / units (push) Failing after 20s
🚀 Publish Trigger.dev Docker / typecheck (push) Failing after 20s
🚀 Publish Trigger.dev Docker / publish-webapp (push) Has been skipped
🚀 Publish Trigger.dev Docker / publish-worker (push) Has been skipped
🚀 Publish Trigger.dev Docker / publish-worker-v4 (push) Has been skipped
🚀 Publish Trigger.dev Docker / scan-webapp (push) Has been skipped
🧭 Helm Chart Release / lint-and-test (push) Has been cancelled
🧭 Helm Chart Release / release (push) Has been cancelled
🚀 Publish Trigger.dev Docker / 📣 Dispatch main image (push) Has been cancelled
# Trigger.dev v4.5.0
4.5.0 is the GA of the AI Agents platform. Everything built during the
prerelease line (durable agents, Sessions, AI Prompts) is now stable on
the `latest` tag, alongside a set of SDK and runtime improvements.
## AI Agents (`chat.agent`)
Run Vercel AI SDK chat completions as durable Trigger.dev tasks instead
of fragile API routes. A conversation runs as one long-lived task keyed
on `chatId`, so it survives page refreshes, network blips, redeploys,
and crashes, and every turn is a span in the dashboard.
```ts
import { chat } from "@trigger.dev/sdk/ai";
import { streamText, stepCountIs } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
export const myChat = chat.agent({
id: "my-chat",
run: async ({ messages, signal }) => {
return streamText({
...chat.toStreamTextOptions(), // system prompt, compaction, steering, telemetry
model: anthropic("claude-sonnet-4-5"),
messages,
abortSignal: signal,
stopWhen: stepCountIs(15),
});
},
});
```
## Sessions
The durable primitive underneath `chat.agent`, usable on its own: a
run-aware, bidirectional stream channel keyed on a stable `externalId`
whose `.in` / `.out` streams survive run boundaries (suspend, crash,
idle-timeout, redeploy). One Session spans many runs, which makes it a
good fit for agent inboxes and approval flows.
```ts
import { sessions } from "@trigger.dev/sdk";
// Create the session and trigger its first run (idempotent on externalId)
await sessions.start({
type: "inbox",
externalId: userId,
taskIdentifier: "inbox-agent",
});
const session = sessions.open(userId);
await session.in.send({ text: "hello" });
const stream = await session.out.read({ signal: AbortSignal.timeout(30_000) });
for await (const chunk of stream) console.log(chunk); // durable across run swaps
```
## AI Prompts
Define prompt templates as code, versioned on every deploy, and override
the text or model from the dashboard without redeploying
(environment-scoped). Each generation links back to its prompt version
for usage, cost, and latency.
```ts
import { prompts } from "@trigger.dev/sdk";
import { z } from "zod";
export const supportPrompt = prompts.define({
id: "customer-support",
model: "gpt-4o",
variables: z.object({ customerName: z.string(), issue: z.string() }),
content: `You are a support agent for Acme.
Customer: {{customerName}}
Issue: {{issue}}`,
});
// Honors any active dashboard override, else the current deployed version
const resolved = await supportPrompt.resolve({ customerName: "Alice", issue: "Can't log in" });
// resolved.text, resolved.model, resolved.version
```
## `useChat` integration
`useTriggerChatTransport` is a Vercel AI SDK `ChatTransport` that runs
`useChat` over Trigger.dev realtime with no API routes. Text, tool
calls, reasoning, and `data-*` parts stream natively, and it works with
AI SDK v5, v6, and now v7.
## First-turn fast path (`chat.headStart`)
Runs the first turn in your warm server process while the agent boots in
parallel, cutting cold-start time-to-first-chunk roughly in half
(measured ~2.8s to ~1.2s). Available via the new
`@trigger.dev/sdk/chat-server` subpath.
## Human-in-the-loop, stop, and steering
The agent control surface: tool approvals (`needsApproval` +
`addToolApprovalResponse`), client-driven stop-generation, mid-execution
steering (`pendingMessages`), and between-turn context injection
(`chat.inject` / `chat.defer`), all durable across the conversation.
## Agent Skills
`skills.define({ id, path })` bundles a `SKILL.md` folder into your
deploy image. The agent gets a one-line summary up front and loads the
full instructions plus scoped `bash` / `readFile` tools on demand
(progressive disclosure), so a capability is something the model reaches
for rather than a pre-declared typed tool.
## `trigger skills` for coding assistants
`trigger skills` installs version-pinned Trigger.dev skills plus a
bundled docs snapshot into Claude Code, Cursor, GitHub Copilot, and
Codex, so your assistant's Trigger.dev knowledge stays current with your
installed SDK version. `trigger init` now offers to set up the MCP
server and skills too.
## Model library
A new Models page in the dashboard: a catalog of models grouped by
provider with context window, capabilities, and input / output pricing
per 1M tokens, plus a "Your models" tab showing per-model usage, cost,
and cache-hit sparklines from your actual traffic.
## Dev branches
Run multiple local `trigger dev` sessions in parallel (separate git
worktrees or coding agents) without runs colliding, each isolated with
its own dashboard, via `trigger dev --branch <name>`.
## `TriggerClient`
An instantiable client so one process can trigger and read across
projects, environments, and preview branches, each with its own auth and
baseURL, with no shared global state.
```ts
import { TriggerClient } from "@trigger.dev/sdk";
const prod = new TriggerClient({ accessToken: process.env.TRIGGER_PROD_KEY });
const preview = new TriggerClient({
accessToken: process.env.TRIGGER_PREVIEW_KEY,
previewBranch: "signup-flow",
});
await prod.tasks.trigger("send-email", { to: "user@example.com" });
await preview.runs.list({ status: ["COMPLETED"] });
```
## SDK and runtime
- AI SDK 7 support (v5 and v6 still supported), with OpenTelemetry
telemetry auto-wired
- Large trigger-payload offload: trigger payloads at or above 128KB
upload to object storage automatically, using the same auth and baseURL
as the trigger call
- Region support on the runs API: filter runs by region and read each
run's executing region (also on MCP `list_runs`)
- Duplicate task-id detection: `dev` and `deploy` fail with a clear
error instead of silently overwriting
- `envvars.upload` gains an `isSecret` flag to import redacted secret
variables
- Retry hardening: `TASK_MIDDLEWARE_ERROR` now retries under the task's
retry policy
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
11 KiB
11 KiB
@trigger.dev/python
4.5.0
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0@trigger.dev/core@4.5.0@trigger.dev/build@4.5.0
4.5.0-rc.7
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0-rc.7@trigger.dev/core@4.5.0-rc.7@trigger.dev/build@4.5.0-rc.7
4.5.0-rc.6
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0-rc.6@trigger.dev/core@4.5.0-rc.6@trigger.dev/build@4.5.0-rc.6
4.5.0-rc.5
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0-rc.5@trigger.dev/core@4.5.0-rc.5@trigger.dev/build@4.5.0-rc.5
4.5.0-rc.4
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0-rc.4@trigger.dev/core@4.5.0-rc.4@trigger.dev/build@4.5.0-rc.4
4.5.0-rc.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.5.0-rc.3@trigger.dev/build@4.5.0-rc.3@trigger.dev/sdk@4.5.0-rc.3
4.5.0-rc.2
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0-rc.2@trigger.dev/build@4.5.0-rc.2@trigger.dev/core@4.5.0-rc.2
4.5.0-rc.1
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.5.0-rc.1@trigger.dev/build@4.5.0-rc.1@trigger.dev/sdk@4.5.0-rc.1
4.5.0-rc.0
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.5.0-rc.0@trigger.dev/core@4.5.0-rc.0@trigger.dev/build@4.5.0-rc.0
4.4.6
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.4.6@trigger.dev/build@4.4.6@trigger.dev/sdk@4.4.6
4.4.5
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.4.5@trigger.dev/build@4.4.5@trigger.dev/sdk@4.4.5
4.4.4
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.4.4@trigger.dev/core@4.4.4@trigger.dev/build@4.4.4
4.4.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.4.3@trigger.dev/build@4.4.3@trigger.dev/sdk@4.4.3
4.4.2
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.4.2@trigger.dev/build@4.4.2@trigger.dev/core@4.4.2
4.4.1
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.4.1@trigger.dev/build@4.4.1@trigger.dev/core@4.4.1
4.4.0
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.4.0@trigger.dev/sdk@4.4.0@trigger.dev/build@4.4.0
4.3.3
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.3.3@trigger.dev/core@4.3.3@trigger.dev/build@4.3.3
4.3.2
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.3.2@trigger.dev/build@4.3.2@trigger.dev/core@4.3.2
4.3.1
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.3.1@trigger.dev/core@4.3.1@trigger.dev/build@4.3.1
4.3.0
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.3.0@trigger.dev/build@4.3.0@trigger.dev/sdk@4.3.0
4.2.0
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.2.0@trigger.dev/sdk@4.2.0@trigger.dev/core@4.2.0
4.1.2
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.1.2@trigger.dev/core@4.1.2@trigger.dev/sdk@4.1.2
4.1.1
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.1.1@trigger.dev/core@4.1.1@trigger.dev/sdk@4.1.1
4.1.0
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.1.0@trigger.dev/build@4.1.0@trigger.dev/core@4.1.0
4.0.7
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.7@trigger.dev/core@4.0.7@trigger.dev/sdk@4.0.7
4.0.6
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.6@trigger.dev/build@4.0.6@trigger.dev/sdk@4.0.6
4.0.5
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.5@trigger.dev/build@4.0.5@trigger.dev/sdk@4.0.5
4.0.4
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.4@trigger.dev/core@4.0.4@trigger.dev/sdk@4.0.4
4.0.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.3@trigger.dev/sdk@4.0.3@trigger.dev/build@4.0.3
4.0.2
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.2@trigger.dev/core@4.0.2@trigger.dev/sdk@4.0.2
4.0.1
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.1@trigger.dev/core@4.0.1@trigger.dev/sdk@4.0.1
4.0.0
Major Changes
- Trigger.dev v4 release. Please see our upgrade to v4 docs to view the full changelog: https://trigger.dev/docs/upgrade-to-v4 (#1869)
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0@trigger.dev/core@4.0.0@trigger.dev/build@4.0.0
4.0.0-v4-beta.28
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.28@trigger.dev/core@4.0.0-v4-beta.28@trigger.dev/build@4.0.0-v4-beta.28
4.0.0-v4-beta.27
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.27@trigger.dev/build@4.0.0-v4-beta.27@trigger.dev/core@4.0.0-v4-beta.27
4.0.0-v4-beta.26
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.26@trigger.dev/build@4.0.0-v4-beta.26@trigger.dev/core@4.0.0-v4-beta.26
4.0.0-v4-beta.25
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.25@trigger.dev/core@4.0.0-v4-beta.25@trigger.dev/sdk@4.0.0-v4-beta.25
4.0.0-v4-beta.24
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.24@trigger.dev/build@4.0.0-v4-beta.24@trigger.dev/core@4.0.0-v4-beta.24
4.0.0-v4-beta.23
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.23@trigger.dev/core@4.0.0-v4-beta.23@trigger.dev/build@4.0.0-v4-beta.23
4.0.0-v4-beta.22
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.22@trigger.dev/sdk@4.0.0-v4-beta.22@trigger.dev/build@4.0.0-v4-beta.22
4.0.0-v4-beta.21
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.21@trigger.dev/build@4.0.0-v4-beta.21@trigger.dev/sdk@4.0.0-v4-beta.21
4.0.0-v4-beta.20
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.20@trigger.dev/core@4.0.0-v4-beta.20@trigger.dev/sdk@4.0.0-v4-beta.20
4.0.0-v4-beta.19
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.19@trigger.dev/sdk@4.0.0-v4-beta.19@trigger.dev/build@4.0.0-v4-beta.19
4.0.0-v4-beta.18
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.18@trigger.dev/core@4.0.0-v4-beta.18@trigger.dev/sdk@4.0.0-v4-beta.18
4.0.0-v4-beta.17
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.17@trigger.dev/build@4.0.0-v4-beta.17@trigger.dev/sdk@4.0.0-v4-beta.17
4.0.0-v4-beta.16
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.16@trigger.dev/core@4.0.0-v4-beta.16@trigger.dev/sdk@4.0.0-v4-beta.16
4.0.0-v4-beta.15
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.15@trigger.dev/core@4.0.0-v4-beta.15@trigger.dev/sdk@4.0.0-v4-beta.15
4.0.0-v4-beta.14
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.14@trigger.dev/build@4.0.0-v4-beta.14@trigger.dev/core@4.0.0-v4-beta.14
4.0.0-v4-beta.13
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.13@trigger.dev/build@4.0.0-v4-beta.13@trigger.dev/sdk@4.0.0-v4-beta.13
4.0.0-v4-beta.12
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.12@trigger.dev/build@4.0.0-v4-beta.12@trigger.dev/core@4.0.0-v4-beta.12
4.0.0-v4-beta.11
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.11@trigger.dev/build@4.0.0-v4-beta.11@trigger.dev/core@4.0.0-v4-beta.11
4.0.0-v4-beta.10
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.10@trigger.dev/build@4.0.0-v4-beta.10@trigger.dev/sdk@4.0.0-v4-beta.10
4.0.0-v4-beta.9
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.9@trigger.dev/core@4.0.0-v4-beta.9@trigger.dev/sdk@4.0.0-v4-beta.9
4.0.0-v4-beta.8
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.8@trigger.dev/build@4.0.0-v4-beta.8@trigger.dev/sdk@4.0.0-v4-beta.8
4.0.0-v4-beta.7
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.7@trigger.dev/build@4.0.0-v4-beta.7@trigger.dev/sdk@4.0.0-v4-beta.7
4.0.0-v4-beta.6
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.6@trigger.dev/sdk@4.0.0-v4-beta.6@trigger.dev/build@4.0.0-v4-beta.6
4.0.0-v4-beta.5
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.5@trigger.dev/build@4.0.0-v4-beta.5@trigger.dev/core@4.0.0-v4-beta.5
4.0.0-v4-beta.4
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.4@trigger.dev/build@4.0.0-v4-beta.4@trigger.dev/core@4.0.0-v4-beta.4
4.0.0-v4-beta.3
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.3@trigger.dev/build@4.0.0-v4-beta.3@trigger.dev/sdk@4.0.0-v4-beta.3
4.0.0-v4-beta.2
Patch Changes
- Updated dependencies:
@trigger.dev/core@4.0.0-v4-beta.2@trigger.dev/build@4.0.0-v4-beta.2@trigger.dev/sdk@4.0.0-v4-beta.2
4.0.0-v4-beta.1
Patch Changes
- Updated dependencies:
@trigger.dev/build@4.0.0-v4-beta.1@trigger.dev/core@4.0.0-v4-beta.1@trigger.dev/sdk@4.0.0-v4-beta.1
4.0.0-v4-beta.0
Major Changes
- Trigger.dev v4 release. Please see our upgrade to v4 docs to view the full changelog: https://trigger.dev/docs/upgrade-to-v4 (#1869)
Patch Changes
- Updated dependencies:
@trigger.dev/sdk@4.0.0-v4-beta.0@trigger.dev/build@4.0.0-v4-beta.0@trigger.dev/core@4.0.0-v4-beta.0
3.3.17
Patch Changes
- Introduced a new Python extension to enhance the build process. It now allows users to execute Python scripts with improved support and error handling. (#1686)
- Updated dependencies:
@trigger.dev/sdk@3.3.17@trigger.dev/core@3.3.17@trigger.dev/build@3.3.17