eve 0.5.4 → 0.6.0-beta.3

package/dist/src/public/channels/linear/api.d.ts

@@ -0,0 +1,122 @@
+import { type LinearChannelCredentials } from "#public/channels/linear/auth.js";
+import { type JsonObject } from "#shared/json.js";
+export type LinearFetch = typeof fetch;
+/** Transport options for Linear GraphQL calls. */
+export interface LinearApiOptions {
+    /** Defaults to `https://api.linear.app/graphql`. */
+    readonly apiBaseUrl?: string;
+    /** Test/fetch override. */
+    readonly fetch?: LinearFetch;
+}
+export type LinearAgentActivitySignal = "auth" | "continue" | "select" | "stop";
+export type LinearAgentActivityContent = {
+    readonly body: string;
+    readonly type: "elicitation" | "error" | "response" | "thought";
+} | {
+    readonly action: string;
+    readonly parameter: string;
+    readonly result?: string;
+    readonly type: "action";
+};
+export interface LinearAgentActivityCreateInput {
+    agentSessionId: string;
+    content: LinearAgentActivityContent;
+    ephemeral?: boolean;
+    signal?: LinearAgentActivitySignal;
+    signalMetadata?: JsonObject;
+}
+export interface LinearExternalUrl {
+    label: string;
+    url: string;
+}
+export interface LinearAgentSessionUpdateInput {
+    addedExternalUrls?: readonly LinearExternalUrl[];
+    externalLink?: string;
+    externalUrls?: readonly LinearExternalUrl[];
+    plan?: JsonObject;
+    removedExternalUrls?: readonly string[];
+}
+export interface LinearAgentSessionRecord {
+    appUserId?: string;
+    commentId?: string | null;
+    creatorId?: string | null;
+    id: string;
+    issue?: {
+        id: string;
+        identifier?: string;
+        title?: string;
+        url?: string;
+    } | null;
+    issueId?: string | null;
+    organizationId?: string;
+    sourceCommentId?: string | null;
+    status?: string;
+    url?: string | null;
+}
+export interface LinearAgentActivityRecord {
+    content: {
+        body?: string;
+        type?: string;
+        __typename?: string;
+    };
+    id: string;
+    updatedAt?: string;
+}
+export declare class LinearApiError extends Error {
+    readonly body: unknown;
+    readonly queryName: string;
+    readonly status: number;
+    constructor(input: {
+        readonly body: unknown;
+        readonly queryName: string;
+        readonly status: number;
+    });
+}
+export declare function callLinearGraphQL<T>(input: {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly query: string;
+    readonly queryName: string;
+    readonly variables?: JsonObject;
+}): Promise<T>;
+/** Emits one semantic Agent Activity into a Linear Agent Session. */
+export declare function createLinearAgentActivity(input: {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly activity: LinearAgentActivityCreateInput;
+}): Promise<{
+    readonly id: string;
+    readonly success: boolean;
+}>;
+/** Updates mutable Agent Session fields such as external URLs and plan. */
+export declare function updateLinearAgentSession(input: {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly id: string;
+    readonly update: LinearAgentSessionUpdateInput;
+}): Promise<{
+    readonly success: boolean;
+}>;
+/** Creates a proactive Agent Session attached to a Linear issue. */
+export declare function createLinearAgentSessionOnIssue(input: {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly issueId: string;
+    readonly externalLink?: string;
+    readonly externalUrls?: readonly LinearExternalUrl[];
+}): Promise<LinearAgentSessionRecord>;
+/** Creates a proactive Agent Session attached to a Linear root comment. */
+export declare function createLinearAgentSessionOnComment(input: {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly commentId: string;
+    readonly externalLink?: string;
+    readonly externalUrls?: readonly LinearExternalUrl[];
+}): Promise<LinearAgentSessionRecord>;
+/** Reads recent Agent Activities for reconstructing Linear-native HITL replies. */
+export declare function listLinearAgentSessionActivities(input: {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly agentSessionId: string;
+    readonly last?: number;
+}): Promise<readonly LinearAgentActivityRecord[]>;

package/dist/src/public/channels/linear/api.js

