@nextclaw/kernel 0.8.7 → 0.9.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, getAutomaticUpdateCheckDelay, resolveAutomaticUpdateCheckIntervalMs } from "./utils/automatic-update-check.utils.js";
 import { a as getUnsignedUpdateManifest, c as UpdateBlockReason, d as UpdateStatus, i as UpdateManifestReader, l as UpdateProgress, n as UpdateHostKind, o as serializeUnsignedUpdateManifest, r as UpdateManifest, s as InstallationKind, t as UnsignedUpdateManifest, u as UpdateSnapshot } from "./update-manifest.types-CQpbURTE.js";
-import { BaseChannel, Config, ContextCompactionCheckpoint, ContextCompactionPhase, ContextCompactionPlan, ContextWindowSnapshot, CreateAgentProfileInput, CreateSessionContextInheritanceInput, CreateSessionInput, CreatedSession, CronService, EffectiveAgentProfile, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, ExtensionUiMetadata, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, ModelThinkingCapability, OutboundMessage, ProviderModelDiscoveryResult, RequestSessionParams, RequestedSkillsMetadataReader, SearchConfig, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchService, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, UpdateAgentProfileInput, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
-import { ListMessagesOptions, ListSessionsOptions, NcpAgentConversationStateManager, NcpAgentRuntime, NcpEndpointEvent, NcpEventType, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessagePart, NcpRunHandle, NcpSessionApi, NcpSessionMessagePageInfo, NcpSessionPatch, NcpSessionSummary, NcpTool, OpenAIChatChunk } from "@nextclaw/ncp";
+import { BaseChannel, Config, ContextCompactionCheckpoint, ContextCompactionPhase, ContextCompactionPlan, ContextWindowSnapshot, CreateAgentProfileInput, CreateSessionContextInheritanceInput, CreateSessionInput, CreatedSession, CronService, DiagnosticRuntime, EffectiveAgentProfile, ExtensionChannelBinding, ExtensionDiagnostic, ExtensionRegistry, ExtensionUiMetadata, GatewayController, InboundAttachment, InboundMessage, LLMProvider, LLMResponse, LLMStreamEvent, MessageBus, ModelThinkingCapability, OutboundMessage, ProviderModelDiscoveryResult, RequestSessionParams, RequestedSkillsMetadataReader, SearchConfig, SessionMessage, SessionRequestDispatcher, SessionRequestRecord, SessionRequestToolResult, SessionSearchService, SkillInfo, SkillInfo as SkillInfo$1, SkillScope, SpawnSessionAndRequestParams, ThinkingLevel, UpdateAgentProfileInput, buildCompressingCompactionCheckpoint, resolveThinkingLevel } from "@nextclaw/core";
+import { ListMessagesOptions, ListSessionsOptions, NcpAgentConversationStateManager, NcpAgentRuntime, NcpEndpointEvent, NcpEventType, NcpInputDelivery, NcpLLMApi, NcpLLMApiInput, NcpLLMApiOptions, NcpMessage, NcpMessagePart, NcpRunHandle, NcpSessionApi, NcpSessionMessagePageInfo, NcpSessionPatch, NcpSessionSummary, NcpTool, OpenAIChatChunk } from "@nextclaw/ncp";
 import { AgentRunSendIngressPayload, EventBus, InboxDelivery, InboxDeliveryContentType, InboxDeliveryListView, InboxDeliverySource, InboxDeliveryStateAction, Ingress, RuntimeModelSelectionMode, SystemObjectReferenceGroupDescriptor, SystemObjectReferenceItem, SystemObjectReferenceListView, SystemObjectResolvedReference, Unsubscribe } from "@nextclaw/shared";
 import { LocalAssetStore } from "@nextclaw/ncp-agent-runtime";
 import { AppInstallProgressHandler, AppNativeArtifactTarget, AppPlatformTargetService, AppRollbackResult, AppRuntimeIsolation, AppRuntimeProfile, AppStorageContext, AppStorageUsage, AppUninstallResult, AppUpdateResult } from "@nextclaw/app-runtime";
@@ -107,6 +107,7 @@ declare class ChannelManager {
   private extensionChannels;
   constructor(deps: {
     bus: MessageBus;
+    diagnostics?: Pick<DiagnosticRuntime, "record" | "readCorrelationId">;
   });
   readonly load: (params: {
     channelConfig: Config;
@@ -126,6 +127,7 @@ declare class ChannelManager {
   get enabledChannels(): string[];
   readonly getChannel: (name: string) => BaseChannel<Record<string, unknown>> | null;
   readonly deliver: (message: OutboundMessage) => Promise<boolean>;
+  private readonly recordDelivery;
   private readonly initChannels;
   private readonly startChannel;
   private readonly normalizeOutbound;
@@ -260,6 +262,7 @@ type ConfigManagerRuntimeHooks = {
 type ConfigManagerOptions = {
   configPath?: string;
   channels: ChannelManager;
+  diagnostics?: Pick<DiagnosticRuntime, "record">;
   providerManager: LlmProviderManager;
   providerModelCatalogManager?: Pick<ProviderModelCatalogManager, "load">;
 };
@@ -291,6 +294,7 @@ declare class ConfigManager {
   installRuntimeHooks: (hooks: ConfigManagerRuntimeHooks) => void;
   applyLiveConfigReload: () => Promise<void>;
   applyReloadPlan: (nextConfig: Config) => Promise<void>;
+  private recordConfigEvent;
   getConfigSnapshot: (params?: {
     version?: string;
   }) => Record<string, unknown>;
@@ -301,7 +305,7 @@ declare class ConfigManager {
   patchRawConfig: (params: RawConfigMutationParams) => Promise<ConfigMutationResult>;
   applyConfig: (nextConfig: Config, note?: string) => Promise<ConfigMutationResult>;
   scheduleReload: (reason: string) => void;
-  runReload: (reason: string) => Promise<void>;
+  runReload: (_reason: string) => Promise<void>;
   reloadConfig: (reason?: string) => Promise<string>;
   rebuildChannels: (nextConfig: Config, options?: {
     start?: boolean;
@@ -371,6 +375,7 @@ type AgentRunRequest = {
   model?: string;
   maxTokens?: number;
   thinkingEffort?: ThinkingEffort | null;
+  delivery?: NcpInputDelivery;
 };
 type SessionQueuedInput = {
   id: string;
@@ -379,6 +384,17 @@ type SessionQueuedInput = {
   message: NcpMessage;
   metadata: Record<string, unknown>;
 };
+type SessionPendingInput = SessionQueuedInput & {
+  placement: "queued" | "steering";
+  intendedRunId: string | null;
+};
+type SessionSteerQueuedInputResult = {
+  ok: true;
+  input: SessionPendingInput;
+} | {
+  ok: false;
+  reason: "not-found" | "unavailable";
+};
 type AgentRunSpec = {
   runId: string;
   runtimeId: string;
@@ -419,10 +435,13 @@ type ToolRunContext = {
   workspace: string;
 };
 declare class ToolProviderManager {
+  private readonly diagnostics?;
   private readonly providers;
+  constructor(diagnostics?: Pick<DiagnosticRuntime, "record"> | undefined);
   register: (provider: ToolProvider) => (() => void);
   buildTools: (request: AgentRunRequest) => Promise<readonly NcpTool[]>;
   dispose: () => void;
+  private readonly wrapTool;
 }
 //#endregion
 //#region src/managers/agent-context-window.manager.d.ts
@@ -518,6 +537,7 @@ type UnfinishedNcpAgentRun = {
 //#region src/types/session.types.d.ts
 type SessionMessagePage = {
   messages: NcpMessage[];
+  messageDetailCursors: Record<string, string>;
   total: number;
   pageInfo: NcpSessionMessagePageInfo;
   contextWindow: Record<string, unknown> | null;
@@ -600,13 +620,17 @@ declare class NcpAgentSessionJournalStore {
   private readonly messageProjectionStore;
   private readonly unfinishedRunStore;
   private readonly summaryIndexStore;
+  private readonly summaryReadStore;
   constructor(journalDir: string);
   appendSessionEvent: (params: {
     sessionId: string;
     event: NcpAgentSessionJournalReplayEvent;
   }) => Promise<void>;
   getSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
-  listSessionSummaries: () => Promise<NcpSessionSummary[]>;
+  listSessionSummaries: (options?: {
+    limit?: number;
+  }) => Promise<NcpSessionSummary[]>;
+  getSessionSummary: (sessionId: string) => Promise<NcpSessionSummary | null>;
   listUnfinishedRuns: () => Promise<UnfinishedNcpAgentRun[]>;
   listSessionMessages: (sessionId: string) => Promise<NcpMessage[]>;
   listSessionMessagePage: (params: {
@@ -615,6 +639,7 @@ declare class NcpAgentSessionJournalStore {
     cursor?: string;
   }) => Promise<SessionMessagePage | null>;
   updateSessionMessageProjectionContextWindow: (sessionId: string, contextWindow: Record<string, unknown> | null) => Promise<void>;
+  getSessionMessageProjectionContextWindow: (sessionId: string) => Promise<Record<string, unknown> | null>;
   setSessionMetadata: (params: {
     sessionId: string;
     metadata: Record<string, unknown>;
@@ -629,7 +654,6 @@ declare class NcpAgentSessionJournalStore {
   deleteSession: (sessionId: string) => Promise<AgentSessionRecord | null>;
   hasSession: (sessionId: string) => Promise<boolean>;
   private appendSessionEventNow;
-  private withMetadata;
   private loadSession;
   private appendJournalEntry;
   private ensureJournalDir;
@@ -746,6 +770,18 @@ declare class SessionManager implements NcpSessionApi {
   private applySessionProjectPatch;
 }
 //#endregion
+//#region src/types/product-activity.types.d.ts
+type ProductActivityKind = "intent_accepted" | "run_succeeded";
+type ProductActivitySource = "direct" | "channel";
+type ProductActivitySignal = {
+  kind: ProductActivityKind;
+  occurredAt: string;
+  source: ProductActivitySource;
+};
+type ProductActivitySink = {
+  record: (signal: ProductActivitySignal) => Promise<void> | void;
+};
+//#endregion
 //#region src/managers/session-run.manager.d.ts
 type SessionRunQueuedRequest = {
   id: string;
@@ -757,23 +793,23 @@ type SessionRunQueuedRequest = {
 type SessionRunActiveRequest = SessionRunQueuedRequest & {
   signal: AbortSignal;
 };
-declare class MessageInbox<T> {
-  private readonly messages;
-  enqueue: (message: T) => void;
-  drain: () => T[];
-}
+type SessionRunPendingRequest = SessionRunQueuedRequest & {
+  placement: "queued" | "steering";
+  intendedRunId: string | null;
+};
 declare class SessionRun {
   private readonly stateManager;
-  readonly inbox: MessageInbox<NcpMessage>;
+  private readonly productActivitySink?;
   readonly sessionId: string;
   private readonly statusListeners;
-  private readonly queuedRequests;
+  private readonly pendingInputs;
   private activeRunId;
   private activeRunController;
+  private activeProductActivitySource;
   constructor(seed: {
     sessionId: string;
     messages: readonly NcpMessage[];
-  }, stateManager?: NcpAgentConversationStateManager);
+  }, stateManager?: NcpAgentConversationStateManager, productActivitySink?: ProductActivitySink | undefined);
   getSnapshot: () => {
     messages: readonly NcpMessage[];
   };
@@ -782,7 +818,13 @@ declare class SessionRun {
   onStatusChange: (listener: (status: "idle" | "running") => void) => (() => void);
   enqueueRequest: (request: AgentRunRequest, session: AgentRunSession) => SessionRunQueuedRequest;
   listQueuedRequests: () => readonly SessionRunQueuedRequest[];
+  listPendingRequests: () => readonly SessionRunPendingRequest[];
   removeQueuedRequest: (queuedRequestId: string) => SessionRunQueuedRequest | null;
+  moveQueuedRequestToNextStep: (queuedRequestId: string) => SessionRunPendingRequest | null;
+  enqueueNextStepRequest: (request: AgentRunRequest, session: AgentRunSession) => SessionRunPendingRequest | null;
+  claimNextStepRequests: (runId: string) => readonly SessionRunPendingRequest[];
+  acknowledgeNextStepRequests: (requestIds: readonly string[]) => void;
+  getActiveRunId: () => string | null;
   beginNextRun: () => SessionRunActiveRequest | null;
   abortRun: (runId?: string, reason?: unknown) => boolean;
   isRunning: () => boolean;
@@ -793,9 +835,10 @@ declare class SessionRun {
 }
 declare class SessionRunManager {
   private readonly sessionManager;
+  private readonly productActivitySink?;
   private readonly runs;
   private readonly pendingCreations;
-  constructor(sessionManager: SessionManager);
+  constructor(sessionManager: SessionManager, productActivitySink?: ProductActivitySink | undefined);
   getSessionRun: (sessionId: string) => SessionRun | null;
   isSessionRunning: (sessionId: string) => boolean;
   getOrCreateSessionRun: (sessionId: string) => Promise<SessionRun>;
@@ -810,6 +853,7 @@ type AgentRuntimeRunOptions = {
   sessionRun: SessionRun;
   contextBlocks: readonly ContextBlock[];
   tools: readonly NcpTool[];
+  initialMessages: readonly NcpMessage[];
   signal?: AbortSignal;
 };
 type AgentRuntimeContextCompactionOptions = Pick<AgentRuntimeRunOptions, "session" | "sessionRun">;
@@ -819,6 +863,9 @@ type AgentRuntimeContextCompactionResult = {
   supported: boolean;
 };
 type AgentRuntime = {
+  capabilities?: {
+    nextStepInput?: boolean;
+  };
   run: (spec: AgentRunSpec, options: AgentRuntimeRunOptions) => AsyncIterable<NcpEndpointEvent>;
   compactContext?: (options: AgentRuntimeContextCompactionOptions) => Promise<AgentRuntimeContextCompactionResult>;
   dispose?: () => Promise<void> | void;
@@ -866,6 +913,24 @@ declare class AgentRuntimeManager {
   private disposeAllRuntimes;
 }
 //#endregion
+//#region src/services/agent-run-input-delivery.service.d.ts
+/** Resolves public pending-input actions while SessionRun remains the state owner. */
+declare class AgentRunInputDeliveryService {
+  private readonly agentRuntimeManager;
+  private readonly sessionManager;
+  private readonly sessionRunManager;
+  private readonly publishQueueUpdated;
+  constructor(agentRuntimeManager: AgentRuntimeManager, sessionManager: SessionManager, sessionRunManager: SessionRunManager, publishQueueUpdated: (sessionId: string) => void);
+  listQueuedInputs: (sessionId: string) => readonly SessionQueuedInput[];
+  removeQueuedInput: (sessionId: string, queuedInputId: string) => SessionQueuedInput | null;
+  listPendingInputs: (sessionId: string) => readonly SessionPendingInput[];
+  steerQueuedInput: (sessionId: string, queuedInputId: string) => Promise<SessionSteerQueuedInputResult>;
+  enqueuePreferredSteeringInput: (sessionRun: SessionRun, request: AgentRunRequest, session: AgentRunSession) => SessionRunPendingRequest | null;
+  private supportsNextStepInput;
+  private toPendingInput;
+  private toQueuedInput;
+}
+//#endregion
 //#region src/managers/agent-run-request.manager.d.ts
 declare class AgentRunRequestManager {
   private readonly agentRuntimeManager;
@@ -876,15 +941,15 @@ declare class AgentRunRequestManager {
   private readonly ingress;
   private readonly sessionManager;
   private readonly sessionRunManager;
+  private readonly diagnostics?;
   readonly cleanups: Array<() => void>;
   private readonly observedSessionRuns;
   private readonly sessionCommandManager;
+  readonly pendingInputs: AgentRunInputDeliveryService;
   private started;
-  constructor(agentRuntimeManager: AgentRuntimeManager, agentManager: AgentManager, configManager: ConfigManager, agentContextWindowManager: AgentContextWindowManager, eventBus: EventBus, ingress: Ingress, sessionManager: SessionManager, sessionRunManager: SessionRunManager);
+  constructor(agentRuntimeManager: AgentRuntimeManager, agentManager: AgentManager, configManager: ConfigManager, agentContextWindowManager: AgentContextWindowManager, eventBus: EventBus, ingress: Ingress, sessionManager: SessionManager, sessionRunManager: SessionRunManager, diagnostics?: Pick<DiagnosticRuntime, "record"> | undefined);
   start: () => void;
   dispose: () => void;
-  listQueuedInputs: (sessionId: string) => readonly SessionQueuedInput[];
-  removeQueuedInput: (sessionId: string, queuedInputId: string) => SessionQueuedInput | null;
   private handleSendRequest;
   private handleAbortRequest;
   private handleEditMessageRequest;
@@ -898,7 +963,6 @@ declare class AgentRunRequestManager {
   private observeSessionRun;
   private publishRunQueueUpdated;
   private publishNcpEvent;
-  private toQueuedInput;
   private getOrCreateSessionForRequest;
   private abort;
 }
@@ -992,6 +1056,7 @@ declare class AccessManager {
 //#region src/managers/automation.manager.d.ts
 type AutomationManagerOptions = {
   storePath: string;
+  diagnostics?: Pick<DiagnosticRuntime, "record">;
 };
 declare class AutomationManager extends CronService {
   constructor(options: AutomationManagerOptions);
@@ -1039,8 +1104,15 @@ type AppPackageView = {
   runtimeProfile: AppRuntimeProfile;
   isolation: AppRuntimeIsolation;
 };
+type AppPackageHostTarget = {
+  key: string;
+  operatingSystem: "darwin" | "linux" | "win32";
+  architecture: "x64" | "arm64";
+  abi?: "gnu" | "musl" | "msvc";
+};
 type AppPackageList = {
   entries: AppPackageView[];
+  hostTarget?: AppPackageHostTarget;
 };
 type AppPackageOperationAction = "install" | "rollback" | "uninstall" | "update";
 type AppPackageOperationStatus = "queued" | "resolving" | "downloading" | "verifying" | "installing" | "finalizing" | "succeeded" | "failed" | "interrupted";
@@ -1111,6 +1183,7 @@ declare class AppPackageManager {
   private readonly installationService;
   private readonly manifestService;
   private readonly operationManager;
+  private readonly platformTargetService;
   private readonly presentationService;
   private readonly registryService;
   private runtimeHooks;
@@ -1126,6 +1199,7 @@ declare class AppPackageManager {
   listPackages: (options?: {
     includeStorageUsage?: boolean;
   }) => Promise<AppPackageList>;
+  private readHostTarget;
   listInstalledDataOwners: () => Promise<Array<{
     id: string;
     name: string;
@@ -1252,6 +1326,7 @@ type ExtensionLoadResult = {
   shouldRestartChannels: boolean;
 };
 type ExtensionManagerOptions = {
+  diagnostics: DiagnosticRuntime;
   configManager: Pick<ConfigManager, "loadConfig">;
   eventBus: Pick<EventBus, "emitEnvelope">;
   ingress: Pick<Ingress, "addHandler">;
@@ -1504,6 +1579,7 @@ declare class SessionContextCompactionManager {
 //#region src/stores/panel-app-state.store.d.ts
 type PanelAppPreferencesUpdate = {
   favorite?: boolean;
+  mainSidebar?: boolean;
 };
 //#endregion
 //#region src/stores/panel-app-client-grant.store.d.ts
@@ -1595,6 +1671,61 @@ type ServiceActionGrantRequest = {
 };
 //#endregion
 //#region src/types/panel-app.types.d.ts
+type PanelAppEntry = {
+  id: string;
+  appId: string;
+  fileName: string;
+  kind: "single-file" | "folder";
+  title: string;
+  description?: string;
+  icon?: string;
+  contentPath: string;
+  createdAt: string;
+  updatedAt: string;
+  sizeBytes: number;
+  favorite: boolean;
+  mainSidebar: boolean;
+  mainSidebarOrder?: number;
+  clientDeclared: boolean;
+  clientGranted: boolean;
+  lastOpenedAt?: string;
+  openCount: number;
+  sourceKind: "workspace" | "package";
+  packageId?: string;
+  packageVersion?: string;
+};
+type PanelAppList = {
+  workspacePath: string;
+  panelsPath: string;
+  entries: PanelAppEntry[];
+};
+type PanelAppContent = {
+  id: string;
+  appId: string;
+  fileName: string;
+  html: string;
+  contentType: "text/html; charset=utf-8";
+  capabilities: string[];
+  clientDeclared: boolean;
+  clientGranted: boolean;
+  serviceActions: string[];
+};
+type PanelAppDeleteResult = {
+  deleted: true;
+  fileName: string;
+  id: string;
+};
+type PanelAppBridgeSession = {
+  id: string;
+  token: string;
+  appId: string;
+  caller: ServiceActionCaller;
+  declaredCapabilities: string[];
+  declaredActions: string[];
+  clientDeclared: boolean;
+  createdAt: string;
+  expiresAt: string;
+};
 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_ASSET_TOKEN_EXPIRED" | "PANEL_APP_ASSET_TOKEN_INVALID" | "PANEL_APP_BRIDGE_SESSION_NOT_FOUND" | "PANEL_APP_CAPABILITY_NOT_DECLARED" | "PANEL_APP_CLIENT_NOT_DECLARED" | "PANEL_APP_INVALID_ASSET_PATH" | "PANEL_APP_INVALID_ID" | "PANEL_APP_INVALID_SOURCE_PATH" | "PANEL_APP_MANIFEST_INVALID" | "PANEL_APP_MANAGED_SOURCE" | "PANEL_APP_NOT_FOUND" | "PANEL_APP_READ_FAILED";
 declare class PanelAppError extends Error {
   readonly code: PanelAppErrorCode;
@@ -1659,60 +1790,6 @@ type PanelAppAsset = {
 };
 //#endregion
 //#region src/managers/panel-app.manager.d.ts
-declare const PANEL_APP_CONTENT_TYPE: "text/html; charset=utf-8";
-type PanelAppEntry = {
-  id: string;
-  appId: string;
-  fileName: string;
-  kind: "single-file" | "folder";
-  title: string;
-  description?: string;
-  icon?: string;
-  contentPath: string;
-  createdAt: string;
-  updatedAt: string;
-  sizeBytes: number;
-  favorite: boolean;
-  clientDeclared: boolean;
-  clientGranted: boolean;
-  lastOpenedAt?: string;
-  openCount: number;
-  sourceKind: "workspace" | "package";
-  packageId?: string;
-  packageVersion?: string;
-};
-type PanelAppList = {
-  workspacePath: string;
-  panelsPath: string;
-  entries: PanelAppEntry[];
-};
-type PanelAppContent = {
-  id: string;
-  appId: string;
-  fileName: string;
-  html: string;
-  contentType: typeof PANEL_APP_CONTENT_TYPE;
-  capabilities: string[];
-  clientDeclared: boolean;
-  clientGranted: boolean;
-  serviceActions: string[];
-};
-type PanelAppDeleteResult = {
-  deleted: true;
-  fileName: string;
-  id: string;
-};
-type PanelAppBridgeSession = {
-  id: string;
-  token: string;
-  appId: string;
-  caller: ServiceActionCaller;
-  declaredCapabilities: string[];
-  declaredActions: string[];
-  clientDeclared: boolean;
-  createdAt: string;
-  expiresAt: string;
-};
 declare class PanelAppManager {
   private readonly params;
   private readonly bridgeSessions;
@@ -1854,6 +1931,14 @@ type ServiceAppRemovalDiagnostic = {
   message: string;
 };
 //#endregion
+//#region src/utils/service-app-error.utils.d.ts
+type ServiceAppErrorCode = "AUTHORIZATION_REQUIRED" | "SERVICE_APP_ACTION_NOT_DECLARED" | "SERVICE_APP_ACTION_NOT_FOUND" | "SERVICE_APP_INVALID_ACTION" | "SERVICE_APP_INVALID_CALLER" | "SERVICE_APP_INVALID_MANIFEST" | "SERVICE_APP_MANAGED_SOURCE" | "SERVICE_APP_NOT_FOUND" | "SERVICE_APP_READ_FAILED" | "SERVICE_APP_RUNTIME_FAILED";
+declare class ServiceAppError extends Error {
+  readonly code: ServiceAppErrorCode;
+  constructor(code: ServiceAppErrorCode, message: string);
+}
+declare const isServiceAppError: (error: unknown) => error is ServiceAppError;
+//#endregion
 //#region src/managers/service-app.manager.d.ts
 type ServiceAppList = {
   workspacePath: string;
@@ -1866,12 +1951,6 @@ type ServiceAppDeleteResult = {
   id: string;
   dataRemoved: boolean;
 };
-type ServiceAppErrorCode = "AUTHORIZATION_REQUIRED" | "SERVICE_APP_ACTION_NOT_DECLARED" | "SERVICE_APP_ACTION_NOT_FOUND" | "SERVICE_APP_INVALID_ACTION" | "SERVICE_APP_INVALID_CALLER" | "SERVICE_APP_INVALID_MANIFEST" | "SERVICE_APP_MANAGED_SOURCE" | "SERVICE_APP_NOT_FOUND" | "SERVICE_APP_READ_FAILED" | "SERVICE_APP_RUNTIME_FAILED";
-declare class ServiceAppError extends Error {
-  readonly code: ServiceAppErrorCode;
-  constructor(code: ServiceAppErrorCode, message: string);
-}
-declare const isServiceAppError: (error: unknown) => error is ServiceAppError;
 declare class ServiceAppManager {
   private readonly params;
   private readonly removalService;
@@ -2037,6 +2116,7 @@ type NextclawKernelOptions = {
   configPath?: string;
   builtInAppsDirectory?: string;
   productVersion?: string;
+  productActivitySink?: ProductActivitySink;
 };
 type NextclawKernelRuntimeControl<TGatewayInput, TUiInput, TStartInput> = {
   gateway: (input: TGatewayInput) => Promise<void>;
@@ -2055,6 +2135,7 @@ declare class NextclawKernel {
   readonly eventBus: EventBus;
   readonly ingress: Ingress;
   readonly messageBus: MessageBus;
+  readonly diagnostics: DiagnosticRuntime;
   readonly llmProviders: LlmProviderManager;
   readonly providerModelCatalog: ProviderModelCatalogManager;
   readonly llmUsage: LlmUsageManager;
@@ -2181,6 +2262,7 @@ type GatewayInboundLoopRuntime = {
   kernel: {
     channels: ChannelManager;
     assetStore: AssetApi;
+    diagnostics?: Pick<DiagnosticRuntime, "record" | "readCorrelationId">;
   };
   agentRunClient: AgentRunClient;
   messageBus: MessageBus;
@@ -2194,6 +2276,7 @@ declare class GatewayInboundProcessor {
   private runtime;
   constructor(runtime: GatewayInboundLoopRuntime);
   process: (message: InboundMessage) => Promise<void>;
+  private record;
   private resolveRoute;
   private dispatchSlashCommandMaybe;
   private dispatchChannelReplyRouteMaybe;
@@ -2585,5 +2668,5 @@ declare function resolveLegacyEventType(message: SessionMessage): string;
 declare function getUiContentParamsBootstrapScript(): string;
 declare function injectUiContentParamsBootstrap(html: string): string;
 //#endregion
-export { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, AccessLoginResult, AccessManager, AccessManagerOptions, AccessPasswordStatus, AccessPrincipal, AccessRole, AccessSessionRecord, AccessSessionState, AgentManager, AgentManagerOptions, AgentRunClient, type AgentRunReply, type AgentRunReplyOptions, AgentRunSession, type AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeProviderRegistration, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, AgentRuntimeSessionTypeProvider, AppDataDeleteResult, AppDataDiagnostic, AppDataEntry, AppDataError, AppDataErrorCode, AppDataLifecycle, AppDataList, AppDataManager, AppDataSource, AppPackageComponentKind, AppPackageComponentSource, AppPackageComponentView, AppPackageConflict, AppPackageError, AppPackageErrorCode, AppPackageList, AppPackageManager, AppPackageOperationAction, AppPackageOperationInput, AppPackageOperationList, AppPackageOperationResult, AppPackageOperationStatus, AppPackageOperationView, AppPackageRuntimeHooks, AppPackageView, type AssetApi, AutomationManager, AutomationManagerOptions, type BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_CONTINUATION_TEXT, CONTEXT_COMPACTION_PROJECTION_KIND, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, CONTEXT_COMPACTION_SYSTEM_PREAMBLE, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, ChannelReplyRouterDispatchParams, CommandRegistry, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionJournalRecoveryService, ContextCompactionModelProjection, ContextCompactionPreflightBeginResult, ContextCompactionPreflightResult, ContextCompactionPreflightService, ContextCompactionTimelineCheckpoint, ContextCompactionTrigger, CreateAgentRunSessionParams, CreateInboxDeliveryInput, CreateProjectInput, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DEFAULT_SERVICE_ACTION_RISK, DirectPromptDispatchParams, ExtensionLoadProgress, ExtensionLoadResult, ExtensionManager, type ExtensionRuntimeStatus, GatewayInboundLoopRuntime, GatewayInboundProcessor, InboxDeliveryError, InboxDeliveryErrorCode, InboxDeliveryManager, InboxDeliveryManagerOptions, InstallationKind, InstalledSkillDetail, InstalledSkillSummary, InstalledSkillsList, type LearningLoopRuntimeConfig, LlmProviderManager, LlmProviderRuntime, LlmUsageManager, LlmUsageManagerOptions, LlmUsageRecord, LlmUsageSnapshot, LlmUsageStats, LlmUsageStore, LlmUsageStoreOptions, LlmUsageSummary, LocalizedTextMap, MAX_INBOX_DELIVERY_CONTENT_LENGTH, McpManager, McpServiceAppRuntimeService, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, NextclawKernelOptions, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextResolveParams, PANEL_APP_AGENT_CAPABILITIES, PROJECT_TEMPLATE_IDS, PROVIDER_MODEL_CATALOG_REFRESH_INTERVAL_MS, PanelAppAgentCapability, PanelAppAgentGenerateObjectInput, PanelAppAgentGenerateObjectRequest, PanelAppAgentGenerateObjectResult, PanelAppAgentRunClient, PanelAppAgentSendPayload, PanelAppAgentSendRequest, PanelAppAgentSendResult, PanelAppAssetTokenService, PanelAppBridgeSession, PanelAppCapabilityGrant, PanelAppCapabilityGrantCaller, type PanelAppClientGrant, PanelAppContent, PanelAppDeleteResult, PanelAppEntry, PanelAppError, PanelAppErrorCode, PanelAppList, PanelAppManager, type PanelAppPreferencesUpdate, PreferenceEntry, PreferenceError, PreferenceErrorCode, PreferenceJsonValue, PreferenceManager, PreferenceManagerOptions, ProjectError, ProjectErrorCode, ProjectManager, ProjectManagerOptions, ProjectRecord, ProjectTemplate, ProjectTemplateId, ProviderManagerNcpLLMApi, ProviderModelCatalogEntry, ProviderModelCatalogManager, ProviderModelCatalogSnapshot, ProviderModelsDiscoverInput, ResolvedAgentProfile, SERVICE_APP_MANIFEST_FILE_NAME, ServiceAction, ServiceActionCaller, ServiceActionGrant, ServiceActionGrantRequest, ServiceActionGrantState, ServiceActionInvokeRequest, ServiceActionInvokeResult, ServiceActionRisk, ServiceActionRuntimeState, ServiceAppDeleteResult, ServiceAppError, ServiceAppErrorCode, ServiceAppList, ServiceAppManager, ServiceAppManifest, ServiceAppManifestAction, ServiceAppProtocol, ServiceAppRecord, ServiceAppRuntimeStatus, SessionContextCompactionError, SessionContextCompactionErrorCode, SessionContextCompactionManager, SessionContextCompactionResult, SessionManager, SessionManagerOptions, SessionMessageCursorError, SessionMessagePage, SessionModelTokenUsage, type SessionQueuedInput, SessionRequestManager, SessionRequestManagerOptions, SessionSettingsError, SessionSettingsPatch, SessionTokenUsageStatus, SessionTokenUsageSummary, SessionTokenUsageTotals, SkillFrontmatter, type SkillInfo, SkillManager, type SkillScope, SystemObjectReferenceError, SystemObjectReferenceErrorCode, SystemObjectReferenceManager, SystemObjectReferenceProvider, SystemObjectReferenceSnapshotSource, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdateProgress, UpdateSnapshot, UpdateStatus, type WorkspaceServiceDataOwner, buildAgentRunSendPayload, buildContextCompactionModelProjection, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNextclawNcpRunContext, buildServiceActionId, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextCompactionMessageId, createContextWindowSignature, createCronJobSystemObjectProvider, createInboxDeliverySystemObjectProvider, createLlmUsageRecord, describeAgentRuntimeSessionTypes, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getAutomaticUpdateCheckDelay, getServiceActionName, getServiceAppManifestPath, getUiContentParamsBootstrapScript, getUnsignedUpdateManifest, hasLlmUsageTelemetry, injectUiContentParamsBootstrap, isAppDataError, isAppPackageError, isContextCompactionProjectionMessage, isContextCompactionTimelineMessage, isContextWindowSnapshot, isInboxDeliveryError, isPanelAppAgentCapability, isPanelAppError, isPreferenceError, isProjectError, isReplyCapableChannel, isServiceAppError, isSessionContextCompactionError, isSessionMessageCursorError, isSessionSettingsError, isSystemObjectReferenceError, listExtensionChannelIds, listServiceAppManifestActions, mergeServiceAppRuntimeActions, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseServiceAppManifest, parseSkillFrontmatter, readContextCompactionCheckpoint, readContextWindowEventSessionId, readLatestContextCompactionCheckpoint, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, readServiceAppManifest, resolveAgentRuntimeEntries, resolveAutomaticUpdateCheckIntervalMs, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, waitForAgentRuntimeSessionReply };
+export { AUTOMATIC_UPDATE_CHECK_INTERVAL_MS, AccessLoginResult, AccessManager, AccessManagerOptions, AccessPasswordStatus, AccessPrincipal, AccessRole, AccessSessionRecord, AccessSessionState, AgentManager, AgentManagerOptions, AgentRunClient, type AgentRunReply, type AgentRunReplyOptions, AgentRunSession, type AgentRunStreamOptions, AgentRuntimeEntry, AgentRuntimeProviderRegistration, AgentRuntimeSessionRequestDispatcherOptions, AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeIcon, AgentRuntimeSessionTypeOption, AgentRuntimeSessionTypeProvider, AppDataDeleteResult, AppDataDiagnostic, AppDataEntry, AppDataError, AppDataErrorCode, AppDataLifecycle, AppDataList, AppDataManager, AppDataSource, AppPackageComponentKind, AppPackageComponentSource, AppPackageComponentView, AppPackageConflict, AppPackageError, AppPackageErrorCode, AppPackageHostTarget, AppPackageList, AppPackageManager, AppPackageOperationAction, AppPackageOperationInput, AppPackageOperationList, AppPackageOperationResult, AppPackageOperationStatus, AppPackageOperationView, AppPackageRuntimeHooks, AppPackageView, type AssetApi, AutomationManager, AutomationManagerOptions, type BuildAgentRunSendPayloadParams, BuiltinNarpRuntimeProviderService, CONTEXT_COMPACTION_CONTINUATION_TEXT, CONTEXT_COMPACTION_PROJECTION_KIND, CONTEXT_COMPACTION_PROJECTION_METADATA_KEY, CONTEXT_COMPACTION_SYSTEM_PREAMBLE, CONTEXT_COMPACTION_TIMELINE_KIND, ChannelManager, ChannelReplyRouterDispatchParams, CommandRegistry, ConfigManager, ConfigManagerOptions, ConfigManagerRuntimeHooks, ConfigMutationResult, ContextCompactionJournalRecoveryService, ContextCompactionModelProjection, ContextCompactionPreflightBeginResult, ContextCompactionPreflightResult, ContextCompactionPreflightService, ContextCompactionTimelineCheckpoint, ContextCompactionTrigger, CreateAgentRunSessionParams, CreateInboxDeliveryInput, CreateProjectInput, DEFAULT_AGENT_RUNTIME_ENTRY_ID, DEFAULT_SERVICE_ACTION_RISK, DirectPromptDispatchParams, ExtensionLoadProgress, ExtensionLoadResult, ExtensionManager, type ExtensionRuntimeStatus, GatewayInboundLoopRuntime, GatewayInboundProcessor, InboxDeliveryError, InboxDeliveryErrorCode, InboxDeliveryManager, InboxDeliveryManagerOptions, InstallationKind, InstalledSkillDetail, InstalledSkillSummary, InstalledSkillsList, type LearningLoopRuntimeConfig, LlmProviderManager, LlmProviderRuntime, LlmUsageManager, LlmUsageManagerOptions, LlmUsageRecord, LlmUsageSnapshot, LlmUsageStats, LlmUsageStore, LlmUsageStoreOptions, LlmUsageSummary, LocalizedTextMap, MAX_INBOX_DELIVERY_CONTENT_LENGTH, McpManager, McpServiceAppRuntimeService, NARP_HTTP_RUNTIME_KIND, NARP_STDIO_RUNTIME_KIND, NEXTCLAW_TIMELINE_KIND_METADATA_KEY, NcpAgentSessionJournalStore, NextclawKernel, NextclawKernelOptions, NextclawNcpResolvedAgentProfile, NextclawNcpResolvedRunContext, NextclawNcpRunContextResolveParams, PANEL_APP_AGENT_CAPABILITIES, PROJECT_TEMPLATE_IDS, PROVIDER_MODEL_CATALOG_REFRESH_INTERVAL_MS, PanelAppAgentCapability, PanelAppAgentGenerateObjectInput, PanelAppAgentGenerateObjectRequest, PanelAppAgentGenerateObjectResult, PanelAppAgentRunClient, PanelAppAgentSendPayload, PanelAppAgentSendRequest, PanelAppAgentSendResult, PanelAppAssetTokenService, PanelAppBridgeSession, PanelAppCapabilityGrant, PanelAppCapabilityGrantCaller, type PanelAppClientGrant, PanelAppContent, PanelAppDeleteResult, PanelAppEntry, PanelAppError, PanelAppErrorCode, PanelAppList, PanelAppManager, type PanelAppPreferencesUpdate, PreferenceEntry, PreferenceError, PreferenceErrorCode, PreferenceJsonValue, PreferenceManager, PreferenceManagerOptions, ProductActivityKind, ProductActivitySignal, ProductActivitySink, ProductActivitySource, ProjectError, ProjectErrorCode, ProjectManager, ProjectManagerOptions, ProjectRecord, ProjectTemplate, ProjectTemplateId, ProviderManagerNcpLLMApi, ProviderModelCatalogEntry, ProviderModelCatalogManager, ProviderModelCatalogSnapshot, ProviderModelsDiscoverInput, ResolvedAgentProfile, SERVICE_APP_MANIFEST_FILE_NAME, ServiceAction, ServiceActionCaller, ServiceActionGrant, ServiceActionGrantRequest, ServiceActionGrantState, ServiceActionInvokeRequest, ServiceActionInvokeResult, ServiceActionRisk, ServiceActionRuntimeState, ServiceAppDeleteResult, ServiceAppError, type ServiceAppErrorCode, ServiceAppList, ServiceAppManager, ServiceAppManifest, ServiceAppManifestAction, ServiceAppProtocol, ServiceAppRecord, ServiceAppRuntimeStatus, SessionContextCompactionError, SessionContextCompactionErrorCode, SessionContextCompactionManager, SessionContextCompactionResult, SessionManager, SessionManagerOptions, SessionMessageCursorError, SessionMessagePage, SessionModelTokenUsage, type SessionPendingInput, type SessionQueuedInput, SessionRequestManager, SessionRequestManagerOptions, SessionSettingsError, SessionSettingsPatch, type SessionSteerQueuedInputResult, SessionTokenUsageStatus, SessionTokenUsageSummary, SessionTokenUsageTotals, SkillFrontmatter, type SkillInfo, SkillManager, type SkillScope, SystemObjectReferenceError, SystemObjectReferenceErrorCode, SystemObjectReferenceManager, SystemObjectReferenceProvider, SystemObjectReferenceSnapshotSource, UnsignedUpdateManifest, UpdateBlockReason, UpdateHostKind, UpdateManifest, UpdateManifestReader, UpdateProgress, UpdateSnapshot, UpdateStatus, type WorkspaceServiceDataOwner, buildAgentRunSendPayload, buildContextCompactionModelProjection, buildContextCompactionTimelineNcpMessage, buildLlmUsageSummary, buildLocalizedTextMap, buildNextclawNcpRunContext, buildServiceActionId, createAgentRuntimeSessionRequestDispatcher, createAssetTools, createContextCompactionMessageId, createContextWindowSignature, createCronJobSystemObjectProvider, createInboxDeliverySystemObjectProvider, createLlmUsageRecord, describeAgentRuntimeSessionTypes, dispatchAgentRuntimeSessionRequest, dispatchChannelReplyRoute, dispatchPromptOverNcp, getAutomaticUpdateCheckDelay, getServiceActionName, getServiceAppManifestPath, getUiContentParamsBootstrapScript, getUnsignedUpdateManifest, hasLlmUsageTelemetry, injectUiContentParamsBootstrap, isAppDataError, isAppPackageError, isContextCompactionProjectionMessage, isContextCompactionTimelineMessage, isContextWindowSnapshot, isInboxDeliveryError, isPanelAppAgentCapability, isPanelAppError, isPreferenceError, isProjectError, isReplyCapableChannel, isServiceAppError, isSessionContextCompactionError, isSessionMessageCursorError, isSessionSettingsError, isSystemObjectReferenceError, listExtensionChannelIds, listServiceAppManifestActions, mergeServiceAppRuntimeActions, normalizeAgentRuntimeSessionTypeIcon, normalizeLlmUsageModel, normalizeOptionalString, parseServiceAppManifest, parseSkillFrontmatter, readContextCompactionCheckpoint, readContextWindowEventSessionId, readLatestContextCompactionCheckpoint, readLearningLoopRuntimeConfig, readMetadataModel, readMetadataThinking, readServiceAppManifest, resolveAgentRuntimeEntries, resolveAutomaticUpdateCheckIntervalMs, resolveChannelReplyRoute, resolveEffectiveModel, resolveLegacyEventType, resolveSessionChannelContext, runGatewayInboundLoop, sanitizeLlmUsage, serializeUnsignedUpdateManifest, shouldRefreshContextWindowDuringStream, shouldRefreshContextWindowImmediately, stripSkillFrontmatter, syncSessionThinkingPreference, toNcpMessages, waitForAgentRuntimeSessionReply };
 //# sourceMappingURL=index.d.ts.map