pi2dsh 0.3.5 → 0.5.0

package/README.md

@@ -94,6 +94,23 @@ node dist/cli.mjs mcp-config                        # Pi mcpServers → DSH patc
 dsh plugin --profile headless add file:$PWD/pi-host
 ```
 
+## Examples: copy-paste working capabilities
+
+**Every verified capability ships as a complete, runnable example under
+[`examples/`](examples/)** — clone the repo, follow one example's README from
+zero to seeing the feature run. Every command in an example has actually been
+executed against a real DSH loop (CLI and web) before landing here; nothing
+is aspirational.
+
+| Example | What you get |
+|---|---|
+| [`examples/vision-bridge`](examples/vision-bridge/) | A text-only model answers questions about images: mention an image path, a configured vision model reads it, the analysis is injected into the conversation (works in CLI and the DSH web app; probe images included) |
+| [`examples/custom-models`](examples/custom-models/) | Define a provider once in Pi's standard `models.json` — it becomes a native DSH llm route: visible in the DSH web model picker, usable as the main model, and resolvable/callable by every Pi plugin through one directory |
+
+More verified capabilities (approval guardian, cross-session memory,
+interactive OAuth, MCP config conversion, host mode) get their examples as
+each one is re-verified end to end under the same bar.
+
 ## Interactive OAuth: sign in with your subscription
 
 DSH ships static HTTP headers only; pi2dsh adds the interactive OAuth layer from the Pi ecosystem. Any Pi provider package that registers an `oauth` block gets a working `/login <provider>` command on DSH, driven by the package's own protocol code. Pi's four official flows ship built in (vendored byte-identical): **OpenAI Codex (ChatGPT Plus/Pro)**, **Anthropic**, **GitHub Copilot**, **Kimi Code**.

package/README.zh.md

@@ -94,6 +94,17 @@ node dist/cli.mjs mcp-config                        # Pi mcpServers → DSH patc
 dsh plugin --profile headless add file:$PWD/pi-host
 ```
 
+## Examples：每个能力都有完整可跑的示例
+
+**每个已验证的能力，都在 [`examples/`](examples/) 下有一份完整可直接运行的示例**——克隆仓库，照任意一个示例的 README 从零走到看到效果。示例里的每条命令都在真实 DSH loop（CLI 和 Web 双端）上实际执行过才收录，没有"理论上可以"的内容。
+
+| 示例 | 你得到什么 |
+|---|---|
+| [`examples/vision-bridge`](examples/vision-bridge/) | 纯文本模型回答图片问题：消息里带图片路径，配置的视觉模型识图，分析结果注入对话（CLI 与 DSH Web 都能用；附探针测试图） |
+| [`examples/custom-models`](examples/custom-models/) | 在 Pi 标准 `models.json` 里定义一次 provider——它成为原生 DSH llm 路由：出现在 DSH Web 模型选择器、可当主模型对话、所有 Pi 插件经同一个目录可见可调 |
+
+更多已验证能力（审批 guardian、跨会话记忆、交互式 OAuth、MCP 配置转换、host 模式）的示例，将按同一标准逐个重新端到端验证后补齐。
+
 ## 交互式 OAuth：用你的订阅账号登录
 
 DSH 原生只有静态 HTTP headers；pi2dsh 把 Pi 生态的交互式 OAuth 层带了过来。任何注册了 `oauth` 块的 Pi provider 包，在 DSH 上都直接获得可用的 `/login <provider>` 命令，登录流程由包自己的协议代码驱动。Pi 的四条官方流内建（vendored 字节级）：**OpenAI Codex（ChatGPT Plus/Pro）**、**Anthropic**、**GitHub Copilot**、**Kimi Code**。

package/dist/{all-Rt4K68QA.mjs → all-DSpxKvHa.mjs}

