@jshookmcp/jshook 0.2.3 → 0.2.6

package/workflows/qwen-mail-open-latest/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "noEmit": false,
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["workflow.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/workflows/qwen-mail-open-latest/workflow.ts

@@ -0,0 +1,77 @@
+import {
+  createWorkflow,
+  SequenceNodeBuilder,
+} from '@jshookmcp/extension-sdk/workflow';
+
+// =====================================================
+// Workflow 1: Qwen Mail Activate Link Extractor
+// =====================================================
+
+const activateWorkflowId = 'workflow.qwen-mail-activate.v1';
+
+export const qwenMailActivate = createWorkflow(activateWorkflowId, 'Qwen Mail Activate')
+  .description('Open temp mailbox, refresh inbox, and extract Qwen activation/verify links.')
+  .tags(['workflow', 'qwen', 'mail', 'activate'])
+  .timeoutMs(3 * 60_000)
+  .defaultMaxConcurrency(1)
+  .buildGraph(() => {
+    const root = new SequenceNodeBuilder('qwen-mail-activate-root');
+
+    root
+      .tool('open-mailbox', 'page_navigate', {
+        input: {
+          url: 'https://www.linshiyouxiang.net',
+        },
+      })
+      .tool('refresh-inbox', 'page_press_key', {
+        input: { key: 'F5' },
+      })
+      .tool('wait-load', 'page_wait_for_selector', {
+        input: { selector: '.mail-list', timeout: 5000 },
+      })
+      .tool('extract-link', 'temp_mail_extract_link', {
+        config: {
+          linkPattern: '/activate',
+        },
+      });
+
+    return root;
+  });
+
+// =====================================================
+// Workflow 2: Qwen Mail Open Latest
+// =====================================================
+
+const openLatestWorkflowId = 'workflow.qwen-mail-open-latest.v1';
+
+export const qwenMailOpenLatest = createWorkflow(openLatestWorkflowId, 'Qwen Mail Open Latest')
+  .description('Navigate mailbox, refresh, and open latest Qwen-related mail item if present.')
+  .tags(['workflow', 'qwen', 'mail'])
+  .timeoutMs(3 * 60_000)
+  .defaultMaxConcurrency(1)
+  .buildGraph(() => {
+    const root = new SequenceNodeBuilder('qwen-mail-open-latest-root');
+
+    root
+      .tool('open-mailbox', 'page_navigate', {
+        input: {
+          url: 'https://www.linshiyouxiang.net',
+        },
+      })
+      .tool('refresh-inbox', 'page_press_key', {
+        input: { key: 'F5' },
+      })
+      .tool('wait-load', 'page_wait_for_selector', {
+        input: { selector: '.mail-list', timeout: 5000 },
+      })
+      .tool('open-latest', 'temp_mail_open_latest', {
+        config: {
+          subjectPattern: 'qwen',
+        },
+      });
+
+    return root;
+  });
+
+// Default export: first workflow for backwards compatibility
+export default qwenMailActivate;

package/workflows/register-account-flow/.jshook-install.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "kind": "workflow",
+  "slug": "register-account-flow",
+  "id": "workflow.register-account-flow.v1",
+  "source": {
+    "type": "git",
+    "repo": "https://github.com/vmoranv/jshook_workflow_register_account_flow",
+    "ref": "main",
+    "commit": "fb1d112",
+    "subpath": ".",
+    "entry": "workflow.ts"
+  }
+}

package/workflows/register-account-flow/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vmoranv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/workflows/register-account-flow/README.md

