@artyfacts/claude 1.2.6 → 1.3.0

package/src/tools/handlers.ts

@@ -0,0 +1,460 @@
+/**
+ * Tool Handlers for Artyfacts
+ * 
+ * Each handler calls the corresponding Artyfacts API endpoint.
+ */
+
+import { ApiClient, ToolResult, ToolHandler } from './types';
+
+// =============================================================================
+// Section Handlers
+// =============================================================================
+
+export const getSectionHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.get(`/artifacts/sections/${args.section_id}`);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const listSectionsHandler: ToolHandler = async (args, client) => {
+  try {
+    let path = `/artifacts/${args.artifact_id}/sections`;
+    if (args.type) {
+      path += `?type=${args.type}`;
+    }
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const createSectionHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/artifacts/${args.artifact_id}/sections`, {
+      section_id: args.section_id || `section-${Date.now()}`,
+      heading: args.heading,
+      content: args.content,
+      type: args.type || 'content',
+      position: args.position,
+      agent_id: args.agent_id || 'system',
+      agent_name: args.agent_name || 'System',
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const updateSectionHandler: ToolHandler = async (args, client) => {
+  try {
+    const updates: Record<string, unknown> = {};
+    if (args.heading) updates.heading = args.heading;
+    if (args.content) updates.content = args.content;
+    
+    const data = await client.patch(`/artifacts/sections/${args.section_id}`, updates);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const deleteSectionHandler: ToolHandler = async (args, client) => {
+  try {
+    await client.delete(`/artifacts/sections/${args.section_id}`);
+    return { success: true, data: { deleted: true } };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+// =============================================================================
+// Artifact Handlers
+// =============================================================================
+
+export const getArtifactHandler: ToolHandler = async (args, client) => {
+  try {
+    let path = `/artifacts/${args.artifact_id}`;
+    if (args.include_sections) {
+      path += '?include_sections=true';
+    }
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const listArtifactsHandler: ToolHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    if (args.type) params.set('type', String(args.type));
+    if (args.status) params.set('status', String(args.status));
+    if (args.parent_id) params.set('parent_id', String(args.parent_id));
+    if (args.limit) params.set('limit', String(args.limit));
+    
+    const query = params.toString();
+    const path = `/artifacts${query ? `?${query}` : ''}`;
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const searchArtifactsHandler: ToolHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    params.set('q', String(args.query));
+    if (args.type) params.set('type', String(args.type));
+    if (args.limit) params.set('limit', String(args.limit));
+    
+    const data = await client.get(`/artifacts/search?${params.toString()}`);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const createArtifactHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post('/artifacts', {
+      title: args.title,
+      artifact_type: args.type,
+      content: args.content,
+      summary: args.summary,
+      parent_id: args.parent_id,
+      tags: args.tags,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const updateArtifactHandler: ToolHandler = async (args, client) => {
+  try {
+    const updates: Record<string, unknown> = {};
+    if (args.title) updates.title = args.title;
+    if (args.summary) updates.summary = args.summary;
+    if (args.status) updates.status = args.status;
+    
+    const data = await client.patch(`/artifacts/${args.artifact_id}`, updates);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const linkArtifactsHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/artifacts/${args.parent_id}/link`, {
+      child_id: args.child_id,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+// =============================================================================
+// Agent Handlers
+// =============================================================================
+
+export const getAgentHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.get(`/agents/${args.agent_id}`);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const listAgentsHandler: ToolHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    if (args.role) params.set('role', String(args.role));
+    if (args.status) params.set('status', String(args.status));
+    
+    const query = params.toString();
+    const path = `/agents${query ? `?${query}` : ''}`;
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const createAgentHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post('/agents', {
+      id: args.id,
+      name: args.name,
+      role: args.role,
+      description: args.description,
+      system_prompt: args.system_prompt,
+      capabilities: args.capabilities || [],
+      permissions: args.permissions || ['sections:read', 'artifacts:read'],
+      model: args.model,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const updateAgentHandler: ToolHandler = async (args, client) => {
+  try {
+    const updates: Record<string, unknown> = {};
+    if (args.name) updates.name = args.name;
+    if (args.role) updates.role = args.role;
+    if (args.description) updates.description = args.description;
+    if (args.system_prompt) updates.system_prompt = args.system_prompt;
+    if (args.capabilities) updates.capabilities = args.capabilities;
+    if (args.permissions) updates.permissions = args.permissions;
+    if (args.status) updates.status = args.status;
+    
+    const data = await client.patch(`/agents/${args.agent_id}`, updates);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+// =============================================================================
+// Task Handlers
+// =============================================================================
+
+export const getTaskHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.get(`/tasks/${args.task_id}/context`);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const listTasksHandler: ToolHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    if (args.artifact_id) params.set('artifact_id', String(args.artifact_id));
+    if (args.status) params.set('status', String(args.status));
+    if (args.assignee) params.set('assignee', String(args.assignee));
+    if (args.limit) params.set('limit', String(args.limit));
+    
+    const query = params.toString();
+    const path = `/tasks${query ? `?${query}` : ''}`;
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const createTaskHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/artifacts/${args.artifact_id}/sections`, {
+      section_id: `task-${Date.now()}`,
+      heading: args.heading,
+      content: args.content,
+      type: 'task',
+      task_status: 'pending',
+      assignee_agent_id: args.assignee,
+      depends_on: args.depends_on,
+      priority: args.priority,
+      agent_id: 'system',
+      agent_name: 'System',
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const completeTaskHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/tasks/${args.task_id}/complete`, {
+      output: args.output,
+      summary: args.summary,
+      output_url: args.output_url,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const blockTaskHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/tasks/${args.task_id}/fail`, {
+      reason: args.reason,
+      blocker_type: args.blocker_type,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+// =============================================================================
+// Blocker Handlers
+// =============================================================================
+
+export const getBlockerHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.get(`/blockers/${args.blocker_id}`);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const listBlockersHandler: ToolHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    if (args.status) params.set('status', String(args.status));
+    if (args.artifact_id) params.set('artifact_id', String(args.artifact_id));
+    if (args.kind) params.set('kind', String(args.kind));
+    
+    const query = params.toString();
+    const path = `/blockers${query ? `?${query}` : ''}`;
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const createBlockerHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post('/blockers', {
+      title: args.title,
+      description: args.description,
+      kind: args.kind,
+      options: args.options,
+      artifact_id: args.artifact_id,
+      task_id: args.task_id,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const resolveBlockerHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.post(`/blockers/${args.blocker_id}/resolve`, {
+      decision: args.decision,
+      notes: args.notes,
+    });
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+// =============================================================================
+// Organization Handlers
+// =============================================================================
+
+export const getOrgContextHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.get('/org/context');
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const getProjectHandler: ToolHandler = async (args, client) => {
+  try {
+    const data = await client.get(`/projects/${args.project_id}`);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+export const listProjectsHandler: ToolHandler = async (args, client) => {
+  try {
+    const params = new URLSearchParams();
+    if (args.status) params.set('status', String(args.status));
+    
+    const query = params.toString();
+    const path = `/projects${query ? `?${query}` : ''}`;
+    const data = await client.get(path);
+    return { success: true, data };
+  } catch (error) {
+    return { success: false, error: String(error) };
+  }
+};
+
+// =============================================================================
+// Handler Registry
+// =============================================================================
+
+export const handlers: Record<string, ToolHandler> = {
+  // Sections
+  get_section: getSectionHandler,
+  list_sections: listSectionsHandler,
+  create_section: createSectionHandler,
+  update_section: updateSectionHandler,
+  delete_section: deleteSectionHandler,
+  
+  // Artifacts
+  get_artifact: getArtifactHandler,
+  list_artifacts: listArtifactsHandler,
+  search_artifacts: searchArtifactsHandler,
+  create_artifact: createArtifactHandler,
+  update_artifact: updateArtifactHandler,
+  link_artifacts: linkArtifactsHandler,
+  
+  // Agents
+  get_agent: getAgentHandler,
+  list_agents: listAgentsHandler,
+  create_agent: createAgentHandler,
+  update_agent: updateAgentHandler,
+  
+  // Tasks
+  get_task: getTaskHandler,
+  list_tasks: listTasksHandler,
+  create_task: createTaskHandler,
+  complete_task: completeTaskHandler,
+  block_task: blockTaskHandler,
+  
+  // Blockers
+  get_blocker: getBlockerHandler,
+  list_blockers: listBlockersHandler,
+  create_blocker: createBlockerHandler,
+  resolve_blocker: resolveBlockerHandler,
+  
+  // Organization
+  get_org_context: getOrgContextHandler,
+  get_project: getProjectHandler,
+  list_projects: listProjectsHandler,
+};
+
+/**
+ * Get handler for a tool
+ */
+export function getHandler(toolName: string): ToolHandler | undefined {
+  return handlers[toolName];
+}
+
+/**
+ * Execute a tool with the given arguments
+ */
+export async function executeTool(
+  toolName: string,
+  args: Record<string, unknown>,
+  client: ApiClient
+): Promise<ToolResult> {
+  const handler = handlers[toolName];
+  if (!handler) {
+    return { success: false, error: `Unknown tool: ${toolName}` };
+  }
+  return handler(args, client);
+}

package/src/tools/index.ts

@@ -0,0 +1,30 @@
+/**
+ * Artyfacts Tools
+ * 
+ * Tools registry for Claude to interact with Artyfacts API.
+ */
+
+export * from './types';
+export * from './registry';
+export * from './handlers';
+export * from './api-client';
+
+// Re-export commonly used functions
+export {
+  getAllToolSchemas,
+  getToolSchema,
+  getToolsForPermissions,
+  isToolAllowed,
+  getRequiredPermission,
+  permissionToTools,
+} from './registry';
+
+export {
+  handlers,
+  getHandler,
+  executeTool,
+} from './handlers';
+
+export {
+  createApiClient,
+} from './api-client';