@nextclaw/kernel 0.1.14 → 0.1.15-beta.0

package/dist/index.d.ts

@@ -1,13 +1,104 @@
 import { a as getUnsignedUpdateManifest, c as UpdateBlockReason, d as UpdateSnapshot, f as UpdateStatus, i as UpdateManifestReader, l as UpdatePreferences, n as UpdateHostKind, o as serializeUnsignedUpdateManifest, r as UpdateManifest, s as InstallationKind, t as UnsignedUpdateManifest, u as UpdateProgress } from "./update-manifest.types-DLWDvs_v.js";
-import { EventBus, Ingress, Unsubscribe } from "@nextclaw/shared";
+import { AgentRunSendIngressPayload, EventBus, Ingress, Unsubscribe } from "@nextclaw/shared";
 import * as _$_nextclaw_ncp0 from "@nextclaw/ncp";
-import { ListMessagesOptions, ListSessionsOptions, NcpAgentConversationStateManager, NcpAgentRunInput, NcpAgentRunSendOptions, NcpAgentRunStreamOptions, NcpAgentRuntime, NcpContextBuilder, NcpContextPrepareOptions, NcpEndpointEvent, NcpEventType, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessagePart, NcpRequestEnvelope, NcpSessionApi, NcpSessionPatch, NcpSessionSummary, NcpStreamRequestPayload, NcpTool, NcpToolRegistry, OpenAIChatChunk } from "@nextclaw/ncp";
+import { ListMessagesOptions, ListSessionsOptions, NcpAgentConversationStateManager, NcpAgentRunInput, NcpAgentRunSendOptions, NcpAgentRuntime, NcpContextBuilder, NcpContextPrepareOptions, NcpEndpointEvent, NcpEventType, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessagePart, NcpRequestEnvelope, NcpRunHandle, NcpSessionApi, NcpSessionPatch, NcpSessionSummary, NcpTool, NcpToolRegistry, OpenAIChatChunk } from "@nextclaw/ncp";
 import { LocalAssetStore } from "@nextclaw/ncp-agent-runtime";
