@docsagent/docsagent 1.0.0

package/README.md

@@ -0,0 +1,133 @@
+# DocsAgent 🛡️
+
+**The High-Performance Local Intelligence Layer for AI Agents.**
+
+DocsAgent is a professional, local-first document intelligence engine and MCP (Model Context Protocol) server. It provides a secure, near-instant bridge between your private local files and advanced agentic platforms like **OpenClaw**, **Claude Code**, and **Cursor**.
+
+**100% Local. 100% Private. Zero Data Leakage.**
+
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+[![OS: macOS / Windows / Linux](https://img.shields.io/badge/OS-macOS%20|%20Windows%20|%20Linux-black.svg)](#)
+
+---
+
+### 🔥 Why DocsAgent?
+
+Modern AI Agents are incredibly smart, but they are "blind" to your private desktop documents. DocsAgent acts as a **High-Performance Intelligence Engine** that indexes your local data, allowing agents to search, read, and analyze thousands of files (1,000+) with absolute privacy.
+
+*   **🔒 Absolute Privacy:** All document parsing, indexing, and vector storage happen strictly on your own hardware. Your data never leaves your machine.
+*   **⚡ High-Performance Core:** Powered by a native C++ engine. Experience millisecond-level retrieval even across massive document libraries.
+*   **🔌 MCP Native:** Built-in support for the **Model Context Protocol (MCP)**, making it instantly compatible with the latest AI tools.
+*   **📂 Format Mastery:** Native parsing for PDF, Word (.docx), Excel (.xlsx), PPTX, Markdown, and TXT.
+*   **🤖 Local LLM Ready:** Works seamlessly with Claude 3.5/GPT-4o or run completely air-gapped with local models via Ollama.
+
+---
+
+### 🚀 Quick Start
+
+#### 1. Install via NPM
+```bash
+npm install -g @docsagent/docsagent
+```
+
+#### 2. CLI Usage (Local Indexing & Search)
+DocsAgent provides a powerful CLI for managing your local knowledge base.
+
+*   **Index your folders:**
+    ```bash
+    # Add one or more directories or files to the index
+    docsagent add ~/Documents/Legal_Archive ~/Documents/Research
+    ```
+*   **Search your documents:**
+    ```bash
+    # Perform a semantic search directly from the terminal
+    docsagent search "What are the key terms in the Barclays contract?"
+    ```
+
+#### 3. MCP Usage (Connect to AI Agents)
+DocsAgent is a native **Model Context Protocol (MCP)** server. This allows AI agents to "see" your local documents.
+
+**Start the MCP server:**
+```bash
+docsagent server
+```
+
+---
+
+### 🔌 Agent Integration Examples
+
+Connect DocsAgent to your favorite tools using the following configurations:
+
+#### **OpenClaw (Recommended)**
+OpenClaw is the most powerful UI for local-first agents. Add DocsAgent in your `config.yaml`:
+```yaml
+mcpServers:
+  docsagent:
+    command: "docsagent"
+    args: ["server"]
+```
+
+#### **Claude Code**
+Integrate with Anthropic's CLI tool:
+```bash
+claude code mcp add docsagent -- docsagent server
+```
+
+#### **Cursor / Windsurf**
+1. Open **Settings** > **Features** > **MCP Servers**.
+2. Click **+ Add New MCP Server**.
+3. Name: `DocsAgent`
+4. Type: `command`
+5. Command: `docsagent server`
+
+---
+
+### 🛠️ Agent Tools (via MCP)
+
+Once integrated, your AI agent gains professional-grade document capabilities through these tools:
+
+- **`search`**: Perform deep semantic search across your entire local library to find relevant snippets.
+- **`add_docs`**: Instantly index new local folders or files during a conversation.
+- *(More tools coming soon: `list_documents`, `remove_document`, `status`)*
+
+---
+
+### 💻 CLI Reference
+
+DocsAgent provides a powerful CLI with convenient aliases (`dag`, `da`):
+
+| Command | Alias Example | Description |
+| :--- | :--- | :--- |
+| `server` | `da server` | Start the MCP server service |
+| `add` | `dag add <path>` | Add directories or files to the index |
+| `search` | `da search "query"`| Search for documents directly from CLI |
+| `status`| `dag status` | Check engine and indexing status |
+| `stop`  | `da stop` | Stop the background engine service |
+
+---
+
+### 📂 Support Matrix
+
+| Format | Status | Features |
+| :--- | :--- | :--- |
+| **PDF** | ✅ Full | Deep layout analysis & high-speed parsing |
+| **Word (.docx)** | ✅ Full | Table extraction & heading hierarchy preserved |
+| **PPTX** | ✅ Full | Extracts slides, shapes, and speaker notes |
+
+---
+
+### 🤝 Community & Contributing
+
+We are building the open standard for Local RAG. Join us in making AI respect personal data sovereignty!
+
+- **GitHub Issues:** Found a bug? Have a feature request? Open an issue.
+- **Star the Repo:** If DocsAgent improved your workflow, please give us a ⭐ to help others find the project!
+
+---
+
+### ⚖️ License
+
+DocsAgent is open-source under the **Apache-2.0 License**.
+
+---
+**Desktop Sovereignty is here. Empower your Agents with DocsAgent.**

package/dist/chunk-D7PCT4W2.mjs

@@ -0,0 +1,4 @@
+import{spawn as g}from"child_process";import n from"path";import{fileURLToPath as m}from"url";var d=m(import.meta.url),y=n.dirname(d),c=()=>{let a=process.platform,e=process.arch,t="";return a==="darwin"?e==="arm64"?t="docsagent-aarch64-apple-darwin":e==="x64"?t="docsagent-x86_64-apple-darwin":t="docsagent-universal-apple-darwin":a==="win32"?t="docsagent-x86_64-pc-windows-msvc.exe":a==="linux"&&(t="docsagent-universal-apple-darwin"),n.join(y,"../bin",t)};import{McpServer as f}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as w}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as l}from"zod";var P=18688,h=class{process=null;binaryPath;port;baseUrl;initialPath;readyPromise;constructor(e,t=P){this.binaryPath=c(),this.initialPath=e,this.port=t,this.baseUrl=`http://localhost:${this.port}`,this.readyPromise=this.startEngine()}async startEngine(){try{let t=new AbortController,s=setTimeout(()=>t.abort(),200),i=await fetch(`${this.baseUrl}/status`,{signal:t.signal});if(clearTimeout(s),i.ok)return}catch{}let e=["--port",this.port.toString()];if(this.initialPath){let t=Array.isArray(this.initialPath)?this.initialPath.join(" "):this.initialPath;e.push("--source",t)}return new Promise((t,s)=>{this.process=g(this.binaryPath,e,{stdio:"ignore",detached:!0}),this.process.unref(),this.process.on("error",r=>{this.process=null,s(r)}),this.process.on("exit",r=>{r!==0&&this.process&&console.error(`DocsAgent engine exited with code ${r}`),this.process=null});let i=0,o=async()=>{try{let r=new AbortController,p=setTimeout(()=>r.abort(),100),u=await fetch(`${this.baseUrl}/status`,{signal:r.signal});if(clearTimeout(p),u.ok)t();else throw new Error}catch{i++,i>50?s(new Error(`Timeout waiting for DocsAgent service to start on port ${this.port}`)):setTimeout(o,100)}};setTimeout(o,50)})}async request(e,t,s){await this.readyPromise;let i=`${this.baseUrl}${e}`;try{let o=await fetch(i,{method:t,headers:s?{"Content-Type":"application/json"}:void 0,body:s?JSON.stringify(s):void 0});if(!o.ok)throw new Error(`HTTP error! status: ${o.status}`);return await o.json()}catch(o){throw new Error(`Failed to communicate with DocsAgent service: ${o.message}`)}}async add(e){let t=Array.isArray(e)?e:[e];await this.request("/add","POST",{source:t})}async search(e){let t=await this.request("/search","POST",{query:e});return t&&t.code===200&&Array.isArray(t.result_items)?t.result_items:[]}async status(){return await this.request("/status","GET")}async list(){let e=await this.request("/list","GET");return Array.isArray(e)?e:[]}async remove(e){await this.request("/remove","POST",{path:e})}async close(){try{await this.request("/close","POST")}catch{this.process&&(this.process.kill(),this.process=null)}}async startMcpServer(){await this.readyPromise;let e=new f({name:"DocsAgent",version:"1.0.0"});e.tool("search",{query:l.string().describe("The search query for local documents")},async({query:s})=>{try{let i=await this.search(s);return i.length===0?{content:[{type:"text",text:"No results found."}]}:{content:[{type:"text",text:i.map(r=>`[Score: ${r.score.toFixed(2)}]${r.path?` ${r.path}`:""}${r.page?` (P${r.page})`:""}
+Context: ${r.context}`).join(`
+
+`)}]}}catch(i){return{content:[{type:"text",text:i.message}],isError:!0}}}),e.tool("add_docs",{dir:l.string().describe("The directory or file path to add")},async({dir:s})=>{try{return await this.add(s),{content:[{type:"text",text:`Added ${s}`}]}}catch(i){return{content:[{type:"text",text:i.message}],isError:!0}}});let t=new w;await e.connect(t)}};export{h as a};

