agent-portal-2 0.1.0

package/apps/desktop/src/main.ts

@@ -0,0 +1,117 @@
+import path from "node:path";
+import {
+  AgentPortalRuntime,
+  BrowserSession,
+  GoalPlanner,
+  PortalGraph,
+  VisionCore,
+  createDefaultWorkspace,
+  resolveWorkspaceFileUrl
+} from "@agent-portal/core";
+
+async function main(): Promise<void> {
+  const repoRoot = path.resolve(process.cwd(), "../..");
+  const workspace = createDefaultWorkspace("demo-project");
+  const vision = new VisionCore();
+  const planner = new GoalPlanner();
+  const graph = new PortalGraph();
+  const runtime = new AgentPortalRuntime({
+    workspace,
+    workspaceBasePath: repoRoot,
+    agents: [
+      { id: "frontend", role: "frontend", status: "idle" },
+      { id: "qa", role: "qa", status: "idle" }
+    ]
+  });
+
+  runtime.record({
+    type: "session.started",
+    at: new Date().toISOString(),
+    detail: `Workspace ${workspace.name} initialized`
+  });
+  runtime.startAgent("frontend");
+  runtime.startAgent("qa");
+
+  const browser = new BrowserSession(runtime, {
+    headless: true,
+    basePath: repoRoot
+  });
+
+  try {
+    await browser.launch();
+    const localWorkflowUrl = resolveWorkspaceFileUrl(
+      repoRoot,
+      "apps/desktop/fixtures/local-workflow.html"
+    );
+
+    await browser.open(localWorkflowUrl);
+    await browser.waitForSelector("#name");
+    await browser.hover("#name");
+    await browser.type("#name", "Portal Runner");
+    await browser.click("#generate-report");
+    await browser.scroll({ selector: "#evidence-panel" });
+    const result = await browser.readText("#result");
+    const capture = await browser.capture({
+      label: "local-workflow",
+      includeAccessibilityTree: true
+    });
+    const understanding = vision.analyze({
+      snapshot: capture.snapshot,
+      goal: "Test the signup flow"
+    });
+    const goalPlan = planner.createPlan(
+      {
+        id: "goal-signup-test",
+        title: "Test the signup flow"
+      },
+      understanding
+    );
+    runtime.addGraphNode(graph.fromSnapshot(capture.snapshot, understanding));
+    const projectAwareness = await runtime.detectProjectAwareness(repoRoot);
+    await runtime.writeMemoryRecord({
+      id: `page-understanding-${Date.now()}`,
+      kind: "page-understanding",
+      createdAt: new Date().toISOString(),
+      summary: understanding.summary,
+      payload: {
+        understanding,
+        goalPlan,
+        projectAwareness
+      }
+    });
+    runtime.completeAgent("frontend");
+    runtime.completeAgent("qa");
+    const reportPath = await runtime.writeSessionReport();
+    const overview = runtime.getOverview();
+
+    console.log("Agent Portal browser vertical slice");
+    console.log(
+      JSON.stringify(
+        {
+          title: capture.title,
+          url: capture.url,
+          resultText: result.text,
+          pageCategory: understanding.pageCategory,
+          understandingSummary: understanding.summary,
+          goalSteps: goalPlan.steps.map((step) => step.title),
+          projectAwareness: projectAwareness.summary,
+          screenshotPath: capture.screenshotPath,
+          detectedElements: capture.snapshot.detectedElements.length,
+          reportPath,
+          events: overview.sessionEvents.length,
+          memoryRecords: overview.memoryRecords.length,
+          graphNodes: overview.graph.length
+        },
+        null,
+        2
+      )
+    );
+  } finally {
+    await browser.close();
+  }
+}
+
+main().catch((error: unknown) => {
+  console.error("Failed to start Agent Portal", error);
+  process.exitCode = 1;
+});

package/apps/desktop/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/apps/vscode-extension/LICENSE

@@ -0,0 +1,60 @@
+Copyright (c) 2026 Magnexis
+
+All Rights Reserved.
+
+Agent Portal and all associated source code, binaries, documentation, assets,
+designs, interfaces, branding, logos, and related materials are the exclusive
+property of Magnexis.
+
+No person or entity is granted permission to copy, modify, merge, publish,
+distribute, sublicense, sell, lease, rent, host, reverse engineer, create
+derivative works from, or otherwise exploit any portion of the Software
+without the express prior written permission of Magnexis.
+
+Permitted Use
+
+Subject to compliance with this license, Magnexis grants the end user a
+limited, non-exclusive, non-transferable, revocable license to install and
+use the Software solely for its intended purposes.
+
+Restrictions
+
+You may not:
+
+Modify the Software.
+Create derivative works based on the Software.
+Redistribute the Software.
+Resell the Software.
+Repackage the Software.
+Host the Software as a service.
+Remove copyright notices.
+Reverse engineer, decompile, or disassemble the Software except where
+prohibited by applicable law.
+Use Magnexis trademarks, logos, branding, or product names without
+written authorization.
+
+Ownership
+
+All right, title, and interest in and to the Software remain exclusively with
+Magnexis. No ownership rights are transferred under this license.
+
+Termination
+
+This license automatically terminates if any provision is violated. Upon
+termination, all copies of the Software must be permanently removed and
+destroyed.
+
+Disclaimer of Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+Limitation of Liability
+
+IN NO EVENT SHALL MAGNEXIS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY ARISING FROM THE USE OF OR INABILITY TO USE THE SOFTWARE.
+
+Contact
+
+Licensing inquiries and permission requests should be directed to Magnexis.

