@easynet/agent-runtime 1.0.2 → 1.0.4

package/apps/imessagebot/scripts/resolve-deps.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * resolve-deps.js
+ *
+ * Run automatically via `preinstall` npm hook.
+ * In CI (CI=true), rewrites file: references in package.json to npm versions
+ * so that `npm install` can resolve them without local sibling directories.
+ *
+ * Local development: no-op (CI env var is not set).
+ */
+
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgPath = resolve(__dirname, '..', 'package.json');
+
+if (!process.env.CI) {
+  process.exit(0);
+}
+
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+let changed = false;
+
+for (const section of ['dependencies', 'devDependencies']) {
+  const deps = pkg[section];
+  if (!deps) continue;
+  for (const [name, version] of Object.entries(deps)) {
+    if (name.startsWith('@easynet/') && typeof version === 'string' && version.startsWith('file:')) {
+      deps[name] = 'latest';
+      changed = true;
+      console.log(`[resolve-deps] ${name}: file: → latest`);
+    }
+  }
+}
+
+if (changed) {
+  writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+  console.log('[resolve-deps] package.json updated for CI.');
+}

package/apps/imessagebot/scripts/test-llm.mjs

@@ -0,0 +1,27 @@
+/**
+ * Quick LLM config test. Run from app root: npm run test:llm
+ */
+import { createAgentLlm } from "@easynet/agent-model";
+
+async function main() {
+  try {
+    console.log("[test-llm] Loading LLM from config/agents/shared/model.yaml ...");
+    const llm = await createAgentLlm({
+      configPath: "config/agents/shared/model.yaml",
+      checkConnectivity: false,
+    });
+
+    console.log("[test-llm] Invoking LLM ...");
+    const res = await llm.invoke(
+      "In one sentence, introduce yourself and say you are being used to test iMessageBot's LLM config."
+    );
+
+    console.log("[test-llm] Raw response:");
+    console.log(JSON.stringify(res, null, 2));
+  } catch (err) {
+    console.error("[test-llm] Error:", err);
+    process.exit(1);
+  }
+}
+
+main();

