agl 1.0.17 → 21.0.2

package/dist_ts/classes.opencodeclient.d.ts

@@ -0,0 +1,146 @@
+import type { IControllerMessage, TControllerModelChoice, TControllerModelOption, IControllerPermission, IControllerQuestion, IControllerRuntimeId, IControllerSession, IControllerSessionDetail, IControllerSessionMetrics, IControllerSessionReversionInfo, IControllerTodo, IControllerToolExecution, TControllerBuiltinCommand, TControllerPermissionReply, TControllerSessionStatus } from '../dist_ts_interfaces/index.js';
+import type { IOpenCodeClientOptions, IOpenCodeEventStreamOptions, IOpenCodeMessagePage, IOpenCodeNormalizedMessageBundle } from './interfaces.opencode.js';
+import type { IFlexOpenCodeOAuthAuth } from './interfaces.flexipc.js';
+interface ISessionIntelligenceMarker {
+    controllerId: string;
+    projectId: string;
+    sourceSessionId: IControllerRuntimeId;
+    exchangeId: string;
+}
+export declare class OpenCodeSessionIntelligenceCleanupError extends AggregateError {
+    readonly temporarySessionId: string;
+    constructor(temporarySessionIdArg: string, isolationErrorArg: Error, cleanupErrorArg: unknown);
+}
+export declare const createBoundedOpenCodeFetch: (expectedBaseUrlArg: string, fetchImplementationArg?: typeof globalThis.fetch, acquireRuntimeLeaseArg?: () => () => void) => typeof globalThis.fetch;
+export declare const normalizeOpenCodeSession: (value: unknown, directory: string, status?: TControllerSessionStatus) => IControllerSession;
+export declare const normalizeOpenCodeMessageBundles: (value: unknown, expectedSessionIdArg?: string) => IOpenCodeNormalizedMessageBundle[];
+export declare const normalizeOpenCodeMessages: (value: unknown, expectedSessionIdArg?: string) => IControllerMessage[];
+export declare const mergeOpenCodeToolExecutionsIntoDetail: <TDetail extends {
+    messages: IControllerMessage[];
+}>(detailArg: TDetail, executionsArg: readonly IControllerToolExecution[]) => Omit<TDetail, "messages"> & {
+    messages: IControllerMessage[];
+};
+export declare const createBoundedOpenCodeSelectedMessageSlice: (messagesArg: readonly IControllerMessage[]) => IControllerMessage[];
+export declare const normalizeOpenCodePermissions: (value: unknown) => IControllerPermission[];
+export declare const normalizeOpenCodeQuestions: (value: unknown) => IControllerQuestion[];
+export interface IPtyConnectionCallbacks {
+    onData: (chunk: Buffer) => void;
+    onMeta?: (cursor: number) => void;
+    onClose: () => void;
+}
+export interface IPtyConnectionHandle {
+    sendInput: (data: string) => void;
+    close: () => void;
+}
+interface IOpenCodePty {
+    /** OpenCode-native PTY ID; this is not a controller terminal ID. */
+    id: string;
+    title: string;
+    command: string;
+    cwd: string;
+}
+export declare const normalizeOpenCodePtys: (value: unknown) => IOpenCodePty[];
+export declare const normalizeOpenCodeTodos: (value: unknown) => IControllerTodo[];
+export declare class OpenCodeClientAdapter {
+    readonly directory: string;
+    readonly baseUrl: string;
+    private readonly client;
+    private readonly controlClient;
+    private readonly authorization;
+    private eventAbortController?;
+    private eventTask?;
+    private readonly temporarySessionIds;
+    private readonly sessionMetricsCache;
+    private readonly liveMessagePartCache;
+    private liveMessagePartCacheBytes;
+    constructor(options: IOpenCodeClientOptions);
+    private requireDirectory;
+    getStatuses(directoryArg: string, signal?: AbortSignal): Promise<Record<string, TControllerSessionStatus>>;
+    listSessions(directoryArg: string, signal?: AbortSignal): Promise<IControllerSession[]>;
+    getSessionReversionInfo(directoryArg: string, sessionIdArg: string, signal?: AbortSignal): Promise<IControllerSessionReversionInfo>;
+    getSession(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<IControllerSession>;
+    getSessionSnapshot(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<IControllerSession>;
+    getSessionIfPresent(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<IControllerSession | undefined>;
+    updateSession(directoryArg: string, sessionId: string, patch: {
+        title?: string;
+        archivedAt?: number;
+    }, signal?: AbortSignal): Promise<IControllerSession>;
+    createSession(directoryArg: string, title?: string, signal?: AbortSignal): Promise<IControllerSession>;
+    deleteSession(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<boolean>;
+    deleteSessionIfPresent(directoryArg: string, sessionIdArg: string, signal?: AbortSignal): Promise<void>;
+    sendMessage(directoryArg: string, sessionId: string, text: string, model?: TControllerModelChoice, agent?: string, signal?: AbortSignal, messageIdArg?: string): Promise<void>;
+    sendMessageAndWait(directoryArg: string, sessionId: string, text: string, signal?: AbortSignal): Promise<void>;
+    sendHarnessControlMessageAndWait(directoryArg: string, sessionId: string, text: string, signal?: AbortSignal, timeoutMsArg?: number): Promise<void>;
+    sendHarnessControlMessage(directoryArg: string, sessionId: string, text: string, signal?: AbortSignal): Promise<void>;
+    abortSession(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<boolean>;
+    setOpenCodeOAuthAuth(authArg: IFlexOpenCodeOAuthAuth, signal?: AbortSignal): Promise<void>;
+    listMessages(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<IControllerMessage[]>;
+    private readRawMessagePage;
+    listMessagePage(directoryArg: string, sessionId: string, options: {
+        limit: number;
+        before?: string;
+    }, signal?: AbortSignal): Promise<IOpenCodeMessagePage>;
+    getSessionMetrics(directoryArg: string, sessionIdArg: string, signal?: AbortSignal): Promise<IControllerSessionMetrics>;
+    private sessionMetricsCacheKey;
+    private calculateSessionMetrics;
+    buildSessionIntelligenceTranscript(directoryArg: string, sessionIdArg: string, signal?: AbortSignal): Promise<string>;
+    getMessageBundle(directoryArg: string, sessionId: string, messageId: string, signal?: AbortSignal): Promise<IOpenCodeNormalizedMessageBundle>;
+    runBuiltinSessionCommand(directoryArg: string, sessionId: string, command: TControllerBuiltinCommand, model?: TControllerModelChoice, signal?: AbortSignal): Promise<void>;
+    listPermissions(directoryArg: string, sessionId?: string, signal?: AbortSignal): Promise<IControllerPermission[]>;
+    listQuestions(directoryArg: string, sessionId?: string, signal?: AbortSignal): Promise<IControllerQuestion[]>;
+    replyQuestion(directoryArg: string, requestId: string, answers: string[][], signal?: AbortSignal): Promise<boolean>;
+    rejectQuestion(directoryArg: string, requestId: string, signal?: AbortSignal): Promise<boolean>;
+    replyPermission(directoryArg: string, requestId: string, reply: TControllerPermissionReply, message?: string, signal?: AbortSignal): Promise<boolean>;
+    listPtys(directoryArg: string, signal?: AbortSignal): Promise<IOpenCodePty[]>;
+    createPty(directoryArg: string, title?: string, signal?: AbortSignal): Promise<IOpenCodePty>;
+    updatePty(directoryArg: string, ptyId: string, patch: {
+        title?: string;
+        size?: {
+            rows: number;
+            cols: number;
+        };
+    }, signal?: AbortSignal): Promise<IOpenCodePty>;
+    removePty(directoryArg: string, ptyId: string, signal?: AbortSignal): Promise<boolean>;
+    /**
+     * Opens the PTY relay socket. The ticket flow mirrors the official web
+     * client: mint a short-lived single-use ticket, then upgrade without Basic
+     * auth. cursor 0 requests a full scrollback replay.
+     */
+    connectPty(directoryArg: string, ptyId: string, cursor: number, callbacks: IPtyConnectionCallbacks): Promise<IPtyConnectionHandle>;
+    listTodos(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<IControllerTodo[]>;
+    listCommands(directoryArg: string, signal?: AbortSignal): Promise<Array<{
+        name: string;
+        description?: string;
+        template: string;
+        agent?: string;
+        model?: string;
+    }>>;
+    getSessionIntelligenceCapability(directoryArg: string, signal?: AbortSignal): Promise<{
+        enabled: boolean;
+        model?: string;
+        contextTokens?: number;
+    }>;
+    createSessionIntelligenceSession(directoryArg: string, markerArg: ISessionIntelligenceMarker, signal?: AbortSignal): Promise<string>;
+    runSessionIntelligence(directoryArg: string, temporarySessionIdArg: string, promptArg: string, signal?: AbortSignal): Promise<{
+        answer: string;
+        scratchpad: string;
+        model: string;
+    }>;
+    deleteSessionIntelligenceSession(directoryArg: string, temporarySessionIdArg: string, signal?: AbortSignal): Promise<void>;
+    rememberSessionIntelligenceTemporarySessionIds(sessionIdsArg: string[]): void;
+    getRememberedSessionIntelligenceTemporarySessionIds(): string[];
+    cleanupOrphanedSessionIntelligenceSessions(directoryArg: string, controllerIdArg: string, olderThanArg: number, signal?: AbortSignal): Promise<number>;
+    private rememberTemporarySessionId;
+    listModelOptions(signal?: AbortSignal): Promise<TControllerModelOption[]>;
+    getSessionDetail(directoryArg: string, sessionId: string, signal?: AbortSignal): Promise<Omit<IControllerSessionDetail, 'scratchpad' | 'intelligenceExchanges' | 'pendingPrompts' | 'toolStreamCursor' | 'messageStreamCursor'>>;
+    startEventStream(options: IOpenCodeEventStreamOptions): Promise<void>;
+    stopEventStream(): Promise<void>;
+    private liveMessagePartKey;
+    private clearLiveMessagePartCache;
+    private clearLiveMessagePartsForSession;
+    private clearLiveMessagePartsForMessage;
+    private projectLiveMessageUpdate;
+    private normalizeLiveMessageStreamEvent;
+    private consumeEventStream;
+}
+export {};