npm - @cursor/july - Versions diffs - 0.1.105 → 0.1.108 - Mend

@cursor/july 0.1.105 → 0.1.108

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.

Files changed (395) hide show

package/README.md +10 -5
package/dist/bin/agent-serve.js +31 -16
package/dist/channels/bitbucket/types.d.ts +2 -4
package/dist/channels/bitbucket/types.d.ts.map +1 -1
package/dist/channels/deployments/types.d.ts +5 -8
package/dist/channels/deployments/types.d.ts.map +1 -1
package/dist/channels/github/github-channel.js +8 -5
package/dist/channels/github/types.d.ts +7 -5
package/dist/channels/github/types.d.ts.map +1 -1
package/dist/channels/gitlab/types.d.ts +2 -5
package/dist/channels/gitlab/types.d.ts.map +1 -1
package/dist/channels/origin/origin-channel.d.ts.map +1 -1
package/dist/channels/origin/origin-channel.js +27 -13
package/dist/channels/origin/types.d.ts +7 -4
package/dist/channels/origin/types.d.ts.map +1 -1
package/dist/channels/slack/defaults.d.ts.map +1 -1
package/dist/channels/slack/defaults.js +3 -0
package/dist/channels/slack/dispatch.d.ts.map +1 -1
package/dist/channels/slack/dispatch.js +1 -1
package/dist/channels/slack/live-delivery.d.ts.map +1 -1
package/dist/channels/slack/live-delivery.js +48 -11
package/dist/channels/slack/types.d.ts +4 -3
package/dist/channels/slack/types.d.ts.map +1 -1
package/dist/channels.d.ts +45 -0
package/dist/channels.d.ts.map +1 -1
package/dist/channels.js +106 -7
package/dist/connections.d.ts +2 -1
package/dist/connections.d.ts.map +1 -1
package/dist/connections.js +2 -1
package/dist/docs/404.html +3 -3
package/dist/docs/ab.html +6 -6
package/dist/docs/assets/{app.BVwaffdK.js → app.BASKM3M4.js} +1 -1
package/dist/docs/assets/chunks/@localSearchIndexroot.BHZYsNVi.js +1 -0
package/dist/docs/assets/chunks/{VPLocalSearchBox.WuWTZ1x8.js → VPLocalSearchBox.BOKxlYGP.js} +2 -2
package/dist/docs/assets/chunks/{theme.BYdI_6sF.js → theme.DbDZW-zb.js} +2 -2
package/dist/docs/assets/{deployment.md.MFPKqsqI.js → deployment.md.JenwuCCB.js} +4 -4
package/dist/docs/assets/{deployment.md.MFPKqsqI.lean.js → deployment.md.JenwuCCB.lean.js} +1 -1
package/dist/docs/assets/{evals.md.CbMoebP1.js → evals.md.C1ekS3k2.js} +1 -1
package/dist/docs/assets/guides_cloud-agents.md.BsloyHdY.js +9 -0
package/dist/docs/assets/{guides_cloud-agents.md.DS8RIjwx.lean.js → guides_cloud-agents.md.BsloyHdY.lean.js} +1 -1
package/dist/docs/assets/{guides_github.md.c0gdGJ-D.js → guides_github.md.BH33UEBJ.js} +1 -1
package/dist/docs/assets/{guides_grokbot-agents.md.DVqdhBKb.js → guides_grokbot-agents.md.DyV-WArv.js} +1 -1
package/dist/docs/assets/guides_improve.md.BGVk32bK.js +14 -0
package/dist/docs/assets/guides_improve.md.BGVk32bK.lean.js +1 -0
package/dist/docs/assets/{guides_opentelemetry.md.COh9jFVg.js → guides_opentelemetry.md.SCRMskno.js} +3 -3
package/dist/docs/assets/{guides_opentelemetry.md.COh9jFVg.lean.js → guides_opentelemetry.md.SCRMskno.lean.js} +1 -1
package/dist/docs/assets/{guides_slack.md.9oHPye9o.js → guides_slack.md.D4RVMM4G.js} +3 -3
package/dist/docs/assets/{guides_slack.md.9oHPye9o.lean.js → guides_slack.md.D4RVMM4G.lean.js} +1 -1
package/dist/docs/assets/index.md.BjH1w2ZW.js +5 -0
package/dist/docs/assets/{reference_agent-config.md.CHNpiyp4.js → reference_agent-config.md.CvoL6pof.js} +1 -1
package/dist/docs/assets/{reference_channels.md.DBGcaB7m.js → reference_channels.md.D-qTqwcq.js} +2 -2
package/dist/docs/assets/{reference_channels.md.DBGcaB7m.lean.js → reference_channels.md.D-qTqwcq.lean.js} +1 -1
package/dist/docs/assets/{reference_cli.md.C6Lo8SEd.js → reference_cli.md.Ca26u0Es.js} +6 -6
package/dist/docs/assets/{reference_cli.md.C6Lo8SEd.lean.js → reference_cli.md.Ca26u0Es.lean.js} +1 -1
package/dist/docs/assets/{reference_connections.md.Di6jJAXF.js → reference_connections.md.BojkC6c5.js} +1 -1
package/dist/docs/assets/{reference_extensions.md.CGmMLblt.js → reference_extensions.md.CPWt00ds.js} +1 -1
package/dist/docs/assets/{scaffolding-agents.md.em43xlY1.js → scaffolding-agents.md.Kctn3OVb.js} +1 -1
package/dist/docs/assets/{skills_create-agent.md.BVoWPcan.js → skills_create-agent.md.Q3h6Je-e.js} +1 -1
package/dist/docs/assets/{skills_debug.md.CDbPhHfg.js → skills_debug.md.CVjCXMFF.js} +1 -1
package/dist/docs/assets/{skills_debug.md.CDbPhHfg.lean.js → skills_debug.md.CVjCXMFF.lean.js} +1 -1
package/dist/docs/assets/{skills_evals.md.723kpUmA.js → skills_evals.md.BhovOvrl.js} +1 -1
package/dist/docs/assets/skills_framework-map.md.D-tFZhFS.js +1 -0
package/dist/docs/assets/{skills_framework-map.md.haibFyoB.lean.js → skills_framework-map.md.D-tFZhFS.lean.js} +1 -1
package/dist/docs/assets/{skills_github.md.D0JahM8c.js → skills_github.md.hgFX_oKY.js} +1 -1
package/dist/docs/assets/{skills_otel.md.CqhobH3B.js → skills_otel.md.B5Ddv1xH.js} +1 -1
package/dist/docs/assets/{style.BRuM8477.css → style.DCD_zyg3.css} +1 -1
package/dist/docs/assets/troubleshooting.md.CYEAO9bM.js +1 -0
package/dist/docs/building-with-agents.html +6 -6
package/dist/docs/concepts.html +5 -5
package/dist/docs/deployment.html +9 -9
package/dist/docs/deployment.md +7 -2
package/dist/docs/evals.html +8 -8
package/dist/docs/evals.md +3 -2
package/dist/docs/guides/agent-to-agent.html +6 -6
package/dist/docs/guides/cloud-agents.html +7 -7
package/dist/docs/guides/cloud-agents.md +4 -3
package/dist/docs/guides/convert-automation.html +6 -6
package/dist/docs/guides/github.html +7 -7
package/dist/docs/guides/github.md +2 -1
package/dist/docs/guides/grokbot-agents.html +7 -7
package/dist/docs/guides/grokbot-agents.md +2 -2
package/dist/docs/guides/human-in-the-loop.html +6 -6
package/dist/docs/guides/improve.html +40 -0
package/dist/docs/guides/improve.md +91 -0
package/dist/docs/guides/mcp-oauth.html +6 -6
package/dist/docs/guides/opentelemetry.html +8 -8
package/dist/docs/guides/opentelemetry.md +3 -4
package/dist/docs/guides/slack.html +8 -8
package/dist/docs/guides/slack.md +2 -1
package/dist/docs/guides/webhooks.html +6 -6
package/dist/docs/hashmap.json +1 -1
package/dist/docs/hillclimbing.html +6 -6
package/dist/docs/index.html +8 -8
package/dist/docs/index.md +4 -0
package/dist/docs/llms-full.txt +180 -61
package/dist/docs/llms.txt +1 -0
package/dist/docs/quickstart.html +6 -6
package/dist/docs/reference/agent-config.html +7 -7
package/dist/docs/reference/agent-config.md +5 -2
package/dist/docs/reference/artifacts.html +6 -6
package/dist/docs/reference/channels.html +7 -7
package/dist/docs/reference/channels.md +11 -19
package/dist/docs/reference/cli.html +11 -11
package/dist/docs/reference/cli.md +23 -13
package/dist/docs/reference/connections.html +8 -8
package/dist/docs/reference/connections.md +2 -1
package/dist/docs/reference/extensions.html +7 -7
package/dist/docs/reference/extensions.md +2 -0
package/dist/docs/reference/hooks.html +6 -6
package/dist/docs/reference/http-api.html +6 -6
package/dist/docs/reference/instructions.html +6 -6
package/dist/docs/reference/playground.html +5 -5
package/dist/docs/reference/project-layout.html +6 -6
package/dist/docs/reference/prompt.html +6 -6
package/dist/docs/reference/result.html +6 -6
package/dist/docs/reference/schedules.html +6 -6
package/dist/docs/reference/sessions.html +5 -5
package/dist/docs/reference/skills.html +6 -6
package/dist/docs/reference/subagents.html +6 -6
package/dist/docs/reference/tools.html +6 -6
package/dist/docs/scaffolding-agents.html +6 -6
package/dist/docs/scaffolding-agents.md +2 -1
package/dist/docs/skills/ab.html +6 -6
package/dist/docs/skills/create-agent.html +8 -8
package/dist/docs/skills/create-agent.md +1 -1
package/dist/docs/skills/debug.html +6 -6
package/dist/docs/skills/debug.md +1 -1
package/dist/docs/skills/evals.html +8 -8
package/dist/docs/skills/evals.md +1 -1
package/dist/docs/skills/framework-map.html +6 -6
package/dist/docs/skills/framework-map.md +4 -2
package/dist/docs/skills/github.html +8 -8
package/dist/docs/skills/github.md +1 -1
package/dist/docs/skills/hillclimb.html +6 -6
package/dist/docs/skills/index.html +5 -5
package/dist/docs/skills/mcp-auth.html +6 -6
package/dist/docs/skills/otel.html +8 -8
package/dist/docs/skills/otel.md +3 -3
package/dist/docs/skills/setup-slack.html +6 -6
package/dist/docs/storage.html +6 -6
package/dist/docs/templates/agentic-owners.html +6 -6
package/dist/docs/templates/agents-md.html +6 -6
package/dist/docs/templates/code-wiki.html +6 -6
package/dist/docs/templates/demo.html +6 -6
package/dist/docs/templates/grokbot-agents.html +6 -6
package/dist/docs/templates/pr-autofixer.html +6 -6
package/dist/docs/templates/security-help.html +6 -6
package/dist/docs/templates/security-reviewer.html +6 -6
package/dist/docs/templates/triage.html +6 -6
package/dist/docs/troubleshooting.html +6 -6
package/dist/docs/troubleshooting.md +1 -1
package/dist/extensions/improve/extension.d.ts +46 -0
package/dist/extensions/improve/extension.d.ts.map +1 -0
package/dist/extensions/improve/extension.js +41 -0
package/dist/extensions/improve/skills/yourself.d.ts +4 -0
package/dist/extensions/improve/skills/yourself.d.ts.map +1 -0
package/dist/extensions/improve/skills/yourself.js +43 -0
package/dist/index.d.ts +4 -5
package/dist/index.d.ts.map +1 -1
package/dist/index.js +3 -4
package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -1
package/dist/internal/builtin-tools/artifacts.js +2 -3
package/dist/internal/channel-route-dispatch.d.ts +13 -0
package/dist/internal/channel-route-dispatch.d.ts.map +1 -0
package/dist/internal/channel-route-dispatch.js +62 -0
package/dist/internal/channel-state.d.ts +17 -0
package/dist/internal/channel-state.d.ts.map +1 -0
package/dist/internal/channel-state.js +78 -0
package/dist/internal/cli-ax.d.ts +7 -0
package/dist/internal/cli-ax.d.ts.map +1 -1
package/dist/internal/cli-ax.js +99 -1
package/dist/internal/cli-cursor.d.ts.map +1 -1
package/dist/internal/cli-cursor.js +2 -0
package/dist/internal/cli-deploy.d.ts.map +1 -1
package/dist/internal/cli-deploy.js +61 -25
package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
package/dist/internal/cli-mcp-oauth.js +15 -0
package/dist/internal/cli-mcp.d.ts.map +1 -1
package/dist/internal/cli-mcp.js +12 -0
package/dist/internal/cli-slack.d.ts.map +1 -1
package/dist/internal/cli-slack.js +8 -2
package/dist/internal/cursor/backend-client.d.ts +25 -0
package/dist/internal/cursor/backend-client.d.ts.map +1 -1
package/dist/internal/cursor/backend-client.js +57 -2
package/dist/internal/cursor/credentials.d.ts +8 -2
package/dist/internal/cursor/credentials.d.ts.map +1 -1
package/dist/internal/cursor/credentials.js +27 -5
package/dist/internal/deploy-client.d.ts +35 -0
package/dist/internal/deploy-client.d.ts.map +1 -1
package/dist/internal/deploy-client.js +46 -0
package/dist/internal/deploy-manifest.d.ts +26 -0
package/dist/internal/deploy-manifest.d.ts.map +1 -1
package/dist/internal/deploy-manifest.js +99 -13
package/dist/internal/describe-error.d.ts +1 -0
package/dist/internal/describe-error.d.ts.map +1 -1
package/dist/internal/describe-error.js +25 -0
package/dist/internal/discovery/agent.d.ts.map +1 -1
package/dist/internal/discovery/agent.js +1 -0
package/dist/internal/discovery/info.d.ts.map +1 -1
package/dist/internal/discovery/info.js +7 -3
package/dist/internal/discovery/modules.d.ts +1 -1
package/dist/internal/discovery/modules.d.ts.map +1 -1
package/dist/internal/discovery/modules.js +1 -0
package/dist/internal/discovery/project.d.ts.map +1 -1
package/dist/internal/discovery/project.js +3 -0
package/dist/internal/discovery/reminders.d.ts +7 -0
package/dist/internal/discovery/reminders.d.ts.map +1 -0
package/dist/internal/discovery/reminders.js +65 -0
package/dist/internal/discovery/subagent.js +1 -0
package/dist/internal/distribution.d.ts +5 -0
package/dist/internal/distribution.d.ts.map +1 -1
package/dist/internal/distribution.js +17 -0
package/dist/internal/framework-storage-selection.d.ts +14 -3
package/dist/internal/framework-storage-selection.d.ts.map +1 -1
package/dist/internal/framework-storage-selection.js +36 -6
package/dist/internal/guest-network.d.ts +4 -10
package/dist/internal/guest-network.d.ts.map +1 -1
package/dist/internal/guest-network.js +44 -26
package/dist/internal/hosted-admission-adapter.d.ts +2 -0
package/dist/internal/hosted-admission-adapter.d.ts.map +1 -1
package/dist/internal/hosted-catch-protocol.d.ts +51 -0
package/dist/internal/hosted-catch-protocol.d.ts.map +1 -0
package/dist/internal/hosted-catch-protocol.js +103 -0
package/dist/internal/hosted-catch.d.ts +40 -0
package/dist/internal/hosted-catch.d.ts.map +1 -0
package/dist/internal/hosted-catch.js +149 -0
package/dist/internal/hosted-delivery-protocol.d.ts +89 -0
package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
package/dist/internal/hosted-delivery-protocol.js +309 -0
package/dist/internal/hosted-delivery.d.ts +20 -1
package/dist/internal/hosted-delivery.d.ts.map +1 -1
package/dist/internal/hosted-delivery.js +179 -36
package/dist/internal/hosted-execution-diag.d.ts +4 -1
package/dist/internal/hosted-execution-diag.d.ts.map +1 -1
package/dist/internal/hosted-execution-diag.js +13 -4
package/dist/internal/hosted-execution-flush.d.ts +3 -0
package/dist/internal/hosted-execution-flush.d.ts.map +1 -1
package/dist/internal/hosted-execution-flush.js +2 -4
package/dist/internal/http-control-plane-session.d.ts +30 -0
package/dist/internal/http-control-plane-session.d.ts.map +1 -0
package/dist/internal/http-control-plane-session.js +83 -0
package/dist/internal/legacy-command-guard.d.ts +22 -0
package/dist/internal/legacy-command-guard.d.ts.map +1 -0
package/dist/internal/legacy-command-guard.js +51 -0
package/dist/internal/local-control-plane.d.ts +18 -2
package/dist/internal/local-control-plane.d.ts.map +1 -1
package/dist/internal/local-control-plane.js +199 -17
package/dist/internal/platform-timers.d.ts +7 -0
package/dist/internal/platform-timers.d.ts.map +1 -1
package/dist/internal/platform-timers.js +139 -0
package/dist/internal/reminder-control-plane-protocol.d.ts +189 -0
package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -0
package/dist/internal/reminder-control-plane-protocol.js +251 -0
package/dist/internal/reminder-runner.d.ts +56 -6
package/dist/internal/reminder-runner.d.ts.map +1 -1
package/dist/internal/reminder-runner.js +372 -57
package/dist/internal/reminder-schedule.d.ts +5 -2
package/dist/internal/reminder-schedule.d.ts.map +1 -1
package/dist/internal/reminder-schedule.js +8 -6
package/dist/internal/reminder-store.d.ts +24 -7
package/dist/internal/reminder-store.d.ts.map +1 -1
package/dist/internal/reminder-store.js +6 -5
package/dist/internal/request-error-status.d.ts +2 -0
package/dist/internal/request-error-status.d.ts.map +1 -1
package/dist/internal/request-error-status.js +22 -3
package/dist/internal/resolve-prod-target.d.ts +2 -0
package/dist/internal/resolve-prod-target.d.ts.map +1 -1
package/dist/internal/resolve-prod-target.js +13 -0
package/dist/internal/scm/pr-url.d.ts +40 -0
package/dist/internal/scm/pr-url.d.ts.map +1 -1
package/dist/internal/scm/pr-url.js +93 -14
package/dist/internal/sdk-runner.d.ts.map +1 -1
package/dist/internal/sdk-runner.js +4 -3
package/dist/internal/server.d.ts.map +1 -1
package/dist/internal/server.js +118 -77
package/dist/internal/session-engine.d.ts +6 -6
package/dist/internal/session-engine.d.ts.map +1 -1
package/dist/internal/session-engine.js +100 -67
package/dist/playground/assets/{index-BaQzjaNK.js → index-BMDqAeXu.js} +34 -34
package/dist/playground/assets/index-LUgJoWdL.css +1 -0
package/dist/playground/index.html +2 -2
package/dist/reminders.d.ts +24 -5
package/dist/reminders.d.ts.map +1 -1
package/dist/reminders.js +28 -5
package/dist/storage-backends/cursor-hosted.d.ts +6 -0
package/dist/storage-backends/cursor-hosted.d.ts.map +1 -1
package/dist/storage-backends/cursor-hosted.js +29 -1
package/dist/types.d.ts +122 -25
package/dist/types.d.ts.map +1 -1
package/docs/README.md +4 -0
package/docs/deployment.md +7 -2
package/docs/evals.md +3 -2
package/docs/guides/cloud-agents.md +4 -3
package/docs/guides/github.md +2 -1
package/docs/guides/grokbot-agents.md +2 -2
package/docs/guides/improve.md +96 -0
package/docs/guides/opentelemetry.md +3 -4
package/docs/guides/slack.md +2 -1
package/docs/reference/agent-config.md +5 -2
package/docs/reference/channels.md +11 -19
package/docs/reference/cli.md +23 -13
package/docs/reference/connections.md +2 -1
package/docs/reference/extensions.md +2 -0
package/docs/scaffolding-agents.md +2 -1
package/docs/troubleshooting.md +1 -1
package/package.json +10 -3
package/skills/create-agent/SKILL.md +1 -1
package/skills/debug/SKILL.md +1 -1
package/skills/evals/SKILL.md +1 -1
package/skills/framework-map/SKILL.md +4 -2
package/skills/github/SKILL.md +1 -1
package/skills/otel/SKILL.md +3 -3
package/src/bin/agent-serve.ts +28 -11
package/src/channels/bitbucket/types.ts +2 -4
package/src/channels/deployments/types.ts +5 -8
package/src/channels/github/github-channel.ts +8 -8
package/src/channels/github/types.ts +7 -4
package/src/channels/gitlab/types.ts +2 -5
package/src/channels/origin/origin-channel.ts +29 -13
package/src/channels/origin/types.ts +7 -3
package/src/channels/slack/defaults.ts +3 -0
package/src/channels/slack/dispatch.ts +1 -0
package/src/channels/slack/live-delivery.ts +53 -12
package/src/channels/slack/types.ts +4 -3
package/src/channels.ts +157 -10
package/src/connections.ts +2 -1
package/src/extensions/improve/extension.ts +70 -0
package/src/extensions/improve/skills/yourself.ts +50 -0
package/src/index.ts +6 -3
package/src/internal/builtin-tools/artifacts.ts +2 -3
package/src/internal/channel-route-dispatch.ts +66 -0
package/src/internal/channel-state.ts +96 -0
package/src/internal/cli-ax.ts +110 -1
package/src/internal/cli-cursor.ts +4 -1
package/src/internal/cli-deploy.ts +80 -22
package/src/internal/cli-mcp-oauth.ts +18 -0
package/src/internal/cli-mcp.ts +11 -0
package/src/internal/cli-slack.ts +15 -2
package/src/internal/cursor/backend-client.ts +90 -2
package/src/internal/cursor/credentials.ts +35 -7
package/src/internal/deploy-client.ts +70 -0
package/src/internal/deploy-manifest.ts +131 -12
package/src/internal/describe-error.ts +28 -0
package/src/internal/discovery/agent.ts +1 -0
package/src/internal/discovery/info.ts +6 -0
package/src/internal/discovery/modules.ts +2 -4
package/src/internal/discovery/project.ts +3 -0
package/src/internal/discovery/reminders.ts +65 -0
package/src/internal/discovery/subagent.ts +1 -0
package/src/internal/distribution.ts +20 -0
package/src/internal/framework-storage-selection.ts +43 -6
package/src/internal/guest-network.ts +46 -29
package/src/internal/hosted-admission-adapter.ts +2 -0
package/src/internal/hosted-catch-protocol.ts +130 -0
package/src/internal/hosted-catch.ts +192 -0
package/src/internal/hosted-delivery-protocol.ts +483 -0
package/src/internal/hosted-delivery.ts +303 -43
package/src/internal/hosted-execution-diag.ts +21 -3
package/src/internal/hosted-execution-flush.ts +6 -3
package/src/internal/http-control-plane-session.ts +104 -0
package/src/internal/legacy-command-guard.ts +59 -0
package/src/internal/local-control-plane.ts +281 -22
package/src/internal/platform-timers.ts +191 -0
package/src/internal/reminder-control-plane-protocol.ts +512 -0
package/src/internal/reminder-runner.ts +481 -57
package/src/internal/reminder-schedule.ts +11 -6
package/src/internal/reminder-store.ts +27 -7
package/src/internal/request-error-status.ts +27 -3
package/src/internal/resolve-prod-target.ts +15 -0
package/src/internal/scm/pr-url.ts +167 -20
package/src/internal/sdk-runner.ts +2 -1
package/src/internal/server.ts +151 -88
package/src/internal/session-engine.ts +146 -83
package/src/reminders.ts +35 -4
package/src/storage-backends/cursor-hosted.ts +40 -1
package/src/types.ts +134 -26
package/dist/docs/assets/chunks/@localSearchIndexroot.CJxMklAy.js +0 -1
package/dist/docs/assets/guides_cloud-agents.md.DS8RIjwx.js +0 -9
package/dist/docs/assets/index.md.BW_6tOgR.js +0 -5
package/dist/docs/assets/skills_framework-map.md.haibFyoB.js +0 -1
package/dist/docs/assets/troubleshooting.md.Cus_YZga.js +0 -1
package/dist/playground/assets/index-CceqnLTX.css +0 -1
/package/dist/docs/assets/{evals.md.CbMoebP1.lean.js → evals.md.C1ekS3k2.lean.js} +0 -0
/package/dist/docs/assets/{guides_github.md.c0gdGJ-D.lean.js → guides_github.md.BH33UEBJ.lean.js} +0 -0
/package/dist/docs/assets/{guides_grokbot-agents.md.DVqdhBKb.lean.js → guides_grokbot-agents.md.DyV-WArv.lean.js} +0 -0
/package/dist/docs/assets/{index.md.BW_6tOgR.lean.js → index.md.BjH1w2ZW.lean.js} +0 -0
/package/dist/docs/assets/{reference_agent-config.md.CHNpiyp4.lean.js → reference_agent-config.md.CvoL6pof.lean.js} +0 -0
/package/dist/docs/assets/{reference_connections.md.Di6jJAXF.lean.js → reference_connections.md.BojkC6c5.lean.js} +0 -0
/package/dist/docs/assets/{reference_extensions.md.CGmMLblt.lean.js → reference_extensions.md.CPWt00ds.lean.js} +0 -0
/package/dist/docs/assets/{scaffolding-agents.md.em43xlY1.lean.js → scaffolding-agents.md.Kctn3OVb.lean.js} +0 -0
/package/dist/docs/assets/{skills_create-agent.md.BVoWPcan.lean.js → skills_create-agent.md.Q3h6Je-e.lean.js} +0 -0
/package/dist/docs/assets/{skills_evals.md.723kpUmA.lean.js → skills_evals.md.BhovOvrl.lean.js} +0 -0
/package/dist/docs/assets/{skills_github.md.D0JahM8c.lean.js → skills_github.md.hgFX_oKY.lean.js} +0 -0
/package/dist/docs/assets/{skills_otel.md.CqhobH3B.lean.js → skills_otel.md.B5Ddv1xH.lean.js} +0 -0
/package/dist/docs/assets/{troubleshooting.md.Cus_YZga.lean.js → troubleshooting.md.CYEAO9bM.lean.js} +0 -0

