@cogitator-ai/wasm-tools 0.2.7 → 0.3.0

package/dist/index.js

@@ -1,51 +1,269 @@
 /**
  * @cogitator-ai/wasm-tools - WASM-based tools for Cogitator agents
  *
- * This package provides pre-built WASM tools that run in the Extism sandbox.
+ * This package provides pre-built WASM tools and a framework for creating
+ * custom WASM tools that run in the Extism sandbox.
+ *
  * WASM tools offer:
  * - 100-500x faster cold start than Docker
  * - Memory-safe execution in isolated sandbox
  * - ~20x lower memory footprint
+ *
+ * @example
+ * ```ts
+ * import { defineWasmTool, createCalcTool } from '@cogitator-ai/wasm-tools';
+ *
+ * // Use pre-built tools
+ * const calc = createCalcTool();
+ *
+ * // Create custom WASM tools
+ * const myTool = defineWasmTool({
+ *   name: 'image_processor',
+ *   description: 'Process images in WASM sandbox',
+ *   wasmModule: './my-image-proc.wasm',
+ *   wasmFunction: 'process',
+ *   parameters: z.object({
+ *     imageData: z.string(),
+ *     operation: z.enum(['resize', 'crop', 'rotate']),
+ *   }),
+ * });
+ * ```
  */
 import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 /**
- * Get the path to a WASM module in this package
+ * Create a custom WASM tool for agent use.
+ *
+ * WASM tools run in an isolated Extism sandbox with memory-safe execution.
+ * The execute function passes parameters to the WASM module, which handles
+ * the actual computation.
+ *
+ * @param config - WASM tool configuration
+ * @returns A Tool instance configured for WASM sandbox execution
+ *
+ * @example
+ * ```ts
+ * const hashTool = defineWasmTool({
+ *   name: 'hash_text',
+ *   description: 'Hash text using various algorithms',
+ *   wasmModule: './hash.wasm',
+ *   wasmFunction: 'hash',
+ *   parameters: z.object({
+ *     text: z.string(),
+ *     algorithm: z.enum(['sha256', 'sha512', 'md5']),
+ *   }),
+ * });
+ *
+ * // Use with an agent
+ * const agent = new Agent({
+ *   name: 'hasher',
+ *   tools: [hashTool],
+ * });
+ * ```
+ */
+export function defineWasmTool(config) {
+    const sandboxConfig = {
+        type: 'wasm',
+        wasmModule: config.wasmModule,
+        wasmFunction: config.wasmFunction ?? 'run',
+        timeout: config.timeout ?? 5000,
+        wasi: config.wasi,
+    };
+    const tool = {
+        name: config.name,
+        description: config.description,
+        category: config.category,
+        tags: config.tags,
+        parameters: config.parameters,
+        sandbox: sandboxConfig,
+        execute: async (params, _context) => {
+            return params;
+        },
+        toJSON: () => wasmToolToSchema(tool),
+    };
+    return tool;
+}
+function wasmToolToSchema(t) {
+    const jsonSchema = zodToJsonSchema(t.parameters, {
+        target: 'openApi3',
+        $refStrategy: 'none',
+    });
+    const schema = jsonSchema;
+    const properties = (schema.properties ?? {});
+    const required = schema.required;
+    return {
+        name: t.name,
+        description: t.description,
+        parameters: {
+            type: 'object',
+            properties,
+            required,
+        },
+    };
+}
+/**
+ * Get the path to a pre-built WASM module in this package
  */
 export function getWasmPath(name) {
     return join(__dirname, 'wasm', `${name}.wasm`);
 }
