cyrus-core 0.2.2 → 0.2.4

package/dist/issue-tracker/types.js

@@ -0,0 +1,123 @@
+/**
+ * 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}
+ */
+/**
+ * Standard workflow state types across platforms.
+ */
+export var WorkflowStateType;
+(function (WorkflowStateType) {
+    WorkflowStateType["Triage"] = "triage";
+    WorkflowStateType["Backlog"] = "backlog";
+    WorkflowStateType["Unstarted"] = "unstarted";
+    WorkflowStateType["Started"] = "started";
+    WorkflowStateType["Completed"] = "completed";
+    WorkflowStateType["Canceled"] = "canceled";
+})(WorkflowStateType || (WorkflowStateType = {}));
+/**
+ * Issue priority levels (0 = no priority, 1 = urgent, 2 = high, 3 = normal, 4 = low).
+ */
+export var IssuePriority;
+(function (IssuePriority) {
+    IssuePriority[IssuePriority["NoPriority"] = 0] = "NoPriority";
+    IssuePriority[IssuePriority["Urgent"] = 1] = "Urgent";
+    IssuePriority[IssuePriority["High"] = 2] = "High";
+    IssuePriority[IssuePriority["Normal"] = 3] = "Normal";
+    IssuePriority[IssuePriority["Low"] = 4] = "Low";
+})(IssuePriority || (IssuePriority = {}));
+/**
+ * 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 };
+/**
+ * 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 };
+/**
+ * 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 };
+/**
+ * Legacy alias for AgentActivityType.
+ * @deprecated Use AgentActivityType instead
+ */
+export const AgentActivityContentType = AgentActivityType;
+/**
+ * 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 };
+/**
+ * Type guard to check if webhook is an agent session created event.
+ */
+export function isAgentSessionCreatedWebhook(webhook) {
+    return webhook.type === "AgentSessionEvent" && webhook.action === "created";
+}
+/**
+ * Type guard to check if webhook is an agent session prompted event.
+ */
+export function isAgentSessionPromptedWebhook(webhook) {
+    return webhook.type === "AgentSessionEvent" && webhook.action === "prompted";
+}
+/**
+ * Type guard to check if webhook is an issue assigned notification.
+ */
+export function isIssueAssignedWebhook(webhook) {
+    return (webhook.type === "AppUserNotification" &&
+        webhook.action === "issueAssignedToYou");
+}
+/**
+ * Type guard to check if webhook is an issue comment mention notification.
+ */
+export function isIssueCommentMentionWebhook(webhook) {
+    return (webhook.type === "AppUserNotification" &&
+        webhook.action === "issueCommentMention");
+}
+/**
+ * Type guard to check if webhook is an issue new comment notification.
+ */
+export function isIssueNewCommentWebhook(webhook) {
+    return (webhook.type === "AppUserNotification" &&
+        webhook.action === "issueNewComment");
+}
+/**
+ * Type guard to check if webhook is an issue unassigned notification.
+ */
+export function isIssueUnassignedWebhook(webhook) {
+    return (webhook.type === "AppUserNotification" &&
+        webhook.action === "issueUnassignedFromYou");
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/issue-tracker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0FH;;GAEG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC5B,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,0CAAqB,CAAA;AACtB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACxB,6DAAc,CAAA;IACd,qDAAU,CAAA;IACV,iDAAQ,CAAA;IACR,qDAAU,CAAA;IACV,+CAAO,CAAA;AACR,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAyCD;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAG9B;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAmB5B;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAY1D;;;;;;GAMG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAwR/B;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC3C,OAAgB;IAEhB,OAAO,OAAO,CAAC,IAAI,KAAK,mBAAmB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC5C,OAAgB;IAEhB,OAAO,OAAO,CAAC,IAAI,KAAK,mBAAmB,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,OAAgB;IAEhB,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,qBAAqB;QACtC,OAAO,CAAC,MAAM,KAAK,oBAAoB,CACvC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC3C,OAAgB;IAEhB,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,qBAAqB;QACtC,OAAO,CAAC,MAAM,KAAK,qBAAqB,CACxC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACvC,OAAgB;IAEhB,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,qBAAqB;QACtC,OAAO,CAAC,MAAM,KAAK,iBAAiB,CACpC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACvC,OAAgB;IAEhB,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,qBAAqB;QACtC,OAAO,CAAC,MAAM,KAAK,wBAAwB,CAC3C,CAAC;AACH,CAAC"}

package/dist/simple-agent-runner-types.d.ts

@@ -0,0 +1,206 @@
+import type { SDKMessage } from "@anthropic-ai/claude-agent-sdk";
+/**
+ * Simple Agent Runner Interface
+ *
+ * This interface provides a provider-agnostic abstraction for simple agent runners
+ * that return enumerated responses. It follows the same pattern as IAgentRunner,
+ * where type aliases point to provider-specific SDK types (currently Claude SDK).
+ *
+ * Simple agent runners are specialized agents that:
+ * - Accept a constrained set of valid responses (enumerated type T)
+ * - Run until they produce one of the valid responses
+ * - Validate the response before returning
+ * - Provide progress events during execution
+ *
+ * ## Architecture Pattern
+ *
+ * This abstraction uses type aliasing to external SDK types rather than creating
+ * new types. This approach:
+ * - Maintains compatibility with existing simple-agent-runner code
+ * - Allows gradual migration to provider-agnostic code
+ * - Enables adapter pattern implementations for other providers
+ * - Preserves type safety and IDE autocomplete
+ *
+ * ## Usage Example
+ *
+ * ```typescript
+ * type IssueAction = "fix" | "skip" | "clarify";
+ *
+ * const config: ISimpleAgentRunnerConfig<IssueAction> = {
+ *   validResponses: ["fix", "skip", "clarify"] as const,
+ *   systemPrompt: "You analyze issues and decide what to do",
+ *   cyrusHome: "/home/user/.cyrus",
+ *   onProgress: (event) => {
+ *     if (event.type === "response-detected") {
+ *       console.log(`Agent wants to: ${event.candidateResponse}`);
+ *     }
+ *   }
+ * };
+ *
+ * const runner = new SimpleAgentRunner(config);
+ * const result = await runner.query("What should I do with this bug?");
+ * console.log(`Decision: ${result.response}`); // "fix" | "skip" | "clarify"
+ * ```
+ *
+ * @see {@link ISimpleAgentRunnerConfig} for configuration options
+ * @see {@link ISimpleAgentResult} for result structure
+ * @see {@link IAgentProgressEvent} for progress event types
+ */
+export interface ISimpleAgentRunner<T extends string> {
+    /**
+     * Query the agent and get an enumerated response
+     *
+     * This method runs a complete agent session and returns one of the
+     * predefined valid responses. The agent will continue running until
+     * it produces a valid response or times out.
+     *
+     * @param question - The question or prompt to send to the agent
+     * @param options - Optional configuration for this specific query
+     * @returns A result containing the validated response and session metadata
+     * @throws Error if the agent times out or fails to produce a valid response
+     *
+     * @example
+     * ```typescript
+     * const result = await runner.query(
+     *   "Should we merge this PR?",
+     *   { context: "CI passed, 2 approvals", allowFileReading: true }
+     * );
+     * console.log(`Decision: ${result.response}`); // "approve" | "reject" | "request-changes"
+     * console.log(`Cost: $${result.costUSD}`);
+     * console.log(`Duration: ${result.durationMs}ms`);
+     * ```
+     */
+    query(question: string, options?: ISimpleAgentQueryOptions): Promise<ISimpleAgentResult<T>>;
+}
+/**
+ * Progress events emitted during agent execution
+ *
+ * These events allow monitoring the agent's progress as it works toward
+ * producing a valid response. Useful for logging, UI updates, or debugging.
+ *
+ * Event types:
+ * - `started`: Session has begun (includes sessionId)
+ * - `thinking`: Agent is processing (includes reasoning text)
+ * - `tool-use`: Agent is using a tool (includes tool name and input)
+ * - `response-detected`: Agent produced a candidate response (may be invalid)
+ * - `validating`: Checking if response is valid
+ */
+export type IAgentProgressEvent = {
+    type: "started";
+    sessionId: string | null;
+} | {
+    type: "thinking";
+    text: string;
+} | {
+    type: "tool-use";
+    toolName: string;
+    input: unknown;
+} | {
+    type: "response-detected";
+    candidateResponse: string;
+} | {
+    type: "validating";
+    response: string;
+};
+/**
+ * Configuration for Simple Agent Runner
+ *
+ * Defines how the simple agent runner should behave, including valid responses,
+ * prompts, timeouts, and progress callbacks.
+ *
+ * @template T - The enumerated string type for valid responses
+ *
+ * @example
+ * ```typescript
+ * type Priority = "low" | "medium" | "high" | "critical";
+ *
+ * const config: ISimpleAgentRunnerConfig<Priority> = {
+ *   validResponses: ["low", "medium", "high", "critical"] as const,
+ *   systemPrompt: "Analyze the issue and determine priority level",
+ *   maxTurns: 10,
+ *   timeoutMs: 60000,
+ *   model: "sonnet",
+ *   cyrusHome: "/home/user/.cyrus",
+ *   onProgress: (event) => {
+ *     console.log(`Agent progress: ${event.type}`);
+ *   }
+ * };
+ * ```
+ */
+export interface ISimpleAgentRunnerConfig<T extends string> {
+    /** Valid response options that the agent must choose from */
+    validResponses: readonly T[];
+    /** System prompt to guide the agent's behavior */
+    systemPrompt?: string;
+    /** Maximum number of turns before timeout */
+    maxTurns?: number;
+    /** Timeout in milliseconds for the entire operation */
+    timeoutMs?: number;
+    /** Model to use (e.g., "sonnet", "haiku") */
+    model?: string;
+    /** Fallback model if primary is unavailable */
+    fallbackModel?: string;
+    /** Working directory for agent execution */
+    workingDirectory?: string;
+    /** Cyrus home directory */
+    cyrusHome: string;
+    /** Optional callback for progress events */
+    onProgress?: (event: IAgentProgressEvent) => void;
+}
+/**
+ * Result from a Simple Agent Runner query
+ *
+ * Contains the validated response along with session metadata including
+ * messages, duration, cost, and session ID.
+ *
+ * @template T - The enumerated string type for valid responses
+ *
+ * @example
+ * ```typescript
+ * const result: ISimpleAgentResult<"approve" | "reject"> = {
+ *   response: "approve",
+ *   messages: [...],  // All SDK messages from the session
+ *   sessionId: "claude-session-123",
+ *   durationMs: 5432,
+ *   costUSD: 0.0234
+ * };
+ * ```
+ */
+export interface ISimpleAgentResult<T extends string> {
+    /** The validated response from the agent */
+    response: T;
+    /** All SDK messages from the session */
+    messages: SDKMessage[];
+    /** Session ID for debugging/logging */
+    sessionId: string | null;
+    /** Duration of execution in milliseconds */
+    durationMs: number;
+    /** Cost in USD (if available) */
+    costUSD?: number;
+}
+/**
+ * Options for a Simple Agent Runner query
+ *
+ * Provides additional configuration that can be specified per-query
+ * to customize behavior beyond the runner's base configuration.
+ *
+ * @example
+ * ```typescript
+ * const options: ISimpleAgentQueryOptions = {
+ *   context: "User has premium subscription, last login was 2 days ago",
+ *   allowFileReading: true,
+ *   allowedDirectories: ["/home/user/project/src"]
+ * };
+ *
+ * const result = await runner.query("Should we send a reminder email?", options);
+ * ```
+ */
+export interface ISimpleAgentQueryOptions {
+    /** Additional context to provide to the agent */
+    context?: string;
+    /** Allow the agent to use file reading tools */
+    allowFileReading?: boolean;
+    /** Allowed directories for file operations */
+    allowedDirectories?: string[];
+}
+//# sourceMappingURL=simple-agent-runner-types.d.ts.map

package/dist/simple-agent-runner-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-agent-runner-types.d.ts","sourceRoot":"","sources":["../src/simple-agent-runner-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM;IACnD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CACJ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,MAAM;IACzD,6DAA6D;IAC7D,cAAc,EAAE,SAAS,CAAC,EAAE,CAAC;IAE7B,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM;IACnD,4CAA4C;IAC5C,QAAQ,EAAE,CAAC,CAAC;IAEZ,wCAAwC;IACxC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB,uCAAuC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,wBAAwB;IACxC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B"}

package/dist/simple-agent-runner-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=simple-agent-runner-types.js.map

package/dist/simple-agent-runner-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-agent-runner-types.js","sourceRoot":"","sources":["../src/simple-agent-runner-types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cyrus-core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Core business logic for Cyrus",
   "type": "module",
   "main": "dist/index.js",
@@ -9,11 +9,12 @@
     "dist"
   ],
   "dependencies": {
-    "@linear/sdk": "^60.0.0",
-    "cyrus-claude-runner": "0.2.2"
+    "@anthropic-ai/claude-agent-sdk": "^0.1.52",
+    "@linear/sdk": "^64.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "fastify": "^5.6.1",
     "typescript": "^5.3.3",
     "vitest": "^1.1.0"
   },

