@silkweave/core 1.3.0

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+
+
+> @silkweave/core@1.3.0 build /Users/atomic/projects/ai/silkweave/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/silkweave/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.19 KB
+ESM ⚡️ Build success in 6ms
+DTS Build start
+DTS ⚡️ Build success in 602ms
+DTS build/index.d.ts 2.54 KB

package/.turbo/turbo-check.log

@@ -0,0 +1,13 @@
+
+
+> @silkweave/core@1.3.0 check /Users/atomic/projects/ai/silkweave/packages/core
+> pnpm lint && pnpm typecheck
+
+
+> @silkweave/core@1.3.0 lint /Users/atomic/projects/ai/silkweave/packages/core
+> eslint
+
+
+> @silkweave/core@1.3.0 typecheck /Users/atomic/projects/ai/silkweave/packages/core
+> tsc --noEmit
+

package/.turbo/turbo-lint.log

@@ -0,0 +1,13 @@
+
+
+> @silkweave/core@1.3.0 lint /Users/atomic/projects/ai/silkweave/packages/core
+> eslint
+
+
+/Users/atomic/projects/ai/silkweave/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.

package/.turbo/turbo-prepack.log

@@ -0,0 +1,26 @@
+
+
+> @silkweave/core@1.3.0 prepack /Users/atomic/projects/ai/mcphero/packages/core
+> pnpm clean && pnpm build
+
+
+> @silkweave/core@1.3.0 clean /Users/atomic/projects/ai/mcphero/packages/core
+> rimraf build
+
+
+> @silkweave/core@1.3.0 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.19 KB
+ESM ⚡️ Build success in 12ms
+DTS Build start
+DTS ⚡️ Build success in 587ms
+DTS build/index.d.ts 2.54 KB

package/README.md

