cyrus-core 0.2.1 → 0.2.3

package/dist/issue-tracker/IIssueTrackerService.js

@@ -0,0 +1,11 @@
+/**
+ * Platform-agnostic interface for issue tracking platform operations.
+ *
+ * This interface provides a unified API for interacting with issue tracking
+ * platforms like Linear, GitHub Issues, Jira, etc. It abstracts away platform-specific
+ * details while supporting all operations needed for Cyrus agent functionality.
+ *
+ * @module issue-tracker/IIssueTrackerService
+ */
+export {};
+//# sourceMappingURL=IIssueTrackerService.js.map

package/dist/issue-tracker/IIssueTrackerService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IIssueTrackerService.js","sourceRoot":"","sources":["../../src/issue-tracker/IIssueTrackerService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/issue-tracker/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Issue Tracker Abstraction Layer
+ *
+ * This module provides a platform-agnostic interface for issue tracking operations.
+ * It decouples the Cyrus codebase from Linear-specific implementations, enabling
+ * support for multiple issue tracking platforms (Linear, GitHub, Jira, etc.).
+ *
+ * @module issue-tracker
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * import { IIssueTrackerService, Issue, Comment } from '@cyrus/core/issue-tracker';
+ *
+ * // Use the service interface (implementation provided elsewhere)
+ * async function processIssue(service: IIssueTrackerService, issueId: string) {
+ *   const issue = await service.fetchIssue(issueId);
+ *   const comments = await service.fetchComments(issue.id);
+ *   // ... process the issue
+ * }
+ * ```
+ *
+ * @example
+ * Working with webhook events:
+ * ```typescript
+ * import {
+ *   AgentEvent,
+ *   isIssueAssignedEvent,
+ *   isNewCommentEvent
+ * } from '@cyrus/core/issue-tracker';
+ *
+ * function handleWebhook(event: AgentEvent) {
+ *   if (isIssueAssignedEvent(event)) {
+ *     console.log('Issue assigned:', event.notification.issue.identifier);
+ *   } else if (isNewCommentEvent(event)) {
+ *     console.log('New comment:', event.notification.comment.body);
+ *   }
+ * }
+ * ```
+ */
+export { IIssueTrackerService } from "./IIssueTrackerService.js";
+export type { AgentEventTransportConfig, AgentEventTransportEvents, IAgentEventTransport, } from "./IAgentEventTransport.js";
+export type { AgentActivityCreateInput, AgentActivityPayload, } from "./types.js";
+export * from "./types.js";
+export type { AgentEvent } from "./AgentEvent.js";
+export { isAgentSessionCreatedEvent, isAgentSessionPromptedEvent, isCommentMentionEvent, isIssueAssignedEvent, isIssueUnassignedEvent, isNewCommentEvent, } from "./AgentEvent.js";
+/**
+ * Version of the issue tracker abstraction layer.
+ */
+export declare const VERSION = "1.0.0";
+/**
+ * Supported platform types.
+ */
+export declare const SUPPORTED_PLATFORMS: readonly ["linear"];
+/**
+ * Type for supported platform identifiers.
+ */
+export type SupportedPlatform = (typeof SUPPORTED_PLATFORMS)[number];
+//# sourceMappingURL=index.d.ts.map

package/dist/issue-tracker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/issue-tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAMjE,YAAY,EACX,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,2BAA2B,CAAC;AAOnC,YAAY,EACX,wBAAwB,EACxB,oBAAoB,GACpB,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAM3B,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,iBAAiB,CAAC;AAczB;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAAsB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/issue-tracker/index.js

@@ -0,0 +1,61 @@
+/**
+ * Issue Tracker Abstraction Layer
+ *
+ * This module provides a platform-agnostic interface for issue tracking operations.
+ * It decouples the Cyrus codebase from Linear-specific implementations, enabling
+ * support for multiple issue tracking platforms (Linear, GitHub, Jira, etc.).
+ *
+ * @module issue-tracker
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * import { IIssueTrackerService, Issue, Comment } from '@cyrus/core/issue-tracker';
+ *
+ * // Use the service interface (implementation provided elsewhere)
+ * async function processIssue(service: IIssueTrackerService, issueId: string) {
+ *   const issue = await service.fetchIssue(issueId);
+ *   const comments = await service.fetchComments(issue.id);
+ *   // ... process the issue
+ * }
+ * ```
+ *
+ * @example
+ * Working with webhook events:
+ * ```typescript
+ * import {
+ *   AgentEvent,
+ *   isIssueAssignedEvent,
+ *   isNewCommentEvent
+ * } from '@cyrus/core/issue-tracker';
+ *
+ * function handleWebhook(event: AgentEvent) {
+ *   if (isIssueAssignedEvent(event)) {
+ *     console.log('Issue assigned:', event.notification.issue.identifier);
+ *   } else if (isNewCommentEvent(event)) {
+ *     console.log('New comment:', event.notification.comment.body);
+ *   }
+ * }
+ * ```
+ */
+// Export all types and enums from types.ts
+export * from "./types.js";
+export { isAgentSessionCreatedEvent, isAgentSessionPromptedEvent, isCommentMentionEvent, isIssueAssignedEvent, isIssueUnassignedEvent, isNewCommentEvent, } from "./AgentEvent.js";
+// ============================================================================
+// ADAPTERS
+// ============================================================================
+// CLI adapters will be added in part 2 of CYPACK-388
+// Linear adapters have been moved to cyrus-linear-event-transport package
+// Import them directly from that package instead of from cyrus-core
+// ============================================================================
+// MODULE METADATA
+// ============================================================================
+/**
+ * Version of the issue tracker abstraction layer.
+ */
+export const VERSION = "1.0.0";
+/**
+ * Supported platform types.
+ */
+export const SUPPORTED_PLATFORMS = ["linear"];
+//# sourceMappingURL=index.js.map

