@artyfacts/claude 1.3.23 → 1.3.25

package/dist/index.d.mts

@@ -63,19 +63,32 @@ 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.
  */
+/**
+ * Task context for execution (v2)
+ */
 interface TaskContext$1 {
-    /** Task ID (section ID) */
-    taskId: string;
-    /** Task heading/title */
-    heading: string;
-    /** Task content/description */
-    content: string;
-    /** Parent artifact ID */
-    artifactId: string;
-    /** Parent artifact title */
+    /** Task UUID */
+    id: string;
+    /** @deprecated Use id instead */
+    taskId?: string;
+    /** Task title */
+    title: string;
+    /** @deprecated Use title instead */
+    heading?: string;
+    /** Task description */
+    description?: string;
+    /** @deprecated Use description instead */
+    content?: string;
+    /** Goal UUID this task belongs to */
+    goalId: string;
+    /** @deprecated Use goalId instead */
+    artifactId?: string;
+    /** Goal title for context */
+    goalTitle?: string;
+    /** @deprecated Use goalTitle instead */
     artifactTitle?: string;
-    /** Task priority (1=high, 2=medium, 3=low) */
-    priority?: number;
+    /** Task priority */
+    priority?: 'low' | 'medium' | 'high';
     /** Additional context */
     context?: Record<string, unknown>;
 }
