@revisium/orchestrator 0.1.0-alpha.5 → 0.1.0-alpha.6

package/README.md

@@ -5,7 +5,7 @@ reviewer → integrator), hosted in **NestJS**. **DBOS** owns durable progress
 from the first unfinished step — while **Revisium** owns meaning: roles, policy, inbox, events. Workflow-as-data is
 a post-MVP goal; see [`docs/architecture-overview.md`](./docs/architecture-overview.md).
 
-> 🚧 **Early alpha.** The end-to-end MVP works — `run create` → plan gate → implement → review → PR → merge
+> 🚧 **Early alpha.** The end-to-end MVP works — create a run → plan gate → implement → review → PR → merge
 > gate — see [`docs/roadmap.md`](./docs/roadmap.md).
 
 ## Start here
@@ -15,6 +15,154 @@ a post-MVP goal; see [`docs/architecture-overview.md`](./docs/architecture-overv
 - Architecture & invariants: [`docs/architecture-overview.md`](./docs/architecture-overview.md)
 - Docs index & roadmap: [`docs/README.md`](./docs/README.md) · [`docs/roadmap.md`](./docs/roadmap.md)
 
+## Local Development
+
+`revo` is one daemonized product. **`revo start`** brings up the whole stack — the standalone
+Revisium daemon plus the Revo host daemon that owns DBOS and serves the GraphQL + MCP front doors —
+and bootstraps the control-plane so it is ready to use. The CLI is lifecycle-only
+(`start` / `stop` / `status` / `restart` / `doctor` / `logs`); orchestration (runs, inbox, …) is
+reached over **MCP** (agents) or **GraphQL** (UI/scripts), both served by the daemon.
+
+Run a source checkout alongside an installed package without collisions via a named **profile**
+(`--profile dev`, or `REVO_PROFILE=dev`): the `dev` profile shifts the whole port band off the
+`default` profile, so the two never share a port, data dir, or `dbos` database.
+
+```sh
+pnpm install
+pnpm run revo -- start --profile dev    # standalone + host daemon, bootstrapped & ready
+pnpm run revo -- status --profile dev   # stack health summary
+pnpm run revo -- doctor --profile dev   # diagnose process / port / profile issues
+pnpm run revo -- logs --profile dev     # tail host + standalone logs; add -f to follow
+pnpm run revo -- restart --profile dev  # stop, then start
+pnpm run revo -- stop --profile dev
+```
+
+| Knob | `default` (installed package) | `dev` (source checkout) |
+| --- | --- | --- |
+| data dir | `~/.revisium-orchestrator` | `~/.revisium-orchestrator-dev` |
+| standalone HTTP / Postgres | `19222` / `15440` | `19622` / `15840` |
+| Revo GraphQL | `19223` | `19623` |
+| DBOS database | `dbos` | `dbos_dev` |
+
+Any single knob can be overridden explicitly — `REVO_DATA_DIR` / `REVO_PORT` / `REVO_PG_PORT` /
+`REVO_GRAPHQL_PORT` / `REVO_DBOS_DB` — and an explicit env var always wins over the profile band.
+
+Connect an agent over MCP (a thin stdio bridge that forwards to the running daemon):
+
+```sh
+claude mcp add revo -- pnpm --dir "$PWD" run revo -- mcp
+```
+
+Run the local verification gates:
+
+```sh
+pnpm run typecheck
+pnpm run lint:ci
+pnpm run test:cov
+pnpm run verify
+```
+
+The smoke scripts are guarded: they require a non-default `REVO_DATA_DIR`,
+`REVO_PORT`, `REVO_PG_PORT`, and `REVO_DBOS_DB`; GraphQL smoke paths also require
+`REVO_GRAPHQL_PORT`.
+
+```sh
+pnpm run smoke:control-plane
+pnpm run smoke:create-run
+pnpm run smoke:inspect-run
+```
+
+### Live Run Observability Smoke
+
+This smoke runs a real agent. It can call provider CLIs and incur cost. Use it
+only when that is intentional.
+
+```sh
+export REVO_SMOKE_REPO=/path/to/local/sandbox-repo
+pnpm run revo -- start --profile dev   # standalone + host daemon (serves GraphQL + MCP), ready
+```
+
+Drive and observe a run through the daemon's front doors — there are no `run`/`serve` CLI commands.
+From an agent, use the MCP tools (`create_run`, `start_run`, then `get_agent_activity` /
+`get_agent_log`). From a UI or script, use the GraphQL front door the daemon already serves at
+`http://127.0.0.1:$REVO_GRAPHQL_PORT/graphql` — create a run:
+
+```graphql
+mutation Create($data: CreateRunInput!) {
+  createRun(data: $data) {
+    runId
+  }
+}
+```
+
+Then observe it over the same endpoint:
+
+```graphql
+query Activity($runId: ID!) {
+  runAgentActivity(runId: $runId) {
+    runId
+    aggregateStatus
+    latestOutputAt
+    attempts {
+      attemptId
+      runner
+      status
+      stdoutBytes
+      stderrBytes
+      artifactRef
+    }
+  }
+}
+
+query Log($data: GetAgentLogInput!) {
+  runAgentLog(data: $data) {
+    runId
+    attemptId
+    stream
+    offsetBytes
+    nextOffsetBytes
+    totalBytes
+    truncated
+    content
+  }
+}
+```
+
+For MCP, configure the MCP client to launch this checkout's local binary with the
+same environment. The MCP tools do not accept per-call profile arguments; the
+profile comes from the process environment.
+
+```json
+{
+  "mcpServers": {
+    "revo-dev": {
+      "command": "/path/to/agent-orchestrator/bin/revo.js",
+      "args": ["mcp"],
+      "env": {
+        "REVO_DATA_DIR": "/path/to/.revisium-orchestrator-dev",
+        "REVO_PORT": "19622",
+        "REVO_PG_PORT": "15840",
+        "REVO_GRAPHQL_PORT": "19623",
+        "REVO_DBOS_DB": "dbos_dev"
+      }
+    }
+  }
+}
+```
+
+Useful MCP observability tools for the same run:
+
+- `get_agent_activity`
+- `get_agent_attempts`
+- `get_agent_log`
+- `read_agent_output_events`
+- `tail_agent_log`
+
+If running from a sandboxed automation environment, local server checks may fail
+with `listen EPERM` or a misleading `No free port found from <port>`. Re-run the
+daemon, GraphQL, and MCP smoke commands from a normal terminal or an approved
+unsandboxed execution context.
+
 ## License
 
 See [LICENSE](./LICENSE).

package/dist/api/graphql-api/filters/agent-observability-exception.filter.js

@@ -0,0 +1,24 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Catch } from '@nestjs/common';
+import { GraphQLError } from 'graphql';
+import { AgentObservabilityError } from '../../../observability/types.js';
+let AgentObservabilityExceptionFilter = class AgentObservabilityExceptionFilter {
+    catch(exception, host) {
+        if (host.getType() !== 'graphql') {
+            throw exception;
+        }
+        throw new GraphQLError(exception.message, {
+            extensions: { code: exception.code },
+        });
+    }
+};
+AgentObservabilityExceptionFilter = __decorate([
+    Catch(AgentObservabilityError)
+], AgentObservabilityExceptionFilter);
+export { AgentObservabilityExceptionFilter };
+//# sourceMappingURL=agent-observability-exception.filter.js.map

