import type { ThinkingLevel } from '@earendil-works/pi-agent-core';
import type { Config } from '../config/schema.js';
import type { SessionStore } from '../session/store.js';
import type { AutomationService } from '../automations/index.js';
import type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/index.js';
import type { NotesService } from '../notes/index.js';
import type { ProjectService } from '../projects/index.js';
import type { LocalAppService } from '../local-apps/index.js';
import type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';
import type { AgentSourceContextResolver } from './source-context/types.js';
import type { EndpointToolRuntime } from '../endpoint-tools/index.js';
export interface AgentServiceConfig {
    workspace: string;
    model?: string;
    config?: Config;
    extensionRegistry?: ExtensionRegistry;
    endpointTools?: EndpointToolRuntime;
    maxRequestsPerTurn?: number;
    maxToolFailuresPerTurn?: number;
    maxTaskDurationMs?: number;
    thinkingLevel?: ThinkingLevel;
    reasoningLevel?: 'off' | 'on' | 'stream';
    verboseLevel?: 'off' | 'on' | 'full';
    /**
     * Gateway-only: blocks the `clarify` tool until the user answers via the web UI.
     */
    gatewayClarify?: {
        requestClarification: GatewayClarifyRequestFn;
    };
    getAutomationService?: () => AutomationService | undefined;
    getBrowserRecipeService?: () => import('../browser/recipes/index.js').BrowserRecipeService | undefined;
    /** Gateway: exposes first-class xopc product objects for the `xopc_use` tool. */
    getNotesService?: () => NotesService | undefined;
    getProjectService?: () => ProjectService | undefined;
    getLocalAppService?: () => LocalAppService | undefined;
    dispatchTaskRuns?: () => void;
    /**
     * Gateway: reuse the gateway `SessionManager` store so web API and agent share one index + files.
     * When omitted, `AgentService` creates its own `SessionStore` (CLI / embedded).
     */
    sessionStore?: SessionStore;
    onSessionMetadataUpdated?: (sessionKey: string, patch?: {
        name?: string;
    }) => void;
    /** Gateway: transcript append notification. */
    onSessionTranscriptUpdated?: (sessionKey: string) => void;
    /** Gateway/TUI: local skill catalog changed or skill config toggles changed. */
    onSkillsUpdated?: (payload: {
        reason: 'disk' | 'config';
    }) => void;
    /**
     * Runtime trust override. Local TUI uses this to trust the startup workspace
     * without persisting a trust entry; gateway mode leaves trust fully persistent.
     */
    isWorkspaceTrusted?: (workspaceDir: string) => boolean | null | undefined;
    /** Gateway: persisted workflow runs. */
    getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike;
    /** Gateway: resolves bound source context (e.g. Note-grounded chat) before each turn. */
    sourceContextResolver?: AgentSourceContextResolver;
}
export interface AgentContext {
    channel: string;
    chatId: string;
    sessionKey: string;
    senderId?: string;
    isGroup?: boolean;
}
export interface StreamHandle {
    update: (text: string) => void;
    end: () => Promise<void>;
    abort: () => Promise<void>;
    messageId: () => number | undefined;
}