@band-ai/sdk 0.1.6 → 0.2.0

package/dist/linear.d.cts

@@ -1,12 +1,21 @@
 import { LinearClient, LinearDocument } from '@linear/sdk';
-import { R as RestApi } from './types-CSHFipIc.cjs';
-import { AgentSessionEventWebhookPayload } from '@linear/sdk/webhooks';
+import { R as RestApi } from './types-BgYFd_Yw.cjs';
+import { AppUserNotificationWebhookPayloadWithNotification, AgentSessionEventWebhookPayload, AppUserTeamAccessChangedWebhookPayload, OAuthAppWebhookPayload } from '@linear/sdk/webhooks';
 import { L as Logger } from './logger-CABQOnlR.cjs';
 import { C as CustomToolDef } from './customTools-BzF0IISO.cjs';
 import { IncomingMessage, ServerResponse } from 'node:http';
-import './dtos-DUpbIu8k.cjs';
+import './dtos-B8KU_q4d.cjs';
 import 'zod';
 
+interface CandidateRepositoryInput {
+    hostname: string;
+    repositoryFullName: string;
+}
+interface RepositorySuggestion {
+    repositoryFullName: string;
+    hostname?: string | null;
+    confidence: number;
+}
 /**
  * Subset of `LinearClient` covering only the activity-reporting methods.
  */
