@cursor/bdk 0.2.1

package/dist/channels/bitbucket/state.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Durable per-session Bitbucket channel state, persisted with the turn so
+ * channel stream-event handlers can rebuild a repo-bound handle without
+ * re-parsing the webhook.
+ */
+import type { BitbucketDialect } from "./types.js";
+export interface BitbucketChannelState {
+    dialect: BitbucketDialect | null;
+    /** `workspace/repo` (Cloud) or `PROJECT/repo` (Data Center), as delivered. */
+    repoFullName: string;
+    /** Cloud `repository.uuid` (braces included) when known. */
+    repoUuid: string | null;
+    pullRequestId: number | null;
+    /** Source-branch head at dispatch time, when known. */
+    headSha: string | null;
+    /** Comment id that woke the turn (comment events only). */
+    triggeringCommentId: number | null;
+    deliveryId: string | null;
+    /** Cloud-normalized event key. */
+    eventType: string | null;
+}
+export declare function emptyBitbucketChannelState(overrides?: Partial<BitbucketChannelState>): BitbucketChannelState;
+export declare function bitbucketChannelStateForEvent(input: {
+    repository: {
+        dialect: BitbucketDialect;
+        fullName: string;
+        uuid?: string;
+    };
+    pullRequestId?: number;
+    headSha?: string;
+    deliveryId?: string;
+    eventType: string;
+    triggeringCommentId?: number;
+}): BitbucketChannelState;
+//# sourceMappingURL=state.d.ts.map

package/dist/channels/bitbucket/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/channels/bitbucket/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAC7C,qBAAqB,CAYvB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,UAAU,EAAE;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,qBAAqB,CAWxB"}

package/dist/channels/bitbucket/state.js

@@ -0,0 +1,21 @@
+/**
+ * Durable per-session Bitbucket channel state, persisted with the turn so
+ * channel stream-event handlers can rebuild a repo-bound handle without
+ * re-parsing the webhook.
+ */
+export function emptyBitbucketChannelState(overrides = {}) {
+    return Object.assign({ dialect: null, repoFullName: "", repoUuid: null, pullRequestId: null, headSha: null, triggeringCommentId: null, deliveryId: null, eventType: null }, overrides);
+}
+export function bitbucketChannelStateForEvent(input) {
+    var _a, _b, _c, _d, _e;
+    return emptyBitbucketChannelState({
+        dialect: input.repository.dialect,
+        repoFullName: input.repository.fullName,
+        repoUuid: (_a = input.repository.uuid) !== null && _a !== void 0 ? _a : null,
+        pullRequestId: (_b = input.pullRequestId) !== null && _b !== void 0 ? _b : null,
+        headSha: (_c = input.headSha) !== null && _c !== void 0 ? _c : null,
+        triggeringCommentId: (_d = input.triggeringCommentId) !== null && _d !== void 0 ? _d : null,
+        deliveryId: (_e = input.deliveryId) !== null && _e !== void 0 ? _e : null,
+        eventType: input.eventType,
+    });
+}

package/dist/channels/bitbucket/types.d.ts

