@cursor/july 0.1.75 → 0.1.78
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/origin/origin-webhook.d.ts +23 -2
- package/dist/channels/origin/origin-webhook.d.ts.map +1 -1
- package/dist/channels/origin/origin-webhook.js +82 -20
- package/dist/docs/404.html +2 -2
- package/dist/docs/ab.html +3 -3
- package/dist/docs/assets/{app.b8bhB2SV.js → app.BsA7t7rS.js} +1 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.Dcs6boxD.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.lLSeIyWw.js → VPLocalSearchBox.B1hHhktM.js} +1 -1
- package/dist/docs/assets/chunks/{theme.C_owesa-.js → theme.DLpLSsQh.js} +2 -2
- package/dist/docs/assets/{storage.md.D8NQ389l.js → storage.md.ks1u64_R.js} +3 -3
- package/dist/docs/assets/storage.md.ks1u64_R.lean.js +1 -0
- package/dist/docs/building-with-agents.html +3 -3
- package/dist/docs/concepts.html +3 -3
- package/dist/docs/deployment.html +3 -3
- package/dist/docs/evals.html +3 -3
- package/dist/docs/example-agents/approval-buddy.html +3 -3
- package/dist/docs/example-agents/benny.html +3 -3
- package/dist/docs/example-agents/bugbot.html +3 -3
- package/dist/docs/example-agents/codebase-wiki.html +3 -3
- package/dist/docs/example-agents/codeowners-review.html +3 -3
- package/dist/docs/example-agents/concierge.html +3 -3
- package/dist/docs/example-agents/fsd.html +3 -3
- package/dist/docs/example-agents/index.html +3 -3
- package/dist/docs/example-agents/knowledge-base.html +3 -3
- package/dist/docs/example-agents/oncall.html +3 -3
- package/dist/docs/example-agents/security-reviewer.html +3 -3
- package/dist/docs/example-agents/slack-agent.html +3 -3
- package/dist/docs/example-agents/weather-agent.html +3 -3
- package/dist/docs/guides/agent-to-agent.html +3 -3
- package/dist/docs/guides/cloud-runtime.html +3 -3
- package/dist/docs/guides/convert-automation.html +3 -3
- package/dist/docs/guides/github.html +3 -3
- package/dist/docs/guides/human-in-the-loop.html +3 -3
- package/dist/docs/guides/mcp-oauth.html +3 -3
- package/dist/docs/guides/opentelemetry.html +3 -3
- package/dist/docs/guides/slack.html +3 -3
- package/dist/docs/guides/webhooks.html +3 -3
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +3 -3
- package/dist/docs/index.html +3 -3
- package/dist/docs/quickstart.html +3 -3
- package/dist/docs/reference/agent-config.html +3 -3
- package/dist/docs/reference/artifacts.html +3 -3
- package/dist/docs/reference/channels.html +3 -3
- package/dist/docs/reference/cli.html +3 -3
- package/dist/docs/reference/connections.html +3 -3
- package/dist/docs/reference/hooks.html +3 -3
- package/dist/docs/reference/http-api.html +3 -3
- package/dist/docs/reference/instructions.html +3 -3
- package/dist/docs/reference/playground.html +3 -3
- package/dist/docs/reference/project-layout.html +3 -3
- package/dist/docs/reference/prompt.html +3 -3
- package/dist/docs/reference/schedules.html +3 -3
- package/dist/docs/reference/sessions.html +3 -3
- package/dist/docs/reference/skills.html +3 -3
- package/dist/docs/reference/subagents.html +3 -3
- package/dist/docs/reference/tools.html +3 -3
- package/dist/docs/scaffolding-agents.html +3 -3
- package/dist/docs/storage.html +7 -7
- package/dist/docs/templates/agentic-owners.html +3 -3
- package/dist/docs/templates/demo.html +3 -3
- package/dist/docs/templates/pr-autofixer.html +3 -3
- package/dist/docs/templates/security-reviewer.html +3 -3
- package/dist/docs/templates/triage.html +3 -3
- package/dist/docs/troubleshooting.html +3 -3
- package/dist/index.d.ts +0 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +0 -1
- package/dist/internal/authored-alias-hooks.d.ts +12 -0
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +60 -8
- package/dist/internal/authored-loaders.d.ts +5 -3
- package/dist/internal/authored-loaders.d.ts.map +1 -1
- package/dist/internal/authored-loaders.js +13 -4
- package/dist/internal/deployment-scm-event-stream.js +4 -4
- package/dist/internal/discovery.d.ts.map +1 -1
- package/dist/internal/discovery.js +3 -21
- package/dist/internal/distribution.d.ts.map +1 -1
- package/dist/internal/distribution.js +0 -1
- package/dist/internal/review-comments.d.ts +62 -0
- package/dist/internal/review-comments.d.ts.map +1 -1
- package/dist/internal/review-comments.js +199 -0
- package/dist/internal/session-engine.d.ts +1 -60
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +10 -109
- package/dist/kv/memory-kv.d.ts +1 -10
- package/dist/kv/memory-kv.d.ts.map +1 -1
- package/dist/kv/memory-kv.js +1 -10
- package/dist/kv.d.ts +2 -3
- package/dist/kv.d.ts.map +1 -1
- package/dist/kv.js +2 -3
- package/dist/playground/assets/index-DJzcIeGt.css +1 -0
- package/dist/playground/assets/{index-BJy9UJrF.js → index-K3Sxyx0I.js} +48 -45
- package/dist/playground/index.html +2 -2
- package/dist/storage-backends/cursor-hosted.js +3 -3
- package/dist/storage-protocol.d.ts +3 -8
- package/dist/storage-protocol.d.ts.map +1 -1
- package/dist/storage-protocol.js +4 -10
- package/dist/storage.d.ts +5 -11
- package/dist/storage.d.ts.map +1 -1
- package/dist/storage.js +3 -4
- package/dist/types.d.ts +5 -34
- package/dist/types.d.ts.map +1 -1
- package/docs/storage.md +11 -44
- package/package.json +1 -8
- package/src/channels/origin/origin-webhook.ts +111 -25
- package/src/index.ts +0 -6
- package/src/internal/authored-alias-hooks.ts +75 -7
- package/src/internal/authored-loaders.ts +15 -4
- package/src/internal/deployment-scm-event-stream.ts +4 -4
- package/src/internal/discovery.ts +3 -27
- package/src/internal/distribution.ts +0 -1
- package/src/internal/review-comments.ts +286 -0
- package/src/internal/session-engine.ts +1 -168
- package/src/kv/memory-kv.ts +1 -10
- package/src/kv.ts +2 -3
- package/src/storage-backends/cursor-hosted.ts +3 -3
- package/src/storage-protocol.ts +4 -10
- package/src/storage.ts +6 -12
- package/src/types.ts +5 -35
- package/dist/docs/assets/chunks/@localSearchIndexroot.DGZeXVqn.js +0 -1
- package/dist/docs/assets/storage.md.D8NQ389l.lean.js +0 -1
- package/dist/internal/durable-session-store.d.ts +0 -60
- package/dist/internal/durable-session-store.d.ts.map +0 -1
- package/dist/internal/durable-session-store.js +0 -131
- package/dist/internal/ledger-serving.d.ts +0 -169
- package/dist/internal/ledger-serving.d.ts.map +0 -1
- package/dist/internal/ledger-serving.js +0 -393
- package/dist/ledger/janitor.d.ts +0 -60
- package/dist/ledger/janitor.d.ts.map +0 -1
- package/dist/ledger/janitor.js +0 -137
- package/dist/ledger/session-ledger.d.ts +0 -293
- package/dist/ledger/session-ledger.d.ts.map +0 -1
- package/dist/ledger/session-ledger.js +0 -614
- package/dist/ledger.d.ts +0 -12
- package/dist/ledger.d.ts.map +0 -1
- package/dist/ledger.js +0 -9
- package/dist/playground/assets/index-BrSd5vff.css +0 -1
- package/src/internal/durable-session-store.ts +0 -134
- package/src/internal/ledger-serving.ts +0 -531
- package/src/ledger/janitor.ts +0 -193
- package/src/ledger/session-ledger.ts +0 -839
- package/src/ledger.ts +0 -44
package/src/storage.ts
CHANGED
|
@@ -7,9 +7,8 @@
|
|
|
7
7
|
* only, and eval/A/B history stays in process memory.
|
|
8
8
|
*
|
|
9
9
|
* The sink is a plain key-value store — put/get/delete/list, no schema —
|
|
10
|
-
* plus a conditional-write group ({@link StorageConfig.cas}
|
|
11
|
-
*
|
|
12
|
-
* coordination features). Implementing that small KV core is enough for
|
|
10
|
+
* plus a conditional-write group ({@link StorageConfig.cas}; optional).
|
|
11
|
+
* Implementing that small KV core is enough for
|
|
13
12
|
* FULL functionality: eval-run and A/B history are derived over the core
|
|
14
13
|
* when the optional dedicated tables ({@link StorageConfig.evals} and
|
|
15
14
|
* {@link StorageConfig.abs}) are not authored — those groups exist as
|
|
@@ -178,10 +177,7 @@ export interface StorageABTable {
|
|
|
178
177
|
/**
|
|
179
178
|
* Conditional writes (CAS) — the coordination tier of the storage backend
|
|
180
179
|
* contract. Plain storage works without it, so existing backends keep
|
|
181
|
-
* working across a platform upgrade
|
|
182
|
-
* session ledger — see `@cursor/july/kv` for the backend-agnostic
|
|
183
|
-
* interface) requires it and fails at startup, with an actionable
|
|
184
|
-
* message, when the backend lacks it. The built-in backends all include
|
|
180
|
+
* working across a platform upgrade. The built-in backends all include
|
|
185
181
|
* it, so implementing this group yourself only comes up for BYO storage.
|
|
186
182
|
*
|
|
187
183
|
* Grouped under {@link StorageConfig.cas} rather than as loose methods —
|
|
@@ -243,10 +239,8 @@ export interface StorageConfig {
|
|
|
243
239
|
abs?: StorageABTable;
|
|
244
240
|
/**
|
|
245
241
|
* Conditional writes (CAS). Optional for plain storage — existing
|
|
246
|
-
* backends keep working without it
|
|
247
|
-
*
|
|
248
|
-
* The built-in backends (`fileKv`, `cursorHostedStorage`) both include
|
|
249
|
-
* it. See {@link StorageCasTable}.
|
|
242
|
+
* backends keep working without it. The built-in backends (`fileKv`,
|
|
243
|
+
* `cursorHostedStorage`) both include it. See {@link StorageCasTable}.
|
|
250
244
|
*/
|
|
251
245
|
cas?: StorageCasTable;
|
|
252
246
|
/**
|
|
@@ -321,7 +315,7 @@ export function defineStorage(config: StorageConfig): StorageDefinition {
|
|
|
321
315
|
] as const;
|
|
322
316
|
const cas = config.cas;
|
|
323
317
|
// A partial group is a bug, not a legacy config: half-implemented CAS
|
|
324
|
-
// would pass the capability probe
|
|
318
|
+
// would pass the capability probe.
|
|
325
319
|
const missingCasHooks = casHooks.filter(
|
|
326
320
|
(hook) => typeof cas[hook] !== "function"
|
|
327
321
|
);
|
package/src/types.ts
CHANGED
|
@@ -240,31 +240,8 @@ export interface AgentConfig {
|
|
|
240
240
|
* it only shapes what the model can call.
|
|
241
241
|
*/
|
|
242
242
|
tools?: ToolName[];
|
|
243
|
-
/**
|
|
244
|
-
* How the serve host coordinates event delivery and turn execution. See
|
|
245
|
-
* {@link AgentServingMode}. Defaults to `"resident"`; opt in to
|
|
246
|
-
* `"ledger"` per agent — rollback is flipping the value back.
|
|
247
|
-
*/
|
|
248
|
-
serving?: AgentServingMode;
|
|
249
243
|
}
|
|
250
244
|
|
|
251
|
-
/**
|
|
252
|
-
* Serving coordination mode on {@link AgentConfig.serving}.
|
|
253
|
-
*
|
|
254
|
-
* - `"resident"` (default): the in-process session engine owns delivery —
|
|
255
|
-
* today's behavior, unchanged.
|
|
256
|
-
* - `"ledger"`: every delivery coordinates through the KV session ledger
|
|
257
|
-
* before its turn runs: session identity, a one-writer-per-session
|
|
258
|
-
* lease with generation fencing, and a fenced commit sequence.
|
|
259
|
-
* Requires a store with conditional writes (the `cas` group on
|
|
260
|
-
* `defineStorage`, or an explicit CAS-capable override); startup fails
|
|
261
|
-
* fast otherwise. This stage is coordination only — there is no
|
|
262
|
-
* durable inbox yet, so an event arriving while the lease is held
|
|
263
|
-
* waits in-process and a crash loses it exactly as resident serving
|
|
264
|
-
* does. The durable mailbox lands in a follow-up.
|
|
265
|
-
*/
|
|
266
|
-
export type AgentServingMode = "resident" | "ledger";
|
|
267
|
-
|
|
268
245
|
/**
|
|
269
246
|
* Built-in tools on {@link AgentConfig.builtinTools}. Each enabled
|
|
270
247
|
* capability materializes as ordinary server tools at discovery time, so
|
|
@@ -596,14 +573,12 @@ export type KvCasResult =
|
|
|
596
573
|
| { ok: false; current: KvVersionedEntry | undefined };
|
|
597
574
|
|
|
598
575
|
/**
|
|
599
|
-
* Conditional-write superset of {@link HostKvApi}
|
|
600
|
-
*
|
|
601
|
-
*
|
|
602
|
-
*
|
|
603
|
-
* deep JSON equality with key-order pitfalls on each of them. The
|
|
576
|
+
* Conditional-write superset of {@link HostKvApi}. Version-token CAS was
|
|
577
|
+
* chosen over compare-value: every candidate backend can mint a cheap
|
|
578
|
+
* opaque token (counter, UUID, row version), while compare-value would
|
|
579
|
+
* force deep JSON equality with key-order pitfalls on each of them. The
|
|
604
580
|
* agent-facing `host.kv` stays plain {@link HostKvApi}; storage backends
|
|
605
|
-
* supply CAS via the optional `cas` group on `defineStorage
|
|
606
|
-
* coordination features fail fast when the backend lacks it.
|
|
581
|
+
* supply CAS via the optional `cas` group on `defineStorage`.
|
|
607
582
|
*/
|
|
608
583
|
export interface HostKvCasApi extends HostKvApi {
|
|
609
584
|
/** Read one value with its version token. Miss → `undefined`. */
|
|
@@ -2574,11 +2549,6 @@ export interface ResolvedAgent {
|
|
|
2574
2549
|
hosting?: AgentHostingOptions;
|
|
2575
2550
|
/** Validated turn admission limits from {@link AgentConfig.concurrency}. */
|
|
2576
2551
|
concurrency?: AgentConcurrencyOptions;
|
|
2577
|
-
/**
|
|
2578
|
-
* Validated serving mode from {@link AgentConfig.serving}. Undefined
|
|
2579
|
-
* means `"resident"` (the default path).
|
|
2580
|
-
*/
|
|
2581
|
-
serving?: AgentServingMode;
|
|
2582
2552
|
tools: DiscoveredTool[];
|
|
2583
2553
|
skills: DiscoveredSkill[];
|
|
2584
2554
|
connections: DiscoveredConnection[];
|