digital-tools 2.0.1

package/dist/tools/web.js

@@ -0,0 +1,138 @@
+/**
+ * Web Tools - HTTP, scraping, browser automation
+ *
+ * @packageDocumentation
+ */
+import { defineTool } from '../define.js';
+/**
+ * Fetch content from a URL
+ */
+export const fetchUrl = defineTool({
+    id: 'web.fetch',
+    name: 'Fetch URL',
+    description: 'Fetch content from a URL using HTTP',
+    category: 'web',
+    subcategory: 'fetch',
+    input: {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'URL to fetch' },
+            method: { type: 'string', description: 'HTTP method (default: GET)', enum: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'] },
+            headers: { type: 'object', description: 'Request headers' },
+            body: { type: 'string', description: 'Request body (for POST/PUT/PATCH)' },
+        },
+        required: ['url'],
+    },
+    handler: async (input) => {
+        const response = await fetch(input.url, {
+            method: input.method || 'GET',
+            headers: input.headers,
+            body: input.body,
+        });
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return {
+            status: response.status,
+            headers,
+            body: await response.text(),
+        };
+    },
+    options: {
+        audience: 'both',
+        tags: ['http', 'network', 'api'],
+    },
+});
+/**
+ * Parse HTML and extract content
+ */
+export const parseHtml = defineTool({
+    id: 'web.parse-html',
+    name: 'Parse HTML',
+    description: 'Parse HTML content and extract text, links, and images',
+    category: 'web',
+    subcategory: 'scrape',
+    input: {
+        type: 'object',
+        properties: {
+            html: { type: 'string', description: 'HTML content to parse' },
+            selector: { type: 'string', description: 'CSS selector to filter content (optional)' },
+        },
+        required: ['html'],
+    },
+    handler: async (input) => {
+        // Basic HTML parsing without DOM (would use cheerio or jsdom in production)
+        const text = input.html.replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ').trim();
+        // Extract links
+        const linkRegex = /href="([^"]+)"/g;
+        const links = [];
+        let match;
+        while ((match = linkRegex.exec(input.html)) !== null) {
+            links.push(match[1]);
+        }
+        // Extract images
+        const imgRegex = /src="([^"]+)"/g;
+        const images = [];
+        while ((match = imgRegex.exec(input.html)) !== null) {
+            if (match[1].match(/\.(jpg|jpeg|png|gif|webp|svg)/i)) {
+                images.push(match[1]);
+            }
+        }
+        return { text, links, images };
+    },
+    options: {
+        audience: 'both',
+        tags: ['html', 'parse', 'extract'],
+    },
+});
+/**
+ * Read content from a URL (combines fetch + parse)
+ */
+export const readUrl = defineTool({
+    id: 'web.read',
+    name: 'Read URL',
+    description: 'Read and extract content from a webpage',
+    category: 'web',
+    subcategory: 'scrape',
+    input: {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'URL to read' },
+        },
+        required: ['url'],
+    },
+    handler: async (input) => {
+        const response = await fetch(input.url);
+        const html = await response.text();
+        // Extract title
+        const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+        const title = titleMatch ? titleMatch[1].trim() : '';
+        // Extract body text
+        const bodyMatch = html.match(/<body[^>]*>([\s\S]*)<\/body>/i);
+        const body = bodyMatch ? bodyMatch[1] : html;
+        const text = body.replace(/<script[\s\S]*?<\/script>/gi, '')
+            .replace(/<style[\s\S]*?<\/style>/gi, '')
+            .replace(/<[^>]*>/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        // Extract links
+        const linkRegex = /href="(https?:\/\/[^"]+)"/g;
+        const links = [];
+        let match;
+        while ((match = linkRegex.exec(html)) !== null) {
+            links.push(match[1]);
+        }
+        return { title, text: text.slice(0, 10000), links: [...new Set(links)] };
+    },
+    options: {
+        audience: 'both',
+        tags: ['read', 'scrape', 'extract'],
+        idempotent: true,
+    },
+});
+/**
+ * All web tools
+ */
+export const webTools = [fetchUrl, parseHtml, readUrl];
+//# sourceMappingURL=web.js.map

