@webskill/sdk 0.0.1

package/dist/index-Bq-bTWh3.d.ts

@@ -0,0 +1,219 @@
+import { C as InteractionRequest, Mt as FileSystemProvider, X as RenderResultRequest, _ as FsMemoryStore, ct as ToolResult, g as FsArtifactStore, it as ScriptExecutor, jt as FileStat, l as BridgeCapabilities, ot as ToolDefinition, pt as UiBridge, rt as ScriptExecutionContext, w as InteractionResponse } from "./index-88KNOnbr.js";
+import { Readable, Writable } from "node:stream";
+//#region ../node/dist/index.d.ts
+//#region src/fs/nodeFs.d.ts
+/** 基于 node:fs/promises 的 FileSystemProvider；接受 `/` 风格路径，写入自动创建父目录 */
+declare class NodeFS implements FileSystemProvider {
+  #private;
+  readonly kind = "node";
+  readText(p: string): Promise<string>;
+  writeText(p: string, content: string): Promise<void>;
+  readBinary(p: string): Promise<Uint8Array>;
+  writeBinary(p: string, content: Uint8Array): Promise<void>;
+  exists(p: string): Promise<boolean>;
+  stat(p: string): Promise<FileStat>;
+  list(p: string): Promise<FileStat[]>;
+  mkdir(p: string): Promise<void>;
+  remove(p: string, options?: {
+    recursive?: boolean;
+  }): Promise<void>;
+}
+//#endregion
+//#region src/executor/nodeScriptExecutor.d.ts
+/**
+ * 进程内脚本执行器。接口按沙箱语义设计（context 无隐式宿主访问），
+ * worker_threads 沙箱见 deferred-items D1。
+ */
+declare class NodeScriptExecutor implements ScriptExecutor {
+  #private;
+  constructor(fs: FileSystemProvider);
+  loadDefinition(skillRoot: string, scriptName: string): Promise<ToolDefinition>;
+  execute(input: {
+    skillRoot: string;
+    scriptName: string;
+    args: Record<string, unknown>;
+    context: Parameters<ScriptExecutor['execute']>[0]['context'];
+    timeoutMs: number;
+  }): Promise<ToolResult>;
+}
+//#endregion
+//#region src/executor/sandboxedScriptExecutor.d.ts
+interface SandboxOptions {
+  /** 默认 { maxOldGenerationSizeMb: 64, maxYoungGenerationSizeMb: 16 } */
+  resourceLimits?: {
+    maxOldGenerationSizeMb?: number;
+    maxYoungGenerationSizeMb?: number;
+  };
+  /** env 白名单（仅这些变量传入 Worker；默认空） */
+  envWhitelist?: string[];
+  capabilities?: BridgeCapabilities;
+}
+/**
+ * D1：worker_threads 沙箱脚本执行器。
+ * 每次执行独立 Worker（resourceLimits + env 白名单），loadDefinition 同样在
+ * Worker 内完成（禁止主进程 import 不可信脚本）；超时 terminate（可杀同步死循环）。
+ * 能力桥协议与浏览器同一来源（runtime/sandbox/bridgeProtocol）。
+ */
+declare class SandboxedScriptExecutor implements ScriptExecutor {
+  #private;
+  constructor(fs: FileSystemProvider, options?: SandboxOptions);
+  loadDefinition(skillRoot: string, scriptName: string): Promise<ToolDefinition>;
+  execute(input: {
+    skillRoot: string;
+    scriptName: string;
+    args: Record<string, unknown>;
+    context: ScriptExecutionContext;
+    timeoutMs: number;
+  }): Promise<ToolResult>;
+}
+//#endregion
+//#region src/artifacts/fileArtifactStore.d.ts
+/**
+ * FileArtifactStore：兼容别名，语义同阶段 2-4。
+ * 实现已上移到 runtime 的 FsArtifactStore；node 侧保留 NodeFS 默认值。
+ */
+declare class FileArtifactStore extends FsArtifactStore {
+  constructor(deps: {
+    root: string;
+    fs?: FileSystemProvider;
+  });
+}
+//#endregion
+//#region src/memory/fileMemoryStore.d.ts
+/**
+ * FileMemoryStore：兼容别名，语义同阶段 3。
+ * 实现已上移到 runtime 的 FsMemoryStore；node 侧保留 NodeFS 默认值。
+ */
+declare class FileMemoryStore extends FsMemoryStore {
+  constructor(deps: {
+    root: string;
+    fs?: FileSystemProvider;
+  });
+}
+//#endregion
+//#region src/ui/cliUiBridge.d.ts
+/**
+ * 命令行 UiBridge：ask→问答，confirm→y/n（带默认值），
+ * form→逐字段提示（显示默认值与必填标记），select→编号列表。
+ * 输入/输出流可注入（测试用 PassThrough）。
+ */
+declare class CliUiBridge implements UiBridge {
+  #private;
+  constructor(deps?: {
+    input?: Readable;
+    output?: Writable;
+  });
+  request(input: InteractionRequest): Promise<InteractionResponse>;
+  progress(input: {
+    runId: string;
+    message: string;
+    value?: number;
+  }): Promise<void>;
+  renderResult(input: RenderResultRequest): Promise<void>;
+}
+//#endregion
+//#region src/skillManagement/types.d.ts
+type SkillSource = {
+  type: 'local';
+  path: string;
+} | {
+  type: 'http';
+  url: string;
+} | {
+  type: 'git';
+  url: string;
+  ref?: string;
+  commit?: string;
+} | {
+  type: 'npm';
+  packageName: string;
+  version?: string;
+};
+interface SkillManifest {
+  schemaVersion: 1;
+  name: string;
+  version?: string;
+  source: SkillSource;
+  installedAt: string;
+  integrity: {
+    algorithm: 'sha256';
+    digest: string;
+  };
+  files: Array<{
+    path: string;
+    size: number;
+    sha256: string;
+  }>;
+}
+interface SkillsLockfile {
+  schemaVersion: 1;
+  skills: Record<string, {
+    digest: string;
+    installedAt: string;
+    source: SkillSource;
+  }>;
+}
+interface VerifyResult {
+  ok: boolean;
+  mismatches: string[];
+}
+/** 技能目录内的安装清单文件名（不参与 files 列表与 digest） */
+declare const SKILL_MANIFEST_FILE = "webskill.skill-manifest.json";
+/** managed root 下的锁定文件名（不参与 files 列表与 digest） */
+declare const SKILLS_LOCKFILE = "skills.lock.json";
+//#endregion
+//#region src/skillManagement/skillManager.d.ts
+/**
+ * 技能管理门面：统一安装管线（staging → 解析 name → 校验 → 拷贝 → manifest → lockfile），
+ * 任何失败清理现场抛 INSTALL_FAILED。
+ */
+declare class SkillManager {
+  #private;
+  constructor(deps: {
+    managedRoot: string;
+    fs?: FileSystemProvider;
+    fetchImpl?: typeof fetch;
+  });
+  install(source: SkillSource, options?: {
+    expectedSha256?: string;
+  }): Promise<SkillManifest>;
+  uninstall(name: string): Promise<void>;
+  verifyIntegrity(name: string): Promise<VerifyResult>;
+  listInstalled(): Promise<SkillsLockfile>;
+  exportArchive(name: string, options: {
+    format: 'zip' | 'tar';
+    outPath: string;
+  }): Promise<string>;
+}
+//#endregion
+//#region src/skillManagement/export/archiveExporter.d.ts
+/** 只解出归档中的 webskill.skill-manifest.json 条目（安装前预览） */
+declare function readArchiveManifest(fs: FileSystemProvider, archivePath: string): Promise<SkillManifest>;
+//#endregion
+//#region src/env.d.ts
+interface LlmEnvConfig {
+  baseUrl: string;
+  apiKey: string;
+  model: string;
+}
+/**
+ * 解析 .env（简单 KEY=VALUE 行解析，不引依赖），
+ * 读取 VITE_BASE_URL / VITE_API_KEY / VITE_MODEL_NAME；缺项返回 undefined 供测试 skip 判断。
+ */
+declare function loadLlmConfigFromEnv(dotenvPath?: string): LlmEnvConfig | undefined;
+interface LlmCapabilities {
+  available: boolean;
+  nonStreaming: boolean;
+  reason?: string;
+}
+/**
+ * 探测 LLM 能力（结果模块级缓存）：
+ * - available：GET /models 可达（与 checkAvailability 同语义）
+ * - nonStreaming：最小非流式 chat completion（max_tokens=1，短超时）；
+ *   HTTP 400/404 或明确不支持非流式的错误 → false
+ * - streaming 能力由 available 推断（SSE 解析在 SDK 侧实现）
+ * 环境变量 VITE_LLM_NON_STREAMING=0 可显式强制 nonStreaming=false（模拟流式-only 回归）。
+ */
+declare function probeLlmCapabilities(config: LlmEnvConfig): Promise<LlmCapabilities>;
+//#endregion
+export { loadLlmConfigFromEnv as _, LlmEnvConfig as a, SKILLS_LOCKFILE as c, SandboxedScriptExecutor as d, SkillManager as f, VerifyResult as g, SkillsLockfile as h, LlmCapabilities as i, SKILL_MANIFEST_FILE as l, SkillSource as m, FileArtifactStore as n, NodeFS as o, SkillManifest as p, FileMemoryStore as r, NodeScriptExecutor as s, CliUiBridge as t, SandboxOptions as u, probeLlmCapabilities as v, readArchiveManifest as y };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { $ as RunTerminationReason, $t as jsonRenderer, A as LlmCompleteInput, At as DiscoveryResult, B as MockLlmQueueItem, Bt as SkillDocument, C as InteractionRequest, Ct as normalizeToolContent, D as LifecycleHookContext, Dt as toLlmToolSpec, E as LifecycleHook, Et as schemaToForm, F as LlmToolSpec, Ft as SKILL_NAME_MAX_LENGTH, G as ProgressiveRouter, Gt as SkillSource, H as MockUiBridge, Ht as SkillLocation, I as MemoryArtifactStore, It as SKILL_NAME_PATTERN, J as READ_SKILL_FILE_TOOL_NAME, Jt as WebSkillErrorCode, K as READ_SKILL_FILE_INPUT_SCHEMA, Kt as ValidationReport, L as MemoryStore, Lt as SkillCatalog, M as LlmResponse, Mt as FileSystemProvider, N as LlmStreamEvent, Nt as JsonSchema, O as LifecycleListener, Ot as toVercelToolSpecs, P as LlmToolCall, Pt as MemoryFS, Q as RunResult, Qt as isValidSkillName, R as MockLlmClient, Rt as SkillCatalogEntry, S as InteractionPolicy, St as mergeCatalogEntries, T as LifecycleEvent, Tt as resolveToolName, U as OpenAiCompatibleClient, Ut as SkillMetadata, V as MockUiAnswer, Vt as SkillIssue, W as OpenAiCompatibleClientConfig, Wt as SkillReader, X as RenderResultRequest, Xt as checkSkillRules, Y as RenderBlock, Yt as buildCatalog, Z as RouteResult, Zt as escapeXml, _ as FsMemoryStore, _t as bridgeError, a as AgentLoopConfig, an as validateSkills, at as SkillRouter, b as HookRunnerOptions, bt as fromVercelResult, c as ArtifactStore, ct as ToolResult, d as BridgeResponse, dt as TraceEventType, en as normalizePath, et as RuntimePhase, f as EventBus, ft as TraceRecorder, g as FsArtifactStore, gt as WebSkillRuntimeDeps, h as FormField, ht as WebSkillRuntime, i as AgentLoop, in as resolveInsideRoot, it as ScriptExecutor, j as LlmMessage, jt as FileStat, k as LlmClient, kt as CatalogRenderer, l as BridgeCapabilities, lt as TraceClock, m as ExternalToolSource, mt as VercelToolSpec, n as ASK_USER_TOOL, nn as renderAvailableSkillsXml, nt as RuntimeSession, o as AgentLoopDeps, on as xmlRenderer, ot as ToolDefinition, p as ExternalSkillProvider, pt as UiBridge, q as READ_SKILL_FILE_TOOL, qt as WebSkillError, r as ASK_USER_TOOL_NAME, rn as renderCatalogJson, rt as ScriptExecutionContext, s as Artifact, st as ToolResolution, t as ASK_USER_INPUT_SCHEMA, tn as parseSkillMarkdown, tt as RuntimeRun, u as BridgeRequest, ut as TraceEvent, v as FullDisclosureRouter, vt as buildRenderResult, w as InteractionResponse, wt as parseBridgeRequest, x as InMemoryStore, xt as fromVercelStreamPart, y as HookRunner, yt as createScriptContext, z as MockLlmHandler, zt as SkillDiscovery } from "./index-88KNOnbr.js";
+export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, type AgentLoopConfig, type AgentLoopDeps, type Artifact, type ArtifactStore, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type CatalogRenderer, type DiscoveryResult, EventBus, type ExternalSkillProvider, type ExternalToolSource, type FileStat, type FileSystemProvider, type FormField, FsArtifactStore, FsMemoryStore, FullDisclosureRouter, HookRunner, type HookRunnerOptions, InMemoryStore, type InteractionPolicy, type InteractionRequest, type InteractionResponse, type JsonSchema, type LifecycleEvent, type LifecycleHook, type LifecycleHookContext, type LifecycleListener, type LlmClient, type LlmCompleteInput, type LlmMessage, type LlmResponse, type LlmStreamEvent, type LlmToolCall, type LlmToolSpec, MemoryArtifactStore, MemoryFS, type MemoryStore, MockLlmClient, type MockLlmHandler, type MockLlmQueueItem, type MockUiAnswer, MockUiBridge, OpenAiCompatibleClient, type OpenAiCompatibleClientConfig, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, type RenderBlock, type RenderResultRequest, type RouteResult, type RunResult, type RunTerminationReason, type RuntimePhase, type RuntimeRun, type RuntimeSession, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, type ScriptExecutionContext, type ScriptExecutor, type SkillCatalog, type SkillCatalogEntry, SkillDiscovery, type SkillDocument, type SkillIssue, type SkillLocation, type SkillMetadata, SkillReader, type SkillRouter, type SkillSource, type ToolDefinition, type ToolResolution, type ToolResult, type TraceClock, type TraceEvent, type TraceEventType, TraceRecorder, type UiBridge, type ValidationReport, type VercelToolSpec, WebSkillError, type WebSkillErrorCode, WebSkillRuntime, type WebSkillRuntimeDeps, bridgeError, buildCatalog, buildRenderResult, checkSkillRules, createScriptContext, escapeXml, fromVercelResult, fromVercelStreamPart, isValidSkillName, jsonRenderer, mergeCatalogEntries, normalizePath, normalizeToolContent, parseBridgeRequest, parseSkillMarkdown, renderAvailableSkillsXml, renderCatalogJson, resolveInsideRoot, resolveToolName, schemaToForm, toLlmToolSpec, toVercelToolSpecs, validateSkills, xmlRenderer };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { A as schemaToForm, B as checkSkillRules, C as createScriptContext, D as normalizeToolContent, E as mergeCatalogEntries, F as SKILL_NAME_PATTERN, G as parseSkillMarkdown, H as isValidSkillName, I as SkillDiscovery, J as resolveInsideRoot, K as renderAvailableSkillsXml, L as SkillReader, M as toVercelToolSpecs, N as MemoryFS, O as parseBridgeRequest, P as SKILL_NAME_MAX_LENGTH, R as WebSkillError, S as buildRenderResult, T as fromVercelStreamPart, U as jsonRenderer, V as escapeXml, W as normalizePath, X as xmlRenderer, Y as validateSkills, _ as READ_SKILL_FILE_TOOL, a as EventBus, b as WebSkillRuntime, c as FullDisclosureRouter, d as MemoryArtifactStore, f as MockLlmClient, g as READ_SKILL_FILE_INPUT_SCHEMA, h as ProgressiveRouter, i as AgentLoop, j as toLlmToolSpec, k as resolveToolName, l as HookRunner, m as OpenAiCompatibleClient, n as ASK_USER_TOOL, o as FsArtifactStore, p as MockUiBridge, q as renderCatalogJson, r as ASK_USER_TOOL_NAME, s as FsMemoryStore, t as ASK_USER_INPUT_SCHEMA, u as InMemoryStore, v as READ_SKILL_FILE_TOOL_NAME, w as fromVercelResult, x as bridgeError, y as TraceRecorder, z as buildCatalog } from "./dist-B_ldNWwT.js";
+
+export { ASK_USER_INPUT_SCHEMA, ASK_USER_TOOL, ASK_USER_TOOL_NAME, AgentLoop, EventBus, FsArtifactStore, FsMemoryStore, FullDisclosureRouter, HookRunner, InMemoryStore, MemoryArtifactStore, MemoryFS, MockLlmClient, MockUiBridge, OpenAiCompatibleClient, ProgressiveRouter, READ_SKILL_FILE_INPUT_SCHEMA, READ_SKILL_FILE_TOOL, READ_SKILL_FILE_TOOL_NAME, SKILL_NAME_MAX_LENGTH, SKILL_NAME_PATTERN, SkillDiscovery, SkillReader, TraceRecorder, WebSkillError, WebSkillRuntime, bridgeError, buildCatalog, buildRenderResult, checkSkillRules, createScriptContext, escapeXml, fromVercelResult, fromVercelStreamPart, isValidSkillName, jsonRenderer, mergeCatalogEntries, normalizePath, normalizeToolContent, parseBridgeRequest, parseSkillMarkdown, renderAvailableSkillsXml, renderCatalogJson, resolveInsideRoot, resolveToolName, schemaToForm, toLlmToolSpec, toVercelToolSpecs, validateSkills, xmlRenderer };

