@canonmsg/agent-sdk 11.2.1 → 12.1.0

package/dist/attached-session.d.ts

@@ -1,58 +0,0 @@
-import { CanonClient, CanonStream, type AttachedNativeSessionAdapter, type AttachedSessionBinding, type AttachedSessionPublisher, type AttachedSessionState, type AttachedSessionStore, type ResolvedAgent, type RuntimeStatePublisher } from '@canonmsg/core';
-export type CanonAttachedSessionConnection = Pick<ResolvedAgent, 'apiKey' | 'environmentId' | 'baseUrl' | 'streamUrl' | 'rtdbUrl' | 'firebaseApiKey' | 'clientType'> & {
-    agentId: string;
-};
-export interface CanonAttachedSessionStatus {
-    status: 'connecting' | 'connected' | 'disconnected' | 'native' | 'accepted' | 'blocked' | 'stopped';
-    reason?: string;
-    messageId?: string;
-    nativeState?: AttachedSessionState;
-    /** REST history is an observation, not fresh permission to execute. */
-    pendingMessageIds?: string[];
-}
-export interface CanonAttachedSessionOptions {
-    connection: CanonAttachedSessionConnection;
-    binding: AttachedSessionBinding;
-    native: AttachedNativeSessionAdapter;
-    /** Exclusive durable store; the Core attachment closes it on stop/failure. */
-    store: AttachedSessionStore;
-    reconcileIntervalMs?: number;
-    onStatus?: (status: CanonAttachedSessionStatus) => void;
-    onError?: (error: unknown, operation: string) => void;
-    /** An account coordinator may supply its authenticated transport for several rooms. */
-    transport?: CanonAttachedSessionTransport;
-}
-export type CanonAttachedSessionStreamHandler = ConstructorParameters<typeof CanonStream>[0]['handler'];
-/** Account resources stay with the coordinator; an individual room never closes them. */
-export interface CanonAttachedSessionTransport {
-    agentId: string;
-    environmentId: string;
-    client: CanonClient;
-    publisher: RuntimeStatePublisher;
-    subscribe(handler: CanonAttachedSessionStreamHandler): () => void;
-    hasPendingInteraction?(conversationId: string): boolean;
-    /** A prepared observer can wait for its owner's durable setup acknowledgement. */
-    isRouteActive?(conversationId: string): boolean;
-}
-export interface CanonAttachedSession {
-    /** Resolves after native attachment and Canon transport startup, not stream termination. */
-    start(): Promise<void>;
-    /** Terminal: closes this attachment; the native session keeps running. */
-    stop(): Promise<void>;
-    getState(): AttachedSessionState;
-    /** Republish an external native interaction's waiting state. */
-    refreshRuntimeState(): void;
-}
-/**
- * Connect one existing native session to one existing Canon conversation.
- * This is account-level participation, not a second group member. The caller
- * must hold exclusive account and native-session ownership so no competing
- * runtime writes this account's live state or republishes the native thread.
- */
-export declare function createCanonAttachedSession(options: CanonAttachedSessionOptions): CanonAttachedSession;
-/**
- * Observed native turns may combine local and Canon input. They are proactive
- * agent transcript publications, never replies authorized by a particular
- * Canon input. Core persists these immutable parts before calling send.
- */
-export declare function createCanonAttachedSessionPublisher(client: Pick<CanonClient, 'sendProactiveMessage'>, binding: AttachedSessionBinding): AttachedSessionPublisher;