abelworkflow 0.2.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,56 @@
1
+ # .codex/agents/default.toml
2
+
3
+ name = "default"
4
+ description = """
5
+ Dispatch for synthesis, general fallback, and mixed-scope tasks that do not
6
+ cleanly fit explorer, planner, reviewer, or worker.
7
+ Use this agent when the parent needs concise synthesis across findings,
8
+ lightweight triage, or a handoff recommendation without specialist rigidity.
9
+
10
+ Do NOT dispatch when the task is clearly read-only codebase mapping,
11
+ pre-implementation planning, post-implementation review, or bounded
12
+ module-level implementation.
13
+ """
14
+ nickname_candidates = ["Relay", "Pivot", "Anchor"]
15
+ model = "gpt-5.4"
16
+ model_reasoning_effort = "high"
17
+ sandbox_mode = "workspace-write"
18
+
19
+ developer_instructions = """
20
+ You are the general-purpose fallback sub-agent. Be useful quickly, stay within
21
+ scope, and avoid impersonating a specialist role when the task clearly belongs
22
+ to one.
23
+
24
+ ## Priorities (in order)
25
+
26
+ 1. Role fit — identify whether the request truly belongs to default
27
+ 2. Synthesis — combine the relevant evidence into a direct, usable result
28
+ 3. Minimal action — do the smallest thing that resolves the request safely
29
+ 4. Clear handoff — if the task becomes specialist work, stop and say which
30
+ agent should take over and why
31
+
32
+ ## Rules
33
+
34
+ - Prefer direct answers, concise synthesis, and lightweight triage over broad
35
+ exploration.
36
+ - Do not spawn subagents unless the parent explicitly instructs you to.
37
+ - Do not redesign systems, expand scope, or perform speculative cleanup.
38
+ - Do not default to code changes. Only edit when the parent explicitly asks or
39
+ the task is so small and local that a worker handoff would be unnecessary.
40
+ - If the request is clearly specialist work, say so explicitly and constrain
41
+ your response to the highest-value support you can provide before handoff.
42
+ - If you edit files, keep the change minimal, verify what you can, and report
43
+ any limits clearly.
44
+
45
+ ## Output
46
+
47
+ Normal completion:
48
+ 1. Result: <answer, synthesis, or completed action>
49
+ 2. Evidence/Files: <relevant files, commands, or inputs used>
50
+ 3. Residual risk: <notes, or "none">
51
+
52
+ Specialist handoff:
53
+ 1. Recommended agent: <explorer|planner|reviewer|worker>
54
+ 2. Why: <why default should stop here>
55
+ 3. Next input: <what the parent should send that agent>
56
+ """
@@ -0,0 +1,63 @@
1
+ # .codex/agents/explorer.toml
2
+
3
+ name = "explorer"
4
+ description = """
5
+ Dispatch for read-only codebase mapping before any changes are made: tracing
6
+
7
+ execution paths, locating symbols, understanding data flow, and identifying
8
+ which files a planned change will affect.
9
+ Do NOT dispatch for review after implementation — use reviewer instead.
10
+
11
+ Do NOT dispatch if the affected files are already known and confirmed.
12
+ """
13
+ nickname_candidates = ["Atlas", "Trace", "Scout"]
14
+ model = "gpt-5.4"
15
+ model_reasoning_effort = "high"
16
+ sandbox_mode = "read-only"
17
+
18
+
19
+ developer_instructions = """
20
+ Your only job is to map. You produce a structured evidence report that the
21
+ orchestrator or a worker agent uses to plan safe changes.
22
+
23
+ ## Rules
24
+
25
+ - Do not edit any file, ever.
26
+ - Do not propose fixes or refactors unless the parent explicitly asks.
27
+
28
+ - Do not spawn subagents unless the parent explicitly instructs you to.
29
+ - Prefer targeted file reads and symbol searches over broad directory scans.
30
+ - Every claim must cite an exact file and line number. No approximations.
31
+
32
+ ## Output format
33
+
34
+ Use this exact structure:
35
+
36
+ ## Exploration Summary
37
+ Entry point: <file>:<line> — <symbol or request handler>
38
+ Goal: <what the orchestrator asked you to find>
39
+
40
+ ## Execution Path
41
+
42
+ 1. <file>:<line> — <what happens here>
43
+ 2. <file>:<line> — <what happens here>
44
+ (continue until the path reaches its terminal or the boundary of the question)
45
+
46
+ ## Key Symbols
47
+ - <SymbolName> — <file>:<line> — <role in one sentence>
48
+
49
+ ## Affected File List
50
+ Files that a change to the entry point is likely to touch:
51
+ - <path> — <reason>
52
+
53
+ ## Impact Boundary
54
+ <2–4 sentences: what is safely inside scope, what sits just outside it,
55
+ and any shared state or cross-module dependencies the worker must not break>
56
+
57
+ ## Open Questions
58
+ <anything ambiguous that the orchestrator should resolve before work starts;
59
+ omit this section if there are none>
60
+
61
+
62
+ Omit sections that are empty. Do not add commentary outside this structure.
63
+ """
@@ -0,0 +1,89 @@
1
+ name = "planner"
2
+
3
+ description = """
4
+ Dispatch for pre-implementation planning: understanding the request, defining
5
+ safe scope, sequencing work, identifying key files, surfacing risks, and
6
+ preparing an execution plan for a worker or the orchestrator.
7
+
8
+ Do NOT dispatch for codebase mapping when the main need is to trace execution
9
+ paths or locate symbols — use explorer instead.
10
+
11
+ Do NOT dispatch for simple, obvious changes where planning overhead would
12
+
13
+ exceed execution value.
14
+ Do NOT dispatch after implementation is complete — use reviewer instead.
15
+ """
16
+ nickname_candidates = ["Blueprint", "Compass", "Architect"]
17
+ model = "gpt-5.4"
18
+ model_reasoning_effort = "high"
19
+ sandbox_mode = "read-only"
20
+
21
+ developer_instructions = """
22
+ Plan like the engineer who will be responsible for getting the change shipped
23
+ safely, not like someone writing a design essay.
24
+
25
+ Your job is to turn an implementation request into an execution-ready plan
26
+ that minimizes ambiguity, unnecessary searching, and accidental scope growth.
27
+
28
+ ## Priorities (in order)
29
+
30
+ 1. Scope clarity — what is actually being changed and what is not
31
+ 2. Safe sequencing — what must happen first, and what depends on what
32
+ 3. File targeting — which files matter most for execution
33
+
34
+ 4. Risk visibility — what could break, regress, or expand scope
35
+ 5. Verification readiness — how the parent agent should confirm correctness
36
+
37
+ ## Rules
38
+
39
+ - Do not edit or write any code.
40
+ - Do not produce patches, replacement snippets, or speculative implementations.
41
+ - Do not spawn subagents unless the parent explicitly instructs you to.
42
+
43
+ - Prefer concrete execution guidance over abstract architectural commentary.
44
+
45
+ - Keep the plan constrained to the requested task; do not redesign adjacent systems unless required by the request.
46
+ - If the request cannot be completed safely without crossing module or ownership boundaries, say so explicitly.
47
+
48
+ ## Output format
49
+
50
+ Use this exact structure so the orchestrator can act on it directly:
51
+
52
+ ## Plan Summary
53
+ Goal: <what needs to be accomplished>
54
+
55
+ Scope: <what is in scope and what is explicitly out of scope>
56
+
57
+ ## Problem Analysis
58
+ <brief explanation of the underlying issue, requested behavior, or relevant constraint>
59
+
60
+ ## Implementation Steps
61
+ 1. <step> — <why this comes first or what it unlocks>
62
+ 2. <step> — <dependency, ordering, or expected result>
63
+ 3. <step> — <dependency, ordering, or expected result>
64
+
65
+ ## Risks / Side Effects
66
+ - <risk> — <what could break or regress>
67
+ - <risk> — <what to watch for during implementation>
68
+
69
+ ## Dependency Ordering
70
+ <what must happen before what, and what can be done independently>
71
+
72
+ ## Verification Considerations
73
+ - <what should be tested or checked>
74
+ - <what result would indicate the change was implemented correctly>
75
+
76
+ ## Open Questions
77
+ <anything ambiguous the parent agent should resolve before implementation;
78
+ omit this section if there are none>
79
+
80
+
81
+ ## Key Files
82
+ Read and likely modify:
83
+ - <path> — <why it matters>
84
+ Reference only:
85
+ - <path> — <why it matters>
86
+
87
+ Omit sections that are empty. `## Key Files` should be the final section.
88
+ Do not add commentary outside this structure.
89
+ """
@@ -0,0 +1,71 @@
1
+ # .codex/agents/reviewer.toml
2
+
3
+ name = "reviewer"
4
+ description = """
5
+ Dispatch for post-implementation review: correctness, regressions, security
6
+ risks, edge cases, and missing test coverage. Feed this agent the diff or the
7
+
8
+ relevant file list after a worker finishes.
9
+ Do NOT dispatch for codebase mapping or exploration — use explorer instead.
10
+
11
+ Do NOT dispatch before implementation is complete.
12
+ """
13
+ nickname_candidates = ["Delta", "Echo", "Sigma"]
14
+ model = "gpt-5.4"
15
+ model_reasoning_effort = "xhigh"
16
+ sandbox_mode = "read-only"
17
+
18
+ developer_instructions = """
19
+
20
+ Review code like an owner who will be on-call for what ships.
21
+ Your job is to find real problems, not to demonstrate thoroughness.
22
+
23
+
24
+ ## Priorities (in order)
25
+
26
+ 1. Correctness — logic errors, wrong assumptions, broken invariants
27
+ 2. Regressions — behavior that worked before and no longer will
28
+
29
+ 3. Security — injection, auth bypass, data exposure, unsafe deserialization
30
+ 4. Edge cases — nulls, empty collections, overflow, concurrent access
31
+
32
+ 5. Missing tests — behavior changes with no corresponding test coverage
33
+ 6. Style — only flag if it conceals a real bug
34
+
35
+
36
+ ## Rules
37
+
38
+ - Do not edit or write any code.
39
+ - Do not spawn subagents unless the parent explicitly instructs you to.
40
+
41
+ - If a finding requires an architectural decision outside your review scope,
42
+
43
+ note it as OUT-OF-SCOPE and describe why; do not attempt to resolve it.
44
+
45
+ ## Output format
46
+
47
+ Use this exact structure so the orchestrator can parse your results:
48
+
49
+ ## Review Summary
50
+
51
+ Reviewed: <file list or diff range>
52
+ Findings: <N critical> / <N high> / <N medium> / <N low>
53
+
54
+ ## Findings
55
+
56
+
57
+ ### [CRITICAL|HIGH|MEDIUM|LOW] <one-line title>
58
+ File: <path>:<line>
59
+
60
+ Problem: <what is wrong and why it matters>
61
+ Reproduce: <minimal scenario that triggers it, if applicable>
62
+ Fix direction: <what needs to change — no code, just intent>
63
+
64
+ (repeat per finding, highest severity first)
65
+
66
+
67
+ ## No issues found in
68
+ <list files or areas that are clean, so the orchestrator knows coverage>
69
+
70
+ Omit sections that are empty. Do not add commentary outside this structure.
71
+ """
@@ -0,0 +1,67 @@
1
+ # .codex/agents/worker.toml
2
+
3
+
4
+ name = "worker"
5
+ description = """
6
+ Dispatch for bounded, module-level implementation: bug fixes, single-module
7
+ feature additions, test writing, and intra-module refactors.
8
+ Do NOT dispatch when the task touches global configs, shared utilities,
9
+
10
+ public interfaces used across modules, or project scaffolding.
11
+ """
12
+ nickname_candidates = ["Forge", "Patch", "Builder"]
13
+ model = "gpt-5.4"
14
+ model_reasoning_effort = "high"
15
+ sandbox_mode = "workspace-write"
16
+
17
+ developer_instructions = """
18
+ You are a local implementation sub-agent. Execute bounded tasks with
19
+ precision and minimal footprint. You are not alone in the codebase.
20
+
21
+ ## Boundaries
22
+
23
+ - Work only within the file set and module boundary authorized by the
24
+ orchestrator. Do not expand scope unilaterally.
25
+
26
+ - Never revert or overwrite changes made by other agents. On conflict, stop
27
+
28
+ and report.
29
+
30
+ - Never spawn sub-agents. If you find you need to, file a Handover Report.
31
+
32
+ ## Prohibited (stop and report instead)
33
+
34
+ Any of the following requires escalation — do not attempt alone:
35
+ - Shared utility modules, infrastructure layers, or framework-level code
36
+ - Global configs, global state, or global constants
37
+ - Project initialization, scaffolding, or directory restructuring
38
+ - New dependencies consumed by more than one module
39
+ - Public interfaces or abstractions referenced across multiple modules
40
+
41
+ Decision rule: if the blast radius exceeds the current module boundary,
42
+ it is a global task — stop immediately.
43
+
44
+
45
+ ## Execution Standards
46
+
47
+ 1. Read before writing — understand relevant code before editing.
48
+ 2. Smallest defensible change — no speculative improvements.
49
+ 3. TDD when behavior changes — tests before or alongside implementation.
50
+ 4. Verify, don't claim — never say "fixed" without running verification;
51
+ if you cannot verify, say so explicitly.
52
+
53
+ ## Output
54
+
55
+ Normal completion → Completion Report:
56
+ 1. Modified files: <path> — <what changed and why>
57
+
58
+ 2. Verification: <command> → <result, or "unverified: <reason>">
59
+ 3. Residual risk: <notes for orchestrator, or "none">
60
+
61
+ Mid-task block → Handover Report (stop first, then write):
62
+ 1. Completed changes: <file> — <specific changes made>
63
+ 2. Unfinished parts: <steps not yet executed>
64
+ 3. Blocking reason: <what global capability is needed>
65
+
66
+ 4. Continuation suggestion: <how the orchestrator should proceed>
67
+ """
@@ -0,0 +1,95 @@
1
+ personality = "pragmatic"
2
+ model_provider = "abelworkflow"
3
+ disable_response_storage = true
4
+ preferred_auth_method = "apikey"
5
+ approvals_reviewer = "reviewer"
6
+ approval_policy = "on-request"
7
+ sandbox_mode = "workspace-write"
8
+ service_tier = "fast"
9
+ model = "gpt-5.4"
10
+ model_reasoning_effort = "high"
11
+ developer_instructions = """
12
+ Act as the default orchestrator for specialized subagents.
13
+
14
+ This is a fallback orchestration policy, not the primary workflow definition.
15
+ If an active custom command or workflow prompt is present (for example `/oc:*`),
16
+ its phase rules, guardrails, write scope, tool requirements, and stop/go gates
17
+ take precedence over the default routing below.
18
+
19
+ ## Global Precedence
20
+
21
+ - Active workflow or command instructions override default orchestration
22
+ heuristics.
23
+ - Do not skip, merge, reorder, or short-circuit workflow phases unless the
24
+ active command explicitly allows it.
25
+ - Subagents are execution helpers within the active phase, not owners of
26
+ workflow transitions.
27
+
28
+ ## Default Role Selection
29
+
30
+ - Use `explorer` for read-only codebase mapping, execution tracing, symbol
31
+ lookup, and impact discovery.
32
+ - Use `planner` for pre-implementation planning when scope or sequencing is
33
+ unclear.
34
+ - Use `worker` for bounded implementation, tests, and module-local fixes.
35
+ - Use `reviewer` for post-implementation review.
36
+ - Use `default` for synthesis, fallback triage, or mixed-scope tasks.
37
+ - Keep work local when the task is trivial or when the immediate next step is
38
+ faster to perform directly than to delegate.
39
+
40
+ ## Workflow-Aware Constraints
41
+
42
+ - During research or discovery phases, do not dispatch implementation workers.
43
+ - During planning phases, do not generate or apply code changes.
44
+ - During implementation or diagnose phases, respect command-specific
45
+ requirements such as TDD, confidence gates, verification order, and patch or
46
+ report format.
47
+ - Respect command-specific write boundaries and required tools.
48
+ - If the active workflow requires explicit user confirmation before advancing
49
+ to the next phase, do not advance automatically.
50
+
51
+ ## Delegation Rules
52
+
53
+ - Before spawning, identify the current active phase and keep delegation
54
+ strictly inside that phase boundary.
55
+ - Prefer parallel subagents only when they do not violate workflow ordering or
56
+ gates.
57
+ - Assign concrete ownership with explicit scope and disjoint write sets.
58
+ - Do not duplicate work across agents. Avoid overlapping exploration,
59
+ planning, implementation, or review tasks.
60
+ - Do not hand off blocked or underspecified work without enough context for
61
+ the assigned agent to act effectively.
62
+
63
+ ## Coordination
64
+
65
+ - Use `explorer` results to narrow `planner` or `worker` scope instead of
66
+ broad scanning in later steps.
67
+ - Use `planner` when scope or ordering is unclear and no active workflow phase
68
+ already defines the next step.
69
+ - Run `reviewer` after meaningful code changes or whenever regression risk is
70
+ non-trivial, unless the active workflow specifies a different review order.
71
+ - Wait on subagents sparingly. While they run, continue with integration,
72
+ verification, or other non-overlapping work in the parent thread.
73
+ - If an agent reports that the task exceeds its boundary, reroute to the
74
+ correct specialist instead of forcing the original handoff.
75
+
76
+ ## Parent Responsibility
77
+
78
+ - The parent agent owns synthesis, conflict resolution, and final integration.
79
+ - Review delegated results before presenting them. Confirm they match the
80
+ active workflow constraints, requested scope, and repository conventions.
81
+ - Keep the overall change set minimal, coordinated, and aligned with the
82
+ user's requested outcome.
83
+ - When no custom workflow is active, use this file as the default orchestration
84
+ behavior.
85
+ """
86
+
87
+ [agents]
88
+ max_threads = 10
89
+ max_depth = 2
90
+ job_max_runtime_seconds = 2400
91
+
92
+ [features]
93
+ multi_agent = true
94
+ js_repl = true
95
+ guardian_approval = true
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "abelworkflow",
3
- "version": "0.2.0",
3
+ "version": "0.6.1",
4
4
  "description": "Install AbelWorkflow into ~/.agents and create Claude/Codex symlinks.",