package/apps/imessagebot/scripts/validate-tools-config.mjs

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { loadYamlFile } from "@easynet/agent-common";
+import { createLangChainAgentTools } from "@easynet/agent-tool/api";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const APP_ROOT = resolve(__dirname, "..");
+const CONFIG_DIR = resolve(APP_ROOT, "config");
+
+function fail(message) {
+  console.error(`[validate-tools-config] ${message}`);
+  process.exit(1);
+}
+
+function assert(condition, message) {
+  if (!condition) fail(message);
+}
+
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function normalizePath(p, baseDir = APP_ROOT) {
+  return p.startsWith("/") ? p : resolve(baseDir, p);
+}
+
+async function loadYaml(path) {
+  const v = await loadYamlFile(path);
+  return v ?? {};
+}
+
+function getCoreToolsOptions() {
+  return {
+    sandboxRoot: APP_ROOT,
+    allowedHosts: ["api.github.com", "duckduckgo.com", "www.duckduckgo.com"],
+  };
+}
+
+function resolveToolConfigPaths(reactAgentConfig, reactAgentDir) {
+  return {
+    toolsDefaultPath: normalizePath(reactAgentConfig?.spec?.tools?.ref ?? "../shared/tool.yaml", reactAgentDir),
+    toolsDevPath: normalizePath(reactAgentConfig?.spec?.tools?.development ?? "../shared/tool.development.yaml", reactAgentDir),
+    toolsProdPath: normalizePath(reactAgentConfig?.spec?.tools?.production ?? "../shared/tool.production.yaml", reactAgentDir),
+  };
+}
+
+function extractToolsConfigSummary(config) {
+  const spec = config?.spec ?? {};
+  const toolsNode = spec?.tools ?? {};
+  return {
+    tools: asArray(toolsNode?.list ?? toolsNode),
+    sandboxedPath: toolsNode?.sandboxedPath ?? spec?.sandboxedPath,
+  };
+}
+
+function validateDefaultConfig(defaultConfig) {
+  const summary = extractToolsConfigSummary(defaultConfig);
+  assert(typeof summary.sandboxedPath === "string", "tool.yaml missing sandboxedPath");
+  assert(summary.tools.length > 0, "tool.yaml tools must not be empty");
+  assert(
+    summary.tools.some(
+      (t) =>
+        typeof t === "string" &&
+        (t.startsWith("file:") || t.startsWith("npm:@easynet/agent-tool-buildin")),
+    ),
+    "tool.yaml should use file:... or npm:@easynet/agent-tool-buildin",
+  );
+  return summary;
+}
+
+function validateVariantConfig(args) {
+  const { config, label, expectedSandboxedPath, defaultLoadedToolsLength, configFilePath } = args;
+  const summary = extractToolsConfigSummary(config);
+  assert(typeof summary.sandboxedPath === "string", `${label} missing sandboxedPath`);
+  assert(summary.sandboxedPath === expectedSandboxedPath, `${label} sandboxedPath should match tool.yaml`);
+  assert(summary.tools.length > 0, `${label} tools must not be empty`);
+  const loadedTools = createLangChainAgentTools({ configFilePath, coreTools: getCoreToolsOptions() });
+  assert(
+    loadedTools.length === defaultLoadedToolsLength,
+    `${label} count mismatch: default=${defaultLoadedToolsLength}, current=${loadedTools.length}`,
+  );
+}
+
+function assertRequiredToolsLoaded(defaultLoadedTools) {
+  const names = new Set(defaultLoadedTools.map((t) => t.name));
+  const hasTool = (shortName) =>
+    Array.from(names).some((fullName) => fullName === shortName || fullName.endsWith(`.${shortName}`));
+  const required = [
+    "platformGetCapabilities",
+    "messagesListChats",
+    "messagesReadChat",
+    "messagesSendByHandle",
+    "notesList",
+    "notesRead",
+    "notesCreate",
+    "remindersList",
+    "remindersCreate",
+    "calendarListEvents",
+    "calendarCreateEvent",
+    "safariGetActiveTab",
+    "safariReadPageContent",
+    "cronListEntries",
+    "cronSetTaggedEntry",
+    "gitStatus",
+    "ghRead",
+  ];
+  for (const name of required) {
+    assert(hasTool(name), `required tool not loaded: ${name}`);
+  }
+}
+
+async function main() {
+  const appYamlPath = resolve(CONFIG_DIR, "app.yaml");
+  assert(existsSync(appYamlPath), `missing config file: ${appYamlPath}`);
+
+  const appConfig = await loadYaml(appYamlPath);
+  const appConfigDir = dirname(appYamlPath);
+  const reactAgentRef = appConfig?.spec?.agents?.list?.react?.ref;
+  const reactAgentYamlPath = normalizePath(reactAgentRef ?? "./agents/react/agent.yaml", appConfigDir);
+  assert(existsSync(reactAgentYamlPath), `react agent config not found: ${reactAgentYamlPath}`);
+  const reactAgentConfig = await loadYaml(reactAgentYamlPath);
+  const reactAgentDir = dirname(reactAgentYamlPath);
+
+  const { toolsDefaultPath, toolsDevPath, toolsProdPath } = resolveToolConfigPaths(reactAgentConfig, reactAgentDir);
+
+  assert(existsSync(toolsDefaultPath), `tool config not found: ${toolsDefaultPath}`);
+
+  const defaultConfig = await loadYaml(toolsDefaultPath);
+  const hasDevFile = existsSync(toolsDevPath);
+  const hasProdFile = existsSync(toolsProdPath);
+  const devConfig = hasDevFile ? await loadYaml(toolsDevPath) : null;
+  const prodConfig = hasProdFile ? await loadYaml(toolsProdPath) : null;
+
+  const { sandboxedPath: defaultSandboxedPath } = validateDefaultConfig(defaultConfig);
+  const defaultLoadedTools = createLangChainAgentTools({
+    configFilePath: toolsDefaultPath,
+    coreTools: getCoreToolsOptions(),
+  });
+
+  assert(defaultLoadedTools.length > 0, "tool.yaml loads 0 tools");
+
+  if (devConfig) {
+    validateVariantConfig({
+      config: devConfig,
+      label: "tool.development.yaml",
+      expectedSandboxedPath: defaultSandboxedPath,
+      defaultLoadedToolsLength: defaultLoadedTools.length,
+      configFilePath: toolsDevPath,
+    });
+  }
+
+  if (prodConfig) {
+    validateVariantConfig({
+      config: prodConfig,
+      label: "tool.production.yaml",
+      expectedSandboxedPath: defaultSandboxedPath,
+      defaultLoadedToolsLength: defaultLoadedTools.length,
+      configFilePath: toolsProdPath,
+    });
+  }
+
+  assertRequiredToolsLoaded(defaultLoadedTools);
+
+  console.log(
+    `[validate-tools-config] OK: default=${defaultLoadedTools.length}, devFile=${hasDevFile}, prodFile=${hasProdFile}`,
+  );
+}
+
+main().catch((error) => {
+  fail(error instanceof Error ? error.message : String(error));
+});