package/dist/webhook-types.d.ts

@@ -1,259 +0,0 @@
-/**
- * Linear webhook types based on actual webhook payloads
- * These are the exact structures Linear sends in webhooks
- */
-import type { LinearDocument } from "@linear/sdk";
-/**
- * Linear team data from webhooks
- */
-export interface LinearWebhookTeam {
-    id: string;
-    key: string;
-    name: string;
-}
-/**
- * Linear issue data from webhooks
- */
-export interface LinearWebhookIssue {
-    id: string;
-    title: string;
-    teamId: string;
-    team: LinearWebhookTeam;
-    identifier: string;
-    url: string;
-}
-/**
- * Linear comment data from webhooks
- */
-export interface LinearWebhookComment {
-    id: string;
-    body: string;
-    userId: string;
-    issueId: string;
-}
-/**
- * Linear actor (user) data from webhooks
- */
-export interface LinearWebhookActor {
-    id: string;
-    name: string;
-    email: string;
-    url: string;
-}
-/**
- * Base notification structure common to all webhook notifications
- */
-export interface LinearWebhookNotificationBase {
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    archivedAt: string | null;
-    actorId: string;
-    externalUserActorId: string | null;
-    userId: string;
-    issueId: string;
-    issue: LinearWebhookIssue;
-    actor: LinearWebhookActor;
-}
-/**
- * Issue assignment notification
- */
-export interface LinearIssueAssignedNotification extends LinearWebhookNotificationBase {
-    type: "issueAssignedToYou";
-}
-/**
- * Issue comment mention notification
- */
-export interface LinearIssueCommentMentionNotification extends LinearWebhookNotificationBase {
-    type: "issueCommentMention";
-    commentId: string;
-    comment: LinearWebhookComment;
-}
-/**
- * Issue new comment notification (can have parent comment for replies)
- */
-export interface LinearIssueNewCommentNotification extends LinearWebhookNotificationBase {
-    type: "issueNewComment";
-    commentId: string;
-    comment: LinearWebhookComment;
-    parentCommentId?: string;
-    parentComment?: LinearWebhookComment;
-}
-/**
- * Issue unassignment notification
- */
-export interface LinearIssueUnassignedNotification extends LinearWebhookNotificationBase {
-    type: "issueUnassignedFromYou";
-    actorId: string;
-    externalUserActorId: string | null;
-    userId: string;
-    issueId: string;
-    issue: LinearWebhookIssue;
-    actor: LinearWebhookActor;
-}
-/**
- * Union of all notification types
- */
-export type LinearWebhookNotification = LinearIssueAssignedNotification | LinearIssueCommentMentionNotification | LinearIssueNewCommentNotification | LinearIssueUnassignedNotification;
-/**
- * Issue assignment webhook payload
- */
-export interface LinearIssueAssignedWebhook {
-    type: "AppUserNotification";
-    action: "issueAssignedToYou";
-    createdAt: string;
-    organizationId: string;
-    oauthClientId: string;
-    appUserId: string;
-    notification: LinearIssueAssignedNotification;
-    webhookTimestamp: number;
-    webhookId: string;
-}
-/**
- * Issue comment mention webhook payload
- */
-export interface LinearIssueCommentMentionWebhook {
-    type: "AppUserNotification";
-    action: "issueCommentMention";
-    createdAt: string;
-    organizationId: string;
-    oauthClientId: string;
-    appUserId: string;
-    notification: LinearIssueCommentMentionNotification;
-    webhookTimestamp: number;
-    webhookId: string;
-}
-/**
- * Issue new comment webhook payload
- */
-export interface LinearIssueNewCommentWebhook {
-    type: "AppUserNotification";
-    action: "issueNewComment";
-    createdAt: string;
-    organizationId: string;
-    oauthClientId: string;
-    appUserId: string;
-    notification: LinearIssueNewCommentNotification;
-    webhookTimestamp: number;
-    webhookId: string;
-}
-/**
- * Issue unassignment webhook payload
- */
-export interface LinearIssueUnassignedWebhook {
-    type: "AppUserNotification";
-    action: "issueUnassignedFromYou";
-    createdAt: string;
-    organizationId: string;
-    oauthClientId: string;
-    appUserId: string;
-    notification: LinearIssueUnassignedNotification;
-    webhookTimestamp: number;
-    webhookId: string;
-}
-/**
- * Creator data in agent session webhooks
- */
-export interface LinearWebhookCreator {
-    id: string;
-    name: string;
-    email: string;
-    avatarUrl: string;
-    url: string;
-}
-/**
- * Agent guidance types - re-exported from @linear/sdk for convenience
- */
-export type LinearWebhookGuidanceRule = LinearDocument.GuidanceRuleWebhookPayload;
-export type LinearWebhookOrganizationOrigin = LinearDocument.OrganizationOriginWebhookPayload;
-export type LinearWebhookTeamOrigin = LinearDocument.TeamOriginWebhookPayload;
-export type LinearWebhookTeamWithParent = LinearDocument.TeamWithParentWebhookPayload;
-/**
- * Agent Session data from webhooks
- */
-export interface LinearWebhookAgentSession {
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    archivedAt: string | null;
-    creatorId: string;
-    appUserId: string;
-    commentId: string;
-    issueId: string;
-    status: "pending" | "active" | "error" | "awaiting-input" | "complete";
-    startedAt: string | null;
-    endedAt: string | null;
-    type: "commentThread";
-    summary: string | null;
-    sourceMetadata: any | null;
-    organizationId: string;
-    creator: LinearWebhookCreator;
-    comment: LinearWebhookComment;
-    issue: LinearWebhookIssue;
-}
-/**
- * Agent Activity content types
- */
-export interface LinearWebhookAgentActivityContent {
-    type: "prompt" | "observation" | "action" | "error" | "elicitation" | "response";
-    body: string;
-}
-/**
- * Agent Activity data from webhooks
- */
-export interface LinearWebhookAgentActivity {
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    archivedAt: string | null;
-    agentContextId: string | null;
-    agentSessionId: string;
-    sourceCommentId: string;
-    content: LinearWebhookAgentActivityContent;
-    signal?: "stop";
-}
-/**
- * Agent Session created webhook payload
- */
-export interface LinearAgentSessionCreatedWebhook {
-    type: "AgentSessionEvent";
-    action: "created";
-    createdAt: string;
-    organizationId: string;
-    oauthClientId: string;
-    appUserId: string;
-    agentSession: LinearWebhookAgentSession;
-    guidance?: LinearWebhookGuidanceRule[];
-    webhookTimestamp: string;
-    webhookId: string;
-}
-/**
- * Agent Session prompted webhook payload
- */
-export interface LinearAgentSessionPromptedWebhook {
-    type: "AgentSessionEvent";
-    action: "prompted";
-    createdAt: string;
-    organizationId: string;
-    oauthClientId: string;
-    appUserId: string;
-    agentSession: LinearWebhookAgentSession;
-    agentActivity: LinearWebhookAgentActivity;
-    guidance?: LinearWebhookGuidanceRule[];
-    webhookTimestamp: string;
-    webhookId: string;
-}
-/**
- * Union of all webhook types we handle
- */
-export type LinearWebhook = LinearIssueAssignedWebhook | LinearIssueCommentMentionWebhook | LinearIssueNewCommentWebhook | LinearIssueUnassignedWebhook | LinearAgentSessionCreatedWebhook | LinearAgentSessionPromptedWebhook;
-/**
- * Type guards for webhook discrimination
- */
-export declare function isIssueAssignedWebhook(webhook: LinearWebhook): webhook is LinearIssueAssignedWebhook;
-export declare function isIssueCommentMentionWebhook(webhook: LinearWebhook): webhook is LinearIssueCommentMentionWebhook;
-export declare function isIssueNewCommentWebhook(webhook: LinearWebhook): webhook is LinearIssueNewCommentWebhook;
-export declare function isIssueUnassignedWebhook(webhook: LinearWebhook): webhook is LinearIssueUnassignedWebhook;
-export declare function isAgentSessionCreatedWebhook(webhook: LinearWebhook): webhook is LinearAgentSessionCreatedWebhook;
-export declare function isAgentSessionPromptedWebhook(webhook: LinearWebhook): webhook is LinearAgentSessionPromptedWebhook;
-//# sourceMappingURL=webhook-types.d.ts.map

