@perstack/base 0.0.64 → 0.0.65

package/dist/bin/server.d.ts

@@ -1 +1,3 @@
-export { };
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/bin/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../bin/server.ts"],"names":[],"mappings":""}

package/dist/bin/server.js

@@ -1,21 +1,21 @@
-#!/usr/bin/env node
-import { F as name, I as version, P as description, r as createBaseServer } from "../server-MjrduhwZ.js";
+#!/usr/bin/env bun
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { Command } from "commander";
-
-//#region bin/server.ts
+import packageJson from "../package.json" with { type: "json" };
+import { createBaseServer } from "../src/server.js";
 async function main() {
-	const program = new Command();
-	program.name(name).description(description).version(version, "-v, --version", "display the version number").action(async () => {
-		const server = createBaseServer();
-		const transport = new StdioServerTransport();
-		console.error("Running @perstack/base version", version);
-		await server.connect(transport);
-	});
-	program.parse();
+    const program = new Command();
+    program
+        .name(packageJson.name)
+        .description(packageJson.description)
+        .version(packageJson.version, "-v, --version", "display the version number")
+        .action(async () => {
+        const server = createBaseServer();
+        const transport = new StdioServerTransport();
+        console.error("Running @perstack/base version", packageJson.version);
+        await server.connect(transport);
+    });
+    program.parse();
 }
 main();
-
-//#endregion
-export {  };
 //# sourceMappingURL=server.js.map

package/dist/bin/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":["packageJson.name","packageJson.description","packageJson.version"],"sources":["../../bin/server.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { Command } from \"commander\"\nimport packageJson from \"../package.json\" with { type: \"json\" }\nimport { createBaseServer } from \"../src/server.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    .action(async () => {\n      const server = createBaseServer()\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"],"mappings":";;;;;;AAOA,eAAe,OAAO;CACpB,MAAM,UAAU,IAAI,SAAS;AAC7B,SACG,KAAKA,KAAiB,CACtB,YAAYC,YAAwB,CACpC,QAAQC,SAAqB,iBAAiB,6BAA6B,CAC3E,OAAO,YAAY;EAClB,MAAM,SAAS,kBAAkB;EACjC,MAAM,YAAY,IAAI,sBAAsB;AAC5C,UAAQ,MAAM,kCAAkCA,QAAoB;AACpE,QAAM,OAAO,QAAQ,UAAU;GAC/B;AACJ,SAAQ,OAAO;;AAEjB,MAAM"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../bin/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;IAC7B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;SACtB,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC;SACpC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,4BAA4B,CAAC;SAC3E,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;QACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;QAC5C,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;QACpE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IACJ,OAAO,CAAC,KAAK,EAAE,CAAA;AACjB,CAAC;AACD,IAAI,EAAE,CAAA"}

package/dist/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "@perstack/base",
+    "version": "0.0.65",
+    "description": "Perstack base skills for agents.",
+    "author": "Wintermute Technologies, Inc.",
+    "license": "Apache-2.0",
+    "type": "module",
+    "exports": {
+        ".": "./src/index.ts"
+    },
+    "publishConfig": {
+        "access": "public",
+        "bin": {
+            "@perstack/base": "dist/bin/server.js"
+        },
+        "exports": {
+            ".": "./dist/src/index.js"
+        },
+        "types": {
+            ".": "./dist/src/index.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "clean": "rm -rf dist",
+        "build": "rm -rf dist && tsc -p tsconfig.build.json",
+        "typecheck": "tsc --noEmit",
+        "test": "bun test"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.26.0",
+        "@perstack/core": "workspace:*",
+        "commander": "^14.0.3",
+        "zod": "^4.3.6"
+    },
+    "devDependencies": {
+        "@tsconfig/node22": "^22.0.5",
+        "@types/node": "^25.3.0",
+        "typescript": "^5.9.3"
+    },
+    "engines": {
+        "bun": ">=1.2.0"
+    }
+}

package/dist/src/index.d.ts

