@gokulvenkatareddy/cortex 0.1.7

package/apps/octogent/apps/api/tests/upgradeHandler.test.ts

@@ -0,0 +1,40 @@
+import type { IncomingMessage } from "node:http";
+import type { Socket } from "node:net";
+import { describe, expect, it, vi } from "vitest";
+
+import { createUpgradeHandler } from "../src/createApiServer/upgradeHandler";
+
+type RuntimeLike = {
+  handleUpgrade: (request: IncomingMessage, socket: Socket, head: Buffer) => boolean;
+};
+
+describe("createUpgradeHandler", () => {
+  it("destroys socket when runtime upgrade handling throws", () => {
+    const runtime: RuntimeLike = {
+      handleUpgrade: () => {
+        throw new Error("boom");
+      },
+    };
+    const handler = createUpgradeHandler({
+      runtime: runtime as never,
+      allowRemoteAccess: true,
+    });
+    const socket = {
+      destroy: vi.fn(),
+    } as unknown as Socket;
+
+    expect(() =>
+      handler(
+        {
+          headers: {
+            host: "127.0.0.1:8787",
+            origin: "http://127.0.0.1:5173",
+          },
+        } as IncomingMessage,
+        socket,
+        Buffer.alloc(0),
+      ),
+    ).not.toThrow();
+    expect(socket.destroy).toHaveBeenCalledTimes(1);
+  });
+});

package/apps/octogent/apps/api/tests/xMonitorProvider.test.ts

@@ -0,0 +1,109 @@
+import { describe, expect, it, vi } from "vitest";
+
+import { createXMonitorProvider } from "../src/monitor/xProvider";
+
+const jsonResponse = (payload: unknown) =>
+  new Response(JSON.stringify(payload), {
+    status: 200,
+    headers: {
+      "Content-Type": "application/json",
+    },
+  });
+
+describe("x monitor provider", () => {
+  it("runs separate recent searches per query term", async () => {
+    const recentSearchQueries: string[] = [];
+
+    const fetchMock = vi.fn(async (input: string | URL | Request) => {
+      const url = new URL(
+        typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url,
+      );
+      if (url.pathname !== "/2/tweets/search/recent") {
+        throw new Error(`Unexpected URL ${url.toString()}`);
+      }
+
+      const query = url.searchParams.get("query") ?? "";
+      recentSearchQueries.push(query);
+
+      if (query.includes('"Alpha"')) {
+        return jsonResponse({
+          data: [
+            {
+              id: "1",
+              text: "Alpha result",
+              created_at: "2026-02-28T10:00:00.000Z",
+              author_id: "user-alpha",
+              public_metrics: {
+                like_count: 10,
+              },
+            },
+          ],
+          includes: {
+            users: [
+              {
+                id: "user-alpha",
+                username: "alpha",
+                name: "Alpha",
+              },
+            ],
+          },
+          meta: {},
+        });
+      }
+
+      if (query.includes('"Beta"')) {
+        return jsonResponse({
+          data: [
+            {
+              id: "2",
+              text: "Beta result",
+              created_at: "2026-02-28T10:30:00.000Z",
+              author_id: "user-beta",
+              public_metrics: {
+                like_count: 20,
+              },
+            },
+          ],
+          includes: {
+            users: [
+              {
+                id: "user-beta",
+                username: "beta",
+                name: "Beta",
+              },
+            ],
+          },
+          meta: {},
+        });
+      }
+
+      throw new Error(`Unexpected query "${query}"`);
+    });
+
+    const provider = createXMonitorProvider({
+      fetchFn: fetchMock as unknown as typeof fetch,
+    });
+
+    const posts = await provider.fetchRecentPosts({
+      credentials: {
+        bearerToken: "x-test-token",
+        apiKey: null,
+        apiSecret: null,
+        accessToken: null,
+        accessTokenSecret: null,
+        updatedAt: "2026-02-28T12:00:00.000Z",
+      },
+      queryTerms: ["Alpha", "Beta"],
+      postLimit: 4,
+      searchWindowDays: 7,
+      now: new Date("2026-02-28T12:00:00.000Z"),
+    });
+
+    expect(posts).toHaveLength(2);
+    expect(new Set(posts.map((post) => post.matchedQueryTerm))).toEqual(new Set(["Alpha", "Beta"]));
+    expect(recentSearchQueries).toHaveLength(2);
+    expect(recentSearchQueries.every((query) => !query.includes(" OR "))).toBe(true);
+    expect(recentSearchQueries).toContain('("Alpha") lang:en -is:retweet');
+    expect(recentSearchQueries).toContain('("Beta") lang:en -is:retweet');
+  });
+});

package/apps/octogent/apps/api/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["node", "vitest/globals"]
+  },
+  "include": ["src", "tests"]
+}

package/apps/octogent/apps/api/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["tests/**/*.test.ts"],
+  },
+});

package/apps/octogent/apps/web/AGENTS.md