package/apps/imessagebot/src/config.ts

@@ -0,0 +1,76 @@
+import { asObject, resolveKindResourceFile } from "@easynet/agent-common";
+import {
+  createRuntimeConfig,
+  getModelsConfigPath as getRuntimeModelsConfigPath,
+  getMemoryConfigPath as getRuntimeMemoryConfigPath,
+  getToolConfigPath as getRuntimeToolConfigPath,
+  resolveDefaultAgentName as resolveRuntimeDefaultAgentName,
+  type AgentProfileConfig,
+} from "@easynet/agent-runtime";
+
+type IMessageAppSpec = {
+  agent?: string;
+};
+
+export interface AppConfig {
+  app?: {
+    agent?: Record<string, AgentProfileConfig>;
+    defaultAgent?: string;
+  };
+}
+
+export interface AppConfigDefaults {
+  modelsPath?: string;
+  memoryPath?: string;
+  toolPath?: string;
+  toolDevPath?: string;
+  toolProdPath?: string;
+}
+
+export async function loadAppConfig(configPath?: string): Promise<AppConfig> {
+  const appResource = await resolveKindResourceFile<IMessageAppSpec>(configPath ?? "config/app.yaml", {
+    baseDir: process.cwd(),
+    expectedApiVersion: "easynet.world/v1",
+    expectedKind: "AppConfig",
+  });
+  const spec = asObject(appResource.spec) as IMessageAppSpec | undefined;
+  const runtimeConfig = await createRuntimeConfig({
+    configPath,
+    overrides: {
+      app: {
+        defaultAgent: spec?.agent,
+      },
+    },
+  });
+  const defaultAgent = resolveRuntimeDefaultAgentName(runtimeConfig, spec?.agent);
+  return {
+    app: {
+      agent: runtimeConfig.app?.agent,
+      defaultAgent,
+    },
+  };
+}
+
+export function getModelsConfigPath(
+  config: AppConfig,
+  agentName?: string,
+  defaults?: AppConfigDefaults,
+): string {
+  return getRuntimeModelsConfigPath(config, agentName, defaults);
+}
+
+export function getMemoryConfigPath(
+  config: AppConfig,
+  agentName?: string,
+  defaults?: AppConfigDefaults,
+): string {
+  return getRuntimeMemoryConfigPath(config, agentName, defaults);
+}
+
+export function getToolConfigPath(
+  config: AppConfig,
+  agentName?: string,
+  defaults?: AppConfigDefaults,
+): string {
+  return getRuntimeToolConfigPath(config, agentName, defaults);
+}

package/apps/imessagebot/src/context.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared runtime context: LLM, memory, tools.
+ * Built once and passed to both ReAct and Deep agents.
+ */
+import {
+  createContextBuilders,
+  type AppContextBuilders,
+  type BotContext,
+  type BotTool,
+  type CreateContextOptions,
+} from "@easynet/agent-runtime";
+import {
+  loadAppConfig,
+  getModelsConfigPath,
+  getMemoryConfigPath,
+  getToolConfigPath,
+  type AppConfig,
+} from "./config.js";
+
+export type { BotContext, BotTool, CreateContextOptions };
+
+const builders: AppContextBuilders = createContextBuilders<AppConfig>({
+  configApi: {
+    loadAgentConfig: loadAppConfig,
+    getModelsConfigPath: (config: AppConfig, agentName?: string) => getModelsConfigPath(config, agentName),
+    getMemoryConfigPath: (config: AppConfig, agentName?: string) => getMemoryConfigPath(config, agentName),
+    getToolConfigPath: (config: AppConfig, agentName?: string) => getToolConfigPath(config, agentName),
+  },
+});
+
+export const createAgentLlm: AppContextBuilders["createAgentLlm"] = builders.createAgentLlm;
+export const createAgentMemory: AppContextBuilders["createAgentMemory"] = builders.createAgentMemory;
+export const createAgentTools: AppContextBuilders["createAgentTools"] = builders.createAgentTools;
+export const createAgent: AppContextBuilders["createAgent"] = builders.createAgent;
+export const createBotContext: AppContextBuilders["createBotContext"] = builders.createBotContext;

