@cursor/july 0.1.92 → 0.1.94

package/dist/docs/example-agents/weather-agent.md

@@ -1,296 +0,0 @@
-# Explore the full Agent SDK surface with a weather agent
-
-The weather agent is the broadest small example in the repository. It fetches
-live conditions and forecasts, converts units through MCP, writes notes in a
-session workspace, and runs from HTTP, Slack, a schedule, and the MCP endpoint.
-
-Use this project when you want to see how the Agent SDK's filesystem pieces fit
-together before you design a larger agent.
-
-[Browse the weather agent source.](https://github.com/cursor/cursor/tree/main/packages/agent-serve/examples/weather-agent/)
-
-## See the runtime features together
-
-Most examples focus on one feature. Weather agent puts the major runtime
-features side by side:
-
-| Capability | Source | Role |
-| --- | --- | --- |
-| Root config and instructions | [`agent/agent.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/agent.ts), [`agent/instructions.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/instructions.md) | Select the cloud runtime and route each request. |
-| Server tools | [`agent/tools/`](https://github.com/cursor/cursor/tree/main/packages/agent-serve/examples/weather-agent/agent/tools/) | Fetch Open-Meteo data and call MCP from the serve host. |
-| Agent tool | [`save_weather_note.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/tools/save_weather_note.ts) | Run a Python script inside the session workspace. |
-| Stdio MCP | [`units.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/mcp-connections/units.ts), [`probe.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/mcp-connections/probe.ts) | Expose conversion tools to the model, host tools, and channel handlers. Author VM-side probe tools as TypeScript `execute` functions. |
-| Custom HTTP | [`webhook.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/channels/webhook.ts) | Start a turn or call MCP without a model turn. |
-| Slack | [`slack.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/channels/slack.ts), [`slack-app.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/channels/slack-app.ts) | Compare account-linked chat with a dedicated app. |
-| Skill and subagent | [`forecast.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/skills/forecast.md), [`researcher/`](https://github.com/cursor/cursor/tree/main/packages/agent-serve/examples/weather-agent/agent/subagents/researcher/) | Load a procedure on demand or delegate broad research. |
-| Schedule and hooks | [`heartbeat.md`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/schedules/heartbeat.md), [`audit.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/hooks/audit.ts), [`journal.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/hooks/journal.ts) | Start recurring tasks, log usage, and save turn summaries. |
-| A/B and evals | [`agent/ab.ts`](https://github.com/cursor/cursor/blob/main/packages/agent-serve/examples/weather-agent/agent/ab.ts), [`evals/`](https://github.com/cursor/cursor/tree/main/packages/agent-serve/examples/weather-agent/evals/) | Compare a sticky variant and protect tool routing with regression cases. |
-
-## Follow one request
-
-A current-weather question takes this path:
-
-1. The built-in HTTP channel, Slack, or the custom `/report` route creates a
-   durable session.
-2. `instructions.md` tells the model to call `get_weather` instead of
-   guessing.
-3. The server tool geocodes the city, fetches Open-Meteo, validates the
-   response, and returns normalized fields.
-4. The agent writes a short answer. The Agent SDK records every event in the
-   session stream.
-5. The audit hook observes `turn.completed`. If the session joined the A/B
-   experiment, the collector updates its metrics too.
-
-Forecasts route to `get_forecast`. Unit conversions route to
-`convert_temperature`, which calls the `units` MCP server through
-`ctx.host.mcp`. Climate history and broad comparisons route to the
-`researcher` subagent.
-
-## Prepare the example
-
-You need:
-
-- Node 22.13 or newer.
-- An agent-runtime credential.
-- Network access to Open-Meteo.
-- Python 3 for `save_weather_note`.
-
-The project mounts an account-linked Slack channel. The Agent SDK checks the
-connection at startup, so sign in even when you plan to call a deterministic
-tool.
-
-The optional dedicated Slack app also needs a token pair.
-`agent-sdk slack create --dir examples/weather-agent` provisions the
-app and writes the tokens for you (see the
-[Slack guide](/docs/guides/slack.md#set-it-up)); with hand-minted tokens,
-export them instead:
-
-```bash
-export WEATHER_AGENT_SLACK_BOT_TOKEN=xoxb-...
-export WEATHER_AGENT_SLACK_APP_TOKEN=xapp-...
-agent-sdk slack doctor --prefix WEATHER_AGENT
-```
-
-Without those two tokens, the dedicated channel stays idle. The
-account-linked channel still works.
-
-## Inspect before running
-
-```bash
-agent-sdk validate --dir examples/weather-agent
-agent-sdk info --dir examples/weather-agent --json
-agent-sdk eval --dir examples/weather-agent --list
-```
-
-`validate` should pass. `info` and `eval --list` should match the capabilities
-described above.
-
-## Call the typed tools
-
-Start with the current-weather server tool:
-
-```bash
-agent-sdk call get_weather \
-  --dir examples/weather-agent \
-  --input '{"city":"New York City"}'
-```
-
-`defineTool` gives the input a Zod schema. The Agent SDK validates the JSON before
-`execute` runs. The result includes the matched place, condition,
-temperature, humidity, wind, gusts, and precipitation.
-
-Try the forecast:
-
-```bash
-agent-sdk call get_forecast \
-  --dir examples/weather-agent \
-  --input '{"city":"Lisbon","days":5}'
-```
-
-The tool accepts one to seven days. Shared Open-Meteo code lives under
-`agent/lib/`, so the Agent SDK imports it without discovering another tool.
-
-## Compare server and agent execution
-
-Most weather tools use the default `execution: "server"`. Their TypeScript
-runs inside the serve host and can reach `ctx.host` services.
-
-`save_weather_note` uses `execution: "agent"` instead. The Agent SDK materializes
-its script into the agent environment. The script reads JSON from stdin and
-appends to `weather-notes.md` in that session's workspace:
-
-```bash
-agent-sdk run --dir examples/weather-agent \
-  --message "Save a note that Boston is cold and windy."
-```
-
-Each session gets its own workspace. Saving a note doesn't edit the authored
-example.
-
-This split matters on cloud. Server tools stay on the Agent SDK host.
-Agent tools run inside the cloud workspace.
-
-## Verify tool execution on the agent VM
-
-Ask the agent to call `probe_cloud_tool` on the `probe` MCP server.
-`agent/mcp-connections/probe.ts` authors that tool as TypeScript. The Agent
-SDK packages it as stdio MCP so a cloud VM with no checkout of this example
-can still run it. The model lists the server and calls the tool; it does
-not write a `.sh`.
-
-A real call writes `vm-tool-observations/<id>.json` in the agent cwd and
-returns hostname, cwd, and pid. Stream events show `probe:probe_cloud_tool`,
-not `shell`.
-
-A local `.agent-serve/tools/probe_cloud_tool.sh` or a marker under `probes/`
-means the model invented a substitute.
-
-```bash
-agent-sdk run --dir examples/weather-agent \
-  --message "Test custom tool execution from this cloud agent. Call probe_cloud_tool."
-```
-
-## Use MCP connections in three places
-
-`agent/mcp-connections/units.ts` starts a local stdio server. The filename
-makes its server name `units`. The Agent SDK exposes it to:
-
-- the model as MCP tools,
-- server tools through `ctx.host.mcp`, and
-- channel handlers through `host.mcp`.
-
-`probe` is a second stdio connection. Its tools are TypeScript `execute`
-functions; the Agent SDK packages them so a cloud VM can spawn the server
-without this checkout. The model calls `probe_cloud_tool` directly; no host
-tool wraps it.
-
-`convert_temperature` demonstrates the server-tool path:
-
-```bash
-agent-sdk call convert_temperature \
-  --dir examples/weather-agent \
-  --input '{"value":72,"from":"F"}'
-```
-
-The custom channel demonstrates the handler path. Start the dev server:
-
-```bash
-agent-sdk dev examples/weather-agent
-```
-
-Then call MCP deterministically through `/convert`:
-
-```bash
-curl -s -X POST \
-  http://127.0.0.1:3000/weather-agent/v1/channels/webhook/convert \
-  -H 'content-type: application/json' \
-  -d '{"value":20,"from":"C"}'
-```
-
-No model chooses a tool in this route. The handler calls the MCP server and
-returns its result.
-
-## Keep conversation state in a custom channel
-
-`POST /report` starts a model turn and waits for it:
-
-```bash
-curl -s -X POST \
-  http://127.0.0.1:3000/weather-agent/v1/channels/webhook/report \
-  -H 'content-type: application/json' \
-  -d '{"message":"What is the weather in Paris?"}'
-```
-
-The response includes a `key`. Send it back on the next request to continue
-the same session:
-
-```bash
-curl -s -X POST \
-  http://127.0.0.1:3000/weather-agent/v1/channels/webhook/report \
-  -H 'content-type: application/json' \
-  -d '{"message":"How about tomorrow?","key":"<key>"}'
-```
-
-This is the custom-channel version of a continuation token. See
-[webhooks and custom channels](/docs/guides/webhooks.md) for route schemas,
-authentication, and asynchronous handlers.
-
-## Load procedures and delegate research
-
-The forecast skill gives the root agent an on-demand procedure. The Agent SDK
-advertises the skill's description, then the harness loads its content when
-the request matches.
-
-The `researcher` directory is an SDK subagent. Its description tells the
-parent when to delegate. It inherits the parent's execution surface, but
-gets its own instructions:
-
-```bash
-agent-sdk run --dir examples/weather-agent \
-  --message "Compare record summer temperatures across Paris, London, and Rome."
-```
-
-Use a skill when the same agent needs a procedure. Use a subagent when the
-parent should hand a bounded task to a specialist. The
-[subagents reference](/docs/reference/subagents.md) explains the current
-inheritance limits.
-
-## Trigger the schedule and inspect the hook
-
-The heartbeat schedule runs at 09:00 UTC on weekdays. Automatic schedule
-timers stay off under `--dev`, so dispatch it manually:
-
-```bash
-curl -s -X POST \
-  http://127.0.0.1:3000/weather-agent/v1/dev/schedules/heartbeat
-```
-
-It creates a task session to check San Francisco, New York, and London.
-The audit hook logs usage after each completed turn. Hooks observe recorded
-events; their failures don't fail the turn.
-
-## Measure variants and regressions
-
-The `weather-tool-efficiency` A/B experiment assigns sessions by a sticky
-hash:
-
-- `control` returns current conditions in Fahrenheit.
-- `treatment` adds a brief Celsius instruction and changes `get_weather` to
-  return Celsius fields.
-
-Samples and aggregate snapshots persist under `.agent-serve/`. The treatment
-only changes current conditions; `get_forecast` still returns Fahrenheit.
-Treat the branch as an example of `ctx.session.abs`, not a complete unit
-policy.
-
-List and run the evals:
-
-```bash
-agent-sdk eval --dir examples/weather-agent --list
-agent-sdk eval --dir examples/weather-agent --json
-```
-
-The suite covers weather and forecast routing, the local converter, workspace
-notes, and the VM-side probe.
-
-## Turn the weather tour into your own agent
-
-Keep the shape and replace the domain:
-
-- Swap Open-Meteo tools for your typed service clients.
-- Keep deterministic transforms behind direct server tools or MCP.
-- Use an agent tool only when code must run in the agent workspace.
-- Put reusable procedures in skills and narrow specialist work into
-  subagents.
-- Add a channel only when the external surface needs its own identity,
-  continuation key, or delivery behavior.
-
-## Where to go next
-
-- [Tools](/docs/reference/tools.md)
-- [MCP connections](/docs/reference/connections.md)
-- [Human-in-the-loop approvals](/docs/guides/human-in-the-loop.md)
-- [Slack](/docs/guides/slack.md)
-- [Schedules and reminders](/docs/reference/schedules.md)
-- [Evals](/docs/evals.md)
-- [Live A/B metrics](/docs/ab.md)

package/dist/internal/cursor-slack-relay.d.ts

@@ -1,96 +0,0 @@
-/**
- * Pulls `/v0/slack-events` into agent-serve: register the mounted
- * cursor-account Slack agents (name + icon) with the Cursor backend, then
- * long-poll routed events with a durable offset under
- * `<stateDir>/offset.json` and dispatch each to the agent it addresses.
- * Outbound Slack Web API calls are proxied through `POST /v0/slack-events/api`
- * via a per-agent {@link SlackApiTransport} binding.
- *
- * Same lifecycle rules as the SCM relay (`cursor-event-relay.ts`):
- * registration-gated consumption, heartbeat re-registration, durable
- * consumer id, at-least-once dispatch with client-owned offsets.
- */
-import type { CursorSlackEnvelope } from "../channels/slack/cursor-account.js";
-/** One agent this host registers over the Cursor Slack connection. */
-export interface CursorSlackAgentRegistration {
-    name: string;
-    iconUrl?: string;
-    iconEmoji?: string;
-    /** Opt out of the default external-sender block. */
-    blockExternals?: boolean;
-}
-/** One relayed event as delivered to {@link CursorSlackRelayOptions.dispatch}. */
-export type CursorSlackRelayEvent = CursorSlackEnvelope & {
-    offset: string;
-};
-export interface CursorSlackRelayOptions {
-    baseUrl: string;
-    apiKey: string;
-    agents: readonly CursorSlackAgentRegistration[];
-    stateDir: string;
-    /**
-     * Called for each event addressed to this consumer's agents; failures
-     * retry a bounded number of times, then log and skip.
-     */
-    dispatch: (envelope: CursorSlackRelayEvent) => Promise<void>;
-    logger: (line: string) => void;
-    /** Test seam. Defaults to global fetch. */
-    fetchImpl?: typeof fetch;
-    /** Test seam: override long-poll wait (default 25s). */
-    pollWaitMs?: number;
-}
-/** Human-readable log fragment for one relayed Slack event. */
-export declare function formatCursorSlackEventLog(envelope: {
-    eventName: string;
-    agentName: string;
-    matchedBy: string;
-    channelId: string;
-    threadTs: string;
-    receivedAtMs: number;
-    eventId?: string;
-}): string;
-/**
- * Build the backend proxy caller one agent's {@link SlackApiTransport}
- * binds to. Returns Slack-shaped `{ ok: false, error }` bodies on transport
- * failures so channel soft-fail paths behave exactly like direct Web API
- * callers.
- */
-export declare function createCursorSlackApiCaller(args: {
-    baseUrl: string;
-    apiKey: string;
-    agentName: string;
-    consumerId: string;
-    fetchImpl?: typeof fetch;
-    logger?: (line: string) => void;
-}): (method: string, callArgs: Record<string, unknown>) => Promise<Record<string, unknown>>;
-/**
- * Cursor Slack relay: a thin {@link CursorRelayCore} adapter. Keeps the same
- * `new CursorSlackRelay(options)` surface with `.resolveConsumerId()`,
- * `.start()`, and `.stop()` (the server binds outbound transports with the
- * resolved consumer id before starting).
- */
-export declare class CursorSlackRelay {
-    private readonly options;
-    private readonly core;
-    /**
-     * Agent names (lowercased) the server confirmed for THIS consumer. The
-     * stream is shared with sibling consumers of the same principal, so only
-     * events for these agents (and this consumer id) may dispatch.
-     */
-    private subscribedAgents;
-    private consumerId;
-    constructor(options: CursorSlackRelayOptions);
-    /**
-     * Resolve the durable consumer id before starting, so transports can bind
-     * with it. Also used by tests.
-     */
-    resolveConsumerId(): Promise<string>;
-    /**
-     * Whether a relayed event belongs to THIS consumer: the backend stamps
-     * each envelope with the registering consumer id and agent.
-     */
-    private shouldDispatch;
-    start(): void;
-    stop(): Promise<void>;
-}
-//# sourceMappingURL=cursor-slack-relay.d.ts.map

package/dist/internal/cursor-slack-relay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor-slack-relay.d.ts","sourceRoot":"","sources":["../../src/internal/cursor-slack-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAO/E,sEAAsE;AACtE,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAYD,kFAAkF;AAClF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,CACF,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0CpC;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAUf,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyC;IAC9D;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,UAAU,CAAM;IAExB,YAA6B,OAAO,EAAE,uBAAuB,EAsE5D;IAED;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAGzC;IAED;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB,KAAK,IAAI,IAAI,CAEZ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF"}

package/dist/internal/cursor-slack-relay.js

@@ -1,176 +0,0 @@
-/**
- * Pulls `/v0/slack-events` into agent-serve: register the mounted
- * cursor-account Slack agents (name + icon) with the Cursor backend, then
- * long-poll routed events with a durable offset under
- * `<stateDir>/offset.json` and dispatch each to the agent it addresses.
- * Outbound Slack Web API calls are proxied through `POST /v0/slack-events/api`
- * via a per-agent {@link SlackApiTransport} binding.
- *
- * Same lifecycle rules as the SCM relay (`cursor-event-relay.ts`):
- * registration-gated consumption, heartbeat re-registration, durable
- * consumer id, at-least-once dispatch with client-owned offsets.
- */
-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 { CursorRelayCore, describeRelayError, } from "./cursor-relay-core.js";
-/** Human-readable log fragment for one relayed Slack event. */
-export function formatCursorSlackEventLog(envelope) {
-    var _a;
-    const received = new Date(envelope.receivedAtMs).toISOString();
-    return `${envelope.eventName} → ${envelope.agentName} (${envelope.matchedBy}) in ${envelope.channelId}/${envelope.threadTs} received=${received} (${(_a = envelope.eventId) !== null && _a !== void 0 ? _a : "no event id"})`;
-}
-/**
- * Build the backend proxy caller one agent's {@link SlackApiTransport}
- * binds to. Returns Slack-shaped `{ ok: false, error }` bodies on transport
- * failures so channel soft-fail paths behave exactly like direct Web API
- * callers.
- */
-export function createCursorSlackApiCaller(args) {
-    var _a;
-    const fetchImpl = (_a = args.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
-    const url = `${args.baseUrl.replace(/\/+$/, "")}/v0/slack-events/api`;
-    return (method, callArgs) => __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        try {
-            const response = yield fetchImpl(url, {
-                method: "POST",
-                headers: {
-                    authorization: `Bearer ${args.apiKey}`,
-                    "content-type": "application/json",
-                },
-                body: JSON.stringify({
-                    method,
-                    arguments: callArgs,
-                    agentName: args.agentName,
-                    consumerId: args.consumerId,
-                }),
-            });
-            const body = (yield response.json().catch(() => undefined));
-            if (body !== undefined && typeof body === "object") {
-                if (!response.ok && body.ok === undefined) {
-                    const error = typeof body.error === "string"
-                        ? body.error
-                        : `cursor_backend_http_${response.status}`;
-                    return { ok: false, error };
-                }
-                return body;
-            }
-            return {
-                ok: false,
-                error: `cursor_backend_http_${response.status}`,
-            };
-        }
-        catch (error) {
-            (_a = args.logger) === null || _a === void 0 ? void 0 : _a.call(args, `[agent-sdk] cursor-slack: ${method} proxy call failed: ${describeRelayError(error)}`);
-            return { ok: false, error: "cursor_backend_unreachable" };
-        }
-    });
-}
-/**
- * Cursor Slack relay: a thin {@link CursorRelayCore} adapter. Keeps the same
- * `new CursorSlackRelay(options)` surface with `.resolveConsumerId()`,
- * `.start()`, and `.stop()` (the server binds outbound transports with the
- * resolved consumer id before starting).
- */
-export class CursorSlackRelay {
-    constructor(options) {
-        this.options = options;
-        /**
-         * Agent names (lowercased) the server confirmed for THIS consumer. The
-         * stream is shared with sibling consumers of the same principal, so only
-         * events for these agents (and this consumer id) may dispatch.
-         */
-        this.subscribedAgents = new Set();
-        this.consumerId = "";
-        const adapter = {
-            logPrefix: "cursor-slack",
-            subscribePath: "/v0/slack-events/subscriptions",
-            pollPath: "/v0/slack-events",
-            buildRegistrationBody: (consumerId) => {
-                this.consumerId = consumerId;
-                return {
-                    consumerId,
-                    // Optional fields may be undefined — JSON.stringify drops them
-                    // from the registration body.
-                    agents: this.options.agents.map((agent) => ({
-                        name: agent.name,
-                        iconUrl: agent.iconUrl,
-                        iconEmoji: agent.iconEmoji,
-                        blockExternals: agent.blockExternals === false ? false : undefined,
-                    })),
-                };
-            },
-            // Empty agents drop this consumer's registration on clean stop, so a
-            // redeployed sibling's identical agent names never tie with this
-            // host's ghost until the server-side TTL lapses.
-            buildDeregistrationBody: (consumerId) => ({ consumerId, agents: [] }),
-            applyRegistrationResponse: (json) => {
-                var _a, _b, _c;
-                const result = json;
-                const agentStatuses = (_a = result.agents) !== null && _a !== void 0 ? _a : [];
-                this.subscribedAgents = new Set(agentStatuses
-                    .filter((status) => status.isSubscribed)
-                    .map((status) => status.name.toLowerCase()));
-                const failures = [
-                    ...((_b = result.workspaces) !== null && _b !== void 0 ? _b : [])
-                        .filter((workspace) => !workspace.isSubscribed)
-                        .map((workspace) => { var _a; return `workspace ${workspace.slackTeamId}: ${(_a = workspace.detail) !== null && _a !== void 0 ? _a : "not subscribed"}`; }),
-                    ...agentStatuses
-                        .filter((status) => !status.isSubscribed)
-                        .map((status) => { var _a; return `agent ${status.name}: ${(_a = status.detail) !== null && _a !== void 0 ? _a : "rejected"}`; }),
-                ];
-                if (failures.length > 0) {
-                    return failures;
-                }
-                const workspaceIds = ((_c = result.workspaces) !== null && _c !== void 0 ? _c : [])
-                    .filter((workspace) => workspace.isSubscribed)
-                    .map((workspace) => workspace.slackTeamId);
-                return [
-                    `registered ${[...this.subscribedAgents].join(", ")} on Slack workspace ${workspaceIds.join(", ")}`,
-                ];
-            },
-            shouldDispatch: (event) => this.shouldDispatch(event),
-            dispatch: (event) => this.options.dispatch(event),
-        };
-        this.core = new CursorRelayCore(Object.assign(Object.assign({ baseUrl: options.baseUrl, apiKey: options.apiKey, stateDir: options.stateDir, adapter, logger: options.logger }, (options.fetchImpl === undefined
-            ? {}
-            : { fetchImpl: options.fetchImpl })), (options.pollWaitMs === undefined
-            ? {}
-            : { pollWaitMs: options.pollWaitMs })));
-    }
-    /**
-     * Resolve the durable consumer id before starting, so transports can bind
-     * with it. Also used by tests.
-     */
-    resolveConsumerId() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.consumerId = yield this.core.resolveConsumerId();
-            return this.consumerId;
-        });
-    }
-    /**
-     * Whether a relayed event belongs to THIS consumer: the backend stamps
-     * each envelope with the registering consumer id and agent.
-     */
-    shouldDispatch(event) {
-        if (event.consumerId !== this.consumerId) {
-            return false;
-        }
-        return this.subscribedAgents.has(event.agentName.toLowerCase());
-    }
-    start() {
-        this.core.start();
-    }
-    stop() {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.core.stop();
-        });
-    }
-}