@cursor/bdk 0.2.12 → 0.2.13

package/dist/internal/session-live-publisher.js

@@ -44,10 +44,62 @@ const DELTA_EVENT_TYPES = new Set(["message.appended", "reasoning.appended"]);
 function utf8Bytes(text) {
     return Buffer.byteLength(text, "utf8");
 }
+/** Per-string length limits tried, longest first, until an event fits the cap. */
+const LIVE_TRUNCATION_STEPS = [4096, 1024, 256, 64];
+/**
+ * `data` fields viewers use to place an event (which tool card, which
+ * subagent, how the turn ended). They survive every truncation step.
+ */
+const LIVE_IDENTITY_KEYS = [
+    "callId",
+    "toolName",
+    "parentCallId",
+    "isError",
+    "finishReason",
+    "stepId",
+    "decision",
+    "sdkAgentId",
+];
+const LIVE_TRUNCATION_MARKER = "… [truncated in the live view]";
+function truncateStrings(value, maxChars) {
+    if (typeof value === "string") {
+        return value.length > maxChars ? `${value.slice(0, maxChars)}${LIVE_TRUNCATION_MARKER}` : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => truncateStrings(item, maxChars));
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, truncateStrings(item, maxChars)]));
+    }
+    return value;
+}
+function identityData(data) {
+    const kept = {};
+    if (data === null || typeof data !== "object" || Array.isArray(data)) {
+        return kept;
+    }
+    for (const key of LIVE_IDENTITY_KEYS) {
+        const value = data[key];
+        if (typeof value === "number" || typeof value === "boolean") {
+            kept[key] = value;
+        }
+        else if (typeof value === "string") {
+            kept[key] = truncateStrings(value, 256);
+        }
+    }
+    // `actions.requested` places its tool cards from `calls`.
+    const calls = data.calls;
+    if (Array.isArray(calls)) {
+        kept.calls = calls.slice(0, 50).map((call) => identityData(call));
+    }
+    return kept;
+}
 /**
  * The event as it crosses the live wire. Delta events drop the accumulated
- * `text` (viewers rebuild it from deltas), and an event over the per-event
- * cap keeps only its envelope, marked `liveTruncated`.
+ * `text` (viewers rebuild it from deltas). An event over the per-event cap
+ * keeps its envelope and `data` with long strings shortened, marked
+ * `liveTruncated`; when even that is too large, `data` keeps only the fields
+ * viewers need to place the event.
  */
 export function toSessionLiveWire(event) {
     let wire = event;
@@ -58,20 +110,31 @@ export function toSessionLiveWire(event) {
             wire = { ...wire, data: rest };
         }
     }
-    const serialized = JSON.stringify(wire);
-    const bytes = utf8Bytes(serialized);
+    const bytes = utf8Bytes(JSON.stringify(wire));
     if (bytes <= SESSION_LIVE_MAX_EVENT_BYTES) {
         return { wire, bytes };
     }
-    const stub = { index: event.index, type: event.type };
+    for (const maxChars of LIVE_TRUNCATION_STEPS) {
+        const candidate = {
+            ...wire,
+            data: truncateStrings(wire.data, maxChars),
+            liveTruncated: true,
+        };
+        const candidateBytes = utf8Bytes(JSON.stringify(candidate));
+        if (candidateBytes <= SESSION_LIVE_MAX_EVENT_BYTES) {
+            return { wire: candidate, bytes: candidateBytes };
+        }
+    }
+    const minimal = { index: event.index, type: event.type };
     if (typeof event.at === "string")
-        stub.at = event.at;
+        minimal.at = event.at;
     if (typeof event.turnId === "string")
-        stub.turnId = event.turnId;
+        minimal.turnId = event.turnId;
     if (typeof event.sessionId === "string")