package/apps/imessagebot/src/index.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * iMessageBot: ReAct agent (LangChain) + Deep agent (DeepAgents).
+ * Usage:
+ *   npm start              # interactive: choose agent then chat
+ *   npm run react          # use ReAct agent
+ *   npm run deep           # use Deep agent
+ *   node dist/index.js react "Your question"
+ *   node dist/index.js deep "Your question"
+ */
+import { runAppCli } from "@easynet/agent-runtime";
+import { createBotContext } from "./context.js";
+
+runAppCli({
+  appName: "iMessageBot",
+  createBotContext,
+});

package/apps/imessagebot/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/apps/itermbot/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+    branches: ['**']
+  repository_dispatch:
+    types:
+      - easynet-package-updated
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test & Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Force npm registry to npmjs.org
+        run: |
+          touch .npmrc
+          grep -q '^registry=https://registry.npmjs.org' .npmrc || echo "registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@easynet:registry=' .npmrc || echo "@easynet:registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@wallee:registry=' .npmrc || echo "@wallee:registry=https://registry.npmjs.org/" >> .npmrc
+
+      - name: Install dependencies
+        env:
+          NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
+        run: npm install --legacy-peer-deps
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Typecheck
+        run: npm run typecheck --if-present
+
+      - name: Test
+        run: npm test --if-present
+
+      - name: Diagnostics (on failure)
+        if: failure()
+        run: |
+          echo "Node: $(node -v) | npm: $(npm -v)"
+          echo "--- .npmrc ---"
+          cat .npmrc 2>&1 || true
+          echo "--- npm config ---"
+          npm config list 2>&1 || true
+          npm ls --depth=0 2>&1 | head -50

package/apps/itermbot/.github/workflows/release.yml

@@ -0,0 +1,80 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+  repository_dispatch:
+    types:
+      - easynet-package-updated
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Force npm registry to npmjs.org
+        run: |
+          touch .npmrc
+          grep -q '^registry=https://registry.npmjs.org' .npmrc || echo "registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@easynet:registry=' .npmrc || echo "@easynet:registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@wallee:registry=' .npmrc || echo "@wallee:registry=https://registry.npmjs.org/" >> .npmrc
+
+      - name: Use @easynet deps from npm (CI has no file:../../)
+        run: |
+          node -e "
+          const fs = require('fs');
+          const pkgPath = 'package.json';
+          const p = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+          const deps = { ...p.dependencies, ...p.devDependencies };
+          let changed = false;
+          for (const [name, v] of Object.entries(deps)) {
+            if (name.startsWith('@easynet/') && typeof v === 'string' && v.startsWith('file:')) {
+              if (p.dependencies[name]) { p.dependencies[name] = 'latest'; changed = true; }
+              if (p.devDependencies[name]) { p.devDependencies[name] = 'latest'; changed = true; }
+            }
+          }
+          if (changed) fs.writeFileSync(pkgPath, JSON.stringify(p, null, 2) + '\n');
+          "
+
+      - name: Install dependencies
+        env:
+          NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
+        run: npm install --legacy-peer-deps
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Typecheck
+        run: npm run typecheck --if-present
+
+      - name: Test
+        run: npm test --if-present
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

package/apps/itermbot/.releaserc.cjs

@@ -0,0 +1,26 @@
+/** @type {import('semantic-release').GlobalConfig} */
+module.exports = {
+  branches: ['master'],
+  plugins: [
+    [
+      '@semantic-release/commit-analyzer',
+      {
+        releaseRules: [
+          { type: 'feat', release: 'patch' },
+          { type: 'fix', release: 'patch' },
+          { type: 'docs', release: 'patch' },
+          { type: 'chore', release: 'patch' },
+          { type: 'refactor', release: 'patch' },
+          { type: 'perf', release: 'patch' },
+          { type: 'test', release: 'patch' },
+          { type: 'ci', release: 'patch' },
+          { type: 'build', release: 'patch' },
+          { message: '*', release: 'patch' },
+        ],
+      },
+    ],
+    '@semantic-release/release-notes-generator',
+    '@semantic-release/npm',
+    '@semantic-release/git',
+  ],
+};