package/dist/webhook-types.d.ts.map

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

package/dist/webhook-types.js

@@ -1,26 +0,0 @@
-/**
- * Linear webhook types based on actual webhook payloads
- * These are the exact structures Linear sends in webhooks
- */
-/**
- * Type guards for webhook discrimination
- */
-export function isIssueAssignedWebhook(webhook) {
-    return webhook.action === "issueAssignedToYou";
-}
-export function isIssueCommentMentionWebhook(webhook) {
-    return webhook.action === "issueCommentMention";
-}
-export function isIssueNewCommentWebhook(webhook) {
-    return webhook.action === "issueNewComment";
-}
-export function isIssueUnassignedWebhook(webhook) {
-    return webhook.action === "issueUnassignedFromYou";
-}
-export function isAgentSessionCreatedWebhook(webhook) {
-    return webhook.type === "AgentSessionEvent" && webhook.action === "created";
-}
-export function isAgentSessionPromptedWebhook(webhook) {
-    return webhook.type === "AgentSessionEvent" && webhook.action === "prompted";
-}
-//# sourceMappingURL=webhook-types.js.map

package/dist/webhook-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"webhook-types.js","sourceRoot":"","sources":["../src/webhook-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqSH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,OAAsB;IAEtB,OAAO,OAAO,CAAC,MAAM,KAAK,oBAAoB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC3C,OAAsB;IAEtB,OAAO,OAAO,CAAC,MAAM,KAAK,qBAAqB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACvC,OAAsB;IAEtB,OAAO,OAAO,CAAC,MAAM,KAAK,iBAAiB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,wBAAwB,CACvC,OAAsB;IAEtB,OAAO,OAAO,CAAC,MAAM,KAAK,wBAAwB,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC3C,OAAsB;IAEtB,OAAO,OAAO,CAAC,IAAI,KAAK,mBAAmB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC5C,OAAsB;IAEtB,OAAO,OAAO,CAAC,IAAI,KAAK,mBAAmB,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;AAC9E,CAAC"}