@@ -1,199 +1,13 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-
-//#region src/lib/path.d.ts
-declare function validatePath(requestedPath: string): Promise<string>;
-//#endregion
-//#region src/lib/tool-result.d.ts
-declare function successToolResult(result: unknown): CallToolResult;
-declare function errorToolResult(e: Error): CallToolResult;
-//#endregion
-//#region src/tools/skill-management.d.ts
-interface SkillManagementCallbacks {
-  addSkill(input: {
-    name: string;
-    type: "mcpStdioSkill" | "mcpSseSkill";
-    command?: string;
-    packageName?: string;
-    args?: string[];
-    requiredEnv?: string[];
-    endpoint?: string;
-    description?: string;
-    rule?: string;
-    pick?: string[];
-    omit?: string[];
-  }): Promise<{
-    tools: string[];
-  }>;
-  removeSkill(skillName: string): Promise<void>;
-  addDelegate(expertKey: string): Promise<{
-    delegateToolName: string;
-  }>;
-  removeDelegate(expertName: string): Promise<void>;
-  createExpert(input: {
-    key: string;
-    instruction: string;
-    description?: string;
-    version?: string;
-    skills?: Record<string, {
-      type: "mcpStdioSkill" | "mcpSseSkill";
-      command?: string;
-      packageName?: string;
-      args?: string[];
-      requiredEnv?: string[];
-      endpoint?: string;
-      description?: string;
-      rule?: string;
-      pick?: string[];
-      omit?: string[];
-      lazyInit?: boolean;
-    }>;
-    delegates?: string[];
-    tags?: string[];
-    providerTools?: string[];
-  }): Promise<{
-    expertKey: string;
-  }>;
-  addDelegateFromConfig(input: {
-    configPath: string;
-    delegateExpertName: string;
-  }): Promise<{
-    delegateToolName: string;
-  }>;
-}
-declare function registerAddSkill(server: McpServer, callbacks: SkillManagementCallbacks): void;
-declare function registerRemoveSkill(server: McpServer, callbacks: SkillManagementCallbacks): void;
-declare function registerAddDelegate(server: McpServer, callbacks: SkillManagementCallbacks): void;
-declare function registerRemoveDelegate(server: McpServer, callbacks: SkillManagementCallbacks): void;
-declare function registerCreateExpert(server: McpServer, callbacks: SkillManagementCallbacks): void;
-declare function registerAddDelegateFromConfig(server: McpServer, callbacks: SkillManagementCallbacks): void;
-declare function registerSkillManagementTools(server: McpServer, callbacks: SkillManagementCallbacks): void;
-//#endregion
-//#region src/server.d.ts
-/** Base skill name */
-declare const BASE_SKILL_NAME: string;
-/** Base skill version */
-declare const BASE_SKILL_VERSION: string;
-/**
- * Register all base skill tools on an MCP server.
- * This is useful for both standalone and in-process server creation.
- */
-declare function registerAllTools(server: McpServer): void;
-interface CreateBaseServerOptions {
-  skillManagement?: SkillManagementCallbacks;
-}
-/**
- * Create a base skill MCP server with all tools registered.
- * Used by the runtime for in-process execution via InMemoryTransport.
- */
-declare function createBaseServer(options?: CreateBaseServerOptions): McpServer;
-//#endregion
-//#region src/tools/attempt-completion.d.ts
-type AttemptCompletionResult = {
-  remainingTodos: {
-    id: number;
-    title: string;
-    completed: boolean;
-  }[];
-} | Record<string, never>;
-declare function attemptCompletion(): Promise<AttemptCompletionResult>;
-declare function registerAttemptCompletion(server: McpServer): void;
-//#endregion
-//#region src/tools/edit-text-file.d.ts
-declare function editTextFile(input: {
-  path: string;
-  newText: string;
-  oldText: string;
-}): Promise<{
-  path: string;
-  newText: string;
-  oldText: string;
-}>;
-declare function registerEditTextFile(server: McpServer): void;
-//#endregion
-//#region src/tools/exec.d.ts
-type ExecInput = {
-  command: string;
-  args: string[];
-  env: Record<string, string>;
-  cwd: string;
-  stdout: boolean;
-  stderr: boolean;
-  timeout?: number;
-};
-declare function exec(input: ExecInput): Promise<{
-  output: string;
-}>;
-declare function registerExec(server: McpServer): void;
-//#endregion
-//#region src/tools/read-image-file.d.ts
-declare function readImageFile(input: {
-  path: string;
-}): Promise<{
-  path: string;
-  mimeType: string;
-  size: number;
-}>;
-declare function registerReadImageFile(server: McpServer): void;
-//#endregion
-//#region src/tools/read-pdf-file.d.ts
-declare function readPdfFile(input: {
-  path: string;
-}): Promise<{
-  path: string;
-  mimeType: string;
-  size: number;
-}>;
-declare function registerReadPdfFile(server: McpServer): void;
-//#endregion
-//#region src/tools/read-text-file.d.ts
-declare function readTextFile(input: {
-  path: string;
-  from?: number;
-  to?: number;
-}): Promise<{
-  path: string;
-  content: string;
-  from: number;
-  to: number;
-}>;
-declare function registerReadTextFile(server: McpServer): void;
-//#endregion
-//#region src/tools/todo.d.ts
-declare function todo(input: {
-  newTodos?: string[];
-  completedTodos?: number[];
-}): Promise<{
-  todos: {
-    id: number;
-    title: string;
-    completed: boolean;
-  }[];
-}>;
-declare function clearTodo(): Promise<{
-  todos: {
-    id: number;
-    title: string;
-    completed: boolean;
-  }[];
-}>;
-declare function getRemainingTodos(): {
-  id: number;
-  title: string;
-  completed: boolean;
-}[];
-declare function registerTodo(server: McpServer): void;
-declare function registerClearTodo(server: McpServer): void;
-//#endregion
-//#region src/tools/write-text-file.d.ts
-declare function writeTextFile(input: {
-  path: string;
-  text: string;
-}): Promise<{
-  path: string;
-  text: string;
-}>;
-declare function registerWriteTextFile(server: McpServer): void;
-//#endregion
-export { AttemptCompletionResult, BASE_SKILL_NAME, BASE_SKILL_VERSION, type CreateBaseServerOptions, SkillManagementCallbacks, attemptCompletion, clearTodo, createBaseServer, editTextFile, errorToolResult, exec, getRemainingTodos, readImageFile, readPdfFile, readTextFile, registerAddDelegate, registerAddDelegateFromConfig, registerAddSkill, registerAllTools, registerAttemptCompletion, registerClearTodo, registerCreateExpert, registerEditTextFile, registerExec, registerReadImageFile, registerReadPdfFile, registerReadTextFile, registerRemoveDelegate, registerRemoveSkill, registerSkillManagementTools, registerTodo, registerWriteTextFile, successToolResult, todo, validatePath, writeTextFile };
+export { validatePath } from "./lib/path.js";
+export { errorToolResult, successToolResult } from "./lib/tool-result.js";
+export { BASE_SKILL_NAME, BASE_SKILL_VERSION, type CreateBaseServerOptions, createBaseServer, registerAllTools, } from "./server.js";
+export * from "./tools/attempt-completion.js";
+export * from "./tools/edit-text-file.js";
+export * from "./tools/exec.js";
+export * from "./tools/read-image-file.js";
+export * from "./tools/read-pdf-file.js";
+export * from "./tools/read-text-file.js";
+export * from "./tools/skill-management.js";
+export * from "./tools/todo.js";
+export * from "./tools/write-text-file.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA"}

