@cursor/july 0.1.1

package/dist/evals.js

@@ -0,0 +1,254 @@
+/**
+ * Filesystem-first evals for agent-serve projects.
+ *
+ * Author cases under evals/ as `*.eval.ts` files with {@link defineEval}.
+ * One file may hold a single datapoint (`test`) or many (`cases`). Drive the
+ * agent with `t.send(...)` and assert with `t.succeeded()`, `t.calledTool()`,
+ * `t.messageIncludes(...)`, or `t.check(value, includes(...))`.
+ *
+ * ```ts
+ * import { defineEval, includes } from "@anysphere/agent-serve/evals";
+ *
+ * // One datapoint — id is the file path (evals/weather/nyc.eval.ts → weather/nyc)
+ * export default defineEval({
+ *   description: "Weather tool is used for temperature questions.",
+ *   async test(t) {
+ *     await t.send("What's the temperature in NYC?");
+ *     t.succeeded();
+ *     t.calledTool("get_weather");
+ *     t.check(t.reply, includes(/°|F|C/));
+ *   },
+ * });
+ *
+ * // Many datapoints in one file — ids are <fileId>/<case.id>
+ * // evals/weather.eval.ts → weather/nyc, weather/paris
+ * export default defineEval({
+ *   tags: ["smoke", "weather"],
+ *   cases: [
+ *     {
+ *       id: "nyc",
+ *       async test(t) {
+ *         await t.send("What's the temperature in NYC?");
+ *         t.succeeded();
+ *         t.calledTool("get_weather");
+ *       },
+ *     },
+ *     {
+ *       id: "paris",
+ *       async test(t) {
+ *         await t.send("What's the weather in Paris?");
+ *         t.succeeded();
+ *         t.calledTool("get_weather");
+ *       },
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+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 { normalizePositiveInt } from "./internal/bounded-int.js";
+import { brandDefinition } from "./internal/brand.js";
+import { assertNonEmptyDir, deleteFileInDir, readJsonDir, resolveProjectRelativeDir, writeJsonFile, } from "./internal/json-dir-store.js";
+export function includes(value) {
+    return { kind: "includes", value };
+}
+export function equals(value) {
+    return { kind: "equals", value };
+}
+export function satisfies(predicate, label) {
+    return { kind: "satisfies", predicate, label };
+}
+/**
+ * Author an eval file. The path under `evals/` is the file id:
+ * `evals/weather.eval.ts` → `weather`. With a single `test`, that is also
+ * the case id. With `cases`, each datapoint is `<fileId>/<case.id>`.
+ */
+export function defineEval(config) {
+    const hasTest = typeof config.test === "function";
+    const hasCases = config.cases !== undefined;
+    if (hasTest && hasCases) {
+        throw new Error("defineEval: set either test or cases, not both");
+    }
+    if (!hasTest && !hasCases) {
+        throw new Error("defineEval requires test(t) or a non-empty cases array");
+    }
+    if (hasCases) {
+        if (!Array.isArray(config.cases) || config.cases.length === 0) {
+            throw new Error("defineEval: cases must be a non-empty array");
+        }
+        const seen = new Set();
+        for (const datapoint of config.cases) {
+            validateDatapointId(datapoint.id);
+            if (seen.has(datapoint.id)) {
+                throw new Error(`defineEval: duplicate case id ${JSON.stringify(datapoint.id)}`);
+            }
+            seen.add(datapoint.id);
+            if (typeof datapoint.test !== "function") {
+                throw new Error(`defineEval: cases[${JSON.stringify(datapoint.id)}] requires test(t)`);
+            }
+        }
+    }
+    return brandDefinition("eval", config);
+}
+function validateDatapointId(id) {
+    if (typeof id !== "string" || id.length === 0) {
+        throw new Error("defineEval: each case needs a non-empty string id");
+    }
+    if (id.includes("/") || id.includes("\\") || id.includes("..")) {
+        throw new Error(`defineEval: case id must be a single path segment (got ${JSON.stringify(id)})`);
+    }
+}
+/**
+ * Expand a file-level definition into runnable datapoints.
+ * Exported for tests and tooling.
+ */
+export function expandEvalDefinition(fileId, definition) {
+    if (definition.cases !== undefined) {
+        return definition.cases.map((datapoint) => {
+            var _a, _b, _c;
+            const description = (_a = datapoint.description) !== null && _a !== void 0 ? _a : definition.description;
+            const timeoutMs = (_b = datapoint.timeoutMs) !== null && _b !== void 0 ? _b : definition.timeoutMs;
+            return {
+                id: `${fileId}/${datapoint.id}`,
+                definition: brandDefinition("eval", Object.assign(Object.assign(Object.assign(Object.assign({}, (description !== undefined ? { description } : {})), { tags: (_c = datapoint.tags) !== null && _c !== void 0 ? _c : definition.tags }), (timeoutMs !== undefined ? { timeoutMs } : {})), { test: datapoint.test })),
+            };
+        });
+    }
+    if (typeof definition.test !== "function") {
+        throw new Error(`defineEval(${fileId}): missing test(t)`);
+    }
+    return [
+        {
+            id: fileId,
+            definition: brandDefinition("eval", Object.assign(Object.assign(Object.assign(Object.assign({}, (definition.description !== undefined
+                ? { description: definition.description }
+                : {})), (definition.tags !== undefined ? { tags: definition.tags } : {})), (definition.timeoutMs !== undefined
+                ? { timeoutMs: definition.timeoutMs }
+                : {})), { test: definition.test })),
+        },
+    ];
+}
+/**
+ * Whether a discovered case id matches a CLI filter.
+ * - exact datapoint: `weather/nyc`
+ * - whole file / prefix: `weather` selects `weather`, `weather/nyc`, …
+ * - multiple filters: OR
+ */
+export function matchesEvalIdFilter(caseId, filter) {
+    return caseId === filter || caseId.startsWith(`${filter}/`);
+}
+/**
+ * Hard ceiling for concurrent eval cases.
+ *
+ * Each case issues model provider requests; unbounded parallelism would
+ * overwhelm provider rate limits and exhaust local API quota.
+ */
+export const EVAL_MAX_CONCURRENCY_LIMIT = 200;
+/** Default playground batches kept in the serve process when `maxPlaygroundRuns` is omitted. */
+export const EVAL_DEFAULT_MAX_PLAYGROUND_RUNS = 20;
+/** Hard ceiling for {@link EvalConfigFile.maxPlaygroundRuns}. */
+export const EVAL_MAX_PLAYGROUND_RUNS = 500;
+/**
+ * Defaults for every eval under `evals/` (`evals/evals.config.ts`).
+ * `maxConcurrency` is required (1–{@link EVAL_MAX_CONCURRENCY_LIMIT}).
+ *
+ * Playground batches default to **in-memory only** (see {@link maxPlaygroundRuns} /
+ * {@link persistRuns}).
+ */
+export function defineEvalConfig(config) {
+    var _a;
+    const persistRuns = normalizePersistRuns(config.persistRuns);
+    return Object.assign(Object.assign(Object.assign({}, (config.timeoutMs === undefined ? {} : { timeoutMs: config.timeoutMs })), { maxConcurrency: normalizeEvalMaxConcurrency(config.maxConcurrency), maxPlaygroundRuns: normalizeEvalMaxPlaygroundRuns((_a = config.maxPlaygroundRuns) !== null && _a !== void 0 ? _a : EVAL_DEFAULT_MAX_PLAYGROUND_RUNS) }), (persistRuns === undefined ? {} : { persistRuns }));
+}
+/**
+ * Validate and enforce the hard concurrency ceiling.
+ */
+export function normalizeEvalMaxConcurrency(value) {
+    return normalizePositiveInt(value, {
+        label: "evals.config.ts: maxConcurrency",
+        max: EVAL_MAX_CONCURRENCY_LIMIT,
+        maxMessage: `evals.config.ts: maxConcurrency ${String(value)} exceeds the hard limit of ${EVAL_MAX_CONCURRENCY_LIMIT} (model provider request limits)`,
+    });
+}
+/** Validate {@link EvalConfigFile.maxPlaygroundRuns}. */
+export function normalizeEvalMaxPlaygroundRuns(value) {
+    return normalizePositiveInt(value, {
+        label: "evals.config.ts: maxPlaygroundRuns",
+        max: EVAL_MAX_PLAYGROUND_RUNS,
+    });
+}
+/**
+ * Effective playground history window. Invalid values fall back to
+ * {@link EVAL_DEFAULT_MAX_PLAYGROUND_RUNS} (same as a missing field).
+ */
+export function resolveEvalMaxPlaygroundRuns(value) {
+    if (value === undefined) {
+        return EVAL_DEFAULT_MAX_PLAYGROUND_RUNS;
+    }
+    try {
+        return normalizeEvalMaxPlaygroundRuns(value);
+    }
+    catch (_a) {
+        return EVAL_DEFAULT_MAX_PLAYGROUND_RUNS;
+    }
+}
+function normalizePersistRuns(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "object" ||
+        value === null ||
+        typeof value.load !== "function" ||
+        typeof value.save !== "function" ||
+        typeof value.delete !== "function") {
+        throw new Error("evals.config.ts: persistRuns must define load(ctx), save(run, ctx), and delete(runId, ctx)");
+    }
+    return value;
+}
+/**
+ * Filesystem {@link EvalRunPersistence}: one JSON file per run under `dir`
+ * (relative paths resolve against the agent project root).
+ *
+ * ```ts
+ * export default defineEvalConfig({
+ *   maxConcurrency: 20,
+ *   persistRuns: persistEvalRunsToDir(".agent-serve/eval-runs"),
+ * });
+ * ```
+ */
+export function persistEvalRunsToDir(dir) {
+    const relativeDir = assertNonEmptyDir(dir, "persistEvalRunsToDir");
+    const resolveDir = (projectRoot) => resolveProjectRelativeDir({ dir: relativeDir, projectRoot });
+    return {
+        load(ctx) {
+            return __awaiter(this, void 0, void 0, function* () {
+                return readJsonDir(resolveDir(ctx.projectRoot));
+            });
+        },
+        save(run, ctx) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield writeJsonFile({
+                    root: resolveDir(ctx.projectRoot),
+                    fileName: `${run.runId}.json`,
+                    value: run,
+                });
+            });
+        },
+        delete(runId, ctx) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield deleteFileInDir({
+                    root: resolveDir(ctx.projectRoot),
+                    fileName: `${runId}.json`,
+                });
+            });
+        },
+    };
+}

