@cursor/july 0.1.108 → 0.1.111

package/dist/internal/discovery/ab.js

@@ -1,113 +0,0 @@
-/**
- * `agent/ab.ts` or `agent/ab/*.ts` plus `agent/ab.config.ts`: live A/B experiments.
- */
-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 { basename, extname, join, relative } from "node:path";
-import { getDefinitionKind } from "../brand.js";
-import { displayPath } from "./context.js";
-import { findModuleFile, isDirectory, isModuleFile, toPosix, walkFiles, } from "./fs.js";
-import { importDefault } from "./modules.js";
-export function loadABs(ctx, agentDir, onDisable) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const abs = [];
-        const seen = new Set();
-        const single = yield findModuleFile(agentDir, "ab");
-        if (single !== undefined) {
-            const definition = yield importDefault(ctx, single, onDisable === undefined ? "ab" : ["ab", "disabled"]);
-            if (definition !== undefined) {
-                if (getDefinitionKind(definition) === "disabled") {
-                    onDisable === null || onDisable === void 0 ? void 0 : onDisable("ab", single);
-                }
-                else {
-                    const name = resolveABName(definition, "ab");
-                    seen.add(name);
-                    abs.push({
-                        name,
-                        source: "ab",
-                        definition: definition,
-                    });
-                }
-            }
-        }
-        const absDir = join(agentDir, "ab");
-        if (yield isDirectory(absDir)) {
-            for (const filePath of yield walkFiles(absDir)) {
-                if (!isModuleFile(basename(filePath))) {
-                    continue;
-                }
-                const rel = toPosix(relative(absDir, filePath));
-                const stem = rel.slice(0, -extname(rel).length);
-                const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "ab" : ["ab", "disabled"]);
-                if (definition === undefined) {
-                    continue;
-                }
-                if (getDefinitionKind(definition) === "disabled") {
-                    onDisable === null || onDisable === void 0 ? void 0 : onDisable(stem, filePath);
-                    continue;
-                }
-                const name = resolveABName(definition, stem);
-                if (seen.has(name)) {
-                    ctx.diagnostics.push({
-                        severity: "error",
-                        path: displayPath(ctx, filePath),
-                        message: `Duplicate A/B experiment name ${JSON.stringify(name)}.`,
-                    });
-                    continue;
-                }
-                seen.add(name);
-                abs.push({
-                    name,
-                    source: stem,
-                    definition: definition,
-                });
-            }
-        }
-        return abs;
-    });
-}
-export function loadABConfig(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const path = yield findModuleFile(agentDir, "ab.config");
-        if (path === undefined) {
-            return undefined;
-        }
-        try {
-            const mod = yield ctx.importModule(path);
-            if (mod.default === null || typeof mod.default !== "object") {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, path),
-                    message: "ab.config.ts must default-export defineABConfig({ ... }) from @cursor/july/ab.",
-                });
-                return undefined;
-            }
-            return mod.default;
-        }
-        catch (error) {
-            ctx.diagnostics.push({
-                severity: "error",
-                path: displayPath(ctx, path),
-                message: `Failed to load ab.config: ${error instanceof Error ? error.message : String(error)}`,
-            });
-            return undefined;
-        }
-    });
-}
-function resolveABName(definition, fallback) {
-    if (typeof definition === "object" &&
-        definition !== null &&
-        "name" in definition &&
-        typeof definition.name === "string" &&
-        definition.name.length > 0) {
-        return definition.name;
-    }
-    return fallback;
-}

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