+export const calcToolSchema = z.object({
+    expression: z.string().describe('Mathematical expression to evaluate (e.g., "2 + 2 * 3")'),
+});
+export const jsonToolSchema = z.object({
+    json: z.string().describe('JSON string to parse and process'),
+    query: z.string().optional().describe('Optional JSONPath query'),
+});
+export const hashToolSchema = z.object({
+    text: z.string().describe('Text to hash'),
+    algorithm: z.enum(['sha256', 'sha1', 'md5']).describe('Hash algorithm to use'),
+});
+export const base64ToolSchema = z.object({
+    text: z.string().describe('Text to encode or decode'),
+    operation: z.enum(['encode', 'decode']).describe('Whether to encode or decode'),
+    urlSafe: z.boolean().optional().describe('Use URL-safe Base64 variant'),
+});
+/**
+ * Create a calculator WASM tool.
+ *
+ * Evaluates mathematical expressions safely in a WASM sandbox.
+ * Supports basic arithmetic: +, -, *, /, %, parentheses.
+ *
+ * @param options - Optional configuration overrides
+ * @returns A Tool for mathematical calculations
+ *
+ * @example
+ * ```ts
+ * const calc = createCalcTool();
+ * const agent = new Agent({ tools: [calc] });
+ *
+ * // Agent can now use: calculate({ expression: "2 + 2 * 3" })
+ * ```
+ */
+export function createCalcTool(options) {
+    return defineWasmTool({
+        name: 'calculate',
+        description: 'Evaluate a mathematical expression safely. Supports +, -, *, /, %, and parentheses.',
+        wasmModule: getWasmPath('calc'),
+        wasmFunction: 'calculate',
+        parameters: calcToolSchema,
+        category: 'math',
+        tags: ['calculation', 'math', 'arithmetic'],
+        timeout: options?.timeout ?? 5000,
+    });
+}
+/**
+ * Create a JSON processor WASM tool.
+ *
+ * Parses and queries JSON data safely in a WASM sandbox.
+ * Supports JSONPath queries for extracting nested data.
+ *
+ * @param options - Optional configuration overrides
+ * @returns A Tool for JSON processing
+ *
+ * @example
+ * ```ts
+ * const jsonTool = createJsonTool();
+ * const agent = new Agent({ tools: [jsonTool] });
+ *
+ * // Agent can now use: process_json({ json: '{"a": 1}', query: '$.a' })
+ * ```
+ */
+export function createJsonTool(options) {
+    return defineWasmTool({
+        name: 'process_json',
+        description: 'Parse and query JSON data. Supports JSONPath queries for extracting nested values.',
+        wasmModule: getWasmPath('json'),
+        wasmFunction: 'process',
+        parameters: jsonToolSchema,
+        category: 'utility',
+        tags: ['json', 'parsing', 'query'],
+        timeout: options?.timeout ?? 5000,
+    });
+}
 /**
- * Calculator tool configuration for WASM execution
+ * Create a hash WASM tool.
+ *
+ * Computes cryptographic hashes safely in a WASM sandbox.
+ * Supports SHA-256, SHA-1, and MD5 algorithms.
+ *
+ * @param options - Optional configuration overrides
+ * @returns A Tool for hashing text
+ *
+ * @example
+ * ```ts
+ * const hashTool = createHashTool();
+ * const agent = new Agent({ tools: [hashTool] });
+ *
+ * // Agent can now use: hash_text({ text: "hello", algorithm: "sha256" })
+ * ```
  */
+export function createHashTool(options) {
+    return defineWasmTool({
+        name: 'hash_text',
+        description: 'Compute cryptographic hash of text. Supports SHA-256, SHA-1, and MD5 algorithms.',
+        wasmModule: getWasmPath('hash'),
+        wasmFunction: 'hash',
+        parameters: hashToolSchema,
+        category: 'utility',
+        tags: ['hash', 'crypto', 'sha256', 'md5'],
+        timeout: options?.timeout ?? 5000,
+    });
+}
+/**
+ * Create a Base64 encoding/decoding WASM tool.
+ *
+ * Encodes and decodes Base64 safely in a WASM sandbox.
+ * Supports both standard and URL-safe Base64 variants.
+ *
+ * @param options - Optional configuration overrides
+ * @returns A Tool for Base64 operations
+ *
+ * @example
+ * ```ts
+ * const b64Tool = createBase64Tool();
+ * const agent = new Agent({ tools: [b64Tool] });
+ *
+ * // Agent can now use: base64({ text: "hello", operation: "encode" })
+ * ```
+ */
+export function createBase64Tool(options) {
+    return defineWasmTool({
+        name: 'base64',
+        description: 'Encode or decode Base64 text. Supports standard and URL-safe variants.',
+        wasmModule: getWasmPath('base64'),
+        wasmFunction: 'base64',
+        parameters: base64ToolSchema,
+        category: 'utility',
+        tags: ['base64', 'encoding', 'decoding'],
+        timeout: options?.timeout ?? 5000,
+    });
+}
 export const calcToolConfig = {
     type: 'wasm',
     wasmModule: getWasmPath('calc'),
     wasmFunction: 'calculate',
     timeout: 5000,
 };
-/**
- * Calculator tool schema
- */
-export const calcToolSchema = z.object({
-    expression: z.string().describe('Mathematical expression to evaluate (e.g., "2 + 2 * 3")'),
-});
-/**
- * JSON processor tool configuration
- */
 export const jsonToolConfig = {
     type: 'wasm',
     wasmModule: getWasmPath('json'),
     wasmFunction: 'process',
     timeout: 5000,
 };
