@junctionpanel/server 0.1.16

package/dist/server/server/session.d.ts

@@ -0,0 +1,280 @@
+import { type SessionInboundMessage, type SessionOutboundMessage } from './messages.js';
+import type { TerminalManager } from '../terminal/terminal-manager.js';
+import { type BinaryMuxFrame } from '../shared/binary-mux.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+export type AgentMcpTransportFactory = () => Promise<Transport>;
+import type { AgentProviderRuntimeSettingsMap } from './agent/provider-launch-config.js';
+import { AgentManager } from './agent/agent-manager.js';
+import { AgentStorage } from './agent/agent-storage.js';
+import { DownloadTokenStore } from './file-download/token-store.js';
+import type pino from 'pino';
+export type SessionOptions = {
+    clientId: string;
+    userId?: string;
+    onMessage: (msg: SessionOutboundMessage) => void;
+    onBinaryMessage?: (frame: BinaryMuxFrame) => void;
+    onLifecycleIntent?: (intent: SessionLifecycleIntent) => void;
+    logger: pino.Logger;
+    downloadTokenStore: DownloadTokenStore;
+    junctionHome: string;
+    agentManager: AgentManager;
+    agentStorage: AgentStorage;
+    createAgentMcpTransport: AgentMcpTransportFactory;
+    terminalManager: TerminalManager | null;
+    agentProviderRuntimeSettings?: AgentProviderRuntimeSettingsMap;
+};
+export type SessionLifecycleIntent = {
+    type: 'shutdown';
+    clientId: string;
+    requestId: string;
+} | {
+    type: 'restart';
+    clientId: string;
+    requestId: string;
+    reason?: string;
+};
+/**
+ * Session represents a single connected client session.
+ * It owns all state management, orchestration logic, and message processing.
+ * Session has no knowledge of WebSockets - it only emits and receives messages.
+ */
+export declare class Session {
+    private readonly clientId;
+    readonly userId: string | undefined;
+    private readonly sessionId;
+    private readonly onMessage;
+    private readonly onBinaryMessage;
+    private readonly onLifecycleIntent;
+    private readonly sessionLogger;
+    private readonly junctionHome;
+    private abortController;
+    private agentMcpClient;
+    private agentTools;
+    private agentManager;
+    private readonly agentStorage;
+    private readonly createAgentMcpTransport;
+    private readonly downloadTokenStore;
+    private readonly providerRegistry;
+    private unsubscribeAgentEvents;
+    private agentUpdatesSubscription;
+    private clientActivity;
+    private readonly MOBILE_BACKGROUND_STREAM_GRACE_MS;
+    private readonly terminalManager;
+    private readonly subscribedTerminalDirectories;
+    private unsubscribeTerminalsChanged;
+    private terminalSubscriptions;
+    private terminalExitSubscriptions;
+    private readonly terminalStreams;
+    private readonly terminalStreamByTerminalId;
+    private nextTerminalStreamId;
+    private readonly checkoutDiffSubscriptions;
+    private readonly checkoutDiffTargets;
+    private readonly agentProviderRuntimeSettings;
+    constructor(options: SessionOptions);
+    /**
+     * Get the client's current activity state
+     */
+    getClientActivity(): {
+        deviceType: 'web' | 'mobile';
+        focusedAgentId: string | null;
+        lastActivityAt: Date;
+        appVisible: boolean;
+        appVisibilityChangedAt: Date;
+    } | null;
+    /**
+     * Send initial state to client after connection
+     */
+    sendInitialState(): Promise<void>;
+    /**
+     * Normalize a user prompt (with optional image metadata) for AgentManager
+     */
+    private buildAgentPrompt;
+    /**
+     * Interrupt the agent's active run so the next prompt starts a fresh turn.
+     * Returns once the manager confirms the stream has been cancelled.
+     */
+    private interruptAgentIfRunning;
+    /**
+     * Start streaming an agent run and forward results via the websocket broadcast
+     */
+    private startAgentStream;
+    private handleAgentRunError;
+    /**
+     * Initialize Agent MCP client for this session using in-memory transport
+     */
+    private initializeAgentMcp;
+    /**
+     * Subscribe to AgentManager events and forward them to the client
+     */
+    private subscribeToAgentEvents;
+    private buildAgentPayload;
+    private buildStoredAgentPayload;
+    private ensureAgentLoaded;
+    private matchesAgentFilter;
+    private getAgentUpdateTargetId;
+    private bufferOrEmitAgentUpdate;
+    private flushBootstrappedAgentUpdates;
+    private buildFallbackProjectCheckout;
+    private toProjectCheckoutLite;
+    private buildProjectPlacement;
+    private forwardAgentUpdate;
+    /**
+     * Main entry point for processing session messages
+     */
+    handleMessage(msg: SessionInboundMessage): Promise<void>;
+    handleBinaryFrame(frame: BinaryMuxFrame): void;
+    private handleTerminalBinaryFrame;
+    private handleRestartServerRequest;
+    private handleShutdownServerRequest;
+    private emitLifecycleIntent;
+    private handleDeleteAgentRequest;
+    private handleArchiveAgentRequest;
+    private getArchivedAt;
+    private handleUpdateAgentRequest;
+    /**
+     * Handle text message to agent (with optional image attachments)
+     */
+    private handleSendAgentMessage;
+    /**
+     * Handle create agent request
+     */
+    private handleCreateAgentRequest;
+    private handleResumeAgentRequest;
+    private handleRefreshAgentRequest;
+    private handleCancelAgentRequest;
+    private buildAgentSessionConfig;
+    private handleListProviderModelsRequest;
+    private handleListAvailableProvidersRequest;
+    private normalizeGitOptions;
+    private assertSafeGitRef;
+    private toCheckoutError;
+    private isPathWithinRoot;
+    private generateCommitMessage;
+    private generatePullRequestText;
+    /**
+     * Handle set agent mode request
+     */
+    private handleSetAgentModeRequest;
+    private handleSetAgentModelRequest;
+    private handleSetAgentThinkingRequest;
+    /**
+     * Handle clearing agent attention flag
+     */
+    private handleClearAgentAttention;
+    /**
+     * Handle client heartbeat for activity tracking
+     */
+    private handleClientHeartbeat;
+    /**
+     * Handle list commands request for an agent
+     */
+    private handleListCommandsRequest;
+    /**
+     * Handle agent permission response from user
+     */
+    private handleAgentPermissionResponse;
+    private handleCheckoutStatusRequest;
+    private handleValidateBranchRequest;
+    private handleBranchSuggestionsRequest;
+    private handleDirectorySuggestionsRequest;
+    private handleGitCloneRequest;
+    private handleGitInitRequest;
+    private normalizeCheckoutDiffCompare;
+    private buildCheckoutDiffTargetKey;
+    private closeCheckoutDiffWatchTarget;
+    private removeCheckoutDiffSubscription;
+    private resolveCheckoutGitDir;
+    private resolveCheckoutWatchRoot;
+    private scheduleCheckoutDiffTargetRefresh;
+    private emitCheckoutDiffUpdate;
+    private checkoutDiffSnapshotFingerprint;
+    private computeCheckoutDiffSnapshot;
+    private refreshCheckoutDiffTarget;
+    private ensureCheckoutDiffWatchTarget;
+    private handleSubscribeCheckoutDiffRequest;
+    private handleUnsubscribeCheckoutDiffRequest;
+    private scheduleCheckoutDiffRefreshForCwd;
+    private handleCheckoutCommitRequest;
+    private handleCheckoutMergeRequest;
+    private handleCheckoutMergeFromBaseRequest;
+    private handleCheckoutPushRequest;
+    private handleCheckoutPrCreateRequest;
+    private handleCheckoutPrStatusRequest;
+    private handleJunctionWorktreeListRequest;
+    private maybeArchiveWorktreeAfterLastAgentArchived;
+    private archiveJunctionWorktree;
+    private handleJunctionWorktreeArchiveRequest;
+    /**
+     * Handle read-only file explorer requests scoped to an agent's cwd
+     */
+    private handleFileExplorerRequest;
+    /**
+     * Handle read-only file explorer requests scoped to a workspace cwd
+     */
+    private handleWorkspaceFileExplorerRequest;
+    /**
+     * Handle project icon request for a given cwd
+     */
+    private handleProjectIconRequest;
+    /**
+     * Handle file download token request scoped to an agent's cwd
+     */
+    private handleFileDownloadTokenRequest;
+    /**
+     * Build the current agent list payload (live + persisted), optionally filtered by labels.
+     */
+    private listAgentPayloads;
+    private resolveAgentIdentifier;
+    private getAgentPayloadById;
+    private normalizeFetchAgentsSort;
+    private getStatusPriority;
+    private getFetchAgentsSortValue;
+    private getFetchAgentsSortValueFromAgent;
+    private compareSortValues;
+    private compareFetchAgentsAgents;
+    private encodeFetchAgentsCursor;
+    private decodeFetchAgentsCursor;
+    private compareAgentWithCursor;
+    private listFetchAgentsEntries;
+    private handleAbort;
+    private handleFetchAgents;
+    private handleFetchAgent;
+    private handleFetchAgentTimelineRequest;
+    private handleSendAgentMessageRequest;
+    private handleWaitForFinish;
+    /**
+     * Emit a message to the client
+     */
+    private emit;
+    private emitBinary;
+    /**
+     * Clean up session resources
+     */
+    cleanup(): Promise<void>;
+    private ensureTerminalExitSubscription;
+    private handleTerminalExited;
+    private emitTerminalsChangedSnapshot;
+    private handleTerminalsChanged;
+    private handleSubscribeTerminalsRequest;
+    private handleUnsubscribeTerminalsRequest;
+    private emitInitialTerminalsChangedSnapshot;
+    private handleListTerminalsRequest;
+    private handleCreateTerminalRequest;
+    private handleSubscribeTerminalRequest;
+    private handleUnsubscribeTerminalRequest;
+    private handleTerminalInput;
+    private killTrackedTerminal;
+    private killTerminalsUnderPath;
+    private handleKillTerminalRequest;
+    private handleAttachTerminalStreamRequest;
+    private getTerminalStreamChunkByteLength;
+    private canEmitTerminalStreamChunk;
+    private emitTerminalStreamChunk;
+    private enqueueOrEmitTerminalStreamChunk;
+    private flushPendingTerminalStreamChunks;
+    private handleDetachTerminalStreamRequest;
+    private detachAllTerminalStreams;
+    private detachTerminalStream;
+    private allocateTerminalStreamId;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/server/server/session.d.ts.map

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