Merge pull request #50 from ssdeanx/develop

Develop

Author: ssdeanx

README.md

@@ -139,42 +139,39 @@ graph TB
 ```mermaid
 %%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#58a6ff', 'primaryTextColor': '#c9d1d9', 'primaryBorderColor': '#30363d', 'lineColor': '#58a6ff', 'sectionBkgColor': '#161b22', 'altSectionBkgColor': '#0d1117', 'sectionTextColor': '#c9d1d9', 'gridColor': '#30363d', 'tertiaryColor': '#161b22' }}}%%
 sequenceDiagram
-    participant W as Workflow Step
-    participant Writer as Writer (custom)
-    participant UI as UI/Frontend
+    participant User
+    participant Workflow
+    participant Writer
+    participant Agent/Tool
+    participant Logger
+
+    User->>Workflow: Execute workflow step
+    Workflow->>Logger: logStepStart()
     
-    Note over W,UI: Standardized Workflow Logging Pattern
+    Workflow->>Writer: custom({ type: "data-tool-progress" })
+    Note over Writer: status: "in-progress"<br/>message: "Starting..."<br/>stage: "step-id"
+    Writer-->>User: Stream progress update
     
-    W->>Writer: step-start event
-    Writer->>UI: data-workflow-step-start
-    Note right of UI: {type: "workflow", data: "step-id", id: "step-id"}
+    Workflow->>Agent/Tool: Execute operation
+    Agent/Tool->>Writer: custom({ type: "data-tool-progress" })
+    Note over Writer: Tool emits progress<br/>with same format
+    Writer-->>User: Stream tool progress
     
-    W->>Writer: progress update (20%)
-    Writer->>UI: data-workflow-progress
-    Note right of UI: {status: "20%", message: "...", stage: "workflow"}
+    Agent/Tool-->>Workflow: Return result
     
-    W->>W: Execute step logic
+    Workflow->>Writer: custom({ type: "data-tool-progress" })
+    Note over Writer: status: "done"<br/>message: "Completed..."<br/>stage: "step-id"
+    Writer-->>User: Stream completion
     
-    W->>Writer: progress update (50%)
-    Writer->>UI: data-workflow-progress
-    Note right of UI: {status: "50%", message: "...", stage: "workflow"}
+    Workflow->>Logger: logStepEnd()
+    Workflow-->>User: Return final output
     
-    W->>W: Continue execution
-    
-    W->>Writer: progress update (100%)
-    Writer->>UI: data-workflow-progress
-    Note right of UI: {status: "100%", message: "...", stage: "workflow"}
-    
-    W->>Writer: step-complete event
-    Writer->>UI: data-workflow-step-complete
-    Note right of UI: {stepId: "step-id", success: true, duration: ms}
-    
-    Note over W,UI: Error Handling Pattern
-    
-    W->>W: Error occurs
-    W->>Writer: step-error event
-    Writer->>UI: data-workflow-step-error
-    Note right of UI: {stepId: "step-id", error: "error message"}
+    alt Error occurs
+        Agent/Tool->>Writer: custom({ type: "data-tool-progress" })
+        Note over Writer: status: "error"<br/>message: error details
+        Writer-->>User: Stream error
+        Workflow->>Logger: logError()
+    end
 ```
 
 ## 📊 **System Flowchart**
@@ -330,9 +327,6 @@ cp .env.example .env
 ```bash
 # Terminal 1: Start Mastra backend (agents/tools/workflows at :4111)
 npm run dev
-
-# Terminal 2: Start Next.js frontend (at :3000)
-
 ```
 
 ### Next.js + Mastra Client SDK
@@ -404,13 +398,15 @@ export type Agent = z.infer<typeof AgentSchema>;
 ```
 
 **Key Features:**
+
 - **Type Safety**: All API responses validated with Zod schemas
 - **Caching**: Centralized query keys for efficient cache management
 - **Mutations**: useExecuteToolMutation, useCreateThreadMutation, useVectorQueryMutation
 - **Real-time**: Automatic cache invalidation and refetch on mutations
 - **Error Handling**: Built-in loading/error states
 
 **Usage in client components:**
+
 ```typescript
 "use client";
 import { useAgentsQuery } from "@/lib/hooks/use-dashboard-queries";
@@ -1145,4 +1141,4 @@ classDiagram
     Writer --> WriterCustomPayload : sends
 
     UpstashConfig o--> UpstashVector
-```
+```

package-lock.json

@@ -47,7 +47,7 @@
     "@ai-sdk/openai": "^2.0.86",
     "@ai-sdk/openai-compatible": "^1.0.29",
     "@ai-sdk/react": "^2.0.115",
-    "@dotenvx/dotenvx": "^1.51.1",
+    "@dotenvx/dotenvx": "^1.51.2",
     "@emotion/react": "^11.14.0",
     "@inquirer/prompts": "^8.0.2",
     "@inquirer/type": "^4.0.2",
@@ -72,7 +72,7 @@
     "@mastra/vectorize": "^1.0.0-beta.2",
     "@mastra/voice-google": "^0.12.0-beta.1",
     "@mastra/voice-openai": "^0.12.0-beta.1",
-    "@mcpc-tech/acp-ai-provider": "^0.1.37",
+    "@mcpc-tech/acp-ai-provider": "^0.1.41",
     "@monaco-editor/loader": "^1.7.0",
     "@monaco-editor/react": "^4.8.0-rc.3",
     "@next/bundle-analyzer": "^16.0.10",
@@ -160,7 +160,7 @@
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "serpapi": "^2.2.1",
-    "shiki": "^3.19.0",
+    "shiki": "^3.20.0",
     "streamdown": "^1.6.10",
     "strip-comments": "^2.0.1",
     "svgjson": "^2.2.3",
@@ -195,7 +195,7 @@
     "@typescript-eslint/eslint-plugin": "^8.49.0",
     "@typescript-eslint/parser": "^8.49.0",
     "@vitest/coverage-v8": "^4.0.15",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "ink-testing-library": "^4.0.0",
     "mastra": "^1.0.0-beta.9",