@supertools-ai/core 0.1.0

package/dist/supertools.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Supertools
+ *
+ * Wrap any LLM SDK client with programmatic tool calling.
+ * Auto-detects the provider and applies the appropriate wrapper.
+ *
+ * @example
+ * ```ts
+ * import { supertools, defineTool, z } from '@supertools-ai/core';
+ * import { Sandbox } from 'e2b';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const tools = [
+ *   defineTool({
+ *     name: 'queryDatabase',
+ *     description: 'Execute a SQL query',
+ *     parameters: z.object({ sql: z.string() }),
+ *     returns: z.array(z.record(z.any())),
+ *     execute: async ({ sql }) => db.query(sql),
+ *   }),
+ * ];
+ *
+ * const sandbox = await Sandbox.create('supertools-bun');
+ * const client = supertools(new Anthropic(), { tools, sandbox });
+ *
+ * // Use exactly like the normal SDK
+ * const response = await client.messages.create({
+ *   model: 'claude-haiku-4-5-20251001',
+ *   max_tokens: 1024,
+ *   messages: [{ role: 'user', content: 'Query all users and summarize' }],
+ * });
+ * ```
+ */
+import type { Sandbox } from 'e2b';
+import type { AnyTool } from './tool';
+import type { ExecutionEvent } from './types';
+/**
+ * Configuration options for supertools
+ */
+export interface SupertoolsConfig {
+    /** Tools to make available */
+    readonly tools: readonly AnyTool[];
+    /** Pre-created E2B sandbox - caller manages lifecycle */
+    readonly sandbox: Sandbox;
+    /** Additional instructions for the LLM */
+    readonly instructions?: string;
+    /** Enable debug logging */
+    readonly debug?: boolean;
+    /** Callback for structured execution events */
+    readonly onEvent?: (event: ExecutionEvent) => void;
+}
+/**
+ * Supported provider types
+ */
+export type SupportedProvider = 'anthropic';
+/**
+ * Detect the provider type from a client instance
+ */
+export declare function detectProvider(client: unknown): SupportedProvider | null;
+/**
+ * Wrap an LLM SDK client with programmatic tool calling.
+ *
+ * The wrapper intercepts API calls and automatically generates code
+ * that runs all tool calls in a secure sandbox, returning results
+ * in the expected SDK format.
+ *
+ * @param client - An LLM SDK client (Anthropic, OpenAI, etc.)
+ * @param config - Configuration including tools to make available
+ * @returns A wrapped client that behaves like the original
+ *
+ * @example
+ * ```ts
+ * const sandbox = await Sandbox.create('supertools-bun');
+ * const client = supertools(new Anthropic(), {
+ *   tools: [queryDb, sendEmail],
+ *   sandbox,
+ *   debug: true,
+ * });
+ *
+ * // Works exactly like the normal Anthropic SDK
+ * const response = await client.messages.create({
+ *   model: 'claude-haiku-4-5-20251001',
+ *   max_tokens: 1024,
+ *   messages: [{ role: 'user', content: 'Find top users and email report' }],
+ * });
+ * ```
+ */
+export declare function supertools<T>(client: T, config: SupertoolsConfig): T;
+export default supertools;
+//# sourceMappingURL=supertools.d.ts.map

package/dist/supertools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supertools.d.ts","sourceRoot":"","sources":["../src/supertools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE5C;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAKxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAG,CAAC,CA2BpE;AAED,eAAe,UAAU,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+declare const TOOL_BRAND: unique symbol;
+type ZodSchema = z.ZodType;
+type InferInput<T extends ZodSchema> = z.infer<T>;
+type InferOutput<T extends ZodSchema> = z.infer<T>;
+type ExecuteFn<TParams extends ZodSchema, TReturns extends ZodSchema | undefined> = (params: InferInput<TParams>) => TReturns extends ZodSchema ? InferOutput<TReturns> | Promise<InferOutput<TReturns>> : unknown | Promise<unknown>;
+export interface ToolDefinition<TParams extends ZodSchema, TReturns extends ZodSchema | undefined = undefined> {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: TParams;
+    readonly returns?: TReturns;
+    readonly execute: ExecuteFn<TParams, TReturns>;
+    /**
+     * If true, tool runs locally in sandbox (no network round-trip).
+     * Use for pure computation that doesn't need host resources.
+     */
+    readonly local?: boolean;
+}
+export interface Tool<TParams extends ZodSchema = ZodSchema, TReturns extends ZodSchema | undefined = undefined> {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: TParams;
+    readonly returns?: TReturns;
+    readonly execute: ExecuteFn<TParams, TReturns>;
+    readonly local?: boolean;
+    readonly [TOOL_BRAND]: true;
+}
+export type AnyTool = Tool<ZodSchema, ZodSchema | undefined>;
+export interface NormalizedParameter {
+    readonly name: string;
+    readonly type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'any';
+    readonly description: string;
+    readonly required: boolean;
+    readonly default?: unknown;
+}
+export interface NormalizedTool {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: readonly NormalizedParameter[];
+    readonly execute: (params: Record<string, unknown>) => unknown | Promise<unknown>;
+    /** If set, this tool runs locally in sandbox using this code */
+    readonly localCode?: string;
+}
+/**
+ * Define a tool with type-safe parameters and optional return type.
+ *
+ * @example
+ * const searchUsers = defineTool({
+ *   name: 'searchUsers',
+ *   description: 'Search users by name or email',
+ *   parameters: z.object({
+ *     query: z.string().describe('Search query'),
+ *     limit: z.number().optional().default(10),
+ *   }),
+ *   returns: z.array(z.object({
+ *     id: z.number(),
+ *     name: z.string(),
+ *   })),
+ *   execute: async ({ query, limit }) => db.users.search(query).limit(limit),
+ * });
+ */
+export declare function defineTool<TParams extends ZodSchema, TReturns extends ZodSchema | undefined = undefined>(definition: ToolDefinition<TParams, TReturns>): Tool<TParams, TReturns>;
+export declare function isTool(value: unknown): value is Tool;
+export declare function normalizeTools(tools: readonly AnyTool[]): NormalizedTool[];
+export { z };
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}

