@grok/agent-sdk 0.3.0 → 0.4.0
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/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +27 -14
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.BzTUBOAD.js → app.BSH__xV4.js} +4 -4
- package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.js → building-with-agents.md.Bo3ct-rf.js} +1 -1
- package/dist/docs/assets/changelog.md.b6H_ea44.js +1 -0
- package/dist/docs/assets/{changelog.md.BWhC6DET.lean.js → changelog.md.b6H_ea44.lean.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.DsnRlUT5.js → VPLocalSearchBox.Cadl7A0k.js} +1 -1
- package/dist/docs/assets/chunks/{arc.DH8GOhiv.js → arc.K7t9nNY6.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.9m9ObyuE.js → architectureDiagram-Q4EWVU46.SlHEknkX.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.BXHpx1lE.js → baseUniq.DJLRMLkz.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.xY3EX59q.js → blockDiagram-DXYQGD6D.Bs6XxFpe.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DnqgMVgc.js → c4Diagram-AHTNJAMY.CyLg6Ovc.js} +1 -1
- package/dist/docs/assets/chunks/channel.CVTdqYx0.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.BjFxK2A3.js → chunk-4BX2VUAB.DTQ4TinT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.BujS_Spt.js → chunk-4TB4RGXK.Es84IgcH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.YbTjhdaM.js → chunk-55IACEB6.Clm3cGPQ.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DnQ8t4GC.js → chunk-EDXVE4YY.DE4CRkS5.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.B67AwAmj.js → chunk-FMBD7UC4.Bf8HCvqp.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.DrZIAFOm.js → chunk-OYMX7WX6.eub-7nSx.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLmmydkn.js → chunk-QZHKN3VN.WyP9VAS_.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DaoOfw0O.js → chunk-YZCP3GAM.LO9ohhDE.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +1 -0
- package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DMQuNhM5.js → cose-bilkent-S5V4N54A.D5za6aH0.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CZoGVuUf.js → dagre-KV5264BT.Dq1daUru.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.CLt9uOyL.js → diagram-5BDNPKRD.j1YL5BKS.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DpczEm1G.js → diagram-G4DWMVQ6.Bi1aLdhC.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.D4r13DvJ.js → diagram-MMDJMWI5.BOzMEkAr.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.CYU9eGFu.js → diagram-TYMM5635.Dx2FVhCr.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.QA9naWEw.js → erDiagram-SMLLAGMA.DI4TNkye.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BbNoVZYd.js → flowDiagram-DWJPFMVM.C58Z9uPK.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.IHjDoG7r.js → ganttDiagram-T4ZO3ILL.DXSpW809.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B21VMdf5.js → gitGraphDiagram-UUTBAWPF.B955oaFl.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DgJ4L-8V.js → graph.BQXhKtxS.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.CQjrcthc.js → infoDiagram-42DDH7IO.Dozj_-Gm.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D4tPGtVo.js → ishikawaDiagram-UXIWVN3A.D2140OzH.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BD3WaNbQ.js → journeyDiagram-VCZTEJTY.DrqrMhCk.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Ca0o4Tqz.js → kanban-definition-6JOO6SKY.Dv-LTrlw.js} +1 -1
- package/dist/docs/assets/chunks/{layout.DXXqX4MQ.js → layout.CGtHp49X.js} +1 -1
- package/dist/docs/assets/chunks/{linear.5c61gNw4.js → linear.CHZLYB52.js} +1 -1
- package/dist/docs/assets/chunks/{min.B1-NAjHX.js → min.D4Vt3eIy.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BELznv3-.js → mindmap-definition-QFDTVHPH.BBfpYTea.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.qPzO1mq5.js → pieDiagram-DEJITSTG.BVYvElmY.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CxIvzbjX.js → quadrantDiagram-34T5L4WZ.C6Gc2mdY.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.CqA0iJx8.js → requirementDiagram-MS252O5E.DWa8b4cn.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.XRTutBnb.js → sankeyDiagram-XADWPNL6.Bi-g4ajv.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.E--7bRLQ.js → sequenceDiagram-FGHM5R23.DlU3vVN9.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.C4vGu8zq.js → stateDiagram-FHFEXIEX.CeqJRqnU.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +1 -0
- package/dist/docs/assets/chunks/{theme.DMj_7q3B.js → theme.DGq7D4tt.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C7LgNVAL.js → timeline-definition-GMOUNBTQ.Cqf2kjq9.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.HUwoZcy_.js → vennDiagram-DHZGUBPP.BeOpE_lM.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.BxFEFYZS.js → wardley-RL74JXVD.FMQXA-6q.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.B2pSo5rB.js → wardleyDiagram-NUSXRM2D.BXS65dAC.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.NQhMiOOL.js → xychartDiagram-5P7HB3ND.haEiSxqc.js} +1 -1
- package/dist/docs/assets/{deployment.md.BtqJrHhp.js → deployment.md.DJtuDVLh.js} +3 -3
- package/dist/docs/assets/{deployment.md.BtqJrHhp.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
- package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.js → guides_agent-to-agent.md.DcB3nhOz.js} +1 -1
- package/dist/docs/assets/{guides_github.md.6jiEH7dg.js → guides_github.md.CcuZ7keS.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.js → guides_mcp-oauth.md.GVPMKcYl.js} +1 -1
- package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.js → guides_migrate.md.B8CZxnnX.js} +1 -1
- package/dist/docs/assets/{guides_slack.md.BgIGG9ur.js → guides_slack.md.D7Rwyva4.js} +1 -1
- package/dist/docs/assets/{hillclimbing.md.3TkdF79A.js → hillclimbing.md.M51bF-oT.js} +1 -1
- package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
- package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
- package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.js → reference_agent-config.md.BSNp2uJ7.js} +3 -3
- package/dist/docs/assets/{reference_cli.md.B8GdpaRj.js → reference_cli.md.DHm6DmYk.js} +2 -2
- package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.js → reference_hooks.md.vbIM394-.js} +2 -2
- package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.lean.js → reference_hooks.md.vbIM394-.lean.js} +1 -1
- package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
- package/dist/docs/building-with-agents.html +36 -36
- package/dist/docs/building-with-agents.md +3 -3
- package/dist/docs/changelog.html +36 -36
- package/dist/docs/changelog.md +20 -1
- package/dist/docs/deployment.html +37 -37
- package/dist/docs/deployment.md +22 -16
- package/dist/docs/evals.html +35 -35
- package/dist/docs/guides/agent-to-agent.html +37 -37
- package/dist/docs/guides/agent-to-agent.md +4 -2
- 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 +37 -37
- package/dist/docs/guides/github.md +1 -1
- 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 +37 -37
- package/dist/docs/guides/mcp-oauth.md +1 -1
- package/dist/docs/guides/migrate.html +37 -37
- package/dist/docs/guides/migrate.md +1 -1
- package/dist/docs/guides/opentelemetry.html +35 -35
- package/dist/docs/guides/pagerduty.html +35 -35
- package/dist/docs/guides/slack.html +37 -37
- package/dist/docs/guides/slack.md +1 -1
- package/dist/docs/guides/webhooks.html +35 -35
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +36 -36
- package/dist/docs/hillclimbing.md +1 -1
- package/dist/docs/index.html +42 -48
- package/dist/docs/index.md +8 -14
- package/dist/docs/llms-full.txt +70 -50
- package/dist/docs/quickstart.html +35 -35
- package/dist/docs/reference/access.html +35 -35
- package/dist/docs/reference/agent-config.html +39 -39
- package/dist/docs/reference/agent-config.md +5 -6
- package/dist/docs/reference/artifacts.html +35 -35
- package/dist/docs/reference/channels.html +35 -35
- package/dist/docs/reference/cli.html +38 -38
- package/dist/docs/reference/cli.md +2 -2
- 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 +37 -37
- package/dist/docs/reference/hooks.md +1 -1
- 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 +38 -38
- 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/filesystem.d.ts +7 -320
- package/dist/filesystem.d.ts.map +1 -1
- package/dist/filesystem.js +10 -691
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/internal/authored-alias-hooks.d.ts +6 -0
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +12 -0
- package/dist/internal/authored-loaders.js +10 -1
- package/dist/internal/cli/commands/scaffold.js +1 -1
- package/dist/internal/continuation-session-ids.d.ts +15 -0
- package/dist/internal/continuation-session-ids.d.ts.map +1 -0
- package/dist/internal/continuation-session-ids.js +43 -0
- package/dist/internal/filesystem/walk.d.ts +1 -5
- package/dist/internal/filesystem/walk.d.ts.map +1 -1
- package/dist/internal/filesystem/walk.js +1 -9
- package/dist/internal/hosted-catch-protocol.d.ts +3 -3
- package/dist/internal/hosted-catch-protocol.js +3 -3
- package/dist/internal/hosted-fetch.d.ts +7 -0
- package/dist/internal/hosted-fetch.d.ts.map +1 -0
- package/dist/internal/hosted-fetch.js +26 -0
- package/dist/internal/install-cursor-skills.d.ts +5 -6
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +19 -4
- package/dist/internal/mcp-endpoint.js +4 -4
- package/dist/internal/model-config.d.ts.map +1 -1
- package/dist/internal/model-config.js +11 -4
- package/dist/internal/platform-timers.d.ts +3 -7
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +10 -51
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +6 -1
- package/dist/internal/session-engine.d.ts +3 -0
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +12 -3
- package/dist/playground/assets/index-Bno25Cg0.css +1 -0
- package/dist/playground/assets/index-SGKsaznh.js +62 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +2 -2
- package/docs/README.md +8 -14
- package/docs/building-with-agents.md +3 -3
- package/docs/changelog.md +20 -1
- package/docs/deployment.md +22 -16
- package/docs/guides/agent-to-agent.md +4 -2
- package/docs/guides/github.md +1 -1
- package/docs/guides/mcp-oauth.md +1 -1
- package/docs/guides/migrate.md +1 -1
- package/docs/guides/slack.md +1 -1
- package/docs/hillclimbing.md +1 -1
- package/docs/reference/agent-config.md +5 -6
- package/docs/reference/cli.md +2 -2
- package/docs/reference/hooks.md +1 -1
- package/package.json +3 -3
- package/skills/cli/SKILL.md +1 -1
- package/skills/create-agent/SKILL.md +61 -7
- package/skills/debug/SKILL.md +1 -1
- package/skills/deploy/SKILL.md +3 -3
- package/skills/evals/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +2 -2
- package/skills/github/SKILL.md +1 -1
- package/skills/hillclimb/SKILL.md +1 -1
- package/skills/mcp-auth/SKILL.md +1 -1
- package/skills/migrate-v2/SKILL.md +2 -2
- package/skills/otel/SKILL.md +1 -1
- package/skills/setup-slack/SKILL.md +2 -2
- package/dist/docs/assets/changelog.md.BWhC6DET.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +0 -1
- package/dist/docs/assets/chunks/channel.Cctv0f7X.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +0 -1
- package/dist/docs/assets/chunks/clone.B9rdNt6j.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +0 -1
- package/dist/docs/assets/index.md.DRfaoRCZ.js +0 -20
- package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +0 -1
- package/dist/internal/filesystem/errors.d.ts +0 -64
- package/dist/internal/filesystem/errors.d.ts.map +0 -1
- package/dist/internal/filesystem/errors.js +0 -180
- package/dist/internal/filesystem/merge.d.ts +0 -34
- package/dist/internal/filesystem/merge.d.ts.map +0 -1
- package/dist/internal/filesystem/merge.js +0 -154
- package/dist/playground/assets/index-D6mVn9og.js +0 -62
- package/dist/playground/assets/index-DlALM6gr.css +0 -1
- /package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +0 -0
- /package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.lean.js → guides_agent-to-agent.md.DcB3nhOz.lean.js} +0 -0
- /package/dist/docs/assets/{guides_github.md.6jiEH7dg.lean.js → guides_github.md.CcuZ7keS.lean.js} +0 -0
- /package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +0 -0
- /package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +0 -0
- /package/dist/docs/assets/{guides_slack.md.BgIGG9ur.lean.js → guides_slack.md.D7Rwyva4.lean.js} +0 -0
- /package/dist/docs/assets/{hillclimbing.md.3TkdF79A.lean.js → hillclimbing.md.M51bF-oT.lean.js} +0 -0
- /package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.lean.js → reference_agent-config.md.BSNp2uJ7.lean.js} +0 -0
- /package/dist/docs/assets/{reference_cli.md.B8GdpaRj.lean.js → reference_cli.md.DHm6DmYk.lean.js} +0 -0
- /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: agent-sdk-create-agent
|
|
3
3
|
description: >-
|
|
4
4
|
Scaffold a new Agent SDK agent: short AskQuestion interview, then
|
|
5
5
|
verify a turn and hand off to hillclimb. Use when creating a new
|
|
@@ -8,11 +8,14 @@ description: >-
|
|
|
8
8
|
|
|
9
9
|
# Create an Agent SDK agent
|
|
10
10
|
|
|
11
|
-
1. **
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
11
|
+
1. **Sign in.** `agent-sdk whoami`. Run `agent-sdk login` only
|
|
12
|
+
when it reports no credential.
|
|
13
|
+
2. **Interview.** Two `AskQuestion` rounds, then a plan gate.
|
|
14
|
+
3. **Scaffold.** `agent-sdk init`, then shape the files.
|
|
15
|
+
4. **Verify.** `validate` / `info` / `tool call`, then a model turn.
|
|
16
|
+
5. **Channels.** Slack, GitHub, webhook, or schedule as chosen.
|
|
17
|
+
6. **Report.** What it does, how to test it, how to deploy it.
|
|
18
|
+
7. **Hillclimb.** `skills/hillclimb/SKILL.md`.
|
|
16
19
|
|
|
17
20
|
Read `skills/framework-map/SKILL.md` if you have not. CLI is
|
|
18
21
|
`agent-sdk`. Public docs:
|
|
@@ -46,12 +49,16 @@ on a running host.
|
|
|
46
49
|
|
|
47
50
|
| Question | Options | Guidance |
|
|
48
51
|
| --- | --- | --- |
|
|
49
|
-
| **Model** | `grok-4.
|
|
52
|
+
| **Model** | `grok-4.7` + `reasoning_effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.7", params: [{ id: "reasoning_effort", value: "high" }, { id: "fast", value: "true" }] }` |
|
|
50
53
|
| **Channels** (multi) | playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord/Teams pack; offer custom webhook. |
|
|
51
54
|
| **MCP** (multi) | none · remote URL · local stdio · Cursor account connectors · Other | One file under `bot/mcp-connections/`. Account file is `account.ts`, never `cursor.ts`. Named local tools need `advertiseTools: true`. Privileged servers go in `bot/host-connections/`. |
|
|
52
55
|
| **Capabilities** (multi) | server tools · agent tools · skills · subagents · hooks · sandbox seeds · evals (recommend) | Always recommend one smoke eval. |
|
|
53
56
|
<!-- interview:end -->
|
|
54
57
|
|
|
58
|
+
Location: inside a git checkout, recommend a new folder outside
|
|
59
|
+
it. `init` runs `npm install`, which breaks a pnpm or yarn
|
|
60
|
+
workspace.
|
|
61
|
+
|
|
55
62
|
Close with the plan and file tree, then "Scaffold it" / "Adjust
|
|
56
63
|
something". Write files only after approval.
|
|
57
64
|
|
|
@@ -154,6 +161,18 @@ agent-sdk eval --dir ./<slug>
|
|
|
154
161
|
Serve only this agent's directory. Session files land in the
|
|
155
162
|
project state directory (`--state-root`). That is not harness cwd.
|
|
156
163
|
|
|
164
|
+
Finish gate. Before the report, these pass. Fix each error first:
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
agent-sdk validate --dir ./<slug>
|
|
168
|
+
npx tsc --noEmit -p ./<slug>
|
|
169
|
+
agent-sdk run --dir ./<slug> --message "<realistic first message>"
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
Show the reply word for word. Without a credential, `run` may fail
|
|
173
|
+
with only the API-key error. Then write the report anyway, and put
|
|
174
|
+
the hand-over commands above in "Test it locally".
|
|
175
|
+
|
|
157
176
|
## Channel setup
|
|
158
177
|
|
|
159
178
|
- **Slack.** `skills/setup-slack/SKILL.md`
|
|
@@ -166,6 +185,41 @@ project state directory (`--state-root`). That is not harness cwd.
|
|
|
166
185
|
- **Schedules.** Never auto-fire under `--dev`.
|
|
167
186
|
`POST /v1/dev/schedules/<id>`.
|
|
168
187
|
|
|
188
|
+
## Report
|
|
189
|
+
|
|
190
|
+
End with this report. Write it in ASD-STE100 Simplified Technical
|
|
191
|
+
English: short sentences, active voice, one instruction per step.
|
|
192
|
+
Fill in the real slug, env prefix, and commands.
|
|
193
|
+
|
|
194
|
+
```markdown
|
|
195
|
+
## What the agent does
|
|
196
|
+
|
|
197
|
+
- 3 to 5 short bullets.
|
|
198
|
+
|
|
199
|
+
## Test it locally
|
|
200
|
+
|
|
201
|
+
Commands for `agent-sdk dev ./<slug>` (playground URL) and
|
|
202
|
+
`agent-sdk eval --dir ./<slug>`, and what the person sees.
|
|
203
|
+
|
|
204
|
+
## Deploy it
|
|
205
|
+
|
|
206
|
+
1. If the project is not in a git repository, create one and
|
|
207
|
+
add a remote.
|
|
208
|
+
2. Commit the project and push it to a branch.
|
|
209
|
+
3. Slack only: run `agent-sdk slack create --dir ./<slug> --env prod`.
|
|
210
|
+
4. Run `agent-sdk validate --dir ./<slug>`, then
|
|
211
|
+
`agent-sdk deploy --dir ./<slug> --dry-run`.
|
|
212
|
+
5. Run `agent-sdk deploy --dir ./<slug>` in your own terminal.
|
|
213
|
+
The first deploy prints an alias token one time. Save it in
|
|
214
|
+
a password manager.
|
|
215
|
+
6. Run `agent-sdk session create --slug <slug> --message "<test>" --wait`.
|
|
216
|
+
7. Manage the agent at https://cursor.com/dashboard/deployed-agents.
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
Do not deploy, push, or create the prod Slack app unless the
|
|
220
|
+
person asks. Hand the first deploy to the person, so the alias
|
|
221
|
+
token stays out of your transcript.
|
|
222
|
+
|
|
169
223
|
## Hillclimb handoff
|
|
170
224
|
|
|
171
225
|
Once a smoke turn passes, agree fixtures, success criteria, and a
|
package/skills/debug/SKILL.md
CHANGED
package/skills/deploy/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: agent-sdk-deploy
|
|
3
3
|
description: >-
|
|
4
4
|
Deploy or redeploy an Agent SDK project to Cursor-managed hosting
|
|
5
5
|
with an attached service account. Use when asked to deploy,
|
|
@@ -14,7 +14,7 @@ pushed Git ref to Cursor-managed hosting. Local files never upload.
|
|
|
14
14
|
Use the package name and version embedded in the installed skill. Do not
|
|
15
15
|
use a floating npm tag or a workspace build of the CLI.
|
|
16
16
|
|
|
17
|
-
Follow the `
|
|
17
|
+
Follow the `agent-sdk-cli` skill for `--json`, exit codes, `--fields`, and
|
|
18
18
|
`--dry-run`.
|
|
19
19
|
|
|
20
20
|
## Gather the target
|
|
@@ -39,7 +39,7 @@ the value. Do not run `agent-sdk login`.
|
|
|
39
39
|
On Linux and macOS, run every Agent SDK command through this wrapper:
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
BDK_VERSION="0.
|
|
42
|
+
BDK_VERSION="0.4.0"
|
|
43
43
|
BDK_PACKAGE="@grok/agent-sdk"
|
|
44
44
|
case "$BDK_VERSION" in
|
|
45
45
|
__BDK_V*)
|
package/skills/evals/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: agent-sdk-framework-map
|
|
3
3
|
description: >-
|
|
4
4
|
Orient on Agent SDK layout, local runtime, sessions, and
|
|
5
5
|
invariants (Node not Bun, root evals/, typecheck after tsx,
|
|
@@ -13,7 +13,7 @@ description: >-
|
|
|
13
13
|
over HTTP, Slack, and GitHub. Markdown is prose. TypeScript is typed
|
|
14
14
|
behavior. Ground truth: package `README.md` and `AGENTS.md`.
|
|
15
15
|
|
|
16
|
-
CLI is `agent-sdk` (Node, never Bun). Follow the `
|
|
16
|
+
CLI is `agent-sdk` (Node, never Bun). Follow the `agent-sdk-cli` skill before you
|
|
17
17
|
run an `agent-sdk` command.
|
|
18
18
|
|
|
19
19
|
Public docs: `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or
|
package/skills/github/SKILL.md
CHANGED
package/skills/mcp-auth/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: agent-sdk-migrate-v2
|
|
3
3
|
description: >-
|
|
4
4
|
Migrate an Agent SDK project from hosted architecture v1 to v2: upgrade the
|
|
5
5
|
package, remove v1-only code, and redeploy. Applies only to projects
|
|
@@ -106,7 +106,7 @@ still loads.
|
|
|
106
106
|
Commit the lockfile the install writes, since deploys build from Git.
|
|
107
107
|
Rewrite every `@cursor/july` import to `@grok/agent-sdk`; subpaths such as
|
|
108
108
|
`/channels/slack`, `/evals`, and `/reminders` keep their names. Replace
|
|
109
|
-
the legacy CLI command with `
|
|
109
|
+
the legacy CLI command with `agent-sdk` in scripts, CI jobs, and READMEs.
|
|
110
110
|
|
|
111
111
|
The new types are stricter. `ctx.session.continuationKey` is
|
|
112
112
|
`string | null`, so guard with `typeof key === "string"`, not
|
package/skills/otel/SKILL.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: agent-sdk-setup-slack
|
|
3
3
|
description: >-
|
|
4
4
|
Wire Slack to an Agent SDK agent. Mint a dedicated Socket Mode app
|
|
5
5
|
with slack create, then doctor and smoke. Use slack init --manual
|
|
@@ -35,7 +35,7 @@ approve Slack, pick the bot name. CLI writes
|
|
|
35
35
|
Prefix is the directory basename in upper snake (`jenny` →
|
|
36
36
|
`JENNY`, `pr-approver` → `PR_APPROVER` → `PR_APPROVER_SLACK_*`).
|
|
37
37
|
`--prefix` / `--no-prefix` override. Dev and prod are separate
|
|
38
|
-
apps; `--prod` is the prod app. `--name` / `--icon` /
|
|
38
|
+
apps; `--env prod` is the prod app. `--name` / `--icon` /
|
|
39
39
|
`--channel-posts` / `--slack-team` prefill the wizard.
|
|
40
40
|
|
|
41
41
|
If Slack needs workspace-admin approval, keep the CLI running.
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{_ as a,c as o,o as t,a3 as l}from"./chunks/framework.BNw1pucY.js";const _=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 r(i,e,s,g,c,d){return t(),o("div",null,[...e[0]||(e[0]=[l('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to "Changelog""></a></h1><h2 id="_0-3-0-2026-10-23" tabindex="-1">0.3.0 (2026-10-23) <a class="header-anchor" href="#_0-3-0-2026-10-23" aria-label="Permalink to "0.3.0 (2026-10-23)""></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>',5)])])}const u=a(n,[["render",r]]);export{_ as __pageData,u as default};
|