@spences10/pi-omnisearch 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# @spences10/pi-omnisearch
+
+## 0.0.1
+
+### Patch Changes
+
+- 3ef8d39: Add Omnisearch and SQLite prompt shims; refine destructive
+  confirmation for session-created files.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Scott Spence
+
+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

@@ -0,0 +1,86 @@
+# @spences10/pi-omnisearch
+
+Pi extension that reminds the model to use `mcp-omnisearch` for
+verified web research instead of relying on stale model memory or
+search snippets.
+
+This package does **not** start the MCP server and does **not**
+duplicate its tools. `mcp-omnisearch` remains the source of truth;
+this extension only injects workflow guidance when Omnisearch MCP
+tools are available.
+
+## Installation
+
+```bash
+pi install npm:@spences10/pi-omnisearch
+```
+
+Local development from this monorepo:
+
+```bash
+pnpm --filter @spences10/pi-omnisearch run build
+pi install ./packages/pi-omnisearch
+# or for one run only
+pi -e ./packages/pi-omnisearch
+```
+
+## What it does
+
+The extension injects a system reminder telling the model to use
+`mcp-omnisearch` when the user asks to:
+
+- research current information
+- verify facts or citations
+- inspect documentation
+- compare packages, APIs, or tools
+- extract and summarize web content
+
+It encourages the verified research workflow from Scott's ecosystem
+skill:
+
+- use `web_search` for discovery
+- use `web_extract` to read actual source content before making claims
+- use `ai_search` for synthesized answers with sources
+- prefer official docs, repositories, release notes, and source files
+- report partial failures, conflicts, and uncertainty
+
+It adds no slash commands and no custom tools.
+
+## Example MCP config
+
+`mcp-omnisearch` must be configured separately, for example in
+`~/.pi/agent/mcp.json`:
+
+```json
+{
+	"mcpServers": {
+		"mcp-omnisearch": {
+			"command": "npx",
+			"args": ["-y", "mcp-omnisearch"]
+		}
+	}
+}
+```
+
+## Using from a custom harness
+
+```ts
+import omnisearch from '@spences10/pi-omnisearch';
+
+// pass `omnisearch` as an ExtensionFactory to your Pi runtime
+```
+
+`my-pi` imports this package directly and enables it as the built-in
+Omnisearch reminder.
+
+## Development
+
+```bash
+pnpm --filter @spences10/pi-omnisearch run check
+pnpm --filter @spences10/pi-omnisearch run test
+pnpm --filter @spences10/pi-omnisearch run build
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { BeforeAgentStartEvent, ExtensionAPI } from '@mariozechner/pi-coding-agent';
+export declare function should_inject_omnisearch_prompt(event: Pick<BeforeAgentStartEvent, 'systemPromptOptions'>): boolean;
+export default function omnisearch(pi: ExtensionAPI): Promise<void>;

package/dist/index.js

@@ -0,0 +1,42 @@
+const MCP_OMNISEARCH_TOOL_PREFIX = 'mcp__mcp-omnisearch__';
+const MCP_OMNISEARCH_TOOLS = new Set([
+    'web_search',
+    'ai_search',
+    'web_extract',
+]);
+function is_mcp_omnisearch_tool(tool_name) {
+    if (tool_name.startsWith(MCP_OMNISEARCH_TOOL_PREFIX))
+        return true;
+    const [, server_name, tool] = tool_name.split('__');
+    if (!server_name?.includes('omnisearch') || !tool)
+        return false;
+    return MCP_OMNISEARCH_TOOLS.has(tool);
+}
+export function should_inject_omnisearch_prompt(event) {
+    const selected_tools = event.systemPromptOptions?.selectedTools;
+    return (!selected_tools || selected_tools.some(is_mcp_omnisearch_tool));
+}
+export default async function omnisearch(pi) {
+    pi.on('before_agent_start', async (event) => {
+        if (!should_inject_omnisearch_prompt(event))
+            return {};
+        return {
+            systemPrompt: event.systemPrompt +
+                `
+
+## Web research via mcp-omnisearch
+
+You have access to \`mcp-omnisearch\`, a unified MCP server for web search, AI answers, and content extraction. Use it when the user asks to research, verify current information, inspect documentation, compare tools, find sources, or cite external facts.
+
+Preferred workflow:
+- Use \`mcp__mcp-omnisearch__web_search\` for discovery. Pick providers intentionally: Tavily for factual/cited search, Brave or Kagi for operators like \`site:\` and \`filetype:\`, Exa for semantic discovery.
+- Use \`mcp__mcp-omnisearch__web_extract\` to read actual source content before presenting claims. Do not rely on search snippets alone.
+- Use \`mcp__mcp-omnisearch__ai_search\` when a synthesized answer with sources is more useful than raw results.
+- For docs or packages, prefer official docs, repos, release notes, and source files; verify before summarizing.
+- Report partial failures, source conflicts, or uncertainty instead of silently guessing.
+
+Do not rely only on stale model memory for current web facts when mcp-omnisearch is available.`,
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAE3D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACpC,YAAY;IACZ,WAAW;IACX,aAAa;CACb,CAAC,CAAC;AAEH,SAAS,sBAAsB,CAAC,SAAiB;IAChD,IAAI,SAAS,CAAC,UAAU,CAAC,0BAA0B,CAAC;QAAE,OAAO,IAAI,CAAC;IAElE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC9C,KAAyD;IAEzD,MAAM,cAAc,GAAG,KAAK,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAChE,OAAO,CACN,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAC9D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,UAAU,CAAC,EAAgB;IACxD,EAAE,CAAC,EAAE,CACJ,oBAAoB,EACpB,KAAK,EAAE,KAA4B,EAAE,EAAE;QACtC,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvD,OAAO;YACN,YAAY,EACX,KAAK,CAAC,YAAY;gBAClB;;;;;;;;;;;;;+FAa0F;SAC3F,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@spences10/pi-omnisearch",
+  "version": "0.0.1",
+  "description": "Pi extension that reminds the model to use mcp-omnisearch for verified web research",
+  "keywords": [
+    "mcp",
+    "omnisearch",
+    "pi",
+    "pi-package",
+    "research",
+    "search",
+    "web"
+  ],
+  "license": "MIT",
+  "author": "Scott Spence <me@scottspence.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spences10/my-pi.git",
+    "directory": "packages/pi-omnisearch"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@mariozechner/pi-coding-agent": "^0.70.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.0",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  }
+}