npm - @cursor/july - Versions diffs - 0.1.48 → 0.1.51 - Mend

@cursor/july 0.1.48 → 0.1.51

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 (151) hide show

package/AGENTS.md +3 -3
package/README.md +7 -14
package/dist/bin/agent-serve.js +22 -8
package/dist/channels/slack/init.d.ts +2 -3
package/dist/channels/slack/init.d.ts.map +1 -1
package/dist/channels/slack/init.js +8 -43
package/dist/channels/slack/manifest.d.ts +3 -3
package/dist/channels/slack/manifest.js +3 -3
package/dist/channels/slack/setup.d.ts +2 -11
package/dist/channels/slack/setup.d.ts.map +1 -1
package/dist/channels/slack/setup.js +26 -94
package/dist/channels/slack/types.d.ts +3 -4
package/dist/channels/slack/types.d.ts.map +1 -1
package/dist/docs/404.html +2 -2
package/dist/docs/ab.html +5 -5
package/dist/docs/assets/{ab.md.hdxsvX5M.js → ab.md.DYjwREAP.js} +2 -2
package/dist/docs/assets/{ab.md.hdxsvX5M.lean.js → ab.md.DYjwREAP.lean.js} +1 -1
package/dist/docs/assets/{app.BC1P20xI.js → app.C51TX1Bw.js} +1 -1
package/dist/docs/assets/chunks/@localSearchIndexroot.D2DpXdZN.js +1 -0
package/dist/docs/assets/chunks/{VPLocalSearchBox.C_900xn2.js → VPLocalSearchBox.BB9HCJPq.js} +1 -1
package/dist/docs/assets/chunks/{theme.CT135Jhh.js → theme.Dp-0SZcu.js} +2 -2
package/dist/docs/assets/{deployment.md.Cdp4rTE4.js → deployment.md.B8kW-h7P.js} +1 -1
package/dist/docs/assets/{evals.md.qeoGgPw0.js → evals.md.CVe_O75-.js} +3 -3
package/dist/docs/assets/{evals.md.qeoGgPw0.lean.js → evals.md.CVe_O75-.lean.js} +1 -1
package/dist/docs/assets/{example-agents_benny.md.l7JTmm8X.js → example-agents_benny.md.B-LIDGja.js} +1 -1
package/dist/docs/assets/{example-agents_oncall.md.ZE0n6ZFN.js → example-agents_oncall.md.CBmyuAKc.js} +2 -2
package/dist/docs/assets/{guides_human-in-the-loop.md.BWvT7UqY.js → guides_human-in-the-loop.md.Cf8kIIqC.js} +2 -2
package/dist/docs/assets/{guides_human-in-the-loop.md.BWvT7UqY.lean.js → guides_human-in-the-loop.md.Cf8kIIqC.lean.js} +1 -1
package/dist/docs/assets/{guides_slack.md.zriQpU_9.js → guides_slack.md.D2nTRu9M.js} +7 -12
package/dist/docs/assets/guides_slack.md.D2nTRu9M.lean.js +1 -0
package/dist/docs/assets/{reference_cli.md.BDmjPPAm.js → reference_cli.md.CGKfz_Yj.js} +3 -7
package/dist/docs/assets/{reference_cli.md.BDmjPPAm.lean.js → reference_cli.md.CGKfz_Yj.lean.js} +1 -1
package/dist/docs/assets/{reference_http-api.md.DGrw_wOu.js → reference_http-api.md.DMbdFGVQ.js} +1 -1
package/dist/docs/assets/{storage.md.CJYd5YmN.js → storage.md.D8NQ389l.js} +3 -3
package/dist/docs/assets/storage.md.D8NQ389l.lean.js +1 -0
package/dist/docs/assets/{troubleshooting.md.CkgwmVI0.js → troubleshooting.md.C6n3wCr6.js} +1 -1
package/dist/docs/building-with-agents.html +3 -3
package/dist/docs/concepts.html +3 -3
package/dist/docs/deployment.html +5 -5
package/dist/docs/evals.html +6 -6
package/dist/docs/example-agents/approval-buddy.html +3 -3
package/dist/docs/example-agents/benny.html +5 -5
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 +6 -6
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/github.html +3 -3
package/dist/docs/guides/human-in-the-loop.html +5 -5
package/dist/docs/guides/mcp-oauth.html +3 -3
package/dist/docs/guides/opentelemetry.html +3 -3
package/dist/docs/guides/slack.html +11 -16
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 +6 -10
package/dist/docs/reference/connections.html +3 -3
package/dist/docs/reference/hooks.html +3 -3
package/dist/docs/reference/http-api.html +5 -5
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 +5 -5
package/dist/docs/templates/triage.html +3 -3
package/dist/docs/troubleshooting.html +5 -5
package/dist/internal/cli-ax.js +3 -3
package/dist/internal/cli-cursor.d.ts +18 -0
package/dist/internal/cli-cursor.d.ts.map +1 -1
package/dist/internal/cli-cursor.js +25 -0
package/dist/internal/cli-slack.d.ts +3 -4
package/dist/internal/cli-slack.d.ts.map +1 -1
package/dist/internal/cli-slack.js +126 -325
package/dist/internal/convert-automation/convert-workflow.js +2 -2
package/dist/internal/event-log.d.ts +17 -0
package/dist/internal/event-log.d.ts.map +1 -1
package/dist/internal/event-log.js +32 -2
package/dist/internal/process-memory-telemetry.d.ts +90 -0
package/dist/internal/process-memory-telemetry.d.ts.map +1 -0
package/dist/internal/process-memory-telemetry.js +259 -0
package/dist/internal/server.d.ts.map +1 -1
package/dist/internal/server.js +9 -10
package/dist/internal/session-engine.d.ts +4 -0
package/dist/internal/session-engine.d.ts.map +1 -1
package/dist/internal/session-engine.js +19 -5
package/dist/internal/slack-provision-client.d.ts +41 -6
package/dist/internal/slack-provision-client.d.ts.map +1 -1
package/dist/internal/slack-provision-client.js +53 -7
package/dist/playground/assets/{index-DEVTyeOu.js → index-BKMz70wx.js} +41 -41
package/dist/playground/assets/index-BmMrulSc.css +1 -0
package/dist/playground/index.html +2 -2
package/dist/storage.d.ts +36 -10
package/dist/storage.d.ts.map +1 -1
package/dist/storage.js +82 -6
package/docs/ab.md +4 -3
package/docs/deployment.md +1 -1
package/docs/evals.md +10 -7
package/docs/example-agents/benny.md +2 -3
package/docs/example-agents/oncall.md +4 -5
package/docs/guides/human-in-the-loop.md +1 -1
package/docs/guides/slack.md +51 -112
package/docs/reference/cli.md +14 -37
package/docs/reference/http-api.md +4 -3
package/docs/storage.md +38 -22
package/docs/troubleshooting.md +2 -2
package/package.json +1 -1
package/skills/create-agent/SKILL.md +4 -5
package/skills/setup-slack/SKILL.md +74 -132
package/src/bin/agent-serve.ts +26 -9
package/src/channels/slack/init.ts +10 -71
package/src/channels/slack/manifest.ts +3 -3
package/src/channels/slack/setup.ts +25 -103
package/src/channels/slack/types.ts +3 -4
package/src/internal/cli-ax.ts +3 -3
package/src/internal/cli-cursor.ts +34 -0
package/src/internal/cli-slack.ts +136 -394
package/src/internal/convert-automation/convert-workflow.ts +2 -2
package/src/internal/event-log.ts +45 -7
package/src/internal/process-memory-telemetry.ts +373 -0
package/src/internal/server.ts +13 -0
package/src/internal/session-engine.ts +20 -1
package/src/internal/slack-provision-client.ts +90 -9
package/src/storage.ts +130 -11
package/dist/docs/assets/chunks/@localSearchIndexroot.DV5SAHnQ.js +0 -1
package/dist/docs/assets/guides_slack.md.zriQpU_9.lean.js +0 -1
package/dist/docs/assets/storage.md.CJYd5YmN.lean.js +0 -1
package/dist/playground/assets/index-CiCmH6R-.css +0 -1
/package/dist/docs/assets/{deployment.md.Cdp4rTE4.lean.js → deployment.md.B8kW-h7P.lean.js} +0 -0
/package/dist/docs/assets/{example-agents_benny.md.l7JTmm8X.lean.js → example-agents_benny.md.B-LIDGja.lean.js} +0 -0
/package/dist/docs/assets/{example-agents_oncall.md.ZE0n6ZFN.lean.js → example-agents_oncall.md.CBmyuAKc.lean.js} +0 -0
/package/dist/docs/assets/{reference_http-api.md.DGrw_wOu.lean.js → reference_http-api.md.DMbdFGVQ.lean.js} +0 -0
/package/dist/docs/assets/{troubleshooting.md.CkgwmVI0.lean.js → troubleshooting.md.C6n3wCr6.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-DEVTyeOu.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-CiCmH6R-.css">
+    <script type="module" crossorigin src="./assets/index-BKMz70wx.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BmMrulSc.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/storage.d.ts CHANGED Viewed

@@ -9,9 +9,12 @@
  * The sink is a plain key-value store — put/get/delete/list, no schema —
  * plus a conditional-write group ({@link StorageConfig.cas}, the substrate
  * for framework coordination; optional for plain storage, required by
- * coordination features) and two optional dedicated tables
- * ({@link StorageConfig.evals} and {@link StorageConfig.abs}) for
- * eval-run and A/B history:
+ * coordination features). Implementing that small KV core is enough for
+ * FULL functionality: eval-run and A/B history are derived over the core
+ * when the optional dedicated tables ({@link StorageConfig.evals} and
+ * {@link StorageConfig.abs}) are not authored — those groups exist as
+ * backend-native optimizations (a real table, an analytics pipeline),
+ * not as required-or-lose-history hooks:
  *
  * ```ts
  * import { defineStorage } from "@anysphere/agent-serve/storage";
@@ -178,13 +181,20 @@ export interface StorageConfig {
     /** Timing knobs; see {@link StoragePolicy}. */
     policy?: StoragePolicy;
     /**
-     * Dedicated eval-runs table. Omit it and playground eval history stays
-     * in process memory (lost on restart).
+     * Dedicated eval-runs table — a backend-native optimization, not a
+     * requirement. When omitted, `defineStorage` derives the table over the
+     * KV core (one key per run under `agentkit/v1/{agent}/eval-runs/`),
+     * which needs core `put`, `delete`, and `list`; only when the core
+     * lacks `delete` or `list` does playground eval history stay in process
+     * memory (lost on restart).
      */
     evals?: StorageEvalsTable;
     /**
-     * Dedicated A/B table. Omit it and metric samples are not exported
-     * (session event logs remain the assignment/fold source of truth).
+     * Dedicated A/B table — a backend-native optimization, not a
+     * requirement. When omitted, `defineStorage` derives it over the KV
+     * core: `putSample` and `putSnapshot` need only core `put` (always
+     * present), `getSnapshot` additionally needs core `get`. Session event
+     * logs remain the assignment/fold source of truth either way.
      */
     abs?: StorageABTable;
     /**
@@ -217,7 +227,8 @@ export interface StorageConfig {
     /**
      * All entries under a key prefix, in ascending key order. Optional —
      * required for the **startup bulk restore** (sessions + event streams)
-     * and playground eval history.
+     * and, together with `delete`, for the derived eval-runs table
+     * (playground eval history).
      */
     list?(prefix: string, ctx: StorageContext): StorageEntry[] | Promise<StorageEntry[]>;
 }
@@ -252,9 +263,14 @@ export declare const STORAGE_KEY_ROOT: "agentkit/v1";
  * | `agentkit/v1/{agent}/session-events/{sessionId}/{index}` | `SessionEvent[]` chunk (index = first event's index, zero-padded) |
  * | `agentkit/v1/{agent}/continuation/{channelId}/{token}` | `{ sessionId }` |
  * | `agentkit/v1/{agent}/kv/{key}` | Author JSON via {@link HostContext.kv} |
+ * | `agentkit/v1/{agent}/eval-runs/{runId}` | `EvalRunSnapshot` (derived `evals` table) |
+ * | `agentkit/v1/{agent}/ab-samples/{experiment}/{sessionId}/{at}` | `ABMetricSample` (derived `abs` table, append-only) |
+ * | `agentkit/v1/{agent}/ab-snapshot` | `ABSnapshot` (derived `abs` table, LWW) |
  *
- * Eval-run and A/B history do not flow through this KV scheme — they have
- * dedicated tables ({@link StorageConfig.evals} / {@link StorageConfig.abs}).
+ * The `eval-runs` / `ab-samples` / `ab-snapshot` families are minted only
+ * by the tables `defineStorage` derives over the KV core; a backend that
+ * authors dedicated {@link StorageConfig.evals} / {@link StorageConfig.abs}
+ * groups never sees them.
  */
 export declare const storageKeys: {
     readonly session: (agent: string, sessionId: string) => string;
@@ -268,6 +284,16 @@ export declare const storageKeys: {
      */
     readonly kv: (agent: string, key: string) => string;
     readonly kvPrefix: (agent: string) => string;
+    /** One playground eval-run snapshot (derived `evals` table). */
+    readonly evalRun: (agent: string, runId: string) => string;
+    readonly evalRunsPrefix: (agent: string) => string;
+    /**
+     * One A/B metric sample (derived `abs` table); the segments mirror the
+     * dedicated table's row identity (experiment + sessionId + at).
+     */
+    readonly abSample: (agent: string, experiment: string, sessionId: string, at: string) => string;
+    /** Latest aggregate A/B snapshot (derived `abs` table, LWW). */
+    readonly abSnapshot: (agent: string) => string;
 };
 /**
  * Max bytes a caller-controlled key segment may occupy after URI-encoding.

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

	@@ -1 +1 @@
1	- {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG~~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~~;;;OAGG~~;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B~~;;;OAGG~~;IACH,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,kEAAkE;IAClE,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE;;;;;;;OAOG;IACH,GAAG,CAAC,CACF,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,GAClB,SAAS,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IACxE~~;;;;OAIG~~;IACH,IAAI,CAAC,CACH,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,GAClB,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG;IAC9C,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;CAClC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,~~CA8DtE~~;~~AAMD~~;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,aAAsB,CAAC;AAEvD~~;;;;;;;;;;;;;;;;;;;;;GAqBG~~;AACH,eAAO,MAAM,WAAW;aACtB,OAAO,UAAU,MAAM,aAAa,MAAM,KAAG,MAAM;aAEnD,aAAa,UAAU,MAAM,KAAG,MAAM;aAEtC,aAAa,UACJ,MAAM,aACF,MAAM,cACL,MAAM,KACjB,MAAM;aAET,mBAAmB,UAAU,MAAM,aAAa,MAAM,KAAG,MAAM;aAE/D,YAAY,UACH,MAAM,aACF,MAAM,mBACA,MAAM,KACtB,MAAM;IAET;;;OAGG;aACH,EAAE,UAAU,MAAM,OAAO,MAAM,KAAG,MAAM;aAExC,QAAQ,UAAU,MAAM,KAAG,MAAM;~~CACzB~~,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAMD,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAC1D,eAAO,MAAM,kCAAkC,EAAE,MAA8B,CAAC;AAChF,eAAO,MAAM,uCAAuC,aAAgB,CAAC;AAErE,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,EAAE,SAAS,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,OAAO,EACH,KAAK,GACL;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,qBAAqB,CA8BvB"}
1	+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/storage.js CHANGED Viewed

@@ -9,9 +9,12 @@
  * The sink is a plain key-value store — put/get/delete/list, no schema —
  * plus a conditional-write group ({@link StorageConfig.cas}, the substrate
  * for framework coordination; optional for plain storage, required by
- * coordination features) and two optional dedicated tables
- * ({@link StorageConfig.evals} and {@link StorageConfig.abs}) for
- * eval-run and A/B history:
+ * coordination features). Implementing that small KV core is enough for
+ * FULL functionality: eval-run and A/B history are derived over the core
+ * when the optional dedicated tables ({@link StorageConfig.evals} and
+ * {@link StorageConfig.abs}) are not authored — those groups exist as
+ * backend-native optimizations (a real table, an analytics pipeline),
+ * not as required-or-lose-history hooks:
  *
  * ```ts
  * import { defineStorage } from "@anysphere/agent-serve/storage";
