npm - agent-portal-2 - Versions diffs - 0.1.0 - Mend

agent-portal-2 0.1.0

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.

Files changed (120) hide show

package/.continue/agents/new-config.yaml +22 -0
package/AGENT_STEERING.md +36 -0
package/ARCHITECTURE.md +13 -0
package/CHANGELOG.md +97 -0
package/CLI.md +38 -0
package/CONTRIBUTING.md +55 -0
package/INSTALLATION.md +58 -0
package/LICENSE +60 -0
package/PLUGIN_SYSTEM.md +33 -0
package/PYTHON_SDK.md +22 -0
package/QUICKSTART.md +19 -0
package/README.md +385 -0
package/RELEASE_NOTES_v0.1.0.md +281 -0
package/ROADMAP.md +3 -0
package/RUNTIME.md +44 -0
package/SAFETY_MODEL.md +24 -0
package/TESTING.md +35 -0
package/TROUBLESHOOTING.md +30 -0
package/UPGRADE_GUIDE.md +288 -0
package/VS_CODE_EXTENSION.md +47 -0
package/agent-portal.config.json +20 -0
package/apps/desktop/agent-portal-desktop.zip +0 -0
package/apps/desktop/fixtures/local-workflow.html +151 -0
package/apps/desktop/package.json +18 -0
package/apps/desktop/src/main.ts +117 -0
package/apps/desktop/tsconfig.json +8 -0
package/apps/vscode-extension/LICENSE +60 -0
package/apps/vscode-extension/README.md +20 -0
package/apps/vscode-extension/media/agent-portal-logo.png +0 -0
package/apps/vscode-extension/package.json +149 -0
package/apps/vscode-extension/src/extension.ts +614 -0
package/apps/vscode-extension/tsconfig.json +12 -0
package/assets/branding/agent-portal-logo.png +0 -0
package/connectors/chatgpt-tools/README.md +9 -0
package/connectors/claude-mcp-server/README.md +9 -0
package/connectors/gemini-connector/README.md +9 -0
package/connectors/rest-websocket-api/README.md +9 -0
package/docs/MCP_SERVER.md +68 -0
package/docs/architecture.md +214 -0
package/docs/roadmap.md +125 -0
package/package.json +21 -0
package/packages/agent-portal-mcp/README.md +12 -0
package/packages/agent-portal-mcp/agent_portal_mcp/__init__.py +3 -0
package/packages/agent-portal-mcp/agent_portal_mcp/bridge/__init__.py +1 -0
package/packages/agent-portal-mcp/agent_portal_mcp/bridge/runtime_client.py +180 -0
package/packages/agent-portal-mcp/agent_portal_mcp/cli.py +32 -0
package/packages/agent-portal-mcp/agent_portal_mcp/doctor.py +71 -0
package/packages/agent-portal-mcp/agent_portal_mcp/schemas/__init__.py +1 -0
package/packages/agent-portal-mcp/agent_portal_mcp/schemas/actions.py +17 -0
package/packages/agent-portal-mcp/agent_portal_mcp/schemas/results.py +24 -0
package/packages/agent-portal-mcp/agent_portal_mcp/schemas/risk.py +20 -0
package/packages/agent-portal-mcp/agent_portal_mcp/security/__init__.py +1 -0
package/packages/agent-portal-mcp/agent_portal_mcp/security/policy.py +27 -0
package/packages/agent-portal-mcp/agent_portal_mcp/server.py +148 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tool_registry.py +58 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/__init__.py +1 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/browser.py +89 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/common.py +98 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/inspection.py +93 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/navigation.py +93 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/reports.py +34 -0
package/packages/agent-portal-mcp/agent_portal_mcp/tools/steering.py +93 -0
package/packages/agent-portal-mcp/pyproject.toml +20 -0
package/packages/agent-portal-mcp/tests/test_doctor.py +20 -0
package/packages/agent-portal-mcp/tests/test_mcp_server.py +161 -0
package/packages/core/package.json +15 -0
package/packages/core/src/index.ts +1842 -0
package/packages/core/tsconfig.json +8 -0
package/packages/mcp-server/package.json +15 -0
package/packages/mcp-server/src/index.ts +73 -0
package/packages/mcp-server/tsconfig.json +8 -0
package/packages/sdk/package.json +15 -0
package/packages/sdk/src/index.ts +544 -0
package/packages/sdk/tsconfig.json +8 -0
package/plugins/README.md +16 -0
package/plugins/agent-portal-browser/plugin.json +19 -0
package/plugins/agent-portal-python/plugin.json +16 -0
package/plugins/agent-portal-skills/plugin.json +19 -0
package/plugins/agent-portal-vscode/plugin.json +27 -0
package/plugins/example-runtime-plugin/README.md +3 -0
package/plugins/example-runtime-plugin/plugin.json +20 -0
package/plugins/plugin.schema.json +53 -0
package/python/README.md +18 -0
package/python/agent_portal/__init__.py +5 -0
package/python/agent_portal/__main__.py +5 -0
package/python/agent_portal/browser.py +393 -0
package/python/agent_portal/cli.py +164 -0
package/python/agent_portal/config.py +31 -0
package/python/agent_portal/doctor.py +165 -0
package/python/agent_portal/exceptions.py +39 -0
package/python/agent_portal/logging_utils.py +33 -0
package/python/agent_portal/metrics.py +309 -0
package/python/agent_portal/models.py +160 -0
package/python/agent_portal/plugin_system.py +42 -0
package/python/agent_portal/rate_limit.py +253 -0
package/python/agent_portal/runtime.py +739 -0
package/python/agent_portal/server.py +351 -0
package/python/agent_portal/validation.py +299 -0
package/python/pyproject.toml +29 -0
package/python/tests/test_config.py +24 -0
package/python/tests/test_doctor.py +19 -0
package/python/tests/test_metrics.py +180 -0
package/python/tests/test_rate_limit.py +237 -0
package/python/tests/test_runtime.py +122 -0
package/python/tests/test_server.py +53 -0
package/python/tests/test_validation.py +170 -0
package/releases/desktop/agent-portal-desktop/README.md +378 -0
package/releases/desktop/agent-portal-desktop/RELEASE_NOTES.md +14 -0
package/releases/desktop/agent-portal-desktop/assets/branding/agent-portal-logo.png +0 -0
package/releases/desktop/agent-portal-desktop/fixtures/local-workflow.html +151 -0
package/releases/desktop/agent-portal-desktop/launch-agent-portal.bat +4 -0
package/releases/desktop/agent-portal-desktop.zip +0 -0
package/releases/python/agent_portal-0.0.2-py3-none-any.whl +0 -0
package/releases/python/agent_portal-0.0.2.tar.gz +0 -0
package/scripts/package_desktop.mjs +117 -0
package/scripts/release_python.py +46 -0
package/tests/plugin-manifest.test.mjs +26 -0
package/tests/runtime.test.mjs +41 -0
package/tests/vscode-extension.test.mjs +22 -0
package/tsconfig.base.json +16 -0

