@xopcai/xopc 0.0.82 → 0.0.83

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

@@ -3,16 +3,11 @@ import { CronService } from '../cron/index.js';
 import { ExtensionLoader } from '../extensions/index.js';
 import { SessionIndex } from '../session/index.js';
 import type { Config } from '../config/schema.js';
-import type { SessionListQuery, ExportFormat } from '../session/types.js';
-import type { SessionPatchBody } from '../session/patch-metadata.js';
-import type { CompactionResult } from '../agent/memory/compaction.js';
 import { type ResolvedGatewayAuth } from './auth.js';
 import { AgentRunRelay } from './agent-run-relay.js';
-import { type MarketplaceCategoryOption, type SkillsStoreListParams, type UnifiedMarketplaceListResponse, type UnifiedMarketplacePackageDetail } from '../agent/skills/skills-marketplace.js';
-import { type MarketplacePackageDetail } from '../agent/skills/marketplace/adapters/store/store-api-client.js';
-import type { SkillCatalogEntry } from '../agent/agent-manager.js';
-import type { SkillMarkdownPreviewPayload } from '../agent/skills/types.js';
-import type { ManagedSkillListItem } from '../agent/skills/managed-store.js';
+import { GatewaySessionsApi } from './service/sessions-api.js';
+import { GatewayMarketplaceService } from './service/marketplace-service.js';
+import { GatewayAgentRunner } from './service/agent-runner.js';
 import type { GatewayServiceConfig, ServiceEvent } from './service/types.js';
 import { type GatewayReadinessSnapshot } from './startup-readiness.js';
 export type { GatewayChannelStartupPhase1Metrics, GatewayChannelStartupPhase2Metrics, GatewayServiceConfig, ServiceEvent, } from './service/types.js';
