@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/types/chat-channels.d.ts

@@ -0,0 +1,402 @@
+/** Provider-neutral contracts for Paperclip's native external chat subsystem. */
+export declare const CHAT_PROVIDERS: readonly ["slack", "github", "discord", "microsoft-teams", "telegram", "agentmail", "imessage-photon"];
+export type ChatProvider = (typeof CHAT_PROVIDERS)[number];
+export declare const CHAT_ENDPOINT_STATUSES: readonly ["draft", "verifying", "active", "paused", "attention", "revoked", "archived"];
+export type ChatEndpointStatus = (typeof CHAT_ENDPOINT_STATUSES)[number];
+export declare const CHAT_DEPLOYMENT_MODES: readonly ["direct", "relay"];
+export type ChatDeploymentMode = (typeof CHAT_DEPLOYMENT_MODES)[number];
+export declare const CHAT_CONCURRENCY_POLICIES: readonly ["burst", "queue", "debounce", "drop", "concurrent"];
+export type ChatConcurrencyPolicy = (typeof CHAT_CONCURRENCY_POLICIES)[number];
+export declare const CHAT_EVENT_KINDS: readonly ["mention", "message", "direct_message", "message_updated", "message_deleted", "message_restored", "reaction_added", "reaction_removed", "action", "modal_submitted", "modal_closed", "slash_command", "file_shared", "installation", "uninstallation", "unknown"];
+export type ChatEventKind = (typeof CHAT_EVENT_KINDS)[number];
+export declare const CHAT_DELIVERY_STATES: readonly ["received", "filtered", "processing", "processed", "retry", "failed"];
+export type ChatDeliveryState = (typeof CHAT_DELIVERY_STATES)[number];
+export declare const CHAT_PUBLICATION_STATES: readonly ["pending", "awaiting_consent", "streaming", "published", "retry", "delivery_unknown", "failed", "cancelled"];
+export type ChatPublicationState = (typeof CHAT_PUBLICATION_STATES)[number];
+export declare const CHAT_FILE_TRANSFER_PHASES: readonly ["consent_pending", "consent_sending", "consent_unknown", "awaiting_consent", "upload_pending", "uploading", "upload_unknown", "file_info_pending", "file_info_sending", "file_info_unknown", "delivered", "declined", "expired", "cancelled", "conflict"];
+export type ChatFileTransferPhase = (typeof CHAT_FILE_TRANSFER_PHASES)[number];
+/** Closed presentation only: never provider URLs, credentials or private state. */
+export interface ChatFileTransferSummary {
+    provider: "microsoft-teams";
+    phase: ChatFileTransferPhase;
+    filename: string;
+    expiresAt?: string | null;
+    /** Monotonic durable row revision, not a schema version. */
+    version: number;
+}
+export type ChatFileTransferResolutionPrecondition = Pick<ChatFileTransferSummary, "phase" | "version">;
+export declare const CHAT_CONVERSATION_STATES: readonly ["active", "waiting", "completed", "unavailable", "endpoint_removed"];
+export type ChatConversationState = (typeof CHAT_CONVERSATION_STATES)[number];
+export declare const CHAT_PRINCIPAL_KINDS: readonly ["user", "bot", "app", "system"];
+export type ChatPrincipalKind = (typeof CHAT_PRINCIPAL_KINDS)[number];
+export declare const CHAT_IDENTITY_LINK_STATUSES: readonly ["pending", "linked", "revoked", "expired"];
+export type ChatIdentityLinkStatus = (typeof CHAT_IDENTITY_LINK_STATUSES)[number];
+export declare const CHAT_RESOURCE_AVAILABILITIES: readonly ["available", "unavailable", "removed"];
+export type ChatResourceAvailability = (typeof CHAT_RESOURCE_AVAILABILITIES)[number];
+export interface ChatAdapterCapabilities {
+    threads: boolean;
+    directMessages: boolean;
+    nativeStreaming: boolean;
+    messageEdits: boolean;
+    messageDeletes: boolean;
+    reactions: boolean;
+    files: boolean;
+    cards: boolean;
+    actions: boolean;
+    modals: boolean;
+    slashCommands: boolean;
+    ephemeralMessages: boolean;
+    proactiveDirectMessages: boolean;
+}
+export interface ChatEndpointBehaviorPolicy {
+    /** Defaults to queue and is not exposed in the initial settings UI. */
+    concurrency: ChatConcurrencyPolicy;
+    allowDirectMessages: boolean;
+    allowGroupChats: boolean;
+    allowUnlinkedPeople: boolean;
+}
+export declare const CHAT_CALLBACK_SURFACE_STATUSES: readonly ["current", "stale", "unverified"];
+export type ChatCallbackSurfaceStatus = (typeof CHAT_CALLBACK_SURFACE_STATUSES)[number];
+export interface ChatEndpointCallbackSurfaceState {
+    status: ChatCallbackSurfaceStatus;
+    observedAt?: string | null;
+}
+export interface ChatEndpointCallbackSurfaces {
+    events: ChatEndpointCallbackSurfaceState;
+    interactivity: ChatEndpointCallbackSurfaceState;
+    slashCommands: ChatEndpointCallbackSurfaceState;
+}
+export interface SlackAppConfiguration {
+    appName: string;
+    botName: string;
+    command: string;
+}
+export interface ChatEndpointSetupState {
+    github?: {
+        stage: "connect" | "install" | "repositories" | "verify" | "identity" | "behavior" | "test";
+        appSlug?: string;
+        installationUrl?: string;
+        managementUrl?: string;
+        registrationStatus?: "pending" | "completed" | "failed";
+    };
+    step: "choose_agent" | "provider_setup" | "test" | "complete";
+    /** Server-generated boundary; only provider events at or after this time can complete setup. */
+    testStartedAt?: string | null;
+    /** Onboarding was finished without requiring a full conversation test. */
+    testSkipped?: boolean;
+    /** Set only after the provider has delivered a signed callback challenge. */
+    webhookVerifiedAt?: string | null;
+    authorizationUrl?: string | null;
+    providerUrl?: string | null;
+    command?: string | null;
+    slackApp?: SlackAppConfiguration;
+    webhookUrl?: string | null;
+    messagingEndpoint?: string | null;
+    /** Safe presence signal only; the secret value is returned once by its generation endpoint. */
+    webhookSecretConfigured?: boolean;
+    /** Provider callback surfaces observed at the endpoint's current public URL. */
+    callbackSurfaces?: ChatEndpointCallbackSurfaces;
+    /** True when at least one previously observed callback still targets an old public URL. */
+    callbacksNeedUpdate?: boolean;
+}
+export interface ChatEndpointSetupSecret {
+    webhookSecret: string;
+}
+export type ChannelPublicationMode = "automatic" | "explicit";
+export type ExternalMessageExecutionPolicy = "restricted" | "agent";
+export interface ChatEndpoint {
+    /** Additional presentation instructions captured only for newly created tasks. */
+    communicationInstructions?: string;
+    id: string;
+    companyId: string;
+    connectionId: string;
+    /** Older clients omit these fields; defaults are automatic/restricted. */
+    publicationMode?: ChannelPublicationMode;
+    externalExecutionPolicy?: ExternalMessageExecutionPolicy;
+    provider: ChatProvider;
+    publicId: string;
+    status: ChatEndpointStatus;
+    deploymentMode: ChatDeploymentMode;
+    assignedAgentId: string;
+    assignedAgentName?: string | null;
+    sponsorUserId?: string | null;
+    providerAccountId?: string | null;
+    providerAccountLabel?: string | null;
+    botExternalId?: string | null;
+    botUsername?: string | null;
+    botLabel?: string | null;
+    botAvatarUrl?: string | null;
+    photonAllocation?: "dedicated" | "shared";
+    allowDirectMessages: boolean;
+    allowGroupChats: boolean;
+    allowUnlinkedPeople: boolean;
+    replyMode: "subscribed";
+    capabilities: ChatAdapterCapabilities;
+    setup: ChatEndpointSetupState;
+    healthMessage?: string | null;
+    lastError?: string | null;
+    lastActivityAt?: string | null;
+    lastPublicationAt?: string | null;
+    activatedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ChatEndpointResource {
+    id: string;
+    companyId: string;
+    endpointId: string;
+    type: string;
+    providerResourceId: string;
+    parentProviderResourceId?: string | null;
+    label: string;
+    detail?: string | null;
+    providerUrl?: string | null;
+    availability: ChatResourceAvailability;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+    participants?: string[];
+}
+export interface ChatExternalPrincipal {
+    id: string;
+    companyId: string;
+    provider: ChatProvider;
+    providerAccountId: string;
+    externalId: string;
+    kind: ChatPrincipalKind;
+    displayName?: string | null;
+    handle?: string | null;
+    avatarUrl?: string | null;
+    isBot: boolean;
+    lastSeenAt?: string | null;
+}
+export interface ChatIdentityLink {
+    id: string;
+    companyId: string;
+    endpointId: string;
+    principalId: string;
+    /** Latest discovery-only connect command received by this endpoint. */
+    lastConnectAt?: string | null;
+    externalLabel: string;
+    externalDetail?: string | null;
+    paperclipUserId?: string | null;
+    paperclipUserLabel?: string | null;
+    status: ChatIdentityLinkStatus;
+    expiresAt?: string | null;
+    confirmedAt?: string | null;
+    revokedAt?: string | null;
+}
+export interface ChatConversation {
+    id: string;
+    companyId: string;
+    endpointId: string;
+    resourceId?: string | null;
+    issueId: string;
+    issueIdentifier?: string | null;
+    issueTitle?: string | null;
+    externalConversationId: string;
+    externalThreadId: string;
+    sessionGeneration: number;
+    externalLabel: string;
+    externalUrl?: string | null;
+    isDirectMessage: boolean;
+    state: ChatConversationState;
+    lastPublicationStatus?: ChatPublicationState | null;
+    lastActivityAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ChatDelivery {
+    id: string;
+    companyId: string;
+    endpointId: string;
+    conversationId?: string | null;
+    principalId?: string | null;
+    providerEventId: string;
+    deduplicationKey: string;
+    eventKind: ChatEventKind;
+    state: ChatDeliveryState;
+    attempts: number;
+    summary?: string | null;
+    redactedError?: string | null;
+    receivedAt: string;
+    processedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export type SafeExternalChatCardKind = "status" | "question" | "confirmation";
+export type SafeExternalChatCardAction = {
+    type: "callback";
+    actionId: string;
+    label: string;
+    style?: "default" | "primary" | "danger";
+} | {
+    type: "link";
+    label: string;
+    url: string;
+};
+export interface SafeExternalChatCard {
+    schema: "paperclip.chat.card.v1";
+    kind: SafeExternalChatCardKind;
+    title: string;
+    body?: string;
+    actions?: SafeExternalChatCardAction[];
+}
+export interface SafeChatPublicationPayload {
+    text: string;
+    attachmentIds?: string[];
+    interactionId?: string;
+    card?: SafeExternalChatCard;
+    /** Server-managed metadata for a logical publication split into durable messages. */
+    transportPart?: {
+        batchId: string;
+        count: number;
+        index: number;
+        /** Server-managed provider rendering for this transport part. */
+        mode?: "inline" | "discord_markdown_attachment" | "telegram_markdown_attachment";
+        orderKey: string;
+        /** Closed, server-generated Markdown fence wrappers; text remains an exact source slice. */
+        prefix?: string;
+        suffix?: string;
+    };
+    progressState?: "queued" | "working" | "waiting_for_input" | "approval_needed" | "completed" | "failed";
+}
+export interface ChatPublication {
+    id: string;
+    companyId: string;
+    endpointId: string;
+    conversationId: string;
+    issueId: string;
+    commentId?: string | null;
+    idempotencyKey: string;
+    state: ChatPublicationState;
+    providerMessageId?: string | null;
+    providerUrl?: string | null;
+    attempts: number;
+    redactedError?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string | null;
+}
+export interface ChatPublicationSummary {
+    id: string;
+    state: ChatPublicationState;
+    providerUrl?: string | null;
+    attempts: number;
+    redactedError?: string | null;
+    nextAttemptAt?: string | null;
+    publishedAt?: string | null;
+    fileTransfer?: ChatFileTransferSummary;
+}
+export interface ChatPublicationBatchStatus {
+    /** First unresolved part; a terminal nonpublished part for mixed outcomes. */
+    publication: ChatPublicationSummary;
+    total: number;
+    published: number;
+    /** Additive during rolling upgrades; missing settlement proof is not permission to dismiss. */
+    parts?: ChatPublicationSummary[];
+    awaitingConsent?: number;
+    declined?: number;
+    expired?: number;
+    /** Excludes declined and expired. */
+    cancelled?: number;
+    /** published + declined + expired + cancelled, never failed or uncertain. */
+    settled?: number;
+    canDismiss?: boolean;
+}
+export interface ChatActivityItem {
+    id: string;
+    kind: "delivery" | "publication" | "action" | "health" | "repair";
+    actionType?: "slash_task_start" | "provider_effect" | "github_webhook_ingress" | "slack_session_sync" | "slack_session_stop";
+    status: string;
+    summary: string;
+    detail?: string | null;
+    createdAt: string;
+    replayable?: boolean;
+    resolutionActions?: Array<"mark_delivered" | "retry_anyway" | "cancel">;
+    fileTransfer?: ChatFileTransferSummary;
+}
+export interface ExternalChannelBindingSummary {
+    endpointId: string;
+    provider: ChatProvider;
+    botLabel?: string | null;
+    externalLabel: string;
+    externalUrl?: string | null;
+    conversationId: string;
+    publicationState?: ChatPublicationState | null;
+    assignedAgentLocked: true;
+}
+export interface CreateChatEndpointInput {
+    provider: ChatProvider;
+    assignedAgentId: string;
+    applicationId?: string;
+    name?: string;
+}
+export interface UpdateChatEndpointInput {
+    slackApp?: SlackAppConfiguration;
+    communicationInstructions?: string;
+    allowDirectMessages?: boolean;
+    allowGroupChats?: boolean;
+    allowUnlinkedPeople?: boolean;
+}
+export interface ConfigureChatEndpointInput {
+    action: "configure" | "verify" | "pause" | "resume" | "reconnect" | "remove";
+    credentials?: Record<string, string>;
+    photon?: PhotonChannelConfiguration;
+}
+export interface NormalizedChatEvent {
+    providerEventId: string;
+    kind: ChatEventKind;
+    providerAccountId: string;
+    principal: {
+        externalId: string;
+        kind: ChatPrincipalKind;
+        displayName?: string;
+        handle?: string;
+        isBot?: boolean;
+    };
+    resource: {
+        type: string;
+        providerResourceId: string;
+        parentProviderResourceId?: string;
+        label: string;
+        providerUrl?: string;
+    };
+    conversation: {
+        externalConversationId: string;
+        externalThreadId?: string;
+        label: string;
+        providerUrl?: string;
+        isDirectMessage?: boolean;
+    };
+    message?: {
+        providerMessageId: string;
+        text: string;
+        mentionedBot?: boolean;
+        replyToProviderMessageId?: string;
+        attachmentUrls?: string[];
+    };
+    raw: Record<string, unknown>;
+}
+/** Safe Photon project inspection; credentials and line tokens are never serialized. */
+export interface PhotonProjectInspection {
+    projectId: string;
+    projectName: string;
+    allocation: "dedicated" | "shared";
+    eligible: boolean;
+    lines: Array<{
+        lineId: string;
+        phoneNumber: string;
+        eligible: boolean;
+        unavailableReason?: string;
+    }>;
+}
+export type PhotonChannelConfiguration = {
+    allocation?: "dedicated";
+    projectId: string;
+    lineId: string;
+} | {
+    allocation: "shared";
+    projectId: string;
+};
+//# sourceMappingURL=chat-channels.d.ts.map

package/dist/types/chat-channels.d.ts.map

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

package/dist/types/chat-channels.js

@@ -0,0 +1,105 @@
+/** Provider-neutral contracts for Paperclip's native external chat subsystem. */
+export const CHAT_PROVIDERS = [
+    "slack",
+    "github",
+    "discord",
+    "microsoft-teams",
+    "telegram",
+    "agentmail",
+    "imessage-photon",
+];
+export const CHAT_ENDPOINT_STATUSES = [
+    "draft",
+    "verifying",
+    "active",
+    "paused",
+    "attention",
+    "revoked",
+    "archived",
+];
+export const CHAT_DEPLOYMENT_MODES = ["direct", "relay"];
+export const CHAT_CONCURRENCY_POLICIES = [
+    "burst",
+    "queue",
+    "debounce",
+    "drop",
+    "concurrent",
+];
+export const CHAT_EVENT_KINDS = [
+    "mention",
+    "message",
+    "direct_message",
+    "message_updated",
+    "message_deleted",
+    "message_restored",
+    "reaction_added",
+    "reaction_removed",
+    "action",
+    "modal_submitted",
+    "modal_closed",
+    "slash_command",
+    "file_shared",
+    "installation",
+    "uninstallation",
+    "unknown",
+];
+export const CHAT_DELIVERY_STATES = [
+    "received",
+    "filtered",
+    "processing",
+    "processed",
+    "retry",
+    "failed",
+];
+export const CHAT_PUBLICATION_STATES = [
+    "pending",
+    "awaiting_consent",
+    "streaming",
+    "published",
+    "retry",
+    "delivery_unknown",
+    "failed",
+    "cancelled",
+];
+export const CHAT_FILE_TRANSFER_PHASES = [
+    "consent_pending",
+    "consent_sending",
+    "consent_unknown",
+    "awaiting_consent",
+    "upload_pending",
+    "uploading",
+    "upload_unknown",
+    "file_info_pending",
+    "file_info_sending",
+    "file_info_unknown",
+    "delivered",
+    "declined",
+    "expired",
+    "cancelled",
+    "conflict",
+];
+export const CHAT_CONVERSATION_STATES = [
+    "active",
+    "waiting",
+    "completed",
+    "unavailable",
+    "endpoint_removed",
+];
+export const CHAT_PRINCIPAL_KINDS = ["user", "bot", "app", "system"];
+export const CHAT_IDENTITY_LINK_STATUSES = [
+    "pending",
+    "linked",
+    "revoked",
+    "expired",
+];
+export const CHAT_RESOURCE_AVAILABILITIES = [
+    "available",
+    "unavailable",
+    "removed",
+];
+export const CHAT_CALLBACK_SURFACE_STATUSES = [
+    "current",
+    "stale",
+    "unverified",
+];
+//# sourceMappingURL=chat-channels.js.map

package/dist/types/chat-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-channels.js","sourceRoot":"","sources":["../../src/types/chat-channels.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO;IACP,QAAQ;IACR,SAAS;IACT,iBAAiB;IACjB,UAAU;IACV,WAAW;IACX,iBAAiB;CACT,CAAC;AAGX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO;IACP,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;CACF,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGlE,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;IACN,YAAY;CACJ,CAAC;AAGX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,QAAQ;IACR,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU;IACV,UAAU;IACV,YAAY;IACZ,WAAW;IACX,OAAO;IACP,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS;IACT,kBAAkB;IAClB,WAAW;IACX,WAAW;IACX,OAAO;IACP,kBAAkB;IAClB,QAAQ;IACR,WAAW;CACH,CAAC;AAGX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,WAAW;IACX,UAAU;IACV,SAAS;IACT,WAAW;IACX,UAAU;CACF,CAAC;AAkBX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,SAAS;IACT,WAAW;IACX,aAAa;IACb,kBAAkB;CACV,CAAC;AAGX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAG9E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,WAAW;IACX,aAAa;IACb,SAAS;CACD,CAAC;AA4BX,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,SAAS;IACT,OAAO;IACP,YAAY;CACJ,CAAC"}

package/dist/types/chat-github.d.ts

@@ -0,0 +1,123 @@
+/** GitHub is a channel into an ordinary Paperclip task, not another executor. */
+export declare const GITHUB_REVIEW_EVENTS: readonly ["opened", "synchronize", "reopened", "ready_for_review", "mention", "comment"];
+export type GitHubReviewEvent = (typeof GITHUB_REVIEW_EVENTS)[number];
+export interface GitHubReviewPolicy {
+    invocation: "mentions_only" | "linked_authors" | "allowed_authors";
+    events: GitHubReviewEvent[];
+    reviewDrafts: boolean;
+    reviewBotAuthors: boolean;
+    includeAuthors: string[];
+    excludeAuthors: string[];
+    targetBranches: string[];
+    excludedBranches: string[];
+    requiredLabels: string[];
+    excludedLabels: string[];
+    ignoredPaths: string[];
+    instructions: string;
+    prompts: Record<GitHubReviewEvent, string>;
+    findingCategories: string[];
+    minimumCommentSeverity: "info" | "warning" | "error";
+    publishSummary: boolean;
+    publishInline: boolean;
+    allowApprove: boolean;
+    allowRequestChanges: boolean;
+    ratingThreshold: 1 | 2 | 3 | 4 | 5 | null;
+}
+export type GitHubAllowedPerson = {
+    githubUserId: string;
+    login: string;
+    automaticReviews: boolean;
+} & ({
+    kind: "member";
+    userId: string;
+} | {
+    kind: "guest";
+    sponsorUserId: string;
+    permissionProfile: "restricted";
+});
+export interface GitHubChatConfiguration {
+    version: 1;
+    /** Enabling the feature and bot tools is explicit for existing endpoints. */
+    toolsEnabled: boolean;
+    responsibleUserId: string;
+    memberAccess: "all_linked" | "selected";
+    people: GitHubAllowedPerson[];
+    defaults: GitHubReviewPolicy;
+    /** Keys are stable GitHub repository IDs; labels never grant access. */
+    repositories: Record<string, Partial<GitHubReviewPolicy>>;
+}
+export interface GitHubReviewEventContext {
+    event: GitHubReviewEvent;
+    deliveryId: string;
+    repositoryId: string;
+    repository: string;
+    pullNumber: number;
+    title: string;
+    body: string;
+    baseSha: string;
+    headSha: string;
+    baseBranch: string;
+    author: {
+        id: string;
+        login: string;
+        isBot: boolean;
+    };
+    sender: {
+        id: string;
+        login: string;
+    };
+    draft: boolean;
+    labels: string[];
+    previousHeadSha?: string;
+    /** Latest assessed commit, which may precede several unreviewed pushes. */
+    priorReviewedHeadSha?: string;
+}
+export interface GitHubReviewFinding {
+    /** Stable agent-supplied key; combined with path and line for deduplication. */
+    key: string;
+    path: string;
+    line: number;
+    side: "LEFT" | "RIGHT";
+    severity: "info" | "warning" | "error";
+    category: string;
+    body: string;
+}
+export interface GitHubReviewAssessment {
+    reviewedCommit: string;
+    score: 0 | 1 | 2 | 3 | 4 | 5;
+    complete: boolean;
+    summary: string;
+    rationale: string;
+    coverage: {
+        reviewedPaths: string[];
+        omittedPaths: string[];
+        limitations: string[];
+    };
+    findings: GitHubReviewFinding[];
+}
+export type GitHubReviewConclusion = "success" | "failure" | "neutral" | "action_required";
+/** Stored evidence attached to a task/run. Never independently scheduled. */
+export interface GitHubTaskReview {
+    id: string;
+    companyId: string;
+    endpointId: string;
+    issueId: string;
+    runId: string | null;
+    repositoryId: string;
+    repository: string;
+    pullNumber: number;
+    headSha: string;
+    configurationRevision: number;
+    event: GitHubReviewEventContext;
+    state: "queued" | "running" | "completed" | "incomplete" | "error" | "superseded" | "manual_required";
+    assessment: GitHubReviewAssessment | null;
+    conclusion: GitHubReviewConclusion | null;
+    checkUrl: string | null;
+    summaryUrl: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare const GITHUB_REVIEW_RUBRIC: readonly ["0: No usable assessment; analysis is incomplete or cannot establish coverage.", "1: Critical defects make the change unsafe to ship.", "2: Major defects require substantial correction.", "3: Meaningful defects require correction before merging.", "4: Minor concerns remain; explain their impact and remaining risk.", "5: No actionable defects found within the stated coverage and limitations."];
+export declare const DEFAULT_GITHUB_REVIEW_PROMPTS: Record<GitHubReviewEvent, string>;
+export declare function defaultGitHubReviewPolicy(): GitHubReviewPolicy;
+//# sourceMappingURL=chat-github.d.ts.map

package/dist/types/chat-github.d.ts.map

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