@@ -0,0 +1,227 @@
+import type { ContinuationIdentity } from "../../internal/continuation-identity.js";
+import type { AgentCloudOptions, ArtifactsApi, AuthContext, AuthPolicy, ChannelEventHandlers, ChannelStartArgs, HostContext, SendMessageFn } from "../../types.js";
+import type { BitbucketTokenProvider } from "./api.js";
+import type { BitbucketHandle } from "./binding.js";
+import type { BitbucketChannelState } from "./state.js";
+/**
+ * Which Bitbucket sent the payload. Cloud bodies carry `pullrequest` and
+ * `repository.uuid`; Data Center bodies carry `pullRequest` and
+ * `repository.project.key`.
+ */
+export type BitbucketDialect = "cloud" | "data-center";
+export interface BitbucketUser {
+    /** Cloud `uuid` (braces included) or Data Center numeric `id`. */
+    id: string;
+    displayName?: string;
+    /** Cloud `nickname` / Data Center `name`. */
+    username?: string;
+}
+export interface BitbucketRepositoryRef {
+    dialect: BitbucketDialect;
+    /**
+     * `workspace/repo` (Cloud) or `PROJECT/repo` (Data Center), as delivered.
+     * Continuation keys lowercase it; consumers should too when comparing.
+     */
+    fullName: string;
+    /** Workspace slug (Cloud) or project key (Data Center). */
+    owner: string;
+    slug: string;
+    /** Cloud `repository.uuid` (braces included). */
+    uuid?: string;
+    /** Data Center numeric repository id. */
+    id?: number;
+    /** Web URL when the payload carries one. */
+    htmlUrl?: string;
+}
+/** A pull request normalized from either dialect. */
+export interface BitbucketPullRequestEvent {
+    /**
+     * Cloud-normalized action: `created`, `updated`, `approved`, `unapproved`,
+     * `changes_request_created`, `fulfilled`, `rejected`.
+     */
+    action: string;
+    id: number;
+    title?: string;
+    description?: string | null;
+    /** `OPEN`, `MERGED`, `DECLINED`, `SUPERSEDED`. */
+    state?: string;
+    draft?: boolean;
+    sourceBranch?: string;
+    targetBranch?: string;
+    /** Source-branch head: Cloud `source.commit.hash` / DC `fromRef.latestCommit`. */
+    headSha?: string;
+    /** DC `previousFromHash` on `pr:from_ref_updated` — new commits were pushed. */
+    previousHeadSha?: string;
+    author?: BitbucketUser;
+    htmlUrl?: string;
+}
+export interface BitbucketPullRequestComment {
+    id: number;
+    body: string;
+    author?: BitbucketUser;
+    htmlUrl?: string;
+    /** Cloud `comment.inline` when the comment is anchored to a file. */
+    inline?: {
+        path?: string;
+        to?: number;
+        from?: number;
+    };
+}
+export interface BitbucketPushChange {
+    ref?: string;
+    /** Branch / tag name. */
+    name?: string;
+    before?: string;
+    after?: string;
+    type?: string;
+}
+export interface BitbucketPush {
+    changes: BitbucketPushChange[];
+}
+export interface BitbucketEventContext {
+    /** `X-Request-UUID` (Cloud) / `X-Request-Id` (DC), when present. */
+    deliveryId?: string;
+    /** Cloud-normalized event key (`pullrequest:created`, `repo:push`, …). */
+    eventType: string;
+    /** Raw `X-Event-Key` as delivered (DC keys before normalization). */
+    rawEventType: string;
+    repository: BitbucketRepositoryRef;
+    pullRequestId?: number;
+    pullRequestUrl?: string;
+    /** Raw parsed payload record, for consumers whose normalization needs more. */
+    payload: Record<string, unknown>;
+    /** `actor` on the payload — who triggered the delivery. */
+    sender?: BitbucketUser;
+    /**
+     * Repo-bound Bitbucket API (`api`, `request`, `setBuildStatus`,
+     * `createCheck`) in the delivery's dialect. Routes through the Cursor SCM
+     * proxy under `cursorAccount` + `--cursor-scm-proxy`; otherwise uses
+     * {@link BitbucketChannelOptions.token} / `BITBUCKET_TOKEN` against the
+     * dialect's API base.
+     */
+    bitbucket: BitbucketHandle;
+    /**
+     * Channel `send`. Set on every delivery path (HTTP webhook, hosted
+     * admission) so a hook can start a turn itself instead of returning
+     * `{ auth, message }` or a deferred `{ task }`.
+     */
+    send?: SendMessageFn;
+    host: HostContext;
+    artifacts: ArtifactsApi;
+}
+export type BitbucketTurnDispatch = {
+    auth: AuthContext;
+    message?: string;
+    title?: string;
+    context?: readonly string[];
+};
+/** Bound per-delivery helpers passed to a {@link BitbucketTaskDispatch.task}. */
+export interface BitbucketTaskArgs {
+    send: SendMessageFn;
+    waitUntil: (promise: Promise<unknown>) => void;
+}
+/** Run a host-side handler after the webhook is acknowledged with a 202. */
+export type BitbucketTaskDispatch = {
+    task: (args: BitbucketTaskArgs) => void | Promise<void>;
+};
+export type BitbucketDispatch = BitbucketTurnDispatch | BitbucketTaskDispatch;
+export type BitbucketDispatchResult = BitbucketDispatch | null | Promise<BitbucketDispatch | null>;
+export type BitbucketPullRequestHook = (ctx: BitbucketEventContext, pullRequest: BitbucketPullRequestEvent) => BitbucketDispatchResult;
+export type BitbucketPullRequestCommentHook = (ctx: BitbucketEventContext, comment: BitbucketPullRequestComment, pullRequest: BitbucketPullRequestEvent) => BitbucketDispatchResult;
+export type BitbucketPushHook = (ctx: BitbucketEventContext, push: BitbucketPush) => BitbucketDispatchResult;
+export type BitbucketEventHook = (ctx: BitbucketEventContext, event: {
+    eventType: string;
+    rawEventType: string;
+    payload: unknown;
+}) => BitbucketDispatchResult;
+export type BitbucketCloudOptionsResolver = (ctx: BitbucketEventContext, pullRequest: BitbucketPullRequestEvent) => AgentCloudOptions | undefined | Promise<AgentCloudOptions | undefined>;
+/** One verified Bitbucket delivery handed to {@link dispatchBitbucketWebhook}. */
+export interface BitbucketWebhookDelivery {
+    /** Cloud-normalized event key (hosted admission passes the envelope's). */
+    eventType: string;
+    /** `X-Event-Key` as delivered. Defaults to {@link eventType}. */
+    rawEventType?: string;
+    payload: Record<string, unknown>;
+    deliveryId?: string;
+}
+export interface BitbucketChannelOptions {
+    /**
+     * Use the signed-in Cursor account for inbound Bitbucket events delivered
+     * by the Cursor backend. `true` takes repo scope from the deployment;
+     * `{ repos }` (`workspace/repo` or `PROJECT/repo`) makes the channel
+     * self-contained.
+     */
+    cursorAccount?: boolean | {
+        repos: readonly string[];
+    };
+    /**
+     * Access token (or provider) for direct `ctx.bitbucket` calls when not in
+     * proxy mode. Sent as `Authorization: Bearer`. Falls back to
+     * `BITBUCKET_TOKEN`.
+     */
+    token?: string | BitbucketTokenProvider;
+    /**
+     * REST base for direct `ctx.bitbucket` calls. Defaults to
+     * `BITBUCKET_API_BASE_URL`, else api.bitbucket.org 2.0 (Cloud). Data
+     * Center deploys must set one of these; the payload's repository link is
+     * never used to pick where the token is sent.
+     */
+    apiBaseUrl?: string;
+    /**
+     * Webhook secret for direct HTTP deliveries: `X-Hub-Signature`
+     * `sha256=<hmac>` over the raw body (both dialects). Falls back to
+     * `BITBUCKET_WEBHOOK_SECRET`. With a secret set the HMAC is the request
+     * auth; without one production stays loopback-strict and `serve --dev`
+     * admits unsigned loopback deliveries.
+     */
+    webhookSecret?: string | (() => string | undefined);
+    /**
+     * Optional repo allowlist (`workspace/repo` / `PROJECT/repo`,
+     * case-insensitive). Events from other repos are acked without a turn.
+     */
+    repos?: readonly string[];
+    /** Route auth chain; defaults follow {@link webhookSecret}. */
+    auth?: AuthPolicy[];
+    /** Route path under `/v1/channels/<name>`. Defaults to `/`. */
+    path?: string;
+    /**
+     * Pin the event keys this channel dispatches on (Cloud vocabulary; DC keys
+     * are normalized). Published as `meta.bitbucketWebhookEvents`. Defaults to
+     * the set derived from hooks.
+     */
+    webhookEvents?: readonly string[];
+    /**
+     * Continuation selector. Omit this to inherit the agent architecture's
+     * default. Set it explicitly only when migrating persisted identities.
+     */
+    continuation?: ContinuationIdentity;
+    /**
+     * Decide whether an inbound pull-request event starts a turn. Return
+     * `{ auth: defaultBitbucketAuth(ctx) }` to dispatch, `null` to ignore.
+     * Without this hook the channel dispatches on `created` and on `updated`
+     * that pushed commits (Data Center `previousFromHash` differs from the
+     * head; Cloud `pullrequest:updated` carries no diff and is not dispatched).
+     */
+    onPullRequest?: BitbucketPullRequestHook;
+    /** Opt-in `pullrequest:comment_created` handler. */
+    onPullRequestComment?: BitbucketPullRequestCommentHook;
+    /** Opt-in `repo:push` handler. No default dispatch. */
+    onPush?: BitbucketPushHook;
+    /**
+     * Catch-all for event keys without a typed hook (`repo:fork`,
+     * `issue:created`, …). NOT a fallback: typed events never reach it.
+     */
+    onEvent?: BitbucketEventHook;
+    /**
+     * Per-session cloud options. Pass `true` to attach the repo using the
+     * pull request's web URL, or a resolver for custom cloud options.
+     */
+    cloud?: boolean | AgentCloudOptions | BitbucketCloudOptionsResolver;
+    /** Channel stream-event handlers. */
+    events?: ChannelEventHandlers<BitbucketChannelState>;
+    /** Called once when the server mounts this channel. */
+    onStart?: (args: ChannelStartArgs) => void | Promise<void>;
+    /** Called when the server shuts down. */
+    onStop?: () => void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/bitbucket/types.d.ts.map

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

package/dist/channels/bitbucket/types.js

@@ -0,0 +1 @@
+export {};

package/dist/channels/change-monitors/change-monitors-channel.d.ts

@@ -0,0 +1,5 @@
+import type { ChannelDefinition } from "../../types.js";
+import { type ChangeMonitorsChannelOptions } from "./types.js";
+export declare function changeMonitorsChannel(options: ChangeMonitorsChannelOptions): ChannelDefinition;
+export declare function getChangeMonitorsChannelOptions(definition: object): ChangeMonitorsChannelOptions | undefined;
+//# sourceMappingURL=change-monitors-channel.d.ts.map

package/dist/channels/change-monitors/change-monitors-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-monitors-channel.d.ts","sourceRoot":"","sources":["../../../src/channels/change-monitors/change-monitors-channel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAEL,KAAK,4BAA4B,EAElC,MAAM,YAAY,CAAC;AA+CpB,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,iBAAiB,CAE9F;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,GACjB,4BAA4B,GAAG,SAAS,CAE1C"}

package/dist/channels/change-monitors/change-monitors-channel.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { createFactoryResourceChannel } from "../../internal/factory-resource-channel.js";
+import { CHECKPOINT_CREATED_EVENT_TYPE, } from "./types.js";
+const checkpointResourceSchema = z
+    .object({
+    name: z.string().min(1),
+    deployment: z.string().min(1),
+    runKey: z.string().min(1),
+    evidenceSummary: z.string().min(1),
+    planRevision: z.string().optional(),
+    createTime: z.string().min(1).optional(),
+    description: z.string().optional(),
+    clear: z.object({}).passthrough().optional(),
+    issues: z
+        .object({ title: z.string().min(1) })
+        .passthrough()
+        .optional(),
+    inconclusive: z.object({}).passthrough().optional(),
+    deferred: z
+        .object({ reason: z.string().min(1) })
+        .passthrough()
+        .optional(),
+})
+    .passthrough()
+    .refine(checkpoint => [checkpoint.clear, checkpoint.issues, checkpoint.inconclusive, checkpoint.deferred].filter(arm => arm !== undefined).length === 1, { message: "checkpoint must have exactly one result arm" });
+const checkpointCreatedEventSchema = z.object({
+    eventId: z.string().min(1),
+    eventType: z.literal(CHECKPOINT_CREATED_EVENT_TYPE),
+    teamId: z.string().min(1),
+    occurredAtMs: z.number().int().nonnegative(),
+    checkpoint: checkpointResourceSchema,
+});
+const pack = createFactoryResourceChannel({
+    kind: "change_monitors",
+    eventTypes: [CHECKPOINT_CREATED_EVENT_TYPE],
+    eventSchema: checkpointCreatedEventSchema,
+    replayDescription: "Replay a Change Monitor checkpoint-created event.",
+    invalidError: "invalid change-monitor checkpoint event",
+});
+export function changeMonitorsChannel(options) {
+    return pack.channel(options);
+}
+export function getChangeMonitorsChannelOptions(definition) {
+    return pack.getOptions(definition);
+}

package/dist/channels/change-monitors/index.d.ts

@@ -0,0 +1,4 @@
+export { changeMonitorsChannel } from "./change-monitors-channel.js";
+export type { ChangeMonitorsChannelOptions, CheckpointCreatedEvent, CheckpointCreatedEventType, CheckpointResource, } from "./types.js";
+export { CHECKPOINT_CREATED_EVENT_TYPE } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/change-monitors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/change-monitors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EACV,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC"}

package/dist/channels/change-monitors/index.js

@@ -0,0 +1,2 @@
+export { changeMonitorsChannel } from "./change-monitors-channel.js";
+export { CHECKPOINT_CREATED_EVENT_TYPE } from "./types.js";

package/dist/channels/change-monitors/types.d.ts

@@ -0,0 +1,42 @@
+import type { ContinuationIdentity } from "../../internal/continuation-identity.js";
+import type { ChannelDefinition, ChannelHandlerArgs } from "../../types.js";
+export declare const CHECKPOINT_CREATED_EVENT_TYPE: "checkpoint.created";
+export type CheckpointCreatedEventType = typeof CHECKPOINT_CREATED_EVENT_TYPE;
+/**
+ * Factory Checkpoint JSON (camelCase proto JSON). Exactly one result arm is
+ * set: `clear`, `issues`, `inconclusive`, or `deferred`. The channel does not pre-filter.
+ */
+export type CheckpointResource = {
+    name: string;
+    deployment: string;
+    runKey: string;
+    evidenceSummary: string;
+    planRevision?: string;
+    createTime?: string;
+    description?: string;
+    clear?: Record<string, unknown>;
+    issues?: {
+        title: string;
+    };
+    inconclusive?: Record<string, unknown>;
+    deferred?: {
+        reason: string;
+    };
+};
+/** Factory `checkpoint.created` for every Change Monitor Checkpoint create. */
+export type CheckpointCreatedEvent = {
+    eventId: string;
+    eventType: CheckpointCreatedEventType;
+    teamId: string;
+    occurredAtMs: number;
+    checkpoint: CheckpointResource;
+};
+export type ChangeMonitorsChannelOptions = {
+    onEvent: (event: CheckpointCreatedEvent, args: ChannelHandlerArgs) => Promise<unknown> | unknown;
+    continuation?: ContinuationIdentity;
+    path?: string;
+    auth?: ChannelDefinition["auth"];
+    onStart?: ChannelDefinition["onStart"];
+    onStop?: ChannelDefinition["onStop"];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/change-monitors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channels/change-monitors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,eAAO,MAAM,6BAA6B,EAAG,oBAA6B,CAAC;AAE3E,MAAM,MAAM,0BAA0B,GAAG,OAAO,6BAA6B,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,0BAA0B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjG,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;CACtC,CAAC"}

package/dist/channels/change-monitors/types.js

@@ -0,0 +1 @@
+export const CHECKPOINT_CREATED_EVENT_TYPE = "checkpoint.created";

package/dist/channels/checks.d.ts

@@ -0,0 +1,121 @@
+/**
+ * CI checks, shared across SCMs.
+ *
+ * The check lifecycle lives here once: `openCiCheck` opens a run (defaults
+ * `in_progress`, stamps `startedAt`), the returned {@link CiCheck} handle
+ * patches it (`update`) and completes it (`conclude`, stamps `completedAt`),
+ * and `resumeCiCheck` rebuilds a handle after a restart. Each SCM plugs in
+ * with one {@link CiCheckWriter} — a function that persists a single desired
+ * check state on its API (GitHub Checks API create/patch, Origin's keyed
+ * upsert, …) and owns any transport state such as a server-assigned run id.
+ *
+ * Agent code should usually stay one level higher, on {@link CiChecksClient}:
+ * both `ctx.github` and `ctx.origin` satisfy it, so a check reporter written
+ * once works on either forge:
+ *
+ * ```ts
+ * async function reportCheck(checks: CiChecksClient, sha: string) {
+ *   const check = await checks.createCheck({ name: "My Agent", sha });
+ *   // …do the work…
+ *   await check.conclude({
+ *     conclusion: "success",
+ *     output: { title: "Done", summary: "All good." },
+ *   });
+ * }
+ * ```
+ *
+ * {@link CiCheckConclusion} is the common subset every SCM accepts; an SCM
+ * with extras widens it through the generic parameter (e.g. Origin's
+ * `CiCheck<CiCheckConclusion | "stale">`).
+ */
+/** Output shown on the check page. */
+export interface CiCheckOutput {
+    /** Heading on the check page. */
+    title: string;
+    /** Markdown body (supports links, e.g. `[View session](…)`). */
+    summary: string;
+    /** Optional detailed markdown body. */
+    text?: string;
+}
+export type CiCheckStatus = "queued" | "in_progress" | "completed";
+/** Final results accepted by every SCM. */
+export type CiCheckConclusion = "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "success" | "timed_out";
+export interface CiCheckUpdateInput<TConclusion extends string = CiCheckConclusion> {
+    status?: CiCheckStatus;
+    conclusion?: TConclusion;
+    detailsUrl?: string;
+    output?: CiCheckOutput;
+}
+export interface CiCheckConcludeInput<TConclusion extends string = CiCheckConclusion> {
+    /** Final result shown in the merge box. */
+    conclusion: TConclusion;
+    detailsUrl?: string;
+    output?: CiCheckOutput;
+}
+/** SCM-side reference to a check run, when the SCM reports one. */
+export interface CiCheckRef {
+    /** Server-assigned run id (GitHub check-run number, Origin `cr_…`). */
+    id?: number | string;
+    /** Web URL of the check run page. */
+    url?: string;
+}
+/** A created check run, whichever SCM it lives on. */
+export interface CiCheck<TConclusion extends string = CiCheckConclusion> {
+    /** Patch status / output / details link while the check is running. */
+    update(input: CiCheckUpdateInput<TConclusion>): Promise<void>;
+    /** Complete the check with a conclusion (stamps `completedAt`). */
+    conclude(input: CiCheckConcludeInput<TConclusion>): Promise<void>;
+}
+export interface CiCheckCreateInput {
+    /** Check name shown in the PR merge box, e.g. `"Cursor Security Review"`. */
+    name: string;
+    /** Commit the check attaches to (usually the PR head SHA). */
+    sha: string;
+    /**
+     * Check suite the check files under, on forges that have one. Origin
+     * renders every check as `suite / check` and groups the checks tab by
+     * suite, so name it after the posting app (GitHub groups an app's checks
+     * under the app); without it the suite mirrors the check name. GitHub,
+     * GitLab and Bitbucket have no app-named suite and ignore it.
+     */
+    suite?: {
+        name?: string;
+    };
+    /** Initial status. Defaults to `"in_progress"`. */
+    status?: "queued" | "in_progress";
+    /** "Details" link on the check, e.g. the agent session run URL. */
+    detailsUrl?: string;
+    /** Title + markdown summary shown on the check page. */
+    output?: CiCheckOutput;
+}
+/**
+ * Anything that can open a CI check on its bound repository — `ctx.github`,
+ * `ctx.origin`, or the `bindOriginChecks` adapter.
+ */
+export interface CiChecksClient<TConclusion extends string = CiCheckConclusion> {
+    createCheck(input: CiCheckCreateInput): Promise<CiCheck<TConclusion>>;
+}
+/** One desired check state for a writer to persist. */
+export interface CiCheckWrite<TConclusion extends string = CiCheckConclusion> extends CiCheckUpdateInput<TConclusion> {
+    startedAt?: string;
+    completedAt?: string;
+}
+/**
+ * The per-SCM extension point: persist one {@link CiCheckWrite} on the SCM
+ * (create-then-patch, keyed upsert, …). Bound to a repo + check identity at
+ * construction; owns transport state (e.g. the created run id) across calls.
+ * May return a {@link CiCheckRef} to expose on the handle.
+ */
+export type CiCheckWriter<TConclusion extends string = CiCheckConclusion> = (write: CiCheckWrite<TConclusion>) => Promise<CiCheckRef | undefined>;
+/**
+ * Open a check run through `writer` and return a handle for later updates.
+ * SCM modules wrap this (`createGitHubCheck`, `createOriginCheck`); channels
+ * expose it repo-bound as `ctx.github.createCheck` / `ctx.origin.createCheck`.
+ */
+export declare function openCiCheck<TConclusion extends string = CiCheckConclusion>(writer: CiCheckWriter<TConclusion>, input?: Pick<CiCheckCreateInput, "status" | "detailsUrl" | "output">): Promise<CiCheck<TConclusion> & CiCheckRef>;
+/**
+ * Rebuild a {@link CiCheck} handle around an existing run (e.g. after a
+ * process restart). No write happens until the first update.
+ */
+export declare function resumeCiCheck<TConclusion extends string = CiCheckConclusion>(writer: CiCheckWriter<TConclusion>, ref?: CiCheckRef): CiCheck<TConclusion> & CiCheckRef;
+//# sourceMappingURL=checks.d.ts.map

package/dist/channels/checks.d.ts.map

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

package/dist/channels/checks.js

@@ -0,0 +1,86 @@
+/**
+ * CI checks, shared across SCMs.
+ *
+ * The check lifecycle lives here once: `openCiCheck` opens a run (defaults
+ * `in_progress`, stamps `startedAt`), the returned {@link CiCheck} handle
+ * patches it (`update`) and completes it (`conclude`, stamps `completedAt`),
+ * and `resumeCiCheck` rebuilds a handle after a restart. Each SCM plugs in
+ * with one {@link CiCheckWriter} — a function that persists a single desired
+ * check state on its API (GitHub Checks API create/patch, Origin's keyed
+ * upsert, …) and owns any transport state such as a server-assigned run id.
+ *
+ * Agent code should usually stay one level higher, on {@link CiChecksClient}:
+ * both `ctx.github` and `ctx.origin` satisfy it, so a check reporter written
+ * once works on either forge:
+ *
+ * ```ts
+ * async function reportCheck(checks: CiChecksClient, sha: string) {
+ *   const check = await checks.createCheck({ name: "My Agent", sha });
+ *   // …do the work…
+ *   await check.conclude({
+ *     conclusion: "success",
+ *     output: { title: "Done", summary: "All good." },
+ *   });
+ * }
+ * ```
+ *
+ * {@link CiCheckConclusion} is the common subset every SCM accepts; an SCM
+ * with extras widens it through the generic parameter (e.g. Origin's
+ * `CiCheck<CiCheckConclusion | "stale">`).
+ */
+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());
+    });
+};
+/**
+ * Open a check run through `writer` and return a handle for later updates.
+ * SCM modules wrap this (`createGitHubCheck`, `createOriginCheck`); channels
+ * expose it repo-bound as `ctx.github.createCheck` / `ctx.origin.createCheck`.
+ */
+export function openCiCheck(writer, input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const ref = yield writer({
+            status: (_a = input === null || input === void 0 ? void 0 : input.status) !== null && _a !== void 0 ? _a : "in_progress",
+            startedAt: new Date().toISOString(),
+            detailsUrl: input === null || input === void 0 ? void 0 : input.detailsUrl,
+            output: input === null || input === void 0 ? void 0 : input.output,
+        });
+        return resumeCiCheck(writer, ref);
+    });
+}
+/**
+ * Rebuild a {@link CiCheck} handle around an existing run (e.g. after a
+ * process restart). No write happens until the first update.
+ */
+export function resumeCiCheck(writer, ref) {
+    let id = ref === null || ref === void 0 ? void 0 : ref.id;
+    let url = ref === null || ref === void 0 ? void 0 : ref.url;
+    const write = (write) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const next = yield writer(write);
+        id = (_a = next === null || next === void 0 ? void 0 : next.id) !== null && _a !== void 0 ? _a : id;
+        url = (_b = next === null || next === void 0 ? void 0 : next.url) !== null && _b !== void 0 ? _b : url;
+    });
+    return {
+        get id() {
+            return id;
+        },
+        get url() {
+            return url;
+        },
+        update: update => write(Object.assign(Object.assign({}, update), { completedAt: update.status === "completed" ? new Date().toISOString() : undefined })),
+        conclude: conclude => write({
+            status: "completed",
+            conclusion: conclude.conclusion,
+            completedAt: new Date().toISOString(),
+            detailsUrl: conclude.detailsUrl,
+            output: conclude.output,
+        }),
+    };
+}