@artyfacts/claude 1.3.24 → 1.3.26

package/src/tools/registry.ts

@@ -413,7 +413,7 @@ const schemas: Record<string, ToolSchema> = {
   },
 
   // ---------------------------------------------------------------------------
-  // Task Tools
+  // Task Tools (v2 - tasks are first-class entities)
   // ---------------------------------------------------------------------------
   get_task: {
     name: 'get_task',
@@ -423,7 +423,7 @@ const schemas: Record<string, ToolSchema> = {
       properties: {
         task_id: {
           type: 'string',
-          description: 'The task UUID or section_id',
+          description: 'The task UUID',
         },
       },
       required: ['task_id'],
@@ -432,13 +432,13 @@ const schemas: Record<string, ToolSchema> = {
 
   list_tasks: {
     name: 'list_tasks',
-    description: 'List tasks with optional filters.',
+    description: 'List tasks from the queue. Returns tasks from the tasks table with goal context.',
     input_schema: {
       type: 'object',
       properties: {
-        artifact_id: {
+        goal_id: {
           type: 'string',
-          description: 'Filter by artifact',
+          description: 'Filter by goal ID',
         },
         status: {
           type: 'string',
@@ -459,21 +459,55 @@ const schemas: Record<string, ToolSchema> = {
     },
   },
 
+  create_goal: {
+    name: 'create_goal',
+    description: 'Create a new goal (v2). Goals are first-class entities that contain tasks.',
+    input_schema: {
+      type: 'object',
+      properties: {
+        title: {
+          type: 'string',
+          description: 'Goal title',
+        },
+        description: {
+          type: 'string',
+          description: 'Goal description and objectives',
+        },
+        priority: {
+          type: 'string',
+          enum: ['low', 'medium', 'high', 'urgent'],
+          default: 'medium',
+          description: 'Priority level',
+        },
+        target_date: {
+          type: 'string',
+          description: 'Optional: target completion date (ISO format)',
+        },
+        tags: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Optional: tags for categorization',
+        },
+      },
+      required: ['title'],
+    },
+  },
+
   create_task: {
     name: 'create_task',
-    description: 'Create a new task on an artifact.',
+    description: 'Create a new task under a goal.',
     input_schema: {
       type: 'object',
       properties: {
-        artifact_id: {
+        goal_id: {
           type: 'string',
-          description: 'The artifact to add the task to',
+          description: 'The goal UUID to add the task to',
         },
-        heading: {
+        title: {
           type: 'string',
-          description: 'Task title/heading',
+          description: 'Task title',
         },
-        content: {
+        description: {
           type: 'string',
           description: 'Task description and requirements',
         },
@@ -484,27 +518,43 @@ const schemas: Record<string, ToolSchema> = {
         depends_on: {
           type: 'array',
           items: { type: 'string' },
-          description: 'Optional: section_ids of tasks this depends on',
+          description: 'Optional: task IDs this depends on',
         },
         priority: {
-          type: 'number',
-          enum: [1, 2, 3],
-          description: 'Optional: priority (1=high, 2=medium, 3=low)',
+          type: 'string',
+          enum: ['low', 'medium', 'high'],
+          default: 'medium',
+          description: 'Optional: priority level',
         },
       },
-      required: ['artifact_id', 'heading', 'content'],
+      required: ['goal_id', 'title'],
+    },
+  },
+
+  claim_task: {
+    name: 'claim_task',
+    description: 'Claim a task for execution. Sets status to in_progress.',
+    input_schema: {
+      type: 'object',
+      properties: {
+        task_id: {
+          type: 'string',
+          description: 'The task UUID to claim',
+        },
+      },
+      required: ['task_id'],
     },
   },
 
   complete_task: {
     name: 'complete_task',
-    description: 'Mark a task as completed with output.',
+    description: 'Mark a task as completed. Returns list of unblocked tasks that can now be worked on.',
     input_schema: {
       type: 'object',
       properties: {
         task_id: {
           type: 'string',
-          description: 'The task UUID or section_id',
+          description: 'The task UUID',
         },
         output: {
           type: 'string',
@@ -531,7 +581,7 @@ const schemas: Record<string, ToolSchema> = {
       properties: {
         task_id: {
           type: 'string',
-          description: 'The task UUID or section_id',
+          description: 'The task UUID',
         },
         reason: {
           type: 'string',
@@ -547,6 +597,58 @@ const schemas: Record<string, ToolSchema> = {
     },
   },
 
+  // ---------------------------------------------------------------------------
+  // Inbox Tools (v2)
+  // ---------------------------------------------------------------------------
+  list_inbox: {
+    name: 'list_inbox',
+    description: 'List pending inbox items (decisions, approvals, reviews).',
+    input_schema: {
+      type: 'object',
+      properties: {
+        status: {
+          type: 'string',
+          enum: ['pending', 'resolved'],
+          description: 'Filter by status',
+        },
+        kind: {
+          type: 'string',
+          enum: ['decision', 'approval', 'review'],
+          description: 'Filter by type',
+        },
+        limit: {
+          type: 'number',
+          default: 20,
+          description: 'Max results',
+        },
+      },
+      required: [],
+    },
+  },
+
+  resolve_inbox: {
+    name: 'resolve_inbox',
+    description: 'Resolve an inbox item with a decision. May trigger auto-execution.',
+    input_schema: {
+      type: 'object',
+      properties: {
+        inbox_id: {
+          type: 'string',
+          description: 'The inbox item UUID',
+        },
+        decision: {
+          type: 'string',
+          description: 'The decision/resolution',
+        },
+        notes: {
+          type: 'string',
+          description: 'Optional: additional notes',
+        },
+      },
+      required: ['inbox_id', 'decision'],
+    },
+  },
+
   // ---------------------------------------------------------------------------
   // Blocker Tools
   // ---------------------------------------------------------------------------
@@ -713,7 +815,9 @@ export const permissionToTools: Record<string, string[]> = {
   'agents:read': ['get_agent', 'list_agents'],
   'agents:write': ['create_agent', 'update_agent'],
   'tasks:read': ['get_task', 'list_tasks'],
-  'tasks:write': ['create_task', 'complete_task', 'block_task'],
+  'tasks:write': ['create_task', 'claim_task', 'complete_task', 'block_task'],
+  'inbox:read': ['list_inbox'],
+  'inbox:write': ['resolve_inbox'],
   'blockers:read': ['get_blocker', 'list_blockers'],
   'blockers:write': ['create_blocker', 'resolve_blocker'],
   'org:read': ['get_org_context', 'get_project', 'list_projects'],

package/src/tools/types.ts

@@ -1,7 +1,94 @@
 /**
  * Tool Types for Artyfacts
+ * 
+ * Updated for Schema v2 - tasks are now first-class entities
  */
 
+// =============================================================================
+// API v2 Types
+// =============================================================================
+
+/**
+ * Task from the tasks table (v2)
+ */
+export interface Task {
+  id: string;
+  goal_id: string;
+  goal_title?: string;
+  title: string;
+  description?: string;
+  status: 'pending' | 'in_progress' | 'blocked' | 'done';
+  priority: 'low' | 'medium' | 'high';
+  assignee_agent_id?: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+/**
+ * Task queue response (GET /api/v1/tasks/queue)
+ */
+export interface TaskQueueResponse {
+  tasks: Task[];
+}
+
+/**
+ * Task claim response (POST /api/v1/tasks/:id/claim)
+ */
+export interface TaskClaimResponse {
+  task: Task;
+  claimed: boolean;
+}
+
+/**
+ * Unblocked task summary
+ */
+export interface UnblockedTask {
+  id: string;
+  title: string;
+}
+
+/**
+ * Task complete response (POST /api/v1/tasks/:id/complete)
+ */
+export interface TaskCompleteResponse {
+  task: Task;
+  unblocked_tasks: UnblockedTask[];
+}
+
+/**
+ * Inbox item
+ */
+export interface InboxItem {
+  id: string;
+  kind: 'decision' | 'approval' | 'review';
+  title: string;
+  description?: string;
+  artifact_id?: string;
+  task_id?: string;
+  options?: Array<{ name: string; description?: string }>;
+  status: 'pending' | 'resolved';
+  created_at?: string;
+}
+
+/**
+ * Inbox list response (GET /api/v1/inbox)
+ */
+export interface InboxResponse {
+  items: InboxItem[];
+}
+
+/**
+ * Inbox resolve response (POST /api/v1/inbox/:id/resolve)
+ */
+export interface InboxResolveResponse {
+  item: InboxItem;
+  auto_executed?: boolean;
+}
+
+// =============================================================================
+// Tool Schema Types
+// =============================================================================
+
 /**
  * JSON Schema for tool input
  */