@spences10/pi-sqlite-tools 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# @spences10/pi-sqlite-tools
+
+## 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,83 @@
+# @spences10/pi-sqlite-tools
+
+Pi extension that reminds the model to prefer `mcp-sqlite-tools` for
+SQLite database work instead of raw `sqlite3` shell commands.
+
+This package does **not** start the MCP server and does **not**
+duplicate its tools. `mcp-sqlite-tools` remains the source of truth;
+this extension only injects workflow guidance when SQLite MCP tools
+are available.
+
+## Installation
+
+```bash
+pi install npm:@spences10/pi-sqlite-tools
+```
+
+Local development from this monorepo:
+
+```bash
+pnpm --filter @spences10/pi-sqlite-tools run build
+pi install ./packages/pi-sqlite-tools
+# or for one run only
+pi -e ./packages/pi-sqlite-tools
+```
+
+## What it does
+
+The extension injects a system reminder telling the model to use
+`mcp-sqlite-tools` when working with SQLite files such as:
+
+- `.db`
+- `.sqlite`
+- `.sqlite3`
+
+It encourages the safer MCP workflow:
+
+- open databases with `open_database`
+- inspect structure with `database_info`, `list_tables`,
+  `describe_table`, and `export_schema`
+- run reads with `execute_read_query`
+- back up and use transactions before writes or schema changes
+- close databases when finished
+
+It adds no slash commands and no custom tools.
+
+## Example MCP config
+
+`mcp-sqlite-tools` must be configured separately, for example in
+`~/.pi/agent/mcp.json`:
+
+```json
+{
+	"mcpServers": {
+		"mcp-sqlite-tools": {
+			"command": "npx",
+			"args": ["-y", "mcp-sqlite-tools"]
+		}
+	}
+}
+```
+
+## Using from a custom harness
+
+```ts
+import sqliteTools from '@spences10/pi-sqlite-tools';
+
+// pass `sqliteTools` as an ExtensionFactory to your Pi runtime
+```
+
+`my-pi` imports this package directly and enables it as the built-in
+SQLite tools reminder.
+
+## Development
+
+```bash
+pnpm --filter @spences10/pi-sqlite-tools run check
+pnpm --filter @spences10/pi-sqlite-tools run test
+pnpm --filter @spences10/pi-sqlite-tools 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_sqlite_tools_prompt(event: Pick<BeforeAgentStartEvent, 'systemPromptOptions'>): boolean;
+export default function sqlite_tools(pi: ExtensionAPI): Promise<void>;

package/dist/index.js

@@ -0,0 +1,64 @@
+const MCP_SQLITE_TOOL_PREFIX = 'mcp__mcp-sqlite-tools__';
+const MCP_SQLITE_TOOL_SUFFIXES = new Set([
+    'open_database',
+    'create_database',
+    'close_database',
+    'list_databases',
+    'database_info',
+    'list_tables',
+    'describe_table',
+    'create_table',
+    'drop_table',
+    'backup_database',
+    'vacuum_database',
+    'execute_read_query',
+    'execute_write_query',
+    'execute_schema_query',
+    'bulk_insert',
+    'begin_transaction',
+    'commit_transaction',
+    'rollback_transaction',
+    'export_schema',
+    'import_schema',
+]);
+function is_mcp_sqlite_tool(tool_name) {
+    if (tool_name.startsWith(MCP_SQLITE_TOOL_PREFIX))
+        return true;
+    const [, server_name, tool] = tool_name.split('__');
+    if (!server_name?.includes('sqlite') || !tool)
+        return false;
+    return MCP_SQLITE_TOOL_SUFFIXES.has(tool);
+}
+export function should_inject_sqlite_tools_prompt(event) {
+    const selected_tools = event.systemPromptOptions?.selectedTools;
+    return !selected_tools || selected_tools.some(is_mcp_sqlite_tool);
+}
+export default async function sqlite_tools(pi) {
+    pi.on('before_agent_start', async (event) => {
+        if (!should_inject_sqlite_tools_prompt(event))
+            return {};
+        return {
+            systemPrompt: event.systemPrompt +
+                `
+
+## SQLite database access via mcp-sqlite-tools
+
+You have access to \`mcp-sqlite-tools\`, a gated MCP server for SQLite database work. Prefer it over raw \`sqlite3\`, Python SQLite scripts, or ad-hoc SQL through \`bash\` when inspecting or modifying SQLite files.
+
+Use it when:
+- The user asks to inspect, query, analyze, or modify \`.db\`, \`.sqlite\`, or \`.sqlite3\` files
+- You need schema, tables, row counts, PRAGMAs, telemetry, analytics, or session data stored in SQLite
+- You are tempted to run \`sqlite3 ...\` or write a one-off script solely to execute SQL
+
+Preferred workflow:
+- Open existing databases with \`mcp__mcp-sqlite-tools__open_database\`; use \`create_database\` only when explicitly creating a new database
+- Discover structure with \`database_info\`, \`list_tables\`, \`describe_table\`, and \`export_schema\` before writing queries
+- Use \`execute_read_query\` for \`SELECT\`, \`PRAGMA\`, and \`EXPLAIN\`; keep result limits small unless the user asks otherwise
+- Before writes or schema changes, prefer \`backup_database\` and explicit transactions; use \`execute_write_query\` or \`execute_schema_query\` only when the intent is clear
+- Close databases with \`close_database\` when finished
+
+Use raw \`sqlite3\` or shell scripts only when MCP tools are unavailable or the user explicitly asks to bypass the MCP workflow. Do not bypass the MCP safety gates just to make destructive SQL easier.`,
+        };
+    });
+}
+//# 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,sBAAsB,GAAG,yBAAyB,CAAC;AAEzD,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACxC,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,sBAAsB;IACtB,aAAa;IACb,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,eAAe;IACf,eAAe;CACf,CAAC,CAAC;AAEH,SAAS,kBAAkB,CAAC,SAAiB;IAC5C,IAAI,SAAS,CAAC,UAAU,CAAC,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9D,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,OAAO,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iCAAiC,CAChD,KAAyD;IAEzD,MAAM,cAAc,GAAG,KAAK,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAChE,OAAO,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,YAAY,CAAC,EAAgB;IAC1D,EAAE,CAAC,EAAE,CACJ,oBAAoB,EACpB,KAAK,EAAE,KAA4B,EAAE,EAAE;QACtC,IAAI,CAAC,iCAAiC,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzD,OAAO;YACN,YAAY,EACX,KAAK,CAAC,YAAY;gBAClB;;;;;;;;;;;;;;;;;;yMAkBoM;SACrM,CAAC;IACH,CAAC,CACD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@spences10/pi-sqlite-tools",
+  "version": "0.0.1",
+  "description": "Pi extension that reminds the model to prefer mcp-sqlite-tools for SQLite database work",
+  "keywords": [
+    "database",
+    "mcp",
+    "pi",
+    "pi-package",
+    "sqlite"
+  ],
+  "license": "MIT",
+  "author": "Scott Spence <me@scottspence.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spences10/my-pi.git",
+    "directory": "packages/pi-sqlite-tools"
+  },
+  "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"
+  }
+}