package/dist/type-hints.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from './tool';
+export declare function generateTypeHints(tools: readonly Tool[]): string;
+//# sourceMappingURL=type-hints.d.ts.map

package/dist/type-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-hints.d.ts","sourceRoot":"","sources":["../src/type-hints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAqBnC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,MAAM,CAKhE"}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+import type { Sandbox } from 'e2b';
+import type { AnyTool } from './tool';
+export type ToolCollection = readonly AnyTool[];
+export interface ExecutionResult {
+    readonly success: boolean;
+    readonly output: string;
+    readonly error?: string;
+    readonly executionTimeMs: number;
+    readonly images?: readonly string[];
+}
+export interface GeneratedCode {
+    readonly code: string;
+    readonly explanation?: string;
+    readonly rawResponse?: string;
+}
+export interface ProgrammaticResult {
+    readonly code: string;
+    readonly explanation?: string;
+    readonly result: ExecutionResult;
+}
+export interface ToolCallRequest {
+    readonly tool: string;
+    readonly arguments: Readonly<Record<string, unknown>>;
+}
+export interface ToolCallResponse {
+    readonly success: boolean;
+    readonly result?: unknown;
+    readonly error?: string;
+}
+export interface LLMAdapter {
+    generateCode(userRequest: string, systemPrompt: string): Promise<GeneratedCode>;
+}
+/**
+ * Structured execution events for real-time progress tracking
+ */
+export type ExecutionEvent = {
+    readonly type: 'code_generated';
+    readonly code: string;
+    readonly explanation?: string;
+} | {
+    readonly type: 'sandbox_ready';
+    readonly sandboxId: string;
+} | {
+    readonly type: 'tool_call';
+    readonly tool: string;
+    readonly arguments: Record<string, unknown>;
+    readonly callId: string;
+} | {
+    readonly type: 'tool_result';
+    readonly tool: string;
+    readonly result: unknown;
+    readonly callId: string;
+    readonly durationMs: number;
+} | {
+    readonly type: 'tool_error';
+    readonly tool: string;
+    readonly error: string;
+    readonly callId: string;
+} | {
+    readonly type: 'result';
+    readonly data: unknown;
+} | {
+    readonly type: 'stdout';
+    readonly data: string;
+} | {
+    readonly type: 'stderr';
+    readonly data: string;
+} | {
+    readonly type: 'complete';
+    readonly success: boolean;
+    readonly output: string;
+    readonly error?: string;
+};
+export interface ExecutorConfig {
+    readonly tools: ToolCollection;
+    /** Pre-created sandbox - you manage its lifecycle */
+    readonly sandbox: Sandbox;
+    /** Additional instructions for the LLM */
+    readonly instructions?: string;
+    /** Enable debug logging */
+    readonly debug?: boolean;
+    /** Callback for structured execution events */
+    readonly onEvent?: (event: ExecutionEvent) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,50 @@
+export type ErrorCode = 'CODE_GENERATION_ERROR' | 'EXECUTION_ERROR' | 'TOOL_ERROR' | 'RELAY_CONNECTION_ERROR' | 'RELAY_TIMEOUT_ERROR' | 'PROTOCOL_ERROR' | 'SANDBOX_ERROR' | 'CONFIGURATION_ERROR';
+export declare class OPTError extends Error {
+    readonly code: ErrorCode;
+    readonly cause?: Error;
+    constructor(message: string, code: ErrorCode, cause?: Error);
+    toJSON(): {
+        name: string;
+        code: ErrorCode;
+        message: string;
+        cause: string | undefined;
+    };
+}
+export declare class CodeGenerationError extends OPTError {
+    constructor(message: string, cause?: Error);
+}
+export declare class ExecutionError extends OPTError {
+    readonly output?: string;
+    constructor(message: string, output?: string, cause?: Error);
+    toJSON(): {
+        output: string | undefined;
+        name: string;
+        code: ErrorCode;
+        message: string;
+        cause: string | undefined;
+    };
+}
+export declare class ToolError extends OPTError {
+    readonly toolName: string;
+    constructor(message: string, toolName: string, cause?: Error);
+    toJSON(): {
+        toolName: string;
+        name: string;
+        code: ErrorCode;
+        message: string;
+        cause: string | undefined;
+    };
+}
+export declare class RelayConnectionError extends OPTError {
+    constructor(message: string, cause?: Error);
+}
+export declare class RelayTimeoutError extends OPTError {
+    constructor(message: string);
+}
+export declare class SandboxError extends OPTError {
+    constructor(message: string, cause?: Error);
+}
+export declare class ConfigurationError extends OPTError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,uBAAuB,GACvB,iBAAiB,GACjB,YAAY,GACZ,wBAAwB,GACxB,qBAAqB,GACrB,gBAAgB,GAChB,eAAe,GACf,qBAAqB,CAAC;AAE1B,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,KAAK;IAQ3D,MAAM;;;;;;CAQP;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAMlD,MAAM;;;;;;;CAGhB;AAED,qBAAa,SAAU,SAAQ,QAAQ;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAMnD,MAAM;;;;;;;CAGhB;AAED,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/utils/sandbox-pool.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Sandbox Pool
+ *
+ * Pre-warms sandboxes to eliminate cold start latency.
+ * Sandboxes are created in advance and reused.
+ */
+import { Sandbox } from '@e2b/code-interpreter';
+export interface SandboxPoolOptions {
+    /** Number of sandboxes to keep warm (default: 1) */
+    readonly size?: number;
+    /** E2B API key (default: E2B_API_KEY env) */
+    readonly apiKey?: string;
+    /** Sandbox timeout in ms (default: 300000) */
+    readonly timeoutMs?: number;
+    /** Template name (default: 'supertools-bun') */
+    readonly template?: string;
+    /** Enable debug logging */
+    readonly debug?: boolean;
+}
+export declare class SandboxPool {
+    private readonly pool;
+    private readonly size;
+    private readonly apiKey?;
+    private readonly timeoutMs;
+    private readonly template;
+    private readonly debug;
+    private warming;
+    private closed;
+    constructor(options?: SandboxPoolOptions);
+    private log;
+    /**
+     * Pre-warm the pool with sandboxes.
+     * Call this once at startup for optimal performance.
+     */
+    warmup(): Promise<void>;
+    private doWarmup;
+    private createSandbox;
+    /**
+     * Acquire a sandbox from the pool.
+     * If pool is empty, creates a new one.
+     * The sandbox is removed from the pool and must be returned or killed.
+     */
+    acquire(): Promise<Sandbox>;
+    private refillInBackground;
+    /**
+     * Return a sandbox to the pool for reuse.
+     * Only call if the sandbox is still healthy.
+     */
+    release(sandbox: Sandbox): Promise<void>;
+    /**
+     * Close the pool and kill all sandboxes.
+     */
+    close(): Promise<void>;
+    /**
+     * Get current pool size.
+     */
+    get available(): number;
+}
+/**
+ * Create a new sandbox pool.
+ */
+export declare function createSandboxPool(options?: SandboxPoolOptions): SandboxPool;
+//# sourceMappingURL=sandbox-pool.d.ts.map

package/dist/utils/sandbox-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-pool.d.ts","sourceRoot":"","sources":["../../src/utils/sandbox-pool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,kBAAuB;IAQ5C,OAAO,CAAC,GAAG;IAIX;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YASf,QAAQ;YAiBR,aAAa;IAO3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAoBjC,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAE3E"}

package/dist/utils/string.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Convert camelCase or PascalCase to snake_case
+ */
+export declare function toSnakeCase(str: string): string;
+//# sourceMappingURL=string.d.ts.map

package/dist/utils/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/utils/type-hints.d.ts

@@ -0,0 +1,3 @@
+import type { AnyTool } from '../tool';
+export declare function generateTypeHints(tools: readonly AnyTool[]): string;
+//# sourceMappingURL=type-hints.d.ts.map

package/dist/utils/type-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-hints.d.ts","sourceRoot":"","sources":["../../src/utils/type-hints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAsBvC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAKnE"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@supertools-ai/core",
+  "version": "0.1.0",
+  "description": "Programmatic tool calling for LLMs - let AI write code that orchestrates your tools",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node --format esm && tsc --emitDeclarationOnly",
+    "dev": "bun --watch src/index.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "cp ../../README.md . && bun run build && bun run test"
+  },
+  "dependencies": {
+    "e2b": "^2.9.0",
+    "zod": "^4.2.1"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.30.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.30.0",
+    "@types/bun": "latest",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "supertools",
+    "llm",
+    "tool-calling",
+    "programmatic",
+    "code-execution",
+    "e2b",
+    "sandbox",
+    "anthropic",
+    "openai",
+    "ai",
+    "agents",
+    "claude"
+  ],
+  "author": "Filip Brebera",
+  "license": "MIT",
+  "homepage": "https://github.com/bxxf/supertools#readme",
+  "bugs": {
+    "url": "https://github.com/bxxf/supertools/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bxxf/supertools.git",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false
+}