package/dist/src/index.js

@@ -1,3 +1,13 @@
-import { A as registerTodo, C as registerEditTextFile, D as clearTodo, E as registerAttemptCompletion, M as errorToolResult, N as successToolResult, O as getRemainingTodos, S as editTextFile, T as attemptCompletion, _ as registerReadPdfFile, a as registerWriteTextFile, b as exec, c as registerAddDelegateFromConfig, d as registerRemoveDelegate, f as registerRemoveSkill, g as readPdfFile, h as registerReadTextFile, i as registerAllTools, j as todo, k as registerClearTodo, l as registerAddSkill, m as readTextFile, n as BASE_SKILL_VERSION, o as writeTextFile, p as registerSkillManagementTools, r as createBaseServer, s as registerAddDelegate, t as BASE_SKILL_NAME, u as registerCreateExpert, v as readImageFile, w as validatePath, x as registerExec, y as registerReadImageFile } from "../server-MjrduhwZ.js";
-
-export { BASE_SKILL_NAME, BASE_SKILL_VERSION, attemptCompletion, clearTodo, createBaseServer, editTextFile, errorToolResult, exec, getRemainingTodos, readImageFile, readPdfFile, readTextFile, registerAddDelegate, registerAddDelegateFromConfig, registerAddSkill, registerAllTools, registerAttemptCompletion, registerClearTodo, registerCreateExpert, registerEditTextFile, registerExec, registerReadImageFile, registerReadPdfFile, registerReadTextFile, registerRemoveDelegate, registerRemoveSkill, registerSkillManagementTools, registerTodo, registerWriteTextFile, successToolResult, todo, validatePath, writeTextFile };
+export { validatePath } from "./lib/path.js";
+export { errorToolResult, successToolResult } from "./lib/tool-result.js";
+export { BASE_SKILL_NAME, BASE_SKILL_VERSION, createBaseServer, registerAllTools, } from "./server.js";
+export * from "./tools/attempt-completion.js";
+export * from "./tools/edit-text-file.js";
+export * from "./tools/exec.js";
+export * from "./tools/read-image-file.js";
+export * from "./tools/read-pdf-file.js";
+export * from "./tools/read-text-file.js";
+export * from "./tools/skill-management.js";
+export * from "./tools/todo.js";
+export * from "./tools/write-text-file.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EACL,eAAe,EACf,kBAAkB,EAElB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA"}