-/**
- * JSON processor tool schema
- */
-export const jsonToolSchema = z.object({
-    json: z.string().describe('JSON string to parse and process'),
-    query: z.string().optional().describe('Optional JSONPath query'),
-});
+export const hashToolConfig = {
+    type: 'wasm',
+    wasmModule: getWasmPath('hash'),
+    wasmFunction: 'hash',
+    timeout: 5000,
+};
+export const base64ToolConfig = {
+    type: 'wasm',
+    wasmModule: getWasmPath('base64'),
+    wasmFunction: 'base64',
+    timeout: 5000,
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC;IAC/B,YAAY,EAAE,WAAW;IACzB,OAAO,EAAE,IAAI;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CAC3F,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC;IAC/B,YAAY,EAAE,SAAS;IACvB,OAAO,EAAE,IAAI;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACjE,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/plugins/base64.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Base64 WASM Plugin
+ *
+ * This file is compiled to WASM using the Extism JS PDK.
+ * It provides base64 encoding and decoding functions.
+ *
+ * Build command:
+ *   esbuild src/plugins/base64.ts -o dist/temp/base64.js --bundle --format=cjs --target=es2020
+ *   extism-js dist/temp/base64.js -o dist/wasm/base64.wasm
+ */
+export declare function base64(): number;
+//# sourceMappingURL=base64.d.ts.map

package/dist/plugins/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/plugins/base64.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqFH,wBAAgB,MAAM,IAAI,MAAM,CA6B/B"}

package/dist/plugins/base64.js

@@ -0,0 +1,96 @@
+/**
+ * Base64 WASM Plugin
+ *
+ * This file is compiled to WASM using the Extism JS PDK.
+ * It provides base64 encoding and decoding functions.
+ *
+ * Build command:
+ *   esbuild src/plugins/base64.ts -o dist/temp/base64.js --bundle --format=cjs --target=es2020
+ *   extism-js dist/temp/base64.js -o dist/wasm/base64.wasm
+ */
+const STANDARD_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+const URL_SAFE_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+function encodeBase64(input, urlSafe) {
+    const chars = urlSafe ? URL_SAFE_CHARS : STANDARD_CHARS;
+    let result = '';
+    let i = 0;
+    while (i < input.length) {
+        const a = input.charCodeAt(i++);
+        const b = i < input.length ? input.charCodeAt(i++) : 0;
+        const c = i < input.length ? input.charCodeAt(i++) : 0;
+        const bitmap = (a << 16) | (b << 8) | c;
+        result +=
+            chars.charAt((bitmap >> 18) & 63) +
+                chars.charAt((bitmap >> 12) & 63) +
+                chars.charAt((bitmap >> 6) & 63) +
+                chars.charAt(bitmap & 63);
+    }
+    const padding = input.length % 3;
+    if (padding === 1) {
+        result = result.slice(0, -2) + (urlSafe ? '' : '==');
+    }
+    else if (padding === 2) {
+        result = result.slice(0, -1) + (urlSafe ? '' : '=');
+    }
+    return result;
+}
+function decodeBase64(input, urlSafe) {
+    let chars = urlSafe ? URL_SAFE_CHARS : STANDARD_CHARS;
+    let normalized = input;
+    if (!urlSafe && input.includes('-')) {
+        chars = URL_SAFE_CHARS;
+        normalized = input;
+    }
+    normalized = normalized.replace(/[=]/g, '');
+    const lookup = {};
+    for (let i = 0; i < chars.length; i++) {
+        lookup[chars[i]] = i;
+    }
+    let result = '';
+    let buffer = 0;
+    let bits = 0;
+    for (let i = 0; i < normalized.length; i++) {
+        const char = normalized[i];
+        const value = lookup[char];
+        if (value === undefined) {
+            continue;
+        }
+        buffer = (buffer << 6) | value;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            result += String.fromCharCode((buffer >> bits) & 0xff);
+        }
+    }
+    return result;
+}
+export function base64() {
+    try {
+        const inputStr = Host.inputString();
+        const input = JSON.parse(inputStr);
+        const urlSafe = input.urlSafe ?? false;
+        let result;
+        if (input.operation === 'encode') {
+            result = encodeBase64(input.text, urlSafe);
+        }
+        else {
+            result = decodeBase64(input.text, urlSafe);
+        }
+        const output = {
+            result,
+            operation: input.operation,
+        };
+        Host.outputString(JSON.stringify(output));
+        return 0;
+    }
+    catch (error) {
+        const output = {
+            result: '',
+            operation: 'unknown',
+            error: error instanceof Error ? error.message : String(error),
+        };
+        Host.outputString(JSON.stringify(output));
+        return 1;
+    }
+}
+//# sourceMappingURL=base64.js.map

package/dist/plugins/base64.js.map

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

package/dist/plugins/hash.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hash WASM Plugin
+ *
+ * This file is compiled to WASM using the Extism JS PDK.
+ * It provides cryptographic hashing functions.
+ *
+ * Build command:
+ *   esbuild src/plugins/hash.ts -o dist/temp/hash.js --bundle --format=cjs --target=es2020
+ *   extism-js dist/temp/hash.js -o dist/wasm/hash.wasm
+ */
+export declare function hash(): number;
+//# sourceMappingURL=hash.d.ts.map

package/dist/plugins/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/plugins/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2SH,wBAAgB,IAAI,IAAI,MAAM,CAmC7B"}