@zhexin/pi-deepseek 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jiang zhexin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# Pi DeepSeek Enhancement
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Enhancement Extension for the [Pi](https://pi.dev) coding agent.
+
+Include **web search/fetch** tools. Nothing more.
+
+Most extensions I've tried seem to be compensating for something. Config that fights pi's philosophy, feature lists that look like a spaceship's dashboard, and UIs that assume you wanted a personal assistant.
+
+This one does less. On purpose.
+
+## Features
+
+- **Boring code.** Small, readable TypeScript. Auditing it takes less time than reading this README.
+- **Boring config.** No config files, no opinionated defaults. Set one API key, get on with your life.
+- **Invisible.** No new commands, no UI surface, no surprises. If you didn't know it was installed, you'd never notice.
+
+## Quick Start
+
+### Installation
+
+```bash
+pi install npm:@zhexin/pi-deepseek
+```
+
+### Setup Your DeepSeek API Key
+
+```bash
+pi auth login deepseek
+```
+
+## LICENSE
+
+MIT

package/index.ts

@@ -0,0 +1 @@
+export { default } from "./src/index.ts";

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@zhexin/pi-deepseek",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "DeepSeek Enhancement for Pi",
+  "version": "0.0.2",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "pi-package",
+    "deepseek",
+    "web-access"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jiang-zhexin/pi-pi.git",
+    "directory": "packages/deepseek"
+  },
+  "homepage": "https://github.com/jiang-zhexin/pi-pi/tree/HEAD/packages/deepseek#readme",
+  "bugs": {
+    "url": "https://github.com/jiang-zhexin/pi-pi/issues"
+  },
+  "files": [
+    "src/*",
+    "index.ts"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": "./index.ts"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/src/index.ts

@@ -0,0 +1,108 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { Static } from "typebox";
+
+import { fetchInput, fetchOutput, searchInput, searchOutput } from "./schema.ts";
+
+const unauthorized = new Error("Unauthorized. Run `/login deepseek` to authenticate.");
+
+async function resolveDeepSeekRequest(ctx: ExtensionContext, path: string) {
+  const authResult = await ctx.modelRegistry.getProviderAuth("deepseek");
+  const apiKey = authResult?.auth.apiKey;
+  if (apiKey === undefined) throw unauthorized;
+
+  const baseUrl =
+    authResult?.auth.baseUrl ??
+    ctx.modelRegistry.getProvider("deepseek")?.baseUrl ??
+    "https://api.deepseek.com";
+
+  return {
+    url: new URL(path, baseUrl),
+    headers: {
+      ...authResult?.auth.headers,
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json",
+    },
+  };
+}
+
+export default function (pi: ExtensionAPI): void {
+  pi.registerTool({
+    name: "web-search",
+    label: "DeepSeek Web Search",
+    description: "Search web pages for a query and return structured results.",
+    parameters: searchInput,
+    outputSchema: searchOutput,
+    async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+      const { url, headers } = await resolveDeepSeekRequest(ctx, "/v1/tools/search");
+
+      const response = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params),
+        signal: signal ?? null,
+      });
+
+      if (!response.ok) {
+        if (response.status === 401) throw unauthorized;
+
+        const errorText = await response.text().catch(() => "");
+        throw new Error(
+          `DeepSeek Search API error (status ${response.status}): ${errorText || response.statusText}`,
+        );
+      }
+
+      const data = (await response.json()) as Static<typeof searchOutput>;
+      const formatted = data.results
+        .map((r, i) =>
+          [
+            `${i + 1}. ${r.title}`,
+            `   URL: ${r.url}`,
+            ...(r.date ? [`   Date: ${r.date}`] : []),
+            r.summary || r.snippet,
+            ...(r.content ? [r.content] : []),
+          ].join("\n"),
+        )
+        .join("\n\n");
+
+      return {
+        content: [{ type: "text", text: formatted || "No results found." }],
+        structuredContent: data,
+        details: {},
+      };
+    },
+  });
+
+  pi.registerTool({
+    name: "web-fetch",
+    label: "DeepSeek Web Fetch",
+    description: "Fetch a single web page and return its content as Markdown.",
+    parameters: fetchInput,
+    outputSchema: fetchOutput,
+    async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+      const { url, headers } = await resolveDeepSeekRequest(ctx, "/v1/tools/fetch");
+
+      const response = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params),
+        signal: signal ?? null,
+      });
+
+      if (!response.ok) {
+        if (response.status === 401) throw unauthorized;
+
+        const errorText = await response.text().catch(() => "");
+        throw new Error(
+          `DeepSeek Fetch API error (status ${response.status}): ${errorText || response.statusText}`,
+        );
+      }
+
+      const data = (await response.json()) as Static<typeof fetchOutput>;
+      return {
+        content: [{ type: "text", text: `Title: ${data.title}\n\n${data.content}` }],
+        structuredContent: data,
+        details: {},
+      };
+    },
+  });
+}

package/src/schema.ts

@@ -0,0 +1,65 @@
+import { Type } from "typebox";
+
+export const searchInput = Type.Object({
+  query: Type.String({
+    minLength: 1,
+    maxLength: 128,
+    description:
+      "Supports site:, -site:, excluded terms, quoted phrases, lang:, after:, and before: operators.",
+  }),
+  count: Type.Optional(
+    Type.Integer({
+      minimum: 1,
+      maximum: 50,
+      default: 10,
+      description: "The number of results to return",
+    }),
+  ),
+  ori_question: Type.Optional(
+    Type.String({
+      minLength: 1,
+      maxLength: 128,
+      description: "The user's question that triggered the search to improve query understanding",
+    }),
+  ),
+  localization: Type.Optional(
+    Type.String({
+      description: "An IP address used to localize search results.",
+    }),
+  ),
+  need_content: Type.Optional(
+    Type.Boolean({
+      description: "Include full page content when available",
+    }),
+  ),
+});
+
+export const searchOutput = Type.Object({
+  results: Type.Array(
+    Type.Object({
+      rerank_score: Type.Number(),
+      title: Type.String(),
+      url: Type.String(),
+      snippet: Type.String(),
+      summary: Type.String(),
+      content: Type.String(),
+      site_name: Type.Union([Type.String(), Type.Null()]),
+      site_icon: Type.Union([Type.String(), Type.Null()]),
+      date: Type.Union([Type.String(), Type.Null()]),
+      authority: Type.Integer(),
+    }),
+  ),
+});
+
+export const fetchInput = Type.Object({
+  url: Type.String({
+    minLength: 1,
+    maxLength: 8192,
+    description: "The page URL to fetch",
+  }),
+});
+
+export const fetchOutput = Type.Object({
+  title: Type.String(),
+  content: Type.String(),
+});