@perstack/base 0.0.21 → 0.0.23

package/README.md

@@ -0,0 +1,61 @@
+# @perstack/base
+
+Base skills (MCP tools) for Perstack agents.
+
+## Installation
+
+```bash
+npm install @perstack/base
+```
+
+## Usage
+
+### As MCP Server
+
+Run directly via npx:
+
+```bash
+npx @perstack/base
+```
+
+### As Library
+
+Import and register tools with your MCP server:
+
+```typescript
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
+import { registerReadTextFile, registerWriteTextFile } from "@perstack/base"
+
+const server = new McpServer({ name: "my-server", version: "1.0.0" })
+
+registerReadTextFile(server)
+registerWriteTextFile(server)
+```
+
+## Available Tools
+
+### File Operations
+- `readTextFile` - Read text files with optional line range
+- `writeTextFile` - Create or overwrite text files
+- `appendTextFile` - Append content to existing files
+- `editTextFile` - Replace text in existing files
+- `deleteFile` - Remove files
+- `moveFile` - Move or rename files
+- `getFileInfo` - Get file metadata
+- `readImageFile` - Read image files (PNG, JPEG, GIF, WebP)
+- `readPdfFile` - Read PDF files
+
+### Directory Operations
+- `listDirectory` - List directory contents
+- `createDirectory` - Create directories
+- `deleteDirectory` - Remove directories
+
+### Utilities
+- `exec` - Execute system commands
+- `think` - Sequential thinking for problem analysis
+- `todo` - Task list management
+- `attemptCompletion` - Signal task completion
+
+## License
+
+Apache-2.0

