@cursor/july 0.1.5 → 0.1.6

package/dist/ab.d.ts

@@ -10,9 +10,8 @@
  *
  * Assignments and foldable metrics live in each session's `events.ndjson`
  * (survive serve restart). Optional project defaults in `agent/ab.config.ts`
- * ({@link defineABConfig}) let authors retain the playground fold window and
- * persist samples / aggregate snapshots wherever they like — same idea as
- * eval `persistRuns`.
+ * ({@link defineABConfig}) cap the playground fold window; durable
+ * sample/snapshot export lives on the `defineStorage` `abs` table.
  *
  * ```ts
  * import { defineAB, splitBySessionHash } from "@anysphere/agent-serve/ab";
@@ -30,7 +29,6 @@
  * });
  * ```
  */
-import type { ABSnapshot } from "./internal/ab-snapshot.js";
 import type { SessionEvent, SessionInfo } from "./types.js";
 export type { ABSnapshot } from "./internal/ab-snapshot.js";
 export interface ABVariantMeta {
@@ -170,88 +168,29 @@ export declare function mergeABInstructions(base: string | undefined, abs: Reado
 export declare const AB_DEFAULT_MAX_PLAYGROUND_SESSIONS = 200;
 /** Hard ceiling for {@link ABConfigFile.maxPlaygroundSessions}. */
 export declare const AB_MAX_PLAYGROUND_SESSIONS = 10000;
-/** Default snapshot files kept when {@link ABConfigFile.persistSnapshots} is set. */
-export declare const AB_DEFAULT_RETAIN_SNAPSHOTS = 20;
-/** Hard ceiling for {@link ABConfigFile.retainSnapshots}. */
-export declare const AB_MAX_RETAIN_SNAPSHOTS = 500;
-/** Context passed to A/B persistence hooks. */
-export interface ABPersistContext {
-    /** Absolute agent project root (directory that contains `agent/`). */
-    projectRoot: string;
-}
-/**
- * Durable sink for {@link ABMetricSample} rows (same payload as
- * {@link ABConfig.onSample}). Session `events.ndjson` remains the source of
- * truth for assignment + fold; this is for analytics export.
- */
-export interface ABSamplePersistence {
-    save(sample: ABMetricSample, ctx: ABPersistContext): void | Promise<void>;
-}
-/**
- * Durable store for playground-style aggregate snapshots (`GET /v1/abs`).
- * Without this, aggregates are always recomputed from session logs (nothing
- * is kept after sessions are pruned).
- *
- * **Runtime note:** `serve` currently only calls {@link save} (after each
- * `GET /v1/abs`). {@link load} / {@link delete} are for author tooling or a
- * custom store; they are not wired into the playground hydrate path.
- */
-export interface ABSnapshotPersistence {
-    load(ctx: ABPersistContext): ABSnapshot[] | Promise<ABSnapshot[]>;
-    save(snapshot: ABSnapshot, ctx: ABPersistContext): void | Promise<void>;
-    delete?(snapshotId: string, ctx: ABPersistContext): void | Promise<void>;
-}
 /**
  * Project-wide A/B defaults (`agent/ab.config.ts`).
  *
  * **Assignments and foldable metrics** already persist in each session's
- * `events.ndjson` under `--state-root`. Use this config to:
- * - cap how many sessions the playground / `GET /v1/abs` folds
- * - export samples and/or aggregate snapshots to author-chosen storage
+ * `events.ndjson` under `--state-root`; durable sample/snapshot export
+ * lives on the `defineStorage` `abs` table (`agent/storage.ts`). This
+ * config only caps how many sessions the playground / `GET /v1/abs` folds.
  */
 export interface ABConfigFile {
     /**
      * Optional. Max newest sessions folded into **`GET /v1/abs` / the A/Bs
-     * tab** (and into {@link persistSnapshots} payloads). Does not prune
-     * session logs, change assignment, or limit {@link persistSamples}.
+     * tab**. Does not prune session logs or change assignment.
      *
      * Default {@link AB_DEFAULT_MAX_PLAYGROUND_SESSIONS}; hard-capped at
      * {@link AB_MAX_PLAYGROUND_SESSIONS}.
      */
     maxPlaygroundSessions?: number;
-    /**
-     * Snapshot-file budget when {@link persistSnapshots} is set.
-     * Default {@link AB_DEFAULT_RETAIN_SNAPSHOTS}; hard-capped at
-     * {@link AB_MAX_RETAIN_SNAPSHOTS}.
-     *
-     * When using {@link persistABSnapshotsToDir}, this value controls on-disk
-     * pruning (overriding the helper's `{ retain }` default). Custom stores
-     * should apply the same budget themselves.
-     */
-    retainSnapshots?: number;
-    /**
-     * Optional sink for cumulative metric samples (in addition to each
-     * experiment's {@link ABConfig.onSample}).
-     *
-     * ```ts
-     * persistSamples: persistABSamplesToDir(".agent-serve/ab-samples"),
-     * ```
-     */
-    persistSamples?: ABSamplePersistence;
-    /**
-     * Optional store for aggregate snapshots written when `GET /v1/abs` runs.
-     *
-     * ```ts
-     * persistSnapshots: persistABSnapshotsToDir(".agent-serve/ab-snapshots"),
-     * ```
-     */
-    persistSnapshots?: ABSnapshotPersistence;
 }
 /**
  * Defaults for every experiment under `agent/ab*` (`agent/ab.config.ts`).
  *
- * Session event logs remain the assignment/metrics source of truth; this
- * file controls the playground fold window and optional durable exports.
+ * Session event logs remain the assignment/metrics source of truth;
+ * durable exports go through the `defineStorage` `abs` table.
  */
 export declare function defineABConfig(config: ABConfigFile): ABConfigFile;
 /** Validate {@link ABConfigFile.maxPlaygroundSessions}. */
@@ -261,30 +200,4 @@ export declare function normalizeABMaxPlaygroundSessions(value: unknown): number
  * {@link AB_DEFAULT_MAX_PLAYGROUND_SESSIONS}.
  */
 export declare function resolveABMaxPlaygroundSessions(value: unknown): number;
-/** Validate {@link ABConfigFile.retainSnapshots}. */
-export declare function normalizeABRetainSnapshots(value: unknown): number;
-/**
- * Append-only NDJSON {@link ABSamplePersistence} under `dir` (relative to
- * the agent project root).
- *
- * ```ts
- * // agent/ab.config.ts
- * export default defineABConfig({
- *   persistSamples: persistABSamplesToDir(".agent-serve/ab-samples"),
- * });
- * ```
- */
-export declare function persistABSamplesToDir(dir: string): ABSamplePersistence;
-/**
- * Filesystem {@link ABSnapshotPersistence}: one JSON file per snapshot under
- * `dir`, pruned to `retain` files (default {@link AB_DEFAULT_RETAIN_SNAPSHOTS}).
- *
- * Prefer setting {@link ABConfigFile.retainSnapshots} in `defineABConfig` —
- * that value is applied to this helper's prune budget. Pass `{ retain }` here
- * only when constructing the helper outside `defineABConfig`, or as a default
- * that `retainSnapshots` may override.
- */
-export declare function persistABSnapshotsToDir(dir: string, options?: {
-    retain?: number;
-}): ABSnapshotPersistence;
 //# sourceMappingURL=ab.d.ts.map

package/dist/ab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ab.d.ts","sourceRoot":"","sources":["../src/ab.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ab.d.ts","sourceRoot":"","sources":["../src/ab.ts"],"names":[],"mappings":"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"}

package/dist/ab.js

@@ -10,9 +10,8 @@
  *
  * Assignments and foldable metrics live in each session's `events.ndjson`
  * (survive serve restart). Optional project defaults in `agent/ab.config.ts`
- * ({@link defineABConfig}) let authors retain the playground fold window and
- * persist samples / aggregate snapshots wherever they like — same idea as
- * eval `persistRuns`.
+ * ({@link defineABConfig}) cap the playground fold window; durable
+ * sample/snapshot export lives on the `defineStorage` `abs` table.
  *
  * ```ts
  * import { defineAB, splitBySessionHash } from "@anysphere/agent-serve/ab";
@@ -39,12 +38,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { randomUUID } from "node:crypto";
-import { appendFile, mkdir } from "node:fs/promises";
-import { join } from "node:path";
 import { normalizePositiveInt } from "./internal/bounded-int.js";
 import { brandDefinition } from "./internal/brand.js";
-import { assertNonEmptyDir, deleteFileInDir, listJsonBasenames, readJsonDir, resolveProjectRelativeDir, writeJsonFile, } from "./internal/json-dir-store.js";
 /** Sticky hash of session id → arm (recommended default). */
 export function splitBySessionHash(options) {
     assertHoldout(options === null || options === void 0 ? void 0 : options.holdout);
@@ -208,42 +203,23 @@ export function mergeABInstructions(base, abs, experiments) {
         : `${baseText}\n\n${extras.join("\n\n")}`;
 }
 // ---------------------------------------------------------------------------
-// Project config (`agent/ab.config.ts`) — fold window + optional persistence
+// Project config (`agent/ab.config.ts`) — playground fold window
 // ---------------------------------------------------------------------------
 /** Default sessions folded into `GET /v1/abs` / the A/Bs tab. */
 export const AB_DEFAULT_MAX_PLAYGROUND_SESSIONS = 200;
 /** Hard ceiling for {@link ABConfigFile.maxPlaygroundSessions}. */
 export const AB_MAX_PLAYGROUND_SESSIONS = 10000;
-/** Default snapshot files kept when {@link ABConfigFile.persistSnapshots} is set. */
-export const AB_DEFAULT_RETAIN_SNAPSHOTS = 20;
-/** Hard ceiling for {@link ABConfigFile.retainSnapshots}. */
-export const AB_MAX_RETAIN_SNAPSHOTS = 500;
-/** Lets {@link defineABConfig} push `retainSnapshots` into {@link persistABSnapshotsToDir}. */
-const abSnapshotRetainState = new WeakMap();
 /**
  * Defaults for every experiment under `agent/ab*` (`agent/ab.config.ts`).
  *
- * Session event logs remain the assignment/metrics source of truth; this
- * file controls the playground fold window and optional durable exports.
+ * Session event logs remain the assignment/metrics source of truth;
+ * durable exports go through the `defineStorage` `abs` table.
  */
 export function defineABConfig(config) {
-    var _a, _b;
-    const persistSamples = normalizeSamplePersistence(config.persistSamples);
-    const persistSnapshots = normalizeSnapshotPersistence(config.persistSnapshots);
-    const helperRetain = persistSnapshots !== undefined
-        ? abSnapshotRetainState.get(persistSnapshots)
-        : undefined;
-    let retainSnapshots;
-    if (config.retainSnapshots !== undefined) {
-        retainSnapshots = normalizeABRetainSnapshots(config.retainSnapshots);
-        if (helperRetain !== undefined) {
-            helperRetain.retain = retainSnapshots;
-        }
-    }
-    else if (persistSnapshots !== undefined) {
-        retainSnapshots = (_a = helperRetain === null || helperRetain === void 0 ? void 0 : helperRetain.retain) !== null && _a !== void 0 ? _a : normalizeABRetainSnapshots(AB_DEFAULT_RETAIN_SNAPSHOTS);
-    }
-    return Object.assign(Object.assign(Object.assign({ maxPlaygroundSessions: normalizeABMaxPlaygroundSessions((_b = config.maxPlaygroundSessions) !== null && _b !== void 0 ? _b : AB_DEFAULT_MAX_PLAYGROUND_SESSIONS) }, (retainSnapshots === undefined ? {} : { retainSnapshots })), (persistSamples === undefined ? {} : { persistSamples })), (persistSnapshots === undefined ? {} : { persistSnapshots }));
+    var _a;
+    return {
+        maxPlaygroundSessions: normalizeABMaxPlaygroundSessions((_a = config.maxPlaygroundSessions) !== null && _a !== void 0 ? _a : AB_DEFAULT_MAX_PLAYGROUND_SESSIONS),
+    };
 }
 /** Validate {@link ABConfigFile.maxPlaygroundSessions}. */
 export function normalizeABMaxPlaygroundSessions(value) {
@@ -267,120 +243,3 @@ export function resolveABMaxPlaygroundSessions(value) {
         return AB_DEFAULT_MAX_PLAYGROUND_SESSIONS;
     }
 }
-/** Validate {@link ABConfigFile.retainSnapshots}. */
-export function normalizeABRetainSnapshots(value) {
-    return normalizePositiveInt(value, {
-        label: "ab.config.ts: retainSnapshots",
-        max: AB_MAX_RETAIN_SNAPSHOTS,
-    });
-}
-function normalizeSamplePersistence(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== "object" ||
-        value === null ||
-        typeof value.save !== "function") {
-        throw new Error("ab.config.ts: persistSamples must define save(sample, ctx)");
-    }
-    return value;
-}
-function normalizeSnapshotPersistence(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== "object" ||
-        value === null ||
-        typeof value.load !== "function" ||
-        typeof value.save !== "function") {
-        throw new Error("ab.config.ts: persistSnapshots must define load(ctx) and save(snapshot, ctx)");
-    }
-    if (value.delete !== undefined && typeof value.delete !== "function") {
-        throw new Error("ab.config.ts: persistSnapshots.delete must be a function");
-    }
-    return value;
-}
-/**
- * Append-only NDJSON {@link ABSamplePersistence} under `dir` (relative to
- * the agent project root).
- *
- * ```ts
- * // agent/ab.config.ts
- * export default defineABConfig({
- *   persistSamples: persistABSamplesToDir(".agent-serve/ab-samples"),
- * });
- * ```
- */
-export function persistABSamplesToDir(dir) {
-    const relativeDir = assertNonEmptyDir(dir, "persistABSamplesToDir");
-    const resolveDir = (projectRoot) => resolveProjectRelativeDir({ dir: relativeDir, projectRoot });
-    return {
-        save(sample, ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                const root = resolveDir(ctx.projectRoot);
-                yield mkdir(root, { recursive: true });
-                yield appendFile(join(root, "samples.ndjson"), `${JSON.stringify(sample)}\n`, "utf8");
-            });
-        },
-    };
-}
-/**
- * Filesystem {@link ABSnapshotPersistence}: one JSON file per snapshot under
- * `dir`, pruned to `retain` files (default {@link AB_DEFAULT_RETAIN_SNAPSHOTS}).
- *
- * Prefer setting {@link ABConfigFile.retainSnapshots} in `defineABConfig` —
- * that value is applied to this helper's prune budget. Pass `{ retain }` here
- * only when constructing the helper outside `defineABConfig`, or as a default
- * that `retainSnapshots` may override.
- */
-export function persistABSnapshotsToDir(dir, options) {
-    var _a;
-    const relativeDir = assertNonEmptyDir(dir, "persistABSnapshotsToDir");
-    const retainState = {
-        retain: normalizeABRetainSnapshots((_a = options === null || options === void 0 ? void 0 : options.retain) !== null && _a !== void 0 ? _a : AB_DEFAULT_RETAIN_SNAPSHOTS),
-    };
-    const resolveDir = (projectRoot) => resolveProjectRelativeDir({ dir: relativeDir, projectRoot });
-    let saveChain = Promise.resolve();
-    const persist = {
-        load(ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                return readJsonDir(resolveDir(ctx.projectRoot), {
-                    sortBasenames: "desc",
-                });
-            });
-        },
-        save(snapshot, ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                const run = () => __awaiter(this, void 0, void 0, function* () {
-                    var _a;
-                    var _b;
-                    const root = resolveDir(ctx.projectRoot);
-                    const snapshotId = (_b = (_a = snapshot.config) === null || _a === void 0 ? void 0 : _a.snapshotId) !== null && _b !== void 0 ? _b : `absnap_${randomUUID().replace(/-/g, "")}`;
-                    const toWrite = Object.assign(Object.assign({}, snapshot), { config: Object.assign(Object.assign({}, snapshot.config), { snapshotId }) });
-                    yield writeJsonFile({
-                        root,
-                        fileName: `${snapshotId}.json`,
-                        value: toWrite,
-                    });
-                    const names = (yield listJsonBasenames(root)).sort().reverse();
-                    for (const stale of names.slice(retainState.retain)) {
-                        yield deleteFileInDir({ root, fileName: stale });
-                    }
-                });
-                const next = saveChain.then(run, run);
-                saveChain = next.then(() => undefined, () => undefined);
-                yield next;
-            });
-        },
-        delete(snapshotId, ctx) {
-            return __awaiter(this, void 0, void 0, function* () {
-                yield deleteFileInDir({
-                    root: resolveDir(ctx.projectRoot),
-                    fileName: `${snapshotId}.json`,
-                });
-            });
-        },
-    };
-    abSnapshotRetainState.set(persist, retainState);
-    return persist;
-}

package/dist/bin/agent-serve.js

@@ -67,7 +67,7 @@ Usage:
   ${CLI} init        [dir] [--json]
   ${CLI} eval        [--dir <path>] [evalId...] [--list] [--json]
                           [--tag <tag>]... [--verbose] [--timeout-ms <n>]
-                          [--no-stream] [--url <baseUrl> | --prod] [--slug <slug>]
+                          [--no-stream] [--local | --url <baseUrl>] [--slug <slug>]
                           [--team <id>]
   ${CLI} info        [--dir <path>] [--json]
   ${CLI} validate    [--dir <path>]
@@ -132,9 +132,11 @@ Commands:
               machine-readable and never blocks on login. No directory:
               print the setup guide.
   eval        Run filesystem evals under evals/**/*.eval.ts (streams on a TTY).
-              Pass evalId args to select: one datapoint (weather/nyc), a whole
-              file (weather → all cases in that file), several of either, or
-              omit to run all.
+              Runs against the team's hosted deployment by default (slug from
+              --slug or the directory name); pass --local for an ephemeral
+              local server, or --url for a running one. Pass evalId args to
+              select: one datapoint (weather/nyc), a whole file (weather →
+              all cases in that file), several of either, or omit to run all.
   info        Print the discovered agent surface (tools, skills, channels, ...).
   validate    Check the project(s) and exit non-zero on error diagnostics.
   login       Sign the host in to Cursor: browser sign-in mints a named,
@@ -169,7 +171,7 @@ Agent loop:
   ${CLI} validate --dir .
   ${CLI} info --dir . --json
   ${CLI} run --dir . --message "..."
-  ${CLI} eval --dir .
+  ${CLI} eval --local --dir .
   ${CLI} dev .
 
 Options:
@@ -208,7 +210,10 @@ Options:
   --prod             chat/resume/run/call/eval/logs/sessions/session/playground:
                      use the team's hosted deployment. Slug from --slug or the
                      --dir basename. Mutually exclusive with --url. Requires
-                     \`${CLI} login\`.
+                     \`${CLI} login\`. (eval already defaults to the
+                     deployment; there --prod is just being explicit.)
+  --local            eval: run against an ephemeral local server instead of
+                     the hosted deployment. Mutually exclusive with --url.
   --once             logs: print current progress / log buffer once and exit
                      (default is to follow).
   --print            playground: print the URL only; do not open a browser.
@@ -321,6 +326,7 @@ function main(argv) {
                 "no-docs": { type: "boolean", default: false },
                 url: { type: "string" },
                 prod: { type: "boolean", default: false },
+                local: { type: "boolean", default: false },
                 message: { type: "string", multiple: true },
                 input: { type: "string" },
                 "messages-file": { type: "string" },
@@ -553,6 +559,7 @@ function main(argv) {
                     tags: values.tag,
                     url: values.url,
                     prod: values.prod,
+                    local: values.local,
                     team: values.team,
                     apiKey: values["api-key"],
                     slug: values.slug,
@@ -863,6 +870,7 @@ function axFromOptions(partial) {
         toolInput: partial.toolInput,
         url: partial.url,
         prod: partial.prod,
+        local: partial.local,
         team: partial.team,
         apiKey: partial.apiKey,
         fetchImpl: partial.fetchImpl,

package/dist/docs/404.html

@@ -9,14 +9,14 @@
     <link rel="preload stylesheet" href="/docs/assets/style.Bj-IXa5W.css" as="style">
     <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
     
-    <script type="module" src="/docs/assets/app.DabPG-io.js"></script>
+    <script type="module" src="/docs/assets/app.DMboGKUD.js"></script>
     <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
     <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
   </head>
   <body>
     <div id="app"></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"ab.md\":\"BMCZ6Hd7\",\"building-with-agents.md\":\"CJCtZCyi\",\"concepts.md\":\"Cfb9b-k1\",\"deployment.md\":\"DTKwE15Z\",\"evals.md\":\"DAgEc_hL\",\"guides_agent-to-agent.md\":\"Bpzgq2Pq\",\"guides_cloud-runtime.md\":\"gVzabdQL\",\"guides_github.md\":\"DOOCpqsW\",\"guides_human-in-the-loop.md\":\"DlUqsp1S\",\"guides_slack.md\":\"CCwqHvSV\",\"guides_webhooks.md\":\"B1EswtUu\",\"hillclimbing.md\":\"DHNast08\",\"index.md\":\"Cylk70gg\",\"quickstart.md\":\"BU6Iwi_9\",\"reference_agent-config.md\":\"DrW2JUM8\",\"reference_channels.md\":\"DdmiKgqf\",\"reference_cli.md\":\"Bv6pOxcF\",\"reference_connections.md\":\"zaEYCLHT\",\"reference_hooks.md\":\"DyLVfE1O\",\"reference_http-api.md\":\"Dx_nmDG6\",\"reference_instructions.md\":\"CgoV-YEb\",\"reference_playground.md\":\"CPZhfYaO\",\"reference_project-layout.md\":\"Bd_CKtNS\",\"reference_schedules.md\":\"w_F2mXB6\",\"reference_sessions.md\":\"DdjWabnN\",\"reference_skills.md\":\"B_jHN7JL\",\"reference_subagents.md\":\"zWAMNfi1\",\"reference_tools.md\":\"CqgJroI0\",\"scaffolding-agents.md\":\"C3pTrmoE\",\"storage.md\":\"CVnInNiN\",\"troubleshooting.md\":\"DkovjS7h\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"agentkit\",\"description\":\"Filesystem-first framework for building and serving Cursor agents.\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Guides\",\"link\":\"/guides/webhooks\"},{\"text\":\"Reference\",\"link\":\"/reference/project-layout\"}],\"search\":{\"provider\":\"local\"},\"outline\":{\"level\":[2,3]},\"sidebar\":[{\"text\":\"Getting started\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Scaffold an agent with Cursor\",\"link\":\"/scaffolding-agents\"},{\"text\":\"Concepts\",\"link\":\"/concepts\"}]},{\"text\":\"Improving agents\",\"items\":[{\"text\":\"Building agents with agents\",\"link\":\"/building-with-agents\"},{\"text\":\"Evals\",\"link\":\"/evals\"},{\"text\":\"Live A/B metrics\",\"link\":\"/ab\"},{\"text\":\"Storage\",\"link\":\"/storage\"},{\"text\":\"Hillclimbing\",\"link\":\"/hillclimbing\"}]},{\"text\":\"Guides\",\"items\":[{\"text\":\"Webhooks & custom channels\",\"link\":\"/guides/webhooks\"},{\"text\":\"GitHub\",\"link\":\"/guides/github\"},{\"text\":\"Slack\",\"link\":\"/guides/slack\"},{\"text\":\"Human-in-the-loop approvals\",\"link\":\"/guides/human-in-the-loop\"},{\"text\":\"Agent-to-agent\",\"link\":\"/guides/agent-to-agent\"},{\"text\":\"Cloud runtime\",\"link\":\"/guides/cloud-runtime\"}]},{\"text\":\"Operating\",\"items\":[{\"text\":\"Deployment\",\"link\":\"/deployment\"},{\"text\":\"Fix common problems\",\"link\":\"/troubleshooting\"}]},{\"text\":\"Reference\",\"collapsed\":false,\"items\":[{\"text\":\"Project layout\",\"link\":\"/reference/project-layout\"},{\"text\":\"Agent config\",\"link\":\"/reference/agent-config\"},{\"text\":\"Instructions\",\"link\":\"/reference/instructions\"},{\"text\":\"Tools\",\"link\":\"/reference/tools\"},{\"text\":\"Skills\",\"link\":\"/reference/skills\"},{\"text\":\"MCP Connections\",\"link\":\"/reference/connections\"},{\"text\":\"Subagents\",\"link\":\"/reference/subagents\"},{\"text\":\"Channels\",\"link\":\"/reference/channels\"},{\"text\":\"Schedules & reminders\",\"link\":\"/reference/schedules\"},{\"text\":\"Hooks\",\"link\":\"/reference/hooks\"},{\"text\":\"Sessions & streaming\",\"link\":\"/reference/sessions\"},{\"text\":\"Playground\",\"link\":\"/reference/playground\"},{\"text\":\"CLI\",\"link\":\"/reference/cli\"},{\"text\":\"HTTP API\",\"link\":\"/reference/http-api\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"ab.md\":\"BMCZ6Hd7\",\"building-with-agents.md\":\"CJCtZCyi\",\"concepts.md\":\"Cfb9b-k1\",\"deployment.md\":\"BtfEsc9S\",\"evals.md\":\"DAgEc_hL\",\"example-agents_approval-buddy.md\":\"8R5phXb5\",\"example-agents_benny.md\":\"B0gjhI-p\",\"example-agents_bugbot.md\":\"DelIdhxB\",\"example-agents_codebase-wiki.md\":\"DC6sgwn0\",\"example-agents_codeowners-review.md\":\"Ku_tG2RY\",\"example-agents_concierge.md\":\"4rQTSMXt\",\"example-agents_fsd.md\":\"CzgUrDfi\",\"example-agents_index.md\":\"CRqJlnIf\",\"example-agents_knowledge-base.md\":\"BPJiVueF\",\"example-agents_security-reviewer.md\":\"D2rtwDTO\",\"example-agents_slack-agent.md\":\"buLbgvBf\",\"example-agents_weather-agent.md\":\"C9Qv-W0o\",\"guides_agent-to-agent.md\":\"Bpzgq2Pq\",\"guides_cloud-runtime.md\":\"gVzabdQL\",\"guides_github.md\":\"DOOCpqsW\",\"guides_human-in-the-loop.md\":\"DlUqsp1S\",\"guides_slack.md\":\"CCwqHvSV\",\"guides_webhooks.md\":\"B1EswtUu\",\"hillclimbing.md\":\"DHNast08\",\"index.md\":\"COiu-1jL\",\"quickstart.md\":\"BU6Iwi_9\",\"reference_agent-config.md\":\"DrW2JUM8\",\"reference_channels.md\":\"DdmiKgqf\",\"reference_cli.md\":\"D189RBCH\",\"reference_connections.md\":\"zaEYCLHT\",\"reference_hooks.md\":\"DyLVfE1O\",\"reference_http-api.md\":\"Dx_nmDG6\",\"reference_instructions.md\":\"CgoV-YEb\",\"reference_playground.md\":\"CPZhfYaO\",\"reference_project-layout.md\":\"Bd_CKtNS\",\"reference_schedules.md\":\"w_F2mXB6\",\"reference_sessions.md\":\"DdjWabnN\",\"reference_skills.md\":\"B_jHN7JL\",\"reference_subagents.md\":\"zWAMNfi1\",\"reference_tools.md\":\"CqgJroI0\",\"scaffolding-agents.md\":\"C3pTrmoE\",\"storage.md\":\"CVnInNiN\",\"troubleshooting.md\":\"DkovjS7h\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"agentkit\",\"description\":\"Filesystem-first framework for building and serving Cursor agents.\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Guides\",\"link\":\"/guides/webhooks\"},{\"text\":\"Examples\",\"link\":\"/example-agents/\"},{\"text\":\"Reference\",\"link\":\"/reference/project-layout\"}],\"search\":{\"provider\":\"local\"},\"outline\":{\"level\":[2,3]},\"sidebar\":[{\"text\":\"Getting started\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"Quickstart\",\"link\":\"/quickstart\"},{\"text\":\"Scaffold an agent with Cursor\",\"link\":\"/scaffolding-agents\"},{\"text\":\"Concepts\",\"link\":\"/concepts\"}]},{\"text\":\"Improving agents\",\"items\":[{\"text\":\"Building agents with agents\",\"link\":\"/building-with-agents\"},{\"text\":\"Evals\",\"link\":\"/evals\"},{\"text\":\"Live A/B metrics\",\"link\":\"/ab\"},{\"text\":\"Storage\",\"link\":\"/storage\"},{\"text\":\"Hillclimbing\",\"link\":\"/hillclimbing\"}]},{\"text\":\"Guides\",\"items\":[{\"text\":\"Webhooks & custom channels\",\"link\":\"/guides/webhooks\"},{\"text\":\"GitHub\",\"link\":\"/guides/github\"},{\"text\":\"Slack\",\"link\":\"/guides/slack\"},{\"text\":\"Human-in-the-loop approvals\",\"link\":\"/guides/human-in-the-loop\"},{\"text\":\"Agent-to-agent\",\"link\":\"/guides/agent-to-agent\"},{\"text\":\"Cloud runtime\",\"link\":\"/guides/cloud-runtime\"}]},{\"text\":\"Example agents\",\"items\":[{\"text\":\"Choose an example\",\"link\":\"/example-agents/\"},{\"text\":\"Weather agent\",\"link\":\"/example-agents/weather-agent\"},{\"text\":\"Slack agent\",\"link\":\"/example-agents/slack-agent\"},{\"text\":\"Concierge\",\"link\":\"/example-agents/concierge\"},{\"text\":\"Playbook router\",\"link\":\"/example-agents/benny\"},{\"text\":\"PR evidence reviewer\",\"link\":\"/example-agents/bugbot\"},{\"text\":\"Approval Buddy\",\"link\":\"/example-agents/approval-buddy\"},{\"text\":\"Security Reviewer\",\"link\":\"/example-agents/security-reviewer\"},{\"text\":\"Remote PR coordinator\",\"link\":\"/example-agents/fsd\"},{\"text\":\"Knowledge base\",\"link\":\"/example-agents/knowledge-base\"},{\"text\":\"Codebase wiki\",\"link\":\"/example-agents/codebase-wiki\"},{\"text\":\"Codeowners review\",\"link\":\"/example-agents/codeowners-review\"}]},{\"text\":\"Operating\",\"items\":[{\"text\":\"Deployment\",\"link\":\"/deployment\"},{\"text\":\"Fix common problems\",\"link\":\"/troubleshooting\"}]},{\"text\":\"Reference\",\"collapsed\":false,\"items\":[{\"text\":\"Project layout\",\"link\":\"/reference/project-layout\"},{\"text\":\"Agent config\",\"link\":\"/reference/agent-config\"},{\"text\":\"Instructions\",\"link\":\"/reference/instructions\"},{\"text\":\"Tools\",\"link\":\"/reference/tools\"},{\"text\":\"Skills\",\"link\":\"/reference/skills\"},{\"text\":\"MCP Connections\",\"link\":\"/reference/connections\"},{\"text\":\"Subagents\",\"link\":\"/reference/subagents\"},{\"text\":\"Channels\",\"link\":\"/reference/channels\"},{\"text\":\"Schedules & reminders\",\"link\":\"/reference/schedules\"},{\"text\":\"Hooks\",\"link\":\"/reference/hooks\"},{\"text\":\"Sessions & streaming\",\"link\":\"/reference/sessions\"},{\"text\":\"Playground\",\"link\":\"/reference/playground\"},{\"text\":\"CLI\",\"link\":\"/reference/cli\"},{\"text\":\"HTTP API\",\"link\":\"/reference/http-api\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
     
   </body>
 </html>