@@ -14,7 +23,9 @@ interface LinearActivityClient {
     createAgentActivity(input: {
         agentSessionId: string;
         content: Record<string, unknown>;
+        ephemeral?: boolean;
     }): Promise<unknown>;
+    updateAgentSession?: (id: string, input: Record<string, unknown>) => Promise<unknown>;
     updateIssue?: (issueId: string, input: Record<string, unknown>) => Promise<unknown>;
     createComment?: (input: {
         issueId: string;
@@ -22,22 +33,81 @@ interface LinearActivityClient {
     }) => Promise<unknown>;
     issue?: (issueId: string) => Promise<unknown>;
     workflowStates?: (variables?: Record<string, unknown>) => Promise<unknown>;
+    issueRepositorySuggestions?: (candidateRepositories: CandidateRepositoryInput[], issueId: string, variables?: {
+        agentSessionId?: string | null;
+    }) => Promise<unknown>;
+    agentSessionUpdateExternalUrl?: (id: string, input: Record<string, unknown>) => Promise<unknown>;
+    /** Create an agent session on an existing Linear issue (proactive initiation). */
+    agentSessionCreateOnIssue?: (input: {
+        issueId: string;
+        externalLink?: string;
+    }) => Promise<unknown>;
+    /** Create an agent session on a specific comment thread (proactive initiation). */
+    agentSessionCreateOnComment?: (input: {
+        commentId: string;
+        externalLink?: string;
+    }) => Promise<unknown>;
+    /** Create a new Linear issue from scratch. */
+    createIssue?: (input: {
+        teamId: string;
+        title: string;
+        description?: string;
+        priority?: number;
+        assigneeId?: string;
+        stateId?: string;
+        labelIds?: string[];
+    }) => Promise<unknown>;
 }
 interface PlanStep {
     title: string;
     status: "pending" | "in_progress" | "completed" | "failed";
 }
-declare function postThought(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
-declare function postError(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
+interface SelectOption {
+    label: string;
+    value: string;
+}
+/** Longest body string allowed in an elicitation activity. */
+declare const ELICITATION_BODY_MAX_LENGTH = 10000;
+/** Longest label or value string allowed in a select option. */
+declare const SELECT_OPTION_MAX_LENGTH = 200;
+/** Longest provider name string allowed in an auth elicitation. */
+declare const PROVIDER_MAX_LENGTH = 100;
+declare function postThought(client: LinearActivityClient, sessionId: string, body: string, options?: {
+    ephemeral?: boolean;
+}): Promise<void>;
+declare function postError(client: LinearActivityClient, sessionId: string, body: string, options?: {
+    ephemeral?: boolean;
+}): Promise<void>;
 declare function postResponse(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
 declare function postElicitation(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
-declare function postAction(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
+declare function postSelectElicitation(client: LinearActivityClient, sessionId: string, body: string, options: SelectOption[]): Promise<void>;
+declare function postAuthElicitation(client: LinearActivityClient, sessionId: string, body: string, url: string, provider?: string): Promise<void>;
+declare function postAction(client: LinearActivityClient, sessionId: string, body: string, options?: {
+    ephemeral?: boolean;
+}): Promise<void>;
 declare function updatePlan(client: LinearActivityClient, sessionId: string, steps: PlanStep[]): Promise<void>;
 
+interface HandleAppUserNotificationInput {
+    payload: AppUserNotificationWebhookPayloadWithNotification;
+    deps: LinearBandBridgeDeps;
+    logger: Logger;
+    /** The Linear app-user id from the webhook envelope; used to skip self-notifications. */
+    appUserId?: string;
+}
+declare function handleAppUserNotification(input: HandleAppUserNotificationInput): Promise<void>;
+
 type RoomStrategy = "issue" | "session";
 type WritebackMode = "final_only" | "activity_stream";
 type SessionStatus = "active" | "waiting" | "completed" | "canceled" | "errored";
-interface LinearThenvoiBridgeConfig {
+/** Default interval (ms) between stale-session keepalive checks. */
+declare const STALE_SESSION_CHECK_INTERVAL_MS: number;
+/**
+ * Maximum age (ms) of the last Linear activity before a session is considered
+ * at risk of going stale. Linear marks sessions stale after 30 minutes of
+ * inactivity; we send a keepalive well before that threshold.
+ */
+declare const STALE_SESSION_THRESHOLD_MS: number;
+interface LinearBandBridgeConfig {
     linearAccessToken: string;
     linearWebhookSecret: string;
     roomStrategy?: RoomStrategy;
@@ -46,20 +116,23 @@ interface LinearThenvoiBridgeConfig {
     planningAgentHandles?: string[];
     implementationAgentHandles?: string[];
     recoveredRoomRetryBaseDelayMs?: number;
+    bandAppBaseUrl?: string;
 }
 interface SessionRoomRecord {
     linearSessionId: string;
     linearIssueId: string | null;
-    thenvoiRoomId: string;
+    bandRoomId: string;
     status: SessionStatus;
     lastEventKey?: string | null;
+    /** ISO-8601 timestamp of the last activity sent to Linear for this session. */
+    lastLinearActivityAt?: string | null;
     createdAt: string;
     updatedAt: string;
 }
 interface PendingBootstrapRequest {
     eventKey: string;
     linearSessionId: string;
-    thenvoiRoomId: string;
+    bandRoomId: string;
     expectedContent: string;
     messageType: string;
     senderId?: string | null;
@@ -76,18 +149,20 @@ interface SessionRoomStore {
     enqueueBootstrapRequest(request: PendingBootstrapRequest): Promise<void>;
     listPendingBootstrapRequests(limit?: number): Promise<PendingBootstrapRequest[]>;
     markBootstrapRequestProcessed(eventKey: string): Promise<void>;
+    /** List sessions with active or waiting status (used by stale-session keepalive). */
+    listActiveSessions?(): Promise<SessionRoomRecord[]>;
     close?(): Promise<void>;
 }
-interface LinearThenvoiBridgeDeps {
-    thenvoiRest: RestApi;
+interface LinearBandBridgeDeps {
+    bandRest: RestApi;
     linearClient: LinearClient;
     store: SessionRoomStore;
     logger?: Logger;
 }
 interface HandleAgentSessionEventInput {
     payload: AgentSessionEventWebhookPayload;
-    config: LinearThenvoiBridgeConfig;
-    deps: LinearThenvoiBridgeDeps;
+    config: LinearBandBridgeConfig;
+    deps: LinearBandBridgeDeps;
 }
 
 type LinearSessionStatus = SessionStatus;
@@ -120,6 +195,55 @@ declare function completeLinearSession(input: {
     lastEventKey?: string | null;
 }): Promise<void>;
 
+interface StaleSessionGuardOptions {
+    store: SessionRoomStore;
+    linearClient: LinearActivityClient;
+    logger?: Logger;
+    /** Interval (ms) between keepalive checks. Defaults to 20 minutes. */
+    checkIntervalMs?: number;
+    /** Max age (ms) of last activity before sending a keepalive. Defaults to 25 minutes. */
+    staleThresholdMs?: number;
+    /** Message sent as a keepalive thought. */
+    keepAliveMessage?: string;
+}
+/**
+ * Periodically checks active Linear sessions and sends a keepalive activity
+ * to prevent Linear from marking them as stale (30-minute inactivity timeout).
+ */
+declare class StaleSessionGuard {
+    private readonly store;
+    private readonly linearClient;
+    private readonly logger;
+    private readonly checkIntervalMs;
+    private readonly staleThresholdMs;
+    private readonly keepAliveMessage;
+    private timer;
+    constructor(options: StaleSessionGuardOptions);
+    /** Start the periodic keepalive check. Safe to call multiple times. */
+    start(): void;
+    /** Stop the periodic keepalive check. */
+    stop(): void;
+    /** Run a single keepalive check. Exposed for testing and manual invocation. */
+    tick(): Promise<number>;
+}
+/**
+ * Returns `true` when the session's last Linear activity is older than
+ * `thresholdMs`, meaning it risks being marked stale by Linear.
+ */
+declare function isSessionStale(session: SessionRoomRecord, nowMs: number, thresholdMs: number): boolean;
+/**
+ * Checks whether a session may have gone stale and sends a recovery activity
+ * before the main update. Call this before posting significant activities to
+ * a session that may have been idle for a long time.
+ */
+declare function sendRecoveryActivityIfStale(input: {
+    session: SessionRoomRecord;
+    linearClient: LinearActivityClient;
+    store: SessionRoomStore;
+    logger: Logger;
+    staleThresholdMs?: number;
+}): Promise<boolean>;
+
 declare function isLinearApiKey(token: string): boolean;
 declare function createLinearClient(token: string): LinearClient;
 declare function buildLinearAuthorizationHeader(token: string): string;
@@ -133,6 +257,7 @@ interface CreateLinearToolsOptions {
     client: LinearActivityClient;
     store?: SessionRoomStore;
     enableElicitation?: boolean;
+    logger?: Logger;
 }
 /**
  * Create Linear activity tools usable by any adapter via `customTools`.
@@ -149,10 +274,15 @@ interface LinearBridgeDispatcher {
     isQueued?(eventKey: string): boolean;
     waitForIdle?(): Promise<void>;
 }
+interface PermissionChangeCallbacks {
+    onTeamAccessChanged?: (payload: AppUserTeamAccessChangedWebhookPayload) => void | Promise<void>;
+    onOAuthAppRevoked?: (payload: OAuthAppWebhookPayload) => void | Promise<void>;
+}
 interface CreateLinearWebhookHandlerOptions {
-    config: LinearThenvoiBridgeConfig;
-    deps: LinearThenvoiBridgeDeps;
+    config: LinearBandBridgeConfig;
+    deps: LinearBandBridgeDeps;
     dispatcher?: LinearBridgeDispatcher;
+    permissionCallbacks?: PermissionChangeCallbacks;
 }
 declare function createInlineLinearBridgeDispatcher(options?: {
     logger?: Logger;
@@ -164,4 +294,4 @@ declare function createLinearWebhookHandler(options: CreateLinearWebhookHandlerO
 
 declare const DEFAULT_STATUS_MAPPING: Record<SessionStatus, LinearSessionStatus>;
 
-export { type CreateLinearWebhookHandlerOptions, DEFAULT_STATUS_MAPPING, type HandleAgentSessionEventInput, type LinearActivityClient, type LinearBridgeDispatchJob, type LinearBridgeDispatcher, type LinearBridgeRuntime, type LinearSessionStatus, type LinearThenvoiBridgeConfig, type LinearThenvoiBridgeDeps, type PendingBootstrapRequest, type PlanStep, type RoomStrategy, type SessionRoomRecord, type SessionRoomStore, type SessionStatus, type WritebackMode, buildLinearAuthorizationHeader, completeLinearSession, createInProcessLinearBridgeDispatcher, createInlineLinearBridgeDispatcher, createLinearBridgeRuntime, createLinearClient, createLinearTools, createLinearWebhookHandler, createSqliteSessionRoomStore, dedupeHandles, handleAgentSessionEvent, isLinearApiKey, postAction, postElicitation, postError, postResponse, postThought, stripHandlePrefix, updatePlan };
+export { type CandidateRepositoryInput, type CreateLinearWebhookHandlerOptions, DEFAULT_STATUS_MAPPING, ELICITATION_BODY_MAX_LENGTH, type HandleAgentSessionEventInput, type HandleAppUserNotificationInput, type LinearActivityClient, type LinearBandBridgeConfig, type LinearBandBridgeDeps, type LinearBridgeDispatchJob, type LinearBridgeDispatcher, type LinearBridgeRuntime, type LinearSessionStatus, PROVIDER_MAX_LENGTH, type PendingBootstrapRequest, type PermissionChangeCallbacks, type PlanStep, type RepositorySuggestion, type RoomStrategy, SELECT_OPTION_MAX_LENGTH, STALE_SESSION_CHECK_INTERVAL_MS, STALE_SESSION_THRESHOLD_MS, type SelectOption, type SessionRoomRecord, type SessionRoomStore, type SessionStatus, StaleSessionGuard, type StaleSessionGuardOptions, type WritebackMode, buildLinearAuthorizationHeader, completeLinearSession, createInProcessLinearBridgeDispatcher, createInlineLinearBridgeDispatcher, createLinearBridgeRuntime, createLinearClient, createLinearTools, createLinearWebhookHandler, createSqliteSessionRoomStore, dedupeHandles, handleAgentSessionEvent, handleAppUserNotification, isLinearApiKey, isSessionStale, postAction, postAuthElicitation, postElicitation, postError, postResponse, postSelectElicitation, postThought, sendRecoveryActivityIfStale, stripHandlePrefix, updatePlan };

package/dist/linear.d.ts

@@ -1,12 +1,21 @@
 import { LinearClient, LinearDocument } from '@linear/sdk';
-import { R as RestApi } from './types-CxII3XkA.js';
-import { AgentSessionEventWebhookPayload } from '@linear/sdk/webhooks';
+import { R as RestApi } from './types-BivGO7I9.js';
+import { AppUserNotificationWebhookPayloadWithNotification, AgentSessionEventWebhookPayload, AppUserTeamAccessChangedWebhookPayload, OAuthAppWebhookPayload } from '@linear/sdk/webhooks';
 import { L as Logger } from './logger-CABQOnlR.js';
 import { C as CustomToolDef } from './customTools-BzF0IISO.js';
 import { IncomingMessage, ServerResponse } from 'node:http';
-import './dtos-DUpbIu8k.js';
+import './dtos-B8KU_q4d.js';
 import 'zod';
 
+interface CandidateRepositoryInput {
+    hostname: string;
+    repositoryFullName: string;
+}
+interface RepositorySuggestion {
+    repositoryFullName: string;
+    hostname?: string | null;
+    confidence: number;
+}
 /**
  * Subset of `LinearClient` covering only the activity-reporting methods.
  */
@@ -14,7 +23,9 @@ interface LinearActivityClient {
     createAgentActivity(input: {
         agentSessionId: string;
         content: Record<string, unknown>;
+        ephemeral?: boolean;
     }): Promise<unknown>;
+    updateAgentSession?: (id: string, input: Record<string, unknown>) => Promise<unknown>;
     updateIssue?: (issueId: string, input: Record<string, unknown>) => Promise<unknown>;
     createComment?: (input: {
         issueId: string;
@@ -22,22 +33,81 @@ interface LinearActivityClient {
     }) => Promise<unknown>;
     issue?: (issueId: string) => Promise<unknown>;
     workflowStates?: (variables?: Record<string, unknown>) => Promise<unknown>;
+    issueRepositorySuggestions?: (candidateRepositories: CandidateRepositoryInput[], issueId: string, variables?: {
+        agentSessionId?: string | null;
+    }) => Promise<unknown>;
+    agentSessionUpdateExternalUrl?: (id: string, input: Record<string, unknown>) => Promise<unknown>;
+    /** Create an agent session on an existing Linear issue (proactive initiation). */
+    agentSessionCreateOnIssue?: (input: {
+        issueId: string;
+        externalLink?: string;
+    }) => Promise<unknown>;
+    /** Create an agent session on a specific comment thread (proactive initiation). */
+    agentSessionCreateOnComment?: (input: {
+        commentId: string;
+        externalLink?: string;
+    }) => Promise<unknown>;
+    /** Create a new Linear issue from scratch. */
+    createIssue?: (input: {
+        teamId: string;
+        title: string;
+        description?: string;
+        priority?: number;
+        assigneeId?: string;
+        stateId?: string;
+        labelIds?: string[];
+    }) => Promise<unknown>;
 }
 interface PlanStep {
     title: string;
     status: "pending" | "in_progress" | "completed" | "failed";
 }
-declare function postThought(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
-declare function postError(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
+interface SelectOption {
+    label: string;
+    value: string;
+}
+/** Longest body string allowed in an elicitation activity. */
+declare const ELICITATION_BODY_MAX_LENGTH = 10000;
+/** Longest label or value string allowed in a select option. */
+declare const SELECT_OPTION_MAX_LENGTH = 200;
+/** Longest provider name string allowed in an auth elicitation. */
+declare const PROVIDER_MAX_LENGTH = 100;
+declare function postThought(client: LinearActivityClient, sessionId: string, body: string, options?: {
+    ephemeral?: boolean;
+}): Promise<void>;
+declare function postError(client: LinearActivityClient, sessionId: string, body: string, options?: {
+    ephemeral?: boolean;
+}): Promise<void>;
 declare function postResponse(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
 declare function postElicitation(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
-declare function postAction(client: LinearActivityClient, sessionId: string, body: string): Promise<void>;
+declare function postSelectElicitation(client: LinearActivityClient, sessionId: string, body: string, options: SelectOption[]): Promise<void>;
+declare function postAuthElicitation(client: LinearActivityClient, sessionId: string, body: string, url: string, provider?: string): Promise<void>;
+declare function postAction(client: LinearActivityClient, sessionId: string, body: string, options?: {
+    ephemeral?: boolean;
+}): Promise<void>;
 declare function updatePlan(client: LinearActivityClient, sessionId: string, steps: PlanStep[]): Promise<void>;
 
+interface HandleAppUserNotificationInput {
+    payload: AppUserNotificationWebhookPayloadWithNotification;
+    deps: LinearBandBridgeDeps;
+    logger: Logger;
+    /** The Linear app-user id from the webhook envelope; used to skip self-notifications. */
+    appUserId?: string;
+}
+declare function handleAppUserNotification(input: HandleAppUserNotificationInput): Promise<void>;
+
 type RoomStrategy = "issue" | "session";
 type WritebackMode = "final_only" | "activity_stream";
 type SessionStatus = "active" | "waiting" | "completed" | "canceled" | "errored";
-interface LinearThenvoiBridgeConfig {
+/** Default interval (ms) between stale-session keepalive checks. */
+declare const STALE_SESSION_CHECK_INTERVAL_MS: number;
+/**
+ * Maximum age (ms) of the last Linear activity before a session is considered
+ * at risk of going stale. Linear marks sessions stale after 30 minutes of
+ * inactivity; we send a keepalive well before that threshold.
+ */
+declare const STALE_SESSION_THRESHOLD_MS: number;
+interface LinearBandBridgeConfig {
     linearAccessToken: string;
     linearWebhookSecret: string;
     roomStrategy?: RoomStrategy;
@@ -46,20 +116,23 @@ interface LinearThenvoiBridgeConfig {
     planningAgentHandles?: string[];
     implementationAgentHandles?: string[];
     recoveredRoomRetryBaseDelayMs?: number;
+    bandAppBaseUrl?: string;
 }
 interface SessionRoomRecord {
     linearSessionId: string;
     linearIssueId: string | null;
-    thenvoiRoomId: string;
+    bandRoomId: string;
     status: SessionStatus;
     lastEventKey?: string | null;
+    /** ISO-8601 timestamp of the last activity sent to Linear for this session. */
+    lastLinearActivityAt?: string | null;
     createdAt: string;
     updatedAt: string;
 }
 interface PendingBootstrapRequest {
     eventKey: string;
     linearSessionId: string;
-    thenvoiRoomId: string;
+    bandRoomId: string;
     expectedContent: string;
     messageType: string;
     senderId?: string | null;
@@ -76,18 +149,20 @@ interface SessionRoomStore {
     enqueueBootstrapRequest(request: PendingBootstrapRequest): Promise<void>;
     listPendingBootstrapRequests(limit?: number): Promise<PendingBootstrapRequest[]>;
     markBootstrapRequestProcessed(eventKey: string): Promise<void>;
+    /** List sessions with active or waiting status (used by stale-session keepalive). */
+    listActiveSessions?(): Promise<SessionRoomRecord[]>;
     close?(): Promise<void>;
 }
-interface LinearThenvoiBridgeDeps {
-    thenvoiRest: RestApi;
+interface LinearBandBridgeDeps {
+    bandRest: RestApi;
     linearClient: LinearClient;
     store: SessionRoomStore;
     logger?: Logger;
 }
 interface HandleAgentSessionEventInput {
     payload: AgentSessionEventWebhookPayload;
-    config: LinearThenvoiBridgeConfig;
-    deps: LinearThenvoiBridgeDeps;
+    config: LinearBandBridgeConfig;
+    deps: LinearBandBridgeDeps;
 }
 
 type LinearSessionStatus = SessionStatus;
@@ -120,6 +195,55 @@ declare function completeLinearSession(input: {
     lastEventKey?: string | null;
 }): Promise<void>;
 
+interface StaleSessionGuardOptions {
+    store: SessionRoomStore;
+    linearClient: LinearActivityClient;
+    logger?: Logger;
+    /** Interval (ms) between keepalive checks. Defaults to 20 minutes. */
+    checkIntervalMs?: number;
+    /** Max age (ms) of last activity before sending a keepalive. Defaults to 25 minutes. */
+    staleThresholdMs?: number;
+    /** Message sent as a keepalive thought. */
+    keepAliveMessage?: string;
+}
+/**
+ * Periodically checks active Linear sessions and sends a keepalive activity
+ * to prevent Linear from marking them as stale (30-minute inactivity timeout).
+ */
+declare class StaleSessionGuard {
+    private readonly store;
+    private readonly linearClient;
+    private readonly logger;
+    private readonly checkIntervalMs;
+    private readonly staleThresholdMs;
+    private readonly keepAliveMessage;
+    private timer;
+    constructor(options: StaleSessionGuardOptions);
+    /** Start the periodic keepalive check. Safe to call multiple times. */
+    start(): void;
+    /** Stop the periodic keepalive check. */
+    stop(): void;
+    /** Run a single keepalive check. Exposed for testing and manual invocation. */
+    tick(): Promise<number>;
+}
+/**
+ * Returns `true` when the session's last Linear activity is older than
+ * `thresholdMs`, meaning it risks being marked stale by Linear.
+ */
+declare function isSessionStale(session: SessionRoomRecord, nowMs: number, thresholdMs: number): boolean;
+/**
+ * Checks whether a session may have gone stale and sends a recovery activity
+ * before the main update. Call this before posting significant activities to
+ * a session that may have been idle for a long time.
+ */
+declare function sendRecoveryActivityIfStale(input: {
+    session: SessionRoomRecord;
+    linearClient: LinearActivityClient;
+    store: SessionRoomStore;
+    logger: Logger;
+    staleThresholdMs?: number;
+}): Promise<boolean>;
+
 declare function isLinearApiKey(token: string): boolean;
 declare function createLinearClient(token: string): LinearClient;
 declare function buildLinearAuthorizationHeader(token: string): string;
@@ -133,6 +257,7 @@ interface CreateLinearToolsOptions {
     client: LinearActivityClient;
     store?: SessionRoomStore;
     enableElicitation?: boolean;
+    logger?: Logger;
 }
 /**
  * Create Linear activity tools usable by any adapter via `customTools`.
@@ -149,10 +274,15 @@ interface LinearBridgeDispatcher {
     isQueued?(eventKey: string): boolean;
     waitForIdle?(): Promise<void>;
 }
+interface PermissionChangeCallbacks {
+    onTeamAccessChanged?: (payload: AppUserTeamAccessChangedWebhookPayload) => void | Promise<void>;
+    onOAuthAppRevoked?: (payload: OAuthAppWebhookPayload) => void | Promise<void>;
+}
 interface CreateLinearWebhookHandlerOptions {
-    config: LinearThenvoiBridgeConfig;
-    deps: LinearThenvoiBridgeDeps;
+    config: LinearBandBridgeConfig;
+    deps: LinearBandBridgeDeps;
     dispatcher?: LinearBridgeDispatcher;
+    permissionCallbacks?: PermissionChangeCallbacks;
 }
 declare function createInlineLinearBridgeDispatcher(options?: {
     logger?: Logger;
@@ -164,4 +294,4 @@ declare function createLinearWebhookHandler(options: CreateLinearWebhookHandlerO
 
 declare const DEFAULT_STATUS_MAPPING: Record<SessionStatus, LinearSessionStatus>;
 
-export { type CreateLinearWebhookHandlerOptions, DEFAULT_STATUS_MAPPING, type HandleAgentSessionEventInput, type LinearActivityClient, type LinearBridgeDispatchJob, type LinearBridgeDispatcher, type LinearBridgeRuntime, type LinearSessionStatus, type LinearThenvoiBridgeConfig, type LinearThenvoiBridgeDeps, type PendingBootstrapRequest, type PlanStep, type RoomStrategy, type SessionRoomRecord, type SessionRoomStore, type SessionStatus, type WritebackMode, buildLinearAuthorizationHeader, completeLinearSession, createInProcessLinearBridgeDispatcher, createInlineLinearBridgeDispatcher, createLinearBridgeRuntime, createLinearClient, createLinearTools, createLinearWebhookHandler, createSqliteSessionRoomStore, dedupeHandles, handleAgentSessionEvent, isLinearApiKey, postAction, postElicitation, postError, postResponse, postThought, stripHandlePrefix, updatePlan };
+export { type CandidateRepositoryInput, type CreateLinearWebhookHandlerOptions, DEFAULT_STATUS_MAPPING, ELICITATION_BODY_MAX_LENGTH, type HandleAgentSessionEventInput, type HandleAppUserNotificationInput, type LinearActivityClient, type LinearBandBridgeConfig, type LinearBandBridgeDeps, type LinearBridgeDispatchJob, type LinearBridgeDispatcher, type LinearBridgeRuntime, type LinearSessionStatus, PROVIDER_MAX_LENGTH, type PendingBootstrapRequest, type PermissionChangeCallbacks, type PlanStep, type RepositorySuggestion, type RoomStrategy, SELECT_OPTION_MAX_LENGTH, STALE_SESSION_CHECK_INTERVAL_MS, STALE_SESSION_THRESHOLD_MS, type SelectOption, type SessionRoomRecord, type SessionRoomStore, type SessionStatus, StaleSessionGuard, type StaleSessionGuardOptions, type WritebackMode, buildLinearAuthorizationHeader, completeLinearSession, createInProcessLinearBridgeDispatcher, createInlineLinearBridgeDispatcher, createLinearBridgeRuntime, createLinearClient, createLinearTools, createLinearWebhookHandler, createSqliteSessionRoomStore, dedupeHandles, handleAgentSessionEvent, handleAppUserNotification, isLinearApiKey, isSessionStale, postAction, postAuthElicitation, postElicitation, postError, postResponse, postSelectElicitation, postThought, sendRecoveryActivityIfStale, stripHandlePrefix, updatePlan };