@@ -1,75 +0,0 @@
-/**
- * Relay-backed Slack posting for managed deployments.
- *
- * On AgentSDK v2 managed deployments the fork never receives a Slack token.
- * The delivery envelope carries the matched automation's configured Slack
- * **channel ids** only (`managedAutomation.slackChannels`, absent when the
- * customer toggled "Send to Slack" off); each post goes through the control
- * plane's Slack relay
- * (`/internal/agent-serve/agent-sdk-slack-relay/:automationUuid`),
- * authenticated with the pod's own `CURSOR_API_KEY`. The relay re-checks
- * that the channel is configured on exactly that automation, renders the
- * markdown, and posts as the Cursor Slack app with the customer's stored
- * workspace token.
- *
- * INTERNAL: first-party multi-tenant deployment plumbing. Deliberately
- * excluded from the published `@cursor/july` npm package (see the `files`
- * whitelist); consumed by internal deployments via relative source imports.
- */
-/**
- * Path prefix of the backend relay route. Must match the mount in
- * `backend/server/src/agentServe/agentServeEndpoints.ts`
- * (`agentSdkSlackRelayRoutes`).
- */
-export declare const AGENT_SDK_SLACK_RELAY_PATH_PREFIX = "/internal/agent-serve/agent-sdk-slack-relay";
-/** Mirrors the relay's body bound; longer summaries are truncated client-side. */
-export declare const AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS = 12000;
-/**
- * Relay URL scoped to the source managed automation the delivery envelope
- * attributed, so the relay checks the destination against exactly that
- * automation's configured channels.
- */
-export declare function relaySlackPostUrl(args: {
-    baseUrl: string;
-    automationUuid: string;
-}): string;
-export type RelaySlackPostResult = {
-    ok: true;
-    channel: string;
-    ts?: string;
-    permalink?: string;
-} | {
-    ok: false;
-    channel: string;
-    /** HTTP status from the relay, or 0 when the request never completed. */
-    status: number;
-    error: string;
-};
-export interface RelaySlackPostTarget {
-    relayBaseUrl: string;
-    apiKey: string;
-}
-/** Pod credential + external API base URL, or undefined off-platform. */
-export declare function resolveRelaySlackTarget(): RelaySlackPostTarget | undefined;
-/**
- * Post one markdown message to one configured channel through the relay.
- * Never throws: every failure is a `{ ok: false }` result so product code
- * can log and continue (a Slack outage must not fail the review).
- */
-export declare function postRelaySlackMessage(args: {
-    /** Source managed automation uuid from the delivery envelope. */
-    automationUuid: string;
-    /** Configured channel id (from `managedAutomation.slackChannels`). */
-    channel: string;
-    /** Markdown body. */
-    message: string;
-    /** Parent message ts to reply in a thread. */
-    threadTs?: string;
-    /** Test seam; defaults to the pod credential + external API base URL. */
-    resolve?: () => RelaySlackPostTarget | undefined;
-    fetchImpl?: typeof fetch;
-    timeoutMs?: number;
-    /** Diagnostic sink; defaults to `console.info`. */
-    log?: (line: string) => void;
-}): Promise<RelaySlackPostResult>;
-//# sourceMappingURL=relay.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../../src/internal/tenant-slack/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,gDACC,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,uCAAuC,QAAS,CAAC;AAI9D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAKT;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IACE,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAM1E;AAmBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyFhC"}

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

