@artyfacts/claude 1.2.6 → 1.3.0

package/dist/index.d.mts

@@ -63,7 +63,7 @@ declare function getCredentials(options?: {
  * Now supports fetching full context (organization, project, artifact, related sections)
  * to provide Claude with the information needed to complete tasks effectively.
  */
-interface TaskContext {
+interface TaskContext$1 {
     /** Task ID (section ID) */
     taskId: string;
     /** Task heading/title */
@@ -79,7 +79,7 @@ interface TaskContext {
     /** Additional context */
     context?: Record<string, unknown>;
 }
-interface ExecutionResult {
+interface ExecutionResult$1 {
     /** Whether execution was successful */
     success: boolean;
     /** The generated output */
@@ -91,7 +91,7 @@ interface ExecutionResult {
     /** The prompt that was used (for debugging) */
     promptUsed?: string;
 }
-interface ExecutorConfig {
+interface ExecutorConfig$1 {
     /** Path to claude CLI (default: 'claude') */
     claudePath?: string;
     /** Timeout in milliseconds (default: 5 minutes) */
@@ -108,14 +108,14 @@ interface ExecutorConfig {
 declare class ClaudeExecutor {
     private config;
     private contextFetcher;
-    constructor(config?: ExecutorConfig);
+    constructor(config?: ExecutorConfig$1);
     /**
      * Execute a task using Claude Code CLI
      *
      * If full context is available (baseUrl + apiKey configured), fetches
      * organization, project, artifact, and related sections for a rich prompt.
      */
-    execute(task: TaskContext): Promise<ExecutionResult>;
+    execute(task: TaskContext$1): Promise<ExecutionResult$1>;
     /**
      * Run Claude Code CLI with the given prompt
      */
@@ -140,7 +140,7 @@ declare class ClaudeExecutor {
 /**
  * Create a Claude executor
  */
-declare function createExecutor(config?: ExecutorConfig): ClaudeExecutor;
+declare function createExecutor(config?: ExecutorConfig$1): ClaudeExecutor;
 
 /**
  * SSE Event Listener for Artyfacts task assignments
@@ -316,4 +316,222 @@ declare class ContextFetcher {
 declare function buildPromptWithContext(context: TaskFullContext): string;
 declare function createContextFetcher(config: ContextFetcherConfig): ContextFetcher;
 
-export { type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult, type ExecutorConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext, type TaskFullContext, type TokenResponse, buildPromptWithContext, clearCredentials, createContextFetcher, createExecutor, createListener, getCredentials, loadCredentials, promptForApiKey, runDeviceAuth, saveCredentials };
+/**
+ * Tool Types for Artyfacts
+ */
+/**
+ * JSON Schema for tool input
+ */
+interface ToolInputSchema {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        enum?: string[] | number[];
+        default?: unknown;
+        items?: {
+            type: string;
+            properties?: Record<string, unknown>;
+        };
+    }>;
+    required: string[];
+}
+/**
+ * Tool schema (for Claude tool_use)
+ */
+interface ToolSchema {
+    name: string;
+    description: string;
+    input_schema: ToolInputSchema;
+}
+/**
+ * Tool execution result
+ */
+interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+/**
+ * API client interface for tool handlers
+ */
+interface ApiClient {
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+}
+/**
+ * Tool handler function
+ */
+type ToolHandler = (args: Record<string, unknown>, client: ApiClient) => Promise<ToolResult>;
+/**
+ * Tool call from Claude
+ */
+interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Tool result to send back to Claude
+ */
+interface ToolCallResult {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+
+/**
+ * Artyfacts Tools Registry
+ *
+ * Defines all tools available to agents for interacting with Artyfacts.
+ * Tools are mapped to permissions - agents only get tools they have permission for.
+ */
+
+declare const permissionToTools: Record<string, string[]>;
+/**
+ * Get all tool schemas
+ */
+declare function getAllToolSchemas(): ToolSchema[];
+/**
+ * Get tool schema by name
+ */
+declare function getToolSchema(name: string): ToolSchema | undefined;
+/**
+ * Get tools available for a set of permissions
+ */
+declare function getToolsForPermissions(permissions: string[]): ToolSchema[];
+/**
+ * Check if a tool is allowed for a set of permissions
+ */
+declare function isToolAllowed(toolName: string, permissions: string[]): boolean;
+/**
+ * Get the permission required for a tool
+ */
+declare function getRequiredPermission(toolName: string): string | undefined;
+
+/**
+ * Tool Handlers for Artyfacts
+ *
+ * Each handler calls the corresponding Artyfacts API endpoint.
+ */
+
+declare const handlers: Record<string, ToolHandler>;
+/**
+ * Execute a tool with the given arguments
+ */
+declare function executeTool(toolName: string, args: Record<string, unknown>, client: ApiClient): Promise<ToolResult>;
+
+/**
+ * API Client for Artyfacts Tools
+ *
+ * Simple HTTP client that wraps the Artyfacts API.
+ */
+
+interface ApiClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    agentId?: string;
+}
+/**
+ * Create an API client for Artyfacts
+ */
+declare function createApiClient(config: ApiClientConfig): ApiClient;
+
+/**
+ * Claude Executor with Tools Support
+ *
+ * Executes tasks using Claude with full tool support.
+ * Uses the Anthropic SDK directly (not the CLI) to enable function calling.
+ */
+
+interface TaskContext {
+    /** Task ID (UUID or section_id) */
+    taskId: string;
+    /** Task heading/title */
+    heading: string;
+    /** Task content/description */
+    content: string;
+    /** Parent artifact ID */
+    artifactId: string;
+    /** Parent artifact title */
+    artifactTitle?: string;
+    /** Task priority (1=high, 2=medium, 3=low) */
+    priority?: number;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+interface ExecutionResult {
+    /** Whether execution was successful */
+    success: boolean;
+    /** The generated output */
+    output: string;
+    /** Summary of what was accomplished */
+    summary: string;
+    /** Any error message if failed */
+    error?: string;
+    /** The prompt that was used (for debugging) */
+    promptUsed?: string;
+    /** Tool calls made during execution */
+    toolCalls?: Array<{
+        name: string;
+        input: Record<string, unknown>;
+        output: unknown;
+    }>;
+}
+interface ExecutorConfig {
+    /** Anthropic API key */
+    anthropicApiKey?: string;
+    /** Model to use (default: claude-sonnet-4-20250514) */
+    model?: string;
+    /** Timeout in milliseconds (default: 5 minutes) */
+    timeout?: number;
+    /** System prompt prefix */
+    systemPromptPrefix?: string;
+    /** Artyfacts API base URL */
+    baseUrl: string;
+    /** Artyfacts API key */
+    apiKey: string;
+    /** Agent's permissions (determines available tools) */
+    permissions?: string[];
+    /** Whether to use full context from API (default: true) */
+    useFullContext?: boolean;
+    /** Max tool call iterations (default: 10) */
+    maxToolIterations?: number;
+}
+declare class ClaudeExecutorWithTools {
+    private config;
+    private anthropic;
+    private contextFetcher;
+    private apiClient;
+    private tools;
+    constructor(config: ExecutorConfig);
+    /**
+     * Execute a task using Claude with tools
+     */
+    execute(task: TaskContext): Promise<ExecutionResult>;
+    /**
+     * Build the task prompt (fallback when full context unavailable)
+     */
+    private buildTaskPrompt;
+    /**
+     * Parse the response to extract output and summary
+     */
+    private parseResponse;
+    /**
+     * Get available tools for this executor
+     */
+    getAvailableTools(): ToolSchema[];
+    /**
+     * Update permissions (recalculates available tools)
+     */
+    setPermissions(permissions: string[]): void;
+}
+/**
+ * Create a Claude executor with tools support
+ */
+declare function createExecutorWithTools(config: ExecutorConfig): ClaudeExecutorWithTools;
+
+export { type ApiClient, type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, ClaudeExecutorWithTools, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult$1 as ExecutionResult, type ExecutorConfig$1 as ExecutorConfig, type ExecutorConfig as ExecutorWithToolsConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext$1 as TaskContext, type TaskFullContext, type TokenResponse, type ToolCall, type ToolCallResult, type ToolHandler, type ToolResult, type ToolSchema, buildPromptWithContext, clearCredentials, createApiClient, createContextFetcher, createExecutor, createExecutorWithTools, createListener, executeTool, getAllToolSchemas, getCredentials, getRequiredPermission, getToolSchema, getToolsForPermissions, isToolAllowed, loadCredentials, permissionToTools, promptForApiKey, runDeviceAuth, saveCredentials, handlers as toolHandlers };

package/dist/index.d.ts

@@ -63,7 +63,7 @@ declare function getCredentials(options?: {
  * Now supports fetching full context (organization, project, artifact, related sections)
  * to provide Claude with the information needed to complete tasks effectively.
  */
-interface TaskContext {
+interface TaskContext$1 {
     /** Task ID (section ID) */
     taskId: string;
     /** Task heading/title */
@@ -79,7 +79,7 @@ interface TaskContext {
     /** Additional context */
     context?: Record<string, unknown>;
 }
-interface ExecutionResult {
+interface ExecutionResult$1 {
     /** Whether execution was successful */
     success: boolean;
     /** The generated output */
@@ -91,7 +91,7 @@ interface ExecutionResult {
     /** The prompt that was used (for debugging) */
     promptUsed?: string;
 }
-interface ExecutorConfig {
+interface ExecutorConfig$1 {
     /** Path to claude CLI (default: 'claude') */
     claudePath?: string;
     /** Timeout in milliseconds (default: 5 minutes) */
@@ -108,14 +108,14 @@ interface ExecutorConfig {
 declare class ClaudeExecutor {
     private config;
     private contextFetcher;
-    constructor(config?: ExecutorConfig);
+    constructor(config?: ExecutorConfig$1);
     /**
      * Execute a task using Claude Code CLI
      *
      * If full context is available (baseUrl + apiKey configured), fetches
      * organization, project, artifact, and related sections for a rich prompt.
      */
-    execute(task: TaskContext): Promise<ExecutionResult>;
+    execute(task: TaskContext$1): Promise<ExecutionResult$1>;
     /**
      * Run Claude Code CLI with the given prompt
      */
@@ -140,7 +140,7 @@ declare class ClaudeExecutor {
 /**
  * Create a Claude executor
  */
-declare function createExecutor(config?: ExecutorConfig): ClaudeExecutor;
+declare function createExecutor(config?: ExecutorConfig$1): ClaudeExecutor;
 
 /**
  * SSE Event Listener for Artyfacts task assignments
@@ -316,4 +316,222 @@ declare class ContextFetcher {
 declare function buildPromptWithContext(context: TaskFullContext): string;
 declare function createContextFetcher(config: ContextFetcherConfig): ContextFetcher;
 
-export { type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult, type ExecutorConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext, type TaskFullContext, type TokenResponse, buildPromptWithContext, clearCredentials, createContextFetcher, createExecutor, createListener, getCredentials, loadCredentials, promptForApiKey, runDeviceAuth, saveCredentials };
+/**
+ * Tool Types for Artyfacts
+ */
+/**
+ * JSON Schema for tool input
+ */
+interface ToolInputSchema {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        enum?: string[] | number[];
+        default?: unknown;
+        items?: {
+            type: string;
+            properties?: Record<string, unknown>;
+        };
+    }>;
+    required: string[];
+}
+/**
+ * Tool schema (for Claude tool_use)
+ */
+interface ToolSchema {
+    name: string;
+    description: string;
+    input_schema: ToolInputSchema;
+}
+/**
+ * Tool execution result
+ */
+interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+/**
+ * API client interface for tool handlers
+ */
+interface ApiClient {
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+}
+/**
+ * Tool handler function
+ */
+type ToolHandler = (args: Record<string, unknown>, client: ApiClient) => Promise<ToolResult>;
+/**
+ * Tool call from Claude
+ */
+interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Tool result to send back to Claude
+ */
+interface ToolCallResult {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+
+/**
+ * Artyfacts Tools Registry
+ *
+ * Defines all tools available to agents for interacting with Artyfacts.
+ * Tools are mapped to permissions - agents only get tools they have permission for.
+ */
+
+declare const permissionToTools: Record<string, string[]>;
+/**
+ * Get all tool schemas
+ */
+declare function getAllToolSchemas(): ToolSchema[];
+/**
+ * Get tool schema by name
+ */
+declare function getToolSchema(name: string): ToolSchema | undefined;
+/**
+ * Get tools available for a set of permissions
+ */
+declare function getToolsForPermissions(permissions: string[]): ToolSchema[];
+/**
+ * Check if a tool is allowed for a set of permissions
+ */
+declare function isToolAllowed(toolName: string, permissions: string[]): boolean;
+/**
+ * Get the permission required for a tool
+ */
+declare function getRequiredPermission(toolName: string): string | undefined;
+
+/**
+ * Tool Handlers for Artyfacts
+ *
+ * Each handler calls the corresponding Artyfacts API endpoint.
+ */
+
+declare const handlers: Record<string, ToolHandler>;
+/**
+ * Execute a tool with the given arguments
+ */
+declare function executeTool(toolName: string, args: Record<string, unknown>, client: ApiClient): Promise<ToolResult>;
+
+/**
+ * API Client for Artyfacts Tools
+ *
+ * Simple HTTP client that wraps the Artyfacts API.
+ */
+
+interface ApiClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    agentId?: string;
+}
+/**
+ * Create an API client for Artyfacts
+ */
+declare function createApiClient(config: ApiClientConfig): ApiClient;
+
+/**
+ * Claude Executor with Tools Support
+ *
+ * Executes tasks using Claude with full tool support.
+ * Uses the Anthropic SDK directly (not the CLI) to enable function calling.
+ */
+
+interface TaskContext {
+    /** Task ID (UUID or section_id) */
+    taskId: string;
+    /** Task heading/title */
+    heading: string;
+    /** Task content/description */
+    content: string;
+    /** Parent artifact ID */
+    artifactId: string;
+    /** Parent artifact title */
+    artifactTitle?: string;
+    /** Task priority (1=high, 2=medium, 3=low) */
+    priority?: number;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+interface ExecutionResult {
+    /** Whether execution was successful */
+    success: boolean;
+    /** The generated output */
+    output: string;
+    /** Summary of what was accomplished */
+    summary: string;
+    /** Any error message if failed */
+    error?: string;
+    /** The prompt that was used (for debugging) */
+    promptUsed?: string;
+    /** Tool calls made during execution */
+    toolCalls?: Array<{
+        name: string;
+        input: Record<string, unknown>;
+        output: unknown;
+    }>;
+}
+interface ExecutorConfig {
+    /** Anthropic API key */
+    anthropicApiKey?: string;
+    /** Model to use (default: claude-sonnet-4-20250514) */
+    model?: string;
+    /** Timeout in milliseconds (default: 5 minutes) */
+    timeout?: number;
+    /** System prompt prefix */
+    systemPromptPrefix?: string;
+    /** Artyfacts API base URL */
+    baseUrl: string;
+    /** Artyfacts API key */
+    apiKey: string;
+    /** Agent's permissions (determines available tools) */
+    permissions?: string[];
+    /** Whether to use full context from API (default: true) */
+    useFullContext?: boolean;
+    /** Max tool call iterations (default: 10) */
+    maxToolIterations?: number;
+}
+declare class ClaudeExecutorWithTools {
+    private config;
+    private anthropic;
+    private contextFetcher;
+    private apiClient;
+    private tools;
+    constructor(config: ExecutorConfig);
+    /**
+     * Execute a task using Claude with tools
+     */
+    execute(task: TaskContext): Promise<ExecutionResult>;
+    /**
+     * Build the task prompt (fallback when full context unavailable)
+     */
+    private buildTaskPrompt;
+    /**
+     * Parse the response to extract output and summary
+     */
+    private parseResponse;
+    /**
+     * Get available tools for this executor
+     */
+    getAvailableTools(): ToolSchema[];
+    /**
+     * Update permissions (recalculates available tools)
+     */
+    setPermissions(permissions: string[]): void;
+}
+/**
+ * Create a Claude executor with tools support
+ */
+declare function createExecutorWithTools(config: ExecutorConfig): ClaudeExecutorWithTools;
+
+export { type ApiClient, type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, ClaudeExecutorWithTools, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult$1 as ExecutionResult, type ExecutorConfig$1 as ExecutorConfig, type ExecutorConfig as ExecutorWithToolsConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext$1 as TaskContext, type TaskFullContext, type TokenResponse, type ToolCall, type ToolCallResult, type ToolHandler, type ToolResult, type ToolSchema, buildPromptWithContext, clearCredentials, createApiClient, createContextFetcher, createExecutor, createExecutorWithTools, createListener, executeTool, getAllToolSchemas, getCredentials, getRequiredPermission, getToolSchema, getToolsForPermissions, isToolAllowed, loadCredentials, permissionToTools, promptForApiKey, runDeviceAuth, saveCredentials, handlers as toolHandlers };