package/dist/issue-tracker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/issue-tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AA2BH,2CAA2C;AAC3C,cAAc,YAAY,CAAC;AAO3B,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,qDAAqD;AACrD,0EAA0E;AAC1E,oEAAoE;AAEpE,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAQ,CAAU,CAAC"}

package/dist/issue-tracker/types.d.ts

@@ -0,0 +1,499 @@
+/**
+ * Platform-agnostic types for issue tracking platforms.
+ *
+ * These types provide simplified interfaces that match Linear SDK GraphQL types structure.
+ * Linear SDK is the source of truth - these types are designed to be compatible subsets
+ * of Linear's types, omitting implementation-specific fields while maintaining core
+ * data structure compatibility.
+ *
+ * Following the pattern from AgentEvent.ts, we reference Linear SDK types via JSDoc
+ * and re-export Linear enums where they exist. This makes Linear the "source of truth"
+ * while keeping interfaces manageable.
+ *
+ * @module issue-tracker/types
+ * @see {@link https://linear.app/docs/graphql/api|Linear GraphQL API Documentation}
+ */
+import type * as LinearSDK from "@linear/sdk";
+/**
+ * Issue type - Direct alias to Linear SDK's Issue type.
+ * Linear SDK is the source of truth for all issue tracking types.
+ *
+ * @see {@link LinearSDK.Issue} - Linear's complete Issue type
+ */
+export type Issue = LinearSDK.Issue;
+/**
+ * Comment type - Direct alias to Linear SDK's Comment type.
+ *
+ * @see {@link LinearSDK.Comment} - Linear's complete Comment type
+ */
+export type Comment = LinearSDK.Comment;
+/**
+ * Label type - Direct alias to Linear SDK's IssueLabel type.
+ *
+ * @see {@link LinearSDK.IssueLabel} - Linear's complete IssueLabel type
+ */
+export type Label = LinearSDK.IssueLabel;
+/**
+ * Team type - Direct alias to Linear SDK's Team type.
+ *
+ * @see {@link LinearSDK.Team} - Linear's complete Team type
+ */
+export type Team = LinearSDK.Team;
+/**
+ * User type - Direct alias to Linear SDK's User type.
+ *
+ * @see {@link LinearSDK.User} - Linear's complete User type
+ */
+export type User = LinearSDK.User;
+/**
+ * WorkflowState type - Direct alias to Linear SDK's WorkflowState type.
+ *
+ * @see {@link LinearSDK.WorkflowState} - Linear's complete WorkflowState type
+ */
+export type WorkflowState = LinearSDK.WorkflowState;
+/**
+ * Filter options for querying entities.
+ */
+export interface FilterOptions {
+    /** Filter by state type */
+    state?: {
+        type?: {
+            eq?: string;
+            neq?: string;
+            in?: string[];
+            nin?: string[];
+        };
+    };
+    /** Filter by archived status */
+    archivedAt?: {
+        null?: boolean;
+    };
+    /** Additional platform-specific filters */
+    [key: string]: unknown;
+}
+/**
+ * Pagination options for list operations.
+ */
+export interface PaginationOptions {
+    /** Number of items to fetch */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Cursor for reverse pagination */
+    before?: string;
+    /** Filter criteria */
+    filter?: FilterOptions;
+}
+/**
+ * Standard workflow state types across platforms.
+ */
+export declare enum WorkflowStateType {
+    Triage = "triage",
+    Backlog = "backlog",
+    Unstarted = "unstarted",
+    Started = "started",
+    Completed = "completed",
+    Canceled = "canceled"
+}
+/**
+ * Issue priority levels (0 = no priority, 1 = urgent, 2 = high, 3 = normal, 4 = low).
+ */
+export declare enum IssuePriority {
+    NoPriority = 0,
+    Urgent = 1,
+    High = 2,
+    Normal = 3,
+    Low = 4
+}
+/**
+ * Minimal issue representation for lightweight operations.
+ */
+export interface IssueMinimal {
+    /** Unique issue identifier */
+    id: string;
+    /** Human-readable identifier */
+    identifier: string;
+    /** Issue title */
+    title: string;
+    /** Issue URL */
+    url: string;
+}
+/**
+ * Issue with child issues included.
+ * Note: This extends Issue but overrides the children property from a method to an array.
+ */
+export interface IssueWithChildren extends Omit<Issue, "children"> {
+    /** Child/sub-issues */
+    children: Issue[];
+    /** Total count of children */
+    childCount: number;
+}
+/**
+ * Comment with attachments metadata.
+ */
+export interface CommentWithAttachments extends Comment {
+    /** Attachment information */
+    attachments?: Array<{
+        id: string;
+        url: string;
+        filename: string;
+        contentType?: string;
+        size?: number;
+    }>;
+}
+/**
+ * Agent session status enumeration.
+ *
+ * Re-exported from Linear SDK. Linear SDK is the source of truth.
+ * Note: Linear uses "awaitingInput" while we historically used "awaiting-input".
+ * We now use Linear's enum directly for consistency.
+ *
+ * @see {@link LinearSDK.AgentSessionStatus} - Linear's AgentSessionStatus enum
+ */
+import { AgentSessionStatus } from "@linear/sdk";
+export { AgentSessionStatus };
+export type { AgentSessionStatus as AgentSessionStatusEnum } from "@linear/sdk";
+/**
+ * Agent session type/context enumeration.
+ *
+ * Re-exported from Linear SDK. Linear SDK is the source of truth.
+ *
+ * @see {@link LinearSDK.AgentSessionType} - Linear's AgentSessionType enum
+ */
+import { AgentSessionType } from "@linear/sdk";
+export { AgentSessionType };
+export type { AgentSessionType as AgentSessionTypeEnum } from "@linear/sdk";
+/**
+ * Agent session webhook payload type.
+ * Used for webhook events and type-safe data structures (strict, non-optional fields).
+ *
+ * @see {@link LinearSDK.LinearDocument.AgentSession}
+ */
+export type AgentSession = LinearSDK.LinearDocument.AgentSession;
+/**
+ * Agent session SDK runtime type.
+ * Used when working with Linear SDK API responses (has optional getters).
+ *
+ * @see {@link LinearSDK.AgentSession}
+ */
+export type AgentSessionSDK = LinearSDK.AgentSession;
+/**
+ * Agent activity type enumeration.
+ *
+ * Re-exported from Linear SDK. Linear SDK is the source of truth.
+ * This is aliased as AgentActivityContentType for backward compatibility.
+ *
+ * @see {@link LinearSDK.AgentActivityType} - Linear's AgentActivityType enum
+ */
+import { AgentActivityType } from "@linear/sdk";
+export { AgentActivityType };
+export type { AgentActivityType as AgentActivityTypeEnum } from "@linear/sdk";
+/**
+ * Legacy alias for AgentActivityType.
+ * @deprecated Use AgentActivityType instead
+ */
+export declare const AgentActivityContentType: typeof LinearSDK.LinearDocument.AgentActivityType;
+export type AgentActivityContentType = AgentActivityType;
+/**
+ * Agent activity content type.
+ * Used for both webhook events and SDK API responses (union type is the same for both).
+ *
+ * @see {@link LinearSDK.LinearDocument.AgentActivityContent}
+ */
+export type AgentActivityContent = LinearSDK.LinearDocument.AgentActivityContent;
+/**
+ * Agent activity signal enumeration.
+ *
+ * Re-exported from Linear SDK. Linear SDK is the source of truth.
+ *
+ * @see {@link LinearSDK.AgentActivitySignal} - Linear's AgentActivitySignal enum
+ */
+import { AgentActivitySignal } from "@linear/sdk";
+export { AgentActivitySignal };
+export type { AgentActivitySignal as AgentActivitySignalEnum } from "@linear/sdk";
+/**
+ * Agent activity webhook payload type.
+ * Used for webhook events and type-safe data structures (strict, non-optional fields).
+ *
+ * @see {@link LinearSDK.LinearDocument.AgentActivity}
+ */
+export type AgentActivity = LinearSDK.LinearDocument.AgentActivity;
+/**
+ * Agent activity SDK runtime type.
+ * Used when working with Linear SDK API responses (has optional getters).
+ *
+ * @see {@link LinearSDK.AgentActivity}
+ */
+export type AgentActivitySDK = LinearSDK.AgentActivity;
+/**
+ * Agent activity create input type.
+ * Used for creating agent activities - matches Linear SDK's input structure exactly.
+ *
+ * @see {@link LinearSDK.LinearDocument.AgentActivityCreateInput}
+ */
+export type AgentActivityCreateInput = LinearSDK.LinearDocument.AgentActivityCreateInput;
+/**
+ * Agent activity payload type.
+ * Returned from createAgentActivity mutation - contains success status and created activity.
+ *
+ * @see {@link LinearSDK.AgentActivityPayload}
+ */
+export type AgentActivityPayload = LinearSDK.AgentActivityPayload;
+/**
+ * File upload request parameters.
+ */
+export interface FileUploadRequest {
+    /** MIME type of the file */
+    contentType: string;
+    /** File name */
+    filename: string;
+    /** File size in bytes */
+    size: number;
+    /** Whether to make the file publicly accessible */
+    makePublic?: boolean;
+}
+/**
+ * File upload response with URLs and headers.
+ */
+export interface FileUploadResponse {
+    /** URL to upload the file to */
+    uploadUrl: string;
+    /** Headers to include in the upload request */
+    headers: Record<string, string>;
+    /** Asset URL to use in content after upload */
+    assetUrl: string;
+}
+/**
+ * Agent session creation input for issue-based sessions.
+ */
+export interface AgentSessionCreateOnIssueInput {
+    /** Issue ID or identifier */
+    issueId: string;
+    /** Optional external link */
+    externalLink?: string;
+}
+/**
+ * Agent session creation input for comment-based sessions.
+ */
+export interface AgentSessionCreateOnCommentInput {
+    /** Comment ID */
+    commentId: string;
+    /** Optional external link */
+    externalLink?: string;
+}
+/**
+ * Agent session creation response.
+ */
+export interface AgentSessionCreateResponse {
+    /** Whether the creation was successful */
+    success: boolean;
+    /** Created agent session ID */
+    agentSessionId: string;
+    /** Last sync ID */
+    lastSyncId: number;
+}
+/**
+ * Issue update parameters.
+ */
+export interface IssueUpdateInput {
+    /** New issue state ID */
+    stateId?: string;
+    /** New assignee ID */
+    assigneeId?: string;
+    /** New title */
+    title?: string;
+    /** New description */
+    description?: string;
+    /** New priority */
+    priority?: IssuePriority;
+    /** New parent ID */
+    parentId?: string;
+    /** Label IDs to set */
+    labelIds?: string[];
+    /** Additional platform-specific fields */
+    [key: string]: unknown;
+}
+/**
+ * Comment creation parameters.
+ */
+export interface CommentCreateInput {
+    /** Comment body/content */
+    body: string;
+    /** Parent comment ID (for threaded comments) */
+    parentId?: string;
+    /**
+     * Asset URLs to attach to the comment (Linear-specific).
+     * These URLs should be obtained from `requestFileUpload()` + upload workflow.
+     * The URLs will be automatically embedded in the comment body as markdown images/links.
+     */
+    attachmentUrls?: string[];
+    /** Additional platform-specific fields */
+    [key: string]: unknown;
+}
+/**
+ * Options for fetching child issues.
+ */
+export interface FetchChildrenOptions {
+    /** Maximum number of children to fetch */
+    limit?: number;
+    /** Whether to include completed children */
+    includeCompleted?: boolean;
+    /** Whether to include archived children */
+    includeArchived?: boolean;
+    /** Additional filter options */
+    filter?: FilterOptions;
+}
+/**
+ * Platform configuration for authentication.
+ */
+export interface PlatformConfig {
+    /** Platform type identifier */
+    type: "linear" | "github" | string;
+    /** Authentication token/API key */
+    apiToken: string;
+    /** User ID on the platform */
+    userId?: string;
+    /** User email on the platform */
+    userEmail?: string;
+    /** Organization/workspace ID */
+    organizationId?: string;
+    /** Additional platform-specific config */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Routing configuration for repository-based routing.
+ */
+export interface RoutingConfig {
+    /** Team keys to route on */
+    teamKeys?: string[];
+    /** Project keys to route on */
+    projectKeys?: string[];
+    /** Label names to route on */
+    routingLabels?: string[];
+    /** Additional platform-specific routing */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Webhook configuration with signature verification.
+ */
+export interface WebhookConfigWithSignature {
+    /** Verification mode */
+    verificationMode: "signature";
+    /** Webhook secret (for signature verification) */
+    secret: string;
+    /** Webhook endpoint URL */
+    endpointUrl?: string;
+    /** Additional platform-specific config */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Webhook configuration with bearer token verification.
+ */
+export interface WebhookConfigWithBearerToken {
+    /** Verification mode */
+    verificationMode: "bearerToken";
+    /** API key (for bearer token verification) */
+    apiKey: string;
+    /** Webhook endpoint URL */
+    endpointUrl?: string;
+    /** Additional platform-specific config */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Webhook configuration - discriminated union based on verification mode.
+ */
+export type WebhookConfig = WebhookConfigWithSignature | WebhookConfigWithBearerToken;
+/**
+ * Platform-agnostic webhook issue data type.
+ * Maps to Linear SDK's IssueWebhookPayload or IssueWithDescriptionChildWebhookPayload.
+ * The Linear SDK uses different payload types in different contexts.
+ */
+export type WebhookIssue = LinearSDK.LinearDocument.IssueWebhookPayload | LinearSDK.LinearDocument.IssueWithDescriptionChildWebhookPayload;
+/**
+ * Platform-agnostic webhook comment data type.
+ * Maps to Linear SDK's CommentWebhookPayload structure.
+ */
+export type WebhookComment = LinearSDK.LinearDocument.CommentWebhookPayload;
+/**
+ * Platform-agnostic webhook agent session data type.
+ * Maps to Linear SDK's AgentSessionWebhookPayload structure.
+ */
+export type WebhookAgentSession = LinearSDK.LinearDocument.AgentSessionWebhookPayload;
+/**
+ * Platform-agnostic agent session created webhook payload.
+ * Maps to Linear SDK's AgentSessionEventWebhookPayload.
+ */
+export type AgentSessionCreatedWebhook = LinearSDK.LinearDocument.AgentSessionEventWebhookPayload;
+/**
+ * Platform-agnostic agent session prompted webhook payload.
+ * Maps to Linear SDK's AgentSessionEventWebhookPayload.
+ */
+export type AgentSessionPromptedWebhook = LinearSDK.LinearDocument.AgentSessionEventWebhookPayload;
+/**
+ * Platform-agnostic issue unassigned webhook payload.
+ * Maps to Linear SDK's AppUserNotificationWebhookPayload.
+ */
+export type IssueUnassignedWebhook = LinearSDK.LinearDocument.AppUserNotificationWebhookPayload;
+/**
+ * Platform-agnostic union of all webhook types.
+ * Maps to Linear SDK's webhook payload union types.
+ */
+export type Webhook = LinearSDK.LinearDocument.AgentSessionEventWebhookPayload | LinearSDK.LinearDocument.AppUserNotificationWebhookPayload;
+/**
+ * Platform-agnostic guidance rule type.
+ * Maps to Linear SDK's GuidanceRuleWebhookPayload.
+ */
+export type GuidanceRule = LinearSDK.LinearDocument.GuidanceRuleWebhookPayload;
+/**
+ * Type guard to check if webhook is an agent session created event.
+ */
+export declare function isAgentSessionCreatedWebhook(webhook: Webhook): webhook is AgentSessionCreatedWebhook;
+/**
+ * Type guard to check if webhook is an agent session prompted event.
+ */
+export declare function isAgentSessionPromptedWebhook(webhook: Webhook): webhook is AgentSessionPromptedWebhook;
+/**
+ * Type guard to check if webhook is an issue assigned notification.
+ */
+export declare function isIssueAssignedWebhook(webhook: Webhook): webhook is LinearSDK.LinearDocument.AppUserNotificationWebhookPayload;
+/**
+ * Type guard to check if webhook is an issue comment mention notification.
+ */
+export declare function isIssueCommentMentionWebhook(webhook: Webhook): webhook is LinearSDK.LinearDocument.AppUserNotificationWebhookPayload;
+/**
+ * Type guard to check if webhook is an issue new comment notification.
+ */
+export declare function isIssueNewCommentWebhook(webhook: Webhook): webhook is LinearSDK.LinearDocument.AppUserNotificationWebhookPayload;
+/**
+ * Type guard to check if webhook is an issue unassigned notification.
+ */
+export declare function isIssueUnassignedWebhook(webhook: Webhook): webhook is IssueUnassignedWebhook;
+/**
+ * Pagination connection for list results.
+ * Based on Linear SDK's Connection pattern with PageInfo.
+ * Linear SDK is the source of truth for pagination patterns.
+ *
+ * @see {@link LinearSDK.LinearDocument.PageInfo} - Linear's PageInfo type
+ */
+export interface Connection<T> {
+    /** Array of items */
+    nodes: T[];
+    /** Page info for cursor-based pagination (from Linear SDK) */
+    pageInfo?: LinearSDK.LinearDocument.PageInfo;
+    /** Total count (if available) */
+    totalCount?: number;
+}
+/**
+ * Generic result type for operations.
+ */
+export interface OperationResult<T = unknown> {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Result data */
+    data?: T;
+    /** Error message if operation failed */
+    error?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/issue-tracker/types.d.ts.map

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