@mcphero/core 1.1.6

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+
+
+> @mcphero/core@1.1.6 build /Users/atomic/projects/ai/mcphero/packages/core
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/atomic/projects/ai/mcphero/packages/core/tsup.config.ts
+CLI Target: node18
+CLI Cleaning output folder
+ESM Build start
+ESM build/index.js     2.88 KB
+ESM build/index.js.map 7.15 KB
+ESM ⚡️ Build success in 6ms
+DTS Build start
+DTS ⚡️ Build success in 590ms
+DTS build/index.d.ts 2.50 KB

package/.turbo/turbo-check.log

@@ -0,0 +1,17 @@
+
+> @mcphero/core@1.1.6 check /Users/atomic/projects/ai/mcphero/packages/core
+> pnpm lint && pnpm typecheck
+
+
+> @mcphero/core@1.1.6 lint /Users/atomic/projects/ai/mcphero/packages/core
+> eslint
+
+
+/Users/atomic/projects/ai/mcphero/packages/core/src/index.ts
+  8:1  error  Too many blank lines at the end of file. Max of 0 allowed  @stylistic/no-multiple-empty-lines
+
+✖ 1 problem (1 error, 0 warnings)
+  1 error and 0 warnings potentially fixable with the `--fix` option.
+
+ ELIFECYCLE  Command failed with exit code 1.
+ ELIFECYCLE  Command failed with exit code 1.

package/.turbo/turbo-lint.log

@@ -0,0 +1,5 @@
+
+
+> @mcphero/core@1.1.6 lint /Users/atomic/projects/ai/mcphero/packages/core
+> eslint
+

package/.turbo/turbo-prepack.log

@@ -0,0 +1,26 @@
+
+
+> @mcphero/core@1.1.6 prepack /Users/atomic/projects/ai/mcphero/packages/core
+> pnpm clean && pnpm build
+
+
+> @mcphero/core@1.1.6 clean /Users/atomic/projects/ai/mcphero/packages/core
+> rimraf build
+
+
+> @mcphero/core@1.1.6 build /Users/atomic/projects/ai/mcphero/packages/core
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/atomic/projects/ai/mcphero/packages/core/tsup.config.ts
+CLI Target: node18
+CLI Cleaning output folder
+ESM Build start
+ESM build/index.js     2.88 KB
+ESM build/index.js.map 7.15 KB
+ESM ⚡️ Build success in 6ms
+DTS Build start
+DTS ⚡️ Build success in 614ms
+DTS build/index.d.ts 2.50 KB

package/build/index.d.ts

@@ -0,0 +1,70 @@
+import z, { z as z$1 } from 'zod';
+import { TextContent } from '@modelcontextprotocol/sdk/types.js';
+
+interface MCPHeroContext {
+    keys: () => string[];
+    has: (key: string) => boolean;
+    get: <T>(key: string) => T;
+    set: <T>(key: string, value: T) => void;
+    fork: (store?: Record<string, unknown>) => MCPHeroContext;
+}
+declare function createContext(store?: Record<string, unknown>): MCPHeroContext;
+
+interface Action<I extends object = any, O extends object = any> {
+    name: string;
+    description: string;
+    input: z.ZodType<I> & {
+        shape: Record<string, z.ZodTypeAny>;
+    };
+    args?: (keyof I)[];
+    isEnabled?: (context: MCPHeroContext) => boolean;
+    run: (input: I, context: MCPHeroContext) => Promise<O>;
+}
+declare function createAction<I extends object = object, O extends object = object>(action: Action<I, O>): Action<I, O>;
+
+interface Adapter {
+    context: MCPHeroContext;
+    start(actions: Action[]): Promise<void>;
+    stop(): Promise<void>;
+}
+type AdapterGenerator = (options: MCPHeroOptions, baseContext: MCPHeroContext) => Adapter;
+type AdapterFactory<T = void> = (options: T) => AdapterGenerator;
+
+interface MCPHeroOptions {
+    name: string;
+    description: string;
+    version: string;
+}
+interface MCPHero {
+    set: <T>(key: string, value: T) => MCPHero;
+    adapter: (generator: AdapterGenerator) => MCPHero;
+    action: (action: Action) => MCPHero;
+    actions: (actions: Action[]) => MCPHero;
+    start: () => Promise<MCPHero>;
+}
+declare function mcphero(options: MCPHeroOptions): MCPHero;
+
+interface ToolResponse {
+    content: TextContent[];
+    [x: string]: unknown;
+}
+declare function toolResponse(data: object): ToolResponse;
+declare function parseToolResponse<T = unknown>(result: ToolResponse): T;
+
+interface SideloadResource {
+    id: string;
+    name: string;
+    contentType: string;
+    size: number;
+}
+declare function createSideloadResource(buffer: Buffer, { name, contentType }: Pick<SideloadResource, 'name' | 'contentType'>): Promise<SideloadResource>;
+
+interface UnwrapResult {
+    defaultValue?: any;
+    isOptional?: boolean;
+    isNullable?: boolean;
+    isReadOnly?: boolean;
+}
+declare function unwrap(type: z$1.ZodTypeAny, result?: UnwrapResult): [z$1.ZodTypeAny, UnwrapResult];
+
+export { type Action, type Adapter, type AdapterFactory, type AdapterGenerator, type MCPHero, type MCPHeroContext, type MCPHeroOptions, type SideloadResource, type ToolResponse, type UnwrapResult, createAction, createContext, createSideloadResource, mcphero, parseToolResponse, toolResponse, unwrap };