@@ -0,0 +1,69 @@
+import{isObject}from"#shared/guards.js";import{parseJsonObject}from"#shared/json.js";import{resolveLinearAccessToken}from"#public/channels/linear/auth.js";var LinearApiError=class extends Error{body;queryName;status;constructor(e){super(`Linear GraphQL ${e.queryName} failed with HTTP ${e.status}.`),this.name=`LinearApiError`,this.body=e.body,this.queryName=e.queryName,this.status=e.status}};async function callLinearGraphQL(t){let r=t.api?.fetch??fetch,i=await resolveLinearAccessToken(t.credentials?.accessToken),a=await r(t.api?.apiBaseUrl??`https://api.linear.app/graphql`,{body:JSON.stringify({query:t.query,variables:t.variables??{}}),headers:{authorization:`Bearer ${i}`,"content-type":`application/json; charset=utf-8`},method:`POST`}),o=await parseResponseBody(a);if(!a.ok||hasGraphQLErrors(o)||!isObject(o)||!isObject(o.data))throw new LinearApiError({body:o,queryName:t.queryName,status:a.status});return o.data}async function createLinearAgentActivity(e){let n=(await callLinearGraphQL({api:e.api,credentials:e.credentials,query:`
+      mutation AgentActivityCreate($input: AgentActivityCreateInput!) {
+        agentActivityCreate(input: $input) {
+          success
+          agentActivity { id }
+        }
+      }
+    `,queryName:`AgentActivityCreate`,variables:{input:parseJsonObject(e.activity)}})).agentActivityCreate,r=n?.agentActivity?.id;return{id:typeof r==`string`?r:``,success:n?.success===!0}}async function updateLinearAgentSession(e){return{success:(await callLinearGraphQL({api:e.api,credentials:e.credentials,query:`
+      mutation AgentSessionUpdate($id: String!, $input: AgentSessionUpdateInput!) {
+        agentSessionUpdate(id: $id, input: $input) {
+          success
+        }
+      }
+    `,queryName:`AgentSessionUpdate`,variables:{id:e.id,input:parseJsonObject(e.update)}})).agentSessionUpdate?.success===!0}}async function createLinearAgentSessionOnIssue(e){return normalizeAgentSessionRecord((await callLinearGraphQL({api:e.api,credentials:e.credentials,query:`
+      mutation AgentSessionCreateOnIssue($input: AgentSessionCreateOnIssue!) {
+        agentSessionCreateOnIssue(input: $input) {
+          success
+          agentSession {
+            id
+            appUserId
+            commentId
+            creator { id }
+            issue { id identifier title url }
+            issueId
+            organizationId
+            sourceCommentId
+            status
+            url
+          }
+        }
+      }
+    `,queryName:`AgentSessionCreateOnIssue`,variables:{input:parseJsonObject({externalLink:e.externalLink,externalUrls:e.externalUrls,issueId:e.issueId})}})).agentSessionCreateOnIssue?.agentSession)}async function createLinearAgentSessionOnComment(e){return normalizeAgentSessionRecord((await callLinearGraphQL({api:e.api,credentials:e.credentials,query:`
+      mutation AgentSessionCreateOnComment($input: AgentSessionCreateOnComment!) {
+        agentSessionCreateOnComment(input: $input) {
+          success
+          agentSession {
+            id
+            appUserId
+            commentId
+            creator { id }
+            issue { id identifier title url }
+            issueId
+            organizationId
+            sourceCommentId
+            status
+            url
+          }
+        }
+      }
+    `,queryName:`AgentSessionCreateOnComment`,variables:{input:parseJsonObject({commentId:e.commentId,externalLink:e.externalLink,externalUrls:e.externalUrls})}})).agentSessionCreateOnComment?.agentSession)}async function listLinearAgentSessionActivities(e){let t=(await callLinearGraphQL({api:e.api,credentials:e.credentials,query:`
+      query AgentSessionActivities($id: String!, $last: Int!) {
+        agentSession(id: $id) {
+          activities(last: $last) {
+            nodes {
+              id
+              updatedAt
+              content {
+                __typename
+                ... on AgentActivityElicitationContent { body type }
+                ... on AgentActivityPromptContent { body type }
+                ... on AgentActivityResponseContent { body type }
+                ... on AgentActivityThoughtContent { body type }
+                ... on AgentActivityErrorContent { body type }
+              }
+            }
+          }
+        }
+      }
+    `,queryName:`AgentSessionActivities`,variables:{id:e.agentSessionId,last:e.last??20}})).agentSession?.activities?.nodes;return Array.isArray(t)?t.map(normalizeAgentActivityRecord).filter(notNull):[]}function normalizeAgentSessionRecord(t){if(!isObject(t)||typeof t.id!=`string`)throw Error(`linearChannel: Linear Agent Session response was malformed.`);let n=isObject(t.creator)?t.creator:void 0,r=normalizeIssue(t.issue),i={id:t.id};return typeof t.appUserId==`string`&&(i.appUserId=t.appUserId),(typeof t.commentId==`string`||t.commentId===null)&&(i.commentId=t.commentId),(typeof n?.id==`string`||n===void 0)&&(i.creatorId=typeof n?.id==`string`?n.id:null),r!==void 0&&(i.issue=r),(typeof t.issueId==`string`||t.issueId===null)&&(i.issueId=t.issueId),typeof t.organizationId==`string`&&(i.organizationId=t.organizationId),(typeof t.sourceCommentId==`string`||t.sourceCommentId===null)&&(i.sourceCommentId=t.sourceCommentId),typeof t.status==`string`&&(i.status=t.status),(typeof t.url==`string`||t.url===null)&&(i.url=t.url),i}function normalizeAgentActivityRecord(t){if(!isObject(t)||typeof t.id!=`string`||!isObject(t.content))return null;let n={};typeof t.content.body==`string`&&(n.body=t.content.body),typeof t.content.type==`string`&&(n.type=t.content.type),typeof t.content.__typename==`string`&&(n.__typename=t.content.__typename);let r={content:n,id:t.id};return typeof t.updatedAt==`string`&&(r.updatedAt=t.updatedAt),r}function normalizeIssue(t){if(t===null)return null;if(!isObject(t)||typeof t.id!=`string`)return;let n={id:t.id};return typeof t.identifier==`string`&&(n.identifier=t.identifier),typeof t.title==`string`&&(n.title=t.title),typeof t.url==`string`&&(n.url=t.url),n}async function parseResponseBody(e){let t=await e.text();if(!t)return null;try{return JSON.parse(t)}catch{return t}}function hasGraphQLErrors(t){return isObject(t)&&Array.isArray(t.errors)&&t.errors.length>0}function notNull(e){return e!==null}export{LinearApiError,callLinearGraphQL,createLinearAgentActivity,createLinearAgentSessionOnComment,createLinearAgentSessionOnIssue,listLinearAgentSessionActivities,updateLinearAgentSession};

package/dist/src/public/channels/linear/auth.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Linear channel credential resolvers.
+ *
+ * Eve keeps Linear access tokens out of model-visible context. Channel helpers
+ * resolve them only when verifying inbound webhooks or calling Linear's
+ * GraphQL API to emit Agent Activities.
+ */
+export type LinearAccessToken = string | (() => string | Promise<string>);
+export type LinearWebhookSecret = string | (() => string | Promise<string>);
+export interface LinearChannelCredentials {
+    /**
+     * OAuth app-token or API key used for Linear GraphQL calls. For the Agent
+     * surface this should usually be an OAuth token installed with `actor=app`.
+     */
+    readonly accessToken?: LinearAccessToken;
+    /** Signing secret from the Linear webhook configuration. */
+    readonly webhookSecret?: LinearWebhookSecret;
+    /** Optional custom verifier for trusted webhook forwarders. */
+    readonly webhookVerifier?: import("#public/channels/linear/verify.js").LinearWebhookVerifier;
+}
+export declare function resolveLinearAccessToken(token: LinearAccessToken | undefined): Promise<string>;
+export declare function resolveLinearWebhookSecret(secret: LinearWebhookSecret | undefined): Promise<string>;

package/dist/src/public/channels/linear/auth.js

@@ -0,0 +1 @@
+async function resolveLinearAccessToken(e){let t=typeof e==`function`?await e():e??process.env.LINEAR_AGENT_ACCESS_TOKEN??process.env.LINEAR_ACCESS_TOKEN??process.env.LINEAR_API_KEY??process.env.LINEAR_API_TOKEN;if(!t)throw Error(`linearChannel: missing Linear access token. Pass credentials.accessToken or set LINEAR_AGENT_ACCESS_TOKEN, LINEAR_ACCESS_TOKEN, LINEAR_API_KEY, or LINEAR_API_TOKEN.`);return t}async function resolveLinearWebhookSecret(e){let t=typeof e==`function`?await e():e??process.env.LINEAR_WEBHOOK_SECRET;if(!t)throw Error(`linearChannel: missing webhook secret. Pass credentials.webhookSecret, set LINEAR_WEBHOOK_SECRET, or supply credentials.webhookVerifier.`);return t}export{resolveLinearAccessToken,resolveLinearWebhookSecret};

package/dist/src/public/channels/linear/constants.d.ts

@@ -0,0 +1,2 @@
+/** Default route mounted by {@link linearChannel}. */
+export declare const LINEAR_CHANNEL_DEFAULT_ROUTE = "/eve/v1/linear";

package/dist/src/public/channels/linear/constants.js

@@ -0,0 +1 @@
+const LINEAR_CHANNEL_DEFAULT_ROUTE=`/eve/v1/linear`;export{LINEAR_CHANNEL_DEFAULT_ROUTE};