package/dist/api/graphql-api/filters/agent-observability-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observability-exception.filter.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/filters/agent-observability-exception.filter.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAiB,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,IAAM,iCAAiC,GAAvC,MAAM,iCAAiC;IAC5C,KAAK,CAAC,SAAkC,EAAE,IAAmB;QAC3D,IAAI,IAAI,CAAC,OAAO,EAAkB,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,MAAM,IAAI,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE;YACxC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAVY,iCAAiC;IAD7C,KAAK,CAAC,uBAAuB,CAAC;GAClB,iCAAiC,CAU7C"}

package/dist/api/graphql-api/graphql-api.module.js

@@ -15,6 +15,7 @@ import { PrApiModule } from '../../features/pr/pr-api.module.js';
 import { RunsApiModule } from '../../features/runs/runs-api.module.js';
 import { SystemApiModule } from '../../features/system/system-api.module.js';
 import { createGraphqlMetricsPlugin } from '../../infrastructure/metrics/graphql/graphql-metrics.js';
+import { AgentObservabilityExceptionFilter } from './filters/agent-observability-exception.filter.js';
 import { GraphQLValidationExceptionFilter } from './filters/graphql-validation-exception.filter.js';
 import { PubSubModule } from './graphql-ws/pubsub.module.js';
 import { InboxResolver } from './inbox/inbox.resolver.js';
