@nextclaw/server 0.11.24 → 0.12.1

package/dist/index.d.ts

@@ -1,34 +1,36 @@
-import * as NextclawCore from '@nextclaw/core';
-import { ThinkingLevel, CronService, Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1 } from '@nextclaw/core';
-import { PluginChannelBinding, PluginUiMetadata } from '@nextclaw/openclaw-compat';
-import { NcpAgentClientEndpoint, NcpSessionSummary, NcpMessage, NcpSessionApi } from '@nextclaw/ncp';
-import { NcpHttpAgentStreamProvider } from '@nextclaw/ncp-http-agent-server';
-import { IncomingMessage } from 'node:http';
-import { Hono } from 'hono';
+import { Hono } from "hono";
+import * as NextclawCore from "@nextclaw/core";
+import { Config, ConfigActionExecuteRequest as ConfigActionExecuteRequest$1, ConfigActionExecuteResult as ConfigActionExecuteResult$1, CronService, ThinkingLevel } from "@nextclaw/core";
+import { NcpHttpAgentStreamProvider } from "@nextclaw/ncp-http-agent-server";
+import { PluginChannelBinding, PluginUiMetadata } from "@nextclaw/openclaw-compat";
+import { NcpAgentClientEndpoint, NcpMessage, NcpSessionApi, NcpSessionStatus, NcpSessionSummary } from "@nextclaw/ncp";
+import { IncomingMessage } from "node:http";
 
+//#region src/ui/ncp-attachment.types.d.ts
 type UiNcpStoredAssetRecord = {
-    id: string;
-    uri: string;
-    storageKey: string;
-    fileName: string;
-    storedName: string;
-    mimeType: string;
-    sizeBytes: number;
-    createdAt: string;
-    sha256: string;
+  id: string;
+  uri: string;
+  storageKey: string;
+  fileName: string;
+  storedName: string;
+  mimeType: string;
+  sizeBytes: number;
+  createdAt: string;
+  sha256: string;
 };
 type UiNcpAssetView = {
-    id: string;
-    name: string;
-    mimeType: string;
-    sizeBytes: number;
-    assetUri: string;
-    url: string;
+  id: string;
+  name: string;
+  mimeType: string;
+  sizeBytes: number;
+  assetUri: string;
+  url: string;
 };
 type UiNcpAssetPutView = {
-    assets: UiNcpAssetView[];
+  assets: UiNcpAssetView[];
 };
-
+//#endregion
+//#region src/ui/marketplace.types.d.ts
 type MarketplaceItemType = "plugin" | "skill" | "mcp";
 type MarketplaceSort = "relevance" | "updated";
 type MarketplacePluginInstallKind = "npm";
