@mono-agent/session-web 0.4.1

package/dist/session-model.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The web operator surface's data model. The heavy lifting — turning a recorded
+ * run into a renderable {@link Session} — lives in `@mono-agent/observability`
+ * (`mapRunToSession`); this module re-exports those frozen types verbatim (never
+ * redefines them) and adds the two shapes unique to the browser boundary: the
+ * per-instance summary the discovery layer produces ({@link WebInstance}) and the
+ * SSE frame union the aggregator fans out to the browser ({@link BrowserStreamFrame}).
+ */
+export type { Session, SessionOutcome, SessionStep, SessionStepUsage, SessionThink, SessionToolCall, SessionTotals, } from "@mono-agent/observability";
+import type { Session } from "@mono-agent/observability";
+/**
+ * One discovered agent instance, projected for the browser. `sourceId` is the
+ * trace-source registry id; `liveConnected` reflects whether the aggregator
+ * currently holds an open SSE connection to this instance's `live` endpoint (so
+ * sub-run streaming is active); `counts.runs` is how many sessions the aggregator
+ * currently holds for it (seeded history + any live/artifact upserts).
+ */
+export interface WebInstance {
+    readonly sourceId: string;
+    readonly label: string;
+    /** Working directory the instance runs in — `dirname(configPath)` when known, else the artifact dir's parent. */
+    readonly cwd: string;
+    readonly artifactDir: string;
+    /** Trace-source health: "running" | "stale" | "failed" (never "stopped" — those are filtered out). */
+    readonly health: string;
+    /** Best-effort instance timezone from trace metadata or runtime.session.rolloverTimezone. */
+    readonly timeZone?: string;
+    /** Back-compat spelling for clients that already probe `timezone`. */
+    readonly timezone?: string;
+    readonly liveConnected: boolean;
+    readonly counts: {
+        readonly runs: number;
+    };
+}
+/**
+ * A frame on the browser SSE stream (`GET /api/stream`). `instances` replaces the
+ * client's instance list wholesale; `session_upsert` inserts-or-replaces one
+ * session by `session.sourceId + session.id` (both the recorded-artifact path and
+ * the live-fold path emit these — last write wins within one source);
+ * `session_removed` drops one run from one source (e.g. its instance vanished
+ * from the registry).
+ */
+export type BrowserStreamFrame = {
+    readonly t: "instances";
+    readonly instances: readonly WebInstance[];
+} | {
+    readonly t: "session_upsert";
+    readonly session: Session;
+} | {
+    readonly t: "session_removed";
+    readonly sourceId: string;
+    readonly runId: string;
+};
+//# sourceMappingURL=session-model.d.ts.map

package/dist/session-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-model.d.ts","sourceRoot":"","sources":["../src/session-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iHAAiH;IACjH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sGAAsG;IACtG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,CAAC,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/session-model.js

@@ -0,0 +1,10 @@
+/**
+ * The web operator surface's data model. The heavy lifting — turning a recorded
+ * run into a renderable {@link Session} — lives in `@mono-agent/observability`
+ * (`mapRunToSession`); this module re-exports those frozen types verbatim (never
+ * redefines them) and adds the two shapes unique to the browser boundary: the
+ * per-instance summary the discovery layer produces ({@link WebInstance}) and the
+ * SSE frame union the aggregator fans out to the browser ({@link BrowserStreamFrame}).
+ */
+export {};
+//# sourceMappingURL=session-model.js.map

package/dist/session-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-model.js","sourceRoot":"","sources":["../src/session-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@mono-agent/session-web",
+  "version": "0.4.1",
+  "description": "Discovers local mono-agent instances and serves a read-only web PWA that visualises their runs live — aggregating recorded-run history with operator-adapter live sub-run streams.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "private": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "webapp/dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@mono-agent/agent-contracts": "0.4.1",
+    "@mono-agent/observability": "0.4.1",
+    "express": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm run build:webapp && pnpm run build:server",
+    "build:server": "tsc -p tsconfig.build.json",
+    "build:webapp": "pnpm --dir webapp install --frozen-lockfile && pnpm --dir webapp run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests src/__tests__ && pnpm --dir webapp run test"
+  }
+}