@@ -56,6 +57,7 @@ GraphqlApiModule = __decorate([
             }),
         ],
         providers: [
+            { provide: APP_FILTER, useClass: AgentObservabilityExceptionFilter },
             { provide: APP_FILTER, useClass: GraphQLValidationExceptionFilter },
             InboxResolver,
             InboxSubscriptionResolver,

package/dist/api/graphql-api/graphql-api.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-api.module.js","sourceRoot":"","sources":["../../../src/api/graphql-api/graphql-api.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,gCAAgC,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAwCtD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,gBAAgB;IAtC5B,MAAM,CAAC;QACN,OAAO,EAAE;YACP,cAAc;YACd,eAAe;YACf,WAAW;YACX,YAAY;YACZ,aAAa;YACb,eAAe;YACf,aAAa,CAAC,YAAY,CAAmB;gBAC3C,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;oBACjB,IAAI,EAAE,UAAU;oBAChB,cAAc,EAAE,IAAI;oBACpB,UAAU,EAAE,IAAI;oBAChB,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE;oBAC7D,yBAAyB,EAAE;wBACzB,6BAA6B,EAAE,QAAQ;qBACxC;oBACD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;oBACpD,OAAO,EAAE,CAAC,0BAA0B,EAAE,CAAC;iBACxC,CAAC;aACH,CAAC;SACH;QACD,SAAS,EAAE;YACT,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gCAAgC,EAAE;YACnE,aAAa;YACb,yBAAyB;YACzB,cAAc;YACd,UAAU;YACV,iBAAiB;YACjB,iBAAiB;YACjB,mBAAmB;YACnB,YAAY;YACZ,wBAAwB;YACxB,cAAc;SACf;KACF,CAAC;GACW,gBAAgB,CAAG;;AAEhC,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"graphql-api.module.js","sourceRoot":"","sources":["../../../src/api/graphql-api/graphql-api.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mDAAmD,CAAC;AACtG,OAAO,EAAE,gCAAgC,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAyCtD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,gBAAgB;IAvC5B,MAAM,CAAC;QACN,OAAO,EAAE;YACP,cAAc;YACd,eAAe;YACf,WAAW;YACX,YAAY;YACZ,aAAa;YACb,eAAe;YACf,aAAa,CAAC,YAAY,CAAmB;gBAC3C,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;oBACjB,IAAI,EAAE,UAAU;oBAChB,cAAc,EAAE,IAAI;oBACpB,UAAU,EAAE,IAAI;oBAChB,aAAa,EAAE,IAAI;oBACnB,SAAS,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE;oBAC7D,yBAAyB,EAAE;wBACzB,6BAA6B,EAAE,QAAQ;qBACxC;oBACD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;oBACpD,OAAO,EAAE,CAAC,0BAA0B,EAAE,CAAC;iBACxC,CAAC;aACH,CAAC;SACH;QACD,SAAS,EAAE;YACT,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iCAAiC,EAAE;YACpE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gCAAgC,EAAE;YACnE,aAAa;YACb,yBAAyB;YACzB,cAAc;YACd,UAAU;YACV,iBAAiB;YACjB,iBAAiB;YACjB,mBAAmB;YACnB,YAAY;YACZ,wBAAwB;YACxB,cAAc;SACf;KACF,CAAC;GACW,gBAAgB,CAAG;;AAEhC,oBAAoB,EAAE,CAAC"}

package/dist/api/graphql-api/graphql-ws/agent-observability-subscription-bridge.service.js

@@ -0,0 +1,296 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AgentObservabilitySubscriptionBridge_1;
+import { Inject, Injectable, Logger } from '@nestjs/common';
+import { TaskControlPlaneApiService } from '../../../task-control-plane/task-control-plane-api.service.js';
+import { RUN_AGENT_ACTIVITY_UPDATED_TOPIC, RUN_AGENT_OUTPUT_APPENDED_TOPIC, } from './constants.js';
+import { mapAgentOutputEventForSubscription, mapAgentRunActivityForSubscription, } from './agent-observability-subscription-mappers.js';
+const LIVE_TAIL_WARMUP_IDLE_MS = 25;
+const LIVE_TAIL_WARMUP_MAX_EVENTS = 1_000;
+const SUBSCRIPTION_QUEUE_MAX_VALUES = 1_000;
+const SUBSCRIPTION_REFETCH_CODE = 'AGENT_OBSERVABILITY_REFETCH_REQUIRED';
+const SUBSCRIPTION_REFETCH_MESSAGE = 'agent observability subscription is no longer current; refetch current agent observability state before resubscribing';
+export class AgentObservabilitySubscriptionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentObservabilitySubscriptionError';
+    }
+}
+let AgentObservabilitySubscriptionBridge = AgentObservabilitySubscriptionBridge_1 = class AgentObservabilitySubscriptionBridge {
+    api;
+    logger = new Logger(AgentObservabilitySubscriptionBridge_1.name);
+    watchers = new Map();
+    constructor(api) {
+        this.api = api;
+    }
+    onModuleDestroy() {
+        for (const state of this.watchers.values()) {
+            state.abort.abort();
+            for (const subscriber of state.subscribers)
+                subscriber.close();
+        }
+        this.watchers.clear();
+    }
+    subscribeToActivity(runId) {
+        return this.retain(runId, RUN_AGENT_ACTIVITY_UPDATED_TOPIC, (signal) => this.watchActivity(runId, signal));
+    }
+    subscribeToOutput(runId) {
+        return this.retain(runId, RUN_AGENT_OUTPUT_APPENDED_TOPIC, (signal) => this.watchOutput(runId, signal));
+    }
+    retain(runId, topic, start) {
+        const key = watcherKey(topic, runId);
+        const current = this.watchers.get(key);
+        const subscriber = new SubscriptionQueue(() => this.release(runId, topic, subscriber));
+        if (current) {
+            current.subscribers.add(subscriber);
+            return subscriber;
+        }
+        const abort = new AbortController();
+        const state = { abort, subscribers: new Set([subscriber]) };
+        this.watchers.set(key, state);
+        void start(abort.signal)
+            .catch((error) => {
+            if (abort.signal.aborted)
+                return;
+            const subscriptionError = toSubscriptionError(error);
+            this.logger.warn(`${topic} watch stopped for ${runId}: ${subscriptionError.code}; ${diagnosticMessage(error)}`);
+            for (const item of state.subscribers)
+                item.fail(subscriptionError);
+        })
+            .finally(() => {
+            const latest = this.watchers.get(key);
+            if (latest !== state)
+                return;
+            for (const item of state.subscribers)
+                item.close();
+            this.watchers.delete(key);
+        });
+        return subscriber;
+    }
+    release(runId, topic, subscriber) {
+        const key = watcherKey(topic, runId);
+        const state = this.watchers.get(key);
+        if (!state)
+            return;
+        state.subscribers.delete(subscriber);
+        if (state.subscribers.size > 0)
+            return;
+        state.abort.abort();
+        this.watchers.delete(key);
+    }
+    async watchActivity(runId, signal) {
+        await consumeLiveTail(this.api.watchAgentActivity({ runId }), signal, (activity) => this.publishActivity(runId, activity));
+    }
+    async watchOutput(runId, signal) {
+        await consumeLiveTail(this.api.watchAgentOutput({ runId }), signal, (event) => this.publishOutput(runId, event));
+    }
+    publishActivity(runId, activity) {
+        if (activity.runId !== runId)
+            return;
+        this.publish(RUN_AGENT_ACTIVITY_UPDATED_TOPIC, runId, {
+            runAgentActivityUpdated: mapAgentRunActivityForSubscription(activity),
+            runId,
+        });
+    }
+    publishOutput(runId, event) {
+        if (event.runId !== runId)
+            return;
+        this.publish(RUN_AGENT_OUTPUT_APPENDED_TOPIC, runId, {
+            runAgentOutputAppended: mapAgentOutputEventForSubscription(event),
+            runId,
+        });
+    }
+    publish(topic, runId, payload) {
+        const state = this.watchers.get(watcherKey(topic, runId));
+        if (!state)
+            return;
+        for (const subscriber of state.subscribers) {
+            const result = subscriber.push(payload);
+            if (result === 'overflow') {
+                this.logger.warn(`${topic} subscriber queue overflow for ${runId}: ${SUBSCRIPTION_REFETCH_CODE}; queued values exceeded ${SUBSCRIPTION_QUEUE_MAX_VALUES}`);
+            }
+        }
+    }
+};
+AgentObservabilitySubscriptionBridge = AgentObservabilitySubscriptionBridge_1 = __decorate([
+    Injectable(),
+    __param(0, Inject(TaskControlPlaneApiService)),
+    __metadata("design:paramtypes", [TaskControlPlaneApiService])
+], AgentObservabilitySubscriptionBridge);
+export { AgentObservabilitySubscriptionBridge };
+function watcherKey(topic, runId) {
+    return `${topic}:${runId}`;
+}
+function diagnosticMessage(error) {
+    return stringifyReason(error);
+}
+function toError(error, fallbackMessage) {
+    if (error instanceof Error)
+        return error;
+    return new Error(error === undefined ? fallbackMessage : stringifyReason(error));
+}
+function stringifyReason(reason) {
+    if (reason instanceof Error)
+        return reason.message;
+    if (typeof reason === 'string')
+        return reason;
+    if (reason === undefined)
+        return 'undefined';
+    if (reason === null)
+        return 'null';
+    if (typeof reason === 'number' || typeof reason === 'boolean' || typeof reason === 'bigint')
+        return `${reason}`;
+    if (typeof reason === 'symbol')
+        return reason.description ? `Symbol(${reason.description})` : 'Symbol()';
+    if (typeof reason === 'function')
+        return reason.name ? `[function ${reason.name}]` : '[function]';
+    try {
+        return JSON.stringify(reason) ?? 'unserializable object';
+    }
+    catch {
+        return 'unserializable object';
+    }
+}
+function toSubscriptionError(_error) {
+    return refetchRequiredSubscriptionError();
+}
+function refetchRequiredSubscriptionError() {
+    return new AgentObservabilitySubscriptionError(SUBSCRIPTION_REFETCH_CODE, SUBSCRIPTION_REFETCH_MESSAGE);
+}
+async function consumeLiveTail(source, signal, publish) {
+    const iterator = source[Symbol.asyncIterator]();
+    let pending = iterator.next();
+    let live = false;
+    let skipped = 0;
+    const abort = () => {
+        void iterator.return?.(undefined).catch(() => undefined);
+    };
+    signal.addEventListener('abort', abort, { once: true });
+    try {
+        while (!signal.aborted) {
+            const next = live ? await pending : await nextWithTimeout(pending, LIVE_TAIL_WARMUP_IDLE_MS);
+            if (next === 'timeout') {
+                live = true;
+                continue;
+            }
+            pending = iterator.next();
+            if (next.done || signal.aborted)
+                break;
+            if (!live) {
+                skipped += 1;
+                if (skipped > LIVE_TAIL_WARMUP_MAX_EVENTS)
+                    throw liveTailOverflowError();
+                continue;
+            }
+            publish(next.value);
+        }
+    }
+    finally {
+        signal.removeEventListener('abort', abort);
+        await iterator.return?.(undefined).catch(() => undefined);
+    }
+}
+function liveTailOverflowError() {
+    return refetchRequiredSubscriptionError();
+}
+async function nextWithTimeout(pending, timeoutMs) {
+    let timer;
+    try {
+        return await Promise.race([
+            pending,
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve('timeout'), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+class SubscriptionQueue {
+    onReturn;
+    maxValues;
+    values = [];
+    waiters = [];
+    closed = false;
+    error;
+    released = false;
+    constructor(onReturn, maxValues = SUBSCRIPTION_QUEUE_MAX_VALUES) {
+        this.onReturn = onReturn;
+        this.maxValues = maxValues;
+    }
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+    next() {
+        if (this.error)
+            return Promise.reject(this.error);
+        if (this.values.length > 0) {
+            return Promise.resolve({ done: false, value: this.values.shift() });
+        }
+        if (this.closed)
+            return Promise.resolve({ done: true, value: undefined });
+        return new Promise((resolve, reject) => this.waiters.push({ resolve, reject }));
+    }
+    async return() {
+        this.close();
+        this.release();
+        return { done: true, value: undefined };
+    }
+    async throw(error) {
+        this.close();
+        this.release();
+        throw toError(error, 'subscription iterator thrown');
+    }
+    push(value) {
+        if (this.closed || this.error)
+            return 'closed';
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter.resolve({ done: false, value });
+            return 'accepted';
+        }
+        if (this.values.length >= this.maxValues) {
+            this.fail(refetchRequiredSubscriptionError());
+            this.release();
+            return 'overflow';
+        }
+        this.values.push(value);
+        return 'accepted';
+    }
+    fail(error) {
+        if (this.closed || this.error)
+            return;
+        this.error = toError(error, 'subscription queue failed');
+        this.values.splice(0);
+        for (const waiter of this.waiters.splice(0))
+            waiter.reject(this.error);
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const waiter of this.waiters.splice(0))
+            waiter.resolve({ done: true, value: undefined });
+    }
+    release() {
+        if (this.released)
+            return;
+        this.released = true;
+        this.onReturn();
+    }
+}
+//# sourceMappingURL=agent-observability-subscription-bridge.service.js.map

package/dist/api/graphql-api/graphql-ws/agent-observability-subscription-bridge.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observability-subscription-bridge.service.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/graphql-ws/agent-observability-subscription-bridge.service.ts"],"names":[],"mappings":"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"}

package/dist/api/graphql-api/graphql-ws/agent-observability-subscription-mappers.js

@@ -0,0 +1,64 @@
+import { AgentOutputStream, } from '../runs/model/agent-activity.model.js';
+function toDate(value) {
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? new Date(0) : parsed;
+}
+function mapOutputStream(stream) {
+    if (stream === 'stdout')
+        return AgentOutputStream.stdout;
+    if (stream === 'stderr')
+        return AgentOutputStream.stderr;
+    if (stream === 'agent-jsonl')
+        return AgentOutputStream.agent_jsonl;
+    return undefined;
+}
+function mapActivitySnapshot(snapshot) {
+    return {
+        runId: snapshot.runId,
+        attemptId: snapshot.attemptId,
+        stepId: snapshot.stepId,
+        stepKey: snapshot.stepKey,
+        role: snapshot.role,
+        runner: snapshot.runner,
+        pid: snapshot.pid,
+        status: snapshot.status,
+        startedAt: toDate(snapshot.startedAt),
+        lastEventAt: toDate(snapshot.lastEventAt),
+        lastOutputAt: snapshot.lastOutputAt ? toDate(snapshot.lastOutputAt) : undefined,
+        lastStream: mapOutputStream(snapshot.lastStream),
+        stdoutBytes: snapshot.stdoutBytes,
+        stderrBytes: snapshot.stderrBytes,
+        eventCount: snapshot.eventCount,
+        artifactRef: snapshot.artifactRef,
+        exitCode: snapshot.exitCode ?? null,
+        timedOut: snapshot.timedOut,
+        error: snapshot.error,
+    };
+}
+export function mapAgentRunActivityForSubscription(activity) {
+    return {
+        runId: activity.runId,
+        aggregateStatus: activity.aggregateStatus,
+        latestActivityAt: toDate(activity.latestActivityAt),
+        latestOutputAt: activity.latestOutputAt ? toDate(activity.latestOutputAt) : undefined,
+        attempts: activity.attempts.map(mapActivitySnapshot),
+    };
+}
+export function mapAgentOutputEventForSubscription(event) {
+    return {
+        cursor: event.cursor,
+        runId: event.runId,
+        attemptId: event.attemptId,
+        attemptSeq: event.attemptSeq,
+        stepId: event.stepId,
+        stepKey: event.stepKey,
+        at: toDate(event.at),
+        kind: event.kind,
+        stream: mapOutputStream(event.stream),
+        bytes: event.bytes,
+        preview: event.preview,
+        parsedType: event.parsedType,
+        statusHint: event.statusHint,
+    };
+}
+//# sourceMappingURL=agent-observability-subscription-mappers.js.map

package/dist/api/graphql-api/graphql-ws/agent-observability-subscription-mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observability-subscription-mappers.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/graphql-ws/agent-observability-subscription-mappers.ts"],"names":[],"mappings":"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"}

package/dist/api/graphql-api/graphql-ws/constants.js

@@ -3,6 +3,8 @@ export const RUN_UPDATED_TOPIC = 'runUpdated';
 export const RUN_WORKFLOW_UPDATED_TOPIC = 'runWorkflowUpdated';
 export const RUN_EVENT_APPENDED_TOPIC = 'runEventAppended';
 export const RUN_PROGRESS_UPDATED_TOPIC = 'runProgressUpdated';
+export const RUN_AGENT_ACTIVITY_UPDATED_TOPIC = 'runAgentActivityUpdated';
+export const RUN_AGENT_OUTPUT_APPENDED_TOPIC = 'runAgentOutputAppended';
 export const INBOX_ITEM_ADDED_TOPIC = 'inboxItemAdded';
 export const INBOX_ITEM_RESOLVED_TOPIC = 'inboxItemResolved';
 export const RUN_COST_RECORDED_TOPIC = 'runCostRecorded';

package/dist/api/graphql-api/graphql-ws/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/graphql-ws/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/graphql-ws/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,CAAC,MAAM,gCAAgC,GAAG,yBAAyB,CAAC;AAC1E,MAAM,CAAC,MAAM,+BAA+B,GAAG,wBAAwB,CAAC;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC"}

package/dist/api/graphql-api/graphql-ws/pubsub.module.js

@@ -7,6 +7,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { Global, Module } from '@nestjs/common';
 import { PubSub } from 'graphql-subscriptions';
 import { RunsApiModule } from '../../../features/runs/runs-api.module.js';
+import { TaskControlPlaneModule } from '../../../task-control-plane/task-control-plane.module.js';
+import { AgentObservabilitySubscriptionBridge } from './agent-observability-subscription-bridge.service.js';
 import { APP_PUB_SUB } from './constants.js';
 import { ControlPlaneSubscriptionBridge } from './subscription-bridge.service.js';
 import { RunProgressSubscriptionPoller } from './run-progress-subscription-poller.service.js';
@@ -15,14 +17,15 @@ let PubSubModule = class PubSubModule {
 PubSubModule = __decorate([
     Global(),
     Module({
-        imports: [RunsApiModule],
+        imports: [RunsApiModule, TaskControlPlaneModule],
         providers: [
             // Local-first production choice. Swap this provider to graphql-redis-subscriptions for multi-instance hosts.
             { provide: APP_PUB_SUB, useFactory: () => new PubSub() },
+            AgentObservabilitySubscriptionBridge,
             ControlPlaneSubscriptionBridge,
             RunProgressSubscriptionPoller,
         ],
-        exports: [APP_PUB_SUB],
+        exports: [APP_PUB_SUB, AgentObservabilitySubscriptionBridge],
     })
 ], PubSubModule);
 export { PubSubModule };

package/dist/api/graphql-api/graphql-ws/pubsub.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub.module.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/graphql-ws/pubsub.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAavF,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,YAAY;IAXxB,MAAM,EAAE;IACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,SAAS,EAAE;YACT,6GAA6G;YAC7G,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,EAAE;YACxD,8BAA8B;YAC9B,6BAA6B;SAC9B;QACD,OAAO,EAAE,CAAC,WAAW,CAAC;KACvB,CAAC;GACW,YAAY,CAAG"}
+{"version":3,"file":"pubsub.module.js","sourceRoot":"","sources":["../../../../src/api/graphql-api/graphql-ws/pubsub.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,EAAE,oCAAoC,EAAE,MAAM,sDAAsD,CAAC;AAC5G,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAcvF,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,YAAY;IAZxB,MAAM,EAAE;IACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,aAAa,EAAE,sBAAsB,CAAC;QAChD,SAAS,EAAE;YACT,6GAA6G;YAC7G,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,EAAE;YACxD,oCAAoC;YACpC,8BAA8B;YAC9B,6BAA6B;SAC9B;QACD,OAAO,EAAE,CAAC,WAAW,EAAE,oCAAoC,CAAC;KAC7D,CAAC;GACW,YAAY,CAAG"}