@@ -36,1146 +38,1169 @@ type MarketplaceSkillInstallKind = "builtin" | "marketplace";
 type MarketplaceMcpInstallKind = "template";
 type MarketplaceInstallKind = MarketplacePluginInstallKind | MarketplaceSkillInstallKind | MarketplaceMcpInstallKind;
 type MarketplaceInstallSpec = {
-    kind: MarketplaceInstallKind;
-    spec: string;
-    command: string;
+  kind: MarketplaceInstallKind;
+  spec: string;
+  command: string;
 };
 type MarketplaceMcpTemplateInput = {
-    id: string;
-    label: string;
-    description?: string;
-    required?: boolean;
-    secret?: boolean;
-    defaultValue?: string;
+  id: string;
+  label: string;
+  description?: string;
+  required?: boolean;
+  secret?: boolean;
+  defaultValue?: string;
 };
 type MarketplaceMcpInstallSpec = MarketplaceInstallSpec & {
-    kind: "template";
-    defaultName: string;
-    transportTypes: Array<"stdio" | "http" | "sse">;
-    template: Record<string, unknown>;
-    inputs: MarketplaceMcpTemplateInput[];
+  kind: "template";
+  defaultName: string;
+  transportTypes: Array<"stdio" | "http" | "sse">;
+  template: Record<string, unknown>;
+  inputs: MarketplaceMcpTemplateInput[];
 };
 type MarketplaceLocalizedTextMap = Record<string, string>;
 type MarketplaceItemSummary = {
-    id: string;
-    slug: string;
-    type: MarketplaceItemType;
-    name: string;
-    summary: string;
-    summaryI18n: MarketplaceLocalizedTextMap;
-    tags: string[];
-    author: string;
-    install: MarketplaceInstallSpec;
-    updatedAt: string;
+  id: string;
+  slug: string;
+  type: MarketplaceItemType;
+  name: string;
+  summary: string;
+  summaryI18n: MarketplaceLocalizedTextMap;
+  tags: string[];
+  author: string;
+  install: MarketplaceInstallSpec;
+  updatedAt: string;
 };
 type MarketplaceItemView = MarketplaceItemSummary & {
-    description?: string;
-    descriptionI18n?: MarketplaceLocalizedTextMap;
-    sourceRepo?: string;
-    homepage?: string;
-    publishedAt: string;
+  description?: string;
+  descriptionI18n?: MarketplaceLocalizedTextMap;
+  sourceRepo?: string;
+  homepage?: string;
+  publishedAt: string;
 };
 type MarketplaceSkillContentView = {
-    type: "skill";
-    slug: string;
-    name: string;
-    install: MarketplaceInstallSpec;
-    source: "builtin" | "marketplace" | "remote";
-    raw: string;
-    metadataRaw?: string;
-    bodyRaw: string;
-    sourceUrl?: string;
+  type: "skill";
+  slug: string;
+  name: string;
+  install: MarketplaceInstallSpec;
+  source: "builtin" | "marketplace" | "remote";
+  raw: string;
+  metadataRaw?: string;
+  bodyRaw: string;
+  sourceUrl?: string;
 };
 type MarketplacePluginContentView = {
-    type: "plugin";
-    slug: string;
-    name: string;
-    install: MarketplaceInstallSpec;
-    source: "npm" | "repo" | "remote";
-    raw?: string;
-    bodyRaw?: string;
-    metadataRaw?: string;
-    sourceUrl?: string;
+  type: "plugin";
+  slug: string;
+  name: string;
+  install: MarketplaceInstallSpec;
+  source: "npm" | "repo" | "remote";
+  raw?: string;
+  bodyRaw?: string;
+  metadataRaw?: string;
+  sourceUrl?: string;
 };
 type MarketplaceMcpContentView = {
-    type: "mcp";
-    slug: string;
-    name: string;
-    install: MarketplaceMcpInstallSpec;
-    source: "marketplace" | "remote";
-    raw: string;
-    metadataRaw?: string;
-    bodyRaw: string;
-    sourceUrl?: string;
+  type: "mcp";
+  slug: string;
+  name: string;
+  install: MarketplaceMcpInstallSpec;
+  source: "marketplace" | "remote";
+  raw: string;
+  metadataRaw?: string;
+  bodyRaw: string;
+  sourceUrl?: string;
 };
 type MarketplaceListView = {
-    total: number;
-    page: number;
-    pageSize: number;
-    totalPages: number;
-    sort: MarketplaceSort;
-    query?: string;
-    items: MarketplaceItemSummary[];
+  total: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  sort: MarketplaceSort;
+  query?: string;
+  items: MarketplaceItemSummary[];
 };
 type MarketplaceRecommendationView = {
-    type: MarketplaceItemType;
-    sceneId: string;
-    title: string;
-    description?: string;
-    total: number;
-    items: MarketplaceItemSummary[];
+  type: MarketplaceItemType;
+  sceneId: string;
+  title: string;
+  description?: string;
+  total: number;
+  items: MarketplaceItemSummary[];
 };
 type MarketplaceInstalledRecord = {
-    type: MarketplaceItemType;
-    id?: string;
-    spec: string;
-    label?: string;
-    description?: string;
-    descriptionZh?: string;
-    source?: string;
-    installedAt?: string;
-    enabled?: boolean;
-    runtimeStatus?: string;
-    origin?: string;
-    installPath?: string;
-    transport?: "stdio" | "http" | "sse";
-    scope?: {
-        allAgents: boolean;
-        agents: string[];
-    };
-    catalogSlug?: string;
-    vendor?: string;
-    docsUrl?: string;
-    homepage?: string;
-    trustLevel?: "official" | "verified" | "community";
-    toolCount?: number;
-    accessible?: boolean;
-    lastReadyAt?: string;
-    lastDoctorAt?: string;
-    lastError?: string;
+  type: MarketplaceItemType;
+  id?: string;
+  spec: string;
+  label?: string;
+  description?: string;
+  descriptionZh?: string;
+  source?: string;
+  installedAt?: string;
+  enabled?: boolean;
+  runtimeStatus?: string;
+  origin?: string;
+  installPath?: string;
+  transport?: "stdio" | "http" | "sse";
+  scope?: {
+    allAgents: boolean;
+    agents: string[];
+  };
+  catalogSlug?: string;
+  vendor?: string;
+  docsUrl?: string;
+  homepage?: string;
+  trustLevel?: "official" | "verified" | "community";
+  toolCount?: number;
+  accessible?: boolean;
+  lastReadyAt?: string;
+  lastDoctorAt?: string;
+  lastError?: string;
 };
 type MarketplaceInstalledView = {
-    type: MarketplaceItemType;
-    total: number;
-    specs: string[];
-    records: MarketplaceInstalledRecord[];
+  type: MarketplaceItemType;
+  total: number;
+  specs: string[];
+  records: MarketplaceInstalledRecord[];
 };
 type MarketplaceInstallSkillParams = {
-    slug: string;
-    kind?: MarketplaceSkillInstallKind;
-    skill?: string;
-    installPath?: string;
-    force?: boolean;
+  slug: string;
+  kind?: MarketplaceSkillInstallKind;
+  skill?: string;
+  installPath?: string;
+  force?: boolean;
 };
 type MarketplacePluginInstallRequest = {
-    type?: "plugin";
-    spec: string;
+  type?: "plugin";
+  spec: string;
 };
 type MarketplaceSkillInstallRequest = {
-    type?: "skill";
-    spec: string;
-    kind?: MarketplaceSkillInstallKind;
-    skill?: string;
-    installPath?: string;
-    force?: boolean;
+  type?: "skill";
+  spec: string;
+  kind?: MarketplaceSkillInstallKind;
+  skill?: string;
+  installPath?: string;
+  force?: boolean;
 };
 type MarketplaceMcpInstallRequest = {
-    type?: "mcp";
-    spec: string;
-    name?: string;
-    enabled?: boolean;
-    allAgents?: boolean;
-    agents?: string[];
-    inputs?: Record<string, string>;
-    template?: MarketplaceMcpInstallSpec;
+  type?: "mcp";
+  spec: string;
+  name?: string;
+  enabled?: boolean;
+  allAgents?: boolean;
+  agents?: string[];
+  inputs?: Record<string, string>;
+  template?: MarketplaceMcpInstallSpec;
 };
 type MarketplacePluginInstallResult = {
-    type: "plugin";
-    spec: string;
-    message: string;
-    output?: string;
+  type: "plugin";
+  spec: string;
+  message: string;
+  output?: string;
 };
 type MarketplaceSkillInstallResult = {
-    type: "skill";
-    spec: string;
-    message: string;
-    output?: string;
+  type: "skill";
+  spec: string;
+  message: string;
+  output?: string;
 };
 type MarketplaceMcpInstallResult = {
-    type: "mcp";
-    spec: string;
-    name: string;
-    message: string;
-    output?: string;
+  type: "mcp";
+  spec: string;
+  name: string;
+  message: string;
+  output?: string;
 };
 type MarketplacePluginManageAction = "enable" | "disable" | "uninstall";
 type MarketplaceSkillManageAction = "uninstall";
 type MarketplaceMcpManageAction = "enable" | "disable" | "remove";
 type MarketplacePluginManageRequest = {
-    type?: "plugin";
-    action: MarketplacePluginManageAction;
-    id?: string;
-    spec?: string;
+  type?: "plugin";
+  action: MarketplacePluginManageAction;
+  id?: string;
+  spec?: string;
 };
 type MarketplaceSkillManageRequest = {
-    type?: "skill";
-    action: MarketplaceSkillManageAction;
-    id?: string;
-    spec?: string;
+  type?: "skill";
+  action: MarketplaceSkillManageAction;
+  id?: string;
+  spec?: string;
 };
 type MarketplaceMcpManageRequest = {
-    type?: "mcp";
-    action: MarketplaceMcpManageAction;
-    id?: string;
-    spec?: string;
+  type?: "mcp";
+  action: MarketplaceMcpManageAction;
+  id?: string;
+  spec?: string;
 };
 type MarketplacePluginManageResult = {
-    type: "plugin";
-    action: MarketplacePluginManageAction;
-    id: string;
-    message: string;
-    output?: string;
+  type: "plugin";
+  action: MarketplacePluginManageAction;
+  id: string;
+  message: string;
+  output?: string;
 };
 type MarketplaceSkillManageResult = {
-    type: "skill";
-    action: MarketplaceSkillManageAction;
-    id: string;
-    message: string;
-    output?: string;
+  type: "skill";
+  action: MarketplaceSkillManageAction;
+  id: string;
+  message: string;
+  output?: string;
 };
 type MarketplaceMcpManageResult = {
-    type: "mcp";
-    action: MarketplaceMcpManageAction;
-    id: string;
-    message: string;
-    output?: string;
+  type: "mcp";
+  action: MarketplaceMcpManageAction;
+  id: string;
+  message: string;
+  output?: string;
 };
 type MarketplaceMcpDoctorResult = {
-    name: string;
-    enabled: boolean;
-    transport: "stdio" | "http" | "sse";
-    accessible: boolean;
-    toolCount: number;
-    error?: string;
+  name: string;
+  enabled: boolean;
+  transport: "stdio" | "http" | "sse";
+  accessible: boolean;
+  toolCount: number;
+  error?: string;
 };
 type MarketplaceInstaller = {
-    installPlugin?: (spec: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    installSkill?: (params: MarketplaceInstallSkillParams) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    enablePlugin?: (id: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    disablePlugin?: (id: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    uninstallPlugin?: (id: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    uninstallSkill?: (slug: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    installMcp?: (params: MarketplaceMcpInstallRequest) => Promise<{
-        name: string;
-        message: string;
-        output?: string;
-    }>;
-    enableMcp?: (name: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    disableMcp?: (name: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    removeMcp?: (name: string) => Promise<{
-        message: string;
-        output?: string;
-    }>;
-    doctorMcp?: (name: string) => Promise<MarketplaceMcpDoctorResult>;
+  installPlugin?: (spec: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  installSkill?: (params: MarketplaceInstallSkillParams) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  enablePlugin?: (id: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  disablePlugin?: (id: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  uninstallPlugin?: (id: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  uninstallSkill?: (slug: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  installMcp?: (params: MarketplaceMcpInstallRequest) => Promise<{
+    name: string;
+    message: string;
+    output?: string;
+  }>;
+  enableMcp?: (name: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  disableMcp?: (name: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  removeMcp?: (name: string) => Promise<{
+    message: string;
+    output?: string;
+  }>;
+  doctorMcp?: (name: string) => Promise<MarketplaceMcpDoctorResult>;
 };
 type MarketplaceApiConfig = {
-    apiBaseUrl?: string;
-    installer?: MarketplaceInstaller;
+  apiBaseUrl?: string;
+  installer?: MarketplaceInstaller;
 };
-
+//#endregion
+//#region src/ui/auth.service.d.ts
 declare class UiAuthService {
-    private readonly configPath;
-    private readonly sessions;
-    constructor(configPath: string);
-    private loadCurrentConfig;
-    private saveCurrentConfig;
-    private readAuthConfig;
-    private isConfigured;
-    isProtectionEnabled(): boolean;
-    private getSessionIdFromCookieHeader;
-    private getValidSession;
-    isRequestAuthenticated(request: Request): boolean;
-    isSocketAuthenticated(request: IncomingMessage): boolean;
-    getStatus(request: Request): AuthStatusView;
-    private createSession;
-    private clearAllSessions;
-    private deleteRequestSession;
-    private buildLoginCookie;
-    buildTrustedRequestCookieHeader(): string | null;
-    buildLogoutCookie(request: Request): string;
-    setup(request: Request, payload: AuthSetupRequest): {
-        status: AuthStatusView;
-        cookie: string;
-    };
-    login(request: Request, payload: AuthLoginRequest): {
-        status: AuthStatusView;
-        cookie: string;
-    };
-    logout(request: Request): void;
-    updatePassword(request: Request, payload: AuthPasswordUpdateRequest): {
-        status: AuthStatusView;
-        cookie?: string;
-    };
-    updateEnabled(request: Request, payload: AuthEnabledUpdateRequest): {
-        status: AuthStatusView;
-        cookie?: string;
-    };
+  private readonly configPath;
+  private readonly sessions;
+  constructor(configPath: string);
+  private loadCurrentConfig;
+  private saveCurrentConfig;
+  private readAuthConfig;
+  private isConfigured;
+  isProtectionEnabled(): boolean;
+  private getSessionIdFromCookieHeader;
+  private getValidSession;
+  isRequestAuthenticated(request: Request): boolean;
+  isSocketAuthenticated(request: IncomingMessage): boolean;
+  getStatus(request: Request): AuthStatusView;
+  private createSession;
+  private clearAllSessions;
+  private deleteRequestSession;
+  private buildLoginCookie;
+  buildTrustedRequestCookieHeader(): string | null;
+  buildLogoutCookie(request: Request): string;
+  setup(request: Request, payload: AuthSetupRequest): {
+    status: AuthStatusView;
+    cookie: string;
+  };
+  login(request: Request, payload: AuthLoginRequest): {
+    status: AuthStatusView;
+    cookie: string;
+  };
+  logout(request: Request): void;
+  updatePassword(request: Request, payload: AuthPasswordUpdateRequest): {
+    status: AuthStatusView;
+    cookie?: string;
+  };
+  updateEnabled(request: Request, payload: AuthEnabledUpdateRequest): {
+    status: AuthStatusView;
+    cookie?: string;
+  };
 }
-
+//#endregion
+//#region src/ui/ui-routes/types.d.ts
 type UiRouterOptions = {
-    configPath: string;
-    productVersion?: string;
-    publish: (event: UiServerEvent) => void;
-    applyLiveConfigReload?: () => Promise<void>;
-    marketplace?: MarketplaceApiConfig;
-    cronService?: InstanceType<typeof NextclawCore.CronService>;
-    ncpAgent?: UiNcpAgent;
-    ncpSessionService?: UiNcpSessionService;
-    authService?: UiAuthService;
-    remoteAccess?: UiRemoteAccessHost;
-    getBootstrapStatus?: () => BootstrapStatusView;
-    getPluginChannelBindings?: () => PluginChannelBinding[];
-    getPluginUiMetadata?: () => PluginUiMetadata[];
+  configPath: string;
+  productVersion?: string;
+  publish: (event: UiServerEvent) => void;
+  applyLiveConfigReload?: () => Promise<void>;
+  initializeAgentHomeDirectory?: (homeDirectory: string) => void;
+  marketplace?: MarketplaceApiConfig;
+  cronService?: InstanceType<typeof NextclawCore.CronService>;
+  ncpAgent?: UiNcpAgent;
+  ncpSessionService?: UiNcpSessionService;
+  authService?: UiAuthService;
+  remoteAccess?: UiRemoteAccessHost;
+  getBootstrapStatus?: () => BootstrapStatusView;
+  getPluginChannelBindings?: () => PluginChannelBinding[];
+  getPluginUiMetadata?: () => PluginUiMetadata[];
 };
 type UiRemoteAccessHost = {
-    getStatus: () => Promise<RemoteAccessView> | RemoteAccessView;
-    login: (input: RemoteLoginRequest) => Promise<RemoteAccessView>;
-    startBrowserAuth: (input: RemoteBrowserAuthStartRequest) => Promise<RemoteBrowserAuthStartResult>;
-    pollBrowserAuth: (input: RemoteBrowserAuthPollRequest) => Promise<RemoteBrowserAuthPollResult>;
-    logout: () => Promise<RemoteAccessView> | RemoteAccessView;
-    updateSettings: (input: RemoteSettingsUpdateRequest) => Promise<RemoteAccessView> | RemoteAccessView;
-    runDoctor: () => Promise<RemoteDoctorView>;
-    controlService: (action: RemoteServiceAction) => Promise<RemoteServiceActionResult>;
-};
-
+  getStatus: () => Promise<RemoteAccessView> | RemoteAccessView;
+  login: (input: RemoteLoginRequest) => Promise<RemoteAccessView>;
+  startBrowserAuth: (input: RemoteBrowserAuthStartRequest) => Promise<RemoteBrowserAuthStartResult>;
+  pollBrowserAuth: (input: RemoteBrowserAuthPollRequest) => Promise<RemoteBrowserAuthPollResult>;
+  logout: () => Promise<RemoteAccessView> | RemoteAccessView;
+  updateSettings: (input: RemoteSettingsUpdateRequest) => Promise<RemoteAccessView> | RemoteAccessView;
+  runDoctor: () => Promise<RemoteDoctorView>;
+  controlService: (action: RemoteServiceAction) => Promise<RemoteServiceActionResult>;
+};
+//#endregion
+//#region src/ui/chat-session-type.types.d.ts
 type ChatSessionTypeCtaView = {
-    kind: string;
-    label?: string;
-    href?: string;
+  kind: string;
+  label?: string;
+  href?: string;
 };
 type ChatSessionTypeOptionView = {
-    value: string;
-    label: string;
-    ready?: boolean;
-    reason?: string | null;
-    reasonMessage?: string | null;
-    supportedModels?: string[];
-    recommendedModel?: string | null;
-    cta?: ChatSessionTypeCtaView | null;
+  value: string;
+  label: string;
+  ready?: boolean;
+  reason?: string | null;
+  reasonMessage?: string | null;
+  supportedModels?: string[];
+  recommendedModel?: string | null;
+  cta?: ChatSessionTypeCtaView | null;
 };
 type ChatSessionTypesView = {
-    defaultType: string;
-    options: ChatSessionTypeOptionView[];
+  defaultType: string;
+  options: ChatSessionTypeOptionView[];
 };
-
+//#endregion
+//#region src/ui/types.d.ts
 type ApiError = {
-    code: string;
-    message: string;
-    details?: Record<string, unknown>;
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
 };
 type ApiResponse<T> = {
-    ok: true;
-    data: T;
+  ok: true;
+  data: T;
 } | {
-    ok: false;
-    error: ApiError;
+  ok: false;
+  error: ApiError;
 };
 type AppMetaView = {
-    name: string;
-    productVersion: string;
+  name: string;
+  productVersion: string;
 };
 type BootstrapPhase = "kernel-starting" | "shell-ready" | "hydrating-capabilities" | "ready" | "error";
 type BootstrapStageState = "pending" | "running" | "ready" | "error";
 type BootstrapRemoteState = "pending" | "ready" | "conflict" | "disabled" | "error";
 type BootstrapStatusView = {
-    phase: BootstrapPhase;
-    shellReadyAt?: string;
-    pluginHydration: {
-        state: BootstrapStageState;
-        loadedPluginCount: number;
-        totalPluginCount: number;
-        startedAt?: string;
-        completedAt?: string;
-        error?: string;
-    };
-    channels: {
-        state: BootstrapStageState;
-        enabled: string[];
-        error?: string;
-    };
-    remote: {
-        state: BootstrapRemoteState;
-        message?: string;
-    };
-    lastError?: string;
+  phase: BootstrapPhase;
+  shellReadyAt?: string;
+  pluginHydration: {
+    state: BootstrapStageState;
+    loadedPluginCount: number;
+    totalPluginCount: number;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+  };
+  channels: {
+    state: BootstrapStageState;
+    enabled: string[];
+    error?: string;
+  };
+  remote: {
+    state: BootstrapRemoteState;
+    message?: string;
+  };
+  lastError?: string;
 };
 type ProviderConfigView = {
-    enabled: boolean;
-    displayName?: string;
-    apiKeySet: boolean;
-    apiKeyMasked?: string;
-    apiBase?: string | null;
-    extraHeaders?: Record<string, string> | null;
-    wireApi?: "auto" | "chat" | "responses" | null;
-    models?: string[];
-    modelThinking?: Record<string, {
-        supported: ThinkingLevel[];
-        default?: ThinkingLevel | null;
-    }>;
+  enabled: boolean;
+  displayName?: string;
+  apiKeySet: boolean;
+  apiKeyMasked?: string;
+  apiBase?: string | null;
+  extraHeaders?: Record<string, string> | null;
+  wireApi?: "auto" | "chat" | "responses" | null;
+  models?: string[];
+  modelThinking?: Record<string, {
+    supported: ThinkingLevel[];
+    default?: ThinkingLevel | null;
+  }>;
 };
 type ProviderConfigUpdate = {
-    enabled?: boolean;
-    displayName?: string | null;
-    apiKey?: string | null;
-    apiBase?: string | null;
-    extraHeaders?: Record<string, string> | null;
-    wireApi?: "auto" | "chat" | "responses" | null;
-    models?: string[] | null;
-    modelThinking?: Record<string, {
-        supported?: ThinkingLevel[];
-        default?: ThinkingLevel | null;
-    }> | null;
+  enabled?: boolean;
+  displayName?: string | null;
+  apiKey?: string | null;
+  apiBase?: string | null;
+  extraHeaders?: Record<string, string> | null;
+  wireApi?: "auto" | "chat" | "responses" | null;
+  models?: string[] | null;
+  modelThinking?: Record<string, {
+    supported?: ThinkingLevel[];
+    default?: ThinkingLevel | null;
+  }> | null;
 };
 type ProviderConnectionTestRequest = ProviderConfigUpdate & {
-    model?: string | null;
+  model?: string | null;
 };
 type ProviderCreateRequest = ProviderConfigUpdate;
 type ProviderCreateResult = {
-    name: string;
-    provider: ProviderConfigView;
+  name: string;
+  provider: ProviderConfigView;
 };
 type ProviderDeleteResult = {
-    deleted: boolean;
-    provider: string;
+  deleted: boolean;
+  provider: string;
 };
 type ProviderConnectionTestResult = {
-    success: boolean;
-    provider: string;
-    model?: string;
-    latencyMs: number;
-    message: string;
+  success: boolean;
+  provider: string;
+  model?: string;
+  latencyMs: number;
+  message: string;
 };
 type SearchProviderName = "bocha" | "brave";
 type BochaFreshnessValue = "noLimit" | "oneDay" | "oneWeek" | "oneMonth" | "oneYear" | string;
 type SearchProviderConfigView = {
-    enabled: boolean;
-    apiKeySet: boolean;
-    apiKeyMasked?: string;
-    baseUrl: string;
-    docsUrl?: string;
-    summary?: boolean;
-    freshness?: BochaFreshnessValue;
+  enabled: boolean;
+  apiKeySet: boolean;
+  apiKeyMasked?: string;
+  baseUrl: string;
+  docsUrl?: string;
+  summary?: boolean;
+  freshness?: BochaFreshnessValue;
 };
 type SearchConfigView = {
-    provider: SearchProviderName;
-    enabledProviders: SearchProviderName[];
-    defaults: {
-        maxResults: number;
-    };
-    providers: {
-        bocha: SearchProviderConfigView;
-        brave: SearchProviderConfigView;
-    };
+  provider: SearchProviderName;
+  enabledProviders: SearchProviderName[];
+  defaults: {
+    maxResults: number;
+  };
+  providers: {
+    bocha: SearchProviderConfigView;
+    brave: SearchProviderConfigView;
+  };
 };
 type SearchConfigUpdate = {
-    provider?: SearchProviderName;
-    enabledProviders?: SearchProviderName[];
-    defaults?: {
-        maxResults?: number;
+  provider?: SearchProviderName;
+  enabledProviders?: SearchProviderName[];
+  defaults?: {
+    maxResults?: number;
+  };
+  providers?: {
+    bocha?: {
+      apiKey?: string | null;
+      baseUrl?: string | null;
+      docsUrl?: string | null;
+      summary?: boolean;
+      freshness?: BochaFreshnessValue | null;
     };
-    providers?: {
-        bocha?: {
-            apiKey?: string | null;
-            baseUrl?: string | null;
-            docsUrl?: string | null;
-            summary?: boolean;
-            freshness?: BochaFreshnessValue | null;
-        };
-        brave?: {
-            apiKey?: string | null;
-            baseUrl?: string | null;
-        };
+    brave?: {
+      apiKey?: string | null;
+      baseUrl?: string | null;
     };
+  };
 };
 type ProviderAuthStartResult = {
-    provider: string;
-    kind: "device_code";
-    methodId?: string;
-    sessionId: string;
-    verificationUri: string;
-    userCode: string;
-    expiresAt: string;
-    intervalMs: number;
-    note?: string;
+  provider: string;
+  kind: "device_code";
+  methodId?: string;
+  sessionId: string;
+  verificationUri: string;
+  userCode: string;
+  expiresAt: string;
+  intervalMs: number;
+  note?: string;
 };
 type ProviderAuthStartRequest = {
-    methodId?: string;
+  methodId?: string;
 };
 type ProviderAuthPollRequest = {
-    sessionId: string;
+  sessionId: string;
 };
 type ProviderAuthPollResult = {
-    provider: string;
-    status: "pending" | "authorized" | "denied" | "expired" | "error";
-    message?: string;
-    nextPollMs?: number;
+  provider: string;
+  status: "pending" | "authorized" | "denied" | "expired" | "error";
+  message?: string;
+  nextPollMs?: number;
 };
 type ProviderAuthImportResult = {
-    provider: string;
-    status: "imported";
-    source: "cli";
-    expiresAt?: string;
+  provider: string;
+  status: "imported";
+  source: "cli";
+  expiresAt?: string;
 };
 type ChannelAuthStartRequest = {
-    accountId?: string;
-    baseUrl?: string;
+  accountId?: string;
+  baseUrl?: string;
 };
 type ChannelAuthStartResult = {
-    channel: string;
-    kind: "qr_code";
-    sessionId: string;
-    qrCode: string;
-    qrCodeUrl: string;
-    expiresAt: string;
-    intervalMs: number;
-    note?: string;
+  channel: string;
+  kind: "qr_code";
+  sessionId: string;
+  qrCode: string;
+  qrCodeUrl: string;
+  expiresAt: string;
+  intervalMs: number;
+  note?: string;
 };
 type ChannelAuthPollRequest = {
-    sessionId: string;
+  sessionId: string;
 };
 type ChannelAuthPollResult = {
-    channel: string;
-    status: "pending" | "scanned" | "authorized" | "expired" | "error";
-    message?: string;
-    nextPollMs?: number;
-    accountId?: string | null;
-    notes?: string[];
+  channel: string;
+  status: "pending" | "scanned" | "authorized" | "expired" | "error";
+  message?: string;
+  nextPollMs?: number;
+  accountId?: string | null;
+  notes?: string[];
 };
 type AuthStatusView = {
-    enabled: boolean;
-    configured: boolean;
-    authenticated: boolean;
-    username?: string;
+  enabled: boolean;
+  configured: boolean;
+  authenticated: boolean;
+  username?: string;
 };
 type AuthSetupRequest = {
-    username: string;
-    password: string;
+  username: string;
+  password: string;
 };
 type AuthLoginRequest = {
-    username: string;
-    password: string;
+  username: string;
+  password: string;
 };
 type AuthPasswordUpdateRequest = {
-    password: string;
+  password: string;
 };
 type AuthEnabledUpdateRequest = {
-    enabled: boolean;
+  enabled: boolean;
 };
 type RemoteAccountView = {
-    loggedIn: boolean;
-    email?: string;
-    role?: string;
-    platformBase?: string | null;
-    apiBase?: string | null;
+  loggedIn: boolean;
+  email?: string;
+  role?: string;
+  platformBase?: string | null;
+  apiBase?: string | null;
 };
 type RemoteRuntimeView = {
-    enabled: boolean;
-    mode: "service" | "foreground";
-    state: "disabled" | "connecting" | "connected" | "disconnected" | "error";
-    deviceId?: string;
-    deviceName?: string;
-    platformBase?: string;
-    localOrigin?: string;
-    lastConnectedAt?: string | null;
-    lastError?: string | null;
-    updatedAt: string;
+  enabled: boolean;
+  mode: "service" | "foreground";
+  state: "disabled" | "connecting" | "connected" | "disconnected" | "error";
+  deviceId?: string;
+  deviceName?: string;
+  platformBase?: string;
+  localOrigin?: string;
+  lastConnectedAt?: string | null;
+  lastError?: string | null;
+  updatedAt: string;
 };
 type RemoteServiceView = {
-    running: boolean;
-    pid?: number;
-    uiUrl?: string;
-    uiPort?: number;
-    currentProcess: boolean;
+  running: boolean;
+  pid?: number;
+  uiUrl?: string;
+  uiPort?: number;
+  currentProcess: boolean;
 };
 type RemoteSettingsView = {
-    enabled: boolean;
-    deviceName: string;
-    platformApiBase: string;
+  enabled: boolean;
+  deviceName: string;
+  platformApiBase: string;
 };
 type RemoteAccessView = {
-    account: RemoteAccountView;
-    settings: RemoteSettingsView;
-    service: RemoteServiceView;
-    localOrigin: string;
-    configuredEnabled: boolean;
-    platformBase?: string | null;
-    runtime: RemoteRuntimeView | null;
+  account: RemoteAccountView;
+  settings: RemoteSettingsView;
+  service: RemoteServiceView;
+  localOrigin: string;
+  configuredEnabled: boolean;
+  platformBase?: string | null;
+  runtime: RemoteRuntimeView | null;
 };
 type RemoteDoctorCheckView = {
-    name: string;
-    ok: boolean;
-    detail: string;
+  name: string;
+  ok: boolean;
+  detail: string;
 };
 type RemoteDoctorView = {
-    generatedAt: string;
-    checks: RemoteDoctorCheckView[];
-    snapshot: {
-        configuredEnabled: boolean;
-        runtime: RemoteRuntimeView | null;
-    };
+  generatedAt: string;
+  checks: RemoteDoctorCheckView[];
+  snapshot: {
+    configuredEnabled: boolean;
+    runtime: RemoteRuntimeView | null;
+  };
 };
 type RemoteLoginRequest = {
-    email: string;
-    password: string;
-    apiBase?: string;
+  email: string;
+  password: string;
+  apiBase?: string;
 };
 type RemoteBrowserAuthStartRequest = {
-    apiBase?: string;
+  apiBase?: string;
 };
 type RemoteBrowserAuthStartResult = {
-    sessionId: string;
-    verificationUri: string;
-    expiresAt: string;
-    intervalMs: number;
+  sessionId: string;
+  verificationUri: string;
+  expiresAt: string;
+  intervalMs: number;
 };
 type RemoteBrowserAuthPollRequest = {
-    sessionId: string;
-    apiBase?: string;
+  sessionId: string;
+  apiBase?: string;
 };
 type RemoteBrowserAuthPollResult = {
-    status: "pending" | "authorized" | "expired";
-    message?: string;
-    nextPollMs?: number;
-    email?: string;
-    role?: string;
+  status: "pending" | "authorized" | "expired";
+  message?: string;
+  nextPollMs?: number;
+  email?: string;
+  role?: string;
 };
 type RemoteSettingsUpdateRequest = {
-    enabled?: boolean;
-    deviceName?: string;
-    platformApiBase?: string;
+  enabled?: boolean;
+  deviceName?: string;
+  platformApiBase?: string;
 };
 type RemoteServiceAction = "start" | "restart" | "stop";
 type RemoteServiceActionResult = {
-    accepted: boolean;
-    action: RemoteServiceAction;
-    message: string;
+  accepted: boolean;
+  action: RemoteServiceAction;
+  message: string;
 };
 type AgentProfileView = {
-    id: string;
-    default?: boolean;
-    workspace?: string;
-    model?: string;
-    engine?: string;
-    engineConfig?: Record<string, unknown>;
-    contextTokens?: number;
-    maxToolIterations?: number;
+  id: string;
+  default?: boolean;
+  displayName?: string;
+  description?: string;
+  avatar?: string;
+  avatarUrl?: string;
+  workspace?: string;
+  model?: string;
+  engine?: string;
+  engineConfig?: Record<string, unknown>;
+  contextTokens?: number;
+  maxToolIterations?: number;
+  builtIn?: boolean;
+};
+type AgentCreateRequest = {
+  id: string;
+  displayName?: string;
+  description?: string;
+  avatar?: string;
+  home?: string;
+};
+type AgentDeleteResult = {
+  deleted: boolean;
+  agentId: string;
 };
 type BindingPeerView = {
-    kind: "direct" | "group" | "channel";
-    id: string;
+  kind: "direct" | "group" | "channel";
+  id: string;
 };
 type AgentBindingView = {
-    agentId: string;
-    match: {
-        channel: string;
-        accountId?: string;
-        peer?: BindingPeerView;
-    };
+  agentId: string;
+  match: {
+    channel: string;
+    accountId?: string;
+    peer?: BindingPeerView;
+  };
 };
 type SessionConfigView = {
-    dmScope?: "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
-    agentToAgent?: {
-        maxPingPongTurns?: number;
-    };
+  dmScope?: "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
 };
-
 type SessionEntryView = {
-    key: string;
-    createdAt: string;
-    updatedAt: string;
-    label?: string;
-    preferredModel?: string;
-    preferredThinking?: ThinkingLevel | null;
-    sessionType: string;
-    sessionTypeMutable: boolean;
-    messageCount: number;
-    lastRole?: string;
-    lastTimestamp?: string;
+  key: string;
+  createdAt: string;
+  updatedAt: string;
+  label?: string;
+  preferredModel?: string;
+  preferredThinking?: ThinkingLevel | null;
+  sessionType: string;
+  sessionTypeMutable: boolean;
+  messageCount: number;
+  lastRole?: string;
+  lastTimestamp?: string;
 };
 type SessionsListView = {
-    sessions: SessionEntryView[];
-    total: number;
+  sessions: SessionEntryView[];
+  total: number;
 };
 type SessionMessageView = {
-    role: string;
-    content: unknown;
-    timestamp: string;
-    name?: string;
-    tool_call_id?: string;
-    tool_calls?: Array<Record<string, unknown>>;
-    reasoning_content?: string;
+  role: string;
+  content: unknown;
+  timestamp: string;
+  name?: string;
+  tool_call_id?: string;
+  tool_calls?: Array<Record<string, unknown>>;
+  reasoning_content?: string;
 };
 type SessionEventView = {
-    seq: number;
-    type: string;
-    timestamp: string;
-    message?: SessionMessageView;
+  seq: number;
+  type: string;
+  timestamp: string;
+  message?: SessionMessageView;
 };
 type SessionHistoryView = {
-    key: string;
-    totalMessages: number;
-    totalEvents: number;
-    sessionType: string;
-    sessionTypeMutable: boolean;
-    metadata: Record<string, unknown>;
-    messages: SessionMessageView[];
-    events: SessionEventView[];
+  key: string;
+  totalMessages: number;
+  totalEvents: number;
+  sessionType: string;
+  sessionTypeMutable: boolean;
+  metadata: Record<string, unknown>;
+  messages: SessionMessageView[];
+  events: SessionEventView[];
 };
 type SessionPatchUpdate = {
-    label?: string | null;
-    preferredModel?: string | null;
-    preferredThinking?: ThinkingLevel | null;
-    sessionType?: string | null;
-    projectRoot?: string | null;
-    clearHistory?: boolean;
+  label?: string | null;
+  preferredModel?: string | null;
+  preferredThinking?: ThinkingLevel | null;
+  sessionType?: string | null;
+  projectRoot?: string | null;
+  clearHistory?: boolean;
 };
 type SessionSkillEntryView = {
-    ref: string;
-    name: string;
-    path: string;
-    scope: "project" | "workspace";
-    source: "project" | "workspace";
-    available: boolean;
-    description?: string;
-    descriptionZh?: string;
+  ref: string;
+  name: string;
+  path: string;
+  scope: "builtin" | "project" | "workspace";
+  source: "builtin" | "project" | "workspace";
+  available: boolean;
+  description?: string;
+  descriptionZh?: string;
 };
 type NcpSessionSkillsView = {
-    sessionId: string;
-    total: number;
-    refs: string[];
-    records: SessionSkillEntryView[];
+  sessionId: string;
+  total: number;
+  refs: string[];
+  records: SessionSkillEntryView[];
 };
 type ServerPathEntryView = {
-    name: string;
-    path: string;
-    kind: "directory" | "file";
-    hidden: boolean;
+  name: string;
+  path: string;
+  kind: "directory" | "file";
+  hidden: boolean;
 };
 type ServerPathBreadcrumbView = {
-    label: string;
-    path: string;
+  label: string;
+  path: string;
 };
 type ServerPathBrowseView = {
-    currentPath: string;
-    parentPath: string | null;
-    homePath: string;
-    breadcrumbs: ServerPathBreadcrumbView[];
-    entries: ServerPathEntryView[];
+  currentPath: string;
+  parentPath: string | null;
+  homePath: string;
+  breadcrumbs: ServerPathBreadcrumbView[];
+  entries: ServerPathEntryView[];
 };
 type CronScheduleView = {
-    kind: "at";
-    atMs?: number | null;
+  kind: "at";
+  atMs?: number | null;
 } | {
-    kind: "every";
-    everyMs?: number | null;
+  kind: "every";
+  everyMs?: number | null;
 } | {
-    kind: "cron";
-    expr?: string | null;
-    tz?: string | null;
+  kind: "cron";
+  expr?: string | null;
+  tz?: string | null;
 };
 type CronPayloadView = {
-    kind?: "system_event" | "agent_turn";
-    message: string;
-    deliver?: boolean;
-    channel?: string | null;
-    to?: string | null;
+  kind?: "system_event" | "agent_turn";
+  message: string;
+  deliver?: boolean;
+  channel?: string | null;
+  to?: string | null;
 };
 type CronJobStateView = {
-    nextRunAt?: string | null;
-    lastRunAt?: string | null;
-    lastStatus?: "ok" | "error" | "skipped" | null;
-    lastError?: string | null;
+  nextRunAt?: string | null;
+  lastRunAt?: string | null;
+  lastStatus?: "ok" | "error" | "skipped" | null;
+  lastError?: string | null;
 };
 type CronJobView = {
-    id: string;
-    name: string;
-    enabled: boolean;
-    schedule: CronScheduleView;
-    payload: CronPayloadView;
-    state: CronJobStateView;
-    createdAt: string;
-    updatedAt: string;
-    deleteAfterRun: boolean;
+  id: string;
+  name: string;
+  enabled: boolean;
+  schedule: CronScheduleView;
+  payload: CronPayloadView;
+  state: CronJobStateView;
+  createdAt: string;
+  updatedAt: string;
+  deleteAfterRun: boolean;
 };
 type CronListView = {
-    jobs: CronJobView[];
-    total: number;
+  jobs: CronJobView[];
+  total: number;
 };
 type CronEnableRequest = {
-    enabled: boolean;
+  enabled: boolean;
 };
 type CronRunRequest = {
-    force?: boolean;
+  force?: boolean;
 };
 type CronActionResult = {
-    job: CronJobView | null;
-    executed?: boolean;
+  job: CronJobView | null;
+  executed?: boolean;
 };
 type RuntimeConfigUpdate = {
-    agents?: {
-        defaults?: {
-            contextTokens?: number;
-            engine?: string;
-            engineConfig?: Record<string, unknown>;
-        };
-        list?: AgentProfileView[];
+  agents?: {
+    defaults?: {
+      contextTokens?: number;
+      engine?: string;
+      engineConfig?: Record<string, unknown>;
     };
-    bindings?: AgentBindingView[];
-    session?: SessionConfigView;
+    list?: AgentProfileView[];
+  };
+  bindings?: AgentBindingView[];
+  session?: SessionConfigView;
 };
 type SecretSourceView = "env" | "file" | "exec";
 type SecretRefView = {
-    source: SecretSourceView;
-    provider?: string;
-    id: string;
+  source: SecretSourceView;
+  provider?: string;
+  id: string;
 };
 type SecretProviderEnvView = {
-    source: "env";
-    prefix?: string;
+  source: "env";
+  prefix?: string;
 };
 type SecretProviderFileView = {
-    source: "file";
-    path: string;
-    format?: "json";
+  source: "file";
+  path: string;
+  format?: "json";
 };
 type SecretProviderExecView = {
-    source: "exec";
-    command: string;
-    args?: string[];
-    cwd?: string;
-    timeoutMs?: number;
+  source: "exec";
+  command: string;
+  args?: string[];
+  cwd?: string;
+  timeoutMs?: number;
 };
 type SecretProviderView = SecretProviderEnvView | SecretProviderFileView | SecretProviderExecView;
 type SecretsView = {
-    enabled: boolean;
-    defaults: {
-        env?: string;
-        file?: string;
-        exec?: string;
-    };
-    providers: Record<string, SecretProviderView>;
-    refs: Record<string, SecretRefView>;
+  enabled: boolean;
+  defaults: {
+    env?: string;
+    file?: string;
+    exec?: string;
+  };
+  providers: Record<string, SecretProviderView>;
+  refs: Record<string, SecretRefView>;
 };
 type SecretsConfigUpdate = {
-    enabled?: boolean;
-    defaults?: {
-        env?: string | null;
-        file?: string | null;
-        exec?: string | null;
-    };
-    providers?: Record<string, SecretProviderView> | null;
-    refs?: Record<string, SecretRefView> | null;
+  enabled?: boolean;
+  defaults?: {
+    env?: string | null;
+    file?: string | null;
+    exec?: string | null;
+  };
+  providers?: Record<string, SecretProviderView> | null;
+  refs?: Record<string, SecretRefView> | null;
 };
 type UiNcpSessionListView = {
-    sessions: NcpSessionSummary[];
-    total: number;
+  sessions: NcpSessionSummary[];
+  total: number;
 };
 type UiNcpSessionMessagesView = {
-    sessionId: string;
-    messages: NcpMessage[];
-    total: number;
+  sessionId: string;
+  status: NcpSessionStatus;
+  messages: NcpMessage[];
+  total: number;
 };
 type SessionTypeDescribeParams = {
-    describeMode?: "observation" | "probe";
+  describeMode?: "observation" | "probe";
 };
 type UiNcpSessionService = NcpSessionApi;
 type UiNcpAgent = {
-    agentClientEndpoint: NcpAgentClientEndpoint;
-    streamProvider?: NcpHttpAgentStreamProvider;
-    listSessionTypes?: (params?: SessionTypeDescribeParams) => Promise<ChatSessionTypesView> | ChatSessionTypesView;
-    assetApi?: {
-        put: (input: {
-            fileName: string;
-            mimeType?: string | null;
-            bytes: Uint8Array;
-            createdAt?: Date;
-        }) => Promise<UiNcpStoredAssetRecord>;
-        stat: (uri: string) => Promise<UiNcpStoredAssetRecord | null> | UiNcpStoredAssetRecord | null;
-        resolveContentPath: (uri: string) => string | null;
-    };
-    basePath?: string;
+  agentClientEndpoint: NcpAgentClientEndpoint;
+  streamProvider?: NcpHttpAgentStreamProvider;
+  listSessionTypes?: (params?: SessionTypeDescribeParams) => Promise<ChatSessionTypesView> | ChatSessionTypesView;
+  assetApi?: {
+    put: (input: {
+      fileName: string;
+      mimeType?: string | null;
+      bytes: Uint8Array;
+      createdAt?: Date;
+    }) => Promise<UiNcpStoredAssetRecord>;
+    stat: (uri: string) => Promise<UiNcpStoredAssetRecord | null> | UiNcpStoredAssetRecord | null;
+    resolveContentPath: (uri: string) => string | null;
+  };
+  basePath?: string;
 };
 type ConfigView = {
-    agents: {
-        defaults: {
-            model: string;
-            workspace?: string;
-            engine?: string;
-            engineConfig?: Record<string, unknown>;
-            contextTokens?: number;
-            maxToolIterations?: number;
-        };
-        list?: AgentProfileView[];
-        context?: {
-            bootstrap?: {
-                files?: string[];
-                minimalFiles?: string[];
-                heartbeatFiles?: string[];
-                perFileChars?: number;
-                totalChars?: number;
-            };
-            memory?: {
-                enabled?: boolean;
-                maxChars?: number;
-            };
-        };
+  agents: {
+    defaults: {
+      model: string;
+      workspace?: string;
+      engine?: string;
+      engineConfig?: Record<string, unknown>;
+      contextTokens?: number;
+      maxToolIterations?: number;
     };
-    providers: Record<string, ProviderConfigView>;
-    search: SearchConfigView;
-    channels: Record<string, Record<string, unknown>>;
-    bindings?: AgentBindingView[];
-    session?: SessionConfigView;
-    tools?: Record<string, unknown>;
-    gateway?: Record<string, unknown>;
-    ui?: Record<string, unknown>;
-    secrets?: SecretsView;
+    list?: AgentProfileView[];
+    context?: {
+      bootstrap?: {
+        files?: string[];
+        minimalFiles?: string[];
+        heartbeatFiles?: string[];
+        perFileChars?: number;
+        totalChars?: number;
+      };
+      memory?: {
+        enabled?: boolean;
+        maxChars?: number;
+      };
+    };
+  };
+  providers: Record<string, ProviderConfigView>;
+  search: SearchConfigView;
+  channels: Record<string, Record<string, unknown>>;
+  bindings?: AgentBindingView[];
+  session?: SessionConfigView;
+  tools?: Record<string, unknown>;
+  gateway?: Record<string, unknown>;
+  ui?: Record<string, unknown>;
+  secrets?: SecretsView;
 };
 type ProviderSpecView = {
-    name: string;
+  name: string;
+  displayName?: string;
+  isCustom?: boolean;
+  modelPrefix?: string;
+  keywords: string[];
+  envKey: string;
+  isGateway?: boolean;
+  isLocal?: boolean;
+  defaultApiBase?: string;
+  logo?: string;
+  apiBaseHelp?: {
+    en?: string;
+    zh?: string;
+  };
+  auth?: {
+    kind: "device_code";
     displayName?: string;
-    isCustom?: boolean;
-    modelPrefix?: string;
-    keywords: string[];
-    envKey: string;
-    isGateway?: boolean;
-    isLocal?: boolean;
-    defaultApiBase?: string;
-    logo?: string;
-    apiBaseHelp?: {
+    note?: {
+      en?: string;
+      zh?: string;
+    };
+    methods?: Array<{
+      id: string;
+      label?: {
         en?: string;
         zh?: string;
-    };
-    auth?: {
-        kind: "device_code";
-        displayName?: string;
-        note?: {
-            en?: string;
-            zh?: string;
-        };
-        methods?: Array<{
-            id: string;
-            label?: {
-                en?: string;
-                zh?: string;
-            };
-            hint?: {
-                en?: string;
-                zh?: string;
-            };
-        }>;
-        defaultMethodId?: string;
-        supportsCliImport?: boolean;
-    };
-    defaultModels?: string[];
-    supportsWireApi?: boolean;
-    wireApiOptions?: Array<"auto" | "chat" | "responses">;
-    defaultWireApi?: "auto" | "chat" | "responses";
-};
-type ChannelSpecView = {
-    name: string;
-    displayName?: string;
-    enabled: boolean;
-    tutorialUrl?: string;
-    tutorialUrls?: {
-        default?: string;
+      };
+      hint?: {
         en?: string;
         zh?: string;
-    };
+      };
+    }>;
+    defaultMethodId?: string;
+    supportsCliImport?: boolean;
+  };
+  defaultModels?: string[];
+  supportsWireApi?: boolean;
+  wireApiOptions?: Array<"auto" | "chat" | "responses">;
+  defaultWireApi?: "auto" | "chat" | "responses";
+};
+type ChannelSpecView = {
+  name: string;
+  displayName?: string;
+  enabled: boolean;
+  tutorialUrl?: string;
+  tutorialUrls?: {
+    default?: string;
+    en?: string;
+    zh?: string;
+  };
 };
 type SearchProviderSpecView = {
-    name: SearchProviderName;
-    displayName: string;
-    description: string;
-    docsUrl?: string;
-    isDefault?: boolean;
-    supportsSummary?: boolean;
+  name: SearchProviderName;
+  displayName: string;
+  description: string;
+  docsUrl?: string;
+  isDefault?: boolean;
+  supportsSummary?: boolean;
 };
 type ConfigMetaView = {
-    providers: ProviderSpecView[];
-    search: SearchProviderSpecView[];
-    channels: ChannelSpecView[];
+  providers: ProviderSpecView[];
+  search: SearchProviderSpecView[];
+  channels: ChannelSpecView[];
 };
 type ConfigUiHint = {
-    label?: string;
-    help?: string;
-    group?: string;
-    order?: number;
-    advanced?: boolean;
-    sensitive?: boolean;
-    placeholder?: string;
-    readOnly?: boolean;
+  label?: string;
+  help?: string;
+  group?: string;
+  order?: number;
+  advanced?: boolean;
+  sensitive?: boolean;
+  placeholder?: string;
+  readOnly?: boolean;
 };
 type ConfigUiHints = Record<string, ConfigUiHint>;
 type ConfigSchemaResponse = {
-    schema: Record<string, unknown>;
-    uiHints: ConfigUiHints;
-    actions: ConfigActionManifest[];
-    version: string;
-    generatedAt: string;
+  schema: Record<string, unknown>;
+  uiHints: ConfigUiHints;
+  actions: ConfigActionManifest[];
+  version: string;
+  generatedAt: string;
 };
 type ConfigActionType = "httpProbe" | "oauthStart" | "webhookVerify" | "openUrl" | "copyToken";
 type ConfigActionManifest = {
-    id: string;
-    version: string;
-    scope: string;
-    title: string;
-    description?: string;
-    type: ConfigActionType;
-    trigger: "manual" | "afterSave";
-    requires?: string[];
-    request: {
-        method: "GET" | "POST" | "PUT";
-        path: string;
-        timeoutMs?: number;
-    };
-    success?: {
-        message?: string;
-    };
-    failure?: {
-        message?: string;
-    };
-    saveBeforeRun?: boolean;
-    savePatch?: Record<string, unknown>;
-    resultMap?: Record<string, string>;
-    policy?: {
-        roles?: string[];
-        rateLimitKey?: string;
-        cooldownMs?: number;
-        audit?: boolean;
-    };
+  id: string;
+  version: string;
+  scope: string;
+  title: string;
+  description?: string;
+  type: ConfigActionType;
+  trigger: "manual" | "afterSave";
+  requires?: string[];
+  request: {
+    method: "GET" | "POST" | "PUT";
+    path: string;
+    timeoutMs?: number;
+  };
+  success?: {
+    message?: string;
+  };
+  failure?: {
+    message?: string;
+  };
+  saveBeforeRun?: boolean;
+  savePatch?: Record<string, unknown>;
+  resultMap?: Record<string, string>;
+  policy?: {
+    roles?: string[];
+    rateLimitKey?: string;
+    cooldownMs?: number;
+    audit?: boolean;
+  };
 };
 type ConfigActionExecuteRequest = {
-    scope?: string;
-    draftConfig?: Record<string, unknown>;
-    context?: {
-        actor?: string;
-        traceId?: string;
-    };
+  scope?: string;
+  draftConfig?: Record<string, unknown>;
+  context?: {
+    actor?: string;
+    traceId?: string;
+  };
 };
 type ConfigActionExecuteResult = {
-    ok: boolean;
-    status: "success" | "failed";
-    message: string;
-    data?: Record<string, unknown>;
-    patch?: Record<string, unknown>;
-    nextActions?: string[];
+  ok: boolean;
+  status: "success" | "failed";
+  message: string;
+  data?: Record<string, unknown>;
+  patch?: Record<string, unknown>;
+  nextActions?: string[];
 };
 type UiServerEvent = {
-    type: "config.updated";
-    payload: {
-        path: string;
-    };
+  type: "config.updated";
+  payload: {
+    path: string;
+  };
 } | {
-    type: "session.updated";
-    payload: {
-        sessionKey: string;
-    };
+  type: "session.updated";
+  payload: {
+    sessionKey: string;
+  };
 } | {
-    type: "session.run-status";
-    payload: {
-        sessionKey: string;
-        status: "running" | "idle";
-    };
+  type: "session.run-status";
+  payload: {
+    sessionKey: string;
+    status: "running" | "idle";
+  };
 } | {
-    type: "session.summary.upsert";
-    payload: {
-        summary: NcpSessionSummary;
-    };
+  type: "session.summary.upsert";
+  payload: {
+    summary: NcpSessionSummary;
+  };
 } | {
-    type: "session.summary.delete";
-    payload: {
-        sessionKey: string;
-    };
+  type: "session.summary.delete";
+  payload: {
+    sessionKey: string;
+  };
 } | {
-    type: "config.reload.started";
-    payload?: Record<string, unknown>;
+  type: "config.reload.started";
+  payload?: Record<string, unknown>;
 } | {
-    type: "config.reload.finished";
-    payload?: Record<string, unknown>;
+  type: "config.reload.finished";
+  payload?: Record<string, unknown>;
 } | {
-    type: "error";
-    payload: {
-        message: string;
-        code?: string;
-    };
+  type: "error";
+  payload: {
+    message: string;
+    code?: string;
+  };
 };
 type UiServerOptions = {
-    host: string;
-    port: number;
-    configPath: string;
-    productVersion?: string;
-    corsOrigins?: string[] | "*";
-    staticDir?: string;
-    marketplace?: MarketplaceApiConfig;
-    cronService?: CronService;
-    ncpAgent?: UiNcpAgent;
-    ncpSessionService?: UiNcpSessionService;
-    remoteAccess?: UiRemoteAccessHost;
-    getBootstrapStatus?: () => BootstrapStatusView;
-    getPluginChannelBindings?: () => PluginChannelBinding[];
-    getPluginUiMetadata?: () => PluginUiMetadata[];
+  host: string;
+  port: number;
+  configPath: string;
+  productVersion?: string;
+  corsOrigins?: string[] | "*";
+  staticDir?: string;
+  initializeAgentHomeDirectory?: (homeDirectory: string) => void;
+  marketplace?: MarketplaceApiConfig;
+  cronService?: CronService;
+  ncpAgent?: UiNcpAgent;
+  ncpSessionService?: UiNcpSessionService;
+  remoteAccess?: UiRemoteAccessHost;
+  getBootstrapStatus?: () => BootstrapStatusView;
+  getPluginChannelBindings?: () => PluginChannelBinding[];
+  getPluginUiMetadata?: () => PluginUiMetadata[];
 };
 type UiServerHandle = {
-    host: string;
-    port: number;
-    close: () => Promise<void>;
-    publish: (event: UiServerEvent) => void;
+  host: string;
+  port: number;
+  close: () => Promise<void>;
+  publish: (event: UiServerEvent) => void;
 };
-
+//#endregion
+//#region src/ui/server.d.ts
 type UiServerStartOptions = UiServerOptions & {
-    applyLiveConfigReload?: () => Promise<void>;
+  applyLiveConfigReload?: () => Promise<void>;
 };
 declare function startUiServer(options: UiServerStartOptions): UiServerHandle;
-
+//#endregion
+//#region src/ui/router.d.ts
 declare function createUiRouter(options: UiRouterOptions): Hono;
-
+//#endregion
+//#region src/ui/plugin-channel-config.projection.d.ts
 type PluginConfigProjectionOptions = {
-    pluginChannelBindings?: PluginChannelBinding[];
-    pluginUiMetadata?: PluginUiMetadata[];
+  pluginChannelBindings?: PluginChannelBinding[];
+  pluginUiMetadata?: PluginUiMetadata[];
 };
-
+//#endregion
+//#region src/ui/config.d.ts
 type ExecuteActionResult = {
-    ok: true;
-    data: ConfigActionExecuteResult$1;
+  ok: true;
+  data: ConfigActionExecuteResult$1;
 } | {
-    ok: false;
-    code: string;
-    message: string;
-    details?: Record<string, unknown>;
+  ok: false;
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
 };
 declare function buildConfigView(config: Config, options?: PluginConfigProjectionOptions): ConfigView;
 declare function buildConfigMeta(config: Config, options?: PluginConfigProjectionOptions): ConfigMetaView;
@@ -1183,38 +1208,39 @@ declare function buildConfigSchemaView(_config: Config, options?: PluginConfigPr
 declare function executeConfigAction(configPath: string, actionId: string, request: ConfigActionExecuteRequest$1): Promise<ExecuteActionResult>;
 declare function loadConfigOrDefault(configPath: string): Config;
 declare function updateModel(configPath: string, patch: {
-    model?: string;
-    workspace?: string;
+  model?: string;
+  workspace?: string;
 }): ConfigView;
 declare function updateSearch(configPath: string, patch: SearchConfigUpdate): ConfigView["search"];
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
 declare function createCustomProvider(configPath: string, patch?: ProviderConfigUpdate): {
-    name: string;
-    provider: ProviderConfigView;
+  name: string;
+  provider: ProviderConfigView;
 };
 declare function deleteCustomProvider(configPath: string, providerName: string): boolean | null;
 declare function testProviderConnection(configPath: string, providerName: string, patch: ProviderConnectionTestRequest): Promise<ProviderConnectionTestResult | null>;
 declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>, options?: PluginConfigProjectionOptions): Record<string, unknown> | null;
 declare const DEFAULT_SESSION_TYPE = "native";
 declare class SessionPatchValidationError extends Error {
-    readonly code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE" | "PREFERRED_THINKING_INVALID";
-    constructor(code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE" | "PREFERRED_THINKING_INVALID", message: string);
+  readonly code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE" | "PREFERRED_THINKING_INVALID";
+  constructor(code: "SESSION_TYPE_INVALID" | "SESSION_TYPE_IMMUTABLE" | "SESSION_TYPE_UNAVAILABLE" | "PREFERRED_THINKING_INVALID", message: string);
 }
 declare function listSessions(configPath: string, query?: {
-    q?: string;
-    limit?: number;
-    activeMinutes?: number;
+  q?: string;
+  limit?: number;
+  activeMinutes?: number;
 }): SessionsListView;
 declare function getSessionHistory(configPath: string, key: string, limit?: number): SessionHistoryView | null;
 declare function patchSession(configPath: string, key: string, patch: SessionPatchUpdate, options?: {
-    availableSessionTypes?: string[];
+  availableSessionTypes?: string[];
 }): SessionHistoryView | null;
 declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 declare function updateSecrets(configPath: string, patch: SecretsConfigUpdate): SecretsView;
-
+//#endregion
+//#region src/ui/auth-bridge.d.ts
 declare function getUiBridgeSecretPath(): string;
 declare function readUiBridgeSecret(): string | null;
 declare function ensureUiBridgeSecret(): string;
-
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type AppMetaView, type AuthEnabledUpdateRequest, type AuthLoginRequest, type AuthPasswordUpdateRequest, type AuthSetupRequest, type AuthStatusView, type BindingPeerView, type BochaFreshnessValue, type BootstrapPhase, type BootstrapRemoteState, type BootstrapStageState, type BootstrapStatusView, type ChannelAuthPollRequest, type ChannelAuthPollResult, type ChannelAuthStartRequest, type ChannelAuthStartResult, type ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, DEFAULT_SESSION_TYPE, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplaceMcpContentView, type MarketplaceMcpDoctorResult, type MarketplaceMcpInstallKind, type MarketplaceMcpInstallRequest, type MarketplaceMcpInstallResult, type MarketplaceMcpInstallSpec, type MarketplaceMcpManageAction, type MarketplaceMcpManageRequest, type MarketplaceMcpManageResult, type MarketplaceMcpTemplateInput, type MarketplacePluginContentView, type MarketplacePluginInstallKind, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallKind, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type NcpSessionSkillsView, type ProviderAuthImportResult, type ProviderAuthPollRequest, type ProviderAuthPollResult, type ProviderAuthStartRequest, type ProviderAuthStartResult, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RemoteAccessView, type RemoteAccountView, type RemoteBrowserAuthPollRequest, type RemoteBrowserAuthPollResult, type RemoteBrowserAuthStartRequest, type RemoteBrowserAuthStartResult, type RemoteDoctorCheckView, type RemoteDoctorView, type RemoteLoginRequest, type RemoteRuntimeView, type RemoteServiceAction, type RemoteServiceActionResult, type RemoteServiceView, type RemoteSettingsUpdateRequest, type RemoteSettingsView, type RuntimeConfigUpdate, type SearchConfigUpdate, type SearchConfigView, type SearchProviderConfigView, type SearchProviderName, type SearchProviderSpecView, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type ServerPathBreadcrumbView, type ServerPathBrowseView, type ServerPathEntryView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, SessionPatchValidationError, type SessionSkillEntryView, type SessionTypeDescribeParams, type SessionsListView, type UiNcpAgent, type UiNcpAssetPutView, type UiNcpAssetView, type UiNcpSessionListView, type UiNcpSessionMessagesView, type UiNcpSessionService, type UiNcpStoredAssetRecord, type UiRemoteAccessHost, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };
+//#endregion
+export { AgentBindingView, AgentCreateRequest, AgentDeleteResult, AgentProfileView, ApiError, ApiResponse, AppMetaView, AuthEnabledUpdateRequest, AuthLoginRequest, AuthPasswordUpdateRequest, AuthSetupRequest, AuthStatusView, BindingPeerView, BochaFreshnessValue, BootstrapPhase, BootstrapRemoteState, BootstrapStageState, BootstrapStatusView, ChannelAuthPollRequest, ChannelAuthPollResult, ChannelAuthStartRequest, ChannelAuthStartResult, ChannelSpecView, type ChatSessionTypeCtaView, type ChatSessionTypeOptionView, type ChatSessionTypesView, ConfigActionExecuteRequest, ConfigActionExecuteResult, ConfigActionManifest, ConfigActionType, ConfigMetaView, ConfigSchemaResponse, ConfigUiHint, ConfigUiHints, ConfigView, CronActionResult, CronEnableRequest, CronJobStateView, CronJobView, CronListView, CronPayloadView, CronRunRequest, CronScheduleView, DEFAULT_SESSION_TYPE, MarketplaceApiConfig, MarketplaceInstallKind, MarketplaceInstallSkillParams, MarketplaceInstallSpec, MarketplaceInstalledRecord, MarketplaceInstalledView, MarketplaceInstaller, MarketplaceItemSummary, MarketplaceItemType, MarketplaceItemView, MarketplaceListView, MarketplaceLocalizedTextMap, MarketplaceMcpContentView, MarketplaceMcpDoctorResult, MarketplaceMcpInstallKind, MarketplaceMcpInstallRequest, MarketplaceMcpInstallResult, MarketplaceMcpInstallSpec, MarketplaceMcpManageAction, MarketplaceMcpManageRequest, MarketplaceMcpManageResult, MarketplaceMcpTemplateInput, MarketplacePluginContentView, MarketplacePluginInstallKind, MarketplacePluginInstallRequest, MarketplacePluginInstallResult, MarketplacePluginManageAction, MarketplacePluginManageRequest, MarketplacePluginManageResult, MarketplaceRecommendationView, MarketplaceSkillContentView, MarketplaceSkillInstallKind, MarketplaceSkillInstallRequest, MarketplaceSkillInstallResult, MarketplaceSkillManageAction, MarketplaceSkillManageRequest, MarketplaceSkillManageResult, MarketplaceSort, NcpSessionSkillsView, ProviderAuthImportResult, ProviderAuthPollRequest, ProviderAuthPollResult, ProviderAuthStartRequest, ProviderAuthStartResult, ProviderConfigUpdate, ProviderConfigView, ProviderConnectionTestRequest, ProviderConnectionTestResult, ProviderCreateRequest, ProviderCreateResult, ProviderDeleteResult, ProviderSpecView, RemoteAccessView, RemoteAccountView, RemoteBrowserAuthPollRequest, RemoteBrowserAuthPollResult, RemoteBrowserAuthStartRequest, RemoteBrowserAuthStartResult, RemoteDoctorCheckView, RemoteDoctorView, RemoteLoginRequest, RemoteRuntimeView, RemoteServiceAction, RemoteServiceActionResult, RemoteServiceView, RemoteSettingsUpdateRequest, RemoteSettingsView, RuntimeConfigUpdate, SearchConfigUpdate, SearchConfigView, SearchProviderConfigView, SearchProviderName, SearchProviderSpecView, SecretProviderEnvView, SecretProviderExecView, SecretProviderFileView, SecretProviderView, SecretRefView, SecretSourceView, SecretsConfigUpdate, SecretsView, ServerPathBreadcrumbView, ServerPathBrowseView, ServerPathEntryView, SessionConfigView, SessionEntryView, SessionEventView, SessionHistoryView, SessionMessageView, SessionPatchUpdate, SessionPatchValidationError, SessionSkillEntryView, SessionTypeDescribeParams, SessionsListView, UiNcpAgent, UiNcpAssetPutView, UiNcpAssetView, UiNcpSessionListView, UiNcpSessionMessagesView, UiNcpSessionService, UiNcpStoredAssetRecord, type UiRemoteAccessHost, UiServerEvent, UiServerHandle, UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, ensureUiBridgeSecret, executeConfigAction, getSessionHistory, getUiBridgeSecretPath, listSessions, loadConfigOrDefault, patchSession, readUiBridgeSecret, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSearch, updateSecrets };