os-dpt 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Paul Demick
+
+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,125 @@
+# os-dpt
+
+A local, web-based SQL editor with a built-in chat-to-SQL agent — where the
+agent's knowledge lives as **plain markdown files in your repo** that you can
+read, diff, and revert.
+
+You run it in your own working directory and use it from `localhost`. Your
+queries and the agent's evolving understanding of your data are ordinary files,
+version-controlled by git. Nothing about your data leaves your machine except
+what you send to your LLM provider when you ask the agent a question.
+
+## Why
+
+Good data agents are mostly about **context** — schema, business meaning, past
+queries, and hard-won corrections. Most tools keep that context in a vendor's
+database where you can't see it. os-dpt keeps every layer as a file you own:
+
+- **Live schema** — introspected from the database on demand.
+- **Curated docs** — `context/schemas.md`, `context/conventions.md`,
+  `context/feedback.md`: human- and agent-editable markdown, scoped per data
+  source.
+- **Memory** — when the agent learns something durable (a clarified column, a
+  data-quality quirk, a correction), it writes it back to those files. Because
+  they're git-tracked, you see a diff for every change the agent makes to its
+  own understanding, and you can revert it.
+
+The result is an agent whose "learning" is transparent and yours, not a black
+box.
+
+## Quick start
+
+```bash
+# In the directory you want as your workspace:
+npx os-dpt
+```
+
+This launches a local server on `127.0.0.1` and opens the editor in your
+browser. On first run it creates a workspace (see below). Add a database
+connection (Postgres to start), then open a worksheet or the chat panel.
+
+You'll need an Anthropic API key for the agent — set it in **Settings → AI
+providers**.
+
+To install it globally instead:
+
+```bash
+npm install -g os-dpt
+os-dpt
+```
+
+### Options
+
+```
+os-dpt [options]
+
+  --workspace <dir>   Workspace directory (default: current directory)
+  --port <n>          Preferred port (default: 3756, falls back if taken)
+  --no-open           Don't open the browser automatically
+  -v, --version       Print version
+  -h, --help          Show this help
+```
+
+## Workspace layout
+
+os-dpt treats your current directory as the workspace root (like `git` or
+`npm`):
+
+```
+<workspace>/
+├── .os-dpt/          # gitignored — encrypted credentials, cache, drafts
+├── worksheets/       # git-tracked .sql files, one per worksheet
+├── context/          # git-tracked agent memory (markdown), scoped per source
+├── connections.json  # connection metadata (no secrets)
+└── .gitignore        # excludes .os-dpt/
+```
+
+Anything sensitive lives in `.os-dpt/` and is gitignored. Anything worth
+versioning — your queries and the agent's context — is plain text at the root.
+
+If the directory isn't already a git repository, os-dpt runs `git init` so
+worksheet/context history works out of the box.
+
+## How the agent works
+
+A small, focused tool loop (see `server/agent/`):
+
+- `get_schema` — introspect live tables/columns.
+- `get_context` / `update_context` — read and write the markdown knowledge files.
+- `run_sql` — execute SQL (read-only by default; see Security).
+- `write_sql` — stage SQL into a worksheet for you to review and save.
+- `render_chart` — draw a chart inline from query results.
+- `ask_user_question` — pause and ask rather than guess.
+
+## Security
+
+os-dpt is a **single-user, loopback-only** tool with no API authentication, and
+the agent can run SQL against your database. **Connections are read-only by
+default**; you opt into writes per connection. For the full trust model —
+credential storage, the read-only guards, TLS behavior, and what gets sent to
+your LLM provider — read [SECURITY.md](./SECURITY.md) before pointing it at
+anything important.
+
+## Develop
+
+Requires Node and pnpm. This is a pnpm monorepo (`client` + `server`).
+
+```bash
+pnpm install
+pnpm dev          # Vite + Hono in parallel
+pnpm typecheck    # gate changes with this
+```
+
+Run the app against a throwaway workspace so you never materialize personal
+data in the repo:
+
+```bash
+os-dpt --workspace ./dev-workspace
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for design principles and how to add a
+database driver.
+
+## License
+
+[MIT](./LICENSE) © Paul Demick

package/bin/os-dpt.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// `npx os-dpt` entrypoint. Boots the bundled server (which serves the built
+// client on the same port), then opens the browser. The current working
+// directory is treated as the workspace — like git/npm.
+
+import { readFileSync } from "node:fs"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const pkg = JSON.parse(readFileSync(path.join(here, "..", "package.json"), "utf8"))
+
+const argv = process.argv.slice(2)
+const has = (...flags) => flags.some((f) => argv.includes(f))
+
+if (has("--help", "-h")) {
+  console.log(`os-dpt ${pkg.version} — local SQL editor with a chat-to-SQL agent
+
+Usage:
+  os-dpt [options]
+
+Options:
+  --workspace <dir>   Workspace directory (default: current directory)
+  --port <n>          Preferred port (default: 3756, falls back if taken)
+  --no-open           Don't open the browser automatically
+  -v, --version       Print version
+  -h, --help          Show this help
+
+The current directory becomes your workspace: worksheets/ and context/ are
+git-tracked; secrets live in .os-dpt/ (gitignored).`)
+  process.exit(0)
+}
+
+if (has("--version", "-v")) {
+  console.log(pkg.version)
+  process.exit(0)
+}
+
+// startServer(argv) does the real arg parsing (--workspace, --no-open, --port).
+// We pre-read --port here only to set process.env.PORT *before* importing the
+// server bundle, since some config reads the env at module load.
+const portIdx = argv.findIndex((a) => a === "--port")
+if (portIdx !== -1 && argv[portIdx + 1]) {
+  process.env.PORT = argv[portIdx + 1]
+}
+
+const { startServer, openBrowser } = await import("../server/dist/index.mjs")
+
+const boot = await startServer(argv)
+
+console.log(`\n  os-dpt is running`)
+console.log(`  ➜  ${boot.url}`)
+console.log(`  ➜  workspace: ${boot.workspace}`)
+console.log(`\n  Press Ctrl-C to stop.\n`)
+
+if (!has("--no-open")) {
+  const opened = await openBrowser(boot.url)
+  if (!opened) console.log(`  Open ${boot.url} in your browser.`)
+}
+
+const shutdown = async () => {
+  await boot.close()
+  process.exit(0)
+}
+process.on("SIGINT", shutdown)
+process.on("SIGTERM", shutdown)

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "os-dpt",
+  "version": "0.0.1",
+  "description": "Local web-based SQL editor with a built-in chat-to-SQL AI agent.",
+  "type": "module",
+  "packageManager": "pnpm@10.30.3",
+  "license": "MIT",
+  "author": "Paul Demick",
+  "homepage": "https://github.com/pdemick/os-dpt#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pdemick/os-dpt.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pdemick/os-dpt/issues"
+  },
+  "keywords": [
+    "sql",
+    "sql-editor",
+    "postgres",
+    "ai-agent",
+    "text-to-sql",
+    "chat-to-sql",
+    "local-first"
+  ],
+  "bin": {
+    "os-dpt": "bin/os-dpt.mjs"
+  },
+  "files": [
+    "bin/",
+    "server/dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.12"
+  },
+  "scripts": {
+    "dev": "node ./scripts/dev.mjs",
+    "dev:client": "pnpm --dir client dev",
+    "dev:server": "pnpm --dir server dev",
+    "build": "pnpm run build:client && pnpm run build:server",
+    "build:client": "pnpm --dir client build",
+    "build:server": "node ./scripts/build-server.mjs",
+    "start": "node bin/os-dpt.mjs",
+    "typecheck": "pnpm -r typecheck",
+    "lint": "pnpm --dir client lint",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.97.0",
+    "@hono/node-server": "^1.13.7",
+    "better-sqlite3": "^12.10.0",
+    "hono": "^4.12.28",
+    "keytar": "^7.9.0",
+    "pg": "^8.13.1"
+  },
+  "peerDependencies": {
+    "braintrust": "^3.11.0"
+  },
+  "peerDependenciesMeta": {
+    "braintrust": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.12"
+  },
+  "pnpm": {
+    "overrides": {
+      "braintrust": "^3.20.0",
+      "@babel/core@<7.29.6": "^7.29.6",
+      "esbuild@>=0.27.3 <0.28.1": "0.28.1"
+    },
+    "onlyBuiltDependencies": [
+      "better-sqlite3",
+      "esbuild",
+      "keytar"
+    ]
+  }
+}

package/server/dist/client/assets/highlighted-body-OFNGDK62-dz6tQnhA.js

@@ -0,0 +1 @@
+import{r,R as x,L as d,j as f,A as p}from"./index-CdhII6ua.js";var N=({code:i,language:e,raw:a,className:u,startLine:n,lineNumbers:g,...m})=>{let{shikiTheme:l}=r.useContext(x),s=d(),[h,t]=r.useState(a);return r.useEffect(()=>{if(!s){t(a);return}let o=s.highlight({code:i,language:e,themes:l},c=>{t(c)});o&&t(o)},[i,e,l,s,a]),f.jsx(p,{className:u,language:e,lineNumbers:g,result:h,startLine:n,...m})};export{N as HighlightedCodeBlockBody};