package/releases/desktop/agent-portal-desktop/fixtures/local-workflow.html ADDED Viewed

@@ -0,0 +1,151 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Agent Portal Local Workflow</title>
+    <style>
+      :root {
+        color-scheme: dark;
+        --bg: #05070c;
+        --panel: #0f1623;
+        --line: rgba(255, 255, 255, 0.1);
+        --text: #eef3ff;
+        --muted: #9cb2d1;
+        --blue: #3cc8ff;
+        --orange: #ff9a1f;
+      }
+      * {
+        box-sizing: border-box;
+      }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        display: grid;
+        place-items: center;
+        background:
+          radial-gradient(circle at top left, rgba(60, 200, 255, 0.2), transparent 28%),
+          radial-gradient(circle at top right, rgba(255, 154, 31, 0.2), transparent 30%),
+          linear-gradient(180deg, #070b12, var(--bg));
+        color: var(--text);
+        font-family: "Segoe UI", system-ui, sans-serif;
+      }
+      .panel {
+        width: min(92vw, 720px);
+        padding: 40px;
+        border: 1px solid var(--line);
+        border-radius: 28px;
+        background: linear-gradient(180deg, rgba(15, 22, 35, 0.96), rgba(7, 11, 18, 0.98));
+        box-shadow: 0 30px 80px rgba(0, 0, 0, 0.45);
+      }
+      .eyebrow {
+        font-size: 12px;
+        letter-spacing: 0.24em;
+        text-transform: uppercase;
+        color: var(--blue);
+      }
+      h1 {
+        margin: 12px 0 8px;
+        font-size: clamp(2rem, 5vw, 3.4rem);
+      }
+      p {
+        margin: 0 0 24px;
+        color: var(--muted);
+        line-height: 1.6;
+      }
+      form {
+        display: grid;
+        gap: 14px;
+      }
+      label {
+        font-size: 0.95rem;
+      }
+      input {
+        width: 100%;
+        padding: 14px 16px;
+        border: 1px solid rgba(60, 200, 255, 0.32);
+        border-radius: 14px;
+        background: rgba(7, 11, 18, 0.85);
+        color: var(--text);
+        font: inherit;
+      }
+      button {
+        padding: 14px 18px;
+        border: 0;
+        border-radius: 14px;
+        background: linear-gradient(90deg, var(--blue), var(--orange));
+        color: #061019;
+        font: inherit;
+        font-weight: 700;
+        cursor: pointer;
+      }
+      .result {
+        margin-top: 20px;
+        padding: 16px;
+        border-radius: 16px;
+        border: 1px solid rgba(255, 154, 31, 0.24);
+        background: rgba(255, 154, 31, 0.08);
+      }
+      .spacer {
+        height: 70vh;
+      }
+      .evidence {
+        margin-top: 24px;
+        padding: 20px;
+        border-radius: 18px;
+        border: 1px solid rgba(60, 200, 255, 0.24);
+        background: rgba(60, 200, 255, 0.08);
+      }
+    </style>
+  </head>
+  <body>
+    <main class="panel">
+      <div class="eyebrow">Local Proving Ground</div>
+      <h1>See, Act, Record</h1>
+      <p>
+        This local page exists to prove the Agent Portal browser loop against a
+        controlled app inside the repository.
+      </p>
+      <form id="workflow-form">
+        <label for="name">Agent Name</label>
+        <input id="name" name="name" type="text" placeholder="Portal Runner" />
+        <button id="generate-report" type="submit">Generate Result</button>
+      </form>
+      <div id="result" class="result" aria-live="polite">
+        Waiting for the agent to complete the workflow.
+      </div>
+      <div class="spacer" aria-hidden="true"></div>
+      <section id="evidence-panel" class="evidence">
+        <strong>Evidence Panel</strong>
+        <p>
+          If the agent reached this section, scrolling worked as part of the
+          browser automation flow.
+        </p>
+      </section>
+    </main>
+    <script>
+      const form = document.getElementById("workflow-form");
+      const result = document.getElementById("result");
+      const input = document.getElementById("name");
+      form.addEventListener("submit", (event) => {
+        event.preventDefault();
+        const value = input.value.trim() || "Unknown Agent";
+        result.textContent = `Workflow completed for ${value}. Screenshot and report are ready.`;
+      });
+    </script>
+  </body>
+  </html>