@@ -26804,7 +26804,7 @@ function amazonBedrockProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/openai-completions.lazy.js
-const openAICompletionsApi = () => lazyApi(() => import("./openai-completions-fXHhRolF.mjs"));
+const openAICompletionsApi = () => lazyApi(() => import("./openai-completions-By8QNX1P.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/ant-ling.js
 function antLingProvider() {
@@ -26819,7 +26819,7 @@ function antLingProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/anthropic-messages.lazy.js
-const anthropicMessagesApi = () => lazyApi(() => import("./anthropic-messages-Beym0_aC.mjs"));
+const anthropicMessagesApi = () => lazyApi(() => import("./anthropic-messages-BL9N1Idv.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/auth/oauth/load.js
 var __rewriteRelativeImportExtension$1 = function(path, preserveJsx) {
@@ -26944,7 +26944,7 @@ function anthropicProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/azure-openai-responses.lazy.js
-const azureOpenAIResponsesApi = () => lazyApi(() => import("./azure-openai-responses-cHqZTgLD.mjs"));
+const azureOpenAIResponsesApi = () => lazyApi(() => import("./azure-openai-responses-A67VbaZ1.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/azure-openai-responses.js
 function azureOpenAIResponsesProvider() {
@@ -26982,7 +26982,7 @@ function cerebrasProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/openai-responses.lazy.js
-const openAIResponsesApi = () => lazyApi(() => import("./openai-responses-DKdCYf3h.mjs"));
+const openAIResponsesApi = () => lazyApi(() => import("./openai-responses-DboJUcFN.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare-auth.js
 const CLOUDFLARE_API_KEY = "CLOUDFLARE_API_KEY";
@@ -27184,7 +27184,7 @@ function githubCopilotProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/google-generative-ai.lazy.js
-const googleGenerativeAIApi = () => lazyApi(() => import("./google-generative-ai-B7OZs5lu.mjs"));
+const googleGenerativeAIApi = () => lazyApi(() => import("./google-generative-ai-DT5S8D8y.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/google.js
 function googleProvider() {
@@ -27199,7 +27199,7 @@ function googleProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/google-vertex.lazy.js
-const googleVertexApi = () => lazyApi(() => import("./google-vertex-DmdaHQtB.mjs"));
+const googleVertexApi = () => lazyApi(() => import("./google-vertex-Dpq7O7Be.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/google-vertex.js
 const VERTEX_ADC_PATH = "~/.config/gcloud/application_default_credentials.json";
@@ -27372,7 +27372,7 @@ function minimaxCnProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/mistral-conversations.lazy.js
-const mistralConversationsApi = () => lazyApi(() => import("./mistral-conversations-HHZCcFv_.mjs").then((n) => n.t));
+const mistralConversationsApi = () => lazyApi(() => import("./mistral-conversations-BsxbCCWx.mjs").then((n) => n.t));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/mistral.js
 function mistralProvider() {
@@ -27435,7 +27435,7 @@ function openaiProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/openai-codex-responses.lazy.js
-const openAICodexResponsesApi = () => lazyApi(() => import("./openai-codex-responses-vmovNu-q.mjs"));
+const openAICodexResponsesApi = () => lazyApi(() => import("./openai-codex-responses-C7vviVT2.mjs"));
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/providers/openai-codex.js
 function openaiCodexProvider() {
@@ -28195,7 +28195,7 @@ function qwenTokenPlanIndividualProvider() {
 }
 //#endregion
 //#region node_modules/.pnpm/@earendil-works+pi-ai@0.84.1_ws@8.21.3_zod@4.4.3/node_modules/@earendil-works/pi-ai/dist/api/pi-messages.lazy.js
-const piMessagesApi = () => lazyApi(() => import("./pi-messages-CV-Ts8An.mjs"));
+const piMessagesApi = () => lazyApi(() => import("./pi-messages-B-7Xo_I0.mjs"));
 function isRadiusGatewayModel(value) {
 	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
 	const model = value;
@@ -28509,4 +28509,4 @@ function builtinImagesModels(options) {
 //#endregion
 export { builtinImagesModels, builtinImagesProviders, builtinModels, builtinProviders, getBuiltinModel, getBuiltinModelDataGeneratedAt, getBuiltinModels, getBuiltinProviders, radiusProvider };
 
-//# sourceMappingURL=all-Rt4K68QA.mjs.map
+//# sourceMappingURL=all-DSpxKvHa.mjs.map