@borgee/agents-host 0.2.97 → 0.2.110

package/dist/providers/normalized/adapter.d.ts

@@ -0,0 +1,107 @@
+import { type SessionDirectoryRequest, type SessionDirectoryResult, type SessionObservationRequest, type SessionObservationResult, type ServerRequestContext } from '../../plugin-sdk.js';
+import { type SessionControlRequest } from '../../plugin-sdk.js';
+import type { AgentInteractionResponse, AgentProviderAdapter, AgentSession } from '../../native-providers.js';
+import type { PreparedPromptContext, PreparedProviderTurnInput, ProviderGenerateOptions, ProviderInput, ProviderReply } from '../../types.js';
+import { type ProviderAdapter, type ProviderSessionControlContext, type ProviderSessionControlResult } from '../provider-adapter.js';
+import { type HostSessionManagementOptions } from './session-management.js';
+interface SessionStore {
+    load(agentId: string): Promise<Record<string, string>>;
+    save(agentId: string, sessions: Record<string, string>): Promise<void>;
+}
+export interface NormalizedProviderOptions {
+    provider: AgentProviderAdapter;
+    prepare(input: ProviderInput): Promise<PreparedProviderTurnInput>;
+    prepareSession?(channelId: string): Promise<PreparedPromptContext | undefined>;
+    resolveAgentId(): string | undefined;
+    serverUrl: string;
+    store: SessionStore;
+    configureSession(session: AgentSession): Promise<void>;
+    sessionManagement?: Omit<HostSessionManagementOptions, 'provider' | 'find' | 'register' | 'resolveAgentId' | 'serverUrl'>;
+}
+/** Owns Host binding and business replies; native event interpretation stays in providers. */
+export declare class NormalizedProviderAdapter implements ProviderAdapter {
+    private readonly options;
+    readonly outputMode: "normalized";
+    readonly capabilities: import("../provider-adapter.js").ProviderCapabilities;
+    private readonly bindings;
+    private readonly bindingRecords;
+    private readonly relationPasses;
+    private readonly deferredRelations;
+    private readonly busy;
+    private readonly stores;
+    private saving;
+    private defaultAdmission;
+    private disposed;
+    private readonly management?;
+    constructor(options: NormalizedProviderOptions);
+    private hasIndependentOwner;
+    private get supportsDefaultOpening();
+    get supportsSessionManagement(): boolean;
+    describeSessionManagement(): Promise<import('../../plugin-sdk.js').SessionManagementAvailability>;
+    manageSession(request: import('../../plugin-sdk.js').SessionManagementRequest, context: ServerRequestContext): Promise<unknown>;
+    private openDefaultSession;
+    private registerIndependentSession;
+    get sessionInputOperations(): readonly ('start_turn' | 'steer' | 'next_turn')[];
+    get supportsSessionInput(): boolean;
+    private sessionPublication?;
+    setSessionPublication(publication: Parameters<NonNullable<ProviderAdapter['setSessionPublication']>>[0]): void;
+    publishSessionBindings(): void;
+    private publishAvailability;
+    private setAvailability;
+    private visibleRuntime;
+    private publishBinding;
+    private publishActivity;
+    private publisher;
+    private publishPreTurnError;
+    private publishTimeline;
+    listSessions(request: SessionDirectoryRequest, context: ServerRequestContext): SessionDirectoryResult;
+    describeSession(request: import('../../plugin-sdk.js').SessionDescriptionRequest, context: ServerRequestContext): import('../../plugin-sdk.js').SessionControlTarget | undefined;
+    observeSession(request: SessionObservationRequest, context: ServerRequestContext): Promise<SessionObservationResult>;
+    generateReply(input: ProviderInput, options?: ProviderGenerateOptions): Promise<ProviderReply>;
+    private bindingCurrent;
+    private controlBinding;
+    controlSession(request: SessionControlRequest, context: ProviderSessionControlContext): Promise<ProviderSessionControlResult>;
+    private registerInput;
+    private confirmInput;
+    private releaseExecution;
+    private reconcileAssociationMetadata;
+    private applyAssociation;
+    private observeOwned;
+    private processOwnedObservation;
+    private sendInput;
+    private finishLocalCommand;
+    private persistConfirmedBinding;
+    private withDefaultAdmission;
+    private bindingFor;
+    private bindingForDefault;
+    private admitChildren;
+    private adoptKnownChildren;
+    private observeSessionState;
+    private selectBinding;
+    private observe;
+    private queueObservation;
+    private drainObservations;
+    private processObservation;
+    private bindingCapabilities;
+    private retireInteractions;
+    private observeNativeTurn;
+    private restoreSession;
+    private observeEvent;
+    respondInteraction(input: {
+        channelId: string;
+        taskId?: string;
+        agentId: string;
+        requestId: string;
+        response: AgentInteractionResponse;
+        binding?: Pick<SessionControlRequest, 'binding_id' | 'native_session_id' | 'connection_generation'>;
+    }, context?: import('../../plugin-sdk.js').ServerRequestContext): Promise<AgentInteractionResponse>;
+    /** Capture and publication share the observation loop's synchronous ordering. */
+    syncNormalizedActivity(channelId: string, bindingId?: string): boolean;
+    cancelTurn(channelId: string, target?: Pick<SessionControlRequest, 'binding_id' | 'native_session_id' | 'connection_generation'>, context?: import('../../plugin-sdk.js').ServerRequestContext): Promise<boolean>;
+    interruptTurn(channelId: string): Promise<boolean>;
+    cancelSession(channelId: string): Promise<boolean>;
+    private closeBinding;
+    private disposeBinding;
+    dispose(): Promise<void>;
+}
+export {};