package/releases/desktop/agent-portal-desktop/launch-agent-portal.bat ADDED Viewed

@@ -0,0 +1,4 @@
+@echo off
+setlocal
+cd /d "%~dp0"
+node dist\main.js

package/releases/desktop/agent-portal-desktop.zip ADDED Viewed

Binary file

package/releases/python/agent_portal-0.0.2-py3-none-any.whl ADDED Viewed

Binary file

package/releases/python/agent_portal-0.0.2.tar.gz ADDED Viewed

Binary file

package/scripts/package_desktop.mjs ADDED Viewed

@@ -0,0 +1,117 @@
+import { copyFile, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const repoRoot = process.cwd();
+const desktopRoot = path.join(repoRoot, "apps", "desktop");
+const stagingRoot = path.join(repoRoot, "releases", "desktop", "agent-portal-desktop");
+const outputDir = path.join(repoRoot, "releases", "desktop");
+const archivePath = path.join(outputDir, "agent-portal-desktop.zip");
+async function main() {
+  await ensureDesktopBuild();
+  await rm(stagingRoot, { recursive: true, force: true });
+  await mkdir(stagingRoot, { recursive: true });
+  await copyTree(path.join(desktopRoot, "dist"), path.join(stagingRoot, "dist"));
+  await copyTree(path.join(desktopRoot, "fixtures"), path.join(stagingRoot, "fixtures"));
+  await copyTree(path.join(repoRoot, "assets", "branding"), path.join(stagingRoot, "assets", "branding"));
+  await copyOptionalTree(
+    path.join(repoRoot, "workspaces", "runtime"),
+    path.join(stagingRoot, "runtime-workspaces")
+  );
+  await copyFile(path.join(repoRoot, "README.md"), path.join(stagingRoot, "README.md"));
+  await writeLaunchScript();
+  await writeReleaseNotes();
+  await zipWithPowerShell(stagingRoot, archivePath);
+  console.log(`Desktop release package written to ${archivePath}`);
+}
+async function ensureDesktopBuild() {
+  await execFileAsync("npm", ["run", "build", "--workspace", "@agent-portal/desktop"], {
+    cwd: repoRoot,
+    shell: process.platform === "win32"
+  });
+}
+async function copyOptionalTree(source, destination) {
+  try {
+    await stat(source);
+    await copyTree(source, destination);
+  } catch {
+    return;
+  }
+}
+async function copyTree(source, destination) {
+  const sourceStats = await stat(source);
+  if (!sourceStats.isDirectory()) {
+    throw new Error(`Expected directory: ${source}`);
+  }
+  await mkdir(destination, { recursive: true });
+  const entries = await readdir(source, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourcePath = path.join(source, entry.name);
+    const destinationPath = path.join(destination, entry.name);
+    if (entry.isDirectory()) {
+      await copyTree(sourcePath, destinationPath);
+      continue;
+    }
+    await copyFile(sourcePath, destinationPath);
+  }
+}
+async function writeLaunchScript() {
+  const launchScript = `@echo off
+setlocal
+cd /d "%~dp0"
+node dist\\main.js
+`;
+  await writeFile(path.join(stagingRoot, "launch-agent-portal.bat"), launchScript, "utf8");
+}
+async function writeReleaseNotes() {
+  const desktopPackageJson = JSON.parse(
+    await readFile(path.join(desktopRoot, "package.json"), "utf8")
+  );
+  const notes = `# Agent Portal Desktop Runtime Package
+Version: ${desktopPackageJson.version}
+Included:
+- desktop runtime build output
+- local workflow fixtures
+- shared branding assets
+- launch-agent-portal.bat helper
+Usage:
+1. Ensure Node.js is installed on the target machine.
+2. Open a terminal in this package directory.
+3. Run \`launch-agent-portal.bat\`.
+`;
+  await writeFile(path.join(stagingRoot, "RELEASE_NOTES.md"), notes, "utf8");
+}
+async function zipWithPowerShell(sourceDirectory, destinationZip) {
+  await mkdir(path.dirname(destinationZip), { recursive: true });
+  const command = [
+    "-NoProfile",
+    "-Command",
+    `Compress-Archive -Path '${sourceDirectory}\\*' -DestinationPath '${destinationZip}' -Force`
+  ];
+  await execFileAsync("powershell", command, { cwd: repoRoot });
+}
+main().catch((error) => {
+  console.error("Desktop release packaging failed.");
+  console.error(error);
+  process.exitCode = 1;
+});

package/scripts/release_python.py ADDED Viewed

@@ -0,0 +1,46 @@
+from __future__ import annotations
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+REPO_ROOT = Path(__file__).resolve().parents[1]
+PYTHON_PROJECT = REPO_ROOT / "python"
+OUTPUT_DIR = REPO_ROOT / "releases" / "python"
+def main() -> int:
+    if shutil.which(sys.executable) is None:
+        print("Python executable could not be resolved for release packaging.", file=sys.stderr)
+        return 1
+    try:
+        import build  # noqa: F401
+    except Exception:
+        print(
+            "Python release tooling is missing. Install it with `python -m pip install build` "
+            "and run `npm run release:python` again.",
+            file=sys.stderr,
+        )
+        return 1
+    OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
+    command = [
+        sys.executable,
+        "-m",
+        "build",
+        str(PYTHON_PROJECT),
+        "--outdir",
+        str(OUTPUT_DIR),
+    ]
+    print(f"Building Python artifacts into {OUTPUT_DIR}")
+    completed = subprocess.run(command, cwd=REPO_ROOT, check=False)
+    return completed.returncode
+if __name__ == "__main__":
+    raise SystemExit(main())

package/tests/plugin-manifest.test.mjs ADDED Viewed

@@ -0,0 +1,26 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { validatePluginManifest } from "../packages/core/dist/index.js";
+const root = process.cwd();
+test("plugin manifests validate", async () => {
+  const pluginDirs = [
+    "agent-portal-vscode",
+    "agent-portal-browser",
+    "agent-portal-python",
+    "agent-portal-skills"
+  ];
+  for (const pluginDir of pluginDirs) {
+    const raw = await fs.readFile(
+      path.join(root, "plugins", pluginDir, "plugin.json"),
+      "utf8"
+    );
+    const manifest = JSON.parse(raw);
+    const errors = validatePluginManifest(manifest);
+    assert.equal(errors.length, 0, `${pluginDir} manifest failed validation`);
+  }
+});

package/tests/runtime.test.mjs ADDED Viewed

@@ -0,0 +1,41 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import path from "node:path";
+import {
+  AgentPortalRuntime,
+  BrowserSession,
+  createDefaultWorkspace,
+  resolveWorkspaceFileUrl
+} from "../packages/core/dist/index.js";
+const root = process.cwd();
+test("runtime launches browser, executes workflow, captures report, and shuts down", async () => {
+  const workspace = createDefaultWorkspace("test-project");
+  const runtime = new AgentPortalRuntime({
+    workspace,
+    workspaceBasePath: root,
+    agents: [{ id: "qa", role: "qa", status: "idle" }]
+  });
+  const session = new BrowserSession(runtime, {
+    headless: true,
+    basePath: root
+  });
+  await session.launch();
+  await session.open(
+    resolveWorkspaceFileUrl(root, "apps/desktop/fixtures/local-workflow.html")
+  );
+  await session.waitForSelector("#name");
+  await session.type("#name", "Runtime Test");
+  await session.click("#generate-report");
+  const text = await session.readText("#result");
+  const capture = await session.capture({ label: "runtime-test" });
+  const reportPath = await runtime.writeSessionReport();
+  await session.shutdownGracefully();
+  assert.match(text.text ?? "", /Runtime Test/);
+  assert.equal(capture.snapshot.detectedElements.length > 0, true);
+  assert.match(reportPath, /session-/);
+  assert.equal(runtime.getOverview().browserStatus, "closed");
+});

package/tests/vscode-extension.test.mjs ADDED Viewed

@@ -0,0 +1,22 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import path from "node:path";
+const root = process.cwd();
+test("VS Code extension package exposes required commands and sidebar", async () => {
+  const raw = await fs.readFile(
+    path.join(root, "apps", "vscode-extension", "package.json"),
+    "utf8"
+  );
+  const manifest = JSON.parse(raw);
+  const commands = manifest.contributes.commands.map((command) => command.command);
+  assert.ok(commands.includes("agentPortal.startRuntime"));
+  assert.ok(commands.includes("agentPortal.pauseAgent"));
+  assert.ok(commands.includes("agentPortal.resumeAgent"));
+  assert.ok(commands.includes("agentPortal.approveNextAction"));
+  assert.ok(commands.includes("agentPortal.rejectNextAction"));
+  assert.ok(manifest.contributes.views.agentPortal.length > 0);
+});

package/tsconfig.base.json ADDED Viewed

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM"],
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  }
+}