@mondaydotcomorg/atp-protocol 0.17.14

package/dist/types.d.ts

@@ -0,0 +1,489 @@
+import type { ProvenanceMode, SecurityPolicy } from '@mondaydotcomorg/atp-provenance';
+export { ProvenanceMode, type SecurityPolicy } from '@mondaydotcomorg/atp-provenance';
+/**
+ * Callback types that can pause execution
+ */
+export declare enum CallbackType {
+    LLM = "llm",
+    APPROVAL = "approval",
+    EMBEDDING = "embedding",
+    TOOL = "tool"
+}
+/**
+ * Tool callback operations
+ */
+export declare enum ToolOperation {
+    CALL = "call"
+}
+export interface AgentToolProtocolRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params: Record<string, unknown>;
+}
+export interface AgentToolProtocolResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface AgentToolProtocolNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Client-provided service availability
+ */
+export interface ClientServices {
+    /** Whether client provides LLM implementation */
+    hasLLM: boolean;
+    /** Whether client provides approval handler */
+    hasApproval: boolean;
+    /** Whether client provides embedding model */
+    hasEmbedding: boolean;
+    /** Whether client provides custom tools */
+    hasTools: boolean;
+    /** Names of client-provided tools (for discovery) */
+    toolNames?: string[];
+}
+/**
+ * Client-provided LLM handler
+ */
+export interface ClientLLMHandler {
+    call: (prompt: string, options?: {
+        context?: Record<string, unknown>;
+        model?: string;
+        temperature?: number;
+        systemPrompt?: string;
+    }) => Promise<string>;
+    extract?: <T>(prompt: string, schema: Record<string, unknown>, options?: {
+        context?: Record<string, unknown>;
+    }) => Promise<T>;
+    classify?: (text: string, categories: string[], options?: {
+        context?: Record<string, unknown>;
+    }) => Promise<string>;
+}
+/**
+ * Client-provided approval handler
+ */
+export interface ClientApprovalHandler {
+    request: (message: string, context?: Record<string, unknown>) => Promise<{
+        approved: boolean;
+        response?: unknown;
+        timestamp: number;
+    }>;
+}
+/**
+ * Client-provided embedding handler
+ */
+export interface ClientEmbeddingHandler {
+    embed: (text: string) => Promise<number[]>;
+    similarity?: (text1: string, text2: string) => Promise<number>;
+}
+/**
+ * Client-provided tool handler
+ * Function that executes on the client side when a client tool is invoked
+ */
+export interface ClientToolHandler {
+    (input: unknown): Promise<unknown>;
+}
+/**
+ * Client tool definition (metadata sent to server)
+ * The actual handler function remains on the client side
+ */
+export interface ClientToolDefinition {
+    /** Tool name (unique per client session) */
+    name: string;
+    /** API namespace (e.g., 'playwright', 'browser'). Defaults to 'client' if not specified */
+    namespace?: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+    /** JSON Schema for tool input validation */
+    inputSchema: JSONSchema;
+    /** JSON Schema for tool output (optional, for documentation) */
+    outputSchema?: JSONSchema;
+    /** Tool metadata for security and risk management */
+    metadata?: ToolMetadata;
+    /** Whether this tool supports parallel execution with other tools */
+    supportsConcurrency?: boolean;
+    /** Keywords for search/discovery (optional) */
+    keywords?: string[];
+}
+/**
+ * Client tool with handler (used client-side only)
+ * Extends ClientToolDefinition to include the actual handler function
+ */
+export interface ClientTool extends ClientToolDefinition {
+    /** Handler function that executes on client side */
+    handler: ClientToolHandler;
+}
+/**
+ * Tool operation type classification
+ */
+export declare enum ToolOperationType {
+    /** Safe read-only operations */
+    READ = "read",
+    /** Operations that modify data */
+    WRITE = "write",
+    /** Operations that delete or destroy data */
+    DESTRUCTIVE = "destructive"
+}
+/**
+ * Tool sensitivity level
+ */
+export declare enum ToolSensitivityLevel {
+    /** Public data, no sensitivity concerns */
+    PUBLIC = "public",
+    /** Internal data, requires authentication */
+    INTERNAL = "internal",
+    /** Sensitive data (PII, financial data, etc.) */
+    SENSITIVE = "sensitive"
+}
+/**
+ * Client-side tool execution rules
+ * Allows clients to control which tools can be executed and under what conditions
+ */
+export interface ClientToolRules {
+    /** Block all tools of specific operation types */
+    blockOperationTypes?: ToolOperationType[];
+    /** Block all tools with specific sensitivity levels */
+    blockSensitivityLevels?: ToolSensitivityLevel[];
+    /** Require approval for specific operation types */
+    requireApprovalForOperationTypes?: ToolOperationType[];
+    /** Require approval for specific sensitivity levels */
+    requireApprovalForSensitivityLevels?: ToolSensitivityLevel[];
+    /** Block specific tools by name (e.g., ['deleteDatabase', 'dropTable']) */
+    blockTools?: string[];
+    /** Allow only specific tools by name (whitelist mode) */
+    allowOnlyTools?: string[];
+    /** Block entire API groups (e.g., ['admin', 'system']) */
+    blockApiGroups?: string[];
+    /** Allow only specific API groups (whitelist mode) */
+    allowOnlyApiGroups?: string[];
+}
+/**
+ * Tool/API metadata for security and risk management
+ *
+ * What can clients do with these annotations?
+ *
+ * 1. **Block Execution**:
+ *    - Block all WRITE operations: blockOperationTypes: [ToolOperationType.WRITE]
+ *    - Block all DESTRUCTIVE operations: blockOperationTypes: [ToolOperationType.DESTRUCTIVE]
+ *    - Block SENSITIVE data access: blockSensitivityLevels: [ToolSensitivityLevel.SENSITIVE]
+ *
+ * 2. **Require Approval**:
+ *    - Require approval for WRITE: requireApprovalForOperationTypes: [ToolOperationType.WRITE]
+ *    - Require approval for DESTRUCTIVE: requireApprovalForOperationTypes: [ToolOperationType.DESTRUCTIVE]
+ *    - Require approval for SENSITIVE: requireApprovalForSensitivityLevels: [ToolSensitivityLevel.SENSITIVE]
+ *
+ * 3. **Whitelist/Blacklist**:
+ *    - Block specific tools: blockTools: ['deleteDatabase', 'dropTable']
+ *    - Allow only safe tools: allowOnlyTools: ['getUser', 'listItems']
+ *    - Block admin APIs: blockApiGroups: ['admin', 'system']
+ *
+ * 4. **Audit & Logging**:
+ *    - Log all DESTRUCTIVE operations
+ *    - Track access to SENSITIVE data
+ *    - Monitor WRITE operations
+ *
+ * Granularity levels:
+ * - Operation Type: READ, WRITE, DESTRUCTIVE (coarse-grained)
+ * - Sensitivity Level: PUBLIC, INTERNAL, SENSITIVE (data classification)
+ * - Tool Name: Specific function names (fine-grained)
+ * - API Group: Entire namespaces (medium-grained)
+ */
+export interface ToolMetadata {
+    /** Operation type classification */
+    operationType?: ToolOperationType;
+    /** Sensitivity level of data handled */
+    sensitivityLevel?: ToolSensitivityLevel;
+    /** Require explicit approval before execution (server-side enforcement) */
+    requiresApproval?: boolean;
+    /** Category for grouping/filtering (e.g., 'database', 'user-management') */
+    category?: string;
+    /** Additional tags for classification */
+    tags?: string[];
+    /** Human-readable description of potential impact */
+    impactDescription?: string;
+    /**
+     * Required OAuth scopes to use this tool
+     * Used for scope-based filtering when user credentials have limited permissions
+     * @example ['repo', 'read:user'] for GitHub
+     * @example ['https://www.googleapis.com/auth/calendar'] for Google
+     */
+    requiredScopes?: string[];
+    /**
+     * Generic permissions required (for non-OAuth providers)
+     * @example ['admin', 'write:users']
+     */
+    requiredPermissions?: string[];
+}
+/**
+ * Client service providers
+ */
+export interface ClientServiceProviders {
+    llm?: ClientLLMHandler;
+    approval?: ClientApprovalHandler;
+    embedding?: ClientEmbeddingHandler;
+    /** Client-provided tools that execute locally */
+    tools?: ClientTool[];
+}
+export interface ExecutionConfig {
+    timeout: number;
+    maxMemory: number;
+    maxLLMCalls: number;
+    allowedAPIs: string[];
+    allowLLMCalls: boolean;
+    progressCallback?: (message: string, fraction: number) => void;
+    customLLMHandler?: (prompt: string, options?: any) => Promise<string>;
+    clientServices?: ClientServices;
+    provenanceMode?: ProvenanceMode;
+    securityPolicies?: SecurityPolicy[];
+    provenanceHints?: string[];
+}
+/**
+ * Execution status codes for fine-grained error reporting
+ */
+export declare enum ExecutionStatus {
+    COMPLETED = "completed",
+    FAILED = "failed",
+    TIMEOUT = "timeout",
+    CANCELLED = "cancelled",
+    PAUSED = "paused",
+    MEMORY_EXCEEDED = "memory_exceeded",
+    LLM_CALLS_EXCEEDED = "llm_calls_exceeded",
+    SECURITY_VIOLATION = "security_violation",
+    VALIDATION_FAILED = "validation_failed",
+    LOOP_DETECTED = "loop_detected",
+    RATE_LIMITED = "rate_limited",
+    NETWORK_ERROR = "network_error",
+    PARSE_ERROR = "parse_error"
+}
+/**
+ * Execution error codes for categorizing failures
+ */
+export declare enum ExecutionErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    MEMORY_LIMIT_EXCEEDED = "MEMORY_LIMIT_EXCEEDED",
+    LLM_CALL_LIMIT_EXCEEDED = "LLM_CALL_LIMIT_EXCEEDED",
+    HTTP_CALL_LIMIT_EXCEEDED = "HTTP_CALL_LIMIT_EXCEEDED",
+    SECURITY_VIOLATION = "SECURITY_VIOLATION",
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    FORBIDDEN_OPERATION = "FORBIDDEN_OPERATION",
+    PARSE_ERROR = "PARSE_ERROR",
+    SYNTAX_ERROR = "SYNTAX_ERROR",
+    TYPE_ERROR = "TYPE_ERROR",
+    REFERENCE_ERROR = "REFERENCE_ERROR",
+    INFINITE_LOOP_DETECTED = "INFINITE_LOOP_DETECTED",
+    LOOP_TIMEOUT = "LOOP_TIMEOUT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    HTTP_ERROR = "HTTP_ERROR",
+    DNS_ERROR = "DNS_ERROR",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    CONCURRENT_LIMIT_EXCEEDED = "CONCURRENT_LIMIT_EXCEEDED"
+}
+export interface ExecutionResult {
+    executionId: string;
+    status: ExecutionStatus;
+    result?: unknown;
+    error?: {
+        message: string;
+        code?: ExecutionErrorCode;
+        stack?: string;
+        line?: number;
+        context?: Record<string, unknown>;
+        retryable?: boolean;
+        suggestion?: string;
+    };
+    stats: {
+        duration: number;
+        memoryUsed: number;
+        llmCallsCount: number;
+        approvalCallsCount: number;
+        statementsExecuted?: number;
+        statementsCached?: number;
+    };
+    needsCallback?: {
+        type: CallbackType;
+        operation: string;
+        payload: Record<string, unknown>;
+    };
+    needsCallbacks?: BatchCallbackRequest[];
+    callbackHistory?: Array<{
+        type: CallbackType;
+        operation: string;
+        payload: Record<string, unknown>;
+        result?: unknown;
+        timestamp: number;
+        sequenceNumber: number;
+    }>;
+    transformedCode?: string;
+    provenanceSnapshot?: unknown;
+    provenanceTokens?: Array<{
+        path: string;
+        token: string;
+    }>;
+}
+/**
+ * Batch callback request for parallel execution
+ */
+export interface BatchCallbackRequest {
+    /** Unique callback ID */
+    id: string;
+    /** Callback type */
+    type: CallbackType;
+    /** Operation name */
+    operation: string;
+    /** Operation payload */
+    payload: Record<string, unknown>;
+}
+/**
+ * Batch callback result from client
+ */
+export interface BatchCallbackResult {
+    /** Callback ID (matches BatchCallbackRequest.id) */
+    id: string;
+    /** Callback result */
+    result: unknown;
+}
+export interface SearchOptions {
+    query: string;
+    apiGroups?: string[];
+    maxResults?: number;
+    useEmbeddings?: boolean;
+    embeddingModel?: string;
+}
+export interface SearchResult {
+    apiGroup: string;
+    functionName: string;
+    description: string;
+    signature: string;
+    example?: string;
+    relevanceScore: number;
+}
+export interface ExploreRequest {
+    path: string;
+}
+export interface ExploreDirectoryResult {
+    type: 'directory';
+    path: string;
+    items: Array<{
+        name: string;
+        type: 'directory' | 'function';
+    }>;
+}
+export interface ExploreFunctionResult {
+    type: 'function';
+    path: string;
+    name: string;
+    description: string;
+    definition: string;
+    group: string;
+}
+export type ExploreResult = ExploreDirectoryResult | ExploreFunctionResult;
+export interface ValidationResult {
+    valid: boolean;
+    errors?: ValidationError[];
+    warnings?: ValidationError[];
+    securityIssues?: SecurityIssue[];
+}
+export interface ValidationError {
+    line: number;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface SecurityIssue {
+    line: number;
+    issue: string;
+    risk: 'low' | 'medium' | 'high';
+}
+export interface APISource {
+    type: 'mcp' | 'openapi' | 'custom';
+    name: string;
+    url?: string;
+    spec?: unknown;
+}
+export interface ServerConfig {
+    apiGroups: APIGroupConfig[];
+    security: SecurityConfig;
+    execution: ExecutionLimits;
+    search: SearchConfig;
+    logging: LoggingConfig;
+}
+export interface APIGroupConfig {
+    name: string;
+    type: 'mcp' | 'openapi' | 'custom';
+    url?: string;
+    spec?: unknown;
+    functions?: CustomFunctionDef[];
+    /** Authentication configuration for this API group */
+    auth?: import('./auth.js').AuthConfig;
+}
+export interface SecurityConfig {
+    allowedOrigins: string[];
+    apiKeyRequired: boolean;
+    rateLimits: {
+        requestsPerMinute: number;
+        executionsPerHour: number;
+    };
+}
+export interface ExecutionLimits {
+    defaultTimeout: number;
+    maxTimeout: number;
+    defaultMemoryLimit: number;
+    maxMemoryLimit: number;
+    defaultLLMCallLimit: number;
+    maxLLMCallLimit: number;
+}
+export interface SearchConfig {
+    enableEmbeddings: boolean;
+    embeddingProvider?: 'openai' | 'cohere' | 'custom';
+    customSearcher?: (query: string) => Promise<SearchResult[]>;
+}
+export interface LoggingConfig {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    destination: 'console' | 'file' | 'remote';
+    auditEnabled: boolean;
+}
+export interface CustomFunctionDef {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+    handler: (params: unknown) => Promise<unknown>;
+    keywords?: string[];
+    metadata?: ToolMetadata;
+    requiredScopes?: string[];
+    auth?: {
+        source?: 'server' | 'user';
+        oauthProvider?: string;
+    };
+}
+export interface JSONSchema {
+    type: string;
+    properties?: Record<string, unknown>;
+    required?: string[];
+    [key: string]: unknown;
+}
+export interface ClientConfig {
+    serverUrl: string;
+    apiKey: string;
+    timeout?: number;
+    llmProvider: 'anthropic' | 'openai' | 'custom';
+    llmModel?: string;
+    temperature?: number;
+    defaultExecutionConfig?: Partial<ExecutionConfig>;
+    searchPreferences?: {
+        useEmbeddings?: boolean;
+        embeddingModel?: string;
+        maxResults?: number;
+    };
+}
+//# 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,88 @@
+export { ProvenanceMode } from '@mondaydotcomorg/atp-provenance';
+/**
+ * Callback types that can pause execution
+ */
+export var CallbackType;
+(function (CallbackType) {
+    CallbackType["LLM"] = "llm";
+    CallbackType["APPROVAL"] = "approval";
+    CallbackType["EMBEDDING"] = "embedding";
+    CallbackType["TOOL"] = "tool";
+})(CallbackType || (CallbackType = {}));
+/**
+ * Tool callback operations
+ */
+export var ToolOperation;
+(function (ToolOperation) {
+    ToolOperation["CALL"] = "call";
+})(ToolOperation || (ToolOperation = {}));
+/**
+ * Tool operation type classification
+ */
+export var ToolOperationType;
+(function (ToolOperationType) {
+    /** Safe read-only operations */
+    ToolOperationType["READ"] = "read";
+    /** Operations that modify data */
+    ToolOperationType["WRITE"] = "write";
+    /** Operations that delete or destroy data */
+    ToolOperationType["DESTRUCTIVE"] = "destructive";
+})(ToolOperationType || (ToolOperationType = {}));
+/**
+ * Tool sensitivity level
+ */
+export var ToolSensitivityLevel;
+(function (ToolSensitivityLevel) {
+    /** Public data, no sensitivity concerns */
+    ToolSensitivityLevel["PUBLIC"] = "public";
+    /** Internal data, requires authentication */
+    ToolSensitivityLevel["INTERNAL"] = "internal";
+    /** Sensitive data (PII, financial data, etc.) */
+    ToolSensitivityLevel["SENSITIVE"] = "sensitive";
+})(ToolSensitivityLevel || (ToolSensitivityLevel = {}));
+/**
+ * Execution status codes for fine-grained error reporting
+ */
+export var ExecutionStatus;
+(function (ExecutionStatus) {
+    ExecutionStatus["COMPLETED"] = "completed";
+    ExecutionStatus["FAILED"] = "failed";
+    ExecutionStatus["TIMEOUT"] = "timeout";
+    ExecutionStatus["CANCELLED"] = "cancelled";
+    ExecutionStatus["PAUSED"] = "paused";
+    ExecutionStatus["MEMORY_EXCEEDED"] = "memory_exceeded";
+    ExecutionStatus["LLM_CALLS_EXCEEDED"] = "llm_calls_exceeded";
+    ExecutionStatus["SECURITY_VIOLATION"] = "security_violation";
+    ExecutionStatus["VALIDATION_FAILED"] = "validation_failed";
+    ExecutionStatus["LOOP_DETECTED"] = "loop_detected";
+    ExecutionStatus["RATE_LIMITED"] = "rate_limited";
+    ExecutionStatus["NETWORK_ERROR"] = "network_error";
+    ExecutionStatus["PARSE_ERROR"] = "parse_error";
+})(ExecutionStatus || (ExecutionStatus = {}));
+/**
+ * Execution error codes for categorizing failures
+ */
+export var ExecutionErrorCode;
+(function (ExecutionErrorCode) {
+    ExecutionErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    ExecutionErrorCode["EXECUTION_FAILED"] = "EXECUTION_FAILED";
+    ExecutionErrorCode["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+    ExecutionErrorCode["MEMORY_LIMIT_EXCEEDED"] = "MEMORY_LIMIT_EXCEEDED";
+    ExecutionErrorCode["LLM_CALL_LIMIT_EXCEEDED"] = "LLM_CALL_LIMIT_EXCEEDED";
+    ExecutionErrorCode["HTTP_CALL_LIMIT_EXCEEDED"] = "HTTP_CALL_LIMIT_EXCEEDED";
+    ExecutionErrorCode["SECURITY_VIOLATION"] = "SECURITY_VIOLATION";
+    ExecutionErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ExecutionErrorCode["FORBIDDEN_OPERATION"] = "FORBIDDEN_OPERATION";
+    ExecutionErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+    ExecutionErrorCode["SYNTAX_ERROR"] = "SYNTAX_ERROR";
+    ExecutionErrorCode["TYPE_ERROR"] = "TYPE_ERROR";
+    ExecutionErrorCode["REFERENCE_ERROR"] = "REFERENCE_ERROR";
+    ExecutionErrorCode["INFINITE_LOOP_DETECTED"] = "INFINITE_LOOP_DETECTED";
+    ExecutionErrorCode["LOOP_TIMEOUT"] = "LOOP_TIMEOUT";
+    ExecutionErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ExecutionErrorCode["HTTP_ERROR"] = "HTTP_ERROR";
+    ExecutionErrorCode["DNS_ERROR"] = "DNS_ERROR";
+    ExecutionErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    ExecutionErrorCode["CONCURRENT_LIMIT_EXCEEDED"] = "CONCURRENT_LIMIT_EXCEEDED";
+})(ExecutionErrorCode || (ExecutionErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAuB,MAAM,iCAAiC,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACvB,2BAAW,CAAA;IACX,qCAAqB,CAAA;IACrB,uCAAuB,CAAA;IACvB,6BAAa,CAAA;AACd,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAEX;AAFD,WAAY,aAAa;IACxB,8BAAa,CAAA;AACd,CAAC,EAFW,aAAa,KAAb,aAAa,QAExB;AAqID;;GAEG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC5B,gCAAgC;IAChC,kCAAa,CAAA;IACb,kCAAkC;IAClC,oCAAe,CAAA;IACf,6CAA6C;IAC7C,gDAA2B,CAAA;AAC5B,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC/B,2CAA2C;IAC3C,yCAAiB,CAAA;IACjB,6CAA6C;IAC7C,6CAAqB,CAAA;IACrB,iDAAiD;IACjD,+CAAuB,CAAA;AACxB,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AA4GD;;GAEG;AACH,MAAM,CAAN,IAAY,eAcX;AAdD,WAAY,eAAe;IAC1B,0CAAuB,CAAA;IACvB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,oCAAiB,CAAA;IACjB,sDAAmC,CAAA;IACnC,4DAAyC,CAAA;IACzC,4DAAyC,CAAA;IACzC,0DAAuC,CAAA;IACvC,kDAA+B,CAAA;IAC/B,gDAA6B,CAAA;IAC7B,kDAA+B,CAAA;IAC/B,8CAA2B,CAAA;AAC5B,CAAC,EAdW,eAAe,KAAf,eAAe,QAc1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBA2BX;AA3BD,WAAY,kBAAkB;IAC7B,qDAA+B,CAAA;IAC/B,2DAAqC,CAAA;IACrC,qDAA+B,CAAA;IAE/B,qEAA+C,CAAA;IAC/C,yEAAmD,CAAA;IACnD,2EAAqD,CAAA;IAErD,+DAAyC,CAAA;IACzC,6DAAuC,CAAA;IACvC,iEAA2C,CAAA;IAE3C,iDAA2B,CAAA;IAC3B,mDAA6B,CAAA;IAC7B,+CAAyB,CAAA;IACzB,yDAAmC,CAAA;IAEnC,uEAAiD,CAAA;IACjD,mDAA6B,CAAA;IAE7B,qDAA+B,CAAA;IAC/B,+CAAyB,CAAA;IACzB,6CAAuB,CAAA;IAEvB,iEAA2C,CAAA;IAC3C,6EAAuD,CAAA;AACxD,CAAC,EA3BW,kBAAkB,KAAlB,kBAAkB,QA2B7B"}

package/dist/validation.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Input validation utilities for ExecutionConfig and other types
+ */
+import { z } from 'zod';
+import type { ExecutionConfig } from './types.js';
+/**
+ * Maximum allowed code size (1MB)
+ */
+export declare const MAX_CODE_SIZE = 1000000;
+export declare class ConfigValidationError extends Error {
+    readonly field: string;
+    readonly value: unknown;
+    constructor(message: string, field: string, value: unknown);
+}
+export declare class SecurityViolationError extends Error {
+    readonly violations: string[];
+    constructor(message: string, violations: string[]);
+}
+/**
+ * Sanitizes input string by removing control characters and normalizing whitespace
+ */
+export declare function sanitizeInput(input: string, maxLength?: number): string;
+/**
+ * Frames user code in a secure execution context to prevent injection attacks
+ * Similar to SQL parameterized queries - treats user code as data within a safe boundary
+ */
+export declare function frameCodeExecution(userCode: string): string;
+/**
+ * Zod schema for ExecutionConfig validation
+ */
+export declare const executionConfigSchema: z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    maxMemory: z.ZodOptional<z.ZodNumber>;
+    maxLLMCalls: z.ZodOptional<z.ZodNumber>;
+    allowedAPIs: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    allowLLMCalls: z.ZodOptional<z.ZodBoolean>;
+    progressCallback: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    customLLMHandler: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    clientServices: z.ZodOptional<z.ZodAny>;
+    provenanceMode: z.ZodOptional<z.ZodAny>;
+    securityPolicies: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    provenanceHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    timeout?: number | undefined;
+    maxMemory?: number | undefined;
+    maxLLMCalls?: number | undefined;
+    allowedAPIs?: string[] | undefined;
+    allowLLMCalls?: boolean | undefined;
+    progressCallback?: ((...args: unknown[]) => unknown) | undefined;
+    customLLMHandler?: ((...args: unknown[]) => unknown) | undefined;
+    clientServices?: any;
+    provenanceMode?: any;
+    securityPolicies?: any[] | undefined;
+    provenanceHints?: string[] | undefined;
+}, {
+    timeout?: number | undefined;
+    maxMemory?: number | undefined;
+    maxLLMCalls?: number | undefined;
+    allowedAPIs?: string[] | undefined;
+    allowLLMCalls?: boolean | undefined;
+    progressCallback?: ((...args: unknown[]) => unknown) | undefined;
+    customLLMHandler?: ((...args: unknown[]) => unknown) | undefined;
+    clientServices?: any;
+    provenanceMode?: any;
+    securityPolicies?: any[] | undefined;
+    provenanceHints?: string[] | undefined;
+}>;
+/**
+ * Validates ExecutionConfig parameters using Zod
+ */
+export declare function validateExecutionConfig(config: Partial<ExecutionConfig>): void;
+/**
+ * Validates client ID format
+ */
+export declare function validateClientId(clientId: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,qBAAa,qBAAsB,SAAQ,KAAK;aAG9B,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO;CAK/B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAG/B,UAAU,EAAE,MAAM,EAAE;gBADpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAAE;CAKrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAgB,GAAG,MAAM,CAgB9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6ChC,CAAC;AAEH;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAc9E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAoBvD"}