@agnt5/sdk 0.2.1

package/dist/sandbox.js

@@ -0,0 +1,168 @@
+/**
+ * Sandbox — secure code execution and file I/O.
+ *
+ * Wraps the native Rust sandbox bindings, supporting both remote (HTTP)
+ * and embedded (WASM) backends. The backend is selected automatically
+ * based on available configuration.
+ *
+ * @example
+ * ```ts
+ * import { Sandbox } from '@agnt5/sdk';
+ *
+ * const sandbox = new Sandbox({ endpoint: 'http://localhost:8080' });
+ * const result = await sandbox.executeCode('console.log("hello")', 'javascript');
+ * console.log(result.stdout); // "hello"
+ * ```
+ */
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ── Native binding loader ──────────────────────────────────────
+let _native = null;
+function loadNative() {
+    if (_native)
+        return _native;
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const require = createRequire(import.meta.url);
+    const paths = [
+        join(__dirname, '../../native/agnt5-sdk-native.darwin-arm64.node'),
+        join(__dirname, '../native/agnt5-sdk-native.darwin-arm64.node'),
+        join(__dirname, '../../native/agnt5-sdk-native.linux-x64-gnu.node'),
+        join(__dirname, '../native/agnt5-sdk-native.linux-x64-gnu.node'),
+        join(__dirname, '../../native/agnt5-sdk-native.linux-x64.node'),
+        join(__dirname, '../native/agnt5-sdk-native.linux-x64.node'),
+    ];
+    for (const p of paths) {
+        try {
+            _native = require(p);
+            return _native;
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error('Could not find native sandbox bindings');
+}
+// ── NAPI → TS field mapping helpers ────────────────────────────
+function mapExecuteResult(r) {
+    return {
+        stdout: r.stdout,
+        stderr: r.stderr,
+        exitCode: r.exit_code ?? r.exitCode,
+        executionTimeMs: r.execution_time_ms ?? r.executionTimeMs,
+        error: r.error ?? undefined,
+    };
+}
+function mapWriteResult(r) {
+    return {
+        success: r.success,
+        path: r.path,
+        size: r.size,
+        error: r.error ?? undefined,
+    };
+}
+function mapReadResult(r) {
+    return {
+        path: r.path,
+        content: r.content,
+        size: r.size,
+        isDir: r.is_dir ?? r.isDir,
+        error: r.error ?? undefined,
+    };
+}
+function mapFileInfo(f) {
+    return {
+        name: f.name,
+        path: f.path,
+        size: f.size,
+        isDir: f.is_dir ?? f.isDir,
+        mode: f.mode,
+        modTime: f.mod_time ?? f.modTime,
+    };
+}
+function mapListResult(r) {
+    return {
+        path: r.path,
+        total: r.total,
+        files: (r.files ?? []).map(mapFileInfo),
+        error: r.error ?? undefined,
+    };
+}
+function mapHealthResult(r) {
+    return {
+        status: r.status,
+        sandboxId: r.sandbox_id ?? r.sandboxId,
+        uptimeMs: r.uptime_ms ?? r.uptimeMs,
+        backendKind: r.backend_kind ?? r.backendKind,
+        error: r.error ?? undefined,
+    };
+}
+function mapCapabilities(c) {
+    return {
+        languages: c.languages,
+        supportsCommands: c.supports_commands ?? c.supportsCommands,
+        supportsGit: c.supports_git ?? c.supportsGit,
+        supportsPreviewUrl: c.supports_preview_url ?? c.supportsPreviewUrl,
+        supportsStreaming: c.supports_streaming ?? c.supportsStreaming,
+        supportsSnapshots: c.supports_snapshots ?? c.supportsSnapshots,
+        hasNetworkAccess: c.has_network_access ?? c.hasNetworkAccess,
+    };
+}
+// ── Sandbox class ──────────────────────────────────────────────
+export class Sandbox {
+    constructor(options) {
+        const native = loadNative();
+        const nativeOpts = options
+            ? {
+                backend: options.backend,
+                endpoint: options.endpoint ?? process.env.AGNT5_SANDBOX_ENDPOINT,
+                sandbox_id: options.sandboxId,
+                api_key: options.apiKey,
+                bearer_token: options.bearerToken,
+                timeout_secs: options.timeoutSecs,
+                quickjs_wasm_path: options.quickjsWasmPath,
+            }
+            : undefined;
+        this.inner = new native.Sandbox(nativeOpts);
+    }
+    /** Active backend type ("remote" or "wasm"). */
+    get backend() {
+        return this.inner.backend;
+    }
+    /** Execute code in a sandboxed environment. */
+    async executeCode(code, language, timeoutMs) {
+        const r = await this.inner.executeCode(code, language, timeoutMs);
+        return mapExecuteResult(r);
+    }
+    /** Write a file into the sandbox workspace. */
+    async writeFile(path, content) {
+        const buf = typeof content === 'string' ? Buffer.from(content) : content;
+        const r = await this.inner.writeFile(path, buf);
+        return mapWriteResult(r);
+    }
+    /** Read a file from the sandbox workspace. */
+    async readFile(path) {
+        const r = await this.inner.readFile(path);
+        return mapReadResult(r);
+    }
+    /** Delete a file or directory from the sandbox workspace. */
+    async deleteFile(path, recursive) {
+        return this.inner.deleteFile(path, recursive);
+    }
+    /** List files in the sandbox workspace. */
+    async listFiles(path, recursive) {
+        const r = await this.inner.listFiles(path, recursive);
+        return mapListResult(r);
+    }
+    /** Check sandbox health and status. */
+    async health() {
+        const r = await this.inner.health();
+        return mapHealthResult(r);
+    }
+    /** Query sandbox capabilities (languages, features). */
+    capabilities() {
+        return mapCapabilities(this.inner.capabilities());
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/schema-utils.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Schema conversion utilities for structured output support.
+ *
+ * This module provides utilities to convert TypeScript schemas (Zod, TypeBox, or manual)
+ * to JSON Schema format for LLM structured output generation, function signatures,
+ * and tool definitions.
+ */
+import type { JSONSchema } from './types.js';
+/**
+ * Schema format types supported by the SDK
+ */
+export type SchemaFormat = 'zod' | 'typebox' | 'raw';
+/**
+ * Options for schema conversion
+ */
+export interface SchemaConversionOptions {
+    /** Include descriptions in the schema */
+    includeDescriptions?: boolean;
+    /** Strict mode (additionalProperties: false) */
+    strict?: boolean;
+}
+/**
+ * Auto-detect format type and convert to JSON schema.
+ *
+ * @param schema - Zod schema, TypeBox schema, or JSON schema object
+ * @param options - Conversion options
+ * @returns Tuple of [format_type, json_schema]
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { detectFormatType } from '@agnt5/sdk';
+ *
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   age: z.number(),
+ * });
+ *
+ * const [format, schema] = detectFormatType(UserSchema);
+ * // format: 'zod'
+ * // schema: { type: 'object', properties: { ... }, required: ['name', 'age'] }
+ * ```
+ */
+export declare function detectFormatType(schema: any, options?: SchemaConversionOptions): [SchemaFormat, JSONSchema];
+/**
+ * Check if value is a Zod schema
+ */
+export declare function isZodSchema(value: any): boolean;
+/**
+ * Check if value is a TypeBox schema
+ */
+export declare function isTypeBoxSchema(value: any): boolean;
+/**
+ * Check if value is a raw JSON schema
+ */
+export declare function isJsonSchema(value: any): boolean;
+/**
+ * Convert Zod schema to JSON Schema.
+ *
+ * @param schema - Zod schema
+ * @param options - Conversion options
+ * @returns JSON Schema object
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *   name: z.string().describe('User name'),
+ *   age: z.number().int().positive(),
+ *   email: z.string().email().optional(),
+ * });
+ *
+ * const jsonSchema = zodToJsonSchema(schema);
+ * ```
+ */
+export declare function zodToJsonSchema(schema: any, options?: SchemaConversionOptions): JSONSchema;
+/**
+ * Convert TypeBox schema to JSON Schema.
+ *
+ * TypeBox schemas are already JSON Schema compatible, so this is mostly a pass-through.
+ *
+ * @param schema - TypeBox schema
+ * @param options - Conversion options
+ * @returns JSON Schema object
+ *
+ * @example
+ * ```typescript
+ * import { Type } from '@sinclair/typebox';
+ *
+ * const schema = Type.Object({
+ *   name: Type.String(),
+ *   age: Type.Number(),
+ * });
+ *
+ * const jsonSchema = typeBoxToJsonSchema(schema);
+ * ```
+ */
+export declare function typeBoxToJsonSchema(schema: any, options?: SchemaConversionOptions): JSONSchema;
+/**
+ * Convert basic TypeScript types to JSON Schema types.
+ *
+ * This is a utility for manual schema generation when you don't want to use Zod or TypeBox.
+ *
+ * @param typeName - TypeScript type name ('string', 'number', 'boolean', etc.)
+ * @param options - Additional schema options
+ * @returns JSON Schema type definition
+ *
+ * @example
+ * ```typescript
+ * const stringSchema = typeToSchema('string', { description: 'User name' });
+ * // { type: 'string', description: 'User name' }
+ *
+ * const arraySchema = typeToSchema('array', { items: { type: 'number' } });
+ * // { type: 'array', items: { type: 'number' } }
+ * ```
+ */
+export declare function typeToSchema(typeName: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null', options?: Partial<JSONSchema>): JSONSchema;
+/**
+ * Create an object schema from property definitions.
+ *
+ * @param properties - Object property definitions
+ * @param required - Array of required property names
+ * @param options - Additional schema options
+ * @returns JSON Schema object definition
+ *
+ * @example
+ * ```typescript
+ * const userSchema = createObjectSchema({
+ *   name: { type: 'string', description: 'User name' },
+ *   age: { type: 'number', minimum: 0 },
+ *   email: { type: 'string', format: 'email' },
+ * }, ['name', 'age']);
+ * ```
+ */
+export declare function createObjectSchema(properties: Record<string, JSONSchema>, required?: string[], options?: Partial<JSONSchema>): JSONSchema;
+/**
+ * Create an array schema with item type.
+ *
+ * @param items - Schema for array items
+ * @param options - Additional schema options
+ * @returns JSON Schema array definition
+ *
+ * @example
+ * ```typescript
+ * const numbersSchema = createArraySchema({ type: 'number' });
+ * const usersSchema = createArraySchema({
+ *   type: 'object',
+ *   properties: {
+ *     name: { type: 'string' },
+ *     age: { type: 'number' },
+ *   },
+ * });
+ * ```
+ */
+export declare function createArraySchema(items: JSONSchema, options?: Partial<JSONSchema>): JSONSchema;
+/**
+ * Create an enum schema.
+ *
+ * @param values - Allowed enum values
+ * @param options - Additional schema options
+ * @returns JSON Schema enum definition
+ *
+ * @example
+ * ```typescript
+ * const statusSchema = createEnumSchema(['pending', 'active', 'completed']);
+ * const roleSchema = createEnumSchema(['admin', 'user', 'guest'], {
+ *   description: 'User role',
+ * });
+ * ```
+ */
+export declare function createEnumSchema(values: any[], options?: Partial<JSONSchema>): JSONSchema;
+/**
+ * Create a union schema (anyOf).
+ *
+ * @param schemas - Array of possible schemas
+ * @param options - Additional schema options
+ * @returns JSON Schema union definition
+ *
+ * @example
+ * ```typescript
+ * const stringOrNumber = createUnionSchema([
+ *   { type: 'string' },
+ *   { type: 'number' },
+ * ]);
+ * ```
+ */
+export declare function createUnionSchema(schemas: JSONSchema[], options?: Partial<JSONSchema>): JSONSchema;
+/**
+ * Make a schema optional (allows null).
+ *
+ * @param schema - Base schema
+ * @returns Schema that allows the base type or null
+ *
+ * @example
+ * ```typescript
+ * const optionalString = makeOptional({ type: 'string' });
+ * // { anyOf: [{ type: 'string' }, { type: 'null' }] }
+ * ```
+ */
+export declare function makeOptional(schema: JSONSchema): JSONSchema;
+/**
+ * Merge multiple schemas into one (allOf).
+ *
+ * @param schemas - Array of schemas to merge
+ * @returns Merged schema
+ *
+ * @example
+ * ```typescript
+ * const baseSchema = { type: 'object', properties: { id: { type: 'string' } } };
+ * const extraSchema = { properties: { name: { type: 'string' } } };
+ * const merged = mergeSchemas([baseSchema, extraSchema]);
+ * ```
+ */
+export declare function mergeSchemas(schemas: JSONSchema[]): JSONSchema;
+/**
+ * Validate a value against a JSON schema.
+ *
+ * This is a basic validator. For production use, consider using a dedicated library like Ajv.
+ *
+ * @param value - Value to validate
+ * @param schema - JSON Schema to validate against
+ * @returns True if valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const schema = { type: 'object', properties: { name: { type: 'string' } } };
+ * validateSchema({ name: 'Alice' }, schema); // true
+ * validateSchema({ name: 123 }, schema); // false
+ * ```
+ */
+export declare function validateSchema(value: any, schema: JSONSchema): boolean;
+/**
+ * Extract description from JSDoc comment.
+ *
+ * @param func - Function to extract description from
+ * @returns Description string or undefined
+ *
+ * @example
+ * ```typescript
+ * /​**
+ *  * This is a greeting function
+ *  *​/
+ * function greet(name: string) { ... }
+ *
+ * extractFunctionDescription(greet); // 'This is a greeting function'
+ * ```
+ */
+export declare function extractFunctionDescription(func: Function): string | undefined;
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schema-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.d.ts","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,EACX,OAAO,GAAE,uBAA4B,GACpC,CAAC,YAAY,EAAE,UAAU,CAAC,CAmB5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAG/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEhD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAoB9F;AAoED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAclG;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,EACnF,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAChC,UAAU,CAKZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAChC,UAAU,CAOZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAMlG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAM7F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAKtG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAI3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CAI9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAetE;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAQ7E"}