@nextclaw/kernel 0.1.15-beta.6 → 0.1.15

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 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 { AgentRouteResolver, BaseChannel, ChannelManager, ChannelManager as ChannelManager$1, Config, ContextCompactionPlan, ContextWindowSnapshot, CreateSessionInput, CreatedSession, CronService, Disposable, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, 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, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
-import { AgentRunSendIngressPayload, EventBus, Ingress, Unsubscribe } from "@nextclaw/shared";
-import { ListMessagesOptions, ListSessionsOptions, NcpAgentRuntime, NcpEndpointEvent, NcpEventType, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpRunHandle, NcpSessionApi, NcpSessionPatch, NcpSessionSummary, NcpTool, OpenAIChatChunk } from "@nextclaw/ncp";
+import { ListMessagesOptions, ListSessionsOptions, NcpAgentConversationStateManager, NcpAgentRuntime, NcpEndpointEvent, NcpEventType, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessagePart, NcpRunHandle, NcpSessionApi, NcpSessionPatch, NcpSessionSummary, NcpTool, OpenAIChatChunk } from "@nextclaw/ncp";
+import { BaseChannel, ChannelManager, ChannelManager as ChannelManager$1, Config, ContextCompactionPlan, ContextWindowSnapshot, CreateSessionInput, CreatedSession, CronService, Disposable, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, ExtensionUiMetadata, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, RequestSessionParams, RequestedSkillsMetadataReader, SearchConfig, Session, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchManager, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
 import { LocalAssetStore } from "@nextclaw/ncp-agent-runtime";
+import { AgentRunSendIngressPayload, EventBus, Ingress, Unsubscribe } from "@nextclaw/shared";
 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";
@@ -128,14 +129,6 @@ declare class AgentManager {
   detachTool: (agentId: AgentId, toolId: ToolId) => never;
 }
 //#endregion
-//#region src/managers/automation.manager.d.ts
-type AutomationManagerOptions = {
-  storePath: string;
-};
-declare class AutomationManager extends CronService {
-  constructor(options: AutomationManagerOptions);
-}
-//#endregion
 //#region src/managers/llm-provider.manager.d.ts
 type ProviderChatParams = {
   messages: Array<Record<string, unknown>>;
@@ -257,6 +250,339 @@ declare class ConfigManager {
   private createConfigMutationResult;
 }
 //#endregion
+//#region src/utils/ncp-agent-session-journal.utils.d.ts
+declare const NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE = "session.snapshot.message";
+declare const NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE = "session.request.accepted";
+declare const NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE = "session.request.completed";
+declare const NCP_SESSION_REQUEST_FAILED_EVENT_TYPE = "session.request.failed";
+type NcpAgentSessionSnapshotMessageEvent = {
+  type: typeof NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE;
+  payload: Extract<NcpEndpointEvent, {
+    type: NcpEventType.MessageSent;
+  }>["payload"];
+};
+type NcpSessionRequestJournalEventType = typeof NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_FAILED_EVENT_TYPE;
+type NcpSessionRequestJournalEvent = {
+  type: NcpSessionRequestJournalEventType;
+  payload: {
+    sessionId: string;
+    request: unknown;
+  };
+};
+type NcpAgentSessionJournalReplayEvent = NcpEndpointEvent | NcpAgentSessionSnapshotMessageEvent | NcpSessionRequestJournalEvent;
+//#endregion
+//#region src/stores/ncp-agent-session-journal.store.d.ts
+declare class NcpAgentSessionJournalStore {
+  private readonly journalDir;
+  private readonly sessions;
+  private readonly nextSeqBySession;
+  private readonly writeChains;
+  private readonly metadataStore;
+  private readonly summaryIndexStore;
+  constructor(journalDir: string);
+  appendSessionEvent: (params: {
+    sessionId: string;
+    event: NcpAgentSessionJournalReplayEvent;
+  }) => Promise<void>;
+  getSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
+  listSessionSummaries: () => Promise<NcpSessionSummary[]>;
+  listSessionMessages: (sessionId: string) => Promise<NcpMessage[]>;
+  setSessionMetadata: (params: {
+    sessionId: string;
+    metadata: Record<string, unknown>;
+  }) => Promise<boolean>;
+  updateSessionMetadata: (params: {
+    sessionId: string;
+    metadata: Record<string, unknown>;
+  }) => Promise<boolean>;
+  private setSessionMetadataNow;
+  private updateSessionMetadataNow;
+  importSessionSnapshot: (record: AgentSessionRecord) => Promise<void>;
+  deleteSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
+  hasSession: (sessionId: string) => Promise<boolean>;
+  private appendSessionEventNow;
+  private withMetadata;
+  private loadSession;
+  private parseSessionJournal;
+  private appendJournalEntry;
+  private ensureJournalDir;
+  private sessionPath;
+}
+//#endregion
+//#region src/types/agent-run.types.d.ts
+type ThinkingEffort = string;
+type ContextBlock = string;
+type AgentRunRequest = {
+  sessionId?: string;
+  peerId?: string;
+  message: NcpMessage;
+  agentRuntimeId?: string;
+  agentId?: string;
+  projectRoot?: string;
+  channel?: string;
+  correlationId?: string;
+  metadata?: Record<string, unknown>;
+  model?: string;
+  maxTokens?: number;
+  thinkingEffort?: ThinkingEffort | null;
+};
+type AgentRunSpec = {
+  runId: string;
+  agentId: string;
+  model: string;
+  maxTokens?: number;
+  thinkingEffort?: ThinkingEffort | null;
+  correlationId?: string;
+};
+type ContextProvider = {
+  provide: (request: AgentRunRequest) => Promise<readonly ContextBlock[]> | readonly ContextBlock[];
+};
+type ToolProvider = {
+  provide: (request: AgentRunRequest) => Promise<readonly NcpTool[]> | readonly NcpTool[];
+};
+//#endregion
+//#region src/types/session.types.d.ts
+type AgentRunSession = {
+  sessionId: string;
+  agentId?: string;
+  agentRuntimeId: string;
+  metadata: Record<string, unknown>;
+  model?: string;
+  projectRoot?: string;
+  thinkingEffort?: ThinkingEffort | null;
+};
+type CreateAgentRunSessionParams = {
+  sessionId?: string;
+  peerId?: string;
+  agentId?: string;
+  agentRuntimeId?: string;
+  channel?: string;
+  metadata?: Record<string, unknown>;
+  model?: string;
+  projectRoot?: string;
+  task?: string;
+  thinkingEffort?: ThinkingEffort | null;
+};
+//#endregion
+//#region src/managers/session.manager.d.ts
+type CreateNcpSessionInput = CreateSessionInput & {
+  sessionId?: string;
+};
+type SessionManagerOptions = {
+  configManager: ConfigManager;
+  eventBus: EventBus;
+  journalStore: NcpAgentSessionJournalStore;
+  sessionSearch: SessionSearchManager;
+};
+declare class SessionManager implements NcpSessionApi {
+  private readonly options;
+  readonly cleanups: Array<() => void>;
+  private readonly contextWindowPreview;
+  private started;
+  constructor(options: SessionManagerOptions);
+  start: () => void;
+  dispose: () => void;
+  createSession: (params: CreateNcpSessionInput) => Promise<CreatedSession>;
+  appendSessionEvent: (params: {
+    sessionId: string;
+    event: NcpAgentSessionJournalReplayEvent;
+  }) => Promise<void>;
+  setSessionMetadata: (sessionId: string, metadata: Record<string, unknown>) => Promise<boolean>;
+  updateSessionMetadata: (sessionId: string, metadata: Record<string, unknown>) => Promise<boolean>;
+  updateSession: (sessionId: string, patch: NcpSessionPatch) => Promise<NcpSessionSummary | null>;
+  deleteSession: (sessionId: string) => Promise<void>;
+  getSessionRecord: (sessionId: string) => Promise<AgentSessionRecord | null>;
+  listSessions: (options?: ListSessionsOptions) => Promise<NcpSessionSummary[]>;
+  listSessionMessages: (sessionId: string, options?: ListMessagesOptions) => Promise<NcpMessage[]>;
+  getSession: (sessionId: string) => Promise<NcpSessionSummary | null>;
+  getContextWindow: (sessionId: string, liveRecord?: AgentSessionRecord | null) => Promise<Record<string, unknown> | null>;
+  getAgentRunSession: (sessionId: string) => Promise<AgentRunSession>;
+  createAgentRunSession: (params: CreateAgentRunSessionParams) => Promise<AgentRunSession>;
+  getOrCreateAgentRunSession: (params: CreateAgentRunSessionParams) => Promise<AgentRunSession>;
+  patchSessionMetadata: (sessionId: string, patch: Record<string, unknown>) => Promise<void>;
+  clearSessionMessages: (sessionId: string) => Promise<number>;
+  publishSessionChange: (sessionKey: string) => Promise<void>;
+  private createSummaryFromRecord;
+  private publishSessionMetadataChanged;
+}
+//#endregion
+//#region src/managers/agent-run-context-compaction.manager.d.ts
+type AgentRunContextCompactionInput = {
+  sessionId: string;
+  agentId: string;
+  messages: readonly NcpMessage[];
+  metadata: Record<string, unknown>;
+};
+declare class AgentRunContextCompactionManager {
+  private readonly sessionManager;
+  private readonly preflightService;
+  constructor(configManager: ConfigManager, providerManager: LlmProviderRuntime, sessionManager: SessionManager);
+  runPreflight: (input: AgentRunContextCompactionInput) => Promise<readonly NcpEndpointEvent[]>;
+  private toEvents;
+}
+//#endregion
+//#region src/managers/session-run.manager.d.ts
+type SessionRunSnapshot = {
+  messages: readonly NcpMessage[];
+};
+type SessionRunSeed = {
+  sessionId: string;
+  messages: readonly NcpMessage[];
+};
+type SessionRunEventPublishMeta = {
+  emittedAt?: string;
+  source: string;
+};
+type SessionRunActiveRun = {
+  runId: string;
+  signal: AbortSignal;
+};
+declare class MessageInbox<T> {
+  private readonly messages;
+  enqueue: (message: T) => void;
+  drain: () => T[];
+  isEmpty: () => boolean;
+}
+declare class SessionRun {
+  private readonly eventBus?;
+  private readonly stateManager;
+  readonly inbox: MessageInbox<NcpMessage>;
+  readonly sessionId: string;
+  private activeRunId;
+  private activeRunController;
+  constructor(seed: SessionRunSeed, eventBus?: EventBus | undefined, stateManager?: NcpAgentConversationStateManager);
+  getSnapshot: () => SessionRunSnapshot;
+  applyEvents: (events: readonly NcpEndpointEvent[]) => Promise<void>;
+  applyAndPublishEvents: (events: readonly NcpEndpointEvent[], meta: SessionRunEventPublishMeta) => Promise<void>;
+  beginRun: () => SessionRunActiveRun;
+  abortRun: (runId?: string) => boolean;
+  isRunning: () => boolean;
+  dispose: () => void;
+  private applyRunEvents;
+}
+declare class SessionRunManager {
+  private readonly sessionManager;
+  private readonly eventBus?;
+  private readonly runs;
+  constructor(sessionManager: SessionManager, eventBus?: EventBus | undefined);
+  getSessionRun: (sessionId: string) => SessionRun | null;
+  isSessionRunning: (sessionId: string) => boolean;
+  createSessionRun: (sessionId: string) => Promise<SessionRun>;
+  deleteSessionRun: (sessionId: string) => boolean;
+  dispose: () => void;
+}
+//#endregion
+//#region src/managers/agent-runtime.manager.d.ts
+type AgentRuntimeRunOptions = {
+  sessionRun: SessionRun;
+  contextBlocks: readonly ContextBlock[];
+  tools: readonly NcpTool[];
+  signal?: AbortSignal;
+};
+type AgentRuntime = {
+  run: (spec: AgentRunSpec, options: AgentRuntimeRunOptions) => AsyncIterable<NcpEndpointEvent>;
+  dispose?: () => Promise<void> | void;
+};
+type AgentRuntimeRegistration = {
+  kind: string;
+  label: string;
+  defaultReuseScope: AgentRuntimeReuseScope;
+  createRuntime: (params: AgentRuntimeCreateParams) => AgentRuntime;
+  describeSessionTypeForEntry?: (params: {
+    entry: AgentRuntimeEntry;
+    describeParams?: AgentRuntimeSessionTypeDescribeParams;
+  }) => Promise<Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined> | Omit<AgentRuntimeSessionTypeOption, "value" | "label"> | null | undefined;
+};
+type AgentRuntimeReuseScope = "global" | "session";
+type AgentRuntimeCreateParams = {
+  entry: AgentRuntimeEntry;
+  session: AgentRunSession;
+  sessionRun: SessionRun;
+};
+type AgentRuntimeCacheParams = {
+  agentRuntimeId: string;
+  session: AgentRunSession;
+  sessionRun: SessionRun;
+};
+declare class AgentRuntimeManager {
+  private readonly providers;
+  private readonly entries;
+  private readonly globalRuntimes;
+  private readonly sessionRuntimes;
+  register: (registration: AgentRuntimeRegistration) => (() => Promise<void>);
+  applyEntries: (entries: readonly AgentRuntimeEntry[]) => void;
+  getOrCreate: (params: AgentRuntimeCacheParams) => AgentRuntime;
+  listSessionTypes: (_params?: AgentRuntimeSessionTypeDescribeParams) => Promise<{
+    defaultType: string;
+    options: AgentRuntimeSessionTypeOption[];
+  }>;
+  dispose: () => Promise<void>;
+  private normalizeId;
+  private getEntry;
+  private getProvider;
+  private resolveReuseScope;
+  private disposeAllRuntimes;
+}
+//#endregion
+//#region src/managers/context-provider.manager.d.ts
+declare class ContextProviderManager {
+  private readonly providers;
+  register: (provider: ContextProvider) => (() => void);
+  buildContext: (request: AgentRunRequest) => Promise<readonly ContextBlock[]>;
+  dispose: () => void;
+}
+//#endregion
+//#region src/managers/tool-provider.manager.d.ts
+type ToolRunContext = {
+  agentId: string;
+  channel: string;
+  chatId: string;
+  config: Config;
+  execTimeoutSeconds: number;
+  handoffDepth: number;
+  metadata: Record<string, unknown>;
+  restrictToWorkspace: boolean;
+  searchConfig: SearchConfig;
+  sessionId: string;
+  workspace: string;
+};
+declare class ToolProviderManager {
+  private readonly providers;
+  register: (provider: ToolProvider) => (() => void);
+  buildTools: (request: AgentRunRequest) => Promise<readonly NcpTool[]>;
+  dispose: () => void;
+}
+//#endregion
+//#region src/managers/agent-run-request.manager.d.ts
+declare class AgentRunRequestManager {
+  private readonly agentRuntimeManager;
+  private readonly configManager;
+  private readonly contextProviderManager;
+  private readonly eventBus;
+  private readonly ingress;
+  private readonly sessionManager;
+  private readonly sessionRunManager;
+  private readonly toolProviderManager;
+  readonly cleanups: Array<() => void>;
+  private started;
+  constructor(agentRuntimeManager: AgentRuntimeManager, configManager: ConfigManager, contextProviderManager: ContextProviderManager, eventBus: EventBus, ingress: Ingress, sessionManager: SessionManager, sessionRunManager: SessionRunManager, toolProviderManager: ToolProviderManager);
+  start: () => void;
+  dispose: () => void;
+  private handleSendRequest;
+  private handleAbortRequest;
+  private handleSessionMessageRequest;
+  private send;
+  private abort;
+}
+//#endregion
+//#region src/managers/automation.manager.d.ts
+type AutomationManagerOptions = {
+  storePath: string;
+};
+declare class AutomationManager extends CronService {
+  constructor(options: AutomationManagerOptions);
+}
+//#endregion
 //#region src/managers/extension.manager.d.ts
 type ExtensionLoadProgress = {
   extensionId: string;
@@ -417,99 +743,6 @@ declare class McpManager {
   private prewarmEnabledServersSafely;
 }
 //#endregion
-//#region src/utils/ncp-agent-session-journal.utils.d.ts
-declare const NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE = "session.snapshot.message";
-declare const NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE = "session.request.accepted";
-declare const NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE = "session.request.completed";
-declare const NCP_SESSION_REQUEST_FAILED_EVENT_TYPE = "session.request.failed";
-type NcpAgentSessionSnapshotMessageEvent = {
-  type: typeof NCP_AGENT_SESSION_SNAPSHOT_MESSAGE_EVENT_TYPE;
-  payload: Extract<NcpEndpointEvent, {
-    type: NcpEventType.MessageSent;
-  }>["payload"];
-};
-type NcpSessionRequestJournalEventType = typeof NCP_SESSION_REQUEST_ACCEPTED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_COMPLETED_EVENT_TYPE | typeof NCP_SESSION_REQUEST_FAILED_EVENT_TYPE;
-type NcpSessionRequestJournalEvent = {
-  type: NcpSessionRequestJournalEventType;
-  payload: {
-    sessionId: string;
-    request: unknown;
-  };
-};
-type NcpAgentSessionJournalReplayEvent = NcpEndpointEvent | NcpAgentSessionSnapshotMessageEvent | NcpSessionRequestJournalEvent;
-//#endregion
-//#region src/stores/ncp-agent-session-journal.store.d.ts
-declare class NcpAgentSessionJournalStore {
-  private readonly journalDir;
-  private readonly sessions;
-  private readonly nextSeqBySession;
-  private readonly writeChains;
-  private readonly metadataStore;
-  private readonly summaryIndexStore;
-  constructor(journalDir: string);
-  appendSessionEvent: (params: {
-    sessionId: string;
-    event: NcpAgentSessionJournalReplayEvent;
-  }) => Promise<void>;
-  getSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
-  listSessionSummaries: () => Promise<NcpSessionSummary[]>;
-  listSessionMessages: (sessionId: string) => Promise<NcpMessage[]>;
-  setSessionMetadata: (params: {
-    sessionId: string;
-    metadata: Record<string, unknown>;
-  }) => Promise<boolean>;
-  updateSessionMetadata: (params: {
-    sessionId: string;
-    metadata: Record<string, unknown>;
-  }) => Promise<boolean>;
-  private setSessionMetadataNow;
-  private updateSessionMetadataNow;
-  importSessionSnapshot: (record: AgentSessionRecord) => Promise<void>;
-  deleteSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
-  hasSession: (sessionId: string) => Promise<boolean>;
-  private appendSessionEventNow;
-  private withMetadata;
-  private loadSession;
-  private parseSessionJournal;
-  private appendJournalEntry;
-  private ensureJournalDir;
-  private sessionPath;
-}
-//#endregion
-//#region src/managers/ncp-session.manager.d.ts
-type CreateNcpSessionInput = CreateSessionInput & {
-  sessionId?: string;
-};
-type NcpSessionManagerOptions = {
-  configManager: ConfigManager;
-  eventBus: EventBus;
-  journalStore: NcpAgentSessionJournalStore;
-  sessionSearch: SessionSearchManager;
-};
-declare class NcpSessionManager implements NcpSessionApi {
-  private readonly options;
-  private readonly contextWindowPreview;
-  constructor(options: NcpSessionManagerOptions);
-  dispose: () => void;
-  createSession: (params: CreateNcpSessionInput) => Promise<CreatedSession>;
-  appendSessionEvent: (params: {
-    sessionId: string;
-    event: NcpAgentSessionJournalReplayEvent;
-  }) => Promise<void>;
-  setSessionMetadata: (sessionId: string, metadata: Record<string, unknown>) => Promise<boolean>;
-  updateSessionMetadata: (sessionId: string, metadata: Record<string, unknown>) => Promise<boolean>;
-  updateSession: (sessionId: string, patch: NcpSessionPatch) => Promise<NcpSessionSummary | null>;
-  deleteSession: (sessionId: string) => Promise<void>;
-  getSessionRecord: (sessionId: string) => Promise<AgentSessionRecord | null>;
-  listSessions: (options?: ListSessionsOptions) => Promise<NcpSessionSummary[]>;
-  listSessionMessages: (sessionId: string, options?: ListMessagesOptions) => Promise<NcpMessage[]>;
-  getSession: (sessionId: string) => Promise<NcpSessionSummary | null>;
-  getContextWindow: (sessionId: string, liveRecord?: AgentSessionRecord | null) => Promise<Record<string, unknown> | null>;
-  publishSessionChange: (sessionKey: string) => Promise<void>;
-  private createSummaryFromRecord;
-  private publishSessionMetadataChanged;
-}
-//#endregion
 //#region src/stores/panel-app-state.store.d.ts
 type PanelAppPreferencesUpdate = {
   favorite?: boolean;
@@ -589,15 +822,81 @@ type ServiceActionGrantRequest = {
   declaredActions: string[];
 };
 //#endregion
+//#region src/types/panel-app.types.d.ts
+type PanelAppErrorCode = "AGENT_OBJECT_REQUEST_FAILED" | "AGENT_OBJECT_RESULT_NOT_SUBMITTED" | "AGENT_OBJECT_RESULT_SCHEMA_INVALID" | "AGENT_OBJECT_RESULT_TIMEOUT" | "AUTHORIZATION_REQUIRED" | "PANEL_APP_AGENT_REQUEST_INVALID" | "PANEL_APP_BRIDGE_SESSION_NOT_FOUND" | "PANEL_APP_CAPABILITY_NOT_DECLARED" | "PANEL_APP_INVALID_ASSET_PATH" | "PANEL_APP_INVALID_ID" | "PANEL_APP_MANIFEST_INVALID" | "PANEL_APP_NOT_FOUND" | "PANEL_APP_READ_FAILED";
+declare class PanelAppError extends Error {
+  readonly code: PanelAppErrorCode;
+  constructor(code: PanelAppErrorCode, message: string);
+}
+declare function isPanelAppError(error: unknown): error is PanelAppError;
+declare const PANEL_APP_AGENT_CAPABILITIES: readonly ["agent:send", "agent:generateObject"];
+type PanelAppAgentCapability = typeof PANEL_APP_AGENT_CAPABILITIES[number];
+declare function isPanelAppAgentCapability(value: unknown): value is PanelAppAgentCapability;
+type PanelAppCapabilityGrantCaller = {
+  surface: "panel-app";
+  appId: string;
+};
+type PanelAppCapabilityGrant = {
+  caller: PanelAppCapabilityGrantCaller;
+  capability: PanelAppAgentCapability;
+  grantedAt: string;
+};
+type PanelAppAgentSendPayload = {
+  sessionId?: string;
+  peerId?: string;
+  content: NcpMessagePart[];
+  message?: never;
+  metadata?: Record<string, unknown>;
+} | {
+  sessionId?: string;
+  peerId?: string;
+  message: NcpMessage | (Omit<NcpMessage, "sessionId"> & {
+    sessionId?: string;
+  });
+  content?: never;
+  metadata?: Record<string, unknown>;
+};
+type PanelAppAgentSendRequest = {
+  payload: PanelAppAgentSendPayload;
+};
+type PanelAppAgentSendResult = NcpRunHandle;
+type PanelAppAgentRunClient = {
+  send: (input: AgentRunSendIngressPayload) => Promise<NcpRunHandle>;
+  sendAndStreamEvents: (input: AgentRunSendIngressPayload) => AsyncGenerator<NcpEndpointEvent>;
+};
+type PanelAppAgentGenerateObjectInput = {
+  peerId: string;
+  prompt: string;
+  context?: unknown;
+  schema: Record<string, unknown>;
+  title?: string;
+  timeoutMs?: number;
+};
+type PanelAppAgentGenerateObjectRequest = {
+  input: PanelAppAgentGenerateObjectInput;
+};
+type PanelAppAgentGenerateObjectResult = {
+  result: unknown;
+};
+//#endregion
+//#region src/utils/panel-app-source.utils.d.ts
+type PanelAppAssetContentType = "application/javascript; charset=utf-8" | "application/json; charset=utf-8" | "application/octet-stream" | "image/png" | "image/svg+xml; charset=utf-8" | "image/webp" | "text/css; charset=utf-8" | "text/plain; charset=utf-8";
+type PanelAppAsset = {
+  content: Buffer;
+  contentType: PanelAppAssetContentType;
+};
+//#endregion
 //#region src/managers/panel-app.manager.d.ts
 declare const PANEL_APP_CONTENT_TYPE: "text/html; charset=utf-8";
 type PanelAppEntry = {
   id: string;
   fileName: string;
+  kind: "single-file" | "folder";
   title: string;
   description?: string;
   icon?: string;
   contentPath: string;
+  createdAt: string;
   updatedAt: string;
   sizeBytes: number;
   favorite: boolean;
@@ -614,32 +913,39 @@ type PanelAppContent = {
   fileName: string;
   html: string;
   contentType: typeof PANEL_APP_CONTENT_TYPE;
+  capabilities: string[];
   serviceActions: string[];
 };
+type PanelAppDeleteResult = {
+  deleted: true;
+  fileName: string;
+  id: string;
+};
 type PanelAppBridgeSession = {
   id: string;
   token: string;
   panelAppId: string;
   tabId: string;
   caller: ServiceActionCaller;
+  declaredCapabilities: string[];
   declaredActions: string[];
   createdAt: string;
   expiresAt: string;
 };
-type PanelAppErrorCode = "PANEL_APP_BRIDGE_SESSION_NOT_FOUND" | "PANEL_APP_INVALID_ID" | "PANEL_APP_NOT_FOUND" | "PANEL_APP_READ_FAILED";
-declare class PanelAppError extends Error {
-  readonly code: PanelAppErrorCode;
-  constructor(code: PanelAppErrorCode, message: string);
-}
-declare function isPanelAppError(error: unknown): error is PanelAppError;
 declare class PanelAppManager {
   private readonly params;
   private readonly bridgeSessions;
+  private readonly agentRunClient;
+  private readonly sourceService;
   constructor(params: {
+    agentRunClient?: PanelAppAgentRunClient;
     configManager: ConfigManager;
+    eventBus?: EventBus;
+    ingress?: Ingress;
   });
   listPanelApps: () => Promise<PanelAppList>;
   getPanelAppContent: (id: string) => Promise<PanelAppContent>;
+  getPanelAppAsset: (id: string, assetPath: string) => Promise<PanelAppAsset>;
   getPanelAppBridgeScript: () => string;
   createPanelAppBridgeSession: (params: {
     id: string;
@@ -647,21 +953,25 @@ declare class PanelAppManager {
   }) => Promise<PanelAppBridgeSession>;
   resolvePanelAppBridgeSession: (token: string) => PanelAppBridgeSession;
   deletePanelAppBridgeSession: (token: string) => void;
+  sendAgentMessage: (bridgeSessionToken: string, payload: PanelAppAgentSendPayload) => Promise<PanelAppAgentSendResult>;
+  generateAgentObject: (bridgeSessionToken: string, input: PanelAppAgentGenerateObjectInput) => Promise<PanelAppAgentGenerateObjectResult>;
+  grantAgentCapability: (bridgeSessionToken: string, capability: PanelAppAgentCapability) => Promise<PanelAppCapabilityGrant>;
   updatePanelAppPreferences: (id: string, preferences: PanelAppPreferencesUpdate) => Promise<PanelAppEntry>;
   recordPanelAppOpened: (id: string) => Promise<PanelAppEntry>;
+  deletePanelApp: (id: string) => Promise<PanelAppDeleteResult>;
+  private assertAgentCapabilityGranted;
+  private assertDeclaredCapability;
+  private describeMissingAgentCapability;
+  private requireAgentRunClient;
   private getWorkspacePath;
   private getPanelsPath;
   private createStateStore;
-  private listPanelAppFileNames;
+  private createCapabilityGrantStore;
   private buildPanelAppEntry;
   private resolvePanelAppFileName;
-  private encodePanelAppId;
-  private decodePanelAppId;
-  private isPanelAppFileName;
-  private toPanelAppTitle;
   private comparePanelApps;
-  private compareIsoDesc;
   private deleteExpiredBridgeSessions;
+  private deleteBridgeSessionsByPanelAppId;
   private isMissingFileError;
 }
 //#endregion
@@ -829,7 +1139,7 @@ declare class SkillManager {
 //#region src/features/session-request/managers/session-request.manager.d.ts
 type SessionRequestManagerOptions = {
   dispatcher: SessionRequestDispatcher;
-  ncpSessionManager: NcpSessionManager;
+  sessionManager: SessionManager;
 };
 declare class SessionRequestManager {
   private readonly options;
@@ -892,7 +1202,6 @@ declare class NextclawKernel {
   readonly llmUsage: LlmUsageManager;
   readonly configManager: ConfigManager;
   readonly agents: AgentManager;
-  readonly sessions: SessionManager;
   readonly control: NextclawKernelControlManager<unknown, unknown, unknown>;
   readonly skills: SkillManager;
   readonly automation: AutomationManager;
@@ -901,13 +1210,17 @@ declare class NextclawKernel {
   readonly sessionSearch: SessionSearchManager;
   readonly assetStore: LocalAssetStore;
   readonly mcpManager: McpManager;
-  readonly ncpSessionManager: NcpSessionManager;
+  readonly sessionManager: SessionManager;
   readonly panelAppManager: PanelAppManager;
   readonly serviceAppManager: ServiceAppManager;
   readonly extensions: ExtensionManager;
+  readonly agentRuntimeManager: AgentRuntimeManager;
+  readonly contextCompactionManager: AgentRunContextCompactionManager;
+  readonly contextProviderManager: ContextProviderManager;
+  readonly sessionRunManager: SessionRunManager;
+  readonly toolProviderManager: ToolProviderManager;
+  readonly agentRunRequestManager: AgentRunRequestManager;
   private readonly ncpAgentSessionJournalStore;
-  private readonly kernelBranch;
-  private readonly agentRunContribution;
   private readonly contributions;
   private gatewayController;
   constructor(options?: NextclawKernelOptions);
@@ -944,22 +1257,28 @@ declare class BuiltinNarpRuntimeProviderService {
   private createStdioRuntime;
 }
 //#endregion
-//#region src/features/agent-run/managers/tool-provider.manager.d.ts
-type ToolRunContext = {
-  agentId: string;
-  channel: string;
-  chatId: string;
-  config: Config;
-  execTimeoutSeconds: number;
-  handoffDepth: number;
-  metadata: Record<string, unknown>;
-  restrictToWorkspace: boolean;
-  searchConfig: SearchConfig;
+//#region src/utils/agent-run-send-payload.utils.d.ts
+type AssetApi = {
+  putBytes: (input: {
+    fileName: string;
+    mimeType?: string | null;
+    bytes: Uint8Array;
+    createdAt?: Date;
+  }) => Promise<{
+    uri: string;
+  }>;
+  resolveContentPath?: (uri: string) => string | null;
+};
+type BuildAgentRunSendPayloadParams = {
   sessionId: string;
-  workspace: string;
+  content: string;
+  attachments?: InboundAttachment[];
+  metadata?: Record<string, unknown>;
+  assetApi?: AssetApi;
 };
+declare function buildAgentRunSendPayload(params: BuildAgentRunSendPayloadParams): Promise<AgentRunSendIngressPayload>;
 //#endregion
-//#region src/features/agent-run/services/agent-run-client.service.d.ts
+//#region src/services/agent-run-client.service.d.ts
 type AgentRunReplyOptions = {
   abortSignal?: AbortSignal;
   onAssistantDelta?: (delta: string) => void;
@@ -989,27 +1308,6 @@ declare class AgentRunClient {
   private sendWithCorrelation;
 }
 //#endregion
-//#region src/features/agent-run/utils/agent-run-send-payload.utils.d.ts
-type AssetApi = {
-  putBytes: (input: {
-    fileName: string;
-    mimeType?: string | null;
-    bytes: Uint8Array;
-    createdAt?: Date;
-  }) => Promise<{
-    uri: string;
-  }>;
-  resolveContentPath?: (uri: string) => string | null;
-};
-type BuildAgentRunSendPayloadParams = {
-  sessionId: string;
-  content: string;
-  attachments?: InboundAttachment[];
-  metadata?: Record<string, unknown>;
-  assetApi?: AssetApi;
-};
-declare function buildAgentRunSendPayload(params: BuildAgentRunSendPayloadParams): Promise<AgentRunSendIngressPayload>;
-//#endregion
 //#region src/features/ncp-dispatch/services/gateway-inbound-processor.service.d.ts
 type GatewayInboundLoopRuntime = {
   kernel: {
@@ -1081,6 +1379,53 @@ type DirectPromptDispatchParams = {
 };
 declare function dispatchPromptOverNcp(params: DirectPromptDispatchParams): Promise<string>;
 //#endregion
+//#region src/services/command-registry.service.d.ts
+type CommandOptionType = "string" | "boolean" | "number";
+type CommandOption = {
+  name: string;
+  description: string;
+  type: CommandOptionType;
+  required?: boolean;
+};
+type CommandExecutionContext = {
+  channel: string;
+  chatId: string;
+  senderId: string;
+  sessionKey?: string;
+};
+type CommandResult = {
+  content: string;
+  ephemeral?: boolean;
+};
+type ParsedTextCommand = {
+  name: string;
+  args: Record<string, unknown>;
+};
+type SlashCommandSpec = {
+  name: string;
+  description: string;
+  options?: CommandOption[];
+};
+declare class CommandRegistry {
+  private readonly config;
+  private readonly sessionManager?;
+  private readonly specs;
+  private readonly lookup;
+  constructor(config: Config, sessionManager?: SessionManager | undefined);
+  listSlashCommands: () => SlashCommandSpec[];
+  execute: (name: string, args: Record<string, unknown> | undefined, ctx: CommandExecutionContext) => Promise<CommandResult>;
+  parseTextCommand: (input: string) => ParsedTextCommand | null;
+  executeText: (input: string, ctx: CommandExecutionContext) => Promise<CommandResult | null>;
+  private registerDefaults;
+  private register;
+  private buildHelpText;
+  private getOrCreateCommandSession;
+  private resolveSessionModel;
+  private resolveSessionThinking;
+  private parseTextArgs;
+  private parseTextOptionValue;
+}
+//#endregion
 //#region src/features/context-compaction/managers/context-compaction.manager.d.ts
 declare class ContextWindowPreviewManager {
   private readonly options;
@@ -1288,5 +1633,5 @@ type SkillRecord = {
   metadata: Record<string, unknown>;
 };
 //#endregion
-export { AgentId, AgentManager, AgentRecord, AgentRunClient, type AgentRunReply, type AgentRunReplyOptions, type AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeProviderRegistration, AgentRuntimeRegistry, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, type AssetApi, AutomationId, AutomationManager, AutomationManagerOptions, type BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelId, ChannelManager, ChannelReplyRouterDispatchParams, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, 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, NcpAgentSessionJournalStore, NcpSessionManager, NcpSessionManagerOptions, NextclawKernel, NextclawKernelOptions, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextParams, PanelAppBridgeSession, PanelAppContent, PanelAppEntry, PanelAppError, PanelAppErrorCode, PanelAppList, PanelAppManager, type PanelAppPreferencesUpdate, ProviderManagerNcpLLMApi, ServiceAction, ServiceActionCaller, ServiceActionGrant, ServiceActionGrantRequest, ServiceActionGrantState, ServiceActionInvokeRequest, ServiceActionInvokeResult, ServiceActionRisk, ServiceActionRuntimeState, ServiceAppError, ServiceAppErrorCode, ServiceAppList, ServiceAppManager, ServiceAppManifest, ServiceAppManifestAction, ServiceAppProtocol, ServiceAppRecord, ServiceAppRuntimeStatus, SessionId, SessionRequestManager, SessionRequestManagerOptions, SkillFrontmatter, SkillId, type SkillInfo, SkillManager, SkillRecord, type SkillScope, TaskId, ToolId, ToolRecord, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdatePreferences, UpdateProgress, UpdateSnapshot, UpdateStatus, buildAgentRunSendPayload, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildSessionOrchestrationSection, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextWindowSignature, createLlmUsageRecord, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getUnsignedUpdateManifest, hasLlmUsageTelemetry, isContextCompactionTimelineMessage, isContextWindowSnapshot, isPanelAppError, isReplyCapableChannel, isServiceAppError, listExtensionChannelIds, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseSkillFrontmatter, projectNcpMessagesWithContextCompaction, readContextWindowEventSessionId, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, resolveAgentRuntimeEntries, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveNextclawNcpRunContext, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, upsertContextCompactionTimelineMessage, waitForAgentRuntimeSessionReply };
+export { AgentId, AgentManager, AgentRecord, AgentRunClient, type AgentRunReply, type AgentRunReplyOptions, AgentRunSession, type AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeProviderRegistration, AgentRuntimeRegistry, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, type AssetApi, AutomationId, AutomationManager, AutomationManagerOptions, type BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelId, ChannelManager, ChannelReplyRouterDispatchParams, CommandRegistry, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionPreflightBeginResult, ContextCompactionPreflightResult, ContextCompactionPreflightService, ContextCompactionTimelineCheckpoint, ContextWindowPreviewManager, CreateAgentRunSessionParams, 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, NcpAgentSessionJournalStore, NextclawKernel, NextclawKernelOptions, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextParams, PANEL_APP_AGENT_CAPABILITIES, PanelAppAgentCapability, PanelAppAgentGenerateObjectInput, PanelAppAgentGenerateObjectRequest, PanelAppAgentGenerateObjectResult, PanelAppAgentRunClient, PanelAppAgentSendPayload, PanelAppAgentSendRequest, PanelAppAgentSendResult, PanelAppBridgeSession, PanelAppCapabilityGrant, PanelAppCapabilityGrantCaller, PanelAppContent, PanelAppDeleteResult, PanelAppEntry, PanelAppError, PanelAppErrorCode, PanelAppList, PanelAppManager, type PanelAppPreferencesUpdate, ProviderManagerNcpLLMApi, ServiceAction, ServiceActionCaller, ServiceActionGrant, ServiceActionGrantRequest, ServiceActionGrantState, ServiceActionInvokeRequest, ServiceActionInvokeResult, ServiceActionRisk, ServiceActionRuntimeState, ServiceAppError, ServiceAppErrorCode, ServiceAppList, ServiceAppManager, ServiceAppManifest, ServiceAppManifestAction, ServiceAppProtocol, ServiceAppRecord, ServiceAppRuntimeStatus, SessionId, SessionManager, SessionManagerOptions, SessionRequestManager, SessionRequestManagerOptions, SkillFrontmatter, SkillId, type SkillInfo, SkillManager, SkillRecord, type SkillScope, TaskId, ToolId, ToolRecord, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdatePreferences, UpdateProgress, UpdateSnapshot, UpdateStatus, buildAgentRunSendPayload, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildSessionOrchestrationSection, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextWindowSignature, createLlmUsageRecord, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getUnsignedUpdateManifest, hasLlmUsageTelemetry, isContextCompactionTimelineMessage, isContextWindowSnapshot, isPanelAppAgentCapability, isPanelAppError, isReplyCapableChannel, isServiceAppError, listExtensionChannelIds, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseSkillFrontmatter, projectNcpMessagesWithContextCompaction, readContextWindowEventSessionId, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, resolveAgentRuntimeEntries, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveNextclawNcpRunContext, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, upsertContextCompactionTimelineMessage, waitForAgentRuntimeSessionReply };
 //# sourceMappingURL=index.d.ts.map