package/dist/src/public/channels/linear/defaults.d.ts

@@ -0,0 +1,16 @@
+import type { SessionAuthContext } from "#channel/types.js";
+import { type LinearApiOptions } from "#public/channels/linear/api.js";
+import type { LinearChannelCredentials } from "#public/channels/linear/auth.js";
+import type { LinearAgentSessionEvent } from "#public/channels/linear/inbound.js";
+import type { LinearChannelEvents, LinearInboundResult, LinearSessionContext } from "#public/channels/linear/linearChannel.js";
+/** Default Linear auth projection for Agent Session webhook actors. */
+export declare function defaultLinearAuth(event: LinearAgentSessionEvent): SessionAuthContext;
+/** Default Agent Session hook: dispatch created/prompted events with Linear user auth. */
+export declare function defaultOnAgentSession(_ctx: LinearSessionContext, event: LinearAgentSessionEvent): LinearInboundResult;
+/** Options used by built-in Linear event handlers. */
+export interface LinearDefaultEventOptions {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+}
+/** Built-in Linear event handlers for Agent Activity progress, replies, HITL, and errors. */
+export declare function createDefaultEvents(options?: LinearDefaultEventOptions): LinearChannelEvents;

package/dist/src/public/channels/linear/defaults.js

@@ -0,0 +1,3 @@
+import{extractErrorId,formatErrorHint}from"#internal/logging.js";import{createLinearAgentActivity}from"#public/channels/linear/api.js";import{renderLinearInputRequests}from"#public/channels/linear/hitl.js";function defaultLinearAuth(e){let t=e.agentActivity?.user??e.agentSession.creator,n=e.agentActivity?.userId??e.agentSession.creatorId??t?.id??`unknown`,r={action:e.action,agent_session_id:e.agentSession.id,organization_id:e.organizationId??e.agentSession.organizationId??``};if(e.delivery.id!==void 0&&(r.delivery_id=e.delivery.id),e.agentSession.issueId!==void 0&&e.agentSession.issueId!==null&&(r.issue_id=e.agentSession.issueId),e.agentSession.issue?.identifier!==void 0&&(r.issue_identifier=e.agentSession.issue.identifier),t!==void 0){let e=linearUserLabel(t);e!==void 0&&(r.user=e)}return{attributes:r,authenticator:`linear-agent-webhook`,issuer:e.organizationId?`linear:${e.organizationId}`:`linear`,principalId:`linear:${n}`,principalType:`user`,subject:n}}function defaultOnAgentSession(e,t){return t.action!==`created`&&t.action!==`prompted`?null:{auth:defaultLinearAuth(t)}}function createDefaultEvents(n={}){return{async"turn.started"(e,t,r){t.state.pendingToolCallMessage=null,await postActivity(t,n,{body:`Working on this.`,type:`thought`},{ephemeral:!0})},async"actions.requested"(e,t,r){let i=t.state.pendingToolCallMessage;if(t.state.pendingToolCallMessage=null,i){await postActivity(t,n,{body:i,type:`thought`},{ephemeral:!0});return}if(e.actions.length!==0){if(e.actions.length>1){await postActivity(t,n,{action:`Running`,parameter:e.actions.map(actionLabel).join(`, `),type:`action`},{ephemeral:!0});return}for(let r of e.actions)await postActivity(t,n,{action:actionLabel(r),parameter:actionParameter(r),type:`action`},{ephemeral:!0})}},async"input.requested"(e,t,i){await postActivity(t,n,{body:renderLinearInputRequests(e.requests),type:`elicitation`})},async"message.completed"(e,t,r){if(e.finishReason===`tool-calls`){t.state.pendingToolCallMessage=e.message?firstNonEmptyLine(e.message)??null:null;return}t.state.pendingToolCallMessage=null,e.message&&await postActivity(t,n,{body:e.message,type:`response`})},async"session.failed"(r,i){let a=formatErrorHint(r),o=extractErrorId(r.details);await postActivity(i,n,{body:[`This session could not recover from an error${a}.`,``,`Start a new Linear agent session to continue.`,...o?[``,`Error id: ${o}`]:[]].join(`
+`),type:`error`})},async"turn.failed"(r,i,a){let o=formatErrorHint(r),s=extractErrorId(r.details);await postActivity(i,n,{body:[`I hit an error while handling your request${o}.`,``,`Please try again, rephrase, or reach out if it keeps failing.`,...s?[``,`Error id: ${s}`]:[]].join(`
+`),type:`error`})}}}function postActivity(e,t,r,i={}){return createLinearAgentActivity({api:t.api,credentials:t.credentials,activity:{agentSessionId:requireAgentSessionId(e.state.agentSessionId),content:r,ephemeral:i.ephemeral}})}function requireAgentSessionId(e){if(e===null)throw Error(`linearChannel: cannot post Agent Activity without an Agent Session id.`);return e}function linearUserLabel(e){return e.displayName??e.name??e.email}function firstNonEmptyLine(e){for(let t of e.split(/\r?\n/u)){let e=t.trim();if(e.length>0)return e}}function actionLabel(e){return e.kind===`tool-call`&&e.toolName?e.toolName:e.kind}function actionParameter(e){if(e.description)return e.description;if(e.name)return e.name;if(e.input!==void 0)try{return JSON.stringify(e.input)}catch{return``}return``}export{createDefaultEvents,defaultLinearAuth,defaultOnAgentSession};

package/dist/src/public/channels/linear/hitl.d.ts

@@ -0,0 +1,14 @@
+import type { LinearAgentActivityRecord } from "#public/channels/linear/api.js";
+import type { InputRequest, InputResponse } from "#runtime/input/types.js";
+/** Hidden marker embedded in Eve-created Linear elicitation bodies. */
+export declare const LINEAR_HITL_MARKER_PREFIX = "<!-- eve-input:";
+export declare const LINEAR_HITL_MARKER_SUFFIX = " -->";
+/** Renders Eve input requests as one Linear elicitation body. */
+export declare function renderLinearInputRequests(requests: readonly InputRequest[]): string;
+/** Resolves a Linear user prompt against the latest Eve-created elicitation marker. */
+export declare function resolveLinearPromptInputResponses(input: {
+    readonly activities: readonly LinearAgentActivityRecord[];
+    readonly body: string;
+}): readonly InputResponse[];
+/** Strips Eve's hidden HITL marker from a body before user-facing assertions/logging. */
+export declare function stripLinearHitlMarker(body: string): string;

package/dist/src/public/channels/linear/hitl.js

