agent-tower 0.7.2-beta.7 → 0.7.2-beta.8

package/dist/services/translation.service.d.ts

@@ -0,0 +1,168 @@
+import { Prisma, type PrismaClient, type TranslationSource as SourceRow } from '@prisma/client';
+import { type TeamRunTranslationOverlay, type TeamRunTranslationOverlaySummary, type TranslationInvalidatedPayload, type SessionTranslationOverlay, type TranslationBlockState, type TranslationDirection, type TranslationSettingsDraft } from '@agent-tower/shared';
+import { TranslationSettingsService } from './translation-settings.service.js';
+import { TranslationClient } from './translation-client.js';
+import { TranslationQueue } from './translation-queue.js';
+type Db = Prisma.TransactionClient;
+type SourceInput = {
+    kind: 'SESSION_BLOCK';
+    sessionId: string;
+    turnId: string;
+    blockId: string;
+    semanticType: 'assistant_message';
+    text: string;
+    state: TranslationBlockState;
+    sourceRevision?: number;
+    enableEpoch?: number;
+} | {
+    kind: 'ROOM_MESSAGE';
+    messageId: string;
+} | {
+    kind: 'USER_DELIVERY';
+    deliveryId: string;
+} | {
+    kind: 'TASK_INPUT';
+    snapshotId: string;
+};
+interface Limits {
+    sources: number;
+    displaySources: number;
+    laneSources: number;
+    attemptMs: number;
+    chainMs: number;
+    retryDelays: number[];
+    tickMs: number;
+    leaseMs: number;
+    renewMs: number;
+}
+/** App-owned translation state machine; transcript facts remain in MsgStore/Session snapshots. */
+export declare class TranslationService {
+    private readonly db;
+    private readonly settings;
+    private readonly owner;
+    private readonly queue;
+    private readonly client;
+    private readonly limits;
+    private readonly running;
+    private readonly drafts;
+    private readonly draftControllers;
+    private readonly circuits;
+    private timer?;
+    private unsubscribe?;
+    private closed;
+    private started;
+    private pumping?;
+    private checkpointOverflow;
+    private pendingCheckpoints;
+    private checkpointDrain?;
+    private pendingRoomMessages;
+    private roomDrain?;
+    private roomCursor?;
+    private roomUpperBound?;
+    /** No text/config or unbounded promises enter the original publication path. */
+    roomMessageCommitted(messageId: string): void;
+    private registerRoomCandidate;
+    private recoverRoomMessages;
+    private drainRoomMessages;
+    checkpointCommitted(sessionId: string): void;
+    private drainCheckpoints;
+    private enabledEpoch?;
+    private listeners;
+    getAdmissionEpoch: () => number | undefined;
+    onInvalidated(listener: (payload: TranslationInvalidatedPayload) => void): () => void;
+    private notify;
+    private mutation;
+    constructor(db: PrismaClient, settings: TranslationSettingsService, options?: {
+        client?: TranslationClient;
+        queue?: TranslationQueue;
+        limits?: Partial<Limits>;
+    });
+    private serial;
+    private schedule;
+    start(): Promise<void>;
+    private pauseRevoked;
+    /** Identity and lane are derived here, never accepted as untrusted scope/source keys. */
+    private resolve;
+    assertReadableTeamTask(taskId: string): Promise<void>;
+    private sourceState;
+    private readableSession;
+    private sessionSnapshot;
+    private matchesSnapshot;
+    assertReadableSession(sessionId: string): Promise<void>;
+    /** Called only after the single Session snapshot writer has committed a boundary. */
+    syncSessionCheckpoint(sessionId: string): Promise<void>;
+    private recoverSessionCheckpoints;
+    listSessionOverlays(sessionId: string, options?: {
+        blockIds?: string[];
+        cursor?: string;
+    }): Promise<{
+        items: SessionTranslationOverlay[];
+        nextCursor: string | null;
+    }>;
+    retrySessionOverlay(sessionId: string, sourceId: string, revision: number): Promise<void>;
+    assertReadableTeamRun(teamRunId: string, tx?: Db): Promise<void>;
+    /** One bounded projection over loaded message IDs; never registers or recovers history. */
+    private roomOverlays;
+    listTeamRunOverlays(teamRunId: string, messageIds: string[]): Promise<{
+        items: TeamRunTranslationOverlaySummary[];
+    }>;
+    getTeamRunOverlay(teamRunId: string, messageId: string): Promise<TeamRunTranslationOverlay>;
+    assertReadableRoomTranslation(teamRunId: string, messageId: string, sourceId: string): Promise<void>;
+    retryTeamRunOverlay(teamRunId: string, sourceId: string, revision: number): Promise<void>;
+    private hasCapacity;
+    retryDeliverySource(tx: Db, sourceId: string, enableEpoch: number): Promise<void>;
+    registerSource(input: SourceInput): Promise<SourceRow>;
+    registerDeliveryInTransaction(tx: Prisma.TransactionClient, deliveryId: string): Promise<{
+        id: string;
+        createdAt: Date;
+        sourceRevision: number;
+        turnId: string | null;
+        blockId: string | null;
+        sessionId: string | null;
+        nextRetryAt: Date | null;
+        updatedAt: Date;
+        enableEpoch: number;
+        scopeType: string;
+        scopeId: string;
+        sourceKind: string;
+        sourceKey: string;
+        laneKey: string;
+        messageId: string | null;
+        deliveryId: string | null;
+        direction: string;
+        originalText: string;
+        sourceHash: string;
+        blockState: string;
+        jobState: string;
+        currentAttemptVersion: number;
+        effectiveAttemptId: string | null;
+        generation: number;
+        retryChainId: string | null;
+        retryCount: number;
+        budgetStartedAt: Date | null;
+        deletedAt: Date | null;
+        overlayRevision: number;
+        errorCode: string | null;
+    }>;
+    /** Candidate creation and translation eligibility share one durable transaction. */
+    registerTaskInputInTransaction(tx: Prisma.TransactionClient, snapshotId: string): Promise<SourceRow>;
+    private registerSourceInTransaction;
+    retry(sourceId: string, expectedRevision: number, teamRunId?: string): Promise<SourceRow>;
+    abortSource(sourceId: string, beforeGeneration: number): void;
+    cancel(sourceId: string, deleted?: boolean): Promise<void>;
+    private wake;
+    pump(): Promise<void>;
+    private recoverExpiredLeases;
+    private runSource;
+    private translateSegment;
+    private owns;
+    private complete;
+    private retireStale;
+    private fail;
+    testDraft(identity: string, draft: TranslationSettingsDraft, text: string, direction: TranslationDirection): Promise<{
+        resultText: string;
+    }>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=translation.service.d.ts.map

package/dist/services/translation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.service.d.ts","sourceRoot":"","sources":["../../src/services/translation.service.ts"],"names":[],"mappings":"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"}