@@ -0,0 +1,89 @@
+# @silkweave/core
+
+Core library for [Silkweave](https://github.com/atomicbi/silkweave) — the TypeScript toolkit for building MCP servers and CLI tools from a single set of Actions.
+
+## Install
+
+```bash
+pnpm add @silkweave/core
+```
+
+## What's Inside
+
+This package provides the foundational building blocks that all Silkweave adapters depend on:
+
+- **`silkweave()`** — Fluent builder to wire up adapters and actions
+- **`createAction()`** — Define transport-agnostic actions with Zod input schemas
+- **Adapter types** — `Adapter`, `AdapterGenerator`, `AdapterFactory` interfaces for building custom adapters
+- **Context** — `SilkweaveContext` key-value store with `fork()` for per-adapter/per-request isolation
+- **MCP utilities** — `toolResponse()`, `parseToolResponse()` for MCP response formatting
+- **Sideload resources** — `createSideloadResource()` for binary resource handling
+- **Zod utilities** — `unwrap()` to recursively unwrap Zod wrapper types
+
+## Usage
+
+```typescript
+import { silkweave, createAction } from '@silkweave/core'
+import z from 'zod'
+
+const GreetAction = createAction({
+  name: 'greet',
+  description: 'Greet someone by name',
+  input: z.object({
+    name: z.string().describe('Name to greet')
+  }),
+  run: async ({ name }, context) => {
+    return { message: `Hello, ${name}!` }
+  }
+})
+
+// Wire up with any adapter
+await silkweave({ name: 'my-app', description: 'My App', version: '1.0.0' })
+  .adapter(someAdapter)
+  .action(GreetAction)
+  .start()
+```
+
+## API
+
+### `silkweave(options): Silkweave`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `name` | `string` | Server/app name |
+| `description` | `string` | Human-readable description |
+| `version` | `string` | Semantic version |
+
+Returns a builder with `.adapter()`, `.action()`, `.actions()`, `.set()`, and `.start()`.
+
+### `createAction(action): Action`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | Unique action identifier |
+| `description` | `string` | Human-readable description |
+| `input` | `z.ZodObject` | Zod schema for input validation |
+| `args` | `(keyof I)[]` | Fields to expose as CLI positional arguments |
+| `isEnabled` | `(context) => boolean` | Gate action availability per adapter |
+| `run` | `(input, context) => Promise<O>` | The action implementation |
+
+### Adapter Interfaces
+
+```typescript
+interface Adapter {
+  context: SilkweaveContext
+  start(actions: Action[]): Promise<void>
+  stop(): Promise<void>
+}
+
+type AdapterGenerator = (options: SilkweaveOptions, baseContext: SilkweaveContext) => Adapter
+type AdapterFactory<T = void> = (options: T) => AdapterGenerator
+```
+
+## See Also
+
+- [Silkweave README](https://github.com/atomicbi/silkweave) — Full documentation
+- [`@silkweave/mcp`](https://www.npmjs.com/package/@silkweave/mcp) — MCP stdio and HTTP adapters
+- [`@silkweave/fastify`](https://www.npmjs.com/package/@silkweave/fastify) — Fastify REST adapter
+- [`@silkweave/cli`](https://www.npmjs.com/package/@silkweave/cli) — CLI adapter
+- [`@silkweave/vercel`](https://www.npmjs.com/package/@silkweave/vercel) — Vercel serverless adapter

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 SilkweaveContext {
+    keys: () => string[];
+    has: (key: string) => boolean;
+    get: <T>(key: string) => T;
+    set: <T>(key: string, value: T) => void;
+    fork: (store?: Record<string, unknown>) => SilkweaveContext;
+}
+declare function createContext(store?: Record<string, unknown>): SilkweaveContext;
+
+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: SilkweaveContext) => boolean;
+    run: (input: I, context: SilkweaveContext) => Promise<O>;
+}
+declare function createAction<I extends object = object, O extends object = object>(action: Action<I, O>): Action<I, O>;
+
+interface Adapter {
+    context: SilkweaveContext;
+    start(actions: Action[]): Promise<void>;
+    stop(): Promise<void>;
+}
+type AdapterGenerator = (options: SilkweaveOptions, baseContext: SilkweaveContext) => Adapter;
+type AdapterFactory<T = void> = (options: T) => AdapterGenerator;
+
+interface SilkweaveOptions {
+    name: string;
+    description: string;
+    version: string;
+}
+interface Silkweave {
+    set: <T>(key: string, value: T) => Silkweave;
+    adapter: (generator: AdapterGenerator) => Silkweave;
+    action: (action: Action) => Silkweave;
+    actions: (actions: Action[]) => Silkweave;
+    start: () => Promise<Silkweave>;
+}
+declare function silkweave(options: SilkweaveOptions): Silkweave;
+
+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 SideloadResource, type Silkweave, type SilkweaveContext, type SilkweaveOptions, type ToolResponse, type UnwrapResult, createAction, createContext, createSideloadResource, parseToolResponse, silkweave, 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/silkweave.ts
+function silkweave(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,
+  parseToolResponse,
+  silkweave,
+  toolResponse,
+  unwrap
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/context.ts","../src/lib/silkweave.ts","../src/util/action.ts","../src/util/mcp.ts","../src/util/sideload.ts","../src/util/zod.ts"],"sourcesContent":["export interface SilkweaveContext {\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>) => SilkweaveContext\n}\n\nexport function createContext(store: Record<string, unknown> = {}): SilkweaveContext {\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 SilkweaveOptions {\n  name: string\n  description: string\n  version: string\n}\n\nexport interface Silkweave {\n  set: <T>(key: string, value: T) => Silkweave\n  adapter: (generator: AdapterGenerator) => Silkweave\n  action: (action: Action) => Silkweave\n  actions: (actions: Action[]) => Silkweave\n  start: () => Promise<Silkweave>\n}\n\nexport function silkweave(options: SilkweaveOptions): Silkweave {\n  const adapters: Adapter[] = []\n  const actions: Action[] = []\n  const context = createContext()\n  const builder: Silkweave = {\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 { SilkweaveContext } 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: SilkweaveContext) => boolean\n  run: (input: I, context: SilkweaveContext) => 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": "@silkweave/core",
+  "version": "1.3.0",
+  "description": "Silkweave Core",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/atomicbi/silkweave.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",
+    "@silkweave/logger": "1.3.0"
+  },
+  "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"
+  }
+}