@band-ai/sdk 0.1.2

package/dist/linear.d.cts

@@ -0,0 +1,167 @@
+import { LinearClient, LinearDocument } from '@linear/sdk';
+import { R as RestApi } from './types-CSHFipIc.cjs';
+import { AgentSessionEventWebhookPayload } 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 'zod';
+
+/**
+ * Subset of `LinearClient` covering only the activity-reporting methods.
+ */
+interface LinearActivityClient {
+    createAgentActivity(input: {
+        agentSessionId: string;
+        content: Record<string, unknown>;
+    }): Promise<unknown>;
+    updateIssue?: (issueId: string, input: Record<string, unknown>) => Promise<unknown>;
+    createComment?: (input: {
+        issueId: string;
+        body: string;
+    }) => Promise<unknown>;
+    issue?: (issueId: string) => Promise<unknown>;
+    workflowStates?: (variables?: Record<string, unknown>) => 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>;
+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 updatePlan(client: LinearActivityClient, sessionId: string, steps: PlanStep[]): Promise<void>;
+
+type RoomStrategy = "issue" | "session";
+type WritebackMode = "final_only" | "activity_stream";
+type SessionStatus = "active" | "waiting" | "completed" | "canceled" | "errored";
+interface LinearThenvoiBridgeConfig {
+    linearAccessToken: string;
+    linearWebhookSecret: string;
+    roomStrategy?: RoomStrategy;
+    writebackMode?: WritebackMode;
+    hostAgentHandle?: string;
+    planningAgentHandles?: string[];
+    implementationAgentHandles?: string[];
+    recoveredRoomRetryBaseDelayMs?: number;
+}
+interface SessionRoomRecord {
+    linearSessionId: string;
+    linearIssueId: string | null;
+    thenvoiRoomId: string;
+    status: SessionStatus;
+    lastEventKey?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PendingBootstrapRequest {
+    eventKey: string;
+    linearSessionId: string;
+    thenvoiRoomId: string;
+    expectedContent: string;
+    messageType: string;
+    senderId?: string | null;
+    senderName?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    expiresAt: string;
+}
+interface SessionRoomStore {
+    getBySessionId(sessionId: string): Promise<SessionRoomRecord | null>;
+    getByIssueId(issueId: string): Promise<SessionRoomRecord | null>;
+    upsert(record: SessionRoomRecord): Promise<void>;
+    markCanceled(sessionId: string): Promise<void>;
+    enqueueBootstrapRequest(request: PendingBootstrapRequest): Promise<void>;
+    listPendingBootstrapRequests(limit?: number): Promise<PendingBootstrapRequest[]>;
+    markBootstrapRequestProcessed(eventKey: string): Promise<void>;
+    close?(): Promise<void>;
+}
+interface LinearThenvoiBridgeDeps {
+    thenvoiRest: RestApi;
+    linearClient: LinearClient;
+    store: SessionRoomStore;
+    logger?: Logger;
+}
+interface HandleAgentSessionEventInput {
+    payload: AgentSessionEventWebhookPayload;
+    config: LinearThenvoiBridgeConfig;
+    deps: LinearThenvoiBridgeDeps;
+}
+
+type LinearSessionStatus = SessionStatus;
+
+interface LinearBridgeRuntime {
+    roomResolutionLocks: Map<string, Promise<SessionRoomRecord>>;
+    resolvedHostHandleCache: WeakMap<RestApi, string>;
+    authenticatedHostHandleCache: WeakMap<RestApi, string>;
+}
+declare function createLinearBridgeRuntime(): LinearBridgeRuntime;
+declare function handleAgentSessionEvent(input: HandleAgentSessionEventInput, options?: {
+    skipAcknowledgment?: boolean;
+    expectedEventKey?: string;
+    skipRoomWrite?: boolean;
+    runtime?: LinearBridgeRuntime;
+}): Promise<void>;
+declare function completeLinearSession(input: {
+    linearClient: {
+        createAgentActivity: (request: {
+            agentSessionId: string;
+            content: {
+                type: LinearDocument.AgentActivityType;
+                body: string;
+            };
+        }) => Promise<unknown>;
+    };
+    agentSessionId: string;
+    body: string;
+    store?: SessionRoomStore;
+    lastEventKey?: string | null;
+}): Promise<void>;
+
+declare function isLinearApiKey(token: string): boolean;
+declare function createLinearClient(token: string): LinearClient;
+declare function buildLinearAuthorizationHeader(token: string): string;
+
+declare function stripHandlePrefix(handle: string): string;
+declare function dedupeHandles(handles: Iterable<string>): string[];
+
+declare function createSqliteSessionRoomStore(dbPath: string): SessionRoomStore;
+
+interface CreateLinearToolsOptions {
+    client: LinearActivityClient;
+    store?: SessionRoomStore;
+    enableElicitation?: boolean;
+}
+/**
+ * Create Linear activity tools usable by any adapter via `customTools`.
+ */
+declare function createLinearTools(options: CreateLinearToolsOptions): CustomToolDef[];
+
+interface LinearBridgeDispatchJob {
+    eventKey: string;
+    input: HandleAgentSessionEventInput;
+    runtime?: LinearBridgeRuntime;
+}
+interface LinearBridgeDispatcher {
+    dispatch(job: LinearBridgeDispatchJob): Promise<void> | void;
+    isQueued?(eventKey: string): boolean;
+    waitForIdle?(): Promise<void>;
+}
+interface CreateLinearWebhookHandlerOptions {
+    config: LinearThenvoiBridgeConfig;
+    deps: LinearThenvoiBridgeDeps;
+    dispatcher?: LinearBridgeDispatcher;
+}
+declare function createInlineLinearBridgeDispatcher(options?: {
+    logger?: Logger;
+}): LinearBridgeDispatcher;
+declare function createInProcessLinearBridgeDispatcher(options?: {
+    logger?: Logger;
+}): LinearBridgeDispatcher;
+declare function createLinearWebhookHandler(options: CreateLinearWebhookHandlerOptions): (request: IncomingMessage, response: ServerResponse) => Promise<void>;
+
+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 };

package/dist/linear.d.ts

@@ -0,0 +1,167 @@
+import { LinearClient, LinearDocument } from '@linear/sdk';
+import { R as RestApi } from './types-CxII3XkA.js';
+import { AgentSessionEventWebhookPayload } 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 'zod';
+
+/**
+ * Subset of `LinearClient` covering only the activity-reporting methods.
+ */
+interface LinearActivityClient {
+    createAgentActivity(input: {
+        agentSessionId: string;
+        content: Record<string, unknown>;
+    }): Promise<unknown>;
+    updateIssue?: (issueId: string, input: Record<string, unknown>) => Promise<unknown>;
+    createComment?: (input: {
+        issueId: string;
+        body: string;
+    }) => Promise<unknown>;
+    issue?: (issueId: string) => Promise<unknown>;
+    workflowStates?: (variables?: Record<string, unknown>) => 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>;
+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 updatePlan(client: LinearActivityClient, sessionId: string, steps: PlanStep[]): Promise<void>;
+
+type RoomStrategy = "issue" | "session";
+type WritebackMode = "final_only" | "activity_stream";
+type SessionStatus = "active" | "waiting" | "completed" | "canceled" | "errored";
+interface LinearThenvoiBridgeConfig {
+    linearAccessToken: string;
+    linearWebhookSecret: string;
+    roomStrategy?: RoomStrategy;
+    writebackMode?: WritebackMode;
+    hostAgentHandle?: string;
+    planningAgentHandles?: string[];
+    implementationAgentHandles?: string[];
+    recoveredRoomRetryBaseDelayMs?: number;
+}
+interface SessionRoomRecord {
+    linearSessionId: string;
+    linearIssueId: string | null;
+    thenvoiRoomId: string;
+    status: SessionStatus;
+    lastEventKey?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PendingBootstrapRequest {
+    eventKey: string;
+    linearSessionId: string;
+    thenvoiRoomId: string;
+    expectedContent: string;
+    messageType: string;
+    senderId?: string | null;
+    senderName?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    expiresAt: string;
+}
+interface SessionRoomStore {
+    getBySessionId(sessionId: string): Promise<SessionRoomRecord | null>;
+    getByIssueId(issueId: string): Promise<SessionRoomRecord | null>;
+    upsert(record: SessionRoomRecord): Promise<void>;
+    markCanceled(sessionId: string): Promise<void>;
+    enqueueBootstrapRequest(request: PendingBootstrapRequest): Promise<void>;
+    listPendingBootstrapRequests(limit?: number): Promise<PendingBootstrapRequest[]>;
+    markBootstrapRequestProcessed(eventKey: string): Promise<void>;
+    close?(): Promise<void>;
+}
+interface LinearThenvoiBridgeDeps {
+    thenvoiRest: RestApi;
+    linearClient: LinearClient;
+    store: SessionRoomStore;
+    logger?: Logger;
+}
+interface HandleAgentSessionEventInput {
+    payload: AgentSessionEventWebhookPayload;
+    config: LinearThenvoiBridgeConfig;
+    deps: LinearThenvoiBridgeDeps;
+}
+
+type LinearSessionStatus = SessionStatus;
+
+interface LinearBridgeRuntime {
+    roomResolutionLocks: Map<string, Promise<SessionRoomRecord>>;
+    resolvedHostHandleCache: WeakMap<RestApi, string>;
+    authenticatedHostHandleCache: WeakMap<RestApi, string>;
+}
+declare function createLinearBridgeRuntime(): LinearBridgeRuntime;
+declare function handleAgentSessionEvent(input: HandleAgentSessionEventInput, options?: {
+    skipAcknowledgment?: boolean;
+    expectedEventKey?: string;
+    skipRoomWrite?: boolean;
+    runtime?: LinearBridgeRuntime;
+}): Promise<void>;
+declare function completeLinearSession(input: {
+    linearClient: {
+        createAgentActivity: (request: {
+            agentSessionId: string;
+            content: {
+                type: LinearDocument.AgentActivityType;
+                body: string;
+            };
+        }) => Promise<unknown>;
+    };
+    agentSessionId: string;
+    body: string;
+    store?: SessionRoomStore;
+    lastEventKey?: string | null;
+}): Promise<void>;
+
+declare function isLinearApiKey(token: string): boolean;
+declare function createLinearClient(token: string): LinearClient;
+declare function buildLinearAuthorizationHeader(token: string): string;
+
+declare function stripHandlePrefix(handle: string): string;
+declare function dedupeHandles(handles: Iterable<string>): string[];
+
+declare function createSqliteSessionRoomStore(dbPath: string): SessionRoomStore;
+
+interface CreateLinearToolsOptions {
+    client: LinearActivityClient;
+    store?: SessionRoomStore;
+    enableElicitation?: boolean;
+}
+/**
+ * Create Linear activity tools usable by any adapter via `customTools`.
+ */
+declare function createLinearTools(options: CreateLinearToolsOptions): CustomToolDef[];
+
+interface LinearBridgeDispatchJob {
+    eventKey: string;
+    input: HandleAgentSessionEventInput;
+    runtime?: LinearBridgeRuntime;
+}
+interface LinearBridgeDispatcher {
+    dispatch(job: LinearBridgeDispatchJob): Promise<void> | void;
+    isQueued?(eventKey: string): boolean;
+    waitForIdle?(): Promise<void>;
+}
+interface CreateLinearWebhookHandlerOptions {
+    config: LinearThenvoiBridgeConfig;
+    deps: LinearThenvoiBridgeDeps;
+    dispatcher?: LinearBridgeDispatcher;
+}
+declare function createInlineLinearBridgeDispatcher(options?: {
+    logger?: Logger;
+}): LinearBridgeDispatcher;
+declare function createInProcessLinearBridgeDispatcher(options?: {
+    logger?: Logger;
+}): LinearBridgeDispatcher;
+declare function createLinearWebhookHandler(options: CreateLinearWebhookHandlerOptions): (request: IncomingMessage, response: ServerResponse) => Promise<void>;
+
+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 };