@@ -1,148 +0,0 @@
-/**
- * Relay-backed Slack posting for managed deployments.
- *
- * On AgentSDK v2 managed deployments the fork never receives a Slack token.
- * The delivery envelope carries the matched automation's configured Slack
- * **channel ids** only (`managedAutomation.slackChannels`, absent when the
- * customer toggled "Send to Slack" off); each post goes through the control
- * plane's Slack relay
- * (`/internal/agent-serve/agent-sdk-slack-relay/:automationUuid`),
- * authenticated with the pod's own `CURSOR_API_KEY`. The relay re-checks
- * that the channel is configured on exactly that automation, renders the
- * markdown, and posts as the Cursor Slack app with the customer's stored
- * workspace token.
- *
- * INTERNAL: first-party multi-tenant deployment plumbing. Deliberately
- * excluded from the published `@cursor/july` npm package (see the `files`
- * whitelist); consumed by internal deployments via relative source imports.
- */
-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 { cursorExternalApiUrl, resolveApiKeySync, } from "../cursor/credentials.js";
-/**
- * Path prefix of the backend relay route. Must match the mount in
- * `backend/server/src/agentServe/agentServeEndpoints.ts`
- * (`agentSdkSlackRelayRoutes`).
- */
-export const AGENT_SDK_SLACK_RELAY_PATH_PREFIX = "/internal/agent-serve/agent-sdk-slack-relay";
-/** Mirrors the relay's body bound; longer summaries are truncated client-side. */
-export const AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS = 12000;
-const DEFAULT_TIMEOUT_MS = 30000;
-/**
- * Relay URL scoped to the source managed automation the delivery envelope
- * attributed, so the relay checks the destination against exactly that
- * automation's configured channels.
- */
-export function relaySlackPostUrl(args) {
-    const trimmed = args.baseUrl.endsWith("/")
-        ? args.baseUrl.slice(0, -1)
-        : args.baseUrl;
-    return `${trimmed}${AGENT_SDK_SLACK_RELAY_PATH_PREFIX}/${encodeURIComponent(args.automationUuid)}`;
-}
-/** Pod credential + external API base URL, or undefined off-platform. */
-export function resolveRelaySlackTarget() {
-    const resolved = resolveApiKeySync();
-    if (resolved === undefined) {
-        return undefined;
-    }
-    return { relayBaseUrl: cursorExternalApiUrl(), apiKey: resolved.apiKey };
-}
-function truncateMessage(message) {
-    if (message.length <= AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS) {
-        return message;
-    }
-    const marker = "\n\n_(truncated)_";
-    return `${message.slice(0, AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS - marker.length)}${marker}`;
-}
-function describeError(error) {
-    if (error instanceof Error) {
-        return error.name === "TimeoutError" || error.name === "AbortError"
-            ? "relay request timed out"
-            : error.message;
-    }
-    return String(error);
-}
-/**
- * Post one markdown message to one configured channel through the relay.
- * Never throws: every failure is a `{ ok: false }` result so product code
- * can log and continue (a Slack outage must not fail the review).
- */
-export function postRelaySlackMessage(args) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e;
-        const channel = args.channel.trim();
-        const log = (_a = args.log) !== null && _a !== void 0 ? _a : ((line) => console.info(line));
-        if (channel === "") {
-            log(`[agent-sdk-slack-relay-client] refusing post automationUuid=${args.automationUuid}: empty channel`);
-            return { ok: false, channel, status: 0, error: "empty channel" };
-        }
-        const target = ((_b = args.resolve) !== null && _b !== void 0 ? _b : resolveRelaySlackTarget)();
-        if (target === undefined) {
-            log(`[agent-sdk-slack-relay-client] refusing post automationUuid=${args.automationUuid} channel=${channel}: no Cursor credential resolved (CURSOR_API_KEY / pod credential absent)`);
-            return {
-                ok: false,
-                channel,
-                status: 0,
-                error: "no Cursor credential for the Slack relay",
-            };
-        }
-        const fetchImpl = (_c = args.fetchImpl) !== null && _c !== void 0 ? _c : fetch;
-        const url = relaySlackPostUrl({
-            baseUrl: target.relayBaseUrl,
-            automationUuid: args.automationUuid,
-        });
-        const messageChars = args.message.length;
-        log(`[agent-sdk-slack-relay-client] POST ${url} channel=${channel} messageChars=${String(messageChars)} truncated=${String(messageChars > AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS)} threaded=${String(args.threadTs !== undefined)} timeoutMs=${String((_d = args.timeoutMs) !== null && _d !== void 0 ? _d : DEFAULT_TIMEOUT_MS)}`);
-        const startedAt = Date.now();
-        let response;
-        try {
-            response = yield fetchImpl(url, {
-                method: "POST",
-                headers: {
-                    authorization: `Bearer ${target.apiKey}`,
-                    "content-type": "application/json",
-                    accept: "application/json",
-                },
-                body: JSON.stringify(Object.assign({ channel, message: truncateMessage(args.message) }, (args.threadTs === undefined ? {} : { threadTs: args.threadTs }))),
-                signal: AbortSignal.timeout((_e = args.timeoutMs) !== null && _e !== void 0 ? _e : DEFAULT_TIMEOUT_MS),
-            });
-        }
-        catch (error) {
-            log(`[agent-sdk-slack-relay-client] request failed before a response channel=${channel} automationUuid=${args.automationUuid} elapsedMs=${String(Date.now() - startedAt)}: ${describeError(error)}`);
-            return { ok: false, channel, status: 0, error: describeError(error) };
-        }
-        let body;
-        try {
-            body = yield response.json();
-        }
-        catch (_f) {
-            body = undefined;
-        }
-        const record = typeof body === "object" && body !== null && !Array.isArray(body)
-            ? body
-            : {};
-        if (!response.ok || record.ok !== true) {
-            const error = typeof record.error === "string" && record.error !== ""
-                ? record.error
-                : `relay responded ${response.status}`;
-            log(`[agent-sdk-slack-relay-client] relay denied channel=${channel} automationUuid=${args.automationUuid} status=${String(response.status)} bodyOk=${String(record.ok)} elapsedMs=${String(Date.now() - startedAt)}: ${error}`);
-            return {
-                ok: false,
-                channel,
-                status: response.status,
-                error,
-            };
-        }
-        log(`[agent-sdk-slack-relay-client] relay posted channel=${typeof record.channel === "string" ? record.channel : channel} automationUuid=${args.automationUuid} status=${String(response.status)} ts=${typeof record.ts === "string" ? record.ts : "<none>"} elapsedMs=${String(Date.now() - startedAt)}`);
-        return Object.assign(Object.assign({ ok: true, channel: typeof record.channel === "string" ? record.channel : channel }, (typeof record.ts === "string" ? { ts: record.ts } : {})), (typeof record.permalink === "string"
-            ? { permalink: record.permalink }
-            : {}));
-    });
-}