@cursor/july 0.1.107 → 0.1.109

package/src/types.ts

@@ -10,7 +10,6 @@
 
 import type { InteractionUpdate, SDKCustomTool, ToolName } from "@cursor/sdk";
 import type { z } from "zod";
-import type { ABConfigFile } from "./ab.js";
 import type { FileSystem } from "./filesystem.js";
 import type {
   ContinuationClaim,
@@ -55,7 +54,6 @@ export type DefinitionKind =
   | "reminder"
   | "hook"
   | "eval"
-  | "ab"
   | "storage"
   | "artifacts"
   | "otel"
@@ -1202,8 +1200,8 @@ export type DisabledConnectionDefinition =
 /**
  * `export default disable()` / `disableSkill()` / `disableHook()` /
  * `disableChannel()` / `disableSchedule()` / `disableSubagent()` /
- * `disableInstructions()` / `disableAB()` / `disableArtifacts()` in a
- * directory mount removes that contribution from the matching overlay slot.
+ * `disableInstructions()` / `disableArtifacts()` in a directory mount
+ * removes that contribution from the matching overlay slot.
  */
 export type DisabledDefinition = BrandedDefinition<"disabled">;
 
@@ -1232,8 +1230,6 @@ export interface DiscoveredExtension {
   instructions: boolean;
   /** Workspace seed paths the mount contributed. */
   seedFiles: string[];
-  /** Composed A/B experiment names (`<ns>__<name>`). */
-  abs: string[];
   /** Composed artifact kind names (`<ns>__<kind>`). */
   artifactKinds: string[];
 }
@@ -1615,15 +1611,6 @@ export interface PendingAuth {
 
 export type SessionEventPayload =
   | { type: "session.started"; data: { channelId: string; dryRun?: boolean } }
-  | {
-      /**
-       * Sticky A/B enrollment for one experiment (`defineAB` under `agent/ab`).
-       * Appended at session creation (before the first turn). `variant` is a
-       * key of the experiment's `variants`, or `null` for sticky skip.
-       */
-      type: "ab.assigned";
-      data: { experiment: string; variant: string | null };
-    }
   | {
       /** Cursor SDK agent id is known (cloud: `bc-…`; local: session id). */
       type: "agent.bound";
@@ -1778,7 +1765,14 @@ export type SessionEventPayload =
       type: "turn.bound";
       data: { requestId: string };
     }
-  | { type: "turn.failed"; data: { message: string } }
+  | {
+      type: "turn.failed";
+      data: {
+        message: string;
+        /** Machine-readable terminal status. Omitted on legacy stored events. */
+        status?: "error" | "cancelled";
+      };
+    }
   | {
       /**
        * A Slack follow-up queued mid-turn reached the running agent: the
@@ -1806,8 +1800,8 @@ export interface TurnUsage {
 
 /**
  * Dollar cost of one turn's token usage (one agent loop pass).
- * Recorded on `turn.completed` events so traces, the playground, A/B
- * metrics, and the CLI can aggregate spend. Computed by
+ * Recorded on `turn.completed` events so traces, the playground, and the
+ * CLI can aggregate spend. Computed by
  * `POST /v1/models/estimate-cost` — billed usage events when available
  * (credits, discounts, CTF), otherwise live catalog pricing.
  */
@@ -1834,8 +1828,7 @@ export type SessionMode = "chat" | "task";
 
 /**
  * Why the session exists. `"eval"` is regression traffic (`defineEval` /
- * `agent-sdk eval` / playground Evals) and is excluded from live A/B
- * enrollment. Default `"live"`.
+ * `agent-sdk eval` / playground Evals). Default `"live"`.
  */
 export type SessionPurpose = "live" | "eval";
 
@@ -1852,12 +1845,6 @@ export interface SessionInfo {
   asOf?: string;
   auth: AuthContext | null;
   title?: string;
-  /**
-   * Sticky A/B arms for this session (`defineAB`): experiment name → variant
-   * key, or `null` for sticky skip. Present after enrollment at session
-   * create (live traffic only). Tools/hooks/harness overlays read this.
-   */
-  abs?: Readonly<Record<string, string | null>>;
   /**
    * Channel-local continuation key when the session is addressable for
    * follow-ups / reminders. Null when the session is not re-keyable.
@@ -1878,20 +1865,14 @@ export interface SessionRecord {
   channelId: string;
   mode: SessionMode;
   /**
-   * `"eval"` for harness sessions — skipped by {@link defineAB} enrollment.
-   * Older records omit this (treated as `"live"`).
+   * `"eval"` for harness sessions. Older records omit this (treated as
+   * `"live"`).
    */
   purpose?: SessionPurpose;
   /** Frozen at create from {@link SendMessageOptions.dryRun}. */
   dryRun?: boolean;
   /** Frozen at create from {@link SendMessageOptions.asOf}. */
   asOf?: string;
-  /**
-   * Denormalized sticky A/B arms (mirrors durable `ab.assigned` events) so
-   * the agent loop / tools can read arms without re-folding the log. Source
-   * of truth for stickiness remains the event stream.
-   */
-  abs?: Record<string, string | null>;
   /** Channel-local continuation key; null when the session is not addressable. */
   continuationKey: string | null;
   /**
@@ -1953,6 +1934,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;
@@ -2023,7 +2008,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>;
@@ -2069,8 +2057,8 @@ export interface SendMessageOptions {
   /** Session display title (applied when creating a new session). */
   title?: string;
   /**
-   * Session purpose at create time. `"eval"` skips sticky A/B enrollment
-   * (`defineAB`) so regression runs do not mix into live metrics.
+   * Session purpose at create time. `"eval"` marks regression traffic so
+   * hooks, `defineResult`, and telemetry can tell it from live sessions.
    */
   purpose?: SessionPurpose;
   /**
@@ -2384,7 +2372,14 @@ export interface ReceiveInput {
   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;
@@ -2401,6 +2396,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<
@@ -2548,6 +2548,14 @@ export interface ChannelMeta {
    * `deploymentEventTypes`.
    */
   factoryEventTypes?: readonly string[];
+  /**
+   * For Slack packs: the Events API event types this channel dispatches on
+   * (`app_mention`, `message`), derived from `engagement`. Extracted into
+   * the deploy manifest as `eventTypes` so hosted v2 fanout subscribes to
+   * exactly these. Local Socket Mode ignores it (the socket delivers
+   * whatever the app manifest subscribed to).
+   */
+  slackEventTypes?: readonly string[];
   /**
    * For Slack packs with the opt-in channel watch: the allowlisted channels
    * (ids or `#names`) this channel dispatches on without a mention. Surfaced
@@ -2711,6 +2719,8 @@ export type ArtifactsDefinition = ArtifactsConfig &
  */
 export interface ResultContext {
   session: SessionInfo;
+  /** Durable channel state captured for this turn. */
+  channelState: JsonValue;
   host: HostContext;
   artifacts: ArtifactsApi;
   stateRoot: string;
@@ -3198,15 +3208,6 @@ export interface DiscoveredHook {
   definition: HookDefinition;
 }
 
-/** Live A/B metrics experiment (`agent/ab.ts` or `agent/ab/<name>.ts`). */
-export interface DiscoveredAB {
-  name: string;
-  /** File stem the experiment was loaded from (`ab` or a path under `ab/`). */
-  source?: string;
-  /** Branded `defineAB({ ... })` config (see `@cursor/july/ab`). */
-  definition: BrandedDefinition<"ab">;
-}
-
 export interface SeedFile {
   /** Path inside the session workspace. */
   relativePath: string;
@@ -3287,10 +3288,6 @@ export interface AgentProject {
   /** Named reminder handlers from `agent/reminders/*` (optional / additive). */
   reminders?: DiscoveredReminder[];
   hooks: DiscoveredHook[];
-  /** Live A/B metric experiments (`defineAB`). */
-  abs: DiscoveredAB[];
-  /** Optional `agent/ab.config.ts` (`defineABConfig`). */
-  abConfig?: ABConfigFile;
   /** Optional `agent/storage.ts` (`defineStorage`). */
   storage?: StorageDefinition;
   /** Optional `agent/artifacts.ts` (`defineArtifacts`). */
@@ -3387,6 +3384,8 @@ export interface AgentProjectInfo {
     deploymentEventTypes?: readonly string[];
     /** Change Monitor checkpoint or Factory issue event types the channel dispatches on, when declared. */
     factoryEventTypes?: readonly string[];
+    /** Slack Events API event types the channel dispatches on, when declared. */
+    slackEventTypes?: readonly string[];
     /** Slack channels watched for posts (opt-in channel watch), when declared. */
     slackChannelPosts?: readonly string[];
   }>;
@@ -3394,14 +3393,6 @@ export interface AgentProjectInfo {
   /** 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[];
-  /** Playground fold / durable-sink meta from `agent/ab.config.ts`. */
-  abConfig?: {
-    maxPlaygroundSessions?: number;
-    durableSamples: boolean;
-    durableSnapshots: boolean;
-  };
   /** Project storage sink from `agent/storage.ts`, when authored. */
   storage?: { name?: string };
   otel?: { serviceName?: string; enabled: true };
@@ -3542,8 +3533,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`. */
@@ -3628,7 +3622,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[];

package/templates/demo/README.md

@@ -7,19 +7,22 @@ walkthrough and comments the result.
 npx @cursor/july init ./my-demo --template demo
 ```
 
+`init` asks which repos to watch. Skip the prompt with
+`--var repos=owner/repo`.
+
 ## Run
 
+Connect GitHub in Cursor for those repos. Then sign the host in:
+
 ```bash
 agent-sdk login
 agent-sdk dev
 ```
 
-In the playground, run `/queue/pr` with a PR URL or `owner/repo#N`.
-Turns are sandboxed with `read` and `grep` only.
-
-GitHub: label `demo` or comment `/demo` on a host that terminates
-webhooks (`GITHUB_WEBHOOK_SECRET`). The host needs `GITHUB_TOKEN` or
-`gh auth` to read the PR and comment.
+In the playground, run `/queue/pr` with a PR URL or `owner/repo#N` from
+a watched repo. On GitHub, label a PR `demo` or comment `/demo`. Events
+and API calls use your Cursor GitHub connection. Turns are sandboxed
+with `read` and `grep` only.
 
 ```text
 POST /<slug>/v1/channels/queue/pr
@@ -29,5 +32,6 @@ POST /<slug>/v1/channels/queue/pr
 
 ## Files to edit
 
+- `agent/lib/repos.ts`: watched repos
 - `agent/instructions.md`: how to record
 - `evals/demo.eval.ts`: smoke case

package/templates/demo/agent/channels/github.ts

@@ -6,6 +6,7 @@ import {
   parseGitHubPrRef,
 } from "@cursor/july/channels/github";
 import { startDemo } from "../lib/collect.js";
+import { REPOS } from "../lib/repos.js";
 
 let send: SendMessageFn | undefined;
 
@@ -21,6 +22,7 @@ function wake(url: string, github: GitHubHandle) {
 export default githubChannel({
   botName: "demo-agent",
   webhookEvents: ["pull_request", "issue_comment"],
+  cursorAccount: { repos: REPOS },
   deliverReplies: false,
   onStart: async (args: ChannelStartArgs) => {
     send = args.send;

package/templates/demo/agent/channels/queue.ts

@@ -2,6 +2,7 @@ import { defineChannel, POST } from "@cursor/july/channels";
 import { parseGitHubPrRef } from "@cursor/july/channels/github";
 import { z } from "zod";
 import { startDemo } from "../lib/collect.js";
+import { REPOS, watches } from "../lib/repos.js";
 
 export default defineChannel({
   routes: [
@@ -12,9 +13,12 @@ export default defineChannel({
       }),
       handler: async (_req, { send, host, body }) => {
         const ref = parseGitHubPrRef(body.pr);
-        if (ref === undefined) {
+        if (ref === undefined || !watches(`${ref.owner}/${ref.repo}`)) {
           return Response.json(
-            { ok: false, error: "need a PR URL or owner/repo#N" },
+            {
+              ok: false,
+              error: `need a PR URL or owner/repo#N in ${REPOS.join(", ")}`,
+            },
             { status: 400 }
           );
         }

package/templates/demo/agent/lib/repos.ts

@@ -0,0 +1,5 @@
+export const REPOS: readonly string[] = ["owner/repo"];
+
+export function watches(fullName: string): boolean {
+  return REPOS.some((repo) => repo.toLowerCase() === fullName.toLowerCase());
+}

package/templates/demo/init.json

@@ -0,0 +1,25 @@
+{
+  "questions": [
+    {
+      "id": "repos",
+      "prompt": "Which GitHub repos should this agent record walkthroughs for?",
+      "hint": "Comma-separated owner/repo. One GitHub owner.",
+      "placeholder": "acme/api, acme/web",
+      "parse": "owner-repo-list"
+    }
+  ],
+  "replace": [
+    {
+      "file": "agent/lib/repos.ts",
+      "find": "[\"owner/repo\"]",
+      "answer": "repos",
+      "as": "json-array"
+    },
+    {
+      "file": "README.md",
+      "find": "owner/repo",
+      "answer": "repos",
+      "as": "first"
+    }
+  ]
+}

package/dist/ab.d.ts

@@ -1,209 +0,0 @@
-/**
- * Live A/B metrics plug-in for agent-serve.
- *
- * Author `agent/ab.ts` (or `agent/ab/<name>.ts`) with {@link defineAB}. At
- * session creation the engine runs {@link ABConfig.split} and appends durable
- * `ab.assigned` events; arms are exposed on {@link SessionInfo.abs} for the
- * agent loop (tools / optional per-variant `instructions`). {@link ABCollector}
- * folds the event stream into metrics and calls {@link ABConfig.onSample}.
- * There is no `agent-sdk ab` test runner.
- *
- * Assignments and foldable metrics live in each session's `events.ndjson`
- * (survive serve restart). Optional project defaults in `agent/ab.config.ts`
- * ({@link defineABConfig}) cap the playground fold window; durable
- * sample/snapshot export lives on the `defineStorage` `abs` table.
- *
- * ```ts
- * import { defineAB, splitBySessionHash } from "@cursor/july/ab";
- *
- * export default defineAB({
- *   name: "concise-instructions",
- *   variants: {
- *     control: { label: "Baseline" },
- *     treatment: { label: "Shorter" },
- *   },
- *   split: splitBySessionHash({ holdout: 0.1 }),
- *   onSample(sample) {
- *     console.log(sample.variant, sample.metrics);
- *   },
- * });
- * ```
- */
-import type { SessionEvent, SessionInfo } from "./types.js";
-export type { ABSnapshot } from "./internal/ab-snapshot.js";
-export interface ABVariantMeta {
-    label?: string;
-    description?: string;
-    /**
-     * Optional prompt overlay for this arm. Appended to the agent's
-     * instructions for the session (local `AGENTS.md` + cloud first-turn
-     * preamble) after sticky enrollment.
-     */
-    instructions?: string;
-}
-export interface ABSplitContext {
-    agent: {
-        name: string;
-    };
-    channel: {
-        id: string;
-    };
-    /**
-     * Live sessions only — the engine never calls `split` for
-     * `purpose: "eval"` harness sessions.
-     */
-    session: SessionInfo;
-    experiment: string;
-    /** Variant keys from {@link ABConfig.variants}, in declaration order. */
-    variants: string[];
-}
-export interface ABCollectContext {
-    agent: {
-        name: string;
-    };
-    channel: {
-        id: string;
-    };
-    session: SessionInfo;
-    experiment: string;
-    variant: string;
-}
-/** Cumulative per-session metrics for one experiment arm. */
-export interface ABMetrics {
-    turns: number;
-    turnFailures: number;
-    toolCalls: number;
-    toolErrors: number;
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number;
-    cacheWriteTokens: number;
-    /**
-     * Sum of estimated turn costs in USD (the `cost.totalUsd` recorded on
-     * `turn.completed` events). Turns whose model has no known rates
-     * contribute 0.
-     */
-    costUsd: number;
-    /** Sum of turn wall times (turn.started → turn.completed/failed). */
-    wallTimeMs: number;
-    /** Custom counters from {@link ABConfig.derive}. */
-    custom: Record<string, number>;
-}
-export type ABSampleReason = "turn.completed" | "turn.failed";
-export interface ABMetricSample {
-    experiment: string;
-    variant: string;
-    variantLabel?: string;
-    sessionId: string;
-    channelId: string;
-    metrics: ABMetrics;
-    reason: ABSampleReason;
-    at: string;
-}
-/** Variant key to enroll, or `null` to leave the session out (sticky). */
-export type ABSplitResult = string | null;
-/**
- * Sticky enrollment decision. Return a variant key, or `null` to skip.
- * Prefer helpers ({@link splitBySessionHash}, {@link splitIf}, …).
- */
-export type ABSplit = (ctx: ABSplitContext) => ABSplitResult | Promise<ABSplitResult>;
-export interface ABSplitOptions {
-    /** Relative weights per variant key (default: equal). */
-    weights?: Record<string, number>;
-    /** Fraction of sessions left out (`0`–`1`, sticky). */
-    holdout?: number;
-    /** Salt so a new rollout reshuffles without renaming the experiment. */
-    salt?: string;
-}
-/** Sticky hash of session id → arm (recommended default). */
-export declare function splitBySessionHash(options?: ABSplitOptions): ABSplit;
-/** Random draw once per new session (then sticky via persistence). */
-export declare function splitByRandom(options?: Omit<ABSplitOptions, "salt">): ABSplit;
-/** Pin every new session to one arm. */
-export declare function splitAlways(variant: string): ABSplit;
-/** Skip every session (pause without deleting the experiment). */
-export declare function splitNone(): ABSplit;
-/** Run `inner` only when `predicate` is true; otherwise skip. */
-export declare function splitIf(predicate: (ctx: ABSplitContext) => boolean | Promise<boolean>, inner: ABSplit): ABSplit;
-export interface ABConfig {
-    /** Experiment id. Defaults to the file stem (`ab/concise.ts` → `concise`). */
-    name?: string;
-    /**
-     * Named arms (at least two). Prefer `control` / `treatment` over `a` / `b`.
-     */
-    variants: Record<string, ABVariantMeta>;
-    /**
-     * Choose an arm at session creation, or return `null` to skip. The engine
-     * appends a durable `ab.assigned` event; the collector folds that stream.
-     */
-    split: ABSplit;
-    /**
-     * Optional custom metric extractors. Return a numeric delta, or
-     * `null`/`undefined` to skip. Called on **every** session event (including
-     * high-frequency `message.appended` deltas) — keep these synchronous and
-     * cheap; do not await I/O.
-     */
-    derive?: Record<string, (event: SessionEvent, ctx: ABCollectContext) => number | null | undefined | Promise<number | null | undefined>>;
-    /**
-     * Called on turn complete/fail for enrolled sessions only. Observe-only;
-     * errors are logged and never fatal.
-     */
-    onSample: (sample: ABMetricSample) => void | Promise<void>;
-}
-export type ABDefinition = ABConfig & {
-    readonly __agentServe: "ab";
-};
-/** Author a live A/B metrics experiment under `agent/ab`. */
-export declare function defineAB(config: ABConfig): ABDefinition;
-/** Resolve {@link ABConfig.split} to a variant key or `null`. */
-export declare function resolveABSplit(split: ABSplit, ctx: ABSplitContext): Promise<ABSplitResult>;
-/** FNV-1a → [0, 1). */
-export declare function hashToUnitInterval(input: string): number;
-export declare function pickWeightedVariant(variantKeys: readonly string[], weights: Record<string, number> | undefined, unitInterval: number): string;
-export declare function emptyABMetrics(): ABMetrics;
-export declare function cloneABMetrics(metrics: ABMetrics): ABMetrics;
-/**
- * Append enrolled per-variant `instructions` overlays onto the base agent
- * prompt. Used by the session engine before materializing the harness.
- */
-export declare function mergeABInstructions(base: string | undefined, abs: Readonly<Record<string, string | null>> | undefined, experiments: ReadonlyArray<{
-    name: string;
-    definition: ABDefinition;
-}>): string | undefined;
-/** Default sessions folded into `GET /v1/abs` / the A/Bs tab. */
-export declare const AB_DEFAULT_MAX_PLAYGROUND_SESSIONS = 200;
-/** Hard ceiling for {@link ABConfigFile.maxPlaygroundSessions}. */
-export declare const AB_MAX_PLAYGROUND_SESSIONS = 10000;
-/**
- * Project-wide A/B defaults (`agent/ab.config.ts`).
- *
- * **Assignments and foldable metrics** already persist in each session's
- * `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**. 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;
-}
-/**
- * Defaults for every experiment under `agent/ab*` (`agent/ab.config.ts`).
- *
- * 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}. */
-export declare function normalizeABMaxPlaygroundSessions(value: unknown): number;
-/**
- * Effective `GET /v1/abs` fold window. Invalid values fall back to
- * {@link AB_DEFAULT_MAX_PLAYGROUND_SESSIONS}.
- */
-export declare function resolveABMaxPlaygroundSessions(value: unknown): number;
-//# sourceMappingURL=ab.d.ts.map

package/dist/ab.d.ts.map

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