@graychennpm/codebridge 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,371 @@
+import type { ChannelDeliveryRow, ProviderHistoryImportInput, ProviderHistoryImportResult, ReplaySafety, RunAttempt, SessionRuntime, SessionEventInput, SessionTimelineSegment, SessionTimelineTurn, SessionTurn, SessionRuntimeTransaction } from "./session-runtime.js";
+export type { ChannelDeliveryInput, ChannelDeliveryRow, ChannelDeliveryStatus, ChannelActorRef, ImportedHistoryEntry, ProviderHistoryImportInput, ProviderHistoryImportResult, QueuePauseReason, QueueState, ReplaySafety, RunAttempt, SessionEventInput, SessionRuntime, SessionRuntimeTransaction, SessionRuntimeWorkItemInput, SessionRunSpec, SessionTimelineBlock, SessionTimelineSegment, SessionTimelineTurn, SessionTurn, SessionTurnMessage, SessionTurnStatus, TimelineTurnStatus, } from "./session-runtime.js";
+export type WorkItemStatus = "created" | "exploring" | "planned" | "awaiting_input" | "awaiting_approval" | "executing" | "verifying" | "manual_review" | "completed" | "failed" | "cancelled";
+export type WorkItemMode = "auto" | "investigation" | "change" | "review" | "release" | "observe";
+export type RiskLevel = "read_only" | "workspace_write" | "git_write" | "production_write";
+export type DomainEventType = "WORK_ITEM_CREATED" | "SESSION_HISTORY_HYDRATED" | "MESSAGE_RECEIVED" | "RUN_CREATED" | "AGENT_EVENT" | "RUN_STARTED" | "RUN_SUCCEEDED" | "RUN_FAILED" | "RUN_CANCELLED" | "RUN_CANCEL_REQUESTED" | "RUN_INTERRUPTED" | "TURN_QUEUED" | "TURN_DISPATCHED" | "TURN_CANCELLED" | "DISCOVERY_STARTED" | "PROJECT_CANDIDATE_FOUND" | "PLAN_PROPOSED" | "PLAN_VALIDATED" | "APPROVAL_REQUESTED" | "APPROVAL_GRANTED" | "APPROVAL_REJECTED" | "STEP_STARTED" | "STEP_SUCCEEDED" | "STEP_SKIPPED" | "STEP_RETRYING" | "STEP_FAILED" | "BRANCH_SELECTED" | "ARTIFACT_CREATED" | "VERIFICATION_COMPLETED" | "WORK_ITEM_COMPLETED";
+export type DomainEventActor = "user" | "agent" | "system" | "adapter" | "channel";
+export interface WorkItem {
+    schemaVersion: 1;
+    id: string;
+    title: string;
+    status: WorkItemStatus;
+    mode: WorkItemMode;
+    conversationId: string;
+    sessionId: string | null;
+    agentId: string | null;
+    workflowId: string | null;
+    workflowRevision: string | null;
+    workspaceScope: string[];
+    identifiers: Record<string, unknown>;
+    contextRevision: number;
+    riskLevel: RiskLevel;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateWorkItemInput {
+    id?: string;
+    title: string;
+    mode: WorkItemMode;
+    conversationId: string;
+    sessionId?: string | null;
+    agentId?: string | null;
+    workflowId?: string | null;
+    workflowRevision?: string | null;
+    workspaceScope?: string[];
+    identifiers?: Record<string, unknown>;
+    contextRevision?: number;
+    riskLevel: RiskLevel;
+}
+export interface DomainEvent {
+    schemaVersion: 1;
+    eventId: string;
+    sequence: number;
+    workItemId: string;
+    runId: string | null;
+    executionKind: ExecutionKind | null;
+    type: DomainEventType;
+    occurredAt: string;
+    actor: DomainEventActor;
+    target: string | null;
+    inputHash: string | null;
+    resultRef: string | null;
+    payload: Record<string, unknown>;
+}
+export interface ContextUsage {
+    used: number;
+    size: number;
+}
+export interface AppendEventInput {
+    workItemId: string;
+    runId?: string | null;
+    type: DomainEventType;
+    actor: DomainEventActor;
+    target?: string | null;
+    inputHash?: string | null;
+    resultRef?: string | null;
+    payload?: Record<string, unknown>;
+}
+export type RunStatus = "queued" | "running" | "waiting" | "succeeded" | "failed" | "cancelled" | "interrupted";
+export type ExecutionKind = "agent" | "flow";
+export interface Run {
+    schemaVersion: 1;
+    id: string;
+    workItemId: string;
+    sessionId: string | null;
+    turnId: string | null;
+    mode: WorkItemMode;
+    status: RunStatus;
+    executionKind: ExecutionKind;
+    agentId: string | null;
+    planId: string | null;
+    planIrHash: string | null;
+    workflowRevision: string | null;
+    terminalReason: string | null;
+    replaySafety: ReplaySafety;
+    leaseOwner: string | null;
+    leaseExpiresAt: string | null;
+    cancelRequestedAt: string | null;
+    cancelDeadlineAt: string | null;
+    providerSessionId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateRunInput {
+    id?: string;
+    workItemId: string;
+    sessionId?: string | null;
+    turnId?: string | null;
+    mode: WorkItemMode;
+    executionKind: ExecutionKind;
+    agentId?: string | null;
+    planId?: string | null;
+    planIrHash?: string | null;
+    workflowRevision?: string | null;
+    providerSessionId?: string | null;
+}
+export interface PersistedPlanStep {
+    id: string;
+    capabilityId: string | null;
+    risk: "read_only" | "workspace_write" | "git_write" | "production_write" | "manual";
+    dependsOn: string[];
+    guard: string | null;
+    approval: "none" | "required";
+    branches: Array<{
+        when: string;
+        next: string;
+    }>;
+    purpose: string | null;
+    successWhen?: string | null;
+    retry?: {
+        maxAttempts: number;
+        delayMs: number;
+    } | null;
+}
+export interface PersistedPlan {
+    schemaVersion: 1;
+    planId: string;
+    source: "workflow" | "agent_generated";
+    workflowId: string;
+    definitionRevision: string | null;
+    planIrHash: string | null;
+    sessionId: string | null;
+    runId: string | null;
+    steps: PersistedPlanStep[];
+    createdAt: string;
+}
+export interface SavePlanInput {
+    planId: string;
+    source: PersistedPlan["source"];
+    workflowId: string;
+    definitionRevision: string | null;
+    planIrHash?: string | null;
+    sessionId?: string | null;
+    runId?: string | null;
+    steps: PersistedPlanStep[];
+}
+export type ArtifactKind = "output" | "diff" | "test_report" | "log" | "image" | "other";
+export interface ArtifactRecord {
+    id: string;
+    workItemId: string;
+    runId: string;
+    stepId: string | null;
+    kind: ArtifactKind;
+    name: string;
+    mimeType: string;
+    content: string;
+    contentHash: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export interface CreateArtifactInput {
+    id?: string;
+    workItemId: string;
+    runId: string;
+    stepId?: string | null;
+    kind?: ArtifactKind;
+    name: string;
+    mimeType?: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    actor?: DomainEventActor;
+}
+export type VerificationStatus = "passed" | "failed" | "skipped";
+export interface VerificationRecord {
+    id: string;
+    workItemId: string;
+    runId: string;
+    stepId: string | null;
+    validator: string;
+    status: VerificationStatus;
+    summary: string;
+    artifactIds: string[];
+    createdAt: string;
+}
+export interface RecordVerificationInput {
+    id?: string;
+    workItemId: string;
+    runId: string;
+    stepId?: string | null;
+    validator: string;
+    status: VerificationStatus;
+    summary: string;
+    artifactIds?: string[];
+}
+export interface MessageAttachmentRecord {
+    schemaVersion: 1;
+    id: string;
+    workItemId: string;
+    name: string;
+    mimeType: string;
+    dataBase64: string;
+    byteSize: number;
+    contentHash: string;
+    createdAt: string;
+}
+export interface CreateMessageAttachmentInput {
+    id?: string;
+    workItemId: string;
+    name: string;
+    mimeType?: string;
+    dataBase64: string;
+}
+export declare class SqliteEventStore {
+    private readonly database;
+    private transactionDepth;
+    constructor(databasePath: string);
+    createWorkItem(input: CreateWorkItemInput): WorkItem;
+    getWorkItem(workItemId: string): WorkItem | undefined;
+    getWorkItemBySessionId(sessionId: string): WorkItem | undefined;
+    getSessionRuntime(sessionId: string): SessionRuntime | undefined;
+    /**
+     * First and latest ACP usage_update persisted for a session (context tokens in use / model window).
+     * INDEXED BY: without ANALYZE stats SQLite picks the (target, sequence) index and scans every
+     * session's usage rows; this keeps the lookup inside one work item.
+     */
+    getContextUsage(sessionId: string): {
+        first: ContextUsage;
+        latest: ContextUsage;
+    } | undefined;
+    getTurn(turnId: string): SessionTurn | undefined;
+    listQueuedTurns(sessionId: string, options: {
+        afterPosition?: number;
+        limit: number;
+    }): {
+        turns: SessionTurn[];
+        total: number;
+        nextCursor: number | null;
+    };
+    listTimelineTurns(sessionId: string, options: {
+        before?: number;
+        limit: number;
+        contentBudgetBytes?: number;
+    }): {
+        turns: SessionTimelineTurn[];
+        previousCursor: number | null;
+        truncatedBlockIds: string[];
+    };
+    listTimelineSegments(blockId: string, options: {
+        after?: number;
+        limit: number;
+    }): {
+        segments: SessionTimelineSegment[];
+        nextCursor: number | null;
+    };
+    listSessionCommands(sessionId: string): Array<{
+        name: string;
+        description: string;
+        input?: {
+            hint: string;
+        };
+    }>;
+    countAllChanges(): number;
+    getProviderHistoryImport(sessionId: string, providerSessionId: string): {
+        providerDigest: string;
+        importedPosition: number;
+        importedAt: string;
+    } | undefined;
+    importProviderHistory(input: ProviderHistoryImportInput): ProviderHistoryImportResult;
+    withSessionTransaction<T>(operation: (transaction: SessionRuntimeTransaction) => T): T;
+    private withTransaction;
+    previewSessionRuntimeMigration(bindings: Array<{
+        sessionId: string;
+        workItemId: string;
+    }>): {
+        conflicts: Array<{
+            sessionId: string;
+            activeRunIds: string[];
+        }>;
+    };
+    bindWorkItemToSession(sessionId: string, workItemId: string): void;
+    backfillRunTurns(sessionId: string, workItemId: string): number;
+    ensureRuntimeFromRuns(sessionId: string): SessionRuntime;
+    getProjectionCursor(sessionId: string): number;
+    backfillSessionProjection(sessionId: string, workItemId: string, batchSize: number): number;
+    listWorkItems(): WorkItem[];
+    appendEvent(input: AppendEventInput): DomainEvent;
+    appendLeasedRunEvent(owner: string, input: SessionEventInput & {
+        runId: string;
+    }): DomainEvent;
+    appendEventOnce(input: AppendEventInput & {
+        inputHash: string;
+    }): DomainEvent;
+    listEvents(workItemId: string, afterSequence?: number): DomainEvent[];
+    listEventsByTarget(target: string): DomainEvent[];
+    listEventsPage(workItemId: string, afterSequence: number, limit: number): DomainEvent[];
+    listRecentEvents(workItemId: string, limit: number): DomainEvent[];
+    listEventInputHashes(workItemId: string): Set<string>;
+    sequenceForEventId(workItemId: string, eventId: string): number;
+    savePlan(input: SavePlanInput): PersistedPlan;
+    getPlan(planId: string): PersistedPlan | undefined;
+    getPlanForRun(runId: string): PersistedPlan | undefined;
+    createRun(input: CreateRunInput): Run;
+    getRun(runId: string): Run | undefined;
+    listRuns(workItemId: string): Run[];
+    listRunsByStatus(statuses: RunStatus[]): Run[];
+    updateRunStatus(runId: string, status: RunStatus): Run;
+    updateRunControl(runId: string, patch: {
+        status?: RunStatus;
+        terminalReason?: string | null;
+        replaySafety?: ReplaySafety;
+        leaseOwner?: string | null;
+        leaseExpiresAt?: string | null;
+        cancelRequestedAt?: string | null;
+        cancelDeadlineAt?: 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;
+    updateLeasedRunReplaySafety(runId: string, owner: string, replaySafety: ReplaySafety): Run;
+    listExpiredRunningRuns(now: string, limit: number): Run[];
+    listCancellationDeadlineRuns(now: string, limit: number): Run[];
+    listDeliveries(channel: string, surfaceMessageId?: string): ChannelDeliveryRow[];
+    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;
+    setSessionProviderSessionId(sessionId: string, providerSessionId: string | null): void;
+    startRunAttempt(runId: string): RunAttempt;
+    finishRunAttempt(attemptId: string, input: {
+        providerError: string | null;
+        sideEffectBoundary: ReplaySafety;
+    }): RunAttempt;
+    listRunAttempts(runId: string): RunAttempt[];
+    findTerminalEventForRun(runId: string): DomainEvent | undefined;
+    requeueRun(runId: string): Run;
+    putIdempotencyResponse(namespace: string, key: string, response: unknown, createdAt?: string): void;
+    getIdempotencyRecord(namespace: string, key: string): {
+        response: unknown;
+        createdAt: string;
+    } | undefined;
+    getIdempotencyResponse(namespace: string, key: string): unknown | undefined;
+    deleteIdempotencyResponse(namespace: string, key: string): void;
+    createMessageAttachment(input: CreateMessageAttachmentInput): MessageAttachmentRecord;
+    getMessageAttachment(id: string): MessageAttachmentRecord | undefined;
+    listMessageAttachments(workItemId: string, ids?: string[]): MessageAttachmentRecord[];
+    createArtifact(input: CreateArtifactInput): ArtifactRecord;
+    getArtifact(id: string): ArtifactRecord | undefined;
+    listArtifacts(runId: string): ArtifactRecord[];
+    recordVerification(input: RecordVerificationInput): VerificationRecord;
+    listVerifications(runId: string): VerificationRecord[];
+    close(): void;
+    private appendEventInTransaction;
+}
+//# sourceMappingURL=index.d.ts.map