@xopcai/xopc 0.0.82 → 0.0.84

package/dist/src/agent/service.d.ts

@@ -1,20 +1,24 @@
-import type { AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';
-import { type MessageBus } from '../infra/bus/index.js';
+import type { MessageBus } from '../infra/bus/index.js';
 import { type Config } from '../config/schema.js';
 import type { ChannelManager } from '../channels/manager.js';
-import type { SessionDetail, SessionMetadata } from '../session/types.js';
-import { type ReasoningLevel } from './transcript/thinking-types.js';
+import { SessionStore } from '../session/index.js';
+import { OutboundCoordinator } from './messaging/index.js';
+import { TurnDispatcher } from './inbound/turn-dispatcher.js';
+import { SessionConfigService, SessionHydrator, SessionInspector } from './session/index.js';
 import { type SkillCatalogEntry } from './agent-manager.js';
 import type { SkillMarkdownPreviewPayload } from './skills/types.js';
 import type { AgentServiceConfig, StreamHandle } from './service.types.js';
-import type { PersistentGoalApis } from './goals/persistent-goal-apis.js';
-import type { CompactionResult } from './memory/compaction.js';
+import { PersistentGoalService } from './goals/persistent-goal-service.js';
 export type { AgentServiceConfig, AgentContext, StreamHandle } from './service.types.js';
 export declare class AgentService {
-    private sessionStore;
+    /**
+     * Persistent transcript + session-metadata store. Public so the gateway/TUI
+     * can read sessions, delete them, etc. without forcing every CRUD-style
+     * operation through a delegation method on `AgentService`.
+     */
+    readonly sessionStore: SessionStore;
     private sessionConfigStore;
     private hookRunner?;
-    private running;
     private agentId;
     private workspaceDir;
     private channelManagerRef;
@@ -36,25 +40,59 @@ export declare class AgentService {
     private messageRouter;
     private commandHandler;
     private streamManager;
+    /**
+     * Outbound pipeline: typing controller, silence guard, final response publish,
+     * extension `message_sending`/`message_sent` hooks, post-turn `webchat_turn_complete`
+     * event. Public so the gateway / channels can drive it directly.
+     */
+    readonly outboundCoordinator: OutboundCoordinator;
+    private inboundLoop;
+    /**
+     * Direct-turn entry points: `processDirect` (one-shot), `processDirectStreaming`
+     * (SSE generator), webchat steering and SSE injection. Public so the gateway,
+     * TUI, CLI, and cron jobs do not need to thread every call through `AgentService`.
+     */
+    readonly turnDispatcher: TurnDispatcher;
+    /**
+     * `/goal` runtime: continuation scheduling, persistent-goal API factory,
+     * stream-outcome state, post-turn verdict. Public so the gateway can wire
+     * the webchat continuation scheduler and read stream outcomes directly.
+     */
+    readonly persistentGoals: PersistentGoalService;
+    /**
+     * Per-session config writes (model / thinking / reasoning / working directory).
+     * Public so REST endpoints and CLI flows can hit it without going through a
+     * monolithic patch entrypoint on `AgentService`.
+     */
+    readonly sessionConfig: SessionConfigService;
+    /**
+     * Hydration — read persisted per-session config and apply it to the runtime
+     * (AgentManager / ModelManager). The mirror image of `sessionConfig`: writes
+     * go through `sessionConfig`, reads-into-runtime go through `sessionHydrator`.
+     */
+    readonly sessionHydrator: SessionHydrator;
+    /**
+     * Read-only introspection (compaction, /context report, /btw, contextUsage,
+     * agentConfig view). Public so REST endpoints and CLI flows can query a
+     * session's view without going through delegating methods on `AgentService`.
+     */
+    readonly sessionInspector: SessionInspector;
     private sessionContextManager;
     private sessionLifecycleManager;
     private agentOrchestrator;
     private agentEventHandler;
     private feedbackCoordinator;
     private agentManager;
-    /** Webchat SSE queue pushers for `clarify_request` and similar mid-turn UI events. */
-    private webchatSseEnqueueBySession;
-    private embeddedStreamTextBySession;
-    private lastAssistantPlainTextBySession;
-    /** Gateway: drain `processDirectStreaming` for webchat continuations (Hermes FIFO-style). */
-    private persistentGoalWebchatContinuationScheduler?;
-    private directStreamOutcomeBySession;
-    /** Concurrent inbound / direct-stream turns per session (Hermes-style /goal mid-flight guard). */
-    private inboundTurnDepthBySession;
+    /**
+     * Unified per-session state container (replaces six ad-hoc Maps). Owns webchat
+     * publishers, last assistant text, embedded stream buffer, persistent-goal stream
+     * outcomes, concurrent-turn depth, and event-listener unsubscribers; runs a TTL
+     * sweep for slots that have no explicit owner.
+     */
+    private sessionState;
     /** Gateway: notify UI after direct `SessionStore.updateMetadata` (no SessionManager emit). */
     private onSessionMetadataUpdated?;
     private onSessionTranscriptUpdated?;
-    private sessionUnsubscribers;
     private effectiveAppConfig;
     constructor(bus: MessageBus, config: AgentServiceConfig);
     private attachmentRootsForSession;
@@ -74,53 +112,18 @@ export declare class AgentService {
     refreshSkillsAfterSkillConfigChange(): void;
     getModelForSession(sessionKey: string): string;
     switchModelForSession(sessionKey: string, modelId: string): Promise<boolean>;
-    private clearSessionModelOverride;
     /**
      * Clears per-session model override so the next turn uses the configured agent default
      * (e.g. cron isolated job with no explicit model).
      */
     resetSessionModelToAgentDefault(sessionKey: string): Promise<void>;
-    private hydrateSessionModelFromStore;
     setStreamHandle(handle: StreamHandle): void;
     clearStreamHandle(): void;
     /** Last assistant visible plain text for a session (e.g. after a webchat stream). */
     getLastAssistantPlainText(sessionKey: string): string;
-    /** Gateway only: webchat continuations bypass the bus and reuse `runGatewayAgent`. */
-    setPersistentGoalWebchatContinuationScheduler(fn: ((sessionKey: string, message: string) => void) | undefined): void;
     beginInboundTurn(sessionKey: string): void;
     endInboundTurn(sessionKey: string): void;
     getInboundTurnDepth(sessionKey: string): number;
-    schedulePersistentGoalContinuation(sessionKey: string, message: string, routing: {
-        channel: string;
-        chatId: string;
-        inboundMetadata?: Record<string, unknown>;
-    }): void;
-    getPersistentGoalApisForCommand(routing: {
-        sessionKey: string;
-        channel: string;
-        chatId: string;
-        inboundMetadata?: Record<string, unknown>;
-    }): PersistentGoalApis;
-    recordPersistentGoalStreamOutcome(sessionKey: string, outcome: {
-        skipPersistentGoalPostTurn: boolean;
-    }): void;
-    takePersistentGoalStreamOutcome(sessionKey: string): {
-        skipPersistentGoalPostTurn: boolean;
-    } | undefined;
-    /**
-     * After any assistant-visible turn (webchat direct stream or bus-driven channels): extension hook + built-in `/goal` post-turn.
-     */
-    emitSessionTurnComplete(payload: {
-        sessionKey: string;
-        channel: string;
-        chatId: string;
-        inboundUserText: string;
-        assistantPlainText: string;
-        aborted: boolean;
-        streamError?: string;
-        skipPersistentGoalPostTurn?: boolean;
-        outboundMetadata?: Record<string, unknown>;
-    }): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
     /**
@@ -161,128 +164,28 @@ export declare class AgentService {
         workspaceRelativePath?: string;
     }> | undefined>;
     private endDirectRequestContext;
-    /** Full session snapshot (metadata + API-shaped messages), e.g. embedded TUI history. */
-    loadSessionDetail(sessionKey: string): Promise<SessionDetail | null>;
-    /** Session list for TUI picker (embedded / local). */
-    listSessionsForUi(limit?: number): Promise<SessionMetadata[]>;
-    deleteSessionKey(key: string): Promise<boolean>;
-    renameSessionKey(key: string, name: string): Promise<void>;
+    /**
+     * Reset a session's transcript and drop the in-memory agent so the next turn
+     * reloads from disk. Combines two collaborators (sessionStore + agentManager)
+     * so it stays on `AgentService`; pure sessionStore reads should use
+     * `agentService.sessionStore.*` directly.
+     */
     clearSessionMessages(key: string): Promise<void>;
-    compactSession(sessionKey: string, options?: {
-        instructions?: string;
-        force?: boolean;
-    }): Promise<CompactionResult>;
     /**
      * Drop in-memory agent so the next turn reloads transcript from disk (e.g. after checkpoint restore).
      */
     evictSessionAgent(sessionKey: string): void;
-    /**
-     * One-shot LLM answer for /btw: uses transcript as background only; does not persist to session.
-     */
-    btwQuery(sessionKey: string, question: string): Promise<{
-        text: string;
-        error?: string;
-    }>;
-    /** Markdown or JSON summary for /context (prompt assembly is approximated from config + transcript stats). */
-    getSessionContextReport(sessionKey: string, mode: 'list' | 'detail' | 'json'): Promise<string>;
-    getSessionStats(sessionKey: string, messages: AgentMessage[]): {
-        windowStats: {
-            total: number;
-            system: number;
-            user: number;
-            assistant: number;
-            tool: number;
-            needsTrim: boolean;
-        };
-        compactionStats: Promise<{
-            compactionCount: number;
-            totalTokensBefore: number;
-            totalTokensAfter: number;
-            lastCompactionAt: any;
-        }>;
-        tokenEstimate: Promise<number>;
-    };
-    /** Rough context usage for TUI footer (estimated tokens vs nominal budget). */
-    getSessionContextUsage(sessionKey: string): Promise<{
-        estimatedTokens: number;
-        contextWindow: number;
-        usagePercent: number | null;
-    }>;
-    private applyResolvedThinkingLevel;
-    /** Resolved thinking level and effective model ref for a session (Web UI). */
-    getSessionAgentConfig(sessionKey: string): Promise<{
-        thinkingLevel: ThinkingLevel;
-        model: string;
-        reasoningLevel: ReasoningLevel;
-        effectiveWorkspacePath: string;
-        workingDirectoryLocked: boolean;
-    }>;
     /**
      * Load session working directory override into AgentManager, ensure directory exists.
      * Call before AgentManager.getOrCreateAgent for this session.
      */
-    hydrateSessionWorkspaceFromStore(sessionKey: string): Promise<void>;
-    /**
-     * Sync persisted session workspace override for an isolated cron run (runs may change when the job is edited).
-     * Omit or pass empty `workingDirectory` to use the effective agent default workspace for this session key.
-     */
-    applyCronJobWorkingDirectory(sessionKey: string, workingDirectory: string | undefined): Promise<void>;
-    private clearCronSessionWorkingDirectoryOverride;
     /** Workspace root for UI file tree / editor (same as agent tools after hydration). */
     getEffectiveWorkspacePathForSession(sessionKey: string): Promise<string>;
-    patchSessionAgentConfig(sessionKey: string, partial: {
-        thinkingLevel?: string;
-        model?: string | null;
-        reasoningLevel?: string;
-        workingDirectory?: string;
-    }): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    processDirectStreaming(content: string, sessionKey?: string, attachments?: Array<{
-        type: string;
-        mimeType?: string;
-        data?: string;
-        name?: string;
-        size?: number;
-        workspaceRelativePath?: string;
-    }>, thinking?: string, options?: {
-        signal?: AbortSignal;
-    }): AsyncGenerator<{
-        type: string;
-        [key: string]: unknown;
-    }, void, unknown>;
     /**
      * Best-effort timezone resolution for webchat envelope timestamps.
      * Reads `USER.md` under the agent `profile/` directory and extracts a `Timezone:` line.
      */
     resolveUserTimezoneForSession(sessionKey: string): string | undefined;
-    private createProcessDirectStreamingDeps;
-    /**
-     * Inject an SSE event into an in-flight webchat stream (same queue as tokens/tools).
-     */
-    enqueueWebchatSseEvent(sessionKey: string, event: {
-        type: string;
-        [key: string]: unknown;
-    }): void;
-    /** Push assistant text to an in-flight webchat stream and notify gateway listeners. */
-    notifyWebchatTranscriptAppend(sessionKey: string, assistantText: string): void;
-    /**
-     * Queue a steering user message into pi-agent's in-flight run (delivered after current tool work, before the next LLM call).
-     * See `Agent.steer` in `@earendil-works/pi-agent-core`.
-     */
-    steerWebchatSession(sessionKey: string, text: string): Promise<boolean>;
-    private createRunProcessDirectDeps;
-    processDirect(content: string, sessionKey?: string, attachments?: Array<{
-        type: string;
-        mimeType?: string;
-        data?: string;
-        name?: string;
-        size?: number;
-        workspaceRelativePath?: string;
-    }>, thinking?: string): Promise<string>;
-    private handleInboundMessage;
-    private handleSystemMessage;
     /**
      * Setup event handling for a specific session
      */
@@ -293,13 +196,5 @@ export declare class AgentService {
     private handleSessionEvent;
     private checkAndCompact;
     private getContextWindow;
-    private sendFinalResponse;
-    /** Extension hooks for ChannelManager outbound pipeline (Gateway). */
-    invokeOutboundMessageSending(to: string, content: string, channel: string): Promise<{
-        send: boolean;
-        content?: string;
-        reason?: string;
-    }>;
-    invokeOutboundMessageSent(to: string, content: string, success: boolean, error: string | undefined, channel: string): Promise<void>;
     private dispose;
 }