-import { BaseChannel, ChannelManager, ChannelManager as ChannelManager$1, Config, ContextWindowSnapshot, CreateSessionInput, CreatedSession, CronService, Disposable, ExtensionRegistry, ExtensionToolContext, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, RequestSessionParams, SearchConfig, Session, SessionManager, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchManager, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, Tool } from "@nextclaw/core";
-import { PluginChannelBinding, PluginRegistry, PluginUiMetadata } from "@nextclaw/openclaw-compat";
+import { BaseChannel, ChannelManager, ChannelManager as ChannelManager$1, Config, ContextCompactionPlan, ContextWindowSnapshot, CreateSessionInput, CreatedSession, CronService, Disposable, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, ExtensionToolContext, ExtensionUiMetadata, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, RequestSessionParams, RequestedSkillsMetadataReader, SearchConfig, Session, SessionManager, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchManager, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, Tool, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
 import * as _$_nextclaw_ncp_toolkit0 from "@nextclaw/ncp-toolkit";
 import { AgentSessionRecord, ChatTarget, NcpReplyInput, RuntimeFactoryParams } from "@nextclaw/ncp-toolkit";
 
+//#region src/features/runtime-registry/services/agent-runtime-registry.service.d.ts
+type AgentRuntimeSessionTypeIcon = {
+  kind: "image";
+  src: string;
+  alt?: string | null;
+};
+type AgentRuntimeSessionTypeOption = {
+  value: string;
+  label: string;
+  icon?: AgentRuntimeSessionTypeIcon | null;
+  ready?: boolean;
+  reason?: string | null;
+  reasonMessage?: string | null;
+  supportedModels?: string[];
+  recommendedModel?: string | null;
+  cta?: {
+    kind: string;
+    label?: string;
+    href?: string;
+  } | null;
+};
+type AgentRuntimeSessionTypeDescribeParams = {
+  describeMode?: "observation" | "probe";
+};
+type AgentRuntimeEntry = {
+  id: string;
+  label: string;
+  icon?: AgentRuntimeSessionTypeIcon | null;
+  type: string;
+  enabled?: boolean;
+  config?: Record<string, unknown>;
+};
+type AgentRuntimeProviderRegistration = {
+  kind: string;
+  label: string;
+  createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
+  createRuntimeForEntry?: (params: {
+    entry: AgentRuntimeEntry;
+    runtimeParams: RuntimeFactoryParams;
+  }) => NcpAgentRuntime;
+  describeSessionType?: (params?: AgentRuntimeSessionTypeDescribeParams) => Promise<Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined> | Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined;
+  describeSessionTypeForEntry?: (params: {
+    entry: AgentRuntimeEntry;
+    describeParams?: AgentRuntimeSessionTypeDescribeParams;
+  }) => Promise<Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined> | Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined;
+};
+declare function normalizeAgentRuntimeSessionTypeIcon(value: unknown): AgentRuntimeSessionTypeIcon | null;
+type ConfigRuntimeEntry = {
+  enabled?: boolean;
+  label?: string;
+  icon?: unknown;
+  type?: string;
+  config?: Record<string, unknown>;
+};
+type AgentRuntimeResolverConfig = {
+  ui?: {
+    ncp?: {
+      runtimes?: {
+        native?: unknown;
+      };
+    };
+  };
+  agents: {
+    runtimes: {
+      entries?: Record<string, ConfigRuntimeEntry>;
+    };
+  };
+};
+declare function resolveAgentRuntimeEntries(params: {
+  config: AgentRuntimeResolverConfig;
+}): {
+  defaultEntryId: string;
+  entries: AgentRuntimeEntry[];
+};
+declare class AgentRuntimeRegistry {
+  private readonly providers;
+  private entries;
+  private defaultEntryId;
+  register: (registration: AgentRuntimeProviderRegistration) => Disposable;
+  applyEntries: (params: {
+    entries: AgentRuntimeEntry[];
+    defaultEntryId?: string;
+  }) => void;
+  resolveSessionMetadata: (sessionMetadata: Record<string, unknown>) => Record<string, unknown>;
+  createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
+  private resolveRuntimeEntry;
+  listSessionTypes: (params?: AgentRuntimeSessionTypeDescribeParams) => Promise<{
+    defaultType: string;
+    options: AgentRuntimeSessionTypeOption[];
+  }>;
+}
+//#endregion
 //#region src/types/entity-ids.types.d.ts
 type AgentId = string;
 type TaskId = string;
@@ -107,99 +198,6 @@ type PublishSessionEventOptions = {
   persistSession?: boolean;
 };
 //#endregion
-//#region src/features/runtime-registry/services/agent-runtime-registry.service.d.ts
-declare const DEFAULT_AGENT_RUNTIME_ENTRY_ID = "native";
-type AgentRuntimeSessionTypeIcon = {
-  kind: "image";
-  src: string;
-  alt?: string | null;
-};
-type AgentRuntimeSessionTypeOption = {
-  value: string;
-  label: string;
-  icon?: AgentRuntimeSessionTypeIcon | null;
-  ready?: boolean;
-  reason?: string | null;
-  reasonMessage?: string | null;
-  supportedModels?: string[];
-  recommendedModel?: string | null;
-  cta?: {
-    kind: string;
-    label?: string;
-    href?: string;
-  } | null;
-};
-type AgentRuntimeSessionTypeDescribeParams = {
-  describeMode?: "observation" | "probe";
-};
-type AgentRuntimeEntry = {
-  id: string;
-  label: string;
-  icon?: AgentRuntimeSessionTypeIcon | null;
-  type: string;
-  enabled?: boolean;
-  config?: Record<string, unknown>;
-};
-type AgentRuntimeProviderRegistration = {
-  kind: string;
-  label: string;
-  createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
-  createRuntimeForEntry?: (params: {
-    entry: AgentRuntimeEntry;
-    runtimeParams: RuntimeFactoryParams;
-  }) => NcpAgentRuntime;
-  describeSessionType?: (params?: AgentRuntimeSessionTypeDescribeParams) => Promise<Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined> | Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined;
-  describeSessionTypeForEntry?: (params: {
-    entry: AgentRuntimeEntry;
-    describeParams?: AgentRuntimeSessionTypeDescribeParams;
-  }) => Promise<Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined> | Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined;
-};
-declare function normalizeAgentRuntimeSessionTypeIcon(value: unknown): AgentRuntimeSessionTypeIcon | null;
-type ConfigRuntimeEntry = {
-  enabled?: boolean;
-  label?: string;
-  icon?: unknown;
-  type?: string;
-  config?: Record<string, unknown>;
-};
-type AgentRuntimeResolverConfig = {
-  ui?: {
-    ncp?: {
-      runtimes?: {
-        native?: unknown;
-      };
-    };
-  };
-  agents: {
-    runtimes: {
-      entries?: Record<string, ConfigRuntimeEntry>;
-    };
-  };
-};
-declare function resolveAgentRuntimeEntries(params: {
-  config: AgentRuntimeResolverConfig;
-}): {
-  defaultEntryId: string;
-  entries: AgentRuntimeEntry[];
-};
-declare class AgentRuntimeRegistry {
-  private readonly providers;
-  private entries;
-  private defaultEntryId;
-  register: (registration: AgentRuntimeProviderRegistration) => Disposable;
-  applyEntries: (params: {
-    entries: AgentRuntimeEntry[];
-    defaultEntryId?: string;
-  }) => void;
-  resolveSessionMetadata: (sessionMetadata: Record<string, unknown>) => Record<string, unknown>;
-  createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
-  private resolveRuntimeEntry;
-  listSessionTypes: (params?: AgentRuntimeSessionTypeDescribeParams) => Promise<{
-    defaultType: string;
-    options: AgentRuntimeSessionTypeOption[];
-  }>;
-}
-//#endregion
 //#region src/managers/agent-runtime.manager.d.ts
 type AgentRuntimeManagerOptions = {
   configManager: {
@@ -324,6 +322,7 @@ declare class LlmProviderManager {
   private matchPrefixedProvider;
   private getOrCreateProvider;
   private createProvider;
+  private prepareMessagesForProvider;
   private buildCacheKey;
 }
 //#endregion
@@ -340,14 +339,6 @@ type ConfigManagerRuntimeHooks = {
     config: Config;
     changedPaths: string[];
   }) => Promise<void> | void;
-  reloadPlugins?: (params: {
-    config: Config;
-    changedPaths: string[];
-  }) => Promise<{
-    restartChannels?: boolean;
-  } | void> | {
-    restartChannels?: boolean;
-  } | void;
   onRestartRequired?: (paths: string[]) => void;
 };
 type ConfigManagerOptions = {
@@ -378,6 +369,8 @@ declare class ConfigManager {
   constructor(options: ConfigManagerOptions);
   get config(): Config;
   loadConfig: () => Config;
+  getDefaultModel: () => string;
+  getModelMaxTokens: (model: string) => number | undefined;
   installRuntimeHooks: (hooks: ConfigManagerRuntimeHooks) => void;
   applyLiveConfigReload: () => Promise<void>;
   applyReloadPlan: (nextConfig: Config) => Promise<void>;
@@ -398,7 +391,6 @@ declare class ConfigManager {
   private resolveChannelConfig;
   private resolveExtensionChannels;
   private reloadProvider;
-  private reloadPlugins;
   private reloadMcp;
   private reloadCompanion;
   private readConfigSnapshot;
@@ -411,6 +403,9 @@ declare class ConfigManager {
 }
 //#endregion
 //#region src/managers/ncp-session.manager.d.ts
+type CreateNcpSessionInput = CreateSessionInput & {
+  sessionId?: string;
+};
 type NcpSessionManagerOptions = {
   configManager: ConfigManager;
   eventBus: EventBus;
@@ -424,7 +419,7 @@ declare class NcpSessionManager implements NcpSessionApi {
   private readonly unsubscribeSessionRunStatus;
   constructor(options: NcpSessionManagerOptions);
   dispose: () => void;
-  createSession: (params: CreateSessionInput) => Promise<CreatedSession>;
+  createSession: (params: CreateNcpSessionInput) => Promise<CreatedSession>;
   appendSessionEvent: (params: {
     sessionId: string;
     event: NcpAgentSessionJournalReplayEvent;
@@ -465,7 +460,6 @@ declare class SessionRunManager {
   getLiveSessionRecord: (sessionId: string) => _$_nextclaw_ncp_toolkit0.AgentSessionRecord | null;
   setActiveSessionRun: (sessionId: string, activeRun: LiveSessionExecution) => void;
   deleteActiveSessionRun: (sessionId: string, runId: string) => void;
-  streamSessionEvents: (payload: NcpStreamRequestPayload, options?: NcpAgentRunStreamOptions) => AsyncIterable<NcpEndpointEvent>;
   updateToolCallResult: UpdateToolCallResult;
   updateSessionMetadata: (sessionId: string, metadata: Record<string, unknown>) => Promise<boolean>;
   appendSessionEvent: (sessionId: string, event: NcpEndpointEvent, options?: PublishSessionEventOptions) => Promise<void>;
@@ -480,7 +474,7 @@ declare class SessionRunManager {
 //#region src/features/context-compaction/managers/context-compaction.manager.d.ts
 declare class ContextWindowPreviewManager {
   private readonly options;
-  private readonly contextWindowBudgetService;
+  private readonly preflightService;
   constructor(options: {
     configManager: ConfigManager;
   });
@@ -494,8 +488,7 @@ declare class ContextWindowPreviewManager {
 }
 declare class ContextCompactionManager {
   private readonly options;
-  private readonly compactionService;
-  private readonly contextWindowBudgetService;
+  private readonly preflightService;
   constructor(options: {
     configManager: ConfigManager;
     providerManager?: LlmProviderRuntime;
@@ -505,12 +498,62 @@ declare class ContextCompactionManager {
     input: NcpAgentRunInput;
     session: LiveSession;
   }) => AsyncIterable<NcpEndpointEvent>;
-  private begin;
-  private finish;
-  private generateSummary;
   private applyLivePreflightResult;
 }
 //#endregion
+//#region src/features/context-compaction/services/context-compaction-preflight.service.d.ts
+type ContextCompactionPreflightResult = {
+  contextWindow: ContextWindowSnapshot;
+  metadataPatch: Record<string, unknown>;
+  sessionMessages: NcpMessage[];
+  timelineMessage: NcpMessage | null;
+};
+type ContextCompactionPreflightBeginResult = ContextCompactionPreflightResult & {
+  pendingCompaction: ContextCompactionPendingWork | null;
+};
+type ContextCompactionPendingWork = {
+  checkpoint: ReturnType<typeof buildCompressingCompactionCheckpoint>;
+  contextTokens: number;
+  model: string;
+  plan: ContextCompactionPlan;
+  reservedContextTokens: number;
+  sessionId: string;
+  sessionMessages: NcpMessage[];
+};
+declare class ContextCompactionPreflightService {
+  private readonly options;
+  private readonly compactionService;
+  private readonly contextWindowBudgetService;
+  constructor(options: {
+    configManager: ConfigManager;
+    providerManager?: LlmProviderRuntime;
+  });
+  preview: (params: {
+    requestMetadata: Record<string, unknown>;
+    sessionId: string;
+    sessionMessages: readonly NcpMessage[];
+    storedAgentId?: string;
+    storedMetadata: Record<string, unknown>;
+  }) => ContextWindowSnapshot | null;
+  begin: (params: {
+    inputMessages: readonly NcpMessage[];
+    requestMetadata: Record<string, unknown>;
+    sessionId: string;
+    sessionMessages: readonly NcpMessage[];
+    storedAgentId?: string;
+    storedMetadata: Record<string, unknown>;
+  }) => ContextCompactionPreflightBeginResult;
+  finish: (pending: ContextCompactionPendingWork) => Promise<ContextCompactionPreflightResult>;
+  private generateSummary;
+}
+//#endregion
+//#region src/features/context-compaction/utils/context-window-event.utils.d.ts
+declare function readContextWindowEventSessionId(event: NcpEndpointEvent): string | null;
+declare function isContextWindowSnapshot(value: unknown): value is Record<string, unknown>;
+declare function createContextWindowSignature(value: Record<string, unknown>): string;
+declare function shouldRefreshContextWindowDuringStream(event: NcpEndpointEvent): boolean;
+declare function shouldRefreshContextWindowImmediately(event: NcpEndpointEvent): boolean;
+//#endregion
 //#region src/features/context-compaction/utils/context-compaction-projection.utils.d.ts
 declare function projectNcpMessagesWithContextCompaction(params: {
   sessionId: string;
@@ -582,34 +625,16 @@ declare class AutomationManager extends CronService {
   constructor(options: AutomationManagerOptions);
 }
 //#endregion
-//#region src/services/extension-plugin-registry.service.d.ts
-type ExtensionPluginLoadProgress = {
-  loadedPluginCount: number;
-  pluginId?: string;
-};
-declare class ExtensionPluginRegistryService {
-  discoverEnabledPluginCount: (params: {
-    config: Config;
-    workspace: string;
-  }) => number;
-  load: (params: {
-    config: Config;
-    workspace: string;
-  }) => PluginRegistry;
-  loadProgressively: (params: {
-    config: Config;
-    workspace: string;
-    onPluginProcessed?: (params: ExtensionPluginLoadProgress) => void;
-  }) => Promise<PluginRegistry>;
-  private resolveLoadingContext;
-}
-//#endregion
 //#region src/managers/extension.manager.d.ts
-type ExtensionLoadProgress = ExtensionPluginLoadProgress;
+type ExtensionLoadProgress = {
+  extensionId: string;
+  loadedExtensionCount: number;
+  totalExtensionCount: number;
+};
 type ExtensionLoadResult = {
-  diagnostics: PluginRegistry["diagnostics"];
-  totalPluginCount: number;
-  loadedPluginCount: number;
+  diagnostics: ExtensionDiagnostic[];
+  totalExtensionCount: number;
+  loadedExtensionCount: number;
   shouldRestartChannels: boolean;
 };
 type ExtensionManagerOptions = {
@@ -617,22 +642,22 @@ type ExtensionManagerOptions = {
   eventBus: Pick<EventBus, "emitEnvelope">;
   ingress: Pick<Ingress, "addHandler">;
   messageBus: Pick<MessageBus, "publishInbound">;
+  sessionManager: SessionManager;
 };
 type ExtensionLoadParams = {
   config?: Config;
   changedPaths?: readonly string[];
   onLoadStart?: (params: {
-    totalPluginCount: number;
+    totalExtensionCount: number;
   }) => void;
-  onPluginProcessed?: (params: ExtensionLoadProgress) => void;
+  onExtensionProcessed?: (params: ExtensionLoadProgress) => void;
 };
 declare class ExtensionManager {
   private readonly options;
   private snapshot;
   private readonly runtime;
-  private readonly pluginRegistry;
   constructor(options: ExtensionManagerOptions);
-  load: (params: ExtensionLoadParams) => Promise<ExtensionLoadResult>;
+  load: (params?: ExtensionLoadParams) => Promise<ExtensionLoadResult>;
   reloadForConfigChange: (params: ExtensionLoadParams & {
     changedPaths: readonly string[];
   }) => Promise<ExtensionLoadResult>;
@@ -642,8 +667,8 @@ declare class ExtensionManager {
   }) => Promise<void>;
   stop: () => Promise<void>;
   getExtensionRegistry: () => ExtensionRegistry;
-  getChannelBindings: () => PluginChannelBinding[];
-  getUiMetadata: () => PluginUiMetadata[];
+  getChannelBindings: () => ExtensionChannelBinding[];
+  getUiMetadata: () => ExtensionUiMetadata[];
   toConfigView: (config: Config) => Config;
   mergeConfigView: (current: Config, nextConfigView: Record<string, unknown>) => Config;
   private readonly getWorkspace;
@@ -911,9 +936,14 @@ declare class NextclawKernel {
   readonly sessionRunManager: SessionRunManager;
   readonly agentRuntimeManager: AgentRuntimeManager;
   private readonly ncpAgentSessionJournalStore;
+  private readonly agentRunContribution;
   private readonly contributions;
   private gatewayController;
   constructor(options?: NextclawKernelOptions);
+  listSessionTypes: (params?: AgentRuntimeSessionTypeDescribeParams) => Promise<{
+    defaultType: string;
+    options: AgentRuntimeSessionTypeOption[];
+  }>;
   provideGatewayController: (gatewayController: GatewayController) => void;
   getGatewayController: () => GatewayController | undefined;
   start: () => Promise<void>;
@@ -927,6 +957,9 @@ type LearningLoopRuntimeConfig = {
 };
 declare function readLearningLoopRuntimeConfig(config: Config): LearningLoopRuntimeConfig;
 //#endregion
+//#region src/configs/agent-runtime.config.d.ts
+declare const DEFAULT_AGENT_RUNTIME_ENTRY_ID = "native";
+//#endregion
 //#region src/features/narp-runtime/services/builtin-narp-runtime-provider.service.d.ts
 declare const NARP_HTTP_RUNTIME_KIND = "narp-http";
 declare const NARP_STDIO_RUNTIME_KIND = "narp-stdio";
@@ -941,7 +974,7 @@ declare class BuiltinNarpRuntimeProviderService {
 //#endregion
 //#region src/features/ncp-dispatch/utils/nextclaw-ncp-runner.utils.d.ts
 type AssetApi = {
-  put: (input: {
+  putBytes: (input: {
     fileName: string;
     mimeType?: string | null;
     bytes: Uint8Array;
@@ -951,48 +984,57 @@ type AssetApi = {
   }>;
   resolveContentPath?: (uri: string) => string | null;
 };
-type NcpRunnerAgent = {
-  run: (envelope: NcpRequestEnvelope, options?: NcpAgentRunSendOptions) => AsyncIterable<NcpEndpointEvent>;
-  assetApi?: AssetApi;
-};
-type RunPromptOverNcpParams = {
-  agent: NcpRunnerAgent;
+type BuildAgentRunSendPayloadParams = {
   sessionId: string;
   content: string;
   attachments?: InboundAttachment[];
   metadata?: Record<string, unknown>;
+  assetApi?: AssetApi;
+};
+type AgentRunReplyOptions = {
   abortSignal?: AbortSignal;
   onAssistantDelta?: (delta: string) => void;
   onEvent?: (event: NcpEndpointEvent) => void;
   missingCompletedMessageError?: string;
   runErrorMessage?: string;
 };
-type StreamPromptOverNcpParams = Omit<RunPromptOverNcpParams, "onAssistantDelta" | "missingCompletedMessageError" | "runErrorMessage">;
+type AgentRunStreamOptions = {
+  abortSignal?: AbortSignal;
+  onEvent?: (event: NcpEndpointEvent) => void;
+};
+type AgentRunReply = {
+  handle: NcpRunHandle;
+  text: string;
+  completedMessage: NcpMessage;
+};
 declare function buildUserMessageParts(params: {
   content: string;
   attachments?: InboundAttachment[];
   assetApi?: AssetApi;
 }): Promise<NcpMessagePart[]>;
-declare function buildNcpUserMessage(params: {
-  sessionId: string;
-  content: string;
-  attachments?: InboundAttachment[];
-  metadata?: Record<string, unknown>;
-  assetApi?: AssetApi;
-}): Promise<NcpMessage>;
-declare function streamPromptOverNcp(params: StreamPromptOverNcpParams): AsyncGenerator<NcpEndpointEvent>;
-declare function runPromptOverNcp(params: RunPromptOverNcpParams): Promise<{
-  text: string;
-  completedMessage: NcpMessage;
-}>;
+declare function buildAgentRunSendPayload(params: BuildAgentRunSendPayloadParams): Promise<AgentRunSendIngressPayload>;
+declare class AgentRunClient {
+  private readonly options;
+  constructor(options: {
+    eventBus: Pick<EventBus, "on">;
+    ingress: Pick<Ingress, "handle">;
+  });
+  send: (input: AgentRunSendIngressPayload) => Promise<NcpRunHandle>;
+  sendAndWaitForReply: (input: AgentRunSendIngressPayload, options?: AgentRunReplyOptions) => Promise<AgentRunReply>;
+  sendAndStreamEvents: (this: AgentRunClient, input: AgentRunSendIngressPayload, options?: AgentRunStreamOptions) => AsyncGenerator<NcpEndpointEvent>;
+  private prepareObserver;
+  private sendWithCorrelation;
+}
 //#endregion
 //#region src/features/ncp-dispatch/services/gateway-inbound-processor.service.d.ts
 type GatewayInboundLoopRuntime = {
   kernel: {
     channels: ChannelManager$1;
-    agentRunRequestManager: NcpRunnerAgent;
+    assetStore: AssetApi;
   };
+  agentRunClient: AgentRunClient;
   messageBus: MessageBus;
+  sessionManager: SessionManager;
   configManager: {
     loadConfig: () => Config;
   };
@@ -1003,6 +1045,7 @@ declare class GatewayInboundProcessor {
   constructor(runtime: GatewayInboundLoopRuntime);
   process: (message: InboundMessage) => Promise<void>;
   private resolveRoute;
+  private dispatchSlashCommandMaybe;
   private dispatchChannelReplyRouteMaybe;
   private publishLegacyReply;
 }
@@ -1020,7 +1063,8 @@ type ResolvedInboundRoute = {
   accountId?: string | null;
 };
 type ChannelReplyRouterDispatchParams = {
-  agent: NcpRunnerAgent;
+  agentRunClient: AgentRunClient;
+  assetApi?: AssetApi;
   route: ChannelReplyRoute;
   sessionId: string;
   content: string;
@@ -1040,7 +1084,7 @@ declare function dispatchChannelReplyRoute(params: ChannelReplyRouterDispatchPar
 //#region src/features/ncp-dispatch/utils/nextclaw-ncp-dispatch.utils.d.ts
 type DirectPromptDispatchParams = {
   config: Config;
-  agentRunRequests: NcpRunnerAgent;
+  agentRunClient: AgentRunClient;
   content: string;
   sessionKey?: string;
   channel?: string;
@@ -1101,6 +1145,42 @@ declare function createAssetTools(params: {
   contentBasePath?: string;
 }): NcpTool[];
 //#endregion
+//#region src/features/native-runtime/utils/nextclaw-ncp-run-context.utils.d.ts
+type NextclawNcpResolvedAgentProfile = {
+  agentId: string;
+  contextTokens: number;
+  execTimeoutSeconds: number;
+  model: string;
+  reservedContextTokens: number;
+  restrictToWorkspace: boolean;
+  searchConfig: Config["search"];
+  workspace: string;
+};
+type NextclawNcpRunContextParams = {
+  configManager: ConfigManager;
+  sessionId: string;
+  requestMetadata?: Record<string, unknown>;
+  sessionMetadata?: Record<string, unknown>;
+  storedAgentId?: string;
+};
+type NextclawNcpResolvedRunContext = {
+  channel: string;
+  chatId: string;
+  config: Config;
+  effectiveModel: string;
+  effectiveWorkspace: string;
+  profile: NextclawNcpResolvedAgentProfile;
+  requestMetadata: Record<string, unknown>;
+  requestedSkills: ReturnType<RequestedSkillsMetadataReader["readSelection"]>;
+  requestedToolNames: string[];
+  runtimeThinking: ReturnType<typeof resolveThinkingLevel>;
+  sessionKey: string;
+  sessionMetadata: Record<string, unknown>;
+  toolRunContext: ToolRunContext;
+};
+declare function buildSessionOrchestrationSection(): string;
+declare function resolveNextclawNcpRunContext(params: NextclawNcpRunContextParams): NextclawNcpResolvedRunContext;
+//#endregion
 //#region src/features/native-runtime/utils/nextclaw-ncp-session-preferences.utils.d.ts
 declare function normalizeOptionalString(value: unknown): string | undefined;
 declare function readMetadataModel(metadata: Record<string, unknown>): string | null;
@@ -1156,5 +1236,5 @@ type SkillRecord = {
   metadata: Record<string, unknown>;
 };
 //#endregion
-export { AgentId, AgentManager, AgentRecord, AgentRunRequestManager, AgentRuntimeEntry, AgentRuntimeManager, AgentRuntimeManagerOptions, AgentRuntimeProviderRegistration, AgentRuntimeRegistry, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, AutomationId, AutomationManager, AutomationManagerOptions, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelId, ChannelManager, ChannelReplyRouterDispatchParams, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionManager, ContextCompactionTimelineCheckpoint, ContextWindowPreviewManager, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DirectPromptDispatchParams, ExtensionLoadProgress, ExtensionLoadResult, ExtensionManager, ExtensionPluginLoadProgress, ExtensionPluginRegistryService, GatewayInboundLoopRuntime, GatewayInboundProcessor, InstallationKind, InstalledSkillDetail, InstalledSkillSummary, InstalledSkillsList, type LearningLoopRuntimeConfig, LlmProviderManager, LlmProviderRuntime, LlmUsageManager, LlmUsageManagerOptions, LlmUsageRecord, LlmUsageSnapshot, LlmUsageStats, LlmUsageStore, LlmUsageStoreOptions, LlmUsageSummary, LocalizedTextMap, McpManager, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NativeAgentRuntimeFactory, NativeAgentRuntimeFactoryOptions, NativeRuntimeFactory, NcpAgentSessionJournalStore, NcpRunnerAgent, NcpSessionManager, NcpSessionManagerOptions, NextclawKernel, NextclawKernelOptions, NextclawNcpContextBuilder, ProviderManagerNcpLLMApi, RunPromptOverNcpParams, SessionId, SessionRequestManager, SessionRequestManagerOptions, SessionRunManager, SkillFrontmatter, SkillId, type SkillInfo, SkillManager, SkillRecord, type SkillScope, StreamPromptOverNcpParams, TaskId, ToolId, ToolManager, ToolProvider, ToolRecord, ToolRegistrationContext, ToolRunContext, ToolRuntimeRegistry, ToolRuntimeRegistryOptions, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdatePreferences, UpdateProgress, UpdateSnapshot, UpdateStatus, UpdateToolCallResult, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNcpUserMessage, buildUserMessageParts, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createLlmUsageRecord, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getUnsignedUpdateManifest, hasLlmUsageTelemetry, isContextCompactionTimelineMessage, isReplyCapableChannel, listExtensionChannelIds, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseSkillFrontmatter, projectNcpMessagesWithContextCompaction, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, resolveAgentHandoffDepth, resolveAgentRuntimeEntries, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, runPromptOverNcp, sanitizeLlmUsage, serializeUnsignedUpdateManifest, streamPromptOverNcp, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, upsertContextCompactionTimelineMessage, waitForAgentRuntimeSessionReply };
+export { AgentId, AgentManager, AgentRecord, AgentRunClient, AgentRunReply, AgentRunReplyOptions, AgentRunRequestManager, AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeManager, AgentRuntimeManagerOptions, AgentRuntimeProviderRegistration, AgentRuntimeRegistry, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, AssetApi, AutomationId, AutomationManager, AutomationManagerOptions, BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelId, ChannelManager, ChannelReplyRouterDispatchParams, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionManager, ContextCompactionPreflightBeginResult, ContextCompactionPreflightResult, ContextCompactionPreflightService, ContextCompactionTimelineCheckpoint, ContextWindowPreviewManager, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DirectPromptDispatchParams, ExtensionLoadProgress, ExtensionLoadResult, ExtensionManager, GatewayInboundLoopRuntime, GatewayInboundProcessor, InstallationKind, InstalledSkillDetail, InstalledSkillSummary, InstalledSkillsList, type LearningLoopRuntimeConfig, LlmProviderManager, LlmProviderRuntime, LlmUsageManager, LlmUsageManagerOptions, LlmUsageRecord, LlmUsageSnapshot, LlmUsageStats, LlmUsageStore, LlmUsageStoreOptions, LlmUsageSummary, LocalizedTextMap, McpManager, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NativeAgentRuntimeFactory, NativeAgentRuntimeFactoryOptions, NativeRuntimeFactory, NcpAgentSessionJournalStore, NcpSessionManager, NcpSessionManagerOptions, NextclawKernel, NextclawKernelOptions, NextclawNcpContextBuilder, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextParams, ProviderManagerNcpLLMApi, SessionId, SessionRequestManager, SessionRequestManagerOptions, SessionRunManager, SkillFrontmatter, SkillId, type SkillInfo, SkillManager, SkillRecord, type SkillScope, TaskId, ToolId, ToolManager, ToolProvider, ToolRecord, ToolRegistrationContext, ToolRunContext, ToolRuntimeRegistry, ToolRuntimeRegistryOptions, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdatePreferences, UpdateProgress, UpdateSnapshot, UpdateStatus, UpdateToolCallResult, buildAgentRunSendPayload, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildSessionOrchestrationSection, buildUserMessageParts, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextWindowSignature, createLlmUsageRecord, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getUnsignedUpdateManifest, hasLlmUsageTelemetry, isContextCompactionTimelineMessage, isContextWindowSnapshot, isReplyCapableChannel, listExtensionChannelIds, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseSkillFrontmatter, projectNcpMessagesWithContextCompaction, readContextWindowEventSessionId, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, resolveAgentHandoffDepth, resolveAgentRuntimeEntries, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveNextclawNcpRunContext, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, upsertContextCompactionTimelineMessage, waitForAgentRuntimeSessionReply };
 //# sourceMappingURL=index.d.ts.map