@hearsay-tools/squawk 0.0.0-stage → 0.17.0-pr3058.5683

package/dist/server/activity-routes.d.ts

@@ -0,0 +1,317 @@
+import { ActivityDemand } from '../activity/demand.ts';
+import type { ActivityChangeSource } from '../activity/publisher.ts';
+import { type ActivityDeps, type CiProgressSource } from '../activity/read-model.ts';
+import type { ToolActivityTracker } from '../activity/tool-activity.ts';
+import { type ActivitySourceDeps, type LoadedProject } from './activity-sources.ts';
+import type { WorkspaceProjects } from './workspace-projects.ts';
+import type { SocketHub } from './ws.ts';
+/** What the server process owns for the activity view (`ServerDeps` extends it). */
+export interface ActivityServerDeps {
+    /** The process's tool activity tracker: `serve` builds one and gives it to every run manager.
+     *  Absent (an app built without boot's wiring), no run reports a tool. */
+    toolActivity?: ToolActivityTracker | undefined;
+}
+export interface ActivityRouteDeps extends Omit<ActivitySourceDeps, 'ciOf'>, ActivityServerDeps {
+    contexts: ActivitySourceDeps['contexts'] & {
+        onContextBuilt?(listener: () => void): () => void;
+    };
+    workspaceProjects: ActivitySourceDeps['workspaceProjects'] & Pick<WorkspaceProjects, 'resolveLiveProject'>;
+    /** The projects activity readers watch: the HTTP route, the topics and every CI progress
+     *  registry share this one instance. */
+    demand?: ActivityDemand;
+    /** The trackers (tool activity, CI progress) and the clock. Default CI progress: each loaded
+     *  project's own manager's registry, which its CI watchers publish to. */
+    activity?: Omit<ActivityDeps, 'onUnreadable'>;
+    /** More change signals that wake the topics' publishers, besides the tool tracker and the CI
+     *  progress registries. */
+    changes?: readonly ActivityChangeSource[];
+    /** The live server's socket hub: when present, the activity topics register on it too, and its
+     *  close (the server's close path) releases what the route plugged into the CI registries. */
+    socketHub?: SocketHub | undefined;
+    /** Project added or removed (the workspace event bus). */
+    workspaceEvents?: {
+        on(listener: (event: string, data: unknown) => void): () => void;
+    };
+}
+/**
+ * The CI progress registries the activity view reads (spec 2026-11-05-live-activity-view, CI check
+ * progress). A project's registry is its own manager's, which need not be the boot manager's (each
+ * workspace semaphore has its own). The first read of a project plugs its registry in once: the
+ * registry gets the process's one activity demand, and its changes wake the topics' publishers.
+ * `release` undoes every plug; the server's close path calls it. After it, a read that was still
+ * in flight then plugs nothing: no demand or listener outlives the server.
+ */
+export declare function ciProgressPlugs(demand: ActivityDemand): {
+    progressOf: (project: LoadedProject) => CiProgressSource | undefined;
+    changes: ActivityChangeSource;
+    release: () => void;
+    closed: () => boolean;
+};
+/**
+ * `GET /workspace/activity` (spec 2026-11-05-live-activity-view, Live transport): the activity
+ * snapshot of one project (`project`), or of every visible project. The global read never builds a
+ * project context, which would recover its runs: a project this process has not loaded answers
+ * `loaded: false` with empty lists. A loaded project whose store cannot open carries the failure
+ * its project routes answer in `unavailable`. With a socket hub, the same snapshots also go out on
+ * the topics `activity:project:<id>` and `activity:workspace`, whose subscribers hold the same
+ * demand.
+ */
+export declare function createActivityRoutes(routeDeps: ActivityRouteDeps): import("hono/hono-base").HonoBase<import("hono/types").BlankEnv, {
+    "/workspace/activity": {
+        $get: {
+            output: {
+                generatedAt: string;
+                projects: {
+                    projectId: string;
+                    name: string;
+                    loaded: boolean;
+                    unavailable?: {
+                        status: 404 | 409 | 503;
+                        error: string;
+                    } | undefined;
+                    inReview: number;
+                    tasks: {
+                        runId: string;
+                        title: string;
+                        status: "cancelled" | "done" | "failed" | "queued" | "review" | "running" | "waiting";
+                        rung: "cancelled" | "done" | "failed" | "monitoring" | "needs-permission" | "needs-review" | "needs-you" | "queued" | "running" | "unseen" | "usage-limit" | "waiting-for-capacity" | "waiting-for-ci" | "waiting-for-command" | "waiting-for-merge" | "waiting-on-subagents" | "waiting-on-workers";
+                        runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                        model?: string | undefined;
+                        currentStepId?: string | undefined;
+                        startedAt?: string | undefined;
+                        wait?: {
+                            kind: "human";
+                            since: string;
+                            detail: {
+                                question?: string | undefined;
+                                reason: "budget" | "completion" | "question" | "turn-end";
+                                queuedMessages?: number | undefined;
+                            };
+                        } | {
+                            kind: "usage-limit";
+                            detail: {
+                                resumeAt: string;
+                            };
+                        } | {
+                            kind: "workers";
+                            since: string;
+                            deadline?: string | undefined;
+                            detail: {
+                                owed: number;
+                                total: number;
+                                settled: number;
+                                replies?: true | undefined;
+                                mode?: "all" | "any" | "one" | undefined;
+                                recipientRunIds: string[];
+                            };
+                        } | {
+                            kind: "peers";
+                            since: string;
+                            deadline: string;
+                            detail: {
+                                peerRunIds: string[];
+                            };
+                        } | {
+                            kind: "subagents";
+                            since: string;
+                            deadline: string;
+                            detail: {
+                                running: number;
+                            };
+                        } | {
+                            kind: "pr";
+                            since: string;
+                            deadline: string;
+                            detail: {
+                                number: number;
+                                target: "checks" | "merge" | "merge_or_blocked";
+                                checks?: {
+                                    name: string;
+                                    bucket: "cancel" | "fail" | "pass" | "pending" | "skipping";
+                                }[] | undefined;
+                                counts?: {
+                                    pass: number;
+                                    fail: number;
+                                    pending: number;
+                                    skipping: number;
+                                    cancel: number;
+                                } | undefined;
+                                truncated?: true | undefined;
+                            };
+                        } | {
+                            kind: "process";
+                            since: string;
+                            deadline: string;
+                            detail: {
+                                pid: number;
+                                note?: string | undefined;
+                            };
+                        } | {
+                            kind: "timer";
+                            since: string;
+                            deadline: string;
+                            detail: {
+                                wakeAt: string;
+                                note?: string | undefined;
+                            };
+                        } | undefined;
+                        tool?: {
+                            title: string;
+                            toolKind: "delete" | "edit" | "execute" | "fetch" | "move" | "other" | "plan" | "read" | "search" | "task" | "think";
+                            status: "completed" | "declined" | "failed" | "pending" | "running";
+                            startedAt: string;
+                            endedAt?: string | undefined;
+                        } | undefined;
+                        rate: number[];
+                        error?: string | undefined;
+                        workers: {
+                            runId: string;
+                            title: string;
+                            status: "cancelled" | "done" | "failed" | "queued" | "review" | "running" | "waiting";
+                            rung: "cancelled" | "done" | "failed" | "monitoring" | "needs-permission" | "needs-review" | "needs-you" | "queued" | "running" | "unseen" | "usage-limit" | "waiting-for-capacity" | "waiting-for-ci" | "waiting-for-command" | "waiting-for-merge" | "waiting-on-subagents" | "waiting-on-workers";
+                            runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                            model?: string | undefined;
+                            currentStepId?: string | undefined;
+                            startedAt?: string | undefined;
+                            wait?: {
+                                kind: "human";
+                                since: string;
+                                detail: {
+                                    question?: string | undefined;
+                                    reason: "budget" | "completion" | "question" | "turn-end";
+                                    queuedMessages?: number | undefined;
+                                };
+                            } | {
+                                kind: "usage-limit";
+                                detail: {
+                                    resumeAt: string;
+                                };
+                            } | {
+                                kind: "workers";
+                                since: string;
+                                deadline?: string | undefined;
+                                detail: {
+                                    owed: number;
+                                    total: number;
+                                    settled: number;
+                                    replies?: true | undefined;
+                                    mode?: "all" | "any" | "one" | undefined;
+                                    recipientRunIds: string[];
+                                };
+                            } | {
+                                kind: "peers";
+                                since: string;
+                                deadline: string;
+                                detail: {
+                                    peerRunIds: string[];
+                                };
+                            } | {
+                                kind: "subagents";
+                                since: string;
+                                deadline: string;
+                                detail: {
+                                    running: number;
+                                };
+                            } | {
+                                kind: "pr";
+                                since: string;
+                                deadline: string;
+                                detail: {
+                                    number: number;
+                                    target: "checks" | "merge" | "merge_or_blocked";
+                                    checks?: {
+                                        name: string;
+                                        bucket: "cancel" | "fail" | "pass" | "pending" | "skipping";
+                                    }[] | undefined;
+                                    counts?: {
+                                        pass: number;
+                                        fail: number;
+                                        pending: number;
+                                        skipping: number;
+                                        cancel: number;
+                                    } | undefined;
+                                    truncated?: true | undefined;
+                                };
+                            } | {
+                                kind: "process";
+                                since: string;
+                                deadline: string;
+                                detail: {
+                                    pid: number;
+                                    note?: string | undefined;
+                                };
+                            } | {
+                                kind: "timer";
+                                since: string;
+                                deadline: string;
+                                detail: {
+                                    wakeAt: string;
+                                    note?: string | undefined;
+                                };
+                            } | undefined;
+                            tool?: {
+                                title: string;
+                                toolKind: "delete" | "edit" | "execute" | "fetch" | "move" | "other" | "plan" | "read" | "search" | "task" | "think";
+                                status: "completed" | "declined" | "failed" | "pending" | "running";
+                                startedAt: string;
+                                endedAt?: string | undefined;
+                            } | undefined;
+                            rate: number[];
+                            error?: string | undefined;
+                            revision: number;
+                            collected: boolean;
+                        }[];
+                    }[];
+                    requests: {
+                        requestId: string;
+                        relationship: "family" | "peer";
+                        senderRunId: string;
+                        recipientRunId: string;
+                        text: string;
+                        senderTitle?: string | undefined;
+                        recipientTitle?: string | undefined;
+                        createdAt: string;
+                        deadline?: string | undefined;
+                    }[];
+                    closed: {
+                        requestId: string;
+                        senderRunId: string;
+                        recipientRunId: string;
+                        status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                        observedAt: string;
+                    }[];
+                }[];
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                query: {
+                    project?: string | undefined;
+                };
+            };
+        } | {
+            output: {
+                error: string;
+                code?: "invalid_input" | undefined;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                query: {
+                    project?: string | undefined;
+                };
+            };
+        } | {
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404 | 409 | 503;
+            input: {
+                query: {
+                    project?: string | undefined;
+                };
+            };
+        };
+    };
+}, "/", "/workspace/activity">;

