Skip to content

Self-improving AI Employees for everyone

fix(deps): resolve Dependabot alerts 97-99 (js-yaml, langgraph-checkpoint, langgraph-sdk) (#47)

trohitg4e5d4e6dc3fe
diff --git a/CLAUDE.md b/CLAUDE.md
index 7e452204..15adf1f0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1015,8 +1015,8 @@ workspace_base_dir: str = Field(default="workspaces", env="WORKSPACE_BASE_DIR")
|------|-------------|
| `server/core/config.py` | `workspace_base_dir` setting |
| `server/services/workflow.py` | `_get_workspace_dir()`, injects into context |
-| `server/services/handlers/document.py` | `fileDownloader` uses workspace for downloads |
-| `server/services/handlers/code.py` | `workspace_dir` available in Python/JS/TS execution |
+| `server/nodes/document/file_downloader/` | `fileDownloader` saves to the workspace |
+| `server/nodes/code/` | `workspace_dir` available in Python/JS/TS executors |
| `server/nodes/filesystem/_backend.py` | `NushellBackend(root_dir=workspace_dir, virtual_mode=True)` for the file/shell plugins |
### Workflow Naming (Wave 14)
@@ -1337,10 +1337,10 @@ Centralized cost tracking for third-party API services (Twitter/X, Google Maps).
**1. Manual Tracking** - For services using native SDKs:
```python
-# server/services/handlers/twitter.py
+# usage tracked inside server/nodes/twitter/
await _track_twitter_usage(node_id, 'tweet', 1, workflow_id, session_id)
-# server/services/maps.py
+# usage tracked inside server/nodes/location/_service.py
await _track_maps_usage(node_id, 'geocode', 1, workflow_id, session_id)
```
@@ -1402,7 +1402,7 @@ Tool Node (calculatorTool) → (tool output) → AI Agent (input-tools handle)
|------|-------------|
| `server/services/handlers/tools.py` | Tool execution handlers |
| `server/services/ai.py` | `_get_tool_schema()` - Pydantic schemas for tools |
-| `server/services/handlers/ai.py` | Tool discovery from edges |
+| `server/services/plugin/edge_walker.py` | `collect_agent_connections` — tool/skill/memory discovery from edges |
### Adding a new tool or specialized agent (Wave 11)
@@ -1569,7 +1569,7 @@ search_results = await asyncio.get_event_loop().run_in_executor(None, do_search)
```
#### Search API Nodes (braveSearch, serperSearch, perplexitySearch)
-Dedicated handlers in `server/services/handlers/search.py` using `httpx.AsyncClient`:
+Dedicated plugins under `server/nodes/search/` (`brave_search` / `serper_search` / `perplexity_search`) using `httpx.AsyncClient`:
- **Brave Search**: `GET https://api.search.brave.com/res/v1/web/search` with `X-Subscription-Token` header. Returns `{query, results: [{title, snippet, url}], result_count, provider}`.
- **Serper**: `POST https://google.serper.dev/search` with `X-API-KEY` header. Supports web/news/images/places search types. Returns `{query, results, result_count, search_type, provider}` with optional `knowledge_graph`.
- **Perplexity Sonar**: `POST https://api.perplexity.ai/chat/completions` with Bearer token. Returns `{query, answer (markdown), citations: [url], results: [{url}], model, provider}` with optional `images` and `related_questions`.
@@ -2447,7 +2447,9 @@ def has_real_android_devices(self) -> bool:
Updated `client_left` and presence handlers use `has_real_android_devices()` instead of checking total device count.
-### WebSocket Message Types (127 Handlers)
+### WebSocket Message Types
+
+> Live count = `len(MESSAGE_HANDLERS) + len(get_ws_handlers())` (core dict in `server/routers/websocket.py` + plugin-registered handlers). The catalogue below is illustrative, not exhaustive or hand-maintained.
#### Request/Response Messages (Client -> Server -> Client)
| Category | Message Types |
@@ -2727,7 +2729,7 @@ This function:
- **Skill System Architecture**: Skills organized in `server/skills/<folder>/` subfolders. Each folder appears in Master Skill dropdown. DB is source of truth for skill instructions (seeded from SKILL.md on first load). Icon resolution mirrors `BaseNode._metadata_dict`: per-plugin `<plugin>/icon.svg` (served as `/api/schemas/nodes/<type>/icon`) → `visuals.json` (emoji / `lobehub:<brand>`); color: per-plugin `<plugin>/meta.json` → `visuals.json`. Lives in [`skill_loader.py::_parse_skill_metadata`](./server/services/skill_loader.py). Native DOM keydown handler prevents React Flow from intercepting Ctrl shortcuts in skill editor. **Mutation broadcasts use the CloudEvents-typed `skill_lifecycle` wire key** with stages `created` / `updated` / `deleted` / `content_saved` — see "Plugin-folder location for plugin-specific CloudEvents factories" below.
- **Example Workflows**: Auto-load example workflow seeds from `<repo>/.machina/workflows/` on first use (git-tracked; the only non-ignored content under `<repo>/.machina/`). Path resolved by `core.paths.example_workflows_dir()` — fixed, NOT under `DATA_DIR`, preserved by `machina clean` via `_MACHINA_KEEP`. Uses `UserSettings.examples_loaded` flag; supports anonymous users (`user_id="default"`); embedded `nodeParameters` saved to DB on import.
- **Onboarding Service**: 5-step welcome wizard (Welcome, Concepts, API Keys, Canvas Tour, Get Started) using shadcn primitives + lucide icons. Database-backed via `UserSettings.onboarding_completed` + `onboarding_step`. Existing users auto-skip (migration marks `examples_loaded=1` as completed). Replayable from Settings "Help" section. No new WebSocket handlers needed. See [Onboarding Service](./docs-internal/onboarding.md) for details.
-- **Node.js Code Executor**: Persistent Node.js server (Express + tsx) at port 3020 for JavaScript/TypeScript execution, replacing subprocess spawning per execution. Handlers in `server/services/handlers/code.py` call `NodeJSClient` which makes HTTP requests to the Node.js server. All config via environment variables (`NODEJS_EXECUTOR_URL`, `NODEJS_EXECUTOR_PORT`, etc.).
+- **Node.js Code Executor**: Persistent Node.js server (Express + tsx) at port 3020 for JavaScript/TypeScript execution, replacing subprocess spawning per execution. The code executor plugins under `server/nodes/code/` call `NodeJSClient` which makes HTTP requests to the Node.js server. All config via environment variables (`NODEJS_EXECUTOR_URL`, `NODEJS_EXECUTOR_PORT`, etc.).
- **writeTodos Tool Node**: Dedicated AI tool for task planning connecting to any agent's `input-tools` handle. `TodoService` singleton (`server/services/todo_service.py`) stores JSON-based per-session todo state keyed by workflow_id. Handler broadcasts `phase: "todo_update"` via WebSocket on each update for real-time UI; `formatTodoOutput()` in `OutputDisplayPanel.tsx` renders the result as a checklist with `[ ]` / `[~]` / `[x]` icons. Schema uses `TodoItem`/`TodoStatus` Pydantic enum. Skill at `server/skills/assistant/write-todos-skill/SKILL.md` teaches the plan-work-update loop.
- **Temporal Activity Heartbeats**: Activities send `activity.heartbeat()` on every non-matching WebSocket broadcast inside the read loop in `services/temporal/activities.py`. This keeps long-running browser and claude_code_agent operations alive past the 2-minute `heartbeat_timeout`. Start/end heartbeats alone were causing `TIMEOUT_TYPE_HEARTBEAT` failures on ops taking 5-10 minutes. Connection config: `heartbeat=30`, `receive_timeout=540` (fits within 10-min `start_to_close_timeout`).
- **WebSocket `_safe_send` Guard**: `server/routers/websocket.py` checks `websocket.client_state.name != "CONNECTED"` before sending and logs at `debug` level (not `error`) on failure. Prevents "ASGI message after websocket.close" errors when broadcasts race with disconnects.
diff --git a/package.json b/package.json
index edeb8e9b..b5aceec6 100644
--- a/package.json
+++ b/package.json
@@ -114,6 +114,7 @@
"esbuild@<0.28.1": "^0.28.1",
"hono@<4.12.21": "^4.12.21",
"js-cookie@<3.0.7": "^3.0.7",
+ "js-yaml@>=4.0.0 <4.2.0": "^4.2.0",
"qs@<6.15.2": "^6.15.2",
"ws@<8.20.1": "^8.20.1"
}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7c676338..763cdd77 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -8,6 +8,7 @@ overrides:
esbuild@<0.28.1: ^0.28.1
hono@<4.12.21: ^4.12.21
js-cookie@<3.0.7: ^3.0.7
+ js-yaml@>=4.0.0 <4.2.0: ^4.2.0
qs@<6.15.2: ^6.15.2
ws@<8.20.1: ^8.20.1
@@ -4084,8 +4085,8 @@ packages:
resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
- resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}
+ resolution: {integrity: sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==}
hasBin: true
@@ -6877,7 +6878,7 @@ snapshots:
globals: 14.0.0
ignore: 5.3.2
import-fresh: 3.3.1
- js-yaml: 4.1.1
+ js-yaml: 4.3.0
minimatch: 3.1.5
strip-json-comments: 3.1.1
transitivePeerDependencies:
@@ -9415,7 +9416,7 @@ snapshots:
dependencies:
env-paths: 2.2.1
import-fresh: 3.3.1
- js-yaml: 4.1.1
+ js-yaml: 4.3.0
parse-json: 5.2.0
optionalDependencies:
typescript: 5.9.3
@@ -10575,7 +10576,7 @@ snapshots:
dependencies:
argparse: 2.0.1
diff --git a/server/requirements.txt b/server/requirements.txt
index 84536e25..91d8ed18 100644
--- a/server/requirements.txt
+++ b/server/requirements.txt
@@ -250,13 +250,13 @@ langchain-text-splitters==1.1.2
# via machinaos-server
langgraph==1.1.6
# via langchain
-langgraph-checkpoint==4.0.1
+langgraph-checkpoint==4.1.1
# via
# langgraph
# langgraph-prebuilt
langgraph-prebuilt==1.0.9
# via langgraph
-langgraph-sdk==0.3.13
+langgraph-sdk==0.3.15
# via langgraph
langsmith==0.8.14
# via
@@ -379,6 +379,8 @@ pydantic==2.12.5
# xdk
pydantic-core==2.41.5
# via pydantic
+pydantic-monty==0.0.18
+ # via machinaos-server
pydantic-settings==2.13.1
# via
# crawlee
@@ -528,6 +530,7 @@ typing-extensions==4.15.0
# portkey-ai
# pydantic
# pydantic-core
+ # pydantic-monty
# pyee
# referencing
# sqlalchemy