@@ -0,0 +1,38 @@
+# Web Guidelines
+
+## Ownership
+- `apps/web` owns the operator UI, client-side interaction flow, and presentation of runtime state.
+- Keep backend orchestration out of the UI. The web app should consume API/runtime contracts, not recreate server logic in React components.
+
+## Relevant Docs
+- `docs/concepts/mental-model.md`
+- `docs/concepts/tentacles.md`
+- `docs/concepts/runtime-and-api.md`
+- `docs/guides/working-with-todos.md`
+- `docs/guides/orchestrating-child-agents.md`
+- `docs/guides/inter-agent-messaging.md`
+- Read these when changing interaction models, UI vocabulary, tentacle flows, agent orchestration surfaces, or operator-facing behavior.
+
+## Module Shape
+- Top-level containers should orchestrate. Move pure constants, parsers, normalizers, and hooks into `src/app/*`.
+- Keep large JSX blocks in focused components under `src/components/*` with typed props.
+- Reusable primitives belong in `src/components/ui/*`.
+- Runtime transport code belongs in `src/runtime/*`.
+
+## Styling
+- Keep `src/styles.css` as the import manifest.
+- Add or update focused CSS modules under `src/styles/*` instead of growing one large stylesheet.
+- Preserve the existing token-driven, modular CSS structure and avoid one-off style dumping in unrelated files.
+
+## UI Conventions
+- Use the existing product vocabulary: agents, sessions, worktrees, logs, pipelines, tentacles, and terminal columns.
+- Preserve the current layout model: terminal columns are the visual unit; tentacles are the contextual grouping.
+- Prefer in-app confirmation and action-panel flows over browser-native dialogs for destructive actions.
+
+## State
+- Persist layout and UI preferences through the runtime-backed `.octogent` state model, not browser-only storage, unless the feature is explicitly local-only.
+- Keep tentacle IDs stable for routing and runtime identity; user-facing names remain presentation data.
+
+## Testing
+- Add targeted component or runtime tests when changing view-model logic, state reconciliation, or destructive UI flows.
+- When modifying shared UI behavior, verify both the component surface and the normalizer/hook logic that feeds it.

package/apps/octogent/apps/web/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/svg+xml" href="/octopus-favicon.svg" />
+    <title>Cortex — Multi-Agent Orchestrator</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/apps/octogent/apps/web/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@octogent/web",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.json --noEmit && vite build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@octogent/core": "workspace:*",
+    "@xterm/addon-fit": "^0.11.0",
+    "d3-force": "^3.0.0",
+    "lucide-react": "^1.7.0",
+    "marked": "^17.0.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "xterm": "^5.3.0",
+    "xterm-addon-unicode11": "^0.6.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.2.0",
+    "@types/d3-force": "^3.0.10",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@vitejs/plugin-react": "^4.3.4",
+    "jsdom": "^26.0.0",
+    "vite": "^6.2.0"
+  }
+}

package/apps/octogent/apps/web/public/octopus-favicon.svg

@@ -0,0 +1,26 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 14" shape-rendering="crispEdges">
+  <!-- Idle-state pixel-art octopus from EmptyOctopus.tsx -->
+  <!-- Body (accent orange) -->
+  <g fill="#faa32c">
+    <rect x="4" y="1" width="8" height="1"/>
+    <rect x="3" y="2" width="10" height="1"/>
+    <rect x="2" y="3" width="12" height="1"/>
+    <rect x="2" y="4" width="2" height="1"/><rect x="6" y="4" width="4" height="1"/><rect x="12" y="4" width="2" height="1"/>
+    <rect x="2" y="5" width="2" height="1"/><rect x="6" y="5" width="4" height="1"/><rect x="12" y="5" width="2" height="1"/>
+    <rect x="2" y="6" width="12" height="4"/>
+    <rect x="2" y="10" width="2" height="3"/><rect x="7" y="10" width="2" height="3"/><rect x="12" y="10" width="2" height="3"/>
+  </g>
+  <!-- Outline + eyes (black) -->
+  <g fill="#000">
+    <rect x="4" y="0" width="8" height="1"/>
+    <rect x="3" y="1" width="1" height="1"/><rect x="12" y="1" width="1" height="1"/>
+    <rect x="2" y="2" width="1" height="1"/><rect x="13" y="2" width="1" height="1"/>
+    <rect x="1" y="3" width="1" height="7"/><rect x="14" y="3" width="1" height="7"/>
+    <!-- Eyes -->
+    <rect x="4" y="4" width="2" height="2"/><rect x="10" y="4" width="2" height="2"/>
+    <!-- Tentacle outlines -->
+    <rect x="1" y="10" width="1" height="3"/><rect x="4" y="10" width="1" height="3"/><rect x="6" y="10" width="1" height="3"/><rect x="9" y="10" width="1" height="3"/><rect x="11" y="10" width="1" height="3"/><rect x="14" y="10" width="1" height="3"/>
+    <!-- Bottom caps -->
+    <rect x="2" y="13" width="2" height="1"/><rect x="7" y="13" width="2" height="1"/><rect x="12" y="13" width="2" height="1"/>
+  </g>
+</svg>