@@ -121,7 +134,7 @@ declare class ClaudeExecutor {
      */
     private runClaude;
     /**
-     * Build the task prompt
+     * Build the task prompt (v2)
      */
     private buildTaskPrompt;
     /**
@@ -148,18 +161,39 @@ declare function createExecutor(config?: ExecutorConfig$1): ClaudeExecutor;
  * Connects to the Artyfacts SSE stream and listens for task_assigned events.
  * Uses EventSource for automatic reconnection handling.
  */
+/**
+ * Task assigned event (v2)
+ * Uses task ID and goal ID (not section_id/artifact_id)
+ */
 interface TaskAssignedEvent {
     type: 'task_assigned';
     timestamp: string;
     data: {
-        taskId: string;
-        sectionId: string;
-        heading: string;
-        content: string;
-        artifactId: string;
+        /** Task UUID (primary identifier) */
+        id: string;
+        /** @deprecated Use id instead */
+        taskId?: string;
+        /** Goal UUID this task belongs to */
+        goalId: string;
+        /** @deprecated Use goalId instead */
+        artifactId?: string;
+        /** Task title */
+        title: string;
+        /** @deprecated Use title instead */
+        heading?: string;
+        /** Task description */
+        description?: string;
+        /** @deprecated Use description instead */
+        content?: string;
+        /** Goal title for context */
+        goalTitle?: string;
+        /** @deprecated Use goalTitle instead */
         artifactTitle?: string;
-        priority?: number;
+        /** Priority level */
+        priority?: 'low' | 'medium' | 'high';
+        /** Assigned agent ID */
         assignedTo: string;
+        /** Assignment timestamp */
         assignedAt: string;
     };
 }
@@ -270,7 +304,8 @@ declare function createListener(config: ListenerConfig): ArtyfactsListener;
 /**
  * Context fetcher for Artyfacts tasks
  *
- * Fetches full context including organization, project, artifact, and related sections.
+ * Fetches full context including organization, project, goal, and related tasks.
+ * Updated for Schema v2 - tasks are first-class entities linked to goals.
  */
 interface OrganizationContext {
     id: string;
@@ -282,6 +317,18 @@ interface ProjectContext {
     name: string;
     description?: string;
 }
+/**
+ * Related task summary (v2)
+ */
+interface RelatedTaskContext {
+    id: string;
+    title: string;
+    status: 'pending' | 'in_progress' | 'blocked' | 'done';
+    priority?: 'low' | 'medium' | 'high';
+}
+/**
+ * Section context (kept for artifact content)
+ */
 interface SectionContext {
     id: string;
     heading: string;
@@ -289,26 +336,53 @@ interface SectionContext {
     section_type?: string;
     task_status?: string;
 }
-interface ArtifactContext {
+/**
+ * Goal context (v2 - replaces artifact context for task work)
+ */
+interface GoalContext {
     id: string;
     title: string;
+    objective?: string;
     summary?: string;
     description?: string;
     artifact_type?: string;
-    sections: SectionContext[];
+    /** Related tasks on this goal */
+    tasks?: RelatedTaskContext[];
+    /** Legacy: sections for content-based artifacts */
+    sections?: SectionContext[];
 }
+/** @deprecated Use GoalContext instead */
+interface ArtifactContext extends GoalContext {
+}
+/**
+ * Full task context (v2)
+ */
 interface TaskFullContext {
     task: {
+        /** Task UUID */
         id: string;
-        heading: string;
-        content: string;
+        /** Task title */
+        title: string;
+        /** @deprecated Use title instead */
+        heading?: string;
+        /** Task description */
+        description?: string;
+        /** @deprecated Use description instead */
+        content?: string;
+        /** Expected output format and requirements */
         expected_output?: {
             format?: string;
             requirements?: string[];
         };
-        priority?: number;
+        /** Priority level */
+        priority?: 'low' | 'medium' | 'high';
+        /** Dependencies */
+        depends_on?: string[];
     };
-    artifact: ArtifactContext;
+    /** The goal this task belongs to */
+    goal: GoalContext;
+    /** @deprecated Use goal instead */
+    artifact?: GoalContext;
     project?: ProjectContext;
     organization: OrganizationContext;
 }
@@ -325,14 +399,11 @@ declare class ContextFetcher {
     fetchTaskContext(taskId: string): Promise<TaskFullContext>;
 }
 /**
- * Build a rich prompt with full context
+ * Build a rich prompt with full context (v2)
  */
 declare function buildPromptWithContext(context: TaskFullContext): string;
 declare function createContextFetcher(config: ContextFetcherConfig): ContextFetcher;
 
-/**
- * Tool Types for Artyfacts
- */
 /**
  * JSON Schema for tool input
  */

package/dist/index.d.ts

@@ -63,19 +63,32 @@ 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.
  */
+/**
+ * Task context for execution (v2)
+ */
 interface TaskContext$1 {
-    /** Task ID (section ID) */
-    taskId: string;
-    /** Task heading/title */
-    heading: string;
-    /** Task content/description */
-    content: string;
-    /** Parent artifact ID */
-    artifactId: string;
-    /** Parent artifact title */
+    /** Task UUID */
+    id: string;
+    /** @deprecated Use id instead */
+    taskId?: string;
+    /** Task title */
+    title: string;
+    /** @deprecated Use title instead */
+    heading?: string;
+    /** Task description */
+    description?: string;
+    /** @deprecated Use description instead */
+    content?: string;
+    /** Goal UUID this task belongs to */
+    goalId: string;
+    /** @deprecated Use goalId instead */
+    artifactId?: string;
+    /** Goal title for context */
+    goalTitle?: string;
+    /** @deprecated Use goalTitle instead */
     artifactTitle?: string;
-    /** Task priority (1=high, 2=medium, 3=low) */
-    priority?: number;
+    /** Task priority */
+    priority?: 'low' | 'medium' | 'high';
     /** Additional context */
     context?: Record<string, unknown>;
 }
@@ -121,7 +134,7 @@ declare class ClaudeExecutor {
      */
     private runClaude;
     /**
-     * Build the task prompt
+     * Build the task prompt (v2)
      */
     private buildTaskPrompt;
     /**
@@ -148,18 +161,39 @@ declare function createExecutor(config?: ExecutorConfig$1): ClaudeExecutor;
  * Connects to the Artyfacts SSE stream and listens for task_assigned events.
  * Uses EventSource for automatic reconnection handling.
  */
+/**
+ * Task assigned event (v2)
+ * Uses task ID and goal ID (not section_id/artifact_id)
+ */
 interface TaskAssignedEvent {
     type: 'task_assigned';
     timestamp: string;
     data: {
-        taskId: string;
-        sectionId: string;
-        heading: string;
-        content: string;
-        artifactId: string;
+        /** Task UUID (primary identifier) */
+        id: string;
+        /** @deprecated Use id instead */
+        taskId?: string;
+        /** Goal UUID this task belongs to */
+        goalId: string;
+        /** @deprecated Use goalId instead */
+        artifactId?: string;
+        /** Task title */
+        title: string;
+        /** @deprecated Use title instead */
+        heading?: string;
+        /** Task description */
+        description?: string;
+        /** @deprecated Use description instead */
+        content?: string;
+        /** Goal title for context */
+        goalTitle?: string;
+        /** @deprecated Use goalTitle instead */
         artifactTitle?: string;
-        priority?: number;
+        /** Priority level */
+        priority?: 'low' | 'medium' | 'high';
+        /** Assigned agent ID */
         assignedTo: string;
+        /** Assignment timestamp */
         assignedAt: string;
     };
 }
@@ -270,7 +304,8 @@ declare function createListener(config: ListenerConfig): ArtyfactsListener;
 /**
  * Context fetcher for Artyfacts tasks
  *
- * Fetches full context including organization, project, artifact, and related sections.
+ * Fetches full context including organization, project, goal, and related tasks.
+ * Updated for Schema v2 - tasks are first-class entities linked to goals.
  */
 interface OrganizationContext {
     id: string;
@@ -282,6 +317,18 @@ interface ProjectContext {
     name: string;
     description?: string;
 }
+/**
+ * Related task summary (v2)
+ */
+interface RelatedTaskContext {
+    id: string;
+    title: string;
+    status: 'pending' | 'in_progress' | 'blocked' | 'done';
+    priority?: 'low' | 'medium' | 'high';
+}
+/**
+ * Section context (kept for artifact content)
+ */
 interface SectionContext {
     id: string;
     heading: string;
@@ -289,26 +336,53 @@ interface SectionContext {
     section_type?: string;
     task_status?: string;
 }
-interface ArtifactContext {
+/**
+ * Goal context (v2 - replaces artifact context for task work)
+ */
+interface GoalContext {
     id: string;
     title: string;
+    objective?: string;
     summary?: string;
     description?: string;
     artifact_type?: string;
-    sections: SectionContext[];
+    /** Related tasks on this goal */
+    tasks?: RelatedTaskContext[];
+    /** Legacy: sections for content-based artifacts */
+    sections?: SectionContext[];
 }
+/** @deprecated Use GoalContext instead */
+interface ArtifactContext extends GoalContext {
+}
+/**
+ * Full task context (v2)
+ */
 interface TaskFullContext {
     task: {
+        /** Task UUID */
         id: string;
-        heading: string;
-        content: string;
+        /** Task title */
+        title: string;
+        /** @deprecated Use title instead */
+        heading?: string;
+        /** Task description */
+        description?: string;
+        /** @deprecated Use description instead */
+        content?: string;
+        /** Expected output format and requirements */
         expected_output?: {
             format?: string;
             requirements?: string[];
         };
-        priority?: number;
+        /** Priority level */
+        priority?: 'low' | 'medium' | 'high';
+        /** Dependencies */
+        depends_on?: string[];
     };
-    artifact: ArtifactContext;
+    /** The goal this task belongs to */
+    goal: GoalContext;
+    /** @deprecated Use goal instead */
+    artifact?: GoalContext;
     project?: ProjectContext;
     organization: OrganizationContext;
 }
@@ -325,14 +399,11 @@ declare class ContextFetcher {
     fetchTaskContext(taskId: string): Promise<TaskFullContext>;
 }
 /**
- * Build a rich prompt with full context
+ * Build a rich prompt with full context (v2)
  */
 declare function buildPromptWithContext(context: TaskFullContext): string;
 declare function createContextFetcher(config: ContextFetcherConfig): ContextFetcher;
 
-/**
- * Tool Types for Artyfacts
- */
 /**
  * JSON Schema for tool input
  */