@cursor/sdk 1.0.7

package/dist/esm/run-interaction-accumulator.d.ts

@@ -0,0 +1,32 @@
+import type { SDKMessage } from "./messages.js";
+import type { ConversationStep, ConversationTurn } from "./types/conversation-types.js";
+import type { InteractionUpdate } from "./types/delta-types.js";
+export interface RunInteractionAccumulatorOptions {
+    onStep?: (args: {
+        step: ConversationStep;
+    }) => void | Promise<void>;
+    onDelta?: (args: {
+        update: InteractionUpdate;
+    }) => void | Promise<void>;
+}
+export declare class RunInteractionAccumulator {
+    private readonly options;
+    private readonly turns;
+    private currentTurn;
+    private lastFiredStepIndex;
+    constructor(options?: RunInteractionAccumulatorOptions);
+    conversation(): ConversationTurn[];
+    apply(update: InteractionUpdate): Promise<void>;
+    flushPendingStep(): Promise<void>;
+    private ensureCurrentTurn;
+    private mergeIntoConversation;
+    private onUserMessage;
+    private onTextDelta;
+    private onThinkingDelta;
+    private onThinkingCompleted;
+    private onTool;
+    private didPreviousStepComplete;
+}
+export declare function accumulateSdkMessageStream(stream: AsyncIterable<SDKMessage>): Promise<ConversationTurn[]>;
+export declare function sdkMessageToInteractionUpdate(message: SDKMessage): InteractionUpdate | undefined;
+//# sourceMappingURL=run-interaction-accumulator.d.ts.map

package/dist/esm/run-interaction-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-interaction-accumulator.d.ts","sourceRoot":"","sources":["../../src/agent/run-interaction-accumulator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAGV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,iBAAiB,EAMlB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,WAAW,gCAAgC;IAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,qBAAa,yBAAyB;IAMlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,kBAAkB,CAAM;gBAGb,OAAO,GAAE,gCAAqC;IAGjE,YAAY,IAAI,gBAAgB,EAAE;IAI5B,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcvC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,uBAAuB;CA4BhC;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAU7B;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,UAAU,GAClB,iBAAiB,GAAG,SAAS,CA8C/B"}

package/dist/esm/run.d.ts