@@ -0,0 +1,64 @@
+# register-account-flow workflow
+
+Declarative workflow for account registration: open a registration page, fill standard fields, submit the form, extract auth findings, and optionally coordinate email verification through shared tab context.
+
+## Entry File
+
+- `workflow.ts`
+
+## Workflow ID
+
+- `workflow.register-account-flow.v1`
+
+## Structure
+
+This workflow mirrors the built-in `handleRegisterAccountFlow` logic as a declarative graph:
+
+- `network_enable` before navigation for request/error capture
+- `page_navigate` to the registration page
+- `page_type` steps for `username`, `email`, and `password`
+- Optional checkbox activation via `page_evaluate`
+- `page_click` to submit the form
+- `page_evaluate` delay step to allow registration requests to settle
+- `network_extract_auth` to collect token/auth findings
+- Optional `tab_workflow` branch to open an email tab and transfer the verification URL into shared context
+- `console_execute` summary step for downstream automation
+
+## Tools Used
+
+- `network_enable`
+- `page_navigate`
+- `page_type`
+- `page_evaluate`
+- `page_click`
+- `network_extract_auth`
+- `tab_workflow`
+- `console_execute`
+
+## Config
+
+- `workflows.registerAccount.registerUrl`
+- `workflows.registerAccount.username`
+- `workflows.registerAccount.email`
+- `workflows.registerAccount.password`
+- `workflows.registerAccount.submitSelector`
+- `workflows.registerAccount.enableTermsCheckbox`
+- `workflows.registerAccount.termsSelector`
+- `workflows.registerAccount.emailProviderUrl`
+- `workflows.registerAccount.verificationLinkPattern`
+- `workflows.registerAccount.timeoutMs`
+
+## Notes
+
+- The email-verification branch stores the discovered URL under shared key `__verificationLink`.
+- A downstream runner can read that context value and decide whether to navigate, verify, or hand off to another workflow.
+- If `emailProviderUrl` is empty, the verification branch is skipped.
+
+## Local Validation
+
+1. Run `pnpm install`.
+2. Run `pnpm typecheck`.
+3. Put this repo under a configured `workflows/` extension root.
+4. Run `extensions_reload` in `jshookmcp`.
+5. Confirm the workflow appears in `extensions_list`.
+6. Execute the workflow and verify registration, auth extraction, and optional verification-link transfer.

package/workflows/register-account-flow/meta.yaml

@@ -0,0 +1,4 @@
+name: register-account-flow
+description: Declarative workflow for account registration, token capture, and optional email verification.
+author: vmoranv
+source_repo: https://github.com/vmoranv/jshook_workflow_register_account_flow

package/workflows/register-account-flow/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@jshookmcpextension/workflow-register-account-flow",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "dotenv": "^17.3.1",
+"@jshookmcp/extension-sdk": "^0.3.0"
+  },
+  "version": "0.1.0",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
+  },
+  "private": true,
+  "packageManager": "pnpm@10.28.2"
+}

package/workflows/register-account-flow/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "rootDir": ".",
+    "outDir": "dist"
+  },
+  "include": ["workflow.ts"],
+  "exclude": ["dist", "node_modules"]
+}

package/workflows/register-account-flow/workflow.ts