@@ -33,17 +28,11 @@ export declare class GatewayService {
     private heartbeatService;
     private sessionIndex;
     private running;
-    private configReloader;
-    /** In-flight coalesced apply after PATCH/save (Telegram `getMe` must not block HTTP). */
-    private channelReloadFlushPromise;
-    private channelReloadPending;
     private startTime;
     private workspacePath;
+    private readonly configCoordinator;
     private auth;
     private readonly sse;
-    readonly runRelay: AgentRunRelay;
-    /** Per-run abort for webchat (POST /api/agent/abort or client disconnect). */
-    private runAbortControllers;
     private stopGatewayUpdateCheck;
     /** When set (e.g. by `GatewayServer`), `triggerGatewayProcessRestart` can stop HTTP then exit. */
     private gatewayShutdownForRestart;
@@ -53,16 +42,35 @@ export declare class GatewayService {
     private lastChannelConnectDeferSource;
     private readonly readiness;
     private startupTrace;
-    private readonly clarifyBridge;
-    /** Maps webchat session key → active `runId` for `clarify` tool routing. */
-    private activeWebchatRunBySession;
+    /**
+     * Webchat agent invocation surface (`runAgent`, `abortAgentRun`, `steer*`,
+     * `submitClarifyResponse`, clarify-bridge dispatch). Owns the
+     * `activeWebchatRunBySession` + `runAbortControllers` maps.
+     */
+    readonly agentRunner: GatewayAgentRunner;
+    /** Read-only alias re-exported from `agentRunner.runRelay` for legacy callers. */
+    get runRelay(): AgentRunRelay;
+    /**
+     * Session CRUD / search / compaction / tag-archive-pin / stats — the gateway
+     * REST surface for sessions. Routes should depend on this narrow service
+     * rather than the full GatewayService composition root.
+     */
+    readonly sessions: GatewaySessionsApi;
+    /**
+     * Skills + extensions marketplace surface (browse / install / uninstall) plus
+     * local-only managed-skill ops. Routes depend on this narrow service.
+     */
+    readonly marketplace: GatewayMarketplaceService;
     constructor(serviceConfig?: GatewayServiceConfig);
     /** Lazy AgentService — constructed on first use or during `start()`. */
     get agentService(): AgentService;
     private ensureAgentService;
     private ensureHeartbeatService;
-    /** Hermes-style: after HTTP sets a goal, enqueue the goal text as the next user turn. */
     enqueueWebchatPersistentGoalKickoff(sessionKey: string, goalText: string): void;
+    runAgent(...args: Parameters<GatewayAgentRunner['runAgent']>): ReturnType<GatewayAgentRunner['runAgent']>;
+    abortAgentRun(runId: string): boolean;
+    steerWebchatAgent(chatId: string, message: string): ReturnType<GatewayAgentRunner['steerWebchatAgent']>;
+    submitClarifyResponse(requestId: string, answer: string): boolean;
     private initializeExtensionLoader;
     private registerExtensionChannelPlugins;
     /**
@@ -100,131 +108,26 @@ export declare class GatewayService {
      * Start processing outbound messages and send through channels
      */
     private startOutboundProcessor;
-    /**
-     * Setup config hot reload using ConfigHotReloader
-     */
-    private setupConfigReloader;
-    /**
-     * Handle models config hot reload
-     */
-    private handleModelsReload;
-    /**
-     * Handle agent defaults config hot reload
-     */
-    private handleAgentDefaultsReload;
-    /**
-     * Apply `latest.channels` to every registered channel plugin (Telegram, Weixin, extensions).
-     * Single runtime path for: file watcher hot reload, API saves, and Weixin QR follow-up.
-     */
-    private handleChannelsReload;
-    /**
-     * Apply channel plugins for the latest persisted `this.config` without blocking `saveConfig` HTTP handlers.
-     * Coalesces rapid saves so Telegram/Weixin do not stop/start repeatedly.
-     */
-    private scheduleChannelPluginsAfterPersist;
-    /**
-     * Handle cron config hot reload
-     */
-    private handleCronReload;
-    /**
-     * Handle heartbeat config hot reload
-     */
-    private handleHeartbeatReload;
-    /**
-     * Apply `gateway.heartbeat` from current config after PATCH /api/config (and when hot reload is off).
-     * File watcher uses `handleHeartbeatReload` with the same effect when paths match.
-     */
     reloadHeartbeatFromCurrentConfig(): void;
-    /**
-     * Handle tools config hot reload
-     */
-    private handleToolsReload;
-    private handleMcpReload;
-    /**
-     * Dispatch config hot reload to extensions that registered `registerReload`, matching changed paths.
-     */
-    private handleExtensionsReload;
-    /**
-     * Reload configuration from disk (manual trigger)
-     */
     reloadConfig(): Promise<{
         reloaded: boolean;
         error?: string;
     }>;
-    /**
-     * After Weixin QR login: token files may change without a `channels.weixin` JSON diff, so run the same
-     * channel apply as an API save, then force Weixin long-poll restart (see `reloadMonitorsWithConfig`).
-     */
     afterWeixinCredentialsPersisted(): Promise<void>;
-    /**
-     * After Feishu WebUI QR setup: `channels.feishu` was written directly to disk; reload into memory
-     * and apply channel plugins (same baseline as PATCH /api/config).
-     */
     afterFeishuCredentialsPersisted(): Promise<void>;
-    /**
-     * Persist and replace `this.config` with the validated file contents so runtime matches disk
-     * (PATCH merge objects can drift from Zod-normalized output).
-     */
-    private writeConfigAndReloadFromDisk;
     saveConfig(config: Config): Promise<{
         saved: boolean;
         error?: string;
     }>;
-    /**
-     * App store (phase 1): persist `extensions.enabled` / `extensions.disabled` for a bundled extension.
-     * Marketplace-only extensions hot-load on enable; disable still needs a gateway restart to unload.
-     */
     setBundledExtensionActivationTarget(extensionId: string, wanted: boolean): Promise<{
         ok: boolean;
         error?: string;
         requiresGatewayRestart: boolean;
     }>;
-    /**
-     * Update configuration and persist to disk
-     */
     updateConfig(updates: Partial<Config>): Promise<{
         updated: boolean;
         error?: string;
     }>;
-    /**
-     * Run agent with a message and stream events.
-     * `runOptions.signal` — When set (e.g. client disconnect), aborts in-flight generation and persists partial output.
-     */
-    runAgent(message: string, channel: string, chatId: string, attachments?: Array<{
-        type: string;
-        mimeType?: string;
-        data?: string;
-        name?: string;
-        size?: number;
-    }>, thinking?: string, runOptions?: {
-        signal?: AbortSignal;
-        clientCreatedAtMs?: number;
-    }): AsyncGenerator<{
-        type: string;
-        content?: string;
-        status?: string;
-        runId?: string;
-    }, {
-        status: string;
-        summary: string;
-    }, unknown>;
-    /** Abort an in-flight webchat agent run (matches `runId` from SSE `status`). */
-    abortAgentRun(runId: string): boolean;
-    /** Background drain for extension-initiated webchat turns (`scheduleWebchatContinuation`). */
-    private drainScheduledWebchatContinuation;
-    /**
-     * Queue steering text for an active webchat run (`Agent.steer` / tool-boundary injection).
-     * `chatId` is the same as `POST /api/agent` body (`sessionKey` or legacy peer id).
-     */
-    steerWebchatAgent(chatId: string, message: string): Promise<{
-        ok: true;
-    } | {
-        ok: false;
-        code: 'BAD_REQUEST' | 'NO_ACTIVE_RUN' | 'STEER_FAILED';
-    }>;
-    private deliverTelegramClarify;
-    /** Deliver a user's answer to a pending `clarify` tool call. */
-    submitClarifyResponse(requestId: string, answer: string): boolean;
     /**
      * Send message through a channel
      */
@@ -294,7 +197,7 @@ export declare class GatewayService {
     /**
      * Get extension registry for external access (HTTP routes, gateway methods)
      */
-    getExtensionRegistry(): import("../extensions/loader.js").ExtensionRegistryImpl;
+    getExtensionRegistry(): import("../extensions/extension-registry-impl.js").ExtensionRegistryImpl;
     /** Extension loader for discovery and frontend asset APIs (may be null if extensions failed to init). */
     getExtensionLoader(): ExtensionLoader | null;
     /**
@@ -309,248 +212,15 @@ export declare class GatewayService {
     /** Effective HTTP listen port (CLI `--port` override or config default). */
     getEffectiveListenPort(): number;
     get cronServiceInstance(): CronService;
-    getSkillsApi(lang?: string): {
-        catalog: SkillCatalogEntry[];
-        managed: ManagedSkillListItem[];
-    };
-    getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null;
-    deleteManagedSkill(skillId: string): void;
-    installManagedSkillZip(buffer: Buffer, opts: {
-        skillId?: string;
-        overwrite?: boolean;
-    }): {
-        skillId: string;
-        path: string;
-    };
-    fetchSkillsMarketplaceCatalog(params: SkillsStoreListParams, provider?: string): Promise<UnifiedMarketplaceListResponse>;
-    fetchSkillsMarketplaceCategories(provider?: string): Promise<{
-        items: MarketplaceCategoryOption[];
-    }>;
-    fetchSkillsMarketplacePackageDetail(packageName: string, provider?: string): Promise<UnifiedMarketplacePackageDetail>;
-    installSkillFromMarketplace(opts: {
-        name: string;
-        version?: string;
-        overwrite?: boolean;
-        provider?: string;
-    }): Promise<{
-        skillId: string;
-        path: string;
-    }>;
-    /**
-     * xopc-store extension package preview (type must be `extension`).
-     */
-    fetchExtensionMarketplacePackageDetail(packageName: string): Promise<MarketplacePackageDetail>;
-    private mergeExtensionEnabledIntoConfig;
-    private mergeExtensionRemovedFromEnabledConfig;
-    /**
-     * Install an extension from xopc-store into the global extensions directory (`~/.xopc/extensions`),
-     * append its id to `extensions.enabled`, refresh the loader, and emit `config.reload`.
-     */
-    installExtensionFromMarketplace(opts: {
-        name: string;
-        version?: string;
-        overwrite?: boolean;
-    }): Promise<{
-        extensionId: string;
-        version: string;
-        requiresGatewayRestart: boolean;
-    }>;
-    /**
-     * Remove a user-installed (global or per-agent extensions dir) extension from disk and config.
-     */
-    uninstallUserExtension(extensionId: string): Promise<{
-        requiresGatewayRestart: boolean;
-    }>;
-    getSkillsMarketplaceProvider(): {
-        provider: string;
-        displayName: string;
-    };
-    /** All registered marketplace providers (built-in + extension-contributed). */
-    getSkillsMarketplaceProviders(): Array<{
-        id: string;
-        displayName: string;
-    }>;
-    reloadSkillsFromDisk(): void;
-    patchSkillEnabled(skillName: string, enabled: boolean): void;
     get sessionIndexInstance(): SessionIndex;
     /** @deprecated Use {@link sessionIndexInstance}. */
     get sessionManagerInstance(): SessionIndex;
-    getSessionAgentConfig(sessionKey: string): Promise<{
-        thinkingLevel: import("@earendil-works/pi-agent-core").ThinkingLevel;
-        model: string;
-        reasoningLevel: import("../config/index.js").ReasoningLevel;
-        effectiveWorkspacePath: string;
-        workingDirectoryLocked: boolean;
-    }>;
-    /** Resolved markdown workspace for a session (after hydration / mkdir). Used by workspace file API when `sessionKey` is passed. */
-    getEffectiveWorkspacePathForSession(sessionKey: string): Promise<string>;
-    patchSessionAgentConfig(sessionKey: string, body: {
-        thinkingLevel?: string;
-        model?: string | null;
-        reasoningLevel?: string;
-        workingDirectory?: string;
-    }): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /**
-     * Process a message directly through the agent (for CLI mode)
-     */
+    /** Process a message directly through the agent (for CLI mode). */
     processDirect(content: string, sessionKey?: string): Promise<string>;
-    /**
-     * Subscribe to server-pushed events.
-     * Returns a cleanup function to unsubscribe.
-     */
     subscribe(sessionId: string, listener: (event: ServiceEvent) => Promise<void> | void): () => void;
-    /**
-     * Emit an event to all subscribers.
-     */
     emit(type: string, payload: unknown): void;
-    /**
-     * Get events since a given event id (for Last-Event-ID reconnection).
-     */
+    /** Replay events since `lastEventId` for SSE reconnection. */
     getEventsSince(sessionId: string, lastEventId: string): ServiceEvent[];
-    /**
-     * List sessions with query filters
-     */
-    listSessions(query?: SessionListQuery): Promise<import("../session/types.js").PaginatedResult<import("../session/types.js").SessionMetadata>>;
-    /**
-     * List all subagent sessions.
-     * Subagent sessions have keys starting with 'subagent:'.
-     */
-    listSubagents(query?: SessionListQuery): Promise<import("../session/types.js").PaginatedResult<import("../session/types.js").SessionMetadata>>;
-    /**
-     * Get a single session by key
-     */
-    getSession(key: string, options?: {
-        includeTranscriptSummary?: boolean;
-        includeTranscriptRows?: boolean;
-    }): Promise<import("../session/types.js").SessionDetail>;
-    /** Read-only: in-flight webchat agent run for this session key, if any. */
-    getSessionActiveRun(sessionKey: string): {
-        active: boolean;
-        runId?: string;
-    };
-    getSessionMessagePage(key: string, options?: {
-        offset?: number;
-        limit?: number;
-        before?: string;
-        includeTranscriptSummary?: boolean;
-        includeTranscriptRows?: boolean;
-    }): Promise<{
-        session: import("../session/types.js").SessionDetail;
-        pagination: {
-            total: number;
-            limit: number;
-            offset: number;
-            hasMore: boolean;
-            before?: string;
-            nextBeforeCursor?: string;
-        };
-    }>;
-    /**
-     * Partial session metadata update (OpenClaw-style sessions.patch subset).
-     */
-    patchSession(key: string, body: SessionPatchBody): Promise<{
-        ok: true;
-    } | {
-        ok: false;
-        error: string;
-    }>;
-    listSessionCompactionCheckpoints(key: string): Promise<import("../session/types.js").CompactionCheckpointSummary[]>;
-    getSessionCompactionCheckpoint(key: string, checkpointId: string): Promise<import("../session/types.js").CompactionCheckpointDetail>;
-    restoreSessionCompactionCheckpoint(key: string, checkpointId: string): Promise<void>;
-    runSessionCompaction(key: string, options?: {
-        instructions?: string;
-        force?: boolean;
-    }): Promise<CompactionResult>;
-    /**
-     * Delete a session
-     */
-    deleteSession(key: string): Promise<{
-        deleted: boolean;
-    }>;
-    /**
-     * Delete multiple sessions
-     */
-    deleteSessions(keys: string[]): Promise<{
-        success: string[];
-        failed: string[];
-    }>;
-    /**
-     * Rename a session
-     */
-    renameSession(key: string, name: string): Promise<{
-        renamed: boolean;
-    }>;
-    /**
-     * Tag a session
-     */
-    tagSession(key: string, tags: string[]): Promise<{
-        tagged: boolean;
-    }>;
-    /**
-     * Remove tags from a session
-     */
-    untagSession(key: string, tags: string[]): Promise<{
-        untagged: boolean;
-    }>;
-    /**
-     * Archive a session
-     */
-    archiveSession(key: string): Promise<{
-        archived: boolean;
-    }>;
-    /**
-     * Unarchive a session
-     */
-    unarchiveSession(key: string): Promise<{
-        unarchived: boolean;
-    }>;
-    /**
-     * Pin a session
-     */
-    pinSession(key: string): Promise<{
-        pinned: boolean;
-    }>;
-    /**
-     * Unpin a session
-     */
-    unpinSession(key: string): Promise<{
-        unpinned: boolean;
-    }>;
-    /**
-     * Search sessions
-     */
-    searchSessions(query: string): Promise<import("../session/types.js").SessionMetadata[]>;
-    /**
-     * Search within a session
-     */
-    searchInSession(key: string, keyword: string): Promise<import("../session/types.js").Message[]>;
-    /**
-     * Export a session
-     */
-    exportSession(key: string, format: ExportFormat): Promise<{
-        content: string;
-    }>;
-    /**
-     * Get session statistics
-     */
-    getSessionStats(): Promise<import("../session/types.js").GlobalSessionStats>;
-    /**
-     * Get unique chat IDs from sessions, grouped by channel
-     * Returns a list of channel/chatId pairs for cron job configuration.
-     * `chatId` is the session-store routing suffix (unique per bot account + peer).
-     * When `routing` exists, `peerId` is the platform id (e.g. Telegram numeric chat id).
-     */
-    getSessionChatIds(channel?: string): Promise<Array<{
-        channel: string;
-        chatId: string;
-        lastActive: string;
-        accountId?: string;
-        peerKind?: string;
-        peerId?: string;
-    }>>;
     /**
      * Validate authentication token from request headers.
      * Returns true if auth is disabled (mode: 'none') or token is valid.