@grok/agent-sdk 0.7.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/channels/github/cursor-account.d.ts +1 -0
- package/dist/channels/github/cursor-account.d.ts.map +1 -1
- package/dist/channels/github/cursor-account.js +8 -2
- package/dist/channels/origin/cursor-account.d.ts +6 -0
- package/dist/channels/origin/cursor-account.d.ts.map +1 -1
- package/dist/channels/origin/cursor-account.js +17 -0
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.Ch-048af.js → app.CpLKJnOA.js} +4 -4
- package/dist/docs/assets/changelog.md.DoOgjnPC.js +1 -0
- package/dist/docs/assets/{changelog.md.SoN0MK7o.lean.js → changelog.md.DoOgjnPC.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BJ_1eI6D.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.D7BIa9Su.js → VPLocalSearchBox.Cr1HJ_9k.js} +1 -1
- package/dist/docs/assets/chunks/{arc.BIzu7OVF.js → arc.BjpgGAMM.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.DNznI0Sn.js → architectureDiagram-Q4EWVU46.CKdhNPPk.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.B4y6Y5eG.js → baseUniq.iovoEQbg.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BudnBsgw.js → blockDiagram-DXYQGD6D.BYQIeDre.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY._bB00GdB.js → c4Diagram-AHTNJAMY.gbWi2q8N.js} +1 -1
- package/dist/docs/assets/chunks/channel.BP0n324b.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.CRftnUwS.js → chunk-4BX2VUAB.1Mem4UG9.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CSx1x2Ob.js → chunk-4TB4RGXK.Dn3H-X_H.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.KkLHAAbH.js → chunk-55IACEB6.BkpSDZwX.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DDeKCCtX.js → chunk-EDXVE4YY.BScqy1zP.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DrLlsD9m.js → chunk-FMBD7UC4.Cp394LWf.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.DeVYOGcT.js → chunk-OYMX7WX6.BDv9LhoL.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.Cz4_bS6p.js → chunk-QZHKN3VN.CsgCcrKO.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.CwrYtDVo.js → chunk-YZCP3GAM.BKBpIC5O.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BhTtyWMA.js +1 -0
- package/dist/docs/assets/chunks/clone.BVK2rFqj.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.3d8hflz6.js → cose-bilkent-S5V4N54A.Bs3ZS9PC.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.BVEgjiPg.js → dagre-KV5264BT.CgWi0tY2.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.j7dZpUK_.js → diagram-5BDNPKRD.rn6qIo9N.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.4flIgIon.js → diagram-G4DWMVQ6.ChhW8oww.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.BlJiFh-S.js → diagram-MMDJMWI5.C0wH5KSk.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.DHAOHEyM.js → diagram-TYMM5635.CNEcrwA0.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DkmyG7xK.js → erDiagram-SMLLAGMA.DCsnKO-7.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.L_WiaAU6.js → flowDiagram-DWJPFMVM.WCMkfvP0.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CT6kOI2a.js → ganttDiagram-T4ZO3ILL.BUb1Sxfr.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.D8CRlLqh.js → gitGraphDiagram-UUTBAWPF._kORbCzm.js} +1 -1
- package/dist/docs/assets/chunks/{graph.CdOyJvsX.js → graph.PrGRm4KW.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.DcmXeSos.js → infoDiagram-42DDH7IO.BxhCjiQM.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BBjY4mxr.js → ishikawaDiagram-UXIWVN3A.5ddTis2y.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BrXteAB6.js → journeyDiagram-VCZTEJTY.BUStU27-.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.OlHsUJVV.js → kanban-definition-6JOO6SKY.CJd1psl3.js} +1 -1
- package/dist/docs/assets/chunks/{layout.DDwvoQlY.js → layout.DqvbZSML.js} +1 -1
- package/dist/docs/assets/chunks/{linear.BRXPDWj3.js → linear.DOmz-1UB.js} +1 -1
- package/dist/docs/assets/chunks/{min.3YwC0t3o.js → min.33k2v8dM.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.mPHnT2lN.js → mindmap-definition-QFDTVHPH.iISCqCXC.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.DEK2--em.js → pieDiagram-DEJITSTG.BHvVgzmD.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.NCdRAOzK.js → quadrantDiagram-34T5L4WZ.CY3w_-Cn.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DLAocFWZ.js → requirementDiagram-MS252O5E.CHXKQS1v.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.afIOqpyT.js → sankeyDiagram-XADWPNL6.DTtRoGss.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.DXBjvkkE.js → sequenceDiagram-FGHM5R23.NnPcQ3eY.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B_SGgvgs.js → stateDiagram-FHFEXIEX.D8DFciH7.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ESAwmMws.js +1 -0
- package/dist/docs/assets/chunks/{theme.bNyH5NPA.js → theme.CwkiT-Fo.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CE6S1iSb.js → timeline-definition-GMOUNBTQ._wIWkMU6.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Blk7wb8V.js → vennDiagram-DHZGUBPP.NLVv7R6r.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.DQqE3WF8.js → wardley-RL74JXVD.DbsCXUZp.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.MUEQyRnz.js → wardleyDiagram-NUSXRM2D.Dp5uAVDl.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DnJA2aXp.js → xychartDiagram-5P7HB3ND.eOEBq4rX.js} +1 -1
- package/dist/docs/assets/{deployment.md.N9S5KC5R.js → deployment.md.CIRydNl3.js} +2 -2
- package/dist/docs/assets/{deployment.md.N9S5KC5R.lean.js → deployment.md.CIRydNl3.lean.js} +1 -1
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.js +82 -0
- package/dist/docs/assets/guides_workload-identity.md.DBV6YkXX.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.js → reference_agent-config.md.CfM1S6Ac.js} +2 -2
- package/dist/docs/assets/{reference_agent-config.md.Bbqf0lgS.lean.js → reference_agent-config.md.CfM1S6Ac.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +35 -35
- package/dist/docs/changelog.html +36 -36
- package/dist/docs/changelog.md +8 -0
- package/dist/docs/deployment.html +38 -38
- package/dist/docs/deployment.md +4 -0
- package/dist/docs/evals.html +35 -35
- package/dist/docs/guides/agent-to-agent.html +35 -35
- package/dist/docs/guides/bitbucket.html +35 -35
- package/dist/docs/guides/cloud-agents.html +35 -35
- package/dist/docs/guides/convert-automation.html +35 -35
- package/dist/docs/guides/github.html +35 -35
- package/dist/docs/guides/gitlab.html +35 -35
- package/dist/docs/guides/improve.html +35 -35
- package/dist/docs/guides/jev.html +35 -35
- package/dist/docs/guides/mcp-oauth.html +35 -35
- package/dist/docs/guides/migrate.html +36 -36
- package/dist/docs/guides/opentelemetry.html +35 -35
- package/dist/docs/guides/pagerduty.html +35 -35
- package/dist/docs/guides/slack.html +35 -35
- package/dist/docs/guides/teams.html +35 -35
- package/dist/docs/guides/webhooks.html +35 -35
- package/dist/docs/guides/workload-identity.html +141 -0
- package/dist/docs/guides/workload-identity.md +227 -0
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +35 -35
- package/dist/docs/index.html +35 -35
- package/dist/docs/llms-full.txt +245 -1
- package/dist/docs/llms.txt +1 -0
- package/dist/docs/quickstart.html +35 -35
- package/dist/docs/reference/access.html +35 -35
- package/dist/docs/reference/agent-config.html +37 -37
- package/dist/docs/reference/agent-config.md +1 -1
- package/dist/docs/reference/artifacts.html +35 -35
- package/dist/docs/reference/channels.html +35 -35
- package/dist/docs/reference/cli.html +35 -35
- package/dist/docs/reference/connections.html +35 -35
- package/dist/docs/reference/evals.html +35 -35
- package/dist/docs/reference/extensions.html +35 -35
- package/dist/docs/reference/hooks.html +35 -35
- package/dist/docs/reference/http-api.html +35 -35
- package/dist/docs/reference/instructions.html +35 -35
- package/dist/docs/reference/limits.html +35 -35
- package/dist/docs/reference/memory.html +35 -35
- package/dist/docs/reference/playground.html +35 -35
- package/dist/docs/reference/project-layout.html +35 -35
- package/dist/docs/reference/schedules.html +35 -35
- package/dist/docs/reference/sessions.html +35 -35
- package/dist/docs/reference/skills.html +35 -35
- package/dist/docs/reference/subagents.html +35 -35
- package/dist/docs/reference/tools.html +35 -35
- package/dist/docs/templates/agentic-owners.html +35 -35
- package/dist/docs/templates/reviews.html +35 -35
- package/dist/docs/troubleshooting.html +35 -35
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +6 -3
- package/dist/internal/cursor-account-mcp-auth.d.ts +7 -1
- package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
- package/dist/internal/cursor-account-mcp-auth.js +20 -5
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +2 -1
- package/dist/internal/discovery/connections.d.ts +5 -0
- package/dist/internal/discovery/connections.d.ts.map +1 -1
- package/dist/internal/discovery/connections.js +18 -1
- package/dist/internal/host-kv-cas.d.ts.map +1 -1
- package/dist/internal/host-kv-cas.js +21 -3
- package/dist/internal/hosted-delivery-protocol.d.ts +1 -0
- package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
- package/dist/internal/hosted-delivery-protocol.js +4 -2
- package/dist/internal/hosted-delivery.d.ts +4 -1
- package/dist/internal/hosted-delivery.d.ts.map +1 -1
- package/dist/internal/hosted-delivery.js +3 -1
- package/dist/internal/ids.d.ts +2 -0
- package/dist/internal/ids.d.ts.map +1 -1
- package/dist/internal/ids.js +5 -0
- package/dist/internal/schedule-runner.d.ts +1 -0
- package/dist/internal/schedule-runner.d.ts.map +1 -1
- package/dist/internal/schedule-runner.js +10 -1
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +8 -4
- package/dist/internal/session-engine.d.ts +4 -1
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +3 -1
- package/dist/oidc-token.d.ts +4 -0
- package/dist/oidc-token.d.ts.map +1 -1
- package/dist/playground/assets/chunk-YOKDWASO-BPO_8GRX.js +115 -0
- package/dist/playground/assets/highlighted-body-KPVGNVTW-CxEV-T_f.js +1 -0
- package/dist/playground/assets/index-CjFJhCtb.js +62 -0
- package/dist/playground/assets/index-vwUVwmk8.css +1 -0
- package/dist/playground/assets/mermaid-HWGCJPDP-eK-fpbFn.js +1 -0
- package/dist/playground/index.html +2 -2
- package/docs/changelog.md +8 -0
- package/docs/deployment.md +4 -0
- package/docs/guides/workload-identity.md +232 -0
- package/docs/reference/agent-config.md +1 -1
- package/package.json +3 -1
- package/skills/deploy/SKILL.md +1 -1
- package/dist/docs/assets/changelog.md.SoN0MK7o.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +0 -1
- package/dist/docs/assets/chunks/channel.CgxlmuBS.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +0 -1
- package/dist/docs/assets/chunks/clone.F824-PNx.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +0 -1
- package/dist/playground/assets/index-BaBSZXki.css +0 -1
- package/dist/playground/assets/index-BkAF8YlO.js +0 -62
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export{r as Mermaid}from"./chunk-YOKDWASO-BPO_8GRX.js";
|
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
/>
|
|
9
9
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
10
10
|
<title>agent-serve playground</title>
|
|
11
|
-
<script type="module" crossorigin src="./assets/index-
|
|
12
|
-
<link rel="stylesheet" crossorigin href="./assets/index-
|
|
11
|
+
<script type="module" crossorigin src="./assets/index-CjFJhCtb.js"></script>
|
|
12
|
+
<link rel="stylesheet" crossorigin href="./assets/index-vwUVwmk8.css">
|
|
13
13
|
</head>
|
|
14
14
|
<body>
|
|
15
15
|
<div id="root"></div>
|
package/docs/changelog.md
CHANGED
|
@@ -5,6 +5,14 @@ description: Changelog for @grok/agent-sdk releases.
|
|
|
5
5
|
|
|
6
6
|
# Changelog
|
|
7
7
|
|
|
8
|
+
## 0.7.1 (2026-11-20)
|
|
9
|
+
|
|
10
|
+
### Fixes
|
|
11
|
+
|
|
12
|
+
- On Cursor hosting, scheduled runs record trace events under the platform session id so they appear in the Trace tab. Before, scheduled runs wrote traces under a local id and the Trace tab stayed empty.
|
|
13
|
+
- GitHub and Origin `cursorAccount` connections ignore GitLab and Bitbucket repository entries in the shared event list instead of failing startup.
|
|
14
|
+
- `cursorAccount` MCP server name matching trims surrounding whitespace on server names and identifiers and rejects blank names.
|
|
15
|
+
|
|
8
16
|
## 0.7.0 (2026-11-19)
|
|
9
17
|
|
|
10
18
|
### Minimum versions
|
package/docs/deployment.md
CHANGED
|
@@ -83,6 +83,10 @@ handler, tool, or callback that needs it. Give an MCP connection a
|
|
|
83
83
|
[`${NAME}` template](./reference/connections.md#credentials-in-headers-and-env)
|
|
84
84
|
instead.
|
|
85
85
|
|
|
86
|
+
To authenticate with cloud providers or external services without static
|
|
87
|
+
keys, declare `hosting.oidc.audiences` and mint short-lived JWTs with
|
|
88
|
+
`getOidcToken`. See [Workload identity (OIDC)](./guides/workload-identity.md).
|
|
89
|
+
|
|
86
90
|
SCM channels take each credential as a named secret, such as
|
|
87
91
|
`{ secretName: "GITHUB_WEBHOOK_SECRET" }`. The channel reads the environment
|
|
88
92
|
variable with that name locally and the deployment secret on Cursor hosting.
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Workload identity (OIDC)"
|
|
3
|
+
description: "Mint short-lived OIDC tokens from a deployed Agent SDK agent to authenticate with cloud providers and external services without static keys."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Authenticate deployed agents with OIDC
|
|
7
|
+
|
|
8
|
+
A deployed Agent SDK agent can mint short-lived OIDC JWTs signed by Cursor and exchange them for temporary cloud credentials or service tokens without storing static access keys in deployment secrets.
|
|
9
|
+
|
|
10
|
+
Agent SDK tokens share the `https://api.cursor.com` issuer, discovery endpoints, signing keys, 5-minute lifetime, socket path, and per-pod rate limits documented in [Cloud Agents OIDC tokens](https://cursor.com/docs/cloud-agent/identity). They differ in four ways:
|
|
11
|
+
|
|
12
|
+
| Aspect | Cloud Agents | Agent SDK deployments |
|
|
13
|
+
| --- | --- | --- |
|
|
14
|
+
| Audience allowlist | Any valid `aud` string | Must be declared in `hosting.oidc.audiences`; undeclared audiences return HTTP `400`. |
|
|
15
|
+
| Subject (`sub`) | `cloud_agent_id:<id>` (or projected `team_id:<id>` via `sub_claim`) | Always `agent_sdk_deployment_id:<deployment-id>`. Sending `sub_claim` returns HTTP `400`. |
|
|
16
|
+
| Runtime claim (`agent_runtime`) | `"managed"` or `"self_hosted"` | `"agent_sdk"`. |
|
|
17
|
+
| Additional claims | Includes owner, team, repository, branch, and turn claims | See [Token claims](#token-claims). No owner, team, repository, or session claims. |
|
|
18
|
+
|
|
19
|
+
## Declare allowed audiences
|
|
20
|
+
|
|
21
|
+
A deployed agent can only mint tokens for audiences declared in `hosting.oidc.audiences` in `bot/agent.ts`. If you omit `hosting.oidc.audiences`, every mint request fails with HTTP `400`.
|
|
22
|
+
|
|
23
|
+
```ts
|
|
24
|
+
// bot/agent.ts
|
|
25
|
+
import { defineAgent } from "@grok/agent-sdk";
|
|
26
|
+
|
|
27
|
+
export default defineAgent({
|
|
28
|
+
hosting: {
|
|
29
|
+
egressDomains: ["sts.amazonaws.com"],
|
|
30
|
+
oidc: {
|
|
31
|
+
audiences: ["sts.amazonaws.com"],
|
|
32
|
+
},
|
|
33
|
+
},
|
|
34
|
+
});
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Minting talks to a local Unix socket, so minting itself needs no egress entry. Calling the relying party to exchange the token still requires its hostname in `hosting.egressDomains`, such as `sts.amazonaws.com` (and any AWS service host your agent calls afterward).
|
|
38
|
+
|
|
39
|
+
Audience rules:
|
|
40
|
+
|
|
41
|
+
- List exact audience strings only. Wildcards (`*`) are rejected.
|
|
42
|
+
- Declare at most 8 audiences per deployment.
|
|
43
|
+
- Each audience must be 1 to 512 printable ASCII characters with no spaces or control characters.
|
|
44
|
+
- Cursor-reserved audiences (such as `cursor.com` hosts) are rejected at deploy time and at mint time.
|
|
45
|
+
- Cursor saves `hosting.oidc.audiences` when you deploy. Redeploy to add or remove an audience.
|
|
46
|
+
|
|
47
|
+
## Mint a token with `getOidcToken`
|
|
48
|
+
|
|
49
|
+
Import `getOidcToken` from `@grok/agent-sdk` and call it inside a tool, channel handler, or callback when your agent needs a token.
|
|
50
|
+
|
|
51
|
+
```ts
|
|
52
|
+
// bot/tools/assume_aws_role.ts
|
|
53
|
+
import { getOidcToken, OidcTokenError } from "@grok/agent-sdk";
|
|
54
|
+
import { defineTool } from "@grok/agent-sdk/tools";
|
|
55
|
+
import { z } from "zod";
|
|
56
|
+
|
|
57
|
+
export default defineTool({
|
|
58
|
+
description: "Exchange an OIDC token for temporary AWS credentials.",
|
|
59
|
+
inputSchema: z.object({}),
|
|
60
|
+
async execute() {
|
|
61
|
+
let token: string;
|
|
62
|
+
try {
|
|
63
|
+
const result = await getOidcToken("sts.amazonaws.com");
|
|
64
|
+
token = result.token;
|
|
65
|
+
} catch (error) {
|
|
66
|
+
if (error instanceof OidcTokenError) {
|
|
67
|
+
return {
|
|
68
|
+
ok: false,
|
|
69
|
+
code: error.code,
|
|
70
|
+
status: error.status ?? null,
|
|
71
|
+
reason: error.reason ?? null,
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
throw error;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
const body = new URLSearchParams({
|
|
78
|
+
Action: "AssumeRoleWithWebIdentity",
|
|
79
|
+
Version: "2011-06-15",
|
|
80
|
+
RoleArn: "arn:aws:iam::123456789012:role/my-agent-role",
|
|
81
|
+
RoleSessionName: "agent-sdk-session",
|
|
82
|
+
WebIdentityToken: token,
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
const response = await fetch("https://sts.amazonaws.com/", {
|
|
86
|
+
method: "POST",
|
|
87
|
+
headers: {
|
|
88
|
+
"content-type": "application/x-www-form-urlencoded",
|
|
89
|
+
accept: "application/json",
|
|
90
|
+
},
|
|
91
|
+
body,
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
if (!response.ok) {
|
|
95
|
+
return { ok: false, stsStatus: response.status };
|
|
96
|
+
}
|
|
97
|
+
return { ok: true };
|
|
98
|
+
},
|
|
99
|
+
});
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Call `getOidcToken` inside a tool, handler, or callback, not at module load time.
|
|
103
|
+
|
|
104
|
+
### Return value and caching
|
|
105
|
+
|
|
106
|
+
`getOidcToken(audience: string)` returns `Promise<OidcToken>`:
|
|
107
|
+
|
|
108
|
+
| Field | Type | Meaning |
|
|
109
|
+
| --- | --- | --- |
|
|
110
|
+
| `token` | `string` | Compact RS256-signed JWT. Never log it. |
|
|
111
|
+
| `expiresAt` | `Date` | Token expiration timestamp from the socket's `expires_at` field. |
|
|
112
|
+
|
|
113
|
+
`getOidcToken` caches one token per audience in memory and refreshes it 60 seconds before `expiresAt`. Concurrent callers for the same audience share a single in-flight mint request. Each mint request times out after 20 seconds.
|
|
114
|
+
|
|
115
|
+
### Error handling
|
|
116
|
+
|
|
117
|
+
`getOidcToken` throws `OidcTokenError` (a subclass of `Error` with `name === "OidcTokenError"`) on failure:
|
|
118
|
+
|
|
119
|
+
| Field | Type | Meaning |
|
|
120
|
+
| --- | --- | --- |
|
|
121
|
+
| `code` | `OidcTokenErrorCode` | Failure category listed below. |
|
|
122
|
+
| `status` | `number \| undefined` | HTTP status code from the identity socket when an HTTP response was received. |
|
|
123
|
+
| `reason` | `string \| undefined` | Machine-readable `error` string from the socket's JSON error body, when present. |
|
|
124
|
+
|
|
125
|
+
`OidcTokenErrorCode` values:
|
|
126
|
+
|
|
127
|
+
| `code` | Typical `status` | Cause | What to do |
|
|
128
|
+
| --- | --- | --- | --- |
|
|
129
|
+
| `"not_hosted"` | `undefined` | No identity socket exists (for example, during local `agent-sdk dev` or `agent-sdk serve`). | Use local credentials in development or skip OIDC locally. |
|
|
130
|
+
| `"refused"` | `403` | The deployment is not running (stopped or deleted) or OIDC minting is disabled for this deployment. | Treat as non-retryable. Check deployment status. |
|
|
131
|
+
| `"rate_limited"` | `429` | The per-pod mint rate limit was exceeded. | Back off and retry. Prefer `getOidcToken` caching over repeated raw calls. |
|
|
132
|
+
| `"timeout"` | `undefined` | The mint request did not finish within 20 seconds. | Retry with backoff. |
|
|
133
|
+
| `"malformed"` | `undefined` | The socket returned HTTP `200` with invalid JSON, missing `token` or `expires_at`, or a body larger than 64 KiB. | Retry or inspect runtime logs. |
|
|
134
|
+
| `"failed"` | `400`, `5xx`, or `undefined` | Another HTTP error or socket transport failure. | Check `status`. HTTP `400` means fix the request or declare the audience in `hosting.oidc.audiences`; `5xx` errors are retryable. |
|
|
135
|
+
|
|
136
|
+
When you request an audience that is not listed in `hosting.oidc.audiences`, the socket returns HTTP `400` and `getOidcToken` throws `OidcTokenError` with `code: "failed"` and `status: 400`. Branch on `code` and `status` rather than matching `reason`, which can change.
|
|
137
|
+
|
|
138
|
+
## Call the identity socket directly
|
|
139
|
+
|
|
140
|
+
Use the local Unix domain socket directly from shell scripts, non-JavaScript tools, or when you need a `nonce` claim (which `getOidcToken` does not accept).
|
|
141
|
+
|
|
142
|
+
The socket path is in `$CURSOR_AGENT_SOCKET`, defaulting to `/run/cursor/api.sock`. Send `POST /v1/tokens/oidc` with `Content-Type: application/json` (maximum body size 4 KB):
|
|
143
|
+
|
|
144
|
+
```bash
|
|
145
|
+
curl --silent --show-error --fail-with-body \
|
|
146
|
+
--unix-socket "${CURSOR_AGENT_SOCKET:-/run/cursor/api.sock}" \
|
|
147
|
+
-H 'Content-Type: application/json' \
|
|
148
|
+
-d '{"aud":"sts.amazonaws.com"}' \
|
|
149
|
+
http://localhost/v1/tokens/oidc
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
Request fields:
|
|
153
|
+
|
|
154
|
+
- `aud` (required string): exact audience declared in `hosting.oidc.audiences`.
|
|
155
|
+
- `nonce` (optional string): opaque printable ASCII string with no spaces, up to 512 characters, echoed into the JWT `nonce` claim.
|
|
156
|
+
|
|
157
|
+
Success response (`200 OK`):
|
|
158
|
+
|
|
159
|
+
```json
|
|
160
|
+
{
|
|
161
|
+
"token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ii4uLiIsInR5cCI6IkpXVCJ9...",
|
|
162
|
+
"expires_at": 1785500000
|
|
163
|
+
}
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
`expires_at` is the token expiration in Unix seconds and matches the JWT `exp` claim.
|
|
167
|
+
|
|
168
|
+
An undeclared audience, a Cursor-reserved audience, an invalid `aud`, or a `sub_claim` field returns HTTP `400` with a JSON error object whose `error` string can change.
|
|
169
|
+
|
|
170
|
+
See [Cloud Agents OIDC tokens](https://cursor.com/docs/cloud-agent/identity) for the full socket HTTP status code table and per-pod rate limits.
|
|
171
|
+
|
|
172
|
+
## Token claims
|
|
173
|
+
|
|
174
|
+
Tokens are signed with `RS256` and include `alg`, `kid`, and `typ: "JWT"` in the header. Every Agent SDK token carries these claims:
|
|
175
|
+
|
|
176
|
+
| Claim | Value | Notes |
|
|
177
|
+
| --- | --- | --- |
|
|
178
|
+
| `iss` | `https://api.cursor.com` | Same issuer as Cloud Agents. |
|
|
179
|
+
| `sub` | `agent_sdk_deployment_id:<deployment-id>` | `<deployment-id>` is the deployment public ID (`asd_` followed by 32 lowercase hex characters). |
|
|
180
|
+
| `aud` | Requested audience string | Always a single string matching an entry in `hosting.oidc.audiences`. |
|
|
181
|
+
| `iat` | Unix seconds | Issued-at time. |
|
|
182
|
+
| `nbf` | `iat - 5` | Allows 5 seconds of clock skew. |
|
|
183
|
+
| `exp` | `iat + 300` | Valid for 5 minutes. |
|
|
184
|
+
| `jti` | UUID | Unique token ID per mint. |
|
|
185
|
+
| `agent_runtime` | `"agent_sdk"` | Identifies an Agent SDK deployment token. |
|
|
186
|
+
| `nonce` | Optional string | Present only when sent on a raw socket request. |
|
|
187
|
+
|
|
188
|
+
## Configure an AWS IAM trust policy
|
|
189
|
+
|
|
190
|
+
1. In AWS IAM, add `https://api.cursor.com` as an OpenID Connect identity provider with `sts.amazonaws.com` as an audience (if your AWS account does not already have one).
|
|
191
|
+
2. Declare `"sts.amazonaws.com"` in `hosting.oidc.audiences` and `hosting.egressDomains`, then deploy your agent.
|
|
192
|
+
3. Find your deployment's exact `sub` claim (`agent_sdk_deployment_id:asd_<32 hex chars>`). You can read `sub` from the JWT payload of a minted token during initial setup. Redeploying the same slug keeps the same deployment public ID; deleting and recreating a deployment generates a new one.
|
|
193
|
+
4. Attach a trust policy to your IAM role that pins both `api.cursor.com:aud` and `api.cursor.com:sub` with `StringEquals`:
|
|
194
|
+
|
|
195
|
+
```json
|
|
196
|
+
{
|
|
197
|
+
"Version": "2012-10-17",
|
|
198
|
+
"Statement": [
|
|
199
|
+
{
|
|
200
|
+
"Effect": "Allow",
|
|
201
|
+
"Principal": {
|
|
202
|
+
"Federated": "arn:aws:iam::123456789012:oidc-provider/api.cursor.com"
|
|
203
|
+
},
|
|
204
|
+
"Action": "sts:AssumeRoleWithWebIdentity",
|
|
205
|
+
"Condition": {
|
|
206
|
+
"StringEquals": {
|
|
207
|
+
"api.cursor.com:aud": "sts.amazonaws.com",
|
|
208
|
+
"api.cursor.com:sub": "agent_sdk_deployment_id:asd_3f9c0a7b1d2e4f60a9b8c7d6e5f40312"
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
]
|
|
213
|
+
}
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
Never replace the `sub` value with a wildcard such as `agent_sdk_deployment_id:*`. A wildcard trusts every Agent SDK deployment on Cursor.
|
|
217
|
+
|
|
218
|
+
## Verification, rate limits, and trust model
|
|
219
|
+
|
|
220
|
+
For OIDC discovery (`https://api.cursor.com/.well-known/openid-configuration`), JWKS (`https://api.cursor.com/keys`), JWT signature verification steps, and per-pod rate limits, see [Cloud Agents OIDC tokens](https://cursor.com/docs/cloud-agent/identity).
|
|
221
|
+
|
|
222
|
+
Keep the deployment trust boundary in mind when scoping external roles:
|
|
223
|
+
|
|
224
|
+
- Any code or tool running inside the deployment pod that can reach the identity socket can mint tokens for any audience declared in `hosting.oidc.audiences`.
|
|
225
|
+
- The platform sets `sub` from the deployment identity, so one deployment cannot impersonate another.
|
|
226
|
+
- Tokens represent the deployment as a whole, not a single session, tool, or end user. Grant the external role only the permissions that the deployment should hold.
|
|
227
|
+
|
|
228
|
+
## Related
|
|
229
|
+
|
|
230
|
+
- [Deployment](../deployment.md)
|
|
231
|
+
- [Agent config](../reference/agent-config.md)
|
|
232
|
+
- [Cloud Agents OIDC tokens](https://cursor.com/docs/cloud-agent/identity)
|
|
@@ -32,7 +32,7 @@ export default defineAgent({
|
|
|
32
32
|
| `description` | string | What the agent is for. Required on subagents, where the parent model reads it to decide when to delegate. |
|
|
33
33
|
| `instructions` | string | Inline instructions for subagents and generated configs. Prefer `instructions.md`. |
|
|
34
34
|
| `local` | `{ cwd?, workspaceDir?, sandbox? }` | Defaults for a local run. See [Local options](#local-options). |
|
|
35
|
-
| `hosting` | `{ egressDomains?, secretNames? }` | The egress allowlist
|
|
35
|
+
| `hosting` | `{ egressDomains?, secretNames?, oidc? }` | The egress allowlist, expected secret names, and [OIDC token audiences](../guides/workload-identity.md) that `agent-sdk deploy` reads. Mounted [extensions](./extensions.md#build-an-extension) add their own egress hosts and secrets. |
|
|
36
36
|
| `concurrency` | `{ maxRunningTurns? }` | Agent-wide limit on concurrent turns. See [Concurrency](#concurrency). |
|
|
37
37
|
| `builtinTools` | `{ reminders? }` | Opt-in tools that Agent SDK provides. See [Built-in tools](#built-in-tools). |
|
|
38
38
|
| `tools` | `ToolName[]` | Allowlist of built-in tools. Omit it for the full standard toolset. See [Harness tools](#harness-tools). |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@grok/agent-sdk",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.1",
|
|
4
4
|
"description": "Build, test, and deploy agents as code on Cursor's agent harness.",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"repository": {
|
|
@@ -290,8 +290,10 @@
|
|
|
290
290
|
},
|
|
291
291
|
"devDependencies": {
|
|
292
292
|
"@anysphere/agent-store-sync": "1.0.0",
|
|
293
|
+
"@anysphere/automations-ui": "1.0.0",
|
|
293
294
|
"@anysphere/context": "1.0.0",
|
|
294
295
|
"@anysphere/mcp-agent-exec": "1.0.0",
|
|
296
|
+
"@anysphere/mcp-core": "1.0.0",
|
|
295
297
|
"@anysphere/ui": "1.0.0",
|
|
296
298
|
"@braintree/sanitize-url": "7.1.2",
|
|
297
299
|
"@microsoft/api-extractor": "7.59.4",
|
package/skills/deploy/SKILL.md
CHANGED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{_ as o,c as t,o as a,a3 as s}from"./chunks/framework.BNw1pucY.js";const g=JSON.parse('{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases.","frontmatter":{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases."},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),n={name:"changelog.md"};function i(r,e,d,c,l,h){return a(),t("div",null,[...e[0]||(e[0]=[s('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to "Changelog""></a></h1><h2 id="_0-7-0-2026-11-19" tabindex="-1">0.7.0 (2026-11-19) <a class="header-anchor" href="#_0-7-0-2026-11-19" aria-label="Permalink to "0.7.0 (2026-11-19)""></a></h2><h3 id="minimum-versions" tabindex="-1">Minimum versions <a class="header-anchor" href="#minimum-versions" aria-label="Permalink to "Minimum versions""></a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.4.2, so each model call's usage arrives as a <code>model_call.completed</code> event.</li></ul><h3 id="behavior-changes" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes" aria-label="Permalink to "Behavior changes""></a></h3><ul><li>The <code>[cloud agent stopped]</code> wake message now holds only the agent id and its status, and tells the model to call <code>cloud__get</code> to read the agent's <code>result</code>. It no longer holds the agent's details.</li><li>On Cursor hosting, a cloud agent that a <code>cursor-cloud-agents</code> conversation launched wakes that conversation once when its run stops. This includes a run that someone else cancelled. Nothing polls the agent. If no wake comes, ask the bot to check the agent. A stop in the middle of a turn does not wake the conversation yet.</li><li>Launches off Cursor hosting, from a mount that sets its own <code>apiKey</code>, or with <code>envVars</code> are not watched, and return <code>watching: false</code>. A launch that Cursor hosting cannot watch also returns <code>watching: false</code>. Before, the stop watch polled the agent every minute.</li><li>A wake that reached no session, such as a failed session restore or a busy session, is sent again every minute, up to 10 times.</li><li>With a <code>skills</code> callback, the skills index lists only the discovered skills available in the mounted tree, rechecked each turn. Skills whose availability check fails are left out.</li></ul><h3 id="new" tabindex="-1">New <a class="header-anchor" href="#new" aria-label="Permalink to "New""></a></h3><ul><li><code>teamsChannel()</code> from <code>@grok/agent-sdk/channels/teams</code> connects an Azure Bot that you own to Microsoft Teams personal chats, group chats, and channel posts. It runs under <code>agent-sdk dev</code> and <code>agent-sdk serve</code>. The <code>agent-sdk channels teams</code> commands store the bot's credentials, build the Teams app package, and check the setup.</li><li><code>teamsChannel()</code> reacts with 👀 (<code>1f440_eyes</code>) to each accepted inbound message when its turn starts. Set <code>reply.ack</code> to another Teams reaction id to change the reaction, or to <code>false</code> to turn it off for the channel. Return <code>quiet: true</code> from an <code>onAppMention</code>, <code>onDirectMessage</code>, or <code>onChannelPost</code> handler to start that message's turn without the reaction.</li><li><code>ctx.steer(message, { deliveryId })</code> on channel event and hook contexts (<code>SessionContext</code>) and on tool contexts (<code>ToolContext</code>) adds a message to the agent's own running turn through <code>Run.steer</code>. It never starts a turn, opens a session, or queues the message: it resolves to <code>steered</code>, <code>no_turn</code>, or <code>not_delivered</code>.</li><li><code>getCloudAgent</code> from <code>@grok/agent-sdk/extensions/cursor-cloud-agents</code> and the <code>cloud__get</code> tool return <code>result</code>, the final answer of the agent's latest run, once the agent has stopped and that run finished. An errored or expired run has no <code>result</code>. Use it to read a cloud agent's report or JSON from your own code. For a stopped agent, they also read the latest run from the Cloud Agents API, and fail if that read fails.</li><li><code>ReminderHostApi.fireNow(id)</code> fires an armed reminder as soon as the platform can, through its normal claim.</li><li><code>Extension.namespace</code> is the namespace an agent mounted the extension under, for a tree that names its own <code><ns>__<name></code> contributions.</li><li><code>ReminderHostApi.createRequest(input)</code> returns the request that <code>create</code> would send, validated the same way, without creating the reminder.</li><li><code>launchCloudAgent</code> takes an optional <code>agentId</code>. Pass the same id again to retry a launch that timed out or failed: when the first launch created the agent, you get that agent and no second agent starts. A launch with <code>cloud.envVars</code> cannot take an <code>agentId</code>.</li></ul><h3 id="fixes" tabindex="-1">Fixes <a class="header-anchor" href="#fixes" aria-label="Permalink to "Fixes""></a></h3><ul><li>On Cursor hosting, a retried delivery continues on the cloud agent that its first attempt created, even when that attempt stopped before it recorded the agent. Before, the retry launched a second cloud agent that did the same work. A retry of a cancelled cloud run stays cancelled. An agent that sets <code>cloud.envVars</code> can still start a second cloud agent on a retry.</li><li>On Cursor hosting, <code>host.reminders.dispatch()</code> runs the reminder's handler once. Before, it failed with HTTP 405, and the handler ran again at the reminder's fire time.</li><li>The CLI writes stored credentials, MCP OAuth tokens, and <code>.env.local</code> so that only your user can read them. It narrows files that earlier versions wrote the next time it reads them.</li><li>In Slack, images in a reply that arrives while a turn runs reach the follow-up turn. Before, only the reply's text did.</li><li>In Slack, a file that the agent can't attach is named in the prompt with the reason, instead of dropped without a word. Files shared from another workspace now download, and a video sends its poster frame as an image.</li><li>In Slack, channel, user, and user group mentions that arrive without a label reach the model as names. Before, an unlabeled channel mention read as <code>#channel</code>. Private channels and DMs show their id.</li><li>On an HTTP 403, <code>agent-sdk deploy</code> prints the server's reason instead of guessing a cause.</li></ul><h2 id="_0-6-0-2026-11-03" tabindex="-1">0.6.0 (2026-11-03) <a class="header-anchor" href="#_0-6-0-2026-11-03" aria-label="Permalink to "0.6.0 (2026-11-03)""></a></h2><h3 id="minimum-versions-1" tabindex="-1">Minimum versions <a class="header-anchor" href="#minimum-versions-1" aria-label="Permalink to "Minimum versions""></a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.3.0.</li></ul><h3 id="behavior-changes-1" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-1" aria-label="Permalink to "Behavior changes""></a></h3><ul><li>On Cursor-managed hosting, when the team turns on its Cloud Agent Allowlist, a turn checks the <code>url:</code> and <code>command:</code> connections it opens against that list. It also checks their network hosts against the team's network allowlist for Cloud Agents. Before, it used the team's MCP Allowlist. Agents that you run with <code>agent-sdk serve</code> keep the MCP Allowlist.</li><li>On Cursor-managed hosting, when the team turns on its Cloud Agent Allowlist, the Cursor backend checks each <code>cursorAccount</code> connection against that list. The turn's local MCP checks no longer refuse these connections.</li><li>An agent with <code>cursorAccount</code> connections starts its shared workspace after those connections resolve. Other agents still start it when the server starts.</li></ul><h2 id="_0-5-0-2026-10-28" tabindex="-1">0.5.0 (2026-10-28) <a class="header-anchor" href="#_0-5-0-2026-10-28" aria-label="Permalink to "0.5.0 (2026-10-28)""></a></h2><h3 id="breaking-changes" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes" aria-label="Permalink to "Breaking changes""></a></h3><ul><li>No change to which file tools an <code>fs</code> agent has or what they do. Their results now use Cursor's native tool-call shape instead of Agent SDK's earlier MCP-style text, in <code>tool_call</code> events, transcripts, and direct tool calls. The same holds without <code>fs</code>. Update code that parses these results. For example, a direct <code>read</code> call returns <code>{ status: "success", value: { content } }</code> instead of numbered lines.</li><li>With <code>fs</code>, a <code>tools</code> list gets only the file tools it names. Add <code>"read"</code>, <code>"ls"</code>, <code>"glob"</code>, <code>"grep"</code>, <code>"edit"</code>, and <code>"delete"</code> to keep them.</li><li><code>@grok/agent-sdk/executors</code> is removed. Remove that import. The npm package has no replacement.</li><li><code>synthesizeFileSystemTools</code> is removed. Pass your tree as <code>fs</code>.</li><li><code>nearestNeighborMissHint</code> is removed. Read suggests nearby names when a file is missing.</li><li><code>RunnerTurnRequest</code> carries <code>fs</code>, <code>reportedWorkspacePath</code>, and <code>settingSources</code> instead of <code>root</code> and <code>subagentInherit</code>.</li></ul><h3 id="minimum-versions-2" tabindex="-1">Minimum versions <a class="header-anchor" href="#minimum-versions-2" aria-label="Permalink to "Minimum versions""></a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.2.0.</li></ul><h3 id="behavior-changes-2" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-2" aria-label="Permalink to "Behavior changes""></a></h3><ul><li>With <code>fs</code>, <code>AGENTS.md</code> and <code>.cursor/rules/</code> in the workspace load as project rules, as they do on the host. Don't make a checkout you don't trust the workspace.</li><li>With <code>fs</code>, omitting <code>tools</code> gives every tool the tree can back, including subagents, web search, web fetch, todos, and MCP.</li><li>With <code>fs</code>, a <code>tools</code> list that names a tool the tree can't run, such as <code>readLints</code>, leaves it out with a warning. Before, <code>readLints</code> with <code>fs</code> failed validation.</li><li>With <code>fs</code>, LS, Grep, and Glob search the workspace when a call names no path.</li><li>With <code>fs</code>, each turn gets an empty <code>/tmp</code>. Large web results are written there.</li><li>With <code>fs</code>, subagents work on the agent's tree, and their writes land in it as the agent's own do. Before, each subagent wrote to its own copy.</li><li><code>local.sandbox</code> works with <code>fs</code>. A tool call that needs approval, such as an external MCP call, fails closed. File access doesn't change.</li><li>With <code>local.sandbox</code> and no <code>fs</code>, an agent with shell in <code>tools</code>, or with <code>tools</code> omitted, can read outside the session workspace with the file tools, as its shell already could. Writes and deletes outside it are still refused.</li><li>With <code>local.sandbox</code> and no <code>fs</code>, an agent whose <code>tools</code> list file tools and no shell runs on its session workspace, mounted at <code>/workspace</code>, and its reads stay inside it. Cursor hooks don't run for it, so a Slack follow-up waits for the turn to end. <code>.cursor/mcp.json</code> from its working directory isn't loaded, host git status doesn't reach the model, and its skills are at <code>/agent/skills</code>.</li><li>An agent tool can be named <code>Read</code>, <code>Grep</code>, or another file tool's name.</li></ul><h3 id="new-1" tabindex="-1">New <a class="header-anchor" href="#new-1" aria-label="Permalink to "New""></a></h3><ul><li><code>workspace</code> sets the folder inside <code>fs</code> that the agent works in. For a sandboxed agent without shell, it sets where the session workspace is mounted.</li></ul><h3 id="fixes-1" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-1" aria-label="Permalink to "Fixes""></a></h3><ul><li>An agent that exports OpenTelemetry traces no longer logs a duplicate propagator registration error on its first HTTP request.</li></ul><h2 id="_0-4-0-2026-10-27" tabindex="-1">0.4.0 (2026-10-27) <a class="header-anchor" href="#_0-4-0-2026-10-27" aria-label="Permalink to "0.4.0 (2026-10-27)""></a></h2><h3 id="breaking-changes-1" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-1" aria-label="Permalink to "Breaking changes""></a></h3><ul><li>The <code>FileSystem</code> type, its helpers, and its errors match the file tools, and the package root exports <code>readOnlyFs</code>.</li></ul><h3 id="fixes-2" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-2" aria-label="Permalink to "Fixes""></a></h3><ul><li>A reply in a Slack thread that a schedule started continues that session.</li><li>A hosted Slack agent with <code>botMentions.allowFrom</code> starts a session when an allowed bot mentions it.</li></ul><h2 id="_0-3-0-2026-10-25" tabindex="-1">0.3.0 (2026-10-25) <a class="header-anchor" href="#_0-3-0-2026-10-25" aria-label="Permalink to "0.3.0 (2026-10-25)""></a></h2><ul><li>GA Release</li><li><code>persistent</code> option is removed from <code>defineAgent</code></li></ul><h2 id="_0-2-29-2026-10-23" tabindex="-1">0.2.29 (2026-10-23) <a class="header-anchor" href="#_0-2-29-2026-10-23" aria-label="Permalink to "0.2.29 (2026-10-23)""></a></h2><ul><li>Bug Fixes</li></ul>',35)])])}const m=o(n,[["render",i]]);export{g as __pageData,m as default};
|