package/dist/src/lib/mime.d.ts

@@ -0,0 +1,2 @@
+export declare function lookupMimeType(filePath: string): string | undefined;
+//# sourceMappingURL=mime.d.ts.map

package/dist/src/lib/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../../src/lib/mime.ts"],"names":[],"mappings":"AAWA,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE"}

package/dist/src/lib/mime.js

@@ -0,0 +1,13 @@
+import { extname } from "node:path";
+const MIME_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".pdf": "application/pdf",
+};
+export function lookupMimeType(filePath) {
+    return MIME_TYPES[extname(filePath).toLowerCase()];
+}
+//# sourceMappingURL=mime.js.map

package/dist/src/lib/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../../src/lib/mime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,UAAU,GAA2B;IACzC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,iBAAiB;CAC1B,CAAA;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/src/lib/path.d.ts

@@ -0,0 +1,3 @@
+export declare const workspacePath: string;
+export declare function validatePath(requestedPath: string): Promise<string>;
+//# sourceMappingURL=path.d.ts.map

package/dist/src/lib/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/lib/path.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,QAA0C,CAAA;AASpE,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCzE"}

package/dist/src/lib/path.js

@@ -0,0 +1,49 @@
+import { realpathSync } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+export const workspacePath = realpathSync(expandHome(process.cwd()));
+function expandHome(filepath) {
+    if (filepath.startsWith("~/") || filepath === "~") {
+        return path.join(os.homedir(), filepath.slice(1));
+    }
+    return filepath;
+}
+export async function validatePath(requestedPath) {
+    const expandedPath = expandHome(requestedPath);
+    const absolute = path.isAbsolute(expandedPath)
+        ? path.resolve(expandedPath)
+        : path.resolve(process.cwd(), expandedPath);
+    const perstackDir = `${workspacePath}/perstack`.toLowerCase();
+    if (absolute.toLowerCase() === perstackDir ||
+        absolute.toLowerCase().startsWith(`${perstackDir}/`)) {
+        throw new Error("Access denied - perstack directory is not allowed");
+    }
+    try {
+        const realAbsolute = await fs.realpath(absolute);
+        if (!isWithinWorkspace(realAbsolute)) {
+            throw new Error("Access denied - symlink target outside allowed directories");
+        }
+        return realAbsolute;
+    }
+    catch (_error) {
+        const parentDir = path.dirname(absolute);
+        try {
+            const realParentPath = await fs.realpath(parentDir);
+            if (!isWithinWorkspace(realParentPath)) {
+                throw new Error("Access denied - parent directory outside allowed directories");
+            }
+            return absolute;
+        }
+        catch {
+            if (!isWithinWorkspace(absolute)) {
+                throw new Error(`Access denied - path outside allowed directories: ${absolute} not in ${workspacePath}`);
+            }
+            throw new Error(`Parent directory does not exist: ${parentDir}`);
+        }
+    }
+}
+function isWithinWorkspace(absolutePath) {
+    return absolutePath === workspacePath || absolutePath.startsWith(`${workspacePath}/`);
+}
+//# sourceMappingURL=path.js.map

package/dist/src/lib/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/lib/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AAEpE,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,aAAqB;IACtD,MAAM,YAAY,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAA;IAC7C,MAAM,WAAW,GAAG,GAAG,aAAa,WAAW,CAAC,WAAW,EAAE,CAAA;IAC7D,IACE,QAAQ,CAAC,WAAW,EAAE,KAAK,WAAW;QACtC,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,CAAC,EACpD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChD,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,YAAY,CAAA;IACrB,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;YACnD,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;YACjF,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,qDAAqD,QAAQ,WAAW,aAAa,EAAE,CACxF,CAAA;YACH,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,YAAoB;IAC7C,OAAO,YAAY,KAAK,aAAa,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,aAAa,GAAG,CAAC,CAAA;AACvF,CAAC"}