package/build/index.js

@@ -0,0 +1,120 @@
+// src/util/context.ts
+function createContext(store = {}) {
+  return {
+    keys: () => {
+      return Object.keys(store);
+    },
+    has: (key) => {
+      return store[key] != null;
+    },
+    get: (key) => {
+      const value = store[key];
+      if (value == null) {
+        throw new Error(`Invalid context key: ${key}`);
+      }
+      return value;
+    },
+    set: (key, value) => {
+      store[key] = value;
+    },
+    fork: (value) => {
+      return createContext({ ...store, ...value });
+    }
+  };
+}
+
+// src/lib/mcphero.ts
+function mcphero(options) {
+  const adapters = [];
+  const actions = [];
+  const context = createContext();
+  const builder = {
+    set: (key, value) => {
+      context.set(key, value);
+      return builder;
+    },
+    adapter: (generator) => {
+      adapters.push(generator(options, context));
+      return builder;
+    },
+    action: (value) => {
+      actions.push(value);
+      return builder;
+    },
+    actions: (values) => {
+      actions.push(...values);
+      return builder;
+    },
+    start: async () => {
+      await Promise.all(adapters.map((adapter) => {
+        return adapter.start(actions.filter((action) => {
+          if (!action.isEnabled) {
+            return true;
+          }
+          return action.isEnabled(adapter.context);
+        }));
+      }));
+      return builder;
+    }
+  };
+  return builder;
+}
+
+// src/util/action.ts
+function createAction(action) {
+  return action;
+}
+
+// src/util/mcp.ts
+function toolResponse(data) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+}
+function parseToolResponse(result) {
+  const text = result.content[0].text;
+  return JSON.parse(text);
+}
+
+// src/util/sideload.ts
+import { randomUUID } from "crypto";
+import { writeFile } from "fs/promises";
+async function createSideloadResource(buffer, { name, contentType }) {
+  const id = randomUUID();
+  const resource = { id, name, contentType, size: buffer.length };
+  await Promise.all([
+    writeFile(`resources/${id}`, buffer),
+    writeFile(`resources/${id}.json`, JSON.stringify(resource), "utf-8")
+  ]);
+  return resource;
+}
+
+// src/util/zod.ts
+import { z } from "zod";
+function unwrap(type, result = {}) {
+  if (type instanceof z.ZodOptional) {
+    result.isOptional = true;
+    return unwrap(type.unwrap(), result);
+  } else if (type instanceof z.ZodNullable) {
+    result.isNullable = true;
+    return unwrap(type.unwrap(), result);
+  } else if (type instanceof z.ZodReadonly) {
+    result.isReadOnly = true;
+    return unwrap(type.unwrap(), result);
+  } else if (type instanceof z.ZodDefault) {
+    result.defaultValue = typeof type.def.defaultValue === "function" ? type.def.defaultValue() : type.def.defaultValue;
+    return unwrap(type.unwrap(), result);
+  } else {
+    return [type, result];
+  }
+}
+export {
+  createAction,
+  createContext,
+  createSideloadResource,
+  mcphero,
+  parseToolResponse,
+  toolResponse,
+  unwrap
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/context.ts","../src/lib/mcphero.ts","../src/util/action.ts","../src/util/mcp.ts","../src/util/sideload.ts","../src/util/zod.ts"],"sourcesContent":["export interface MCPHeroContext {\n  keys: () => string[]\n  has: (key: string) => boolean\n  get: <T>(key: string) => T\n  set: <T>(key: string, value: T) => void\n  fork: (store?: Record<string, unknown>) => MCPHeroContext\n}\n\nexport function createContext(store: Record<string, unknown> = {}): MCPHeroContext {\n  return {\n    keys: () => {\n      return Object.keys(store)\n    },\n    has: (key: string): boolean => {\n      return store[key] != null\n    },\n    get: <T>(key: string): T => {\n      const value = store[key]\n      if (value == null) { throw new Error(`Invalid context key: ${key}`) }\n      return value as T\n    },\n    set: <T>(key: string, value: T) => {\n      store[key] = value\n    },\n    fork: (value?: Record<string, unknown>) => {\n      return createContext({ ...store, ...value })\n    }\n  }\n}\n","import { Action } from '../util/action.js'\nimport { Adapter, AdapterGenerator } from '../util/adapter.js'\nimport { createContext } from '../util/context.js'\n\nexport interface MCPHeroOptions {\n  name: string\n  description: string\n  version: string\n}\n\nexport interface MCPHero {\n  set: <T>(key: string, value: T) => MCPHero\n  adapter: (generator: AdapterGenerator) => MCPHero\n  action: (action: Action) => MCPHero\n  actions: (actions: Action[]) => MCPHero\n  start: () => Promise<MCPHero>\n}\n\nexport function mcphero(options: MCPHeroOptions): MCPHero {\n  const adapters: Adapter[] = []\n  const actions: Action[] = []\n  const context = createContext()\n  const builder: MCPHero = {\n    set: (key, value) => {\n      context.set(key, value)\n      return builder\n    },\n    adapter: (generator) => {\n      adapters.push(generator(options, context))\n      return builder\n    },\n    action: (value) => {\n      actions.push(value)\n      return builder\n    },\n    actions: (values) => {\n      actions.push(...values)\n      return builder\n    },\n    start: async () => {\n      await Promise.all(adapters.map((adapter) => {\n        return adapter.start(actions.filter((action) => {\n          if (!action.isEnabled) { return true }\n          return action.isEnabled(adapter.context)\n        }))\n      }))\n      return builder\n    }\n  }\n  return builder\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport z from 'zod'\nimport { MCPHeroContext } from './context.js'\n\nexport interface Action<I extends object = any, O extends object = any> {\n  name: string\n  description: string\n  input: z.ZodType<I> & { shape: Record<string, z.ZodTypeAny> }\n  args?: (keyof I)[]\n  isEnabled?: (context: MCPHeroContext) => boolean\n  run: (input: I, context: MCPHeroContext) => Promise<O>\n}\n\nexport function createAction<I extends object = object, O extends object = object>(\n  action: Action<I, O>\n): Action<I, O> {\n  return action\n}\n","import { TextContent } from '@modelcontextprotocol/sdk/types.js'\n\nexport interface ToolResponse {\n  content: TextContent[]\n  [x: string]: unknown\n}\n\nexport function toolResponse(data: object): ToolResponse {\n  return {\n    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }]\n  }\n}\n\nexport function parseToolResponse<T = unknown>(result: ToolResponse): T {\n  const text = result.content[0].text\n  return JSON.parse(text)\n}\n","import { randomUUID } from 'crypto'\nimport { writeFile } from 'fs/promises'\n\nexport interface SideloadResource {\n  id: string\n  name: string\n  contentType: string\n  size: number\n}\n\nexport async function createSideloadResource(buffer: Buffer, { name, contentType }: Pick<SideloadResource, 'name' | 'contentType'>) {\n  const id = randomUUID()\n  const resource: SideloadResource = { id, name, contentType, size: buffer.length }\n  await Promise.all([\n    writeFile(`resources/${id}`, buffer),\n    writeFile(`resources/${id}.json`, JSON.stringify(resource), 'utf-8')\n  ])\n  return resource\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { z } from 'zod'\n\nexport interface UnwrapResult {\n  defaultValue?: any\n  isOptional?: boolean\n  isNullable?: boolean\n  isReadOnly?: boolean\n}\n\nexport function unwrap(\n  type: z.ZodTypeAny,\n  result: UnwrapResult = {}\n): [z.ZodTypeAny, UnwrapResult] {\n  if (type instanceof z.ZodOptional) {\n    result.isOptional = true\n    return unwrap(type.unwrap() as z.ZodTypeAny, result)\n  } else if (type instanceof z.ZodNullable) {\n    result.isNullable = true\n    return unwrap(type.unwrap() as z.ZodTypeAny, result)\n  } else if (type instanceof z.ZodReadonly) {\n    result.isReadOnly = true\n    return unwrap(type.unwrap() as z.ZodTypeAny, result)\n  } else if (type instanceof z.ZodDefault) {\n    result.defaultValue = typeof type.def.defaultValue === 'function'\n      ? type.def.defaultValue()\n      : type.def.defaultValue\n    return unwrap(type.unwrap() as z.ZodTypeAny, result)\n  } else {\n    return [type, result]\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@mcphero/core",
+  "version": "1.1.6",
+  "description": "MCP Hero Core",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/atomicbi/mcphero.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6",
+    "@mcphero/logger": "1.1.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@modelcontextprotocol/inspector": "^0.21.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "scripts": {
+    "clean": "rimraf build",
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint",
+    "check": "pnpm lint && pnpm typecheck"
+  }
+}