@@ -0,0 +1,4 @@
+import{resolveTextToResponses}from"#channel/resolve-text.js";const LINEAR_HITL_MARKER_PREFIX=`<!-- eve-input:`,LINEAR_HITL_MARKER_SUFFIX=` -->`;function renderLinearInputRequests(e){let t=encodeLinearHitlMarker(e.map(storableRequest));return`${e.map(renderLinearInputRequest).join(`
+
+`)}\n\n${t}`}function resolveLinearPromptInputResponses(t){let n=findLatestLinearHitlMarker(t.activities);return n===null?[]:resolveTextToResponses(t.body,n.requests.map(toInputRequest))}function stripLinearHitlMarker(e){let n=e.indexOf(LINEAR_HITL_MARKER_PREFIX);return n===-1?e:e.slice(0,n).trimEnd()}function renderLinearInputRequest(e){let t=[e.prompt];return e.options!==void 0&&e.options.length>0&&t.push(``,...e.options.map((e,t)=>{let n=e.description?` - ${e.description}`:``;return`${t+1}. ${e.label}${n}`})),e.allowFreeform===!0&&t.push(``,`You can also reply with a custom answer.`),t.join(`
+`)}function storableRequest(e){let t={prompt:e.prompt,requestId:e.requestId};return e.allowFreeform!==void 0&&(t.allowFreeform=e.allowFreeform),e.display!==void 0&&(t.display=e.display),e.options!==void 0&&(t.options=e.options),t}function toInputRequest(e){let t={action:{callId:`linear-input:${e.requestId}`,input:{},kind:`tool-call`,toolName:`linear_input`},prompt:e.prompt,requestId:e.requestId};return e.allowFreeform!==void 0&&(t.allowFreeform=e.allowFreeform),e.display!==void 0&&(t.display=e.display),e.options!==void 0&&(t.options=[...e.options]),t}function encodeLinearHitlMarker(e){return`${LINEAR_HITL_MARKER_PREFIX}${Buffer.from(JSON.stringify({requests:e}),`utf8`).toString(`base64url`)}${LINEAR_HITL_MARKER_SUFFIX}`}function findLatestLinearHitlMarker(e){for(let t=e.length-1;t>=0;--t){let n=e[t]?.content.body;if(n===void 0)continue;let r=decodeLinearHitlMarker(n);if(r!==null)return r}return null}function decodeLinearHitlMarker(e){let r=e.lastIndexOf(LINEAR_HITL_MARKER_PREFIX);if(r===-1)return null;let i=r+15,a=e.indexOf(LINEAR_HITL_MARKER_SUFFIX,i);if(a===-1)return null;try{let t=Buffer.from(e.slice(i,a),`base64url`).toString(`utf8`),n=JSON.parse(t);return isMarkerPayload(n)?n:null}catch{return null}}function isMarkerPayload(e){if(!e||typeof e!=`object`||!(`requests`in e))return!1;let t=e.requests;return Array.isArray(t)&&t.every(isStoredRequest)}function isStoredRequest(e){if(!e||typeof e!=`object`)return!1;let t=e;if(typeof t.prompt!=`string`||typeof t.requestId!=`string`||t.allowFreeform!==void 0&&typeof t.allowFreeform!=`boolean`||t.display!==void 0&&t.display!==`confirmation`&&t.display!==`select`&&t.display!==`text`)return!1;let n=t.options;return n===void 0||Array.isArray(n)&&n.every(isStoredOption)}function isStoredOption(e){if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.id!=`string`||typeof t.label!=`string`||t.description!==void 0&&typeof t.description!=`string`?!1:t.style===void 0||t.style===`primary`||t.style===`danger`||t.style==="default"}export{LINEAR_HITL_MARKER_PREFIX,LINEAR_HITL_MARKER_SUFFIX,renderLinearInputRequests,resolveLinearPromptInputResponses,stripLinearHitlMarker};

package/dist/src/public/channels/linear/inbound.d.ts

@@ -0,0 +1,88 @@
+import type { UserContent } from "ai";
+import { type JsonObject } from "#shared/json.js";
+/** Linear Agent Session webhook actions supported by the channel. */
+export type LinearAgentSessionAction = "created" | "prompted" | (string & {});
+/** Verified Linear webhook delivery headers. */
+export interface LinearDelivery {
+    event: string | undefined;
+    id: string | undefined;
+}
+/** Linear actor projected from webhook payload user/creator fields. */
+export interface LinearUser {
+    id: string;
+    displayName?: string;
+    name?: string;
+    email?: string;
+    url?: string;
+}
+/** Linear issue context attached to an Agent Session. */
+export interface LinearIssueRef {
+    id: string;
+    identifier?: string;
+    title?: string;
+    url?: string;
+}
+/** Linear Agent Session snapshot carried by Agent Session webhooks. */
+export interface LinearAgentSessionRef {
+    appUserId?: string;
+    commentId?: string | null;
+    creator?: LinearUser;
+    creatorId?: string | null;
+    id: string;
+    issue?: LinearIssueRef | null;
+    issueId?: string | null;
+    organizationId?: string;
+    sourceCommentId?: string | null;
+    status?: string;
+    summary?: string | null;
+    url?: string | null;
+}
+/** Linear Agent Activity snapshot carried by `prompted` webhooks. */
+export interface LinearAgentActivityRef {
+    body?: string;
+    content: JsonObject;
+    id: string;
+    signal?: string | null;
+    signalMetadata?: JsonObject | null;
+    sourceCommentId?: string | null;
+    user?: LinearUser;
+    userId?: string | null;
+}
+/** Parsed Linear Agent Session event consumed by `linearChannel`. */
+export interface LinearAgentSessionEvent {
+    readonly action: LinearAgentSessionAction;
+    readonly agentActivity?: LinearAgentActivityRef;
+    readonly agentSession: LinearAgentSessionRef;
+    readonly appUserId?: string;
+    readonly createdAt?: string;
+    readonly delivery: LinearDelivery;
+    readonly guidance?: string;
+    readonly kind: "agent_session";
+    readonly oauthClientId?: string;
+    readonly organizationId?: string;
+    readonly previousComments: readonly string[];
+    readonly promptContext?: string;
+    readonly raw: JsonObject;
+}
+/** Parsed generic Linear data webhook event. */
+export interface LinearDataWebhookEvent {
+    readonly action?: string;
+    readonly delivery: LinearDelivery;
+    readonly kind: "data";
+    readonly organizationId?: string;
+    readonly raw: JsonObject;
+    readonly type: string;
+}
+/** Parsed Linear webhook event shape consumed by the channel. */
+export type LinearInboundEvent = LinearAgentSessionEvent | LinearDataWebhookEvent;
+/** Builds the continuation token for one Linear Agent Session. */
+export declare function linearContinuationToken(agentSessionId: string): string;
+/** Parses a verified Linear webhook body into a normalized event, or `null` when unsupported. */
+export declare function parseLinearWebhookEvent(input: {
+    readonly body: string;
+    readonly headers: Headers;
+}): LinearInboundEvent | null;
+/** Builds the user-facing message for a Linear Agent Session event. */
+export declare function messageFromLinearAgentSessionEvent(event: LinearAgentSessionEvent): UserContent;
+/** Formats Linear issue/session context as an Eve context block. */
+export declare function formatLinearContextBlock(event: LinearAgentSessionEvent): string;