package/dist/src/lib/safe-file.d.ts

@@ -0,0 +1,4 @@
+export declare function isSymlinkProtectionFullySupported(): boolean;
+export declare function safeWriteFile(path: string, data: string): Promise<void>;
+export declare function safeReadFile(path: string): Promise<string>;
+//# sourceMappingURL=safe-file.d.ts.map

package/dist/src/lib/safe-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-file.d.ts","sourceRoot":"","sources":["../../../src/lib/safe-file.ts"],"names":[],"mappings":"AAaA,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU7E;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhE"}

package/dist/src/lib/safe-file.js

@@ -0,0 +1,38 @@
+import { constants, lstat, open } from "node:fs/promises";
+const O_NOFOLLOW = constants.O_NOFOLLOW ?? 0;
+const O_NOFOLLOW_SUPPORTED = typeof constants.O_NOFOLLOW === "number";
+async function checkNotSymlink(path) {
+    const stats = await lstat(path).catch(() => null);
+    if (stats?.isSymbolicLink()) {
+        throw new Error("Operation denied: target is a symbolic link");
+    }
+}
+export function isSymlinkProtectionFullySupported() {
+    return O_NOFOLLOW_SUPPORTED;
+}
+export async function safeWriteFile(path, data) {
+    let handle;
+    try {
+        await checkNotSymlink(path);
+        const flags = constants.O_WRONLY | constants.O_CREAT | constants.O_TRUNC | O_NOFOLLOW;
+        handle = await open(path, flags, 0o644);
+        await handle.writeFile(data, "utf-8");
+    }
+    finally {
+        await handle?.close();
+    }
+}
+export async function safeReadFile(path) {
+    let handle;
+    try {
+        await checkNotSymlink(path);
+        const flags = constants.O_RDONLY | O_NOFOLLOW;
+        handle = await open(path, flags);
+        const buffer = await handle.readFile("utf-8");
+        return buffer;
+    }
+    finally {
+        await handle?.close();
+    }
+}
+//# sourceMappingURL=safe-file.js.map

package/dist/src/lib/safe-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-file.js","sourceRoot":"","sources":["../../../src/lib/safe-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,IAAI,CAAC,CAAA;AAC5C,MAAM,oBAAoB,GAAG,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ,CAAA;AAErE,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACjD,IAAI,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO,oBAAoB,CAAA;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IAC5D,IAAI,MAA8B,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,IAAI,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,GAAG,UAAU,CAAA;QACrF,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,MAA8B,CAAA;IAClC,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,IAAI,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,GAAG,UAAU,CAAA;QAC7C,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC7C,OAAO,MAAM,CAAA;IACf,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC"}

package/dist/src/lib/tool-result.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function successToolResult(result: unknown): CallToolResult;
+export declare function errorToolResult(e: Error): CallToolResult;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/src/lib/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../../src/lib/tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAExE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAEjE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,cAAc,CAIxD"}

package/dist/src/lib/tool-result.js