package/dist/bin/server.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/server.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { registerAttemptCompletion, registerThink, registerTodo, registerClearTodo, registerExec, registerGetFileInfo, registerReadTextFile, registerReadImageFile, registerReadPdfFile, registerWriteTextFile, registerAppendTextFile, registerEditTextFile, registerMoveFile, registerDeleteFile, registerListDirectory, registerCreateDirectory, registerDeleteDirectory } from '../chunk-H76GGP62.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Command } from 'commander';
+
+// package.json
+var package_default = {
+  name: "@perstack/base",
+  version: "0.0.23",
+  description: "Perstack base skills for agents."};
+
+// bin/server.ts
+async function main() {
+  const program = new Command();
+  program.name(package_default.name).description(package_default.description).version(package_default.version, "-v, --version", "display the version number").option("--verbose", "verbose output").action(async () => {
+    const server = new McpServer(
+      {
+        name: package_default.name,
+        version: package_default.version
+      },
+      {
+        capabilities: {
+          tools: {}
+        }
+      }
+    );
+    registerAttemptCompletion(server);
+    registerThink(server);
+    registerTodo(server);
+    registerClearTodo(server);
+    registerExec(server);
+    registerGetFileInfo(server);
+    registerReadTextFile(server);
+    registerReadImageFile(server);
+    registerReadPdfFile(server);
+    registerWriteTextFile(server);
+    registerAppendTextFile(server);
+    registerEditTextFile(server);
+    registerMoveFile(server);
+    registerDeleteFile(server);
+    registerListDirectory(server);
+    registerCreateDirectory(server);
+    registerDeleteDirectory(server);
+    const transport = new StdioServerTransport();
+    console.error("Running @perstack/base version", package_default.version);
+    await server.connect(transport);
+  });
+  program.parse();
+}
+main();
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/bin/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../package.json","../../bin/server.ts"],"names":[],"mappings":";;;;;;;AAAA,IAAA,eAAA,GAAA;AAAA,EACE,IAAA,EAAQ,gBAAA;AAAA,EACR,OAAA,EAAW,QAAA;AAAA,EACX,WAAA,EAAe,kCA6CjB,CAAA;;;ACzBA,eAAe,IAAA,GAAO;AACpB,EAAA,MAAM,OAAA,GAAU,IAAI,OAAA,EAAQ;AAC5B,EAAA,OAAA,CACG,KAAK,eAAA,CAAY,IAAI,EACrB,WAAA,CAAY,eAAA,CAAY,WAAW,CAAA,CACnC,OAAA,CAAQ,gBAAY,OAAA,EAAS,eAAA,EAAiB,4BAA4B,CAAA,CAC1E,MAAA,CAAO,aAAa,gBAAgB,CAAA,CACpC,OAAO,YAAY;AAClB,IAAA,MAAM,SAAS,IAAI,SAAA;AAAA,MACjB;AAAA,QACE,MAAM,eAAA,CAAY,IAAA;AAAA,QAClB,SAAS,eAAA,CAAY;AAAA,OACvB;AAAA,MACA;AAAA,QACE,YAAA,EAAc;AAAA,UACZ,OAAO;AAAC;AACV;AACF,KACF;AACA,IAAA,yBAAA,CAA0B,MAAM,CAAA;AAChC,IAAA,aAAA,CAAc,MAAM,CAAA;AACpB,IAAA,YAAA,CAAa,MAAM,CAAA;AACnB,IAAA,iBAAA,CAAkB,MAAM,CAAA;AACxB,IAAA,YAAA,CAAa,MAAM,CAAA;AACnB,IAAA,mBAAA,CAAoB,MAAM,CAAA;AAC1B,IAAA,oBAAA,CAAqB,MAAM,CAAA;AAC3B,IAAA,qBAAA,CAAsB,MAAM,CAAA;AAC5B,IAAA,mBAAA,CAAoB,MAAM,CAAA;AAC1B,IAAA,qBAAA,CAAsB,MAAM,CAAA;AAC5B,IAAA,sBAAA,CAAuB,MAAM,CAAA;AAC7B,IAAA,oBAAA,CAAqB,MAAM,CAAA;AAC3B,IAAA,gBAAA,CAAiB,MAAM,CAAA;AACvB,IAAA,kBAAA,CAAmB,MAAM,CAAA;AACzB,IAAA,qBAAA,CAAsB,MAAM,CAAA;AAC5B,IAAA,uBAAA,CAAwB,MAAM,CAAA;AAC9B,IAAA,uBAAA,CAAwB,MAAM,CAAA;AAC9B,IAAA,MAAM,SAAA,GAAY,IAAI,oBAAA,EAAqB;AAC3C,IAAA,OAAA,CAAQ,KAAA,CAAM,gCAAA,EAAkC,eAAA,CAAY,OAAO,CAAA;AACnE,IAAA,MAAM,MAAA,CAAO,QAAQ,SAAS,CAAA;AAAA,EAChC,CAAC,CAAA;AACH,EAAA,OAAA,CAAQ,KAAA,EAAM;AAChB;AACA,IAAA,EAAK","file":"server.js","sourcesContent":["{\n  \"name\": \"@perstack/base\",\n  \"version\": \"0.0.23\",\n  \"description\": \"Perstack base skills for agents.\",\n  \"author\": \"Wintermute Technologies, Inc.\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": \"./src/index.ts\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"bin\": {\n      \"@perstack/base\": \"dist/bin/server.js\"\n    },\n    \"exports\": {\n      \".\": \"./dist/src/index.js\"\n    },\n    \"types\": {\n      \".\": \"./dist/src/index.d.ts\"\n    }\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"clean\": \"rm -rf dist\",\n    \"build\": \"pnpm run clean && tsup\",\n    \"typecheck\": \"tsc --noEmit\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.23.0\",\n    \"commander\": \"^14.0.2\",\n    \"mime-types\": \"^3.0.2\",\n    \"ts-dedent\": \"^2.2.0\",\n    \"zod\": \"^4.1.13\"\n  },\n  \"devDependencies\": {\n    \"@tsconfig/node22\": \"^22.0.5\",\n    \"@types/mime-types\": \"^3.0.1\",\n    \"@types/node\": \"^24.10.1\",\n    \"tsup\": \"^8.5.1\",\n    \"typescript\": \"^5.9.3\",\n    \"vitest\": \"^4.0.14\"\n  },\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  }\n}\n","#!/usr/bin/env node\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { Command } from \"commander\"\nimport packageJson from \"../package.json\" with { type: \"json\" }\nimport { registerAppendTextFile } from \"../src/tools/append-text-file.js\"\nimport { registerAttemptCompletion } from \"../src/tools/attempt-completion.js\"\nimport { registerCreateDirectory } from \"../src/tools/create-directory.js\"\nimport { registerDeleteDirectory } from \"../src/tools/delete-directory.js\"\nimport { registerDeleteFile } from \"../src/tools/delete-file.js\"\nimport { registerEditTextFile } from \"../src/tools/edit-text-file.js\"\nimport { registerExec } from \"../src/tools/exec.js\"\nimport { registerGetFileInfo } from \"../src/tools/get-file-info.js\"\nimport { registerListDirectory } from \"../src/tools/list-directory.js\"\nimport { registerMoveFile } from \"../src/tools/move-file.js\"\nimport { registerReadImageFile } from \"../src/tools/read-image-file.js\"\nimport { registerReadPdfFile } from \"../src/tools/read-pdf-file.js\"\nimport { registerReadTextFile } from \"../src/tools/read-text-file.js\"\nimport { registerThink } from \"../src/tools/think.js\"\nimport { registerClearTodo, registerTodo } from \"../src/tools/todo.js\"\nimport { registerWriteTextFile } from \"../src/tools/write-text-file.js\"\n\nasync function main() {\n  const program = new Command()\n  program\n    .name(packageJson.name)\n    .description(packageJson.description)\n    .version(packageJson.version, \"-v, --version\", \"display the version number\")\n    .option(\"--verbose\", \"verbose output\")\n    .action(async () => {\n      const server = new McpServer(\n        {\n          name: packageJson.name,\n          version: packageJson.version,\n        },\n        {\n          capabilities: {\n            tools: {},\n          },\n        },\n      )\n      registerAttemptCompletion(server)\n      registerThink(server)\n      registerTodo(server)\n      registerClearTodo(server)\n      registerExec(server)\n      registerGetFileInfo(server)\n      registerReadTextFile(server)\n      registerReadImageFile(server)\n      registerReadPdfFile(server)\n      registerWriteTextFile(server)\n      registerAppendTextFile(server)\n      registerEditTextFile(server)\n      registerMoveFile(server)\n      registerDeleteFile(server)\n      registerListDirectory(server)\n      registerCreateDirectory(server)\n      registerDeleteDirectory(server)\n      const transport = new StdioServerTransport()\n      console.error(\"Running @perstack/base version\", packageJson.version)\n      await server.connect(transport)\n    })\n  program.parse()\n}\nmain()\n"]}