package/dist/src/public/channels/linear/inbound.js

@@ -0,0 +1,2 @@
+import{isObject}from"#shared/guards.js";import{parseJsonObject}from"#shared/json.js";function linearContinuationToken(e){return`agent-session:${e}`}function parseLinearWebhookEvent(e){let n=parseJsonObject(JSON.parse(e.body)),r={event:e.headers.get(`linear-event`)??void 0,id:e.headers.get(`linear-delivery`)??void 0},i=readString(n.type);if(!i)return null;if(i===`AgentSessionEvent`){let e=readAgentSession(n.agentSession);return e===null?null:{action:readString(n.action)??`created`,agentActivity:readAgentActivity(n.agentActivity),agentSession:e,appUserId:readString(n.appUserId),createdAt:readString(n.createdAt),delivery:r,guidance:readString(n.guidance),kind:`agent_session`,oauthClientId:readString(n.oauthClientId),organizationId:readString(n.organizationId),previousComments:readPreviousComments(n.previousComments),promptContext:readString(n.promptContext),raw:n}}return{action:readString(n.action),delivery:r,kind:`data`,organizationId:readString(n.organizationId),raw:n,type:i}}function messageFromLinearAgentSessionEvent(e){if(e.action===`prompted`){let t=e.agentActivity?.body;if(t!==void 0&&t.trim().length>0)return t}let t=e.promptContext?.trim();if(t!==void 0&&t.length>0)return t;let n=e.agentSession.summary?.trim();if(n!==void 0&&n.length>0)return n;let r=e.agentSession.issue;return r?.title?`${r.identifier?`${r.identifier}: `:``}${r.title}`:`Linear agent session started.`}function formatLinearContextBlock(e){let t=e.agentSession,n=t.issue;return[`<linear_context>`,`action: ${e.action}`,`agent_session_id: ${t.id}`,`agent_session_url: ${t.url??``}`,`organization_id: ${e.organizationId??t.organizationId??``}`,`issue_id: ${t.issueId??n?.id??``}`,`issue_identifier: ${n?.identifier??``}`,`issue_title: ${n?.title??``}`,`issue_url: ${n?.url??``}`,`comment_id: ${t.commentId??``}`,`source_comment_id: ${t.sourceCommentId??``}`,`response_medium: linear_agent_activity`,`</linear_context>`].join(`
+`)}function readAgentSession(t){if(!isObject(t)||typeof t.id!=`string`)return null;let n={id:t.id};typeof t.appUserId==`string`&&(n.appUserId=t.appUserId),(typeof t.commentId==`string`||t.commentId===null)&&(n.commentId=t.commentId),n.creator=readUser(t.creator),(typeof t.creatorId==`string`||t.creatorId===null)&&(n.creatorId=t.creatorId);let r=readIssue(t.issue);return r!==void 0&&(n.issue=r),(typeof t.issueId==`string`||t.issueId===null)&&(n.issueId=t.issueId),typeof t.organizationId==`string`&&(n.organizationId=t.organizationId),(typeof t.sourceCommentId==`string`||t.sourceCommentId===null)&&(n.sourceCommentId=t.sourceCommentId),typeof t.status==`string`&&(n.status=t.status),(typeof t.summary==`string`||t.summary===null)&&(n.summary=t.summary),(typeof t.url==`string`||t.url===null)&&(n.url=t.url),n}function readAgentActivity(n){if(!isObject(n)||typeof n.id!=`string`)return;let r=isObject(n.content)?parseJsonObject(n.content):{},i={body:readActivityBody(n.content),content:r,id:n.id};return(typeof n.signal==`string`||n.signal===null)&&(i.signal=n.signal),isObject(n.signalMetadata)&&(i.signalMetadata=parseJsonObject(n.signalMetadata)),n.signalMetadata===null&&(i.signalMetadata=null),(typeof n.sourceCommentId==`string`||n.sourceCommentId===null)&&(i.sourceCommentId=n.sourceCommentId),i.user=readUser(n.user),(typeof n.userId==`string`||n.userId===null)&&(i.userId=n.userId),i}function readActivityBody(t){if(isObject(t))return readString(t.body)}function readIssue(t){if(t===null)return null;if(!isObject(t)||typeof t.id!=`string`)return;let n={id:t.id};return typeof t.identifier==`string`&&(n.identifier=t.identifier),typeof t.title==`string`&&(n.title=t.title),typeof t.url==`string`&&(n.url=t.url),n}function readUser(t){if(!isObject(t)||typeof t.id!=`string`)return;let n={id:t.id};return typeof t.displayName==`string`&&(n.displayName=t.displayName),typeof t.name==`string`&&(n.name=t.name),typeof t.email==`string`&&(n.email=t.email),typeof t.url==`string`&&(n.url=t.url),n}function readPreviousComments(t){return Array.isArray(t)?t.map(t=>typeof t==`string`?t:isObject(t)&&typeof t.body==`string`?t.body:null).filter(e=>e!==null):[]}function readString(e){return typeof e==`string`&&e.length>0?e:void 0}export{formatLinearContextBlock,linearContinuationToken,messageFromLinearAgentSessionEvent,parseLinearWebhookEvent};

package/dist/src/public/channels/linear/index.d.ts

@@ -0,0 +1,8 @@
+export { LinearApiError, callLinearGraphQL, createLinearAgentActivity, createLinearAgentSessionOnComment, createLinearAgentSessionOnIssue, listLinearAgentSessionActivities, updateLinearAgentSession, type LinearAgentActivityContent, type LinearAgentActivityCreateInput, type LinearAgentActivityRecord, type LinearAgentActivitySignal, type LinearAgentSessionRecord, type LinearAgentSessionUpdateInput, type LinearApiOptions, type LinearExternalUrl, type LinearFetch, } from "#public/channels/linear/api.js";
+export { type LinearAccessToken, type LinearChannelCredentials, type LinearWebhookSecret, } from "#public/channels/linear/auth.js";
+export { LINEAR_CHANNEL_DEFAULT_ROUTE } from "#public/channels/linear/constants.js";
+export { defaultLinearAuth, defaultOnAgentSession } from "#public/channels/linear/defaults.js";
+export { LINEAR_HITL_MARKER_PREFIX, renderLinearInputRequests, resolveLinearPromptInputResponses, stripLinearHitlMarker, } from "#public/channels/linear/hitl.js";
+export { formatLinearContextBlock, linearContinuationToken, messageFromLinearAgentSessionEvent, parseLinearWebhookEvent, type LinearAgentActivityRef, type LinearAgentSessionAction, type LinearAgentSessionEvent, type LinearAgentSessionRef, type LinearDataWebhookEvent, type LinearDelivery, type LinearInboundEvent, type LinearIssueRef, type LinearUser, } from "#public/channels/linear/inbound.js";
+export { linearChannel, type LinearChannel, type LinearChannelConfig, type LinearChannelContext, type LinearChannelEvents, type LinearChannelState, type LinearEventContext, type LinearHandle, type LinearInboundResult, type LinearInboundResultOrPromise, type LinearInstrumentationMetadata, type LinearReceiveTarget, type LinearSessionContext, } from "#public/channels/linear/linearChannel.js";
+export { signLinearWebhookBody, type LinearVerifyOptions, type LinearWebhookVerifier, } from "#public/channels/linear/verify.js";

