@graychennpm/codebridge 0.0.0-stage → 0.1.0

package/node_modules/@codebridge/work-items/dist/session-runtime.d.ts

@@ -0,0 +1,274 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { ChannelDeliveryInput, ChannelDeliveryRow, ChannelDeliveryStatus } from "@codebridge/core";
+import type { DomainEvent, DomainEventActor, DomainEventType, ExecutionKind, PersistedPlanStep, MessageAttachmentRecord, RiskLevel, Run, RunStatus, WorkItemMode } from "./index.js";
+export type QueueState = "ready" | "paused";
+export type QueuePauseReason = "failed" | "cancelled" | "interrupted" | "stale" | null;
+export type SessionTurnStatus = "queued" | "dispatched" | "cancelled";
+export type ReplaySafety = "safe" | "side_effect_started" | "outcome_unknown";
+export type TimelineTurnStatus = "dispatched" | "running" | "waiting" | "succeeded" | "failed" | "cancelled" | "interrupted";
+export interface SessionRuntime {
+    sessionId: string;
+    activeRunId: string | null;
+    queueState: QueueState;
+    queuePauseReason: QueuePauseReason;
+    lastEventSequence: number;
+    version: number;
+    updatedAt: string;
+}
+export type ChannelActorRef = {
+    channel: "web" | "feishu" | "telegram";
+    id: string;
+};
+export interface SessionTurnMessage {
+    text: string;
+    attachmentIds: string[];
+    model: string | null;
+    effort: string | null;
+    permissionMode: string | null;
+    actorRef?: ChannelActorRef;
+    executionKind: ExecutionKind;
+    plan: {
+        planId: string;
+        source: "workflow" | "agent_generated";
+        workflowId: string;
+        definitionRevision: string | null;
+        planIrHash: string | null;
+        steps: PersistedPlanStep[];
+    } | null;
+}
+export declare function parseSessionTurnMessage(value: string): SessionTurnMessage;
+export interface SessionTurn {
+    turnId: string;
+    sessionId: string;
+    queuePosition: number;
+    status: SessionTurnStatus;
+    message: SessionTurnMessage;
+    version: number;
+    dispatchedRunId: string | null;
+    createdAt: string;
+    dispatchedAt: string | null;
+    cancelledAt: string | null;
+}
+export interface SessionTimelineSegment {
+    segmentId: string;
+    blockId: string;
+    segmentIndex: number;
+    content: string;
+    byteLength: number;
+    sealed: boolean;
+}
+export interface SessionTimelineBlock {
+    blockId: string;
+    sessionId: string;
+    turnId: string;
+    runId: string;
+    blockIndex: number;
+    kind: string;
+    status: string;
+    metadata: Record<string, unknown>;
+    segments: SessionTimelineSegment[];
+    nextSegmentCursor: number | null;
+}
+export interface RunAttempt {
+    attemptId: string;
+    runId: string;
+    attemptNumber: number;
+    startedAt: string;
+    endedAt: string | null;
+    providerError: string | null;
+    sideEffectBoundary: ReplaySafety;
+}
+export type ImportedHistoryEntry = {
+    kind: "message";
+    text: string;
+} | {
+    kind: "agent_event";
+    event: Record<string, unknown>;
+};
+export interface SessionTimelineTurn {
+    sessionId: string;
+    timelineIndex: number;
+    turnId: string;
+    runId: string;
+    startedSequence: number;
+    endedSequence: number | null;
+    status: TimelineTurnStatus;
+    blocks: SessionTimelineBlock[];
+}
+export interface SessionRuntimeWorkItemInput {
+    title: string;
+    mode: WorkItemMode;
+    conversationId: string;
+    agentId: string | null;
+    workspaceScope: string[];
+    riskLevel: RiskLevel;
+    identifiers?: Record<string, unknown>;
+}
+export interface SessionEventInput {
+    workItemId: string;
+    sessionId: string;
+    runId?: string | null;
+    type: DomainEventType;
+    actor: DomainEventActor;
+    target?: string | null;
+    inputHash?: string | null;
+    resultRef?: string | null;
+    payload?: Record<string, unknown>;
+}
+export interface ProviderHistoryImportInput {
+    sessionId: string;
+    providerSessionId: string;
+    priorPosition: number;
+    priorDigest: string;
+    nextDigest: string;
+    events: ImportedHistoryEntry[];
+    idempotencyKey: string;
+}
+export interface ProviderHistoryImportResult {
+    importedEvents: number;
+    importedTurns: number;
+    lastEventSequence: number;
+}
+export interface SessionRunSpec {
+    id: string;
+    workItemId: string;
+    sessionId: string;
+    turnId: string;
+    mode: WorkItemMode;
+    executionKind: ExecutionKind;
+    agentId: string | null;
+    planId: string | null;
+    planIrHash: string | null;
+    workflowRevision: string | null;
+    providerSessionId?: string | null;
+}
+export type { ChannelDeliveryInput, ChannelDeliveryRow, ChannelDeliveryStatus, };
+declare const transactionBrand: unique symbol;
+export interface SessionRuntimeTransaction {
+    readonly [transactionBrand]: true;
+    getRuntime(sessionId: string): SessionRuntime | undefined;
+    ensureRuntime(sessionId: string): SessionRuntime;
+    getOrCreateWorkItem(sessionId: string, input: SessionRuntimeWorkItemInput): string;
+    insertMessageAttachment(input: {
+        id: string;
+        workItemId: string;
+        name: string;
+        mimeType: string;
+        dataBase64: string;
+    }): MessageAttachmentRecord;
+    getIdempotencyResponse<T>(namespace: string, key: string): T | undefined;
+    putIdempotencyResponse(namespace: string, key: string, response: unknown): void;
+    countQueuedTurns(sessionId: string): number;
+    insertTurn(sessionId: string, message: SessionTurnMessage): SessionTurn;
+    getTurn(turnId: string): SessionTurn | undefined;
+    nextQueuedTurn(sessionId: string): SessionTurn | undefined;
+    getRun(runId: string): Run | undefined;
+    getWorkItemForSession(sessionId: string): {
+        id: string;
+        mode: WorkItemMode;
+        agentId: string | null;
+    } | undefined;
+    dispatchTurn(turnId: string, run: SessionRunSpec): {
+        turn: SessionTurn;
+        run: Run;
+    };
+    dispatchNextTurn(sessionId: string): {
+        turn: SessionTurn;
+        run: Run;
+    } | null;
+    cancelTurn(turnId: string, expectedVersion: number): SessionTurn | undefined;
+    updateRun(runId: string, patch: {
+        status?: RunStatus;
+        terminalReason?: string | null;
+        replaySafety?: ReplaySafety;
+        leaseOwner?: string | null;
+        leaseExpiresAt?: string | null;
+        cancelRequestedAt?: string | null;
+        cancelDeadlineAt?: string | null;
+        providerSessionId?: string | null;
+    }): Run;
+    claimRun(runId: string, owner: string, now: string, expiresAt: string): Run | null;
+    renewRunLease(runId: string, owner: string, now: string, expiresAt: string): Run | null;
+    reclaimRunLease(runId: string, owner: string, expiresAt: string): Run | null;
+    listExpiredRunningRuns(now: string, limit: number): Run[];
+    listCancellationDeadlineRuns(now: string, limit: number): Run[];
+    updateRuntime(sessionId: string, patch: Partial<Pick<SessionRuntime, "activeRunId" | "queueState" | "queuePauseReason">>): SessionRuntime;
+    getProviderHistoryImportCursor(sessionId: string, providerSessionId: string): {
+        providerDigest: string;
+        importedPosition: number;
+    } | undefined;
+    nextSessionQueuePosition(sessionId: string): number;
+    insertImportedTurn(input: {
+        turnId: string;
+        sessionId: string;
+        queuePosition: number;
+        message: SessionTurnMessage;
+        runId: string;
+        createdAt: string;
+        dispatchedAt: string;
+    }): void;
+    insertImportedRun(input: {
+        runId: string;
+        workItemId: string;
+        sessionId: string;
+        turnId: string;
+        createdAt: string;
+        updatedAt: string;
+    }): void;
+    upsertProviderHistoryImport(input: {
+        sessionId: string;
+        providerSessionId: string;
+        providerDigest: string;
+        importedPosition: number;
+        importedAt: string;
+    }): void;
+    insertChannelDelivery(input: {
+        turnId: string;
+        sessionId: string;
+        channel: string;
+        conversationId: string;
+        replyToMessageId: string;
+        showThinking: boolean;
+        acceptedSequence: number;
+        runId: string | null;
+        status: "pending" | "dispatched";
+    }): void;
+    markDeliveryDispatched(turnId: string, runId: string): void;
+    markDeliveryRunTerminal(runId: string, now: string): void;
+    claimDelivery(turnId: string, owner: string, now: string, expiresAt: string): boolean;
+    ackDelivery(turnId: string, owner: string, surfaceMessageId: string, surfaceCardId?: string): boolean;
+    completeDelivery(turnId: string, owner: string): boolean;
+    listDeliveries(channel: string, surfaceMessageId?: string): ChannelDeliveryRow[];
+    setSessionProviderSessionId(sessionId: string, providerSessionId: string | null): void;
+    getSessionProviderSessionId(sessionId: string): string | null;
+    claimProviderSession(input: {
+        agentId: string;
+        providerSessionId: string;
+        runId: string;
+        now: string;
+        expiresAt: string;
+    }): boolean;
+    renewProviderSession(input: {
+        agentId: string;
+        providerSessionId: string;
+        runId: string;
+        expiresAt: string;
+    }): boolean;
+    releaseProviderSession(input: {
+        agentId: string;
+        providerSessionId: string;
+        runId: string;
+    }): boolean;
+    findLiveProviderLease(agentId: string, providerSessionId: string, now: string): {
+        runId: string;
+    } | undefined;
+    appendEvent(input: SessionEventInput): DomainEvent;
+}
+export declare function createSqliteSessionRuntimeTransaction(database: DatabaseSync): {
+    transaction: SessionRuntimeTransaction;
+    deactivate: () => void;
+};
+export declare function appendSessionEventInTransaction(database: DatabaseSync, input: SessionEventInput): DomainEvent;
+export declare function resolveRunExecutionKind(database: DatabaseSync, runId: string | null): ExecutionKind | null;
+export declare function importProviderHistory(transaction: SessionRuntimeTransaction, input: ProviderHistoryImportInput): ProviderHistoryImportResult;
+//# sourceMappingURL=session-runtime.d.ts.map