package/dist/mcp.d.ts

@@ -0,0 +1,237 @@
+import { Bt as SkillDocument, F as LlmToolSpec, Nt as JsonSchema, Rt as SkillCatalogEntry, St as mergeCatalogEntries, ct as ToolResult, m as ExternalToolSource, p as ExternalSkillProvider } from "./index-88KNOnbr.js";
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+//#region ../mcp/dist/index.d.ts
+//#region src/transport/messagePort.d.ts
+/**
+ * 显式 MessagePort 接口（禁止 arity 嗅探）。
+ * window/iframe 的 targetOrigin 差异由调用方在适配层处理，不进 transport 主体。
+ */
+interface MessagePortLike {
+  postMessage(message: unknown): void;
+  addEventListener(type: 'message', listener: (event: {
+    data: unknown;
+    origin?: string;
+  }) => void): void;
+  removeEventListener(type: 'message', listener: (event: {
+    data: unknown;
+  }) => void): void;
+  start?(): void;
+  close?(): void;
+}
+//#endregion
+//#region src/transport/jsonRpc.d.ts
+/**
+ * JSON-RPC 2.0 消息校验（守卫）。
+ * 规则：jsonrpc === '2.0'；请求/通知有 method；响应有 id 且 result/error 恰好其一；
+ * error 必须含数值 code 与字符串 message。
+ */
+declare function validateJsonRpcMessage(value: unknown): boolean;
+//#endregion
+//#region src/transport/messageChannelTransport.d.ts
+type TransportState = 'idle' | 'listening' | 'connected' | 'closed' | 'failed';
+interface MessageChannelTransportOptions {
+  /** 缺省 = 当前 origin（无 window 环境时不校验）；显式 ['*'] 才全放行 */
+  allowedOrigins?: string[];
+  /** start 后等待首个合法消息的超时；0/缺省 = 不超时 */
+  connectionTimeoutMs?: number;
+}
+/**
+ * 跑在 MessageChannel/MessagePort 端点间的 MCP Transport。
+ * 入站双重校验（origin 白名单 + JSON-RPC），失败走 onerror 不静默。
+ */
+declare class MessageChannelTransport implements Transport {
+  #private;
+  onclose?: () => void;
+  onerror?: (error: Error) => void;
+  onmessage?: (message: JSONRPCMessage) => void;
+  constructor(port: MessagePortLike, options?: MessageChannelTransportOptions);
+  get state(): TransportState;
+  start(): Promise<void>;
+  send(message: JSONRPCMessage): Promise<void>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/registry/endpointRegistry.d.ts
+/** endpoint 名 → client 注册表；单调版本号，事件驱动等待（禁止轮询） */
+declare class EndpointRegistry<TClient> {
+  #private;
+  /** 注册新 endpoint；重名抛错 */
+  register(endpoint: string, client: TClient): void;
+  /** 热替换 client，版本号 +1 */
+  set(endpoint: string, client: TClient): void;
+  get(endpoint: string): TClient;
+  unregister(endpoint: string): void;
+  version(endpoint: string): number;
+  endpoints(): string[];
+  /** 事件驱动等待 endpoint 出现；超时 reject */
+  waitFor(endpoint: string, timeoutMs: number): Promise<TClient>;
+}
+//#endregion
+//#region src/resolver/mcpToolResolver.d.ts
+/** MCP Client 最小接口（SDK Client 结构兼容，测试可纯对象替身） */
+interface McpClientLike {
+  listTools(): Promise<{
+    tools: Array<{
+      name: string;
+      description?: string;
+      inputSchema?: unknown;
+    }>;
+  }>;
+  callTool(input: {
+    name: string;
+    arguments?: Record<string, unknown>;
+  }): Promise<unknown>;
+  listPrompts(): Promise<{
+    prompts: Array<{
+      name: string;
+      description?: string;
+    }>;
+  }>;
+  getPrompt(input: {
+    name: string;
+  }): Promise<{
+    description?: string;
+    messages?: Array<{
+      role?: string;
+      content?: unknown;
+    }>;
+  }>;
+  listResources(): Promise<{
+    resources: Array<{
+      uri: string;
+      name?: string;
+      mimeType?: string;
+    }>;
+  }>;
+  readResource(input: {
+    uri: string;
+  }): Promise<{
+    contents?: Array<{
+      uri: string;
+      text?: string;
+      blob?: string;
+      mimeType?: string;
+    }>;
+  }>;
+}
+/**
+ * endpoint:toolName 调用 + 工具清单缓存（TTL 默认 1s + registry 版本号双失效）。
+ */
+declare class McpToolResolver {
+  #private;
+  constructor(registry: EndpointRegistry<McpClientLike>, options?: {
+    cacheTtlMs?: number;
+  });
+  call(endpoint: string, toolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+}
+//#endregion
+//#region src/resolver/nameSanitize.d.ts
+/**
+ * LLM 可见名消毒（OpenAI 工具名只允许 [a-zA-Z0-9_-]）。
+ * 约定：`endpoint:tool` ↔ `endpoint__tool`，`mcp#tool` ↔ `mcp__tool`；
+ * 反向映射基于已知前缀，无歧义。
+ */
+declare function endpointToolLlmName(endpoint: string, toolName: string): string;
+declare function parseEndpointToolLlmName(endpoint: string, llmName: string): string | undefined;
+declare function webMcpToolLlmName(toolName: string): string;
+declare function parseWebMcpToolLlmName(llmName: string): string | undefined;
+//#endregion
+//#region src/skills/temporarySkillProvider.d.ts
+/**
+ * 消费端：endpoint 的 prompts → 临时技能（source:'mcp'，随 endpoint 生灭）；
+ * resources → 可读 references（readFile 的 path 即 resource URI）。
+ */
+declare class TemporarySkillProvider implements ExternalSkillProvider {
+  #private;
+  constructor(deps: {
+    registry: EndpointRegistry<McpClientLike>;
+    endpoint: string;
+  });
+  /** endpoint 未注册时返回空（断开即技能消失） */
+  listSkills(): Promise<SkillCatalogEntry[]>;
+  loadSkill(name: string): Promise<SkillDocument>;
+  /** path 即 resource URI；blob 内容转 base64 标注 */
+  readFile(name: string, relativePath: string): Promise<string>;
+}
+//#endregion
+//#region src/skills/serveSkillAsMcp.d.ts
+interface ServedSkill {
+  name: string;
+  description: string;
+  /** SKILL.md 正文 */
+  body: string;
+  resources?: Array<{
+    uri: string;
+    name?: string;
+    text: string;
+    mimeType?: string;
+  }>;
+  tools?: Array<{
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+  }>;
+}
+/** 注册端：在页面 MCP server 上一行声明动态技能（prompt + resources + tools） */
+declare function serveSkillAsMcp(server: McpServer, skill: ServedSkill): void;
+//#endregion
+//#region src/skills/catalogMerge.d.ts
+/**
+ * 本地/临时 Catalog 合并：同名本地优先；mcp:// URI 保留用于强制指定临时技能。
+ * 实现单一来源在 runtime（runtime 自身合并也用同一函数）。
+ */
+declare const catalogMerge: typeof mergeCatalogEntries;
+//#endregion
+//#region src/webmcp/experimentalWebMcpAdapter.d.ts
+/** navigator.modelContext 鸭子类型（对齐浏览器 WebMCP API 草案） */
+interface BrowserModelContextLike {
+  listTools?: () => Promise<unknown>;
+  executeTool?: (name: string, argsJson: string) => Promise<unknown>;
+}
+interface WebMcpToolDescriptor {
+  name: string;
+  description?: string;
+  inputSchema?: unknown;
+}
+/**
+ * Experimental WebMCP Adapter（mcp# 分支）：默认关闭显式启用；
+ * 不可用 TOOL_UNSUPPORTED；工具不存在 MCP_TOOL_NOT_FOUND。
+ * api 可传对象或惰性解析函数（页面异步注入 modelContext 的场景）。
+ */
+declare class ExperimentalWebMcpAdapter {
+  #private;
+  constructor(api?: BrowserModelContextLike | (() => BrowserModelContextLike | undefined), options?: {
+    enabled?: boolean;
+  });
+  isAvailable(): boolean;
+  /** 工具清单（listTools 缺失/失败时返回 undefined）；描述含 inputSchema 时透传 */
+  listTools(): Promise<WebMcpToolDescriptor[] | undefined>;
+  /** 工具名清单（listTools 缺失/失败时返回 undefined） */
+  listToolNames(): Promise<string[] | undefined>;
+  call(toolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+}
+//#endregion
+//#region src/plugin/mcpRuntimePlugin.d.ts
+/**
+ * runtime 扩展点实现：endpoint 注册表 + WebMCP adapter 一处装配。
+ * LLM 可见名：endpoint__tool / mcp__tool；call 时反向映射。
+ */
+declare class McpRuntimePlugin implements ExternalToolSource {
+  #private;
+  readonly kind = "mcp";
+  constructor(deps: {
+    registry: EndpointRegistry<McpClientLike>;
+    webMcp?: ExperimentalWebMcpAdapter;
+    resolver?: McpToolResolver;
+    /** 已知的 endpoint 名（注销后仍按 MCP_ENDPOINT_UNAVAILABLE 响应，而非 TOOL_NOT_FOUND） */
+    endpoints?: string[];
+  });
+  listToolSpecs(): Promise<LlmToolSpec[]>;
+  canHandle(llmToolName: string): boolean;
+  call(llmToolName: string, args: Record<string, unknown>): Promise<ToolResult>;
+}
+//#endregion
+export { type BrowserModelContextLike, EndpointRegistry, ExperimentalWebMcpAdapter, type McpClientLike, McpRuntimePlugin, McpToolResolver, MessageChannelTransport, type MessageChannelTransportOptions, type MessagePortLike, type ServedSkill, TemporarySkillProvider, type TransportState, type WebMcpToolDescriptor, catalogMerge, endpointToolLlmName, parseEndpointToolLlmName, parseWebMcpToolLlmName, serveSkillAsMcp, validateJsonRpcMessage, webMcpToolLlmName };