@@ -48,6 +51,15 @@
  * event log under `--state-root` remains the live source of truth; this
  * interface is the durable mirror.
  */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 import { createHash } from "node:crypto";
 import { brandDefinition } from "./internal/brand.js";
 /**
@@ -101,7 +113,56 @@ export function defineStorage(config) {
     }
     // Validate eagerly so a bad policy fails at discovery, not first flush.
     resolveStoragePolicy(config.policy);
-    return brandDefinition("storage", config);
+    // A backend that implements only the KV core gets full functionality:
+    // the dedicated tables are backend-native optimizations, derived over
+    // the core when absent. Authored groups always win.
+    const derivedEvals = config.evals === undefined ? deriveEvalsTable(config) : undefined;
+    const derivedAbs = config.abs === undefined ? deriveAbsTable(config) : undefined;
+    return brandDefinition("storage", Object.assign(Object.assign(Object.assign({}, config), (derivedEvals === undefined ? {} : { evals: derivedEvals })), (derivedAbs === undefined ? {} : { abs: derivedAbs })));
+}
+/**
+ * Eval-runs table over the KV core: one key per run under
+ * {@link storageKeys.evalRun}, hydrate via prefix `list`, prune via
+ * `delete`. Requires core `put` + `delete` + `list`; without `delete` or
+ * `list` there is no derivation (pruning or hydration would silently not
+ * work) and eval history stays in process memory.
+ */
+function deriveEvalsTable(config) {
+    if (config.delete === undefined || config.list === undefined) {
+        return undefined;
+    }
+    return {
+        put: (run, ctx) => config.put(storageKeys.evalRun(ctx.agentName, run.runId), run, ctx),
+        delete: (runId, ctx) => { var _a; return (_a = config.delete) === null || _a === void 0 ? void 0 : _a.call(config, storageKeys.evalRun(ctx.agentName, runId), ctx); },
+        list: (ctx) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            var _b;
+            const entries = (_b = (yield (_a = config.list) === null || _a === void 0 ? void 0 : _a.call(config, storageKeys.evalRunsPrefix(ctx.agentName), ctx))) !== null && _b !== void 0 ? _b : [];
+            return entries.map((entry) => entry.value);
+        }),
+    };
+}
+/**
+ * A/B table over the KV core. Each sample lands as its own key (identity
+ * = experiment + sessionId + at, matching the dedicated table's row
+ * uniqueness): appending to one array value would need read-modify-write
+ * — lost updates under concurrent writers without CAS, and unbounded
+ * value growth — while a key per sample keeps `putSample` a blind put
+ * with real append-only semantics. The aggregate snapshot lives at one
+ * fixed key via plain `put` (last-write-wins is correct for "latest").
+ * Requires only core `put`; `getSnapshot` is included when core `get`
+ * exists.
+ */
+function deriveAbsTable(config) {
+    const get = config.get;
+    return Object.assign({ putSample: (sample, ctx) => config.put(storageKeys.abSample(ctx.agentName, sample.experiment, sample.sessionId, sample.at), sample, ctx), putSnapshot: (snapshot, ctx) => config.put(storageKeys.abSnapshot(ctx.agentName), snapshot, ctx) }, (get === undefined
+        ? {}
+        : {
+            getSnapshot: (ctx) => __awaiter(this, void 0, void 0, function* () {
+                const value = yield get(storageKeys.abSnapshot(ctx.agentName), ctx);
+                return (value !== null && value !== void 0 ? value : undefined);
+            }),
+        }));
 }
 // ============================================================================
 // Key scheme