package/dist/src/public/channels/linear/index.js

@@ -0,0 +1 @@
+import{LinearApiError,callLinearGraphQL,createLinearAgentActivity,createLinearAgentSessionOnComment,createLinearAgentSessionOnIssue,listLinearAgentSessionActivities,updateLinearAgentSession}from"#public/channels/linear/api.js";import{LINEAR_HITL_MARKER_PREFIX,renderLinearInputRequests,resolveLinearPromptInputResponses,stripLinearHitlMarker}from"#public/channels/linear/hitl.js";import{LINEAR_CHANNEL_DEFAULT_ROUTE}from"#public/channels/linear/constants.js";import{defaultLinearAuth,defaultOnAgentSession}from"#public/channels/linear/defaults.js";import{formatLinearContextBlock,linearContinuationToken,messageFromLinearAgentSessionEvent,parseLinearWebhookEvent}from"#public/channels/linear/inbound.js";import{linearChannel}from"#public/channels/linear/linearChannel.js";import{signLinearWebhookBody}from"#public/channels/linear/verify.js";export{LINEAR_CHANNEL_DEFAULT_ROUTE,LINEAR_HITL_MARKER_PREFIX,LinearApiError,callLinearGraphQL,createLinearAgentActivity,createLinearAgentSessionOnComment,createLinearAgentSessionOnIssue,defaultLinearAuth,defaultOnAgentSession,formatLinearContextBlock,linearChannel,linearContinuationToken,listLinearAgentSessionActivities,messageFromLinearAgentSessionEvent,parseLinearWebhookEvent,renderLinearInputRequests,resolveLinearPromptInputResponses,signLinearWebhookBody,stripLinearHitlMarker,updateLinearAgentSession};

package/dist/src/public/channels/linear/linearChannel.d.ts

@@ -0,0 +1,138 @@
+import type { SessionAuthContext } from "#channel/types.js";
+import type { HandleMessageStreamEvent } from "#protocol/message.js";
+import { createLinearAgentActivity, listLinearAgentSessionActivities, updateLinearAgentSession, type LinearApiOptions } from "#public/channels/linear/api.js";
+import type { LinearChannelCredentials } from "#public/channels/linear/auth.js";
+import { type LinearAgentSessionEvent, type LinearAgentSessionRef, type LinearDataWebhookEvent, type LinearDelivery } from "#public/channels/linear/inbound.js";
+import type { SessionContext } from "#public/definitions/callback-context.js";
+import { type Channel, type ChannelSessionOps } from "#public/definitions/defineChannel.js";
+import type { JsonObject } from "#shared/json.js";
+type EventData<T extends HandleMessageStreamEvent["type"]> = Extract<HandleMessageStreamEvent, {
+    type: T;
+}> extends {
+    data: infer D;
+} ? D : undefined;
+/** JSON-serializable state for one Linear Agent Session conversation. */
+export interface LinearChannelState {
+    readonly agentSessionId: string | null;
+    readonly agentSessionUrl?: string | null;
+    readonly commentId?: string | null;
+    readonly issueId?: string | null;
+    readonly issueIdentifier?: string | null;
+    readonly issueTitle?: string | null;
+    readonly issueUrl?: string | null;
+    readonly organizationId?: string | null;
+    /**
+     * Buffered text from a `message.completed` event whose `finishReason`
+     * was `"tool-calls"`. The default `actions.requested` handler uses this
+     * as the next ephemeral progress activity, matching Slack's typing status.
+     */
+    pendingToolCallMessage?: string | null;
+    readonly sourceCommentId?: string | null;
+}
+/** Per-session instrumentation snapshot for Linear runtime telemetry. */
+export interface LinearInstrumentationMetadata extends Record<string, unknown> {
+    readonly agentSessionId: string | null;
+    readonly commentId: string | null;
+    readonly issueId: string | null;
+    readonly issueIdentifier: string | null;
+    readonly organizationId: string | null;
+}
+/** Target accepted by `receive(linear, { target })` for proactive Linear sessions. */
+export type LinearReceiveTarget = {
+    readonly agentSessionId: string;
+    readonly initialActivity?: string;
+} | {
+    readonly externalLink?: string;
+    readonly externalUrls?: readonly {
+        readonly label: string;
+        readonly url: string;
+    }[];
+    readonly initialActivity?: string;
+    readonly issueId: string;
+} | {
+    readonly commentId: string;
+    readonly externalLink?: string;
+    readonly externalUrls?: readonly {
+        readonly label: string;
+        readonly url: string;
+    }[];
+    readonly initialActivity?: string;
+};
+/** Pre-dispatch Linear context passed to inbound hooks. */
+export interface LinearSessionContext {
+    readonly delivery: LinearDelivery;
+    readonly linear: LinearHandle;
+    readonly session: LinearAgentSessionRef;
+}
+/** Channel-owned Linear context rebuilt from persisted channel state. */
+export interface LinearChannelContext {
+    readonly linear: LinearHandle;
+    state: LinearChannelState;
+}
+/** Event-handler Linear context, including session operations. */
+export interface LinearEventContext extends LinearChannelContext, ChannelSessionOps {
+}
+/** Low-level Linear handle exposed to hooks and event handlers. */
+export interface LinearHandle {
+    readonly agentSessionId: string;
+    createActivity(content: Parameters<typeof createLinearAgentActivity>[0]["activity"]["content"], options?: {
+        readonly ephemeral?: boolean;
+        readonly signal?: Parameters<typeof createLinearAgentActivity>[0]["activity"]["signal"];
+        readonly signalMetadata?: JsonObject;
+    }): Promise<{
+        readonly id: string;
+        readonly success: boolean;
+    }>;
+    listActivities(options?: {
+        readonly last?: number;
+    }): Promise<Awaited<ReturnType<typeof listLinearAgentSessionActivities>>>;
+    updateSession(update: Parameters<typeof updateLinearAgentSession>[0]["update"]): Promise<{
+        readonly success: boolean;
+    }>;
+}
+type LinearEventHandler<T extends HandleMessageStreamEvent["type"]> = (data: EventData<T>, channel: LinearEventContext, ctx: SessionContext) => void | Promise<void>;
+type LinearSessionFailedHandler = (data: EventData<"session.failed">, channel: LinearEventContext) => void | Promise<void>;
+/** Event handlers supported by `linearChannel({ events })`. */
+export interface LinearChannelEvents {
+    readonly "turn.started"?: LinearEventHandler<"turn.started">;
+    readonly "actions.requested"?: LinearEventHandler<"actions.requested">;
+    readonly "action.result"?: LinearEventHandler<"action.result">;
+    readonly "message.completed"?: LinearEventHandler<"message.completed">;
+    readonly "message.appended"?: LinearEventHandler<"message.appended">;
+    readonly "input.requested"?: LinearEventHandler<"input.requested">;
+    readonly "turn.failed"?: LinearEventHandler<"turn.failed">;
+    readonly "turn.completed"?: LinearEventHandler<"turn.completed">;
+    readonly "session.failed"?: LinearSessionFailedHandler;
+    readonly "session.completed"?: LinearEventHandler<"session.completed">;
+    readonly "session.waiting"?: LinearEventHandler<"session.waiting">;
+    readonly "authorization.required"?: LinearEventHandler<"authorization.required">;
+    readonly "authorization.completed"?: LinearEventHandler<"authorization.completed">;
+}
+/**
+ * Result of an inbound Linear hook. Return `null` to acknowledge without
+ * dispatching; return `{ auth }` to dispatch. Optional `context` strings are
+ * added as `role: "user"` messages before the dispatched turn.
+ */
+export type LinearInboundResult = {
+    readonly auth: SessionAuthContext | null;
+    readonly context?: readonly string[];
+} | null;
+/** Sync or async {@link LinearInboundResult}. */
+export type LinearInboundResultOrPromise = LinearInboundResult | Promise<LinearInboundResult>;
+/** Configuration for {@link linearChannel}. */
+export interface LinearChannelConfig {
+    readonly api?: LinearApiOptions;
+    readonly credentials?: LinearChannelCredentials;
+    readonly events?: LinearChannelEvents;
+    readonly route?: string;
+    /** Inbound Agent Session hook. Defaults to dispatching `created` and `prompted` events. */
+    onAgentSession?(ctx: LinearSessionContext, event: LinearAgentSessionEvent): LinearInboundResultOrPromise;
+    /** Optional hook for generic Linear data webhooks sent to the same route. */
+    onDataWebhook?(event: LinearDataWebhookEvent): void | Promise<void>;
+}
+/** Concrete return type of {@link linearChannel}. */
+export interface LinearChannel extends Channel<LinearChannelState, LinearReceiveTarget, LinearInstrumentationMetadata> {
+}
+/** Linear channel factory for Linear Agent Session webhooks and Agent Activities. */
+export declare function linearChannel(config?: LinearChannelConfig): LinearChannel;
+export {};