package/apps/vscode-extension/README.md

@@ -0,0 +1,20 @@
+# Agent Portal VS Code Extension
+
+![Agent Portal Logo](https://github.com/magnexis/agent-portal/raw/main/apps/vscode-extension/media/agent-portal-logo.png)
+
+This extension is the VS Code entry point for Agent Portal.
+
+Official extension link:
+
+- [Agent Portal on the Visual Studio Marketplace](https://marketplace.visualstudio.com/manage/publishers/magnificent-language/extensions/agent-portal/hub)
+
+## Included Branding
+
+- main extension icon uses the Agent Portal logo
+- local extension README uses the same primary logo
+
+## Planned Commands
+
+- `Agent Portal: Start Session`
+- `Agent Portal: Open Browser`
+- `Agent Portal: Launch Agent`

package/apps/vscode-extension/package.json

@@ -0,0 +1,149 @@
+{
+  "name": "agent-portal",
+  "displayName": "Agent Portal",
+  "description": "Control and steer AI agents through local browser/UI workflows.",
+  "version": "0.0.3",
+  "publisher": "magnificent-language",
+  "private": true,
+  "files": [
+    "dist/extension.js",
+    "dist/extension.d.ts",
+    "media/agent-portal-logo.png",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/magnexis/agent-portal.git"
+  },
+  "homepage": "https://github.com/magnexis/agent-portal",
+  "bugs": {
+    "url": "https://github.com/magnexis/agent-portal/issues"
+  },
+  "license": "MIT",
+  "icon": "media/agent-portal-logo.png",
+  "engines": {
+    "vscode": "^1.90.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "onView:agentPortal.sidebar",
+    "onCommand:agentPortal.startRuntime",
+    "onCommand:agentPortal.stopRuntime",
+    "onCommand:agentPortal.restartRuntime",
+    "onCommand:agentPortal.openCurrentProject",
+    "onCommand:agentPortal.runAgent",
+    "onCommand:agentPortal.pauseAgent",
+    "onCommand:agentPortal.resumeAgent",
+    "onCommand:agentPortal.stopAgent",
+    "onCommand:agentPortal.approveNextAction",
+    "onCommand:agentPortal.rejectNextAction",
+    "onCommand:agentPortal.generateReport",
+    "onCommand:agentPortal.openDocumentation",
+    "onCommand:agentPortal.connectRuntime"
+  ],
+  "main": "./dist/extension.js",
+  "contributes": {
+    "viewsContainers": {
+      "activitybar": [
+        {
+          "id": "agentPortal",
+          "title": "Agent Portal",
+          "icon": "media/agent-portal-logo.png"
+        }
+      ]
+    },
+    "views": {
+      "agentPortal": [
+        {
+          "id": "agentPortal.sidebar",
+          "name": "Control Center",
+          "type": "webview"
+        }
+      ]
+    },
+    "commands": [
+      {
+        "command": "agentPortal.startRuntime",
+        "title": "Agent Portal: Start Runtime"
+      },
+      {
+        "command": "agentPortal.stopRuntime",
+        "title": "Agent Portal: Stop Runtime"
+      },
+      {
+        "command": "agentPortal.restartRuntime",
+        "title": "Agent Portal: Restart Runtime"
+      },
+      {
+        "command": "agentPortal.openCurrentProject",
+        "title": "Agent Portal: Open Current Project"
+      },
+      {
+        "command": "agentPortal.runAgent",
+        "title": "Agent Portal: Run Agent"
+      },
+      {
+        "command": "agentPortal.pauseAgent",
+        "title": "Agent Portal: Pause Agent"
+      },
+      {
+        "command": "agentPortal.resumeAgent",
+        "title": "Agent Portal: Resume Agent"
+      },
+      {
+        "command": "agentPortal.stopAgent",
+        "title": "Agent Portal: Stop Agent"
+      },
+      {
+        "command": "agentPortal.approveNextAction",
+        "title": "Agent Portal: Approve Next Action"
+      },
+      {
+        "command": "agentPortal.rejectNextAction",
+        "title": "Agent Portal: Reject Next Action"
+      },
+      {
+        "command": "agentPortal.generateReport",
+        "title": "Agent Portal: Generate Report"
+      },
+      {
+        "command": "agentPortal.openDocumentation",
+        "title": "Agent Portal: Open Documentation"
+      },
+      {
+        "command": "agentPortal.connectRuntime",
+        "title": "Agent Portal: Connect To Running Runtime"
+      }
+    ],
+    "configuration": {
+      "title": "Agent Portal",
+      "properties": {
+        "agentPortal.runtimeUrl": {
+          "type": "string",
+          "default": "http://127.0.0.1:8765",
+          "description": "Base URL for the local Agent Portal runtime."
+        },
+        "agentPortal.preferredLocalDevPort": {
+          "type": "number",
+          "default": 3000,
+          "description": "Preferred local development server port when multiple local apps are detected."
+        }
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepackage": "npm run build"
+  },
+  "vsce": {
+    "dependencies": false
+  },
+  "devDependencies": {
+    "@types/vscode": "^1.90.0"
+  }
+}