package/dist/playground/index.html CHANGED Viewed

@@ -8,8 +8,8 @@
     />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>agent-serve playground</title>
-    <script type="module" crossorigin src="./assets/index-BaQzjaNK.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-CceqnLTX.css">
+    <script type="module" crossorigin src="./assets/index-BMDqAeXu.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-LUgJoWdL.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/reminders.d.ts CHANGED Viewed

@@ -1,23 +1,42 @@
 /**
- * Runtime reminders — per-session durable wakes.
+ * Runtime reminders — per-session durable wakes — and named handlers
+ * authored at `agent/reminders/<name>.ts`.
  *
  * ```ts
+ * import { defineReminder } from "@cursor/july/reminders";
  * import type { ReminderCreateInput } from "@cursor/july/reminders";
  *
+ * // agent/reminders/verdict_recheck.ts
+ * export default defineReminder({
+ *   async run({ args, followup }) {
+ *     await followup({ message: `Recheck ${String(args.headSha)}` });
+ *     return { action: "delivered" };
+ *   },
+ * });
+ *
+ * import verdictRecheck from "./reminders/verdict_recheck.js";
+ *
  * // Recurring ≈ setInterval; one-shot ≈ setTimeout.
  * await host.reminders?.create({
  *   purpose: "ci_recheck",
  *   channelId: session.channelId,
  *   continuationToken: session.continuationKey!,
  *   delay: "2h",
- *   prompt: "Re-check CI. Only act if still failing.",
+ *   handler: verdictRecheck,
+ *   args: { headSha: "abc" },
  * });
  * ```
  *
  * Distinct from `defineSchedule` (deploy-time global cron under
  * `agent/schedules/`). Reminders are created at runtime and bound to a
- * channel continuation. Prefer `run` + function `until` for host policy
- * (silent ticks); agents use prompt-form create via tools.
+ * channel continuation. Prefer named `handler` + serializable `args` for
+ * hosted v2 durability; anonymous `run` remains on local and hosted v1.
+ */
+import type { ReminderDefinition, ReminderHandlerConfig } from "./types.js";
+export type { ReminderBusyPolicy, ReminderCreateInput, ReminderDefinition, ReminderFireContext, ReminderFireResult, ReminderHandlerConfig, ReminderHostApi, ReminderInfo, ReminderReschedule, ReminderScheduleKind, ReminderStatus, ReminderTarget, ReminderUntilContext, } from "./types.js";
+/**
+ * Brand a named reminder handler for `agent/reminders/<name>.ts`.
+ * The registry name is the module stem (not a field on the definition).
  */
