neoctl 0.2.30 → 0.2.31

package/dist/web/index.d.ts

@@ -10,7 +10,9 @@ import type { Tool } from "../tools/tool.js";
 import { ExecProcessManager } from "../tools/builtins/exec-process-manager.js";
 import { type AgentToolRuntime } from "../agents/agent-tool.js";
 import { TaskStore } from "../tasks/task-store.js";
+import type { CompactionReport } from "../context/compaction.js";
 import type { PromptSection } from "../context/prompts.js";
+import type { NeoPluginResource } from "../plugins/plugin-system.js";
 import type { ContextMetrics } from "../types/events.js";
 import { type WebRuntimeContextPayload } from "./runtime-context-protocol.js";
 export interface WebRuntime {
@@ -28,14 +30,12 @@ export interface WebRuntime {
     envPath: string;
     envNotice?: string;
     pluginSupport?: WebRuntimePluginSupport;
+    toolSupport?: WebRuntimeToolSupport;
 }
-export interface WebRuntimePluginDefinition {
-    id: string;
-    name: string;
-    version: string;
+export interface WebRuntimePluginDefinition extends Pick<NeoPluginResource, "id" | "name" | "version" | "tools"> {
     globallyEnabled: boolean;
-    tools: readonly Tool[];
     promptSections?: readonly PromptSection[];
+    presentToolResult?: NeoPluginResource["presentToolResult"];
 }
 interface WebRuntimePluginSupport {
     catalog: WebRuntimePluginDefinition[];
@@ -45,6 +45,20 @@ interface WebRuntimePluginSupport {
     persist?: (sessionId: string, overrides: Record<string, boolean>) => Promise<void>;
     resolve?: (sessionId: string) => Promise<Record<string, boolean>> | Record<string, boolean>;
 }
+interface WebRuntimeToolCatalogItem {
+    name: string;
+    source: "builtin" | "external" | "plugin";
+    pluginId?: string;
+    pluginName?: string;
+}
+interface WebRuntimeToolSupport {
+    catalog: WebRuntimeToolCatalogItem[];
+    globalOverrides: Record<string, boolean>;
+    sessionOverrides: Record<string, boolean>;
+    persistGlobal?: (overrides: Record<string, boolean>) => Promise<void>;
+    persistSession?: (sessionId: string, overrides: Record<string, boolean>) => Promise<void>;
+    resolveSession?: (sessionId: string) => Promise<Record<string, boolean>> | Record<string, boolean>;
+}
 export interface UsageTotals {
     inputTokens: number;
     outputTokens: number;
@@ -62,9 +76,45 @@ export declare class SessionUsageTracker {
     snapshot(): UsageTotals;
 }
 interface UiLineImage {
-    src: string;
+    src?: string;
+    imageId?: string;
     label?: string;
     mimeType: string;
+    available: boolean;
+    error?: string;
+    blockIndex: number;
+}
+interface UiCompactionReport extends CompactionReport {
+    createdAt?: string;
+    current?: boolean;
+}
+interface UiResource {
+    kind: string;
+    url: string;
+    reference?: string;
+    label?: string;
+    downloadName?: string;
+    sizeBytes?: number;
+    expiresAt?: number;
+    mimeType?: string;
+    height?: number;
+}
+interface UiToolFact {
+    label: string;
+    value: string;
+    code?: boolean;
+    tone?: "neutral" | "success" | "warning" | "danger";
+}
+interface UiToolPreview {
+    label?: string;
+    kind: "text" | "code" | "diff" | "list";
+    content: string;
+}
+interface UiToolDisplay {
+    subject?: string;
+    purpose?: string;
+    facts: UiToolFact[];
+    previews: UiToolPreview[];
 }
 interface UiLine {
     id: number;
@@ -78,12 +128,16 @@ interface UiLine {
     title?: string;
     bodyTitle?: string;
     titleStatus?: "success" | "failure";
+    toolDisplay?: UiToolDisplay;
     format?: "markdown" | "ansi" | "plain" | "diff";
     previewStyle?: "summary";
     summaryMaxLines?: number;
+    presentationLevel?: "primary" | "process";
+    resources?: UiResource[];
     live?: boolean;
     collapsible?: boolean;
     image?: UiLineImage;
+    compaction?: UiCompactionReport;
 }
 type WebActionFailure = {
     ok: false;
@@ -127,6 +181,9 @@ export interface CreateWebRuntimeOptions {
     agentId?: string;
     /** Workspace root used by context, tools, and session storage. */
     cwd?: string;
+    /** Persisted CWD transition chain shown to the model on the next request only. */
+    cwdTransitionPaths?: readonly string[];
+    onCwdTransitionConsumed?: () => void | Promise<void>;
     /** Additional tools to register in the web runtime. */
     externalTools?: readonly Tool[];
     /** Stable or dynamic prompt sections supplied by the embedding application. */
@@ -139,6 +196,13 @@ export interface CreateWebRuntimeOptions {
     sessionPluginOverrides?: Readonly<Record<string, boolean>>;
     persistSessionPluginOverrides?: WebRuntimePluginSupport["persist"];
     resolveSessionPluginOverrides?: WebRuntimePluginSupport["resolve"];
+    /** Global tool defaults. Missing names default to enabled. */
+    globalToolOverrides?: Readonly<Record<string, boolean>>;
+    /** Per-session tool overrides. Missing names inherit their global default. */
+    sessionToolOverrides?: Readonly<Record<string, boolean>>;
+    persistGlobalToolOverrides?: WebRuntimeToolSupport["persistGlobal"];
+    persistSessionToolOverrides?: WebRuntimeToolSupport["persistSession"];
+    resolveSessionToolOverrides?: WebRuntimeToolSupport["resolveSession"];
 }
 export interface WebRuntimeScope {
     /** Browser-tab or client-instance identifier. Omit for the legacy singleton runtime. */
@@ -170,6 +234,7 @@ interface LoginFormPayload {
 }
 interface WebImageAttachmentPayload {
     kind: "image";
+    imageId: string;
     label: string;
     mimeType: string;
     data: string;
@@ -208,10 +273,29 @@ export declare class WebRuntimeRouter {
     private readonly repls;
     private readonly createRuntime;
     private readonly createRepl;
+    private readonly clientRevision;
+    private readonly coreVersion;
     constructor(options?: WebRuntimeRouterOptions);
     get(scope?: WebRuntimeScope): Promise<WebRepl>;
     snapshot(scope?: WebRuntimeScope, includeCatalog?: boolean): Promise<ReturnType<WebRepl["snapshot"]>>;
     activeScopes(): string[];
+    clientInfo(): WebClientInfoPayload;
+    requestClientReload(options?: {
+        clearCache?: boolean;
+        reason?: string;
+    }): Promise<WebClientReloadPayload & {
+        clients: number;
+    }>;
+}
+interface WebClientInfoPayload {
+    protocolVersion: 1;
+    revision: string;
+    coreVersion: string;
+}
+interface WebClientReloadPayload extends WebClientInfoPayload {
+    requestId: string;
+    clearCache: boolean;
+    reason: string;
 }
 export declare function createWebRuntimeRouter(options?: WebRuntimeRouterOptions): Promise<WebRuntimeRouter>;
 export declare class WebRepl {
@@ -221,6 +305,8 @@ export declare class WebRepl {
     private pendingDeltaOperations;
     private pendingDeltaStatus;
     private pendingDeltaTimer;
+    private readonly pendingTerminalOutput;
+    private terminalOutputTimer;
     private lineId;
     private assistantLineId;
     private thinkingLineId;
@@ -235,15 +321,16 @@ export declare class WebRepl {
     private queuedAttachments;
     private foregroundRun;
     private foregroundRunToken;
-    private pendingUserImageEchoLabels;
+    private pendingUserImageEchoIds;
     private pendingUserImageEchoMessageId;
     private runtimeContextRevision;
     private runtimeContextPublishQueue;
     private readonly backgroundSessionRuns;
     private readonly suppressReattachedStreaming;
-    private backgroundTaskCount;
     constructor(runtime: WebRuntime);
-    subscribe(res: ServerResponse): void;
+    subscribe(res: ServerResponse, clientInfo?: WebClientInfoPayload): void;
+    get backgroundTaskCount(): number;
+    requestClientReload(payload: WebClientReloadPayload): number;
     snapshot(includeCatalog?: boolean): {
         lines: UiLine[];
         status: UiStatus;
@@ -254,10 +341,15 @@ export declare class WebRepl {
             kind: "agent";
             taskId: string;
             agentId: string;
+            agentType: string | undefined;
             type: import("../index.js").LocalAgentTaskType;
             status: import("../index.js").LocalAgentTaskStatus;
             description: string;
+            prompt: string;
+            progress: import("../index.js").AgentProgressSnapshot;
+            outputFile: string;
             createdAt: string;
+            updatedAt: string;
         } | {
             kind: "terminal";
             taskId: string;
@@ -272,6 +364,16 @@ export declare class WebRepl {
             shell: string;
             tty: boolean;
             durationMs: number;
+            output: string;
+            outputEnd: number;
+        } | {
+            kind: "session";
+            taskId: string;
+            type: string;
+            status: "running";
+            description: string;
+            createdAt: number;
+            sessionId: string;
         })[];
         backgroundSessionRunCount: number;
         runningSessionIds: string[];
@@ -304,10 +406,45 @@ export declare class WebRepl {
             promptSections: number;
         }[];
     };
+    globalTools(): {
+        items: {
+            configuredEnabled: boolean;
+            name: string;
+            source: "builtin" | "external" | "plugin";
+            pluginId?: string;
+            pluginName?: string;
+        }[];
+    };
+    sessionTools(): {
+        sessionId: string | undefined;
+        busy: boolean;
+        items: {
+            available: boolean;
+            globallyEnabled: boolean;
+            mode: string;
+            effectiveEnabled: boolean;
+            name: string;
+            source: "builtin" | "external" | "plugin";
+            pluginId?: string;
+            pluginName?: string;
+        }[];
+    };
+    setGlobalTools(value: unknown): Promise<WebActionResult<{
+        state: ReturnType<WebRepl["globalTools"]>;
+    }>>;
+    setSessionTools(value: unknown): Promise<WebActionResult<{
+        state: ReturnType<WebRepl["sessionTools"]>;
+    }>>;
+    loadSessionTools(sessionId: string): Promise<void>;
     setSessionPlugins(value: unknown): Promise<WebActionResult<{
         state: ReturnType<WebRepl["sessionPlugins"]>;
     }>>;
     loadSessionPlugins(sessionId: string): Promise<void>;
+    private parseToolOverrides;
+    private parseToolModes;
+    private applySessionToolOverrides;
+    private syncPluginToolRegistration;
+    private refreshToolConfiguration;
     private applySessionPluginOverrides;
     submit(text: string, attachments?: WebAttachmentPayload[]): Promise<{
         ok: true;
@@ -341,9 +478,17 @@ export declare class WebRepl {
         body: Buffer;
         mimeType: string;
     } | undefined;
+    imagePayloadById(imageId: string): {
+        body: Buffer;
+        mimeType: string;
+    } | undefined;
     setFastMode(enabled: boolean): Promise<WebActionResult<{
         fastMode: boolean;
     }>>;
+    setContextWindowK(value: unknown): Promise<WebActionResult<{
+        contextWindowK: number;
+        contextWindowTokens: number;
+    }>>;
     loginForm(providerValue?: string): LoginFormPayload;
     saveLogin(providerValue: string, values: Record<string, string>): Promise<WebActionResult>;
     interrupt(): {
@@ -355,6 +500,7 @@ export declare class WebRepl {
         cancelled: boolean;
     };
     private append;
+    private appendCompaction;
     private appendLineText;
     private replaceLineText;
     private replaceLine;
@@ -382,8 +528,12 @@ export declare class WebRepl {
     private scheduleDeltaFlush;
     private flushDeltaOperations;
     private discardPendingDeltaOperations;
+    private dropInactiveTerminalOutput;
+    private queueTerminalOutput;
+    private flushTerminalOutput;
     private broadcastSync;
 }
 export declare function compactLineOperations(operations: WebLineOperation[]): WebLineOperation[];
+export declare function restoreWebHistoryLines(runtime: Pick<WebRuntime, "engine">): Array<Record<string, unknown>>;
 export declare function mergeWebQueuedInput(current: string | undefined, next: string): string;
 export {};