@@ -129,9 +190,14 @@ export const STORAGE_KEY_ROOT = "agentkit/v1";
  * | `agentkit/v1/{agent}/session-events/{sessionId}/{index}` | `SessionEvent[]` chunk (index = first event's index, zero-padded) |
  * | `agentkit/v1/{agent}/continuation/{channelId}/{token}` | `{ sessionId }` |
  * | `agentkit/v1/{agent}/kv/{key}` | Author JSON via {@link HostContext.kv} |
+ * | `agentkit/v1/{agent}/eval-runs/{runId}` | `EvalRunSnapshot` (derived `evals` table) |
+ * | `agentkit/v1/{agent}/ab-samples/{experiment}/{sessionId}/{at}` | `ABMetricSample` (derived `abs` table, append-only) |
+ * | `agentkit/v1/{agent}/ab-snapshot` | `ABSnapshot` (derived `abs` table, LWW) |
  *
- * Eval-run and A/B history do not flow through this KV scheme — they have
- * dedicated tables ({@link StorageConfig.evals} / {@link StorageConfig.abs}).
+ * The `eval-runs` / `ab-samples` / `ab-snapshot` families are minted only
+ * by the tables `defineStorage` derives over the KV core; a backend that
+ * authors dedicated {@link StorageConfig.evals} / {@link StorageConfig.abs}
+ * groups never sees them.
  */
 export const storageKeys = {
     session: (agent, sessionId) => `${STORAGE_KEY_ROOT}/${agent}/session/${sessionId}`,
@@ -145,6 +211,16 @@ export const storageKeys = {
      */
     kv: (agent, key) => `${STORAGE_KEY_ROOT}/${agent}/kv/${keySegment(key)}`,
     kvPrefix: (agent) => `${STORAGE_KEY_ROOT}/${agent}/kv/`,
+    /** One playground eval-run snapshot (derived `evals` table). */
+    evalRun: (agent, runId) => `${STORAGE_KEY_ROOT}/${agent}/eval-runs/${keySegment(runId)}`,
+    evalRunsPrefix: (agent) => `${STORAGE_KEY_ROOT}/${agent}/eval-runs/`,
+    /**
+     * One A/B metric sample (derived `abs` table); the segments mirror the
+     * dedicated table's row identity (experiment + sessionId + at).
+     */
+    abSample: (agent, experiment, sessionId, at) => `${STORAGE_KEY_ROOT}/${agent}/ab-samples/${keySegment(experiment)}/${keySegment(sessionId)}/${keySegment(at)}`,
+    /** Latest aggregate A/B snapshot (derived `abs` table, LWW). */
+    abSnapshot: (agent) => `${STORAGE_KEY_ROOT}/${agent}/ab-snapshot`,
 };
 /**
  * Max bytes a caller-controlled key segment may occupy after URI-encoding.

package/docs/ab.md CHANGED Viewed

@@ -255,9 +255,10 @@ too. This include-all behavior can still apply to `GET /v1/abs` in dev
 when bearer or custom auth keeps `GET /v1/sessions` owner-scoped.
 Session `events.ndjson` is the source of truth for assignment + fold.
-`GET /v1/abs` recomputes aggregates from those logs. For durable
-sample and snapshot export, declare an `abs` table in
-`agent/storage.ts` — same idea as the eval-runs table. See
+`GET /v1/abs` recomputes aggregates from those logs. Any
+`agent/storage.ts` exports samples and snapshots durably: an authored
+`abs` table when the backend has a native shape for it, or the table
+derived over the KV core otherwise. See
 [Storage](./storage.md#eval-and-a-b-tables).
 ## Configure the playground fold window

package/docs/deployment.md CHANGED Viewed

@@ -262,7 +262,7 @@ Slack** connects the workspace with a one-time authorization, and
 **Create Slack app** creates and installs the app, then stores its
 tokens as deployment secrets automatically. Redeploy when prompted so
 the running agent picks them up. See
-[Provision from the dashboard](./guides/slack.md#provision-from-the-dashboard-hosted-deployments)
+[Provision from the dashboard](./guides/slack.md#provision-from-the-dashboard)
 for the walkthrough, including workspace-admin approval.
 If you created the Slack app by hand instead, set its tokens as

package/docs/evals.md CHANGED Viewed

@@ -147,10 +147,12 @@ JUnit XML file for CI, `Artifacts` writes per-case files, and
 the XML for a custom destination). A file or case can add its own
 `reporters` on top of the config list.
-Playground batches live in process memory and disappear when `serve`
-exits. Navigating away and back still works while the process is up.
-To keep batches across restarts, declare an `evals` table in
-`agent/storage.ts`; see [Storage](./storage.md#eval-and-a-b-tables).
+Playground batches survive restarts whenever `agent/storage.ts` exists
+with an `evals` table or a KV core providing `delete` and `list` (the
+table is derived over the core); see
+[Storage](./storage.md#eval-and-a-b-tables). Without storage they live
+in process memory and disappear when `serve` exits — navigating away
+and back still works while the process is up.
 ## Drive and assert with `t`
@@ -360,9 +362,10 @@ agent-sdk serve --dir . --dev
 Playground runs target the live server instead of an ephemeral one.
 Their sessions appear in the session list. One eval batch can run at a
-time. By default those batches are **in-memory only** (capped by
-`maxPlaygroundRuns`); declare an `evals` table in `agent/storage.ts` if
-you need them after a serve restart — see
+time. Batches persist across restarts whenever `agent/storage.ts`
+provides an `evals` table or a KV core with `delete` and `list` (the
+table is derived over the core); without storage they are **in-memory
+only** (capped by `maxPlaygroundRuns`) — see
 [Storage](./storage.md#eval-and-a-b-tables).
 The UI uses the playground eval routes (available without `--dev`):

package/docs/example-agents/benny.md CHANGED Viewed

@@ -101,9 +101,8 @@ For the watched-channel path, configure a dedicated Socket Mode app with:
 - have an App-Level Token with `connections:write`, and
 - be a member of the watched channel.
-Run `agent-sdk slack setup` for the guided app workflow. Generate the project
-manifest with `--channel-posts` when you create a new copy, then validate the
-configured channel prefix with `agent-sdk slack doctor`.
+Run `agent-sdk slack create --dir examples/benny --channel-posts` for a
+dedicated Socket Mode app, then `agent-sdk slack doctor`.
 Missing dedicated-app tokens leave that channel idle. They don't stop the
 account-linked channel.

package/docs/example-agents/oncall.md CHANGED Viewed

@@ -139,14 +139,13 @@ Channel watching is Socket Mode only, so this example uses a dedicated
 app:
 ```bash
-agent-sdk slack init --dir examples/oncall --name "Oncall" --channel-posts
+agent-sdk slack create --dir examples/oncall --name "Oncall" --channel-posts
 agent-sdk slack doctor --prefix ONCALL
 ```
-The generated manifest subscribes to `message.channels` and
-`message.groups` and includes `reactions:write` for the lock-in reaction.
-Install the app, export `ONCALL_SLACK_BOT_TOKEN` and
-`ONCALL_SLACK_APP_TOKEN`, and invite the bot to each watched channel.
+`--channel-posts` prefills channel-watch events (`message.channels` /
+`message.groups`). Invite the bot to each watched channel after the
+wizard finishes.
 `ONCALL_ALERTS_CHANNELS` sets the watch list as comma-separated ids or
 `#names`. It defaults to `#alerts`.

package/docs/guides/human-in-the-loop.md CHANGED Viewed

@@ -92,7 +92,7 @@ export default slackChannel({
 });
 ```
-The Slack app manifest needs interactivity enabled. Cards show redacted,
+Approval cards need interactivity on the Slack app. Cards show redacted,
 truncated arguments because of Block Kit size limits. Execution still
 uses the full validated input, so review sensitive tools in the
 playground when the arguments may exceed the card. Details in the

package/docs/guides/slack.md CHANGED Viewed

@@ -1,15 +1,15 @@
 ---
 title: "Slack"
-description: "Put the agent in Slack over Socket Mode: Add to Slack provisioning, manifests, tokens, doctor, engagement rules, access policy, and approval buttons."
+description: "Put the agent in Slack: Cursor-hosted connection or a dedicated Socket Mode app via the dashboard wizard, plus doctor, engagement rules, access policy, and approval buttons."
 ---
 # Slack agents
-The Slack channel puts your agent in Slack over Socket Mode: no public
-Request URL, streaming replies in threads, tool "thinking" steps,
-suggested prompts, and opt-in approval buttons. Cursor's **Add to
-Slack** provisioning handles the setup in one CLI command or one
-dashboard click; the manual manifest flow remains as a fallback.
+The Slack channel puts your agent in Slack. Two products: the Cursor-hosted
+connection (`cursorAccount: true`), or a dedicated Socket Mode app created
+in the dashboard wizard (`agent-sdk slack create`). Socket Mode has no
+public Request URL. Replies stream in threads, with tool "thinking" steps,
+suggested prompts, and opt-in approval buttons.
 The companion skill is
 [`skills/setup-slack/SKILL.md`](../../skills/setup-slack/SKILL.md).
@@ -99,17 +99,17 @@ export default slackChannel({
 ## Set it up
-Start with Cursor's **Add to Slack** provisioning: Cursor creates and
-installs a dedicated Slack app for the agent and delivers its tokens,
-so nobody visits [api.slack.com](https://api.slack.com/apps) or copies
-an `xoxb-…` / `xapp-…` pair by hand. Use the CLI for local development
-and the dashboard for hosted deployments. Fall back to the
-[manual manifest flow](#manual-setup-fallback) only when provisioning
-reports the feature is not enabled for your account.
+For a dedicated Socket Mode bot, run `agent-sdk slack create`. The CLI
+opens the signed-in Cursor dashboard wizard. Slack consent, bot name,
+and admin-approval wait happen there. Tokens are stored as deployment
+secrets and written to `.env.local`. They are never shown. Do not paste
+a manifest at [api.slack.com](https://api.slack.com/apps). `slack init`
+is removed.
-### Provision with the CLI
+Bots that already have tokens in `.env.local` keep working. Skip the
+wizard unless you want a Cursor-managed app.
-One command runs the whole setup:
+### Provision with the CLI
 ```bash
 agent-sdk slack create --dir .          # dev app (default)
@@ -118,97 +118,47 @@ agent-sdk slack create --dir . --prod   # prod app
 `slack create` needs a signed-in host (`agent-sdk login` or
 `CURSOR_API_KEY`). It scaffolds `agent/channels/slack.ts` when the file
-is missing, connects your Slack workspace through a browser consent
-page when it isn't connected yet (a one-time authorization per user and
-workspace), creates and installs the agent's dedicated Socket Mode app,
+is missing, opens the dashboard wizard, and waits. Finish **Add Slack
+to this agent** in the browser as the same Cursor account. The CLI
 writes `<PREFIX>_SLACK_BOT_TOKEN` and `<PREFIX>_SLACK_APP_TOKEN` into
-`<dir>/.env.local`, and finishes with a `doctor` pass. Then serve and
-smoke it as described [below](#wire-the-env-and-verify); the tokens are
-already in place.
-If the workspace requires admin approval for new apps, `create` prints
-the Slack approval page for a workspace admin. Re-run
-`agent-sdk slack create` after the approval to finish the install and
-mint the tokens.
-Useful companions: `--slack-team T0123ABCD` picks a workspace when
-several are connected, `--icon <https-url-or-file>` sets the app icon,
-`agent-sdk slack destroy` deletes the provisioned app, and
-`agent-sdk slack icon <source>` updates the icon later. A re-run of
-`create` refuses to overwrite manifest edits made by hand in Slack;
-pass `--force` to overwrite them.
-### Provision from the dashboard (hosted deployments)
-For a [Cursor-hosted deployment](../deployment.md#cursor-managed-hosting),
-provision from
-[cursor.com/dashboard](https://cursor.com/dashboard): open **Deployed
-Agents**, select the deployment, switch to the **Details** view, and
-expand the **Slack** row under **Integrations**.
-1. Click **Add to Slack** and approve the authorization in the tab that
-   opens. This is a one-time consent per user and workspace.
-2. Pick the bot name (and the workspace, when several are connected)
-   and click **Create Slack app**. Cursor creates and installs the app,
-   then stores its tokens as deployment secrets; the values are never
-   shown. The **Advanced** disclosure sets the env-var prefix, so the
-   secret names match what your `slackChannel({ envPrefix })` reads.
-3. If the workspace requires admin approval, the row shows **Waiting
-   for admin approval** with an **Approve in Slack** button that opens
-   Slack's pending-request page. After an admin approves, pick
-   **Retry** from the row's menu.
-4. Click **Redeploy** when the banner appears. The running agent keeps
-   its old environment until the next deploy.
-The row's menu also covers later care: rename the app, set its icon,
-rotate its tokens, remove it from Slack, or disconnect the workspace.
-### Manual setup (fallback)
-When Add to Slack is not enabled for your account, create the apps by
-hand. Generate the channel file, the app manifests, and the env
-template:
+`<dir>/.env.local`, then runs `doctor`. Serve and smoke it as described
+[below](#wire-the-env-and-verify).
-```bash
-agent-sdk slack init --dir . --name "My Agent"
-```
+If Slack needs a workspace admin to approve the app, keep the CLI
+running. Managed install does not file the request — open Slack's
+**Request approval** page (the CLI prints the link; the same URL is
+**Send a reminder** after you submit). After an admin approves, click
+**Retry** in the wizard.
-This writes `agent/channels/slack.ts` (with an `envPrefix` derived from
-the directory name), importable app manifests at
-`.agent-serve/slack/manifest.{dev,prod}.json`, and
-`.agent-serve/slack/env.example`. Use `--no-prefix` for the shared
-`SLACK_*` variables on single-agent hosts, `--prefix CUSTOM` to
-override, and `--channel-posts` if you plan to watch channels.
+Useful companions: `--name` / `--icon` / `--channel-posts` prefill the
+wizard. `--slack-team T0123ABCD` picks a workspace when several are
+connected. A second `slack create` for the same agent and env overwrites
+that Slack app. It keeps the Slack app id and replaces the manifest and
+tokens. `agent-sdk slack destroy` deletes the provisioned app.
+`agent-sdk slack icon <source>` updates the icon later.
-#### Create the apps (human, Slack admin)
+### Provision from the dashboard
-This phase needs a human with permission to create Slack apps.
+The same wizard is on [Deployed Agents](https://cursor.com/dashboard).
+Open **Integrations** on an agent and click **Add Slack to this agent**,
+or follow the URL `slack create` printed.
-1. Open [api.slack.com/apps](https://api.slack.com/apps) → **Create New
-   App** → **From a manifest**.
-2. Paste `manifest.dev.json` and create the dev app.
-3. Repeat with `manifest.prod.json`. Dev and prod are separate Slack
-   apps with separate tokens.
+A first-run agent that has no hosted engine yet shows **Not deployed
+yet**. Local `agent-sdk serve` works from `.env.local`. The next
+**Deploy** injects the stored secrets; there is no Slack-only Redeploy.
-#### Install and mint tokens (human)
+If Slack needs admin approval, the wizard waits. Click **Request
+approval** to file the request in Slack (that same page later sends a
+reminder). After an admin approves, click **Retry**.
-For each app: **Install to Workspace** and copy the Bot User OAuth Token
-(`xoxb-…`), then under **Basic Information → App-Level Tokens** create a
-token with scope `connections:write` and copy it (`xapp-…`).
+The app row's menu covers later care: rename, set an icon, rotate
+tokens, remove the app, or disconnect the workspace.
 ### Wire the env and verify
 `agent-sdk slack create` already wrote the tokens to `.env.local`, so
-after provisioning skip straight to `doctor`. After a manual setup,
-export the tokens in the shell that runs `serve`, using the names from
-`env.example`, or put them in the agent directory's `.env.local` —
-`serve`/`dev`/`slack doctor` load that file (real environment variables
-always win over it):
-```bash
-export MY_AGENT_SLACK_BOT_TOKEN=xoxb-…
-export MY_AGENT_SLACK_APP_TOKEN=xapp-…
-```
+after provisioning skip straight to `doctor`. `serve` / `dev` /
+`slack doctor` load that file (real environment variables always win).
 ```bash
 agent-sdk slack doctor --prefix MY_AGENT
@@ -252,15 +202,9 @@ export default slackChannel({
 ```
 Channel watching needs the `message.channels` / `message.groups` events
-on the Slack app (Socket Mode only — not available with
-`cursorAccount: true`). Generate manifests with `slack init --channel-posts`,
-or add the events and re-import. The bot must also be a member of each
-watched channel. Posts that mention the bot stay on the `app_mention`
-path, bot-authored posts never dispatch by default, and deleting a post
-inside the debounce window cancels its dispatch. Watched posts reuse the
-thread-scoped principal, so a later @mention continues the same session.
-Set `engagement.mentions` or `engagement.directMessages` to `false` to
-turn those surfaces off.
+on the Slack app (Socket Mode only; not available with
+`cursorAccount: true`). Pass `--channel-posts` on `slack create`. The
+bot must also be a member of each watched channel.
 Set `includeBotPosts: true` when the posts worth watching come from bots:
 alert feeds, webhook integrations, or other agents posting notes. The
@@ -289,9 +233,8 @@ export default slackChannel({
 });
 ```
-The Slack app manifest must have interactivity enabled. Regenerate with
-`buildSlackManifest({ interactivity: true })` (or edit and re-import) if
-your app predates it. Composing events by hand instead: spread
+Approval cards need interactivity on the Slack app. Recreate with
+`slack create` if clicks do nothing. Composing events by hand: spread
 `buildToolApprovalEvents({ credentials })` into `events` and set
 `interactivity: true` on the channel so Socket Mode routes the clicks.
@@ -331,15 +274,11 @@ Two habits matter most.
 The `slack` subcommands cover setup end to end.
 ```bash
-agent-sdk slack setup                     # guided checklist
-agent-sdk slack create --dir .            # provision via Add to Slack (dev app)
+agent-sdk slack setup                     # two-product chooser
+agent-sdk slack create --dir .            # dashboard wizard (dev app)
 agent-sdk slack create --dir . --prod     # prod app
 agent-sdk slack destroy --dir .           # delete the provisioned app
 agent-sdk slack icon ./icon.png --dir .   # set the provisioned app's icon
-agent-sdk slack init --dir . --name "My Agent"
-agent-sdk slack init --dir . --no-prefix  # shared SLACK_* vars
-agent-sdk slack init --dir . --channel-posts
-agent-sdk slack manifest --env both       # regenerate manifests
 agent-sdk slack doctor --prefix MY_AGENT  # token / connectivity checks
 ```