-export type { ReminderBusyPolicy, ReminderCreateInput, ReminderFireContext, ReminderFireResult, ReminderHostApi, ReminderInfo, ReminderReschedule, ReminderScheduleKind, ReminderStatus, ReminderTarget, ReminderUntilContext, } from "./types.js";
+export declare function defineReminder(config: ReminderHandlerConfig): ReminderDefinition;
 //# sourceMappingURL=reminders.d.ts.map

package/dist/reminders.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"reminders.d.ts","sourceRoot":"","sources":["../src/reminders.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;;;;;;;;;;;GAoBG~~;~~AAEH~~,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
1	+ {"version":3,"file":"reminders.d.ts","sourceRoot":"","sources":["../src/reminders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE5E,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,qBAAqB,GAC5B,kBAAkB,CAKpB"}

package/dist/reminders.js CHANGED Viewed

@@ -1,22 +1,45 @@
 /**
- * Runtime reminders — per-session durable wakes.
+ * Runtime reminders — per-session durable wakes — and named handlers
+ * authored at `agent/reminders/<name>.ts`.
  *
  * ```ts
+ * import { defineReminder } from "@cursor/july/reminders";
  * import type { ReminderCreateInput } from "@cursor/july/reminders";
  *
+ * // agent/reminders/verdict_recheck.ts
+ * export default defineReminder({
+ *   async run({ args, followup }) {
+ *     await followup({ message: `Recheck ${String(args.headSha)}` });
+ *     return { action: "delivered" };
+ *   },
+ * });
+ *
+ * import verdictRecheck from "./reminders/verdict_recheck.js";
+ *
  * // Recurring ≈ setInterval; one-shot ≈ setTimeout.
  * await host.reminders?.create({
  *   purpose: "ci_recheck",
  *   channelId: session.channelId,
  *   continuationToken: session.continuationKey!,
  *   delay: "2h",
- *   prompt: "Re-check CI. Only act if still failing.",
+ *   handler: verdictRecheck,
+ *   args: { headSha: "abc" },
  * });
  * ```
  *
  * Distinct from `defineSchedule` (deploy-time global cron under
  * `agent/schedules/`). Reminders are created at runtime and bound to a
- * channel continuation. Prefer `run` + function `until` for host policy
- * (silent ticks); agents use prompt-form create via tools.
+ * channel continuation. Prefer named `handler` + serializable `args` for
+ * hosted v2 durability; anonymous `run` remains on local and hosted v1.
+ */
+import { brandDefinition } from "./internal/brand.js";
+/**
+ * Brand a named reminder handler for `agent/reminders/<name>.ts`.
+ * The registry name is the module stem (not a field on the definition).
  */
-export {};
+export function defineReminder(config) {
+    if (typeof config.run !== "function") {
+        throw new Error("defineReminder requires a `run` function");
+    }
+    return brandDefinition("reminder", config);
+}

package/dist/storage-backends/cursor-hosted.d.ts CHANGED Viewed

@@ -101,6 +101,12 @@ export interface KvListKeysResponse {
      */
     truncated?: boolean;
 }
+export declare class StorageRpcError extends Error {
+    readonly code = "agent_dependency_failed";
+    readonly reasonCode: string;
+    readonly status: number;
+    constructor(message: string, reasonCode: string, status: number);
+}
 /**
  * One authenticated POST to the control-plane proxy. Shared with the
  * architecture-v2 backend (`cursor-hosted-v2.ts`), which speaks a different

package/dist/storage-backends/cursor-hosted.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cursor-hosted.d.ts","sourceRoot":"","sources":["../../src/storage-backends/cursor-hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,aAAa,EAEb,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,aAAa,CAAC;AAW5E;;;GAGG;AACH,eAAO,MAAM,+CAA+C,EAC1D,cAAuB,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAC5C,2BAAoC,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS;IACpD,OAAO,+CAA+C;IACtD,OAAO,iCAAiC;CAIzC,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,MAE1C,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D;AAED,KAAK,0BAA0B,GAAG,QAAQ,CACxC,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC,CACtE,GAAG;IACF,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;IACvC,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,EAAE,cAAc,CAAC;CACrB,CAAC;AA4BF,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,2CAA2C;IAC3C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iEAAiE;IACjE,OAAO,EAAE;QAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAyCD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,0BAA0B,EACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,~~CAqCZ~~;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,0BAA0B,CAuJ5B"}
1	+ {"version":3,"file":"cursor-hosted.d.ts","sourceRoot":"","sources":["../../src/storage-backends/cursor-hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,aAAa,EAEb,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,aAAa,CAAC;AAW5E;;;GAGG;AACH,eAAO,MAAM,+CAA+C,EAC1D,cAAuB,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAC5C,2BAAoC,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS;IACpD,OAAO,+CAA+C;IACtD,OAAO,iCAAiC;CAIzC,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,MAE1C,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D;AAED,KAAK,0BAA0B,GAAG,QAAQ,CACxC,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC,CACtE,GAAG;IACF,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;IACvC,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,EAAE,cAAc,CAAC;CACrB,CAAC;AA4BF,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,2CAA2C;IAC3C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iEAAiE;IACjE,OAAO,EAAE;QAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAaD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAK9D;CACF;AAyCD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,0BAA0B,EACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAoDZ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,0BAA0B,CAuJ5B"}

package/dist/storage-backends/cursor-hosted.js CHANGED Viewed

@@ -70,6 +70,25 @@ export function isCursorHostedStorage(value) {
         value !== null &&
         value[CURSOR_HOSTED_STORAGE] === true);
 }
+const STORAGE_RPC_ERROR_CODES = new Set([
+    "agentsdk_kv_credential_missing",
+    "agentsdk_kv_cursor_invalid",
+    "agentsdk_kv_deployment_unbound",
+    "agentsdk_kv_key_invalid",
+    "agentsdk_kv_request_invalid",
+    "agentsdk_kv_storage_not_allowed",
+    "agentsdk_kv_value_invalid",
+    "agentsdk_kv_version_invalid",
+]);
+export class StorageRpcError extends Error {
+    constructor(message, reasonCode, status) {
+        super(message);
+        this.code = "agent_dependency_failed";
+        this.name = "StorageRpcError";
+        this.reasonCode = reasonCode;
+        this.status = status;
+    }
+}
 function toCasResult(response) {
     var _a;
     if (response.ok) {
@@ -140,7 +159,16 @@ export function storageRpc(options, path, body) {
                 typeof parsed.error === "string"
                 ? parsed.error
                 : `HTTP ${response.status}`;
-            throw new Error(`cursorHostedStorage ${path}: ${error}`);
+            const candidate = parsed !== null &&
+                typeof parsed === "object" &&
+                "code" in parsed &&
+                typeof parsed.code === "string"
+                ? parsed.code
+                : undefined;
+            const code = candidate !== undefined && STORAGE_RPC_ERROR_CODES.has(candidate)
+                ? candidate
+                : "agentsdk_storage_http_error";
+            throw new StorageRpcError(`cursorHostedStorage ${path}: ${error}`, code, response.status);
         }
         return parsed;
     });

package/dist/types.d.ts CHANGED Viewed

@@ -205,20 +205,8 @@ export interface AgentConfig {
      */
     tools?: ToolName[];
     /**
-     * Hosted architecture this agent deploys onto. Omit or `"v1"` keeps the
-     * current control plane and engine-minted conversation keys. `"v2"`
-     * deploys onto the v2 control plane (v2 APIs and schemas). Omitted
-     * channel `continuation` then inherits from declared events (`github.pr/v2`,
-     * `github.issue/v2`, `github.none/v2`, `slack.thread/v2`, `origin.pr/v2`,
-     * `deployments.deployment/v2`, `change_monitors.checkpoint/v2`,
-     * `issues.issue/v2`, `none/v2`). An explicit per-channel selector
-     * still overrides.
-     *
-     * ```ts
-     * export default defineAgent({
-     *   architecture: "v2",
-     * });
-     * ```
+     * Hosted architecture override. Leave this unset unless Cursor instructs
+     * you to select a specific architecture.
      */
     architecture?: AgentArchitecture;
 }
@@ -1502,6 +1490,8 @@ export type SessionEventPayload = {
     type: "turn.failed";
     data: {
         message: string;
+        /** Machine-readable terminal status. Omitted on legacy stored events. */
+        status?: "error" | "cancelled";
     };
 } | {
     /**
@@ -1677,6 +1667,10 @@ export interface TurnOutcome {
     status: "finished" | "error" | "cancelled";
     result?: string;
     errorMessage?: string;
+    /** Stable machine-readable runner code when the failure supplied one. */
+    errorCode?: string;
+    /** Why a cancelled turn stopped, when the engine observed the boundary. */
+    cancellationReason?: "signal" | "runner";
     usage?: TurnUsage;
     /** Cost of {@link usage} from the Cloud Agents cost endpoint. */
     cost?: TurnCost;
@@ -1744,7 +1738,10 @@ export interface ChannelSession {
     getEventStream(options?: {
         startIndex?: number;
     }): Promise<ReadableStream<Uint8Array>>;
-    /** Resolves when the currently running turn reaches a terminal event. */
+    /**
+     * Resolves after the currently running turn reaches a terminal event and
+     * handlers already queued for that session have settled.
+     */
     waitForCompletion(): Promise<TurnOutcome>;
     /** Re-key the session's channel-local continuation token. */
     setContinuationToken(token: string | null): Promise<void>;
@@ -2052,7 +2049,14 @@ export interface ReceiveInput {
     /** Channel-specific delivery target (e.g. a chat channel id). */
     target?: JsonObject;
 }
-/** Per-event channel context: live (persisted) state plus session ops. */
+/**
+ * Per-event channel context. `state` is mutable. Turn events receive the
+ * state snapshot captured for that turn; handler mutations are recursively
+ * merged into the latest persisted state so fields refreshed by overlapping
+ * deliveries survive. At paths changed by the handler, objects merge
+ * recursively, arrays and scalars replace the latest value, and deletion
+ * removes the latest value. Events outside a turn receive current live state.
+ */
 export interface ChannelEventContext<TState = JsonValue> {
     channelId: string;
     state: TState;
@@ -2068,6 +2072,11 @@ export interface SessionContext {
      * relative path cannot read another session's files.
      */
     host: HostContext;
+    /**
+     * Durable artifacts bound to this event's session and turn. `tag`
+     * auto-fills both ids and rejects a conflicting explicit `sessionId`.
+     */
+    artifacts: ArtifactsApi;
 }
 export type ChannelEventHandler<TState = JsonValue, TEvent extends SessionEvent = SessionEvent> = (event: TEvent, channel: ChannelEventContext<TState>, ctx: SessionContext) => void | Promise<void>;
 /** Handlers are keyed by event type and receive the narrowed event. */
@@ -2081,6 +2090,13 @@ export type ChannelEventHandlers<TState = JsonValue> = {
 /** Bound helpers passed to {@link ChannelConfig.onStart}. */
 export interface ChannelStartArgs {
     send: SendMessageFn;
+    /**
+     * Hosted architecture from {@link AgentConfig.architecture}. Omitted
+     * means v1. Host pipelines that call `send()` themselves (instead of
+     * letting the channel adapter stamp continuation) branch on this so
+     * v1 `continuationToken` and v2 `claim` stay mutually exclusive.
+     */
+    architecture?: AgentArchitecture;
     getSession(sessionId: string): Promise<ChannelSession | null>;
     receive(channel: ChannelDefinition | HttpChannelDefinition | string, input: ReceiveInput): Promise<ChannelSession>;
     /** Call an authored server tool directly (no model turn). */
@@ -2232,9 +2248,8 @@ export interface HttpChannelConfig {
     /** Route auth chain. Defaults to `[localDevStrict()]`. */
     auth?: AuthPolicy[];
     /**
-     * Continuation selector. Omitted inherits {@link AgentConfig.architecture}:
-     * `"none/v1"` unless the agent set `architecture: "v2"` (then `"none/v2"`
-     * → `evt:`). Override with an explicit `"none/v1"` or `"none/v2"`.
+     * Continuation selector. Omit this to inherit the agent architecture's
+     * default. Set it explicitly only when migrating persisted identities.
      */
     continuation?: ContinuationIdentity;
     /**
@@ -2321,6 +2336,8 @@ export type ArtifactsDefinition = ArtifactsConfig & BrandedDefinition<"artifacts
  */
 export interface ResultContext {
     session: SessionInfo;
+    /** Durable channel state captured for this turn. */
+    channelState: JsonValue;
     host: HostContext;
     artifacts: ArtifactsApi;
     stateRoot: string;
@@ -2432,7 +2449,26 @@ export interface ScheduleConfig {
     run?: (args: ScheduleHandlerArgs) => void | Promise<void>;
 }
 export type ScheduleDefinition = ScheduleConfig & BrandedDefinition<"schedule">;
+/**
+ * Authored at `agent/reminders/<name>.ts`. The registry name is the module
+ * stem. Pass the discovered definition to {@link ReminderCreateInput.handler}
+ * with serializable {@link ReminderCreateInput.args}; the engine persists the
+ * stem, not the function.
+ */
+export interface ReminderHandlerConfig {
+    /**
+     * Invoked on every fire with {@link ReminderFireContext} (including the
+     * create-time {@link ReminderFireContext.args} blob).
+     */
+    run: (ctx: ReminderFireContext) => Promise<ReminderFireResult>;
+}
+export type ReminderDefinition = ReminderHandlerConfig & BrandedDefinition<"reminder">;
+export interface DiscoveredReminder {
+    name: string;
+    definition: ReminderDefinition;
+}
 export type ReminderBusyPolicy = "skipIfBusy" | "queueBehindTurn";
+/** Public reminder status. Internal claim state (`firing`) is not exposed. */
 export type ReminderStatus = "armed" | "completed" | "cancelled" | "disarmed";
 export type ReminderScheduleKind = "every" | "cron" | "delay" | "at";
 export type ReminderFireResult = {
@@ -2463,6 +2499,11 @@ export interface ReminderUntilContext {
 }
 export interface ReminderFireContext extends ReminderUntilContext {
     appAuth: AuthContext;
+    /**
+     * Serializable args from {@link ReminderCreateInput.args} when the fire
+     * uses a named {@link ReminderCreateInput.handler}. Empty object otherwise.
+     */
+    args: JsonObject;
     /** Wake the reminder's already-bound session (target is implicit). */
     followup(args: {
         message: string;
@@ -2478,9 +2519,11 @@ export interface ReminderFireContext extends ReminderUntilContext {
 /**
  * Create a durable wake bound to a channel continuation.
  *
- * Exactly one of `prompt` | `run`, and exactly one of
+ * Exactly one of `prompt` | `handler` | `run`, and exactly one of
  * `every` | `cron` | `delay` | `at`. Prompt fires always follow up into the
- * bound session.
+ * bound session. Named `handler` resolves `agent/reminders/<name>.ts` on
+ * every fire (survives restart). Anonymous `run` stays supported on local
+ * and hosted v1; hosted architecture v2 rejects it at create.
  *
  * @example Recurring (host policy)
  * ```ts
@@ -2498,6 +2541,28 @@ export interface ReminderFireContext extends ReminderUntilContext {
  * });
  * ```
  *
+ * @example Named handler (durable across restart / hosted v2)
+ * ```ts
+ * // agent/reminders/verdict_recheck.ts
+ * export default defineReminder({
+ *   async run({ args, followup }) {
+ *     // ...
+ *     return { action: "delivered" };
+ *   },
+ * });
+ *
+ * import verdictRecheck from "./reminders/verdict_recheck.js";
+ *
+ * await host.reminders.create({
+ *   purpose: "verdict_recheck",
+ *   channelId: "origin",
+ *   continuationToken,
+ *   delay: "15m",
+ *   handler: verdictRecheck,
+ *   args: { headSha: "abc" },
+ * });
+ * ```
+ *
  * @example One-shot (agent tool / prompt form)
  * ```ts
  * await host.reminders.create({
@@ -2518,8 +2583,22 @@ export interface ReminderCreateInput {
     continuationToken: string;
     /** Optional opaque metadata (e.g. `{ prUrl }`). */
     target?: Record<string, unknown>;
-    /** Exactly one of prompt or run. */
+    /** Exactly one of prompt, handler, or run. */
     prompt?: string;
+    /**
+     * A definition discovered from `agent/reminders/<name>.ts`, or its stem
+     * for compatibility. Mutually exclusive with `prompt` and `run`. The
+     * definition form avoids coupling callers to a filename string; discovery
+     * resolves it to the stable stem persisted by the control plane. Do not
+     * combine with {@link until}; encode stop conditions in {@link args} and
+     * the handler body.
+     */
+    handler?: ReminderDefinition | string;
+    /**
+     * Serializable args for {@link handler} (UTF-8 JSON capped at 32 KiB).
+     * Only valid with `handler`.
+     */
+    args?: JsonObject;
     run?: (ctx: ReminderFireContext) => Promise<ReminderFireResult>;
     /** Exactly one schedule shape. */
     every?: string;
@@ -2529,6 +2608,9 @@ export interface ReminderCreateInput {
     /**
      * Auto-cancel: function (host evaluates, true → cancel) XOR prompt string
      * (agent-facing stop condition; platform does not interpret it).
+     * Valid with `prompt` (string until) and legacy `run` (function until on
+     * local / hosted v1). Not valid with named `handler`. Function until is
+     * rejected on hosted architecture v2.
      */
     until?: string | ((ctx: ReminderUntilContext) => Promise<boolean>);
     /**
@@ -2545,6 +2627,10 @@ export interface ReminderInfo {
     scheduleKind: ReminderScheduleKind;
     scheduleValue: string;
     prompt?: string;
+    /** Named handler stem when create used `handler`. */
+    handler?: string;
+    /** Serializable args when create used `handler`. */
+    args?: JsonObject;
     untilPrompt?: string;
     busyPolicy: ReminderBusyPolicy;
     status: ReminderStatus;
@@ -2776,6 +2862,8 @@ export interface AgentProject {
     httpChannel: HttpChannelDefinition;
     channels: DiscoveredChannel[];
     schedules: DiscoveredSchedule[];
+    /** Named reminder handlers from `agent/reminders/*` (optional / additive). */
+    reminders?: DiscoveredReminder[];
     hooks: DiscoveredHook[];
     /** Live A/B metric experiments (`defineAB`). */
     abs: DiscoveredAB[];
@@ -2899,6 +2987,10 @@ export interface AgentProjectInfo {
         cron: string;
         kind: "markdown" | "run";
     }>;
+    /** Named reminder handlers (`agent/reminders/<name>.ts`) when present. */
+    reminders?: Array<{
+        name: string;
+    }>;
     hooks: string[];
     /** Live A/B experiment names (`defineAB` under `agent/ab`). */
     abs: string[];
@@ -3048,8 +3140,11 @@ export interface ServeOptions {
     stateRoot?: string;
     /**
      * Cursor API key for the SDK runner and Cursor account MCP connections.
-     * When omitted, falls back to `CURSOR_API_KEY`, then to the credential
-     * stored by `agent-sdk login`.
+     * When omitted, falls back to `CURSOR_API_KEY`, then
+     * `CURSOR_API_KEY_FILE` (hosted default `/run/cursor/secrets/CURSOR_API_KEY`
+     * when unset), then `CURSOR_SERVICE_ACCOUNT_KEY`, then the credential
+     * stored by `agent-sdk login`. A bind file wins over
+     * `CURSOR_SERVICE_ACCOUNT_KEY`.
      */
     apiKey?: string;
     /** Run schedules on their cron cadence. Defaults to `!dev`. */
@@ -3134,7 +3229,9 @@ export interface ServeOptions {
      * GitHub and Origin subscriptions are registered independently.
      * The stream is read as the host's Cursor user, so this requires a signed-in
      * host: `serve` throws when no key resolves from `apiKey` here,
-     * {@link ServeOptions.apiKey}, `CURSOR_API_KEY`, or `agent-sdk login`.
+     * {@link ServeOptions.apiKey}, `CURSOR_API_KEY`, `CURSOR_API_KEY_FILE`
+     * (hosted default `/run/cursor/secrets/CURSOR_API_KEY` when unset),
+     * `CURSOR_SERVICE_ACCOUNT_KEY`, or `agent-sdk login`.
      */
     cursorEvents?: {
         repos: string[];