package/dist/tools/web.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,330 @@
+/**
+ * Types for digital-tools
+ *
+ * Core types for tools that can be used by both humans and AI agents.
+ * This package provides the foundational tool primitives used across
+ * autonomous-agents, human-in-the-loop, and services-as-software.
+ *
+ * @packageDocumentation
+ */
+import type { JSONSchema } from 'ai-functions';
+import type { z } from 'zod';
+/**
+ * High-level tool categories - the primary classification
+ */
+export type ToolCategory = 'communication' | 'data' | 'development' | 'documents' | 'finance' | 'integration' | 'knowledge' | 'media' | 'productivity' | 'security' | 'system' | 'web';
+/**
+ * Communication subcategories
+ */
+export type CommunicationSubcategory = 'email' | 'sms' | 'channel' | 'workspace' | 'direct-message' | 'chat' | 'notification' | 'voice' | 'video-call' | 'slack' | 'discord' | 'teams';
+/**
+ * Data subcategories
+ */
+export type DataSubcategory = 'database' | 'cache' | 'queue' | 'stream' | 'vector-store' | 'object-storage' | 'transform' | 'validate';
+/**
+ * Development subcategories
+ */
+export type DevelopmentSubcategory = 'code-edit' | 'code-execute' | 'git' | 'ci-cd' | 'deploy' | 'test' | 'debug' | 'lint' | 'format' | 'docs';
+/**
+ * Documents subcategories
+ */
+export type DocumentsSubcategory = 'pdf' | 'spreadsheet' | 'presentation' | 'word-processor' | 'markdown' | 'diagram' | 'convert';
+/**
+ * Finance subcategories
+ */
+export type FinanceSubcategory = 'payment' | 'invoice' | 'accounting' | 'expense' | 'payroll' | 'tax' | 'subscription';
+/**
+ * Integration subcategories
+ */
+export type IntegrationSubcategory = 'api' | 'webhook' | 'oauth' | 'graphql' | 'grpc' | 'soap' | 'rpc';
+/**
+ * Knowledge subcategories
+ */
+export type KnowledgeSubcategory = 'search' | 'rag' | 'embedding' | 'knowledge-graph' | 'wiki' | 'faq' | 'semantic-search';
+/**
+ * Media subcategories
+ */
+export type MediaSubcategory = 'image-generate' | 'image-edit' | 'video-generate' | 'video-edit' | 'audio-generate' | 'audio-transcribe' | 'ocr' | 'screenshot';
+/**
+ * Productivity subcategories
+ */
+export type ProductivitySubcategory = 'calendar' | 'task' | 'note' | 'reminder' | 'time-tracking' | 'project-management' | 'crm';
+/**
+ * Security subcategories
+ */
+export type SecuritySubcategory = 'auth' | 'encrypt' | 'hash' | 'sign' | 'access-control' | 'secrets' | 'audit';
+/**
+ * System subcategories
+ */
+export type SystemSubcategory = 'shell' | 'filesystem' | 'process' | 'network' | 'environment' | 'cron' | 'monitor';
+/**
+ * Web subcategories
+ */
+export type WebSubcategory = 'fetch' | 'scrape' | 'browser' | 'dom' | 'screenshot' | 'pdf-capture' | 'api-client';
+/**
+ * Combined subcategory type
+ */
+export type ToolSubcategory = CommunicationSubcategory | DataSubcategory | DevelopmentSubcategory | DocumentsSubcategory | FinanceSubcategory | IntegrationSubcategory | KnowledgeSubcategory | MediaSubcategory | ProductivitySubcategory | SecuritySubcategory | SystemSubcategory | WebSubcategory;
+/**
+ * Who can use this tool
+ */
+export type ToolAudience = 'agent' | 'human' | 'both';
+/**
+ * Permission required to use this tool
+ */
+export interface ToolPermission {
+    /** Permission type */
+    type: 'read' | 'write' | 'execute' | 'admin' | 'custom';
+    /** Resource the permission applies to */
+    resource?: string;
+    /** Custom permission name */
+    name?: string;
+    /** Permission scope */
+    scope?: string;
+}
+/**
+ * Security classification for the tool
+ */
+export type SecurityLevel = 'public' | 'internal' | 'confidential' | 'restricted';
+/**
+ * Rate limiting configuration
+ */
+export interface RateLimit {
+    /** Maximum calls per period */
+    maxCalls: number;
+    /** Time period in seconds */
+    periodSeconds: number;
+    /** Per-user or global */
+    scope?: 'user' | 'global' | 'organization';
+}
+/**
+ * Schema definition - supports both JSON Schema and Zod
+ */
+export type Schema = JSONSchema | z.ZodType;
+/**
+ * Tool parameter definition
+ */
+export interface ToolParameter {
+    /** Parameter name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Parameter type schema */
+    schema: Schema;
+    /** Whether parameter is required */
+    required?: boolean;
+    /** Default value */
+    default?: unknown;
+    /** Example values */
+    examples?: unknown[];
+}
+/**
+ * Tool output definition
+ */
+export interface ToolOutput {
+    /** Output description */
+    description: string;
+    /** Output schema */
+    schema: Schema;
+    /** Whether the tool streams output */
+    streaming?: boolean;
+}
+/**
+ * Core Tool definition - the foundational type
+ *
+ * Tools can be used by both humans and AI agents. They provide
+ * a standardized interface for performing actions.
+ */
+export interface Tool<TInput = unknown, TOutput = unknown> {
+    /** Unique tool identifier (e.g., 'communication.email.send') */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detailed description of what the tool does */
+    description: string;
+    /** Tool version (semver) */
+    version?: string;
+    /** Primary category */
+    category: ToolCategory;
+    /** Subcategory for more specific classification */
+    subcategory?: ToolSubcategory;
+    /** Tags for additional classification */
+    tags?: string[];
+    /** Who can use this tool */
+    audience?: ToolAudience;
+    /** Required permissions */
+    permissions?: ToolPermission[];
+    /** Security classification */
+    securityLevel?: SecurityLevel;
+    /** Rate limiting */
+    rateLimit?: RateLimit;
+    /** Input parameters */
+    parameters: ToolParameter[];
+    /** Output definition */
+    output?: ToolOutput;
+    /** The tool implementation */
+    handler: (input: TInput) => TOutput | Promise<TOutput>;
+    /** Tool author/owner */
+    author?: string;
+    /** Documentation URL */
+    docsUrl?: string;
+    /** Whether this tool requires human confirmation */
+    requiresConfirmation?: boolean;
+    /** Whether this tool is idempotent */
+    idempotent?: boolean;
+    /** Estimated execution time in ms */
+    estimatedDuration?: number;
+    /** Cost per execution (for billing) */
+    costPerExecution?: number;
+}
+/**
+ * Any tool type - used for arrays and collections of tools
+ * with different input/output types
+ */
+export type AnyTool = Tool<any, any>;
+/**
+ * Options for defining a tool
+ */
+export interface DefineToolOptions<TInput, TOutput> {
+    /** Tool ID */
+    id: string;
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Primary category */
+    category: ToolCategory;
+    /** Subcategory */
+    subcategory?: ToolSubcategory;
+    /** Input schema (Zod or JSON Schema) */
+    input: Schema;
+    /** Output schema (optional) */
+    output?: Schema;
+    /** The handler function */
+    handler: (input: TInput) => TOutput | Promise<TOutput>;
+    /** Additional options */
+    options?: Partial<Omit<Tool<TInput, TOutput>, 'id' | 'name' | 'description' | 'category' | 'parameters' | 'handler'>>;
+}
+/**
+ * Tool execution context
+ */
+export interface ToolContext {
+    /** Who is executing the tool */
+    executor: {
+        type: 'agent' | 'human';
+        id: string;
+        name?: string;
+    };
+    /** Request ID for tracing */
+    requestId?: string;
+    /** Organization ID */
+    organizationId?: string;
+    /** User ID (if human or on behalf of) */
+    userId?: string;
+    /** Environment */
+    environment?: 'development' | 'staging' | 'production';
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool execution result
+ */
+export interface ToolResult<TOutput = unknown> {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output data */
+    data?: TOutput;
+    /** Error if failed */
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    /** Execution metadata */
+    metadata?: {
+        /** Duration in ms */
+        duration: number;
+        /** Tokens used (if AI tool) */
+        tokensUsed?: number;
+        /** Cost incurred */
+        cost?: number;
+        /** Request ID */
+        requestId?: string;
+    };
+}
+/**
+ * Options for querying tools
+ */
+export interface ToolQuery {
+    /** Filter by category */
+    category?: ToolCategory;
+    /** Filter by subcategory */
+    subcategory?: ToolSubcategory;
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by audience */
+    audience?: ToolAudience;
+    /** Text search */
+    search?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Tool registry interface
+ */
+export interface ToolRegistry {
+    /** Register a tool */
+    register(tool: AnyTool): void;
+    /** Unregister a tool */
+    unregister(id: string): boolean;
+    /** Get a tool by ID */
+    get(id: string): AnyTool | undefined;
+    /** Check if a tool exists */
+    has(id: string): boolean;
+    /** List all tool IDs */
+    list(): string[];
+    /** Query tools */
+    query(options: ToolQuery): AnyTool[];
+    /** Get tools by category */
+    byCategory(category: ToolCategory): AnyTool[];
+    /** Clear all tools */
+    clear(): void;
+}
+/**
+ * MCP-compatible tool definition
+ * Model Context Protocol standard format
+ */
+export interface MCPTool {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Input schema as JSON Schema */
+    inputSchema: JSONSchema;
+}
+/**
+ * MCP tool call request
+ */
+export interface MCPToolCall {
+    /** Tool name */
+    name: string;
+    /** Arguments */
+    arguments: Record<string, unknown>;
+}
+/**
+ * MCP tool call result
+ */
+export interface MCPToolResult {
+    /** Result content */
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    /** Whether this is an error */
+    isError?: boolean;
+}
+//# 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/types.js

@@ -0,0 +1,11 @@
+/**
+ * Types for digital-tools
+ *
+ * Core types for tools that can be used by both humans and AI agents.
+ * This package provides the foundational tool primitives used across
+ * autonomous-agents, human-in-the-loop, and services-as-software.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "digital-tools",
+  "version": "2.0.1",
+  "description": "Tools that can be used by both humans and AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/providers/types.js",
+      "types": "./dist/providers/types.d.ts"
+    },
+    "./registry": {
+      "import": "./dist/registry.js",
+      "types": "./dist/registry.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "ai-database": "workspace:*",
+    "ai-functions": "workspace:*",
+    "rpc.do": "^0.1.0",
+    "zod": "^3.23.0"
+  },
+  "keywords": [
+    "ai",
+    "tools",
+    "agents",
+    "humans",
+    "primitives",
+    "mcp"
+  ],
+  "license": "MIT"
+}