package/apps/itermbot/README.md

@@ -0,0 +1,82 @@
+# iTermBot
+
+iTermBot is an application built on the **@easynet** agent framework. It runs two agents:
+
+1. **ReAct agent** — LangChain `createAgent` (ReAct pattern) with tools and memory.
+2. **Deep agent** — DeepAgents `createDeepAgent` with a persistent store backed by agent-memory.
+
+Both agents share:
+
+- **@easynet/agent-common** — YAML config (app, paths).
+- **@easynet/agent-model** — LLM and embedding models (falls back to module default config).
+- **@easynet/agent-memory** — Agent memory (recall/inject for ReAct; store adapter for Deep).
+- **@easynet/agent-tool** + **@easynet/agent-tool-buildin** — Tools (FS, HTTP, util, exec, etc.).
+
+## Prerequisites
+
+- Node.js >= 18
+- Ollama (or another OpenAI-compatible endpoint) for the LLM. Default config uses `http://localhost:11434/v1` and `qwen3:0.6b`.
+
+## Setup
+
+Build from source workspace:
+
+```bash
+cd apps/itermbot
+npm install
+npm run build
+```
+
+Tool support uses agent-tool’s `@easynet/agent-tool` and `@easynet/agent-tool-buildin` from the npm registry.
+
+## Config
+
+| File | Purpose |
+|------|--------|
+| `config/app.yaml` | App-level settings (`agent`, `printSteps`, prompt templates). |
+
+Agent profile defaults (model/memory/tool/skills) are resolved by `@easynet/agent-runtime`.
+Top-level app config only overrides runtime defaults.
+
+Tool config now falls back to `@easynet/agent-tool` module defaults when app-level tool config is not provided.
+
+## Usage
+
+- **Interactive (ReAct agent):**
+  ```bash
+  npm start
+  # or
+  npm run react
+  ```
+
+- **Interactive (Deep agent):**
+  ```bash
+  npm run deep
+  ```
+
+- **One-shot query:**
+  ```bash
+  node dist/index.js react "What time is it?"
+  node dist/index.js deep "Remember I prefer short answers."
+  ```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run build` | Compile TypeScript to `dist/`. |
+| `npm start` | Run interactive with ReAct agent. |
+| `npm run react` | Same as start (ReAct). |
+| `npm run deep` | Interactive with Deep agent. |
+| `npm run typecheck` | Type-check only. |
+| `npm run test:llm` | Test LLM config (scripts/test-llm.mjs). |
+
+## Architecture
+
+- **src/index.ts** — CLI startup and orchestration.
+- **src/context.ts** — Shared `BotContext` builders (LLM/memory/tools/skills).
+- **src/config.ts** — App-level override adapter on top of runtime config.
+- **src/startup/** — startup UI, diagnostics, and panel color bootstrapping.
+- **src/iterm/** — iTerm session routing and target session prompt injection.
+
+Both agents use the same LLM, memory backend, and tool set; only the orchestration (ReAct vs Deep) differs.

package/apps/itermbot/config/app.yaml

@@ -0,0 +1,29 @@
+apiVersion: easynet.world/v1
+kind: AppConfig
+metadata:
+  name: itermbot
+spec:
+  agent: react
+
+  printSteps: false
+
+  promptTemplates:
+    itermPolicy: |
+      ## iTerm Operating Policy
+      - Target panel output is the remote source of truth.
+      - Never use local machine commands for system/project data collection.
+      - For remote operations/investigation, use `itermRunCommandInSession` in target panel.
+      - For current screen/panel analysis, never ask user to paste text; capture via no-op `:`.
+      - For full coverage, paginate with `outputOffsetLines + maxOutputLines`, summarize by chunk, then merge.
+      - If output is long, use bounded chunk analysis with interim summaries and one final conclusion.
+      - Prefer fast/low-cost commands; avoid heavy full scans/builds/tests unless required.
+      - Host may auto-update target panel when focus moves to a non-chat panel.
+      - Final response must be valid Markdown with stable formatting.
+      - Host may auto-recover target routing (reuse non-chat pane or auto-split); if still failing, ask user.
+    targetSession: |
+      ## Target Panel Session
+      Routed target panel (may change at runtime):
+      - sessionId: "{{sessionId}}"
+      - windowId: {{windowId}}
+      - tabIndex: {{tabIndex}}
+      Never use `windowId: 0` and never guess IDs.