package/dist/src/public/channels/linear/linearChannel.js

@@ -0,0 +1 @@
+import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{POST,defineChannel}from"#public/definitions/defineChannel.js";import{createLinearAgentActivity,createLinearAgentSessionOnComment,createLinearAgentSessionOnIssue,listLinearAgentSessionActivities,updateLinearAgentSession}from"#public/channels/linear/api.js";import{resolveLinearPromptInputResponses}from"#public/channels/linear/hitl.js";import{LINEAR_CHANNEL_DEFAULT_ROUTE}from"#public/channels/linear/constants.js";import{createDefaultEvents,defaultOnAgentSession}from"#public/channels/linear/defaults.js";import{formatLinearContextBlock,linearContinuationToken,messageFromLinearAgentSessionEvent,parseLinearWebhookEvent}from"#public/channels/linear/inbound.js";import{verifyLinearRequest}from"#public/channels/linear/verify.js";const log=createLogger(`linear.channel`);function linearChannel(e={}){let t=e.onAgentSession??defaultOnAgentSession,a={...createDefaultEvents({api:e.api,credentials:e.credentials}),...e.events};return defineChannel({kindHint:`linear`,state:initialLinearState(),metadata(e){return{agentSessionId:e.agentSessionId,commentId:e.commentId??null,issueId:e.issueId??null,issueIdentifier:e.issueIdentifier??null,organizationId:e.organizationId??null}},context(t,n){return rebuildLinearContext(t,n,e)},routes:[POST(e.route??LINEAR_CHANNEL_DEFAULT_ROUTE,async(n,{send:r,waitUntil:i})=>{let a=await verifyInbound(n,e.credentials);if(a===null)return new Response(`unauthorized`,{status:401});let o;try{o=parseLinearWebhookEvent({body:a,headers:n.headers})}catch(e){return log.warn(`inbound Linear body is not valid JSON`,{error:e}),jsonOk({ignored:!0,ok:!0})}return o===null?jsonOk({ignored:!0,ok:!0}):o.kind===`agent_session`?(i(dispatchAgentSession({config:e,event:o,onAgentSession:t,send:r})),jsonOk({ok:!0})):e.onDataWebhook===void 0?jsonOk({ignored:!0,ok:!0}):(i(Promise.resolve(e.onDataWebhook(o))),jsonOk({ok:!0}))})],async receive(t,{send:n}){let r=t.target,a=await resolveReceiveSession(r,e),o=readString(r.initialActivity);return o!==void 0&&await createLinearAgentActivity({api:e.api,credentials:e.credentials,activity:{agentSessionId:a.id,content:{body:o,type:`thought`}}}),n(t.message,{auth:t.auth,continuationToken:linearContinuationToken(a.id),state:stateFromAgentSession(a)})},events:a})}function rebuildLinearContext(e,t,n){return{linear:buildLinearHandle({agentSessionId:e.agentSessionId??``,config:n}),state:e}}function buildLinearHandle(e){return{agentSessionId:e.agentSessionId,createActivity(t,n){return createLinearAgentActivity({api:e.config.api,credentials:e.config.credentials,activity:{agentSessionId:e.agentSessionId,content:t,ephemeral:n?.ephemeral,signal:n?.signal,signalMetadata:n?.signalMetadata}})},listActivities(t){return listLinearAgentSessionActivities({api:e.config.api,credentials:e.config.credentials,agentSessionId:e.agentSessionId,last:t?.last})},updateSession(t){return updateLinearAgentSession({api:e.config.api,credentials:e.config.credentials,id:e.agentSessionId,update:t})}}}async function dispatchAgentSession(e){let{event:t}=e,n={delivery:t.delivery,linear:buildLinearHandle({agentSessionId:t.agentSession.id,config:e.config}),session:t.agentSession},r=await e.onAgentSession(n,t);if(r===null)return;let i=t.agentActivity?.body,a=t.action===`prompted`&&i!==void 0?await resolvePromptResponses({body:i,config:e.config,event:t}):[];await e.send({context:[formatLinearContextBlock(t),...t.previousComments,...r.context??[]],inputResponses:a,message:messageFromLinearAgentSessionEvent(t)},{auth:r.auth,continuationToken:linearContinuationToken(t.agentSession.id),state:stateFromAgentSession(t.agentSession)})}async function resolvePromptResponses(e){try{return resolveLinearPromptInputResponses({activities:await listLinearAgentSessionActivities({api:e.config.api,credentials:e.config.credentials,agentSessionId:e.event.agentSession.id,last:20}),body:e.body})}catch(e){return log.warn(`linear HITL activity lookup failed — treating prompt as a message`,{error:e}),[]}}async function resolveReceiveSession(e,t){if(hasString(e,`agentSessionId`))return{id:e.agentSessionId};if(hasString(e,`issueId`))return createLinearAgentSessionOnIssue({api:t.api,credentials:t.credentials,externalLink:readString(e.externalLink),externalUrls:readExternalUrls(e.externalUrls),issueId:e.issueId});if(hasString(e,`commentId`))return createLinearAgentSessionOnComment({api:t.api,credentials:t.credentials,commentId:e.commentId,externalLink:readString(e.externalLink),externalUrls:readExternalUrls(e.externalUrls)});throw Error(`linearChannel().receive requires target.agentSessionId, issueId, or commentId.`)}function stateFromAgentSession(e){return{agentSessionId:e.id,agentSessionUrl:e.url??null,commentId:e.commentId??null,issueId:e.issueId??e.issue?.id??null,issueIdentifier:e.issue?.identifier??null,issueTitle:e.issue?.title??null,issueUrl:e.issue?.url??null,organizationId:e.organizationId??null,pendingToolCallMessage:null,sourceCommentId:e.sourceCommentId??null}}function initialLinearState(){return{agentSessionId:null,agentSessionUrl:null,commentId:null,issueId:null,issueIdentifier:null,issueTitle:null,issueUrl:null,organizationId:null,pendingToolCallMessage:null,sourceCommentId:null}}async function verifyInbound(e,t){try{return await verifyLinearRequest(e,{webhookSecret:t?.webhookSecret,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`linear inbound verification failed`,{error:e}),null}}function hasString(e,t){return typeof e[t]==`string`&&e[t].length>0}function readString(e){return typeof e==`string`&&e.length>0?e:void 0}function readExternalUrls(e){if(!Array.isArray(e))return;let n=e.filter(e=>isObject(e)&&typeof e.label==`string`&&typeof e.url==`string`);return n.length>0?n:void 0}function jsonOk(e){return new Response(JSON.stringify(e),{headers:{"content-type":`application/json; charset=utf-8`},status:200})}export{linearChannel};

package/dist/src/public/channels/linear/verify.d.ts

@@ -0,0 +1,22 @@
+import { type LinearWebhookSecret } from "#public/channels/linear/auth.js";
+/**
+ * Caller-supplied inbound webhook verifier. Use it as an alternative to
+ * Linear's HMAC secret, for example when a trusted proxy authenticates the
+ * request before it reaches Eve.
+ *
+ * - Throw / reject / return falsy: request rejected.
+ * - Return a string: request accepted and that string replaces the raw body.
+ * - Return any other truthy value: request accepted and the original body is
+ *   used.
+ */
+export type LinearWebhookVerifier = (request: Request, body: string) => unknown | Promise<unknown>;
+export interface LinearVerifyOptions {
+    /** Max allowed webhook timestamp skew in milliseconds. Defaults to 60s. */
+    readonly maxSkewMs?: number;
+    readonly webhookSecret?: LinearWebhookSecret;
+    readonly webhookVerifier?: LinearWebhookVerifier;
+}
+/** Verifies a Linear webhook request and returns its raw body. */
+export declare function verifyLinearRequest(request: Request, options: LinearVerifyOptions): Promise<string>;
+/** Signs a raw Linear webhook body for tests and local fixtures. */
+export declare function signLinearWebhookBody(body: string, secret: string): string;

package/dist/src/public/channels/linear/verify.js

@@ -0,0 +1 @@
+import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{createHmac,timingSafeEqual}from"node:crypto";import{resolveLinearWebhookSecret}from"#public/channels/linear/auth.js";const log=createLogger(`linear.verify`);async function verifyLinearRequest(e,t){let n=await e.text();if(t.webhookVerifier!==void 0){let r=await t.webhookVerifier(e,n);if(!r)throw Error(`linearChannel: inbound webhook verifier rejected the request.`);return typeof r==`string`?r:n}let r=await resolveLinearWebhookSecret(t.webhookSecret),a=e.headers.get(`linear-signature`)??``;if(!a)throw Error(`linearChannel: inbound request missing Linear-Signature.`);if(!constantTimeCompare(signLinearWebhookBody(n,r),a))throw Error(`linearChannel: inbound request signature mismatch.`);return verifyWebhookTimestamp(n,t.maxSkewMs??6e4),n}function signLinearWebhookBody(e,t){return createHmac(`sha256`,t).update(e).digest(`hex`)}function verifyWebhookTimestamp(e,n){let r;try{r=JSON.parse(e)}catch{throw Error(`linearChannel: inbound request body is not valid JSON.`)}let i=isObject(r)?r.webhookTimestamp:void 0;if(typeof i!=`number`||!Number.isFinite(i))throw Error(`linearChannel: inbound request missing webhookTimestamp.`);if(Math.abs(Date.now()-i)>n)throw Error(`linearChannel: inbound request timestamp outside allowed skew.`)}function constantTimeCompare(e,t){if(e.length!==t.length)return!1;try{return timingSafeEqual(Buffer.from(e),Buffer.from(t))}catch(e){return log.debug(`timingSafeEqual threw`,{error:e}),!1}}export{signLinearWebhookBody,verifyLinearRequest};

package/dist/src/public/channels/slack/api-encoding.d.ts

@@ -0,0 +1,5 @@
+export declare function encodeSlackApiBody(body: unknown): {
+    readonly body: string;
+    readonly contentType: string;
+};
+export declare function decodeSlackApiBody(body: unknown, contentType: string | null): unknown;

package/dist/src/public/channels/slack/api-encoding.js

@@ -0,0 +1 @@
+function encodeSlackApiBody(e){let t=new URLSearchParams;if(e&&typeof e==`object`)for(let[n,r]of Object.entries(e))r!=null&&(typeof r==`string`||typeof r==`number`||typeof r==`boolean`?t.set(n,String(r)):t.set(n,JSON.stringify(r)));return{body:t.toString(),contentType:`application/x-www-form-urlencoded`}}function decodeSlackApiBody(e,t){if(typeof e!=`string`)return e;if(t?.includes(`application/json`))return parseJson(e);if(!t?.includes(`application/x-www-form-urlencoded`))return e;let n={};for(let[t,r]of new URLSearchParams(e))n[t]=r.startsWith(`[`)||r.startsWith(`{`)?parseJson(r):r;return n}function parseJson(e){try{return JSON.parse(e)}catch{return e}}export{decodeSlackApiBody,encodeSlackApiBody};