@@ -0,0 +1,44 @@
+import type { SDKMessage } from "./messages.js";
+import type { ModelSelection } from "./options.js";
+import type { ConversationTurn } from "./types/conversation-types.js";
+export type RunStatus = "running" | "finished" | "error" | "cancelled";
+export type RunResultStatus = Exclude<RunStatus, "running">;
+export type RunOperation = "stream" | "wait" | "cancel" | "conversation";
+export declare class UnsupportedRunOperationError extends Error {
+    readonly operation: RunOperation;
+    constructor(operation: RunOperation, reason?: string);
+}
+export interface RunGitBranchInfo {
+    repoUrl: string;
+    branch?: string;
+    prUrl?: string;
+}
+export interface RunGitInfo {
+    branches: RunGitBranchInfo[];
+}
+export interface RunResult {
+    id: string;
+    status: RunResultStatus;
+    result?: string;
+    model?: ModelSelection;
+    durationMs?: number;
+    git?: RunGitInfo;
+}
+export interface Run {
+    readonly id: string;
+    readonly agentId: string;
+    supports(operation: RunOperation): boolean;
+    unsupportedReason(operation: RunOperation): string | undefined;
+    stream(): AsyncGenerator<SDKMessage, void>;
+    conversation(): Promise<ConversationTurn[]>;
+    wait(): Promise<RunResult>;
+    cancel(): Promise<void>;
+    readonly status: RunStatus;
+    onDidChangeStatus(listener: (status: RunStatus) => void): () => void;
+    readonly result?: string;
+    readonly model?: ModelSelection;
+    readonly durationMs?: number;
+    readonly git?: RunGitInfo;
+    readonly createdAt?: number;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/esm/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/agent/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEzE,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;gBAErB,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM;CAKrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC;IAC3C,iBAAiB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/D,MAAM,IAAI,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3C,YAAY,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,iBAAiB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/esm/stubs.d.ts

@@ -0,0 +1,95 @@
+import type { AgentMessage, AgentOperationOptions, CursorRequestOptions, GetAgentMessagesOptions, GetAgentOptions, GetRunOptions, ListAgentsOptions, ListResult, ListRunsOptions, SDKAgent, SDKAgentInfo, SDKModel, SDKRepository, SDKUser, SendOptions } from "./agent.js";
+import type { SDKArtifact } from "./artifacts.js";
+import type { SDKMessage } from "./messages.js";
+import type { AgentOptions, SDKUserMessage } from "./options.js";
+import type { Run, RunOperation, RunResult, RunStatus } from "./run.js";
+import type { ConversationTurn } from "./types/conversation-types.js";
+export declare function createUnimplementedError(apiName: string): Error;
+export declare class UnimplementedRun implements Run {
+    readonly id = "unimplemented-run";
+    readonly agentId = "unimplemented-agent";
+    readonly result: undefined;
+    readonly model: undefined;
+    readonly durationMs: undefined;
+    readonly git: undefined;
+    supports(_operation: RunOperation): boolean;
+    unsupportedReason(operation: RunOperation): string | undefined;
+    stream(): AsyncGenerator<SDKMessage, void>;
+    conversation(): Promise<ConversationTurn[]>;
+    wait(): Promise<RunResult>;
+    cancel(): Promise<void>;
+    get status(): RunStatus;
+    onDidChangeStatus(_listener: (status: RunStatus) => void): () => void;
+}
+export declare class UnimplementedAgent implements SDKAgent {
+    readonly agentId = "unimplemented-agent";
+    send(_message: string | SDKUserMessage, _options?: SendOptions): Promise<Run>;
+    close(): void;
+    reload(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    listArtifacts(): Promise<SDKArtifact[]>;
+    downloadArtifact(_path: string): Promise<Buffer>;
+}
+export declare class Agent {
+    private constructor();
+    /**
+     * Create an agent instance.
+     */
+    static create(options: AgentOptions): SDKAgent;
+    /**
+     * Resume an existing agent by ID.
+     */
+    static resume(agentId: string, options?: Partial<AgentOptions>): SDKAgent;
+    /**
+     * Convenience API to create an agent, run one prompt, and close.
+     */
+    static prompt(message: string, options?: AgentOptions): Promise<RunResult>;
+    static list(options?: ListAgentsOptions): Promise<ListResult<SDKAgentInfo>>;
+    static listRuns(agentId: string, options?: ListRunsOptions): Promise<ListResult<Run>>;
+    static getRun(runId: string, options?: GetRunOptions): Promise<Run>;
+    /**
+     * Fetch a single agent's metadata by ID. Cloud-only — local agent lookup
+     * is a post-launch followup.
+     */
+    static get(agentId: string, options?: GetAgentOptions): Promise<SDKAgentInfo>;
+    /**
+     * Archive an agent. Cloud-only.
+     */
+    static archive(agentId: string, options?: AgentOperationOptions): Promise<void>;
+    /**
+     * Unarchive a previously archived agent. Cloud-only.
+     */
+    static unarchive(agentId: string, options?: AgentOperationOptions): Promise<void>;
+    /**
+     * Delete an agent. Cloud-only and irreversible.
+     */
+    static delete(agentId: string, options?: AgentOperationOptions): Promise<void>;
+    static readonly messages: {
+        list(agentId: string, options?: GetAgentMessagesOptions): Promise<AgentMessage[]>;
+    };
+}
+/**
+ * Account and platform-level operations. Namespaced separately from `Agent`
+ * because these concerns (the calling user, available models, connected
+ * repositories) aren't scoped to a specific agent.
+ */
+export declare class Cursor {
+    private constructor();
+    /**
+     * Get metadata about the authenticated user / API key.
+     */
+    static me(options?: CursorRequestOptions): Promise<SDKUser>;
+    /**
+     * List models available to the authenticated user.
+     */
+    static readonly models: {
+        list(options?: CursorRequestOptions): Promise<SDKModel[]>;
+    };
+    /**
+     * List GitHub repositories the authenticated user has connected to Cursor.
+     */
+    static readonly repositories: {
+        list(options?: CursorRequestOptions): Promise<SDKRepository[]>;
+    };
+}
+//# sourceMappingURL=stubs.d.ts.map

package/dist/esm/stubs.d.ts.map

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

package/dist/esm/subagent-conversion.d.ts

@@ -0,0 +1,9 @@
+import type { V1CustomSubagent } from "./cloud-api-client.js";
+import type { AgentDefinition } from "./options.js";
+/**
+ * Convert SDK `AgentOptions.agents` to the `V1CustomSubagent[]` shape the
+ * cloud API expects. Inline `McpServerConfig` entries on a subagent are
+ * rejected; v1 cloud subagents inherit the parent agent's MCP config.
+ */
+export declare function convertAgentDefinitionsToV1CustomSubagents(agents: Record<string, AgentDefinition> | undefined): V1CustomSubagent[] | undefined;
+//# sourceMappingURL=subagent-conversion.d.ts.map

package/dist/esm/subagent-conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-conversion.d.ts","sourceRoot":"","sources":["../../src/agent/subagent-conversion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,GAClD,gBAAgB,EAAE,GAAG,SAAS,CAqChC"}

package/dist/esm/tool-call-utils.d.ts

@@ -0,0 +1,7 @@
+export type ToolPayloadTruncated = {
+    args?: boolean;
+    result?: boolean;
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isToolPayloadTruncated(value: unknown): value is ToolPayloadTruncated;
+//# sourceMappingURL=tool-call-utils.d.ts.map

package/dist/esm/tool-call-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-utils.d.ts","sourceRoot":"","sources":["../../src/agent/tool-call-utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAQ/B"}