@@ -0,0 +1,9 @@
+export function successToolResult(result) {
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+}
+export function errorToolResult(e) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: e.name, message: e.message }) }],
+    };
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/src/lib/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../../src/lib/tool-result.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAQ;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;KACzF,CAAA;AACH,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillManagementCallbacks } from "./tools/skill-management.js";
+/** Base skill name */
+export declare const BASE_SKILL_NAME: string;
+/** Base skill version */
+export declare const BASE_SKILL_VERSION: string;
+/**
+ * Register all base skill tools on an MCP server.
+ * This is useful for both standalone and in-process server creation.
+ */
+export declare function registerAllTools(server: McpServer): void;
+export interface CreateBaseServerOptions {
+    skillManagement?: SkillManagementCallbacks;
+}
+/**
+ * Create a base skill MCP server with all tools registered.
+ * Used by the runtime for in-process execution via InMemoryTransport.
+ */
+export declare function createBaseServer(options?: CreateBaseServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAQnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAK3E,sBAAsB;AACtB,eAAO,MAAM,eAAe,QAAmB,CAAA;AAE/C,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,QAAsB,CAAA;AAErD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAUxD;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,wBAAwB,CAAA;CAC3C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAiB7E"}

package/dist/src/server.js

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import packageJson from "../package.json" with { type: "json" };
+import { registerAttemptCompletion } from "./tools/attempt-completion.js";
+import { registerEditTextFile } from "./tools/edit-text-file.js";
+import { registerExec } from "./tools/exec.js";
+import { registerReadImageFile } from "./tools/read-image-file.js";
+import { registerReadPdfFile } from "./tools/read-pdf-file.js";
+import { registerReadTextFile } from "./tools/read-text-file.js";
+import { registerSkillManagementTools } from "./tools/skill-management.js";
+import { registerClearTodo, registerTodo } from "./tools/todo.js";
+import { registerWriteTextFile } from "./tools/write-text-file.js";
+/** Base skill name */
+export const BASE_SKILL_NAME = packageJson.name;
+/** Base skill version */
+export const BASE_SKILL_VERSION = packageJson.version;
+/**
+ * Register all base skill tools on an MCP server.
+ * This is useful for both standalone and in-process server creation.
+ */
+export function registerAllTools(server) {
+    registerAttemptCompletion(server);
+    registerTodo(server);
+    registerClearTodo(server);
+    registerExec(server);
+    registerReadTextFile(server);
+    registerReadImageFile(server);
+    registerReadPdfFile(server);
+    registerWriteTextFile(server);
+    registerEditTextFile(server);
+}
+/**
+ * Create a base skill MCP server with all tools registered.
+ * Used by the runtime for in-process execution via InMemoryTransport.
+ */
+export function createBaseServer(options) {
+    const server = new McpServer({
+        name: BASE_SKILL_NAME,
+        version: BASE_SKILL_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    registerAllTools(server);
+    if (options?.skillManagement) {
+        registerSkillManagementTools(server, options.skillManagement);
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,sBAAsB;AACtB,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAA;AAE/C,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,YAAY,CAAC,MAAM,CAAC,CAAA;IACpB,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACzB,YAAY,CAAC,MAAM,CAAC,CAAA;IACpB,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC3B,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiC;IAChE,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,kBAAkB;KAC5B,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAA;IACD,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxB,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;QAC7B,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/src/tools/attempt-completion.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export type AttemptCompletionResult = {
+    remainingTodos: {
+        id: number;
+        title: string;
+        completed: boolean;
+    }[];
+} | Record<string, never>;
+export declare function attemptCompletion(): Promise<AttemptCompletionResult>;
+export declare function registerAttemptCompletion(server: McpServer): void;
+//# sourceMappingURL=attempt-completion.d.ts.map

package/dist/src/tools/attempt-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-completion.d.ts","sourceRoot":"","sources":["../../../src/tools/attempt-completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAKxE,MAAM,MAAM,uBAAuB,GAC/B;IAAE,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAAE,GACvE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAEzB,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAM1E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,QAkB1D"}

package/dist/src/tools/attempt-completion.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { errorToolResult, successToolResult } from "../lib/tool-result.js";
+import { getRemainingTodos } from "./todo.js";
+export async function attemptCompletion() {
+    const remainingTodos = getRemainingTodos();
+    if (remainingTodos.length > 0) {
+        return { remainingTodos };
+    }
+    return {};
+}
+export function registerAttemptCompletion(server) {
+    server.registerTool("attemptCompletion", {
+        title: "Attempt completion",
+        description: "Signal task completion. Provide a result parameter with your final response text. Validates all todos are complete before ending.",
+        inputSchema: z.object({ result: z.string().optional() }).strict(),
+    }, async () => {
+        try {
+            return successToolResult(await attemptCompletion());
+        }
+        catch (e) {
+            if (e instanceof Error)
+                return errorToolResult(e);
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=attempt-completion.js.map

package/dist/src/tools/attempt-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-completion.js","sourceRoot":"","sources":["../../../src/tools/attempt-completion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAM7C,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAC1C,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,cAAc,EAAE,CAAA;IAC3B,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,mIAAmI;QACrI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KAClE,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,OAAO,iBAAiB,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAA;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,KAAK;gBAAE,OAAO,eAAe,CAAC,CAAC,CAAC,CAAA;YACjD,MAAM,CAAC,CAAA;QACT,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC"}