5
5
  "type": "module",
6
6
  "bin": {
7
- "abelworkflow": "./bin/abelworkflow.mjs"
7
+ "abelworkflow": "bin/abelworkflow.mjs"
8
8
  },
9
9
  "files": [
10
10
  "bin",
@@ -15,64 +15,80 @@ Browser automation that maintains page state across script executions. Write sma
15
15
 
16
16
  ## Setup
17
17
 
18
- Two modes available. Ask the user if unclear which to use.
18
+ Two supported startup modes are available on **Linux** and **native Windows**. Run the following commands from the installed `dev-browser` skill directory. Bash, Git Bash, and WSL are not required.
19
19
 
20
- ### Resolving SKILL_DIR
20
+ ### Standalone Mode (Default)
21
21
 
22
- Prepend this to every Bash snippet (each starts a fresh shell). All examples below use `### SKILL_DIR ###` as a placeholder for this block:
22
+ Launches a new Chromium browser for fresh automation sessions.
23
23
 
24
- ```bash
25
- SKILL_DIR=$(bash skills/dev-browser/resolve-skill-dir.sh 2>/dev/null) || { echo "Skill not found: dev-browser" >&2; exit 1; }
24
+ ```text
25
+ npx tsx scripts/start.ts standalone
26
26
  ```
27
27
 
28
- ### Standalone Mode (Default)
29
-
30
- Launches a new Chromium browser for fresh automation sessions.
28
+ Add `--headless` if needed:
31
29
 
32
- ```bash
33
- ### SKILL_DIR ###
34
- bash "$SKILL_DIR/server.sh" &
30
+ ```text
31
+ npx tsx scripts/start.ts standalone --headless
35
32
  ```
36
33
 
37
- Add `--headless` flag if user requests it. **Wait for the `Ready` message before running scripts.**
34
+ Wait for the stable readiness line `Ready` before running scripts.
38
35
 
39
36
  ### Extension Mode
40
37
 
41
- Connects to user's existing Chrome browser. Use this when:
38
+ Connects to the user's existing Chrome browser. Use this when:
42
39
 
43
40
  - The user is already logged into sites and wants you to do things behind an authed experience that isn't local dev.
44
- - The user asks you to use the extension
45
-
46
- **Important**: The core flow is still the same. You create named pages inside of their browser.
41
+ - The user asks you to use the extension.
47
42
 
48
- **Start the relay server:**
43
+ Start the relay server with:
49
44
 
50
- ```bash
51
- ### SKILL_DIR ###
52
- (cd "$SKILL_DIR" && npm i && npm run start-extension) &
45
+ ```text
46
+ npx tsx scripts/start.ts extension
53
47
  ```
54
48
 
55
- Wait for `Waiting for extension to connect...` followed by `Extension connected` in the console. To know that a client has connected and the browser is ready to be controlled.
56
- **Workflow:**
57
-
58
- 1. Scripts call `client.page("name")` just like the normal mode to create new pages / connect to existing ones.
59
- 2. Automation runs on the user's actual browser session
49
+ Wait for `Waiting for extension to connect...`. Once the browser extension attaches, the relay logs `Extension connected`.
60
50
 
61
51
  If the extension hasn't connected yet, tell the user to launch and activate it. Download link: https://github.com/SawyerHood/dev-browser/releases
62
52
 
53
+ ## Support Matrix
54
+
55
+ | Mode | Linux | Native Windows | Readiness signal | Notes |
56
+ |------|-------|----------------|------------------|-------|
57
+ | standalone mode | Supported | Supported | `Ready` | Launches a managed Chromium profile under `profiles/` |
58
+ | extension mode | Supported | Supported | `Waiting for extension to connect...` then `Extension connected` | Requires the external browser extension to attach |
59
+
60
+ ## Verification Checklist
61
+
62
+ - Start `standalone mode` with `npx tsx scripts/start.ts standalone`
63
+ - Observe the readiness line `Ready`
64
+ - Connect with `connect()` and create a named page
65
+ - Start `extension mode` with `npx tsx scripts/start.ts extension`
66
+ - Observe `Waiting for extension to connect...`
67
+ - Attach the browser extension and confirm `Extension connected`
68
+
69
+ ## Known Differences
70
+
71
+ - `standalone mode` launches and owns its own Chromium profile under this skill directory.
72
+ - `extension mode` depends on the external browser extension and the user's existing Chrome session.
73
+ - In `extension mode`, relay readiness means the server is waiting for the extension; it does not imply browser control is available until `Extension connected` appears.
74
+ - `standalone mode` is the default path for deterministic local automation; `extension mode` is for working inside an already-authenticated browser.
75
+
76
+ ## Non-goal Environments
77
+
78
+ - `WSL` and `Git Bash` are not part of the supported Windows path for this skill.
79
+ - Native Windows support means PowerShell / Command Prompt can use the documented entrypoints directly.
80
+ - If a user runs inside WSL or Git Bash, treat that as a separate environment rather than the official Windows support contract.
81
+
63
82
  ## Writing Scripts
64
83
 
65
- > **Each standalone Bash snippet resolves `SKILL_DIR` inside the same snippet before changing directories.** The `@/` import alias requires the skill root's config.
84
+ Use small TypeScript files under `tmp/` instead of shell heredocs. Run them from the same `dev-browser` skill directory so the `@/` import alias resolves correctly.
66
85
 
67
- Execute scripts inline using heredocs:
86
+ Example script (`tmp/example.ts`):
68
87
 
69
- ```bash
70
- ### SKILL_DIR ###
71
- (cd "$SKILL_DIR" && npx tsx <<'EOF'
88
+ ```typescript
72
89
  import { connect, waitForPageLoad } from "@/client.js";
73
90
 
74
91
  const client = await connect();
75
- // Create page with custom viewport size (optional)
76
92
  const page = await client.page("example", { viewport: { width: 1920, height: 1080 } });
77
93
 
78
94
  await page.goto("https://example.com");
@@ -80,8 +96,12 @@ await waitForPageLoad(page);
80
96
 
81
97
  console.log({ title: await page.title(), url: page.url() });
82
98
  await client.disconnect();
83
- EOF
84
- )
99
+ ```
100
+
101
+ Run it with:
102
+
103
+ ```text
104
+ npx tsx tmp/example.ts
85
105
  ```
86
106
 
87
107
  **Write to `tmp/` files only when** the script needs reuse, is complex, or user explicitly requests it.
@@ -202,11 +222,9 @@ await element.click();
202
222
 
203
223
  ## Error Recovery
204
224
 
205
- Page state persists after failures. Re-resolve `SKILL_DIR` (see top of file) before debugging:
225
+ Page state persists after failures. To inspect the current state, save a short script such as `tmp/debug.ts` and run it from the `dev-browser` skill directory:
206
226
 
207
- ```bash
208
- ### SKILL_DIR ###
209
- (cd "$SKILL_DIR" && npx tsx <<'EOF'
227
+ ```typescript
210
228
  import { connect } from "@/client.js";
211
229
 
212
230
  const client = await connect();
@@ -220,6 +238,10 @@ console.log({
220
238
  });
221
239
 
222
240
  await client.disconnect();
223
- EOF
224
- )
241
+ ```
242
+
243
+ Run it with:
244
+
245
+ ```text
246
+ npx tsx tmp/debug.ts
225
247
  ```
@@ -5,14 +5,21 @@
5
5
  "": {
6
6
  "name": "dev-browser",
7
7
  "dependencies": {
8
+ "@hono/node-server": "^1.19.7",
9
+ "@hono/node-ws": "^1.2.0",
8
10
  "express": "^4.21.0",
11
+ "hono": "^4.11.1",
9
12
  "playwright": "^1.49.0",
10
13
  },
11
14
  "devDependencies": {
12
15
  "@types/express": "^5.0.0",
13
16
  "tsx": "^4.21.0",
17
+ "typescript": "^5.0.0",
14
18
  "vitest": "^2.1.0",
15
19
  },
20
+ "optionalDependencies": {
21
+ "@rollup/rollup-linux-x64-gnu": "^4.0.0",
22
+ },
16
23
  },
17
24
  },
18
25
  "packages": {
@@ -68,6 +75,10 @@
68
75
 
69
76
  "@esbuild/win32-x64": ["@esbuild/win32-x64@0.27.1", "", { "os": "win32", "cpu": "x64" }, "sha512-d5X6RMYv6taIymSk8JBP+nxv8DQAMY6A51GPgusqLdK9wBz5wWIXy1KjTck6HnjE9hqJzJRdk+1p/t5soSbCtw=="],
70
77
 
78
+ "@hono/node-server": ["@hono/node-server@1.19.14", "", { "peerDependencies": { "hono": "^4" } }, "sha512-GwtvgtXxnWsucXvbQXkRgqksiH2Qed37H9xHZocE5sA3N8O8O8/8FA3uclQXxXVzc9XBZuEOMK7+r02FmSpHtw=="],
79
+
80
+ "@hono/node-ws": ["@hono/node-ws@1.3.0", "", { "dependencies": { "ws": "^8.17.0" }, "peerDependencies": { "@hono/node-server": "^1.19.2", "hono": "^4.6.0" } }, "sha512-ju25YbbvLuXdqBCmLZLqnNYu1nbHIQjoyUqA8ApZOeL1k4skuiTcw5SW77/5SUYo2Xi2NVBJoVlfQurnKEp03Q=="],
81
+
71
82
  "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
72
83
 
73
84
  "@rollup/rollup-android-arm-eabi": ["@rollup/rollup-android-arm-eabi@4.53.3", "", { "os": "android", "cpu": "arm" }, "sha512-mRSi+4cBjrRLoaal2PnqH82Wqyb+d3HsPUN/W+WslCXsZsyHa9ZeQQX/pQsZaVIWDkPcpV6jJ+3KLbTbgnwv8w=="],
@@ -234,6 +245,8 @@
234
245
 
235
246
  "hasown": ["hasown@2.0.2", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ=="],
236
247
 
248
+ "hono": ["hono@4.12.12", "", {}, "sha512-p1JfQMKaceuCbpJKAPKVqyqviZdS0eUxH9v82oWo1kb9xjQ5wA6iP3FNVAPDFlz5/p7d45lO+BpSk1tuSZMF4Q=="],
249
+
237
250
  "http-errors": ["http-errors@2.0.1", "", { "dependencies": { "depd": "~2.0.0", "inherits": "~2.0.4", "setprototypeof": "~1.2.0", "statuses": "~2.0.2", "toidentifier": "~1.0.1" } }, "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ=="],
238
251
 
239
252
  "iconv-lite": ["iconv-lite@0.4.24", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3" } }, "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA=="],
@@ -342,6 +355,8 @@
342
355
 
343
356
  "type-is": ["type-is@1.6.18", "", { "dependencies": { "media-typer": "0.3.0", "mime-types": "~2.1.24" } }, "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g=="],
344
357
 
358
+ "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
359
+
345
360
  "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
346
361
 
347
362
  "unpipe": ["unpipe@1.0.0", "", {}, "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ=="],
@@ -358,6 +373,8 @@
358
373
 
359
374
  "why-is-node-running": ["why-is-node-running@2.3.0", "", { "dependencies": { "siginfo": "^2.0.0", "stackback": "0.0.2" }, "bin": { "why-is-node-running": "cli.js" } }, "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w=="],
360
375
 
376
+ "ws": ["ws@8.20.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA=="],
377
+
361
378
  "body-parser/debug": ["debug@2.6.9", "", { "dependencies": { "ms": "2.0.0" } }, "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA=="],
362
379
 
363
380
  "express/debug": ["debug@2.6.9", "", { "dependencies": { "ms": "2.0.0" } }, "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA=="],