package/dist/cli.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import{a as f}from"./chunk-D7PCT4W2.mjs";import l from"path";var a=process.argv.slice(2),n=18688,r=a.findIndex(o=>o==="--port"||o==="-p");r!==-1&&a[r+1]&&(n=parseInt(a[r+1]),a.splice(r,2));var m=a[0],t=a.slice(1),x=async()=>{let o;m==="server"&&(o=(t.length>0?t:["."]).map(c=>l.resolve(c)));let s=new f(o,n);switch(m){case"server":let i=o?o.join(", "):".";console.log(`Starting DocsAgent MCP Server on port ${n} (indexing: ${i})...`),await s.startMcpServer();break;case"add":t.length===0&&(console.error("Please specify at least one directory or file to add."),process.exit(1));let c=t.map(e=>l.resolve(e));await s.add(c),console.log(`Added ${c.join(", ")} to DocsAgent.`);break;case"search":let d=t.join(" ");d||(console.error("Please specify a search query."),process.exit(1));let p=await s.search(d);p.length===0?console.log("No results found."):p.forEach((e,v)=>{console.log(`${v+1}. [Score: ${e.score.toFixed(2)}]${e.path?` ${e.path}`:""}${e.page?` (Page ${e.page})`:""}`),console.log(`   Context: ${e.context}`),console.log("---")});break;case"status":let u=await s.status();console.log(JSON.stringify(u,null,2));break;case"list":let g=await s.list();g.length===0?console.log("No documents indexed."):g.forEach(e=>console.log(`- ${e}`));break;case"remove":t[0]||(console.error("Please specify a path to remove."),process.exit(1));let h=l.resolve(t[0]);await s.remove(h),console.log(`Removed ${h} from DocsAgent.`);break;case"stop":case"close":console.log(`Stopping DocsAgent service on port ${n}...`),await s.close(),console.log("Service stopped.");break;default:console.log(`
+DocsAgent CLI (Aliases: dag, da)
+
+Usage:
+  docsagent server [paths...] [--port <n>] Start persistent service (MCP)
+  docsagent search <q> [paths...] [--port <n>] Search for documents
+  docsagent add <paths...> [--port <n>]    Add directories or files to DocsAgent
+  docsagent status [--port <n>]            Check engine status
+  docsagent list [--port <n>]              List all indexed documents
+  docsagent remove <path> [--port <n>]     Remove a document/folder from index
+  docsagent stop [--port <n>]              Stop the background service
+
+Examples:
+  docsagent search "Barclays case"  (Formal)
+  dag search "Barclays case"        (Geeky)
+  da status                         (Short)
+
+Options:
+  -p, --port <n>  Port for the local service (default: 18688)
+      `);break}};x().catch(o=>{console.error("Error:",o.message),process.exit(1)});process.on("SIGINT",()=>{process.exit(0)});

package/dist/index.mjs

@@ -0,0 +1 @@
+import{a}from"./chunk-D7PCT4W2.mjs";export{a as DocsAgent};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@docsagent/docsagent",
+  "version": "1.0.0",
+  "description": "Private Local Documents Search Assistant",
+  "main": "dist/index.mjs",
+  "bin": {
+    "docsagent": "./dist/cli.mjs",
+    "dag": "./dist/cli.mjs",
+    "da": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format esm --tsconfig tsconfig.json --clean --minify",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "zod": "^3.22.4"
+  },
+  "keywords": [
+    "private",
+    "personal",
+    "local",
+    "documents",
+    "search"
+  ],
+  "author": "Vincent",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/docsagent/docsagent",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/docsagent/docsagent.git"
+  }
+}