package/dist/server/activity-routes.js

@@ -0,0 +1,117 @@
+import { logPrefix } from '../home/display.js';
+import { registerReportsTopic } from './reports-topic.js';
+import { Hono } from 'hono';
+import { activityQuerySchema } from '../contract/index.js';
+import { ActivityDemand } from '../activity/demand.js';
+import { buildActivitySnapshot, unreadableLogger } from '../activity/read-model.js';
+import { createActivitySources } from './activity-sources.js';
+import { projectEventOf } from './activity-project-topic.js';
+import { registerActivityTopics } from './activity-topic.js';
+import { queryZodValidator } from './validators.js';
+/**
+ * The CI progress registries the activity view reads (spec 2026-11-05-live-activity-view, CI check
+ * progress). A project's registry is its own manager's, which need not be the boot manager's (each
+ * workspace semaphore has its own). The first read of a project plugs its registry in once: the
+ * registry gets the process's one activity demand, and its changes wake the topics' publishers.
+ * `release` undoes every plug; the server's close path calls it. After it, a read that was still
+ * in flight then plugs nothing: no demand or listener outlives the server.
+ */
+export function ciProgressPlugs(demand) {
+    let closed = false;
+    const plugged = new WeakSet();
+    const releases = [];
+    const listeners = new Set();
+    const changes = {
+        onChange: (listener) => {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+    };
+    const progressOf = (project) => {
+        // A manager test double may carry no registry.
+        const registry = project.manager.ciProgress;
+        if (registry && !closed && !plugged.has(registry)) {
+            plugged.add(registry);
+            releases.push(registry.useDemand(demand));
+            releases.push(registry.onChange(() => { for (const listener of [...listeners])
+                listener(); }));
+        }
+        return registry;
+    };
+    const release = () => {
+        closed = true;
+        for (const undo of releases.splice(0))
+            undo();
+    };
+    return { progressOf, changes, release, closed: () => closed };
+}
+/**
+ * `GET /workspace/activity` (spec 2026-11-05-live-activity-view, Live transport): the activity
+ * snapshot of one project (`project`), or of every visible project. The global read never builds a
+ * project context, which would recover its runs: a project this process has not loaded answers
+ * `loaded: false` with empty lists. A loaded project whose store cannot open carries the failure
+ * its project routes answer in `unavailable`. With a socket hub, the same snapshots also go out on
+ * the topics `activity:project:<id>` and `activity:workspace`, whose subscribers hold the same
+ * demand.
+ */
+export function createActivityRoutes(routeDeps) {
+    const { contexts, workspaceProjects, demand = new ActivityDemand(), activity = {}, socketHub, workspaceEvents, toolActivity } = routeDeps;
+    const tools = activity.tools ?? toolActivity;
+    const deps = { ...activity, ...(tools ? { tools } : {}), onUnreadable: unreadableLogger() };
+    // An explicit `activity.ci` replaces every project's registry.
+    const ci = ciProgressPlugs(demand);
+    const sources = createActivitySources({ ...routeDeps, ciOf: (project) => (activity.ci ? undefined : ci.progressOf(project)) });
+    // The publishers wake on the tool tracker's changes and on every plugged registry's changes.
+    const changes = [...(routeDeps.changes ?? []), ...(toolActivity && !activity.tools ? [toolActivity] : []), ci.changes];
+    if (socketHub) {
+        socketHub.onClose(ci.release);
+        registerReportsTopic(socketHub, workspaceProjects);
+        registerActivityTopics(socketHub, {
+            sources,
+            workspaceProjects,
+            demand,
+            publisher: { ...deps, changes,
+                onBuildError: (error) => console.warn(`${logPrefix()} activity snapshot failed; the next change retries it:`, error) },
+            onProjectsChange: (listener) => {
+                const offBuilt = contexts.onContextBuilt?.(listener);
+                const offEvents = workspaceEvents?.on((event) => { if (event === 'project-added' || event === 'project-removed')
+                    listener(); });
+                return () => { offBuilt?.(); offEvents?.(); };
+            },
+            onProjectEvent: (listener) => workspaceEvents?.on((event, data) => {
+                const change = projectEventOf(event, data);
+                if (change)
+                    listener(change.event, change.projectId);
+            }) ?? (() => undefined),
+        });
+    }
+    const snapshot = (projects) => {
+        const body = buildActivitySnapshot(projects, deps);
+        // A read that answers after the server closed marks no demand.
+        if (!ci.closed())
+            for (const project of body.projects)
+                if (project.loaded && !project.unavailable)
+                    demand.markRead(project.projectId);
+        return body;
+    };
+    return new Hono().get('/workspace/activity', queryZodValidator(activityQuerySchema), async (c) => {
+        const { project: raw } = c.req.valid('query');
+        if (raw !== undefined) {
+            let project;
+            try {
+                project = await workspaceProjects.resolveLiveProject(raw);
+            }
+            catch (error) {
+                const failure = workspaceProjects.projectFailure(error, raw);
+                return c.json({ error: failure.error }, failure.status);
+            }
+            if (project.store.unavailable) {
+                const failure = workspaceProjects.projectFailure(project.store.unavailable, project.id);
+                return c.json({ error: failure.error }, failure.status);
+            }
+            return c.json(snapshot([await sources.project(project)]), 200);
+        }
+        return c.json(snapshot(await sources.workspace()), 200);
+    });
+}
+//# sourceMappingURL=activity-routes.js.map

package/dist/server/activity-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-routes.js","sourceRoot":"","sources":["../../src/server/activity-routes.ts"],"names":[],"mappings":"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"}

package/dist/server/activity-sources.d.ts

@@ -0,0 +1,26 @@
+import type { LiveActivitySource } from '../activity/publisher.ts';
+import type { CiProgressSource } from '../activity/read-model.ts';
+import type { ProjectContext } from './project-context.ts';
+import type { WorkspaceProjects } from './workspace-projects.ts';
+export type LoadedProject = Pick<ProjectContext, 'id' | 'root' | 'store' | 'manager'>;
+export interface ActivitySourceDeps {
+    bootContext: LoadedProject;
+    contexts: {
+        peek(projectId: string): LoadedProject | undefined;
+    };
+    workspaceProjects: Pick<WorkspaceProjects, 'listVisibleProjects' | 'resolveBootProject' | 'projectFailure'>;
+    /** The check progress of a loaded project's own CI watchers. */
+    ciOf?: (project: LoadedProject) => CiProgressSource | undefined;
+}
+/**
+ * The projects an activity read covers (spec 2026-11-05-live-activity-view), shared by the HTTP
+ * route and the topics so both answer the same snapshot. The workspace read never builds a project
+ * context, which would recover its runs: a project this process has not loaded has no store.
+ */
+export declare function createActivitySources({ bootContext, contexts, workspaceProjects, ciOf }: ActivitySourceDeps): {
+    loadedSource: (project: LoadedProject, name: string) => LiveActivitySource;
+    /** One loaded project, named from the registry. */
+    project: (project: LoadedProject) => Promise<LiveActivitySource>;
+    /** Every visible project; the ones this process has not loaded answer `loaded: false`. */
+    workspace: () => Promise<LiveActivitySource[]>;
+};

package/dist/server/activity-sources.js

@@ -0,0 +1,45 @@
+import { basename } from 'node:path';
+import { projectPaths } from '../project-paths.js';
+import { projectAdmissionRefusal } from './cockpit-ownership.js';
+/**
+ * The projects an activity read covers (spec 2026-11-05-live-activity-view), shared by the HTTP
+ * route and the topics so both answer the same snapshot. The workspace read never builds a project
+ * context, which would recover its runs: a project this process has not loaded has no store.
+ */
+export function createActivitySources({ bootContext, contexts, workspaceProjects, ciOf }) {
+    /** A store that cannot open, or a project under a migration fence, never reads as empty
+     *  (docs/areas/runs-store.md): it carries the failure. */
+    const loadedSource = (project, name) => {
+        const failure = project.store.unavailable ?? projectAdmissionRefusal(projectPaths(project.root).write);
+        return {
+            projectId: project.id,
+            name,
+            ...(failure
+                ? { unavailable: workspaceProjects.projectFailure(failure, project.id) }
+                : { loaded: { store: project.store, isActive: (runId) => project.manager.isActive(runId), ci: ciOf?.(project), dataDir: projectPaths(project.root).write } }),
+        };
+    };
+    /** The registry, or undefined when it cannot be read. */
+    const visibleProjects = () => workspaceProjects.listVisibleProjects().catch(() => undefined);
+    const projectName = (projects, id, root) => projects?.find((project) => project.id === id)?.name ?? basename(root);
+    return {
+        loadedSource,
+        /** One loaded project, named from the registry. */
+        project: async (project) => loadedSource(project, projectName(await visibleProjects(), project.id, project.root)),
+        /** Every visible project; the ones this process has not loaded answer `loaded: false`. */
+        workspace: async () => {
+            const projects = await visibleProjects();
+            const bootId = await workspaceProjects.resolveBootProject(projects);
+            const sources = (projects ?? []).map((entry) => {
+                const owned = entry.id === bootId ? { ...bootContext, id: bootId } : contexts.peek(entry.id);
+                return owned ? loadedSource(owned, entry.name) : { projectId: entry.id, name: entry.name };
+            });
+            // The boot project this process runs is always in the snapshot, loaded or unavailable: also
+            // when it is not registered, or when the registry cannot be read. It comes first.
+            if (!projects?.some((entry) => entry.id === bootId))
+                sources.unshift(loadedSource({ ...bootContext, id: bootId }, projectName(undefined, bootId, bootContext.root)));
+            return sources;
+        },
+    };
+}
+//# sourceMappingURL=activity-sources.js.map

package/dist/server/activity-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-sources.js","sourceRoot":"","sources":["../../src/server/activity-sources.ts"],"names":[],"mappings":"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"}

package/dist/server/activity-topic.d.ts

@@ -0,0 +1,33 @@
+import type { ActivityDemand } from '../activity/demand.ts';
+import { type ActivityPublisherDeps } from '../activity/publisher.ts';
+import { type ProjectEvent } from './activity-project-topic.ts';
+import type { createActivitySources, LoadedProject } from './activity-sources.ts';
+import type { WorkspaceProjects } from './workspace-projects.ts';
+import type { SocketHub } from './ws.ts';
+/** The topic family of one project's activity: `activity:project:<projectId>`. */
+export declare const ACTIVITY_PROJECT_TOPIC_PREFIX = "activity:project:";
+/** Every project's activity, for the global view. */
+export declare const ACTIVITY_WORKSPACE_TOPIC = "activity:workspace";
+export interface ActivityTopicDeps {
+    sources: ReturnType<typeof createActivitySources>;
+    workspaceProjects: {
+        resolveLiveProject(id: string): Promise<LoadedProject>;
+    } & Pick<WorkspaceProjects, 'projectFailure'>;
+    /** The scope changes of the workspace topic: a project built, added or removed. */
+    onProjectsChange: (listener: () => void) => () => void;
+    /** The registry's project-added and project-removed events, for the project topics. */
+    onProjectEvent: (listener: (event: ProjectEvent, projectId: string) => void) => () => void;
+    demand: ActivityDemand;
+    publisher: ActivityPublisherDeps;
+}
+/**
+ * Register the activity topics (spec 2026-11-05-live-activity-view, Live transport). Both keep the
+ * default `loopbackReadable: false`: they carry run titles, tool titles and request text. A
+ * project id the registry does not know answers the hub's unknown-topic error. A known project
+ * whose context cannot build yet gets a topic that sends that failure and binds once the project
+ * resolves. A project topic follows the registry: a removed project sends
+ * one unavailable frame and stops its work, and a re-added one binds to its new context, retrying
+ * a failed resolution when the project's context gets built or a subscriber arrives. A project
+ * id never holds a colon, so the names cannot collide.
+ */
+export declare function registerActivityTopics(hub: SocketHub, deps: ActivityTopicDeps): void;

package/dist/server/activity-topic.js

@@ -0,0 +1,48 @@
+import { createActivityPublisher } from '../activity/publisher.js';
+import { createProjectTopicPublisher } from './activity-project-topic.js';
+import { ProjectContextError } from './project-context.js';
+/** The topic family of one project's activity: `activity:project:<projectId>`. */
+export const ACTIVITY_PROJECT_TOPIC_PREFIX = 'activity:project:';
+/** Every project's activity, for the global view. */
+export const ACTIVITY_WORKSPACE_TOPIC = 'activity:workspace';
+/**
+ * Register the activity topics (spec 2026-11-05-live-activity-view, Live transport). Both keep the
+ * default `loopbackReadable: false`: they carry run titles, tool titles and request text. A
+ * project id the registry does not know answers the hub's unknown-topic error. A known project
+ * whose context cannot build yet gets a topic that sends that failure and binds once the project
+ * resolves. A project topic follows the registry: a removed project sends
+ * one unavailable frame and stops its work, and a re-added one binds to its new context, retrying
+ * a failed resolution when the project's context gets built or a subscriber arrives. A project
+ * id never holds a colon, so the names cannot collide.
+ */
+export function registerActivityTopics(hub, deps) {
+    hub.registerTopicFamily(ACTIVITY_PROJECT_TOPIC_PREFIX, async (projectId) => {
+        let start;
+        try {
+            start = { project: await deps.workspaceProjects.resolveLiveProject(projectId) };
+        }
+        catch (error) {
+            // Only an id the registry does not know names no topic. A known project whose context
+            // cannot build now (folder missing, store unavailable) starts unbound with that failure.
+            const unavailable = deps.workspaceProjects.projectFailure(error, projectId);
+            if (unavailable.status === 404)
+                return undefined;
+            start = { projectId, unavailable };
+        }
+        return createProjectTopicPublisher(start, {
+            sources: deps.sources,
+            demand: deps.demand,
+            publisher: deps.publisher,
+            resolve: (id) => deps.workspaceProjects.resolveLiveProject(id),
+            failure: (error, id) => deps.workspaceProjects.projectFailure(error, id),
+            removedError: (id) => new ProjectContextError('unknown-project', id),
+            onProjectEvent: deps.onProjectEvent,
+        });
+    });
+    hub.registerTopic(ACTIVITY_WORKSPACE_TOPIC, createActivityPublisher({
+        sources: () => deps.sources.workspace(),
+        onScopeChange: deps.onProjectsChange,
+        watch: () => deps.demand.watch(),
+    }, deps.publisher));
+}
+//# sourceMappingURL=activity-topic.js.map

package/dist/server/activity-topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-topic.js","sourceRoot":"","sources":["../../src/server/activity-topic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAA8B,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,2BAA2B,EAAqB,MAAM,6BAA6B,CAAC;AAE7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI3D,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAAmB,CAAC;AACjE,qDAAqD;AACrD,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAa7D;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAc,EAAE,IAAuB;IAC5E,GAAG,CAAC,mBAAmB,CAAC,6BAA6B,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QACzE,IAAI,KAAwD,CAAC;QAC7D,IAAI,CAAC;YACH,KAAK,GAAG,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sFAAsF;YACtF,yFAAyF;YACzF,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAC5E,IAAI,WAAW,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,SAAS,CAAC;YACjD,KAAK,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,2BAA2B,CAAC,KAAK,EAAE;YACxC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;YACxE,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACpE,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,wBAAwB,EAAE,uBAAuB,CAAC;QAClE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;QACvC,aAAa,EAAE,IAAI,CAAC,gBAAgB;QACpC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;KACjC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AACtB,CAAC"}

package/dist/server/app-type.d.ts

@@ -0,0 +1,6 @@
+import type { createApp } from './server.ts';
+/**
+ * Type-only HTTP route table inferred from chained versioned family builders. Loose
+ * registrations discard accumulated route types. This module must introduce no runtime imports.
+ */
+export type AppType = ReturnType<typeof createApp>;

package/dist/server/app-type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-type.js.map

package/dist/server/app-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-type.js","sourceRoot":"","sources":["../../src/server/app-type.ts"],"names":[],"mappings":""}