@supaku/agentfactory-linear 0.1.2 → 0.3.0

package/dist/src/index.d.ts

@@ -12,4 +12,5 @@ export { parseCheckboxes, updateCheckbox, updateCheckboxByText, updateCheckboxes
 export type { CheckboxItem, CheckboxUpdate } from './checkbox-utils';
 export { LinearAgentClient, createLinearAgentClient } from './agent-client';
 export { AgentSession, createAgentSession } from './agent-session';
+export * from './webhook-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,aAAa,EAEb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EAEpB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAGvD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,oBAAoB,EACpB,KAAK,EACL,cAAc,EACd,SAAS,EACT,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG5E,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGvD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGpE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAG3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,aAAa,EAEb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EAEpB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAGvD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,oBAAoB,EACpB,KAAK,EACL,cAAc,EACd,SAAS,EACT,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG5E,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGvD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGpE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAG3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGlE,cAAc,iBAAiB,CAAA"}

package/dist/src/index.js

@@ -14,3 +14,5 @@ export { parseCheckboxes, updateCheckbox, updateCheckboxByText, updateCheckboxes
 export { LinearAgentClient, createLinearAgentClient } from './agent-client';
 // Session
 export { AgentSession, createAgentSession } from './agent-session';
+// Webhook types
+export * from './webhook-types';

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

@@ -0,0 +1,308 @@
+/**
+ * Linear Webhook Payload Types
+ *
+ * Types for processing Linear webhook events, including:
+ * - AgentSession events (created, prompted, updated, removed)
+ * - Issue update events
+ *
+ * @see https://linear.app/developers/webhooks
+ * @see https://linear.app/developers/agent-interaction
+ */
+import type { AgentActivitySignal } from './types';
+/**
+ * Standard webhook action types for most Linear resources
+ */
+export type WebhookAction = 'create' | 'update' | 'remove';
+/**
+ * AgentSession-specific webhook action types
+ * Note: Linear sends past-tense actions (created, updated, removed)
+ * - created: New session initiated by user mention or delegation
+ * - prompted: User sent a follow-up message to an existing session
+ * - updated: Session state changed
+ * - removed: Session was deleted
+ */
+export type AgentSessionAction = 'created' | 'prompted' | 'updated' | 'removed';
+/**
+ * User who initiated or is responsible for the session
+ */
+export interface WebhookUser {
+    id: string;
+    name: string;
+    email?: string;
+    displayName?: string;
+    avatarUrl?: string;
+}
+/**
+ * Comment data included in webhook payloads
+ */
+export interface WebhookComment {
+    id: string;
+    body: string;
+    createdAt: string;
+    user?: WebhookUser;
+    parentId?: string;
+}
+/**
+ * Issue data included in webhook payloads
+ */
+export interface WebhookIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    url: string;
+    state?: {
+        id: string;
+        name: string;
+        type: string;
+    };
+    team?: {
+        id: string;
+        name: string;
+        key: string;
+    };
+    labels?: Array<{
+        id: string;
+        name: string;
+        color?: string;
+    }>;
+    project?: {
+        id: string;
+        name: string;
+    };
+    parent?: {
+        id: string;
+        identifier: string;
+        title: string;
+    };
+}
+/**
+ * Base Linear webhook payload
+ * All webhook events contain these common fields
+ */
+export interface LinearWebhookPayload {
+    /** The action that triggered this webhook */
+    action: WebhookAction | AgentSessionAction;
+    /** The type of resource this webhook is for */
+    type: string;
+    /** The resource data */
+    data: Record<string, unknown>;
+    /** URL to the resource in Linear */
+    url?: string;
+    /** ISO timestamp when the event occurred */
+    createdAt: string;
+    /** ID of the organization this webhook belongs to */
+    organizationId?: string;
+    /** Unix timestamp when the webhook was sent */
+    webhookTimestamp?: number;
+    /** Unique ID for this webhook delivery */
+    webhookId?: string;
+}
+/**
+ * AgentSession state values in webhook payloads.
+ *
+ * Named `LinearSessionState` to distinguish from:
+ * - `AgentSessionState` (Linear Agent SDK states: pending, active, error, awaitingInput, complete)
+ * - `AgentSessionStatus` (Redis session tracking states)
+ */
+export type LinearSessionState = 'created' | 'running' | 'completed' | 'failed';
+/**
+ * Base AgentSession data common to all session events
+ */
+export interface AgentSessionData {
+    /** Unique session ID */
+    id: string;
+    /** ID of the issue this session is working on */
+    issueId: string;
+    /** ID of the agent assigned to this session */
+    agentId: string;
+    /** Current state of the session */
+    state: LinearSessionState;
+    /** External URL for the agent's work (e.g., PR link) */
+    externalUrl?: string;
+    /** Allow additional unknown fields from webhook payload */
+    [key: string]: unknown;
+}
+/**
+ * Extended AgentSession data for 'create' events
+ * Includes context needed to start working on an issue
+ */
+export interface AgentSessionCreatedData extends AgentSessionData {
+    /**
+     * Formatted prompt string containing relevant context for the agent session.
+     * Includes issue details, comments, and guidance.
+     * Present only for 'create' events.
+     */
+    promptContext?: string;
+    /**
+     * Previous comments in the thread before this agent was mentioned.
+     * Present only for 'create' events where the session was initiated
+     * by mentioning the agent in a child comment of a thread.
+     */
+    previousComments?: WebhookComment[];
+    /**
+     * Guidance to inform the agent's behavior.
+     * Comes from configuration at workspace, parent teams, and/or current team.
+     * The nearest team-specific guidance takes highest precedence.
+     */
+    guidance?: string;
+    /**
+     * The human user responsible for initiating this session.
+     * Unset if the session was initiated via automation or by an agent user.
+     */
+    user?: WebhookUser;
+    /**
+     * Full issue data for the session
+     */
+    issue?: WebhookIssue;
+    /**
+     * The comment that triggered this session (if initiated via comment mention)
+     */
+    comment?: WebhookComment;
+}
+/**
+ * Agent activity included in prompted webhooks
+ * This can indicate special signals like 'stop' from the user
+ */
+export interface WebhookAgentActivity {
+    /** The type of activity */
+    type?: string;
+    /** Signal modifier for the activity */
+    signal?: AgentActivitySignal;
+    /** Activity content/body */
+    body?: string;
+}
+/**
+ * Extended AgentSession data for 'prompted' events
+ * Includes the follow-up message from the user
+ */
+export interface AgentSessionPromptedData extends AgentSessionData {
+    /**
+     * The follow-up prompt/message from the user.
+     * Present when user sends a message to an existing session.
+     */
+    promptContext?: string;
+    /**
+     * The user who sent the follow-up message
+     */
+    user?: WebhookUser;
+    /**
+     * The comment containing the follow-up message
+     */
+    comment?: WebhookComment;
+    /**
+     * Agent activity associated with this prompt.
+     * May contain a 'stop' signal if the user clicked Stop.
+     * @see https://linear.app/developers/agent-signals
+     */
+    agentActivity?: WebhookAgentActivity;
+}
+/**
+ * AgentSession data for 'update' events
+ */
+export interface AgentSessionUpdatedData extends AgentSessionData {
+    /** Previous values before the update */
+    updatedFrom?: {
+        state?: LinearSessionState;
+        externalUrl?: string;
+    };
+}
+/**
+ * Webhook payload for AgentSession 'created' events
+ * Triggered when a new agent session is initiated by mention or delegation
+ */
+export interface AgentSessionCreatedPayload extends LinearWebhookPayload {
+    type: 'AgentSessionEvent';
+    action: 'created';
+    data: AgentSessionCreatedData;
+}
+/**
+ * Webhook payload for AgentSession 'prompted' events
+ * Triggered when a user sends a follow-up message to an existing session
+ */
+export interface AgentSessionPromptedPayload extends LinearWebhookPayload {
+    type: 'AgentSessionEvent';
+    action: 'prompted';
+    data: AgentSessionPromptedData;
+}
+/**
+ * Webhook payload for AgentSession 'updated' events
+ * Triggered when session state changes
+ */
+export interface AgentSessionUpdatedPayload extends LinearWebhookPayload {
+    type: 'AgentSessionEvent';
+    action: 'updated';
+    data: AgentSessionUpdatedData;
+}
+/**
+ * Webhook payload for AgentSession 'removed' events
+ * Triggered when a session is deleted
+ */
+export interface AgentSessionRemovedPayload extends LinearWebhookPayload {
+    type: 'AgentSessionEvent';
+    action: 'removed';
+    data: AgentSessionData;
+}
+/**
+ * Union type for all AgentSession webhook payloads
+ */
+export type AgentSessionPayload = AgentSessionCreatedPayload | AgentSessionPromptedPayload | AgentSessionUpdatedPayload | AgentSessionRemovedPayload;
+/**
+ * Type guard to check if a payload is an AgentSession event
+ */
+export declare function isAgentSessionPayload(payload: LinearWebhookPayload): payload is AgentSessionPayload;
+/**
+ * Type guard for AgentSession 'created' events
+ */
+export declare function isAgentSessionCreated(payload: LinearWebhookPayload): payload is AgentSessionCreatedPayload;
+/**
+ * Type guard for AgentSession 'prompted' events (follow-up messages)
+ */
+export declare function isAgentSessionPrompted(payload: LinearWebhookPayload): payload is AgentSessionPromptedPayload;
+/**
+ * Type guard for AgentSession 'updated' events
+ */
+export declare function isAgentSessionUpdated(payload: LinearWebhookPayload): payload is AgentSessionUpdatedPayload;
+/**
+ * Type guard for AgentSession 'removed' events
+ */
+export declare function isAgentSessionRemoved(payload: LinearWebhookPayload): payload is AgentSessionRemovedPayload;
+/**
+ * Issue state information in webhook payloads
+ */
+export interface WebhookIssueState {
+    id: string;
+    name: string;
+    type: string;
+}
+/**
+ * Extended issue data for Issue update webhooks
+ */
+export interface IssueUpdateData extends WebhookIssue {
+    state: WebhookIssueState;
+    assignee?: WebhookUser;
+    /** Allow additional unknown fields */
+    [key: string]: unknown;
+}
+/**
+ * Webhook payload for Issue update events
+ * @see https://linear.app/developers/webhooks
+ */
+export interface IssueUpdatePayload extends LinearWebhookPayload {
+    type: 'Issue';
+    action: 'update';
+    data: IssueUpdateData;
+    /** Previous values before the update */
+    updatedFrom: {
+        stateId?: string;
+        assigneeId?: string;
+        [key: string]: unknown;
+    };
+    /** The actor who made the change */
+    actor?: WebhookUser;
+}
+/**
+ * Type guard for Issue update events
+ */
+export declare function isIssueUpdate(payload: LinearWebhookPayload): payload is IssueUpdatePayload;
+//# sourceMappingURL=webhook-types.d.ts.map

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

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

package/dist/src/webhook-types.js

@@ -0,0 +1,46 @@
+/**
+ * Linear Webhook Payload Types
+ *
+ * Types for processing Linear webhook events, including:
+ * - AgentSession events (created, prompted, updated, removed)
+ * - Issue update events
+ *
+ * @see https://linear.app/developers/webhooks
+ * @see https://linear.app/developers/agent-interaction
+ */
+/**
+ * Type guard to check if a payload is an AgentSession event
+ */
+export function isAgentSessionPayload(payload) {
+    return payload.type === 'AgentSessionEvent';
+}
+/**
+ * Type guard for AgentSession 'created' events
+ */
+export function isAgentSessionCreated(payload) {
+    return payload.type === 'AgentSessionEvent' && payload.action === 'created';
+}
+/**
+ * Type guard for AgentSession 'prompted' events (follow-up messages)
+ */
+export function isAgentSessionPrompted(payload) {
+    return payload.type === 'AgentSessionEvent' && payload.action === 'prompted';
+}
+/**
+ * Type guard for AgentSession 'updated' events
+ */
+export function isAgentSessionUpdated(payload) {
+    return payload.type === 'AgentSessionEvent' && payload.action === 'updated';
+}
+/**
+ * Type guard for AgentSession 'removed' events
+ */
+export function isAgentSessionRemoved(payload) {
+    return payload.type === 'AgentSessionEvent' && payload.action === 'removed';
+}
+/**
+ * Type guard for Issue update events
+ */
+export function isIssueUpdate(payload) {
+    return payload.type === 'Issue' && payload.action === 'update';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supaku/agentfactory-linear",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "type": "module",
   "description": "Linear issue tracker integration for AgentFactory — status transitions, agent sessions, work routing",
   "author": "Supaku (https://supaku.com)",