@@ -0,0 +1,127 @@
+import type { WorkflowContract } from '@jshookmcp/extension-sdk/workflow';
+import { toolNode, sequenceNode, branchNode } from '@jshookmcp/extension-sdk/workflow';
+
+const workflow: WorkflowContract = {
+  kind: 'workflow-contract',
+  version: 1,
+  id: 'workflow.register-account-flow.v1',
+  displayName: 'Register Account Flow',
+  description:
+    'Register via page automation, capture auth artifacts, and optionally perform single-tab email verification without tab_workflow.',
+  tags: ['workflow', 'registration', 'auth', 'verification', 'automation'],
+  timeoutMs: 10 * 60_000,
+  defaultMaxConcurrency: 1,
+
+  build(ctx) {
+    const prefix = 'workflows.registerAccount';
+    const registerUrl = ctx.getConfig<string>(`${prefix}.registerUrl`, 'https://example.com/register');
+    const submitSelector = ctx.getConfig<string>(`${prefix}.submitSelector`, "button[type='submit']");
+    const emailProviderUrl = ctx.getConfig<string>(`${prefix}.emailProviderUrl`, '');
+    const verificationLinkPattern = ctx.getConfig<string>(`${prefix}.verificationLinkPattern`, '/api/v1/auths/activate');
+    const timeoutMs = ctx.getConfig<number>(`${prefix}.timeoutMs`, 90_000);
+    const authMinConfidence = ctx.getConfig<number>(`${prefix}.authMinConfidence`, 0.3);
+    const emailPollingWaitMs = ctx.getConfig<number>(`${prefix}.emailPollingWaitMs`, 6000);
+
+    const username = ctx.getConfig<string>(`${prefix}.username`, 'demo-user');
+    const email = ctx.getConfig<string>(`${prefix}.email`, 'demo@example.com');
+    const password = ctx.getConfig<string>(`${prefix}.password`, 'DemoPassword123!');
+    const includeConfirmPassword = ctx.getConfig<boolean>(`${prefix}.includeConfirmPassword`, true);
+    const confirmPasswordFieldName = ctx.getConfig<string>(`${prefix}.confirmPasswordFieldName`, 'checkPassword');
+    const extraFields = ctx.getConfig<Record<string, unknown>>(`${prefix}.extraFields`, {});
+    const enableTermsCheckbox = ctx.getConfig<boolean>(`${prefix}.enableTermsCheckbox`, false);
+    const termsSelector = ctx.getConfig<string>(`${prefix}.termsSelector`, "input[type='checkbox']");
+    const checkboxSelectors = ctx.getConfig<string[]>(
+      `${prefix}.checkboxSelectors`,
+      enableTermsCheckbox && termsSelector ? [termsSelector] : [],
+    );
+
+    const fields: Record<string, unknown> = { username, email, password, ...extraFields };
+    if (includeConfirmPassword) fields[confirmPasswordFieldName] = password;
+
+    const fillForm = sequenceNode('fill-form');
+    for (const [name, value] of Object.entries(fields)) {
+      fillForm.step(toolNode(`type-${name}`, 'page_type').input({
+        selector: `input[name='${name}']`, text: String(value), delay: 20,
+      }));
+    }
+
+    const clickCheckboxes = sequenceNode('click-checkboxes');
+    checkboxSelectors.forEach((selector, index) => {
+      clickCheckboxes.step(toolNode(`checkbox-${index + 1}`, 'page_evaluate').input({
+        code: `(function(){const cb=document.querySelector(${JSON.stringify(selector)});if(!cb)return false;cb.click();if('checked' in cb){cb.checked=true;}cb.dispatchEvent(new Event('change',{bubbles:true}));return true;})()`,
+      }));
+    });
+
+    const verificationBranch = branchNode('maybe-email-verification', 'register_account_email_verification_enabled')
+      .predicateFn(() => Boolean(emailProviderUrl))
+      .whenTrue(sequenceNode('email-verification-sequence')
+        .step(toolNode('navigate-email-provider', 'page_navigate').input({ url: emailProviderUrl, waitUntil: 'networkidle', enableNetworkMonitoring: true }))
+        .step(toolNode('wait-email-poll', 'page_evaluate')
+          .input({ code: `new Promise(resolve => setTimeout(() => resolve({ waitedMs: ${emailPollingWaitMs} }), ${emailPollingWaitMs}))` })
+          .timeout(Math.max(10_000, emailPollingWaitMs + 2_000)))
+        .step(toolNode('open-latest-mail', 'page_evaluate').input({
+          code: `(function(){
+            const anchors = Array.from(document.querySelectorAll('#message-list a'));
+            const view = anchors.find(a => (a.getAttribute('href') || '').includes('/mail/view/'));
+            if (!view) return { success: false, step: 'open-latest-mail' };
+            const href = view.href || view.getAttribute('href');
+            if (!href) return { success: false, step: 'open-latest-mail', reason: 'empty-href' };
+            window.location.href = href;
+            return { success: true, step: 'open-latest-mail', href };
+          })()`,
+        }))
+        .step(toolNode('wait-mail-detail', 'page_evaluate')
+          .input({ code: 'new Promise(resolve => setTimeout(() => resolve({ waitedMs: 1500 }), 1500))' })
+          .timeout(10_000))
+        .step(toolNode('open-verification-link', 'page_evaluate').input({
+          code: `(function(){
+            const links = Array.from(document.querySelectorAll('a'));
+            const match = links.find(a => (a.href || '').includes(${JSON.stringify(verificationLinkPattern)}));
+            if (!match) return { success: false, step: 'open-verification-link' };
+            const href = match.href || match.getAttribute('href');
+            if (!href) return { success: false, step: 'open-verification-link', reason: 'empty-href' };
+            window.location.href = href;
+            return { success: true, step: 'open-verification-link', href };
+          })()`,
+        }))
+        .step(toolNode('wait-verification-finish', 'page_evaluate')
+          .input({ code: 'new Promise(resolve => setTimeout(() => resolve({ waitedMs: 2500 }), 2500))' })
+          .timeout(10_000)))
+      .whenFalse(toolNode('skip-email-verification', 'console_execute').input({
+        expression: '({ skipped: true, step: "email_verification", reason: "config_disabled" })',
+      }));
+
+    return sequenceNode('register-account-flow-root')
+      .step(toolNode('enable-network', 'network_enable').input({ enableExceptions: true }))
+      .step(toolNode('navigate-register-page', 'page_navigate').input({ url: registerUrl, waitUntil: 'networkidle', enableNetworkMonitoring: true }))
+      .step(toolNode('wait-first-field', 'page_wait_for_selector').input({
+        selector: `input[name='${Object.keys(fields)[0] ?? 'email'}']`, timeout: 15000,
+      }))
+      .step(fillForm)
+      .step(clickCheckboxes)
+      .step(toolNode('submit-registration-form', 'page_click').input({ selector: submitSelector }))
+      .step(toolNode('wait-after-submit', 'page_evaluate')
+        .input({ code: 'new Promise(resolve => setTimeout(() => resolve({ waitedMs: 2000 }), 2000))' })
+        .timeout(10_000))
+      .step(toolNode('extract-auth-findings', 'network_extract_auth').input({ minConfidence: authMinConfidence }))
+      .step(verificationBranch)
+      .step(toolNode('registration-summary', 'console_execute').input({
+        expression: `(${JSON.stringify({ status: 'registration_flow_complete', registerUrl, email, emailProviderUrl, verificationLinkPattern })})`,
+      }))
+      .build();
+  },
+
+  onStart(ctx) {
+    ctx.emitMetric('workflow_runs_total', 1, 'counter', { workflowId: 'workflow.register-account-flow.v1', stage: 'start' });
+  },
+
+  onFinish(ctx) {
+    ctx.emitMetric('workflow_runs_total', 1, 'counter', { workflowId: 'workflow.register-account-flow.v1', stage: 'finish' });
+  },
+
+  onError(ctx, error) {
+    ctx.emitMetric('workflow_errors_total', 1, 'counter', { workflowId: 'workflow.register-account-flow.v1', error: error.name });
+  },
+};
+
+export default workflow;

package/workflows/replay-lab/.jshook-install.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "kind": "workflow",
+  "slug": "replay-lab",
+  "id": "workflow.replay-lab.v1",
+  "source": {
+    "type": "git",
+    "repo": "https://github.com/vmoranv/jshook_workflow_replay_lab",
+    "ref": "main",
+    "commit": "e6125eee343b3ef7e39f37ec69144d4d774b7eea",
+    "subpath": ".",
+    "entry": "workflow.ts"
+  }
+}

package/workflows/replay-lab/meta.yaml

@@ -0,0 +1,6 @@
+name: replay-lab
+description: JSHook workflow for replay-lab
+author: vmoranv
+tags:
+  - workflow
+  - replay-lab

package/workflows/replay-lab/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "jshook-workflow-replay-lab",
+  "private": true,
+  "version": "0.1.0",
+  "description": "jshookmcp workflow: replay-lab",
+  "type": "module",
+  "packageManager": "pnpm@10.28.2",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@jshookmcp/extension-sdk": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}