package/dist/hooks.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `defineHook` — authored at `agent/hooks/<slug>.ts`.
+ *
+ * Hooks subscribe to the session event stream and run side effects after
+ * each event is durably recorded (audit logging, metrics, persisting
+ * transcripts to your own database). Handlers are observe-only.
+ *
+ * ```ts
+ * import { defineHook } from "@anysphere/agent-serve/hooks";
+ *
+ * export default defineHook({
+ *   events: {
+ *     async "turn.completed"(event, ctx) {
+ *       console.log("turn done", ctx.session.id, event.data.usage);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+import type { HookConfig, HookDefinition } from "./types.js";
+export type { HookConfig, HookContext, HookDefinition, HookHandler, } from "./types.js";
+export declare function defineHook(config: HookConfig): HookDefinition;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,YAAY,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAE7D"}

package/dist/hooks.js

@@ -0,0 +1,23 @@
+/**
+ * `defineHook` — authored at `agent/hooks/<slug>.ts`.
+ *
+ * Hooks subscribe to the session event stream and run side effects after
+ * each event is durably recorded (audit logging, metrics, persisting
+ * transcripts to your own database). Handlers are observe-only.
+ *
+ * ```ts
+ * import { defineHook } from "@anysphere/agent-serve/hooks";
+ *
+ * export default defineHook({
+ *   events: {
+ *     async "turn.completed"(event, ctx) {
+ *       console.log("turn done", ctx.session.id, event.data.usage);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+import { brandDefinition } from "./internal/brand.js";
+export function defineHook(config) {
+    return brandDefinition("hook", config);
+}

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @anysphere/agent-serve
+ *
+ * Filesystem-first framework for Cursor agents: define an agent as markdown
+ * and TypeScript files under an `agent/` directory, and serve it over
+ * channels with the Cursor SDK as the execution harness.
+ *
+ * ```ts
+ * import { serve } from "@anysphere/agent-serve";
+ *
+ * const handle = await serve(".", { port: 3000 });
+ * console.log(`agent listening on ${handle.url}`);
+ * ```
+ */
+import { type LoadAgentProjectOptions } from "./internal/discovery.js";
+import type { AgentConfig, AgentConfigDefinition, AgentProject, AgentServeHandle, InstructionsConfig, InstructionsDefinition, ServeOptions } from "./types.js";
+export { defineAB } from "./ab.js";
+export { allowAll, bearerAuth, DELETE, defineChannel, GET, httpChannel, localDev, localDevStrict, loopbackGitHubDev, loopbackOnly, PATCH, POST, PUT, } from "./channels.js";
+export { defineConnection } from "./connections.js";
+export { defineHook } from "./hooks.js";
+export type { LoadAgentProjectOptions } from "./internal/discovery.js";
+export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
+export type { AgentServeGitHubTriggerEvent, AgentServeGitHubTriggerTarget, AgentServeTriggerEvent, AgentServeTriggerResult, AgentServeTriggerTargetResult, } from "./internal/handleAgentServeTrigger.js";
+export { collectGitHubTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
+export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, } from "./internal/mcp-endpoint.js";
+export { ReminderValidationError, UnknownReminderError, } from "./internal/reminder-runner.js";
+export type { AgentMount } from "./internal/server.js";
+export { SessionBusyError, ToolInputError, ToolNotDirectlyCallableError, UnknownChannelError, UnknownSessionError, UnknownToolError, } from "./internal/session-engine.js";
+export type { ReminderBusyPolicy, ReminderCreateInput, ReminderFireContext, ReminderFireResult, ReminderHostApi, ReminderInfo, ReminderReschedule, ReminderScheduleKind, ReminderStatus, ReminderTarget, ReminderUntilContext, } from "./reminders.js";
+export { defineSchedule } from "./schedules.js";
+export { defineSkill } from "./skills.js";
+export { defineTool } from "./tools.js";
+export type * from "./types.js";
+export { DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, } from "./types.js";
+/**
+ * Runtime config for an agent — authored at `agent/agent.ts` (the root
+ * agent) or `agent/subagents/<id>/agent.ts` (a subagent).
+ */
+export declare function defineAgent(config: AgentConfig): AgentConfigDefinition;
+/**
+ * Programmatic instructions — authored at `agent/instructions.ts` when the
+ * system prompt needs to be generated rather than written as markdown.
+ */
+export declare function defineInstructions(config: InstructionsConfig): InstructionsDefinition;
+/**
+ * Discover and serve one or more agents over HTTP.
+ *
+ * Defaults to multi-agent layout: each agent is mounted under `/<slug>/v1/*`
+ * and `/<slug>/playground`, with an index at `/`.
+ *
+ * - Given a directory that is itself an agent project, mounts it under its
+ *   directory name as the slug.
+ * - Given a directory whose immediate children are agent projects, mounts
+ *   each under its directory name.
+ * - Pass `mode: "single"` (or an {@link AgentProject}) for the unslugged
+ *   `/v1/*` surface.
+ *
+ * The built-in session channel lives under `/v1/session*`, custom channels
+ * under `/v1/channels/<id>`, plus `/v1/health` and `/v1/info`. Schedules run
+ * on their cron cadence unless dev mode or `schedules: false` disables them.
+ */
+export declare function serve(projectOrDir: string | AgentProject, options?: ServeOptions & {
+    discovery?: LoadAgentProjectOptions;
+    /**
+     * Mount layout. Defaults to `"multi"` (slugged routes + index).
+     * `"single"` serves one agent at `/v1/*` with an empty slug. Ignored when
+     * an {@link AgentProject} is passed (always single-mount).
+     */
+    mode?: "single" | "multi";
+}): Promise<AgentServeHandle>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,aAAa,EACb,GAAG,EACH,WAAW,EACX,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,GAAG,GACJ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,mBAAmB,YAAY,CAAC;AAChC,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAEtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GACzB,sBAAsB,CAExB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,KAAK,CACzB,YAAY,EAAE,MAAM,GAAG,YAAY,EACnC,OAAO,GAAE,YAAY,GAAG;IACtB,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}

package/dist/index.js

@@ -0,0 +1,101 @@
+/**
+ * @anysphere/agent-serve
+ *
+ * Filesystem-first framework for Cursor agents: define an agent as markdown
+ * and TypeScript files under an `agent/` directory, and serve it over
+ * channels with the Cursor SDK as the execution harness.
+ *
+ * ```ts
+ * import { serve } from "@anysphere/agent-serve";
+ *
+ * const handle = await serve(".", { port: 3000 });
+ * console.log(`agent listening on ${handle.url}`);
+ * ```
+ */
+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());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { registerAuthoredModuleLoaders } from "./internal/authored-loaders.js";
+import { brandDefinition } from "./internal/brand.js";
+import { setDevMode } from "./internal/dev-mode.js";
+import { resolveAgentMounts, } from "./internal/discovery.js";
+import { startServer } from "./internal/server.js";
+export { defineAB } from "./ab.js";
+// Authoring helpers (also available on their focused subpath exports).
+export { allowAll, bearerAuth, DELETE, defineChannel, GET, httpChannel, localDev, localDevStrict, loopbackGitHubDev, loopbackOnly, PATCH, POST, PUT, } from "./channels.js";
+export { defineConnection } from "./connections.js";
+export { defineHook } from "./hooks.js";
+export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
+export { collectGitHubTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
+export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, } from "./internal/mcp-endpoint.js";
+export { ReminderValidationError, UnknownReminderError, } from "./internal/reminder-runner.js";
+export { SessionBusyError, ToolInputError, ToolNotDirectlyCallableError, UnknownChannelError, UnknownSessionError, UnknownToolError, } from "./internal/session-engine.js";
+export { defineSchedule } from "./schedules.js";
+export { defineSkill } from "./skills.js";
+export { defineTool } from "./tools.js";
+export { DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, } from "./types.js";
+/**
+ * Runtime config for an agent — authored at `agent/agent.ts` (the root
+ * agent) or `agent/subagents/<id>/agent.ts` (a subagent).
+ */
+export function defineAgent(config) {
+    return brandDefinition("agent", config);
+}
+/**
+ * Programmatic instructions — authored at `agent/instructions.ts` when the
+ * system prompt needs to be generated rather than written as markdown.
+ */
+export function defineInstructions(config) {
+    return brandDefinition("instructions", config);
+}
+/**
+ * Discover and serve one or more agents over HTTP.
+ *
+ * Defaults to multi-agent layout: each agent is mounted under `/<slug>/v1/*`
+ * and `/<slug>/playground`, with an index at `/`.
+ *
+ * - Given a directory that is itself an agent project, mounts it under its
+ *   directory name as the slug.
+ * - Given a directory whose immediate children are agent projects, mounts
+ *   each under its directory name.
+ * - Pass `mode: "single"` (or an {@link AgentProject}) for the unslugged
+ *   `/v1/*` surface.
+ *
+ * The built-in session channel lives under `/v1/session*`, custom channels
+ * under `/v1/channels/<id>`, plus `/v1/health` and `/v1/info`. Schedules run
+ * on their cron cadence unless dev mode or `schedules: false` disables them.
+ */
+export function serve(projectOrDir_1) {
+    return __awaiter(this, arguments, void 0, function* (projectOrDir, options = {}) {
+        const { discovery, mode } = options, serveOptions = __rest(options, ["discovery", "mode"]);
+        // Programmatic embedders get the same authored-TypeScript loading as the
+        // CLI (idempotent; the bin registers earlier, source runs are a no-op).
+        yield registerAuthoredModuleLoaders();
+        // Set before discovery so channel factories (constructed at import time) can
+        // relax dev-only defaults — e.g. the GitHub channel accepting unsigned
+        // loopback-forwarded deliveries. No-op outside dev.
+        setDevMode(serveOptions.dev === true);
+        if (typeof projectOrDir !== "string") {
+            return startServer([{ slug: "", project: projectOrDir }], serveOptions);
+        }
+        const mounts = yield resolveAgentMounts(projectOrDir, Object.assign(Object.assign({}, discovery), (mode === undefined ? {} : { mode })));
+        return startServer(mounts, serveOptions);
+    });
+}

package/dist/internal/ab-collector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Stream-native collector for {@link defineAB} experiments.
+ *
+ * Pure fold over the session event log:
+ * - sticky arm = last `ab.assigned` for that experiment
+ * - metrics accumulate from the stream; `onSample` on turn complete/fail
+ *
+ * Enrollment is written by the engine at session creation (not here).
+ * In-memory state is a cache: on cold start (or after park eviction) the
+ * collector replays `events.ndjson` so counters survive restart.
+ *
+ * Hydration note: the engine appends before dispatch, so the first-touch
+ * replay already includes the current event — after rebuild we return
+ * without folding it again (and without re-firing `onSample`).
+ */
+import { type ABSamplePersistence } from "../ab.js";
+import type { DiscoveredAB, SessionEvent, SessionInfo } from "../types.js";
+export type { DiscoveredAB };
+export interface ABCollectorOptions {
+    projectRoot: string;
+    persistSamples?: ABSamplePersistence;
+}
+export declare class ABCollector {
+    private readonly experiments;
+    private readonly logger;
+    private readonly loadEvents;
+    private readonly state;
+    private readonly hydrated;
+    private readonly projectRoot;
+    private readonly persistSamples;
+    constructor(experiments: readonly DiscoveredAB[], logger: (line: string) => void, loadEvents: (sessionId: string) => Promise<SessionEvent[]>, options?: ABCollectorOptions);
+    get enabled(): boolean;
+    /**
+     * Fold one live event. On first touch (or after eviction), replays the
+     * durable log first so enrollment + metrics match disk.
+     */
+    onEvent(event: SessionEvent, sessionInfo: SessionInfo, agentName: string): Promise<void>;
+    private drop;
+    private fold;
+    private sessionAccum;
+}
+//# sourceMappingURL=ab-collector.d.ts.map

package/dist/internal/ab-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-collector.d.ts","sourceRoot":"","sources":["../../src/internal/ab-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU3E,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AASD,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IAEjE,YACmB,WAAW,EAAE,SAAS,YAAY,EAAE,EACpC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,EAC3E,OAAO,CAAC,EAAE,kBAAkB,EAI7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACG,OAAO,CACX,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuBf;IAED,OAAO,CAAC,IAAI;YAKE,IAAI;IA0FlB,OAAO,CAAC,YAAY;CAQrB"}