-        stub.sessionId = event.sessionId;
-    stub.liveTruncated = true;
-    return { wire: stub, bytes: utf8Bytes(JSON.stringify(stub)) };
+        minimal.sessionId = event.sessionId;
+    minimal.data = identityData(wire.data);
+    minimal.liveTruncated = true;
+    return { wire: minimal, bytes: utf8Bytes(JSON.stringify(minimal)) };
 }
 export function createSessionLivePublisher(options) {
     const now = options.now ?? Date.now;

package/dist/internal/testing/conversation-identity-vectors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Logical resources shared by the July and control-plane conversation
+ * identity suites. Each vector exercises both claim minting and mailbox
+ * extraction for one typed conversation.
+ *
+ * Pure data: server-shared loads this module without importing July runtime
+ * code into the control plane.
+ */
+type RepoNumberClaim = {
+    type: "pr" | "issue" | "origin-pr" | "gitlab-mr" | "bitbucket-pr";
+    resource: {
+        fullName: string;
+        number: number;
+    };
+};
+type ConversationIdentityClaim = RepoNumberClaim | {
+    type: "thread";
+    resource: {
+        channelId: string;
+        threadTs: string;
+    };
+} | {
+    type: "deployment";
+    resource: {
+        deploymentId: string;
+    };
+} | {
+    type: "change-monitor-checkpoint";
+    resource: {
+        checkpointName: string;
+    };
+} | {
+    type: "factory-issue";
+    resource: {
+        issueName: string;
+    };
+};
+export type ConversationIdentityVector = {
+    name: string;
+    kind: "github" | "slack" | "origin" | "gitlab" | "bitbucket" | "deployments" | "change_monitors" | "issues";
+    claim: ConversationIdentityClaim;
+    eventName: string;
+    payload: Record<string, unknown>;
+    expectedKey: string;
+};
+export declare const CONVERSATION_IDENTITY_VECTORS: readonly ConversationIdentityVector[];
+export {};
+//# sourceMappingURL=conversation-identity-vectors.d.ts.map

package/dist/internal/testing/conversation-identity-vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-identity-vectors.d.ts","sourceRoot":"","sources":["../../../src/internal/testing/conversation-identity-vectors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;IAClE,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,KAAK,yBAAyB,GAC1B,eAAe,GACf;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CAAC;AAEN,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,QAAQ,CAAC;IACb,KAAK,EAAE,yBAAyB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,SAAS,0BAA0B,EA+H9E,CAAC"}

package/dist/internal/testing/conversation-identity-vectors.js

@@ -0,0 +1,136 @@
+/**
+ * Logical resources shared by the July and control-plane conversation
+ * identity suites. Each vector exercises both claim minting and mailbox
+ * extraction for one typed conversation.
+ *
+ * Pure data: server-shared loads this module without importing July runtime
+ * code into the control plane.
+ */
+export const CONVERSATION_IDENTITY_VECTORS = [
+    {
+        name: "GitHub pull request",
+        kind: "github",
+        claim: {
+            type: "pr",
+            resource: { fullName: "Acme/Widgets", number: 12 },
+        },
+        eventName: "pull_request",
+        payload: {
+            repository: { full_name: "Acme/Widgets" },
+            pull_request: { number: 12 },
+        },
+        expectedKey: "cont:github-pr:Acme/Widgets#12",
+    },
+    {
+        name: "GitHub issue",
+        kind: "github",
+        claim: {
+            type: "issue",
+            resource: { fullName: "Acme/Widgets", number: 34 },
+        },
+        eventName: "issues",
+        payload: {
+            repository: { full_name: "Acme/Widgets" },
+            issue: { number: 34 },
+        },
+        expectedKey: "cont:github-issue:Acme/Widgets#34",
+    },
+    {
+        name: "Slack thread",
+        kind: "slack",
+        claim: {
+            type: "thread",
+            resource: { channelId: "C123", threadTs: "1719.000" },
+        },
+        eventName: "message",
+        payload: {
+            type: "event_callback",
+            event: {
+                type: "message",
+                channel: "C123",
+                ts: "1720.000",
+                thread_ts: "1719.000",
+            },
+        },
+        expectedKey: "cont:C123:1719.000",
+    },
+    {
+        name: "Origin pull request",
+        kind: "origin",
+        claim: {
+            type: "origin-pr",
+            resource: { fullName: "Acme/Widgets", number: 42 },
+        },
+        eventName: "pull_request.created",
+        payload: {
+            pullRequest: { number: 42 },
+            repository: { name: "Widgets", owner: { slug: "Acme" } },
+        },
+        expectedKey: "cont:origin-pr:Acme/Widgets#42",
+    },
+    {
+        name: "GitLab merge request",
+        kind: "gitlab",
+        claim: {
+            type: "gitlab-mr",
+            resource: { fullName: "Acme/Platform/API", number: 56 },
+        },
+        eventName: "merge_request",
+        payload: {
+            project: { path_with_namespace: "Acme/Platform/API" },
+            object_attributes: { iid: 56 },
+        },
+        expectedKey: "cont:gitlab-mr:acme/platform/api!56",
+    },
+    {
+        name: "Bitbucket pull request",
+        kind: "bitbucket",
+        claim: {
+            type: "bitbucket-pr",
+            resource: { fullName: "ACME/Widgets", number: 78 },
+        },
+        eventName: "pullrequest:created",
+        payload: {
+            repository: { full_name: "ACME/Widgets" },
+            pullrequest: { id: 78 },
+        },
+        expectedKey: "cont:bitbucket-pr:acme/widgets#78",
+    },
+    {
+        name: "deployment",
+        kind: "deployments",
+        claim: {
+            type: "deployment",
+            resource: { deploymentId: "dep-90" },
+        },
+        eventName: "deployment.created",
+        payload: { deploymentId: "dep-90" },
+        expectedKey: "cont:deployments:dep-90",
+    },
+    {
+        name: "change monitor checkpoint",
+        kind: "change_monitors",
+        claim: {
+            type: "change-monitor-checkpoint",
+            resource: {
+                checkpointName: "changeMonitors/cm-1/checkpoints/cp-2",
+            },
+        },
+        eventName: "checkpoint.created",
+        payload: {
+            checkpoint: { name: "changeMonitors/cm-1/checkpoints/cp-2" },
+        },
+        expectedKey: "cont:change_monitors:changeMonitors/cm-1/checkpoints/cp-2",
+    },
+    {
+        name: "factory issue",
+        kind: "issues",
+        claim: {
+            type: "factory-issue",
+            resource: { issueName: "issues/iss-3" },
+        },
+        eventName: "issue.created",
+        payload: { issue: { name: "issues/iss-3" } },
+        expectedKey: "cont:issues:issues/iss-3",
+    },
+];