@rk0429/agentic-relay 3.5.0 → 3.7.0

package/dist/interfaces/cli/visualization-renderer.js.map

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

package/dist/interfaces/mcp/relay-mcp-server.js

@@ -73,7 +73,7 @@ const deleteTaskInputSchema = {
 export function createRelayMcpServer(options) {
     const server = new McpServer({
         name: "agentic-relay",
-        version: "3.5.0",
+        version: "3.7.0",
     });
     if (options.allowSpawnAgents) {
         server.tool("spawn_agents", "Launch one or more child agent CLI processes in parallel.", spawnAgentsInputSchema, async (args, extra) => {

package/dist/interfaces/vscode/extension.d.ts

@@ -0,0 +1,3 @@
+import * as vscode from "vscode";
+export declare function activate(context: vscode.ExtensionContext): void;
+export declare function deactivate(): void;

package/dist/interfaces/vscode/extension.js

@@ -0,0 +1,213 @@
+import { existsSync, watch } from "node:fs";
+import path from "node:path";
+import * as vscode from "vscode";
+import { ProjectionService } from "../../application/projection-service.js";
+import { RelayStore } from "../../infrastructure/store/relay-store.js";
+import { activeAgentLabel, activeAgentTooltip, describeActiveAgent, describeTaskNode, taskTooltip, } from "./view-model.js";
+const REFRESH_DEBOUNCE_MS = 150;
+export function activate(context) {
+    const coordinator = new VisualizationCoordinator();
+    const taskProvider = new TaskTreeProvider(coordinator);
+    const agentProvider = new ActiveAgentsProvider(coordinator);
+    context.subscriptions.push(coordinator, taskProvider, agentProvider, vscode.window.registerTreeDataProvider("agenticRelay.taskTree", taskProvider), vscode.window.registerTreeDataProvider("agenticRelay.activeAgents", agentProvider), vscode.commands.registerCommand("agenticRelay.refreshViews", () => {
+        coordinator.refresh();
+    }));
+}
+export function deactivate() { }
+class VisualizationCoordinator {
+    emitter = new vscode.EventEmitter();
+    disposables = [];
+    watchers = [];
+    refreshTimer;
+    onDidChange = this.emitter.event;
+    constructor() {
+        this.rebuildWatchers();
+        this.disposables.push(vscode.workspace.onDidChangeWorkspaceFolders(() => {
+            this.rebuildWatchers();
+            this.scheduleRefresh();
+        }));
+    }
+    async getSnapshot() {
+        const workspaceFolder = vscode.workspace.workspaceFolders?.[0];
+        if (!workspaceFolder) {
+            return undefined;
+        }
+        const store = new RelayStore(path.join(workspaceFolder.uri.fsPath, ".relay"));
+        const projectionService = new ProjectionService({
+            store,
+        });
+        return projectionService.getVisualizationSnapshot();
+    }
+    refresh() {
+        this.emitter.fire();
+    }
+    dispose() {
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+        }
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers.length = 0;
+        for (const disposable of this.disposables) {
+            disposable.dispose();
+        }
+        this.emitter.dispose();
+    }
+    scheduleRefresh() {
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+        }
+        this.refreshTimer = setTimeout(() => {
+            this.refresh();
+        }, REFRESH_DEBOUNCE_MS);
+    }
+    rebuildWatchers() {
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers.length = 0;
+        for (const workspaceFolder of vscode.workspace.workspaceFolders ?? []) {
+            for (const watchPath of relayWatchPaths(workspaceFolder.uri.fsPath)) {
+                if (!existsSync(watchPath)) {
+                    continue;
+                }
+                try {
+                    const watcher = watch(watchPath, () => {
+                        this.rebuildWatchers();
+                        this.scheduleRefresh();
+                    });
+                    this.watchers.push(watcher);
+                }
+                catch {
+                    // Ignore unsupported watch targets and keep the view available.
+                }
+            }
+        }
+    }
+}
+class TaskTreeProvider {
+    coordinator;
+    emitter = new vscode.EventEmitter();
+    onDidChangeTreeData = this.emitter.event;
+    subscription;
+    constructor(coordinator) {
+        this.coordinator = coordinator;
+        this.subscription = this.coordinator.onDidChange(() => {
+            this.emitter.fire(undefined);
+        });
+    }
+    dispose() {
+        this.subscription.dispose();
+        this.emitter.dispose();
+    }
+    getTreeItem(element) {
+        return element;
+    }
+    async getChildren(element) {
+        if (element) {
+            return element.children;
+        }
+        const snapshot = await this.coordinator.getSnapshot();
+        if (!snapshot) {
+            return [messageItem("Open a workspace folder to inspect .relay data.")];
+        }
+        if (snapshot.task_tree.length === 0) {
+            return [messageItem("No tasks found under .relay/tasks.")];
+        }
+        return snapshot.task_tree.map((node) => toTaskItem(node));
+    }
+}
+class ActiveAgentsProvider {
+    coordinator;
+    emitter = new vscode.EventEmitter();
+    onDidChangeTreeData = this.emitter.event;
+    subscription;
+    constructor(coordinator) {
+        this.coordinator = coordinator;
+        this.subscription = this.coordinator.onDidChange(() => {
+            this.emitter.fire(undefined);
+        });
+    }
+    dispose() {
+        this.subscription.dispose();
+        this.emitter.dispose();
+    }
+    getTreeItem(element) {
+        return element;
+    }
+    async getChildren(element) {
+        if (element) {
+            return element.children;
+        }
+        const snapshot = await this.coordinator.getSnapshot();
+        if (!snapshot) {
+            return [messageItem("Open a workspace folder to inspect .relay data.")];
+        }
+        if (snapshot.active_agents.length === 0) {
+            return [messageItem("No active agents.")];
+        }
+        return snapshot.active_agents.map((agent) => toAgentItem(agent));
+    }
+}
+class RelayTreeItem extends vscode.TreeItem {
+    children;
+    constructor(label, children = []) {
+        super(label, children.length > 0
+            ? vscode.TreeItemCollapsibleState.Expanded
+            : vscode.TreeItemCollapsibleState.None);
+        this.children = children;
+    }
+}
+function toTaskItem(node) {
+    const item = new RelayTreeItem(node.title, node.children.map((child) => toTaskItem(child)));
+    item.id = node.task_id;
+    item.description = describeTaskNode(node);
+    item.tooltip = new vscode.MarkdownString(taskTooltip(node));
+    item.contextValue = node.status === "blocked" ? "agenticRelay.blockedTask" : "agenticRelay.task";
+    item.iconPath = taskStatusIcon(node.status);
+    return item;
+}
+function toAgentItem(agent) {
+    const item = new RelayTreeItem(activeAgentLabel(agent));
+    item.id = agent.agent_id;
+    item.description = describeActiveAgent(agent);
+    item.tooltip = new vscode.MarkdownString(activeAgentTooltip(agent));
+    item.contextValue = "agenticRelay.activeAgent";
+    item.iconPath = new vscode.ThemeIcon("run");
+    return item;
+}
+function messageItem(label) {
+    const item = new RelayTreeItem(label);
+    item.iconPath = new vscode.ThemeIcon("info");
+    return item;
+}
+function relayWatchPaths(workspacePath) {
+    return [
+        workspacePath,
+        path.join(workspacePath, ".relay"),
+        path.join(workspacePath, ".relay", "tasks"),
+        path.join(workspacePath, ".relay", "logs"),
+    ];
+}
+function taskStatusIcon(status) {
+    switch (status) {
+        case "backlog":
+            return new vscode.ThemeIcon("circle-large-outline");
+        case "ready":
+            return new vscode.ThemeIcon("clock");
+        case "in_progress":
+            return new vscode.ThemeIcon("sync");
+        case "review":
+            return new vscode.ThemeIcon("eye");
+        case "blocked":
+            return new vscode.ThemeIcon("warning", new vscode.ThemeColor("list.errorForeground"));
+        case "done":
+            return new vscode.ThemeIcon("check", new vscode.ThemeColor("charts.green"));
+        case "superseded":
+            return new vscode.ThemeIcon("debug-step-over");
+        case "archived":
+            return new vscode.ThemeIcon("archive");
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/interfaces/vscode/extension.js.map

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

package/dist/interfaces/vscode/relay-file-watcher.d.ts

@@ -0,0 +1,23 @@
+export interface DisposableWatcher {
+    close(): void;
+}
+type WatchFactory = (targetPath: string, listener: () => void) => DisposableWatcher;
+export declare class RelayFileWatcher {
+    private readonly options;
+    private readonly watchFactory;
+    private readonly debounceMs;
+    private readonly watchers;
+    private refreshTimer?;
+    constructor(options: {
+        workspaceRoot: string;
+        onChange: () => void;
+        watchFactory?: WatchFactory;
+        debounceMs?: number;
+    });
+    start(): void;
+    dispose(): void;
+    private syncWatchers;
+    private scheduleRefresh;
+}
+export declare function collectWatchTargets(workspaceRoot: string): string[];
+export {};

package/dist/interfaces/vscode/relay-file-watcher.js

@@ -0,0 +1,80 @@
+import { existsSync, watch } from "node:fs";
+import path from "node:path";
+export class RelayFileWatcher {
+    options;
+    watchFactory;
+    debounceMs;
+    watchers = new Map();
+    refreshTimer;
+    constructor(options) {
+        this.options = options;
+        this.watchFactory = options.watchFactory ?? defaultWatchFactory;
+        this.debounceMs = options.debounceMs ?? 100;
+    }
+    start() {
+        this.syncWatchers();
+    }
+    dispose() {
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = undefined;
+        }
+        for (const watcher of this.watchers.values()) {
+            watcher.close();
+        }
+        this.watchers.clear();
+    }
+    syncWatchers() {
+        const nextTargets = new Set(collectWatchTargets(this.options.workspaceRoot));
+        for (const [targetPath, watcher] of this.watchers.entries()) {
+            if (nextTargets.has(targetPath)) {
+                continue;
+            }
+            watcher.close();
+            this.watchers.delete(targetPath);
+        }
+        for (const targetPath of nextTargets) {
+            if (this.watchers.has(targetPath)) {
+                continue;
+            }
+            const watcher = this.watchFactory(targetPath, () => {
+                this.syncWatchers();
+                this.scheduleRefresh();
+            });
+            this.watchers.set(targetPath, watcher);
+        }
+    }
+    scheduleRefresh() {
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+        }
+        this.refreshTimer = setTimeout(() => {
+            this.refreshTimer = undefined;
+            this.options.onChange();
+        }, this.debounceMs);
+    }
+}
+export function collectWatchTargets(workspaceRoot) {
+    const relayRoot = path.join(workspaceRoot, ".relay");
+    return [
+        workspaceRoot,
+        relayRoot,
+        path.join(relayRoot, "tasks"),
+        path.join(relayRoot, "logs"),
+    ].filter((targetPath, index, allTargets) => {
+        if (index === 0) {
+            return true;
+        }
+        return existsSync(targetPath) && allTargets.indexOf(targetPath) === index;
+    });
+}
+function defaultWatchFactory(targetPath, listener) {
+    const watcher = watch(targetPath, { persistent: false }, () => {
+        listener();
+    });
+    watcher.on("error", () => {
+        listener();
+    });
+    return watcher;
+}
+//# sourceMappingURL=relay-file-watcher.js.map

package/dist/interfaces/vscode/relay-file-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-file-watcher.js","sourceRoot":"","sources":["../../../src/interfaces/vscode/relay-file-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,MAAM,OAAO,gBAAgB;IAOR;IANF,YAAY,CAAe;IAC3B,UAAU,CAAS;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACzD,YAAY,CAAkB;IAEtC,YACmB,OAKhB;QALgB,YAAO,GAAP,OAAO,CAKvB;QAED,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,mBAAmB,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC9C,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEM,OAAO;QACZ,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,YAAY;QAClB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAE7E,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5D,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE;gBACjD,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,aAAqB;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACrD,OAAO;QACL,aAAa;QACb,SAAS;QACT,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC;KAC7B,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;QACzC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,UAAkB,EAClB,QAAoB;IAEpB,MAAM,OAAO,GAAc,KAAK,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE;QACvE,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACvB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/interfaces/vscode/tree-data-providers.d.ts

@@ -0,0 +1,34 @@
+import * as vscode from "vscode";
+import type { VisualizationSnapshot } from "../../core/types.js";
+import { type ActiveAgentItemModel, type TaskTreeItemModel } from "./view-model.js";
+type SnapshotLoader = () => Promise<VisualizationSnapshot>;
+type TreeNode = TaskTreeItemModel | ActiveAgentItemModel | {
+    kind: "message";
+    id: string;
+    label: string;
+    description?: string;
+};
+export declare class TaskTreeDataProvider implements vscode.TreeDataProvider<TreeNode> {
+    private readonly loadSnapshot;
+    private readonly didChangeTreeDataEmitter;
+    private items;
+    readonly onDidChangeTreeData: vscode.Event<void | TreeNode | undefined>;
+    constructor(loadSnapshot: SnapshotLoader);
+    refresh(): Promise<void>;
+    getTreeItem(element: TreeNode): vscode.TreeItem;
+    getChildren(element?: TreeNode): vscode.ProviderResult<TreeNode[]>;
+    dispose(): void;
+}
+export declare class ActiveAgentDataProvider implements vscode.TreeDataProvider<TreeNode> {
+    private readonly loadSnapshot;
+    private readonly didChangeTreeDataEmitter;
+    private items;
+    readonly onDidChangeTreeData: vscode.Event<void | TreeNode | undefined>;
+    constructor(loadSnapshot: SnapshotLoader);
+    refresh(): Promise<void>;
+    getTreeItem(element: TreeNode): vscode.TreeItem;
+    getChildren(): vscode.ProviderResult<TreeNode[]>;
+    dispose(): void;
+}
+export declare function createSnapshotLoader(workspaceRoot?: string, projectionFactory?: (workspaceRoot: string) => SnapshotLoader): SnapshotLoader;
+export {};

package/dist/interfaces/vscode/tree-data-providers.js

@@ -0,0 +1,117 @@
+import * as vscode from "vscode";
+import { buildActiveAgentItemModels, buildTaskTreeItemModels, emptySnapshot, } from "./view-model.js";
+export class TaskTreeDataProvider {
+    loadSnapshot;
+    didChangeTreeDataEmitter = new vscode.EventEmitter();
+    items = [messageNode("task-empty", "No tasks found.")];
+    onDidChangeTreeData = this.didChangeTreeDataEmitter.event;
+    constructor(loadSnapshot) {
+        this.loadSnapshot = loadSnapshot;
+    }
+    async refresh() {
+        this.items = await loadTaskItems(this.loadSnapshot);
+        this.didChangeTreeDataEmitter.fire(undefined);
+    }
+    getTreeItem(element) {
+        if (element.kind === "message") {
+            const item = new vscode.TreeItem(element.label, vscode.TreeItemCollapsibleState.None);
+            item.description = element.description;
+            item.contextValue = "agenticRelay.message";
+            return item;
+        }
+        const item = new vscode.TreeItem(element.label, element.kind === "task" && element.children.length > 0
+            ? vscode.TreeItemCollapsibleState.Collapsed
+            : vscode.TreeItemCollapsibleState.None);
+        item.id = element.id;
+        item.description = element.description;
+        item.tooltip = element.tooltip;
+        item.iconPath = new vscode.ThemeIcon(element.icon);
+        item.contextValue =
+            element.kind === "task" ? "agenticRelay.task" : "agenticRelay.agent";
+        return item;
+    }
+    getChildren(element) {
+        if (!element) {
+            return this.items;
+        }
+        if (element.kind !== "task") {
+            return [];
+        }
+        return element.children;
+    }
+    dispose() {
+        this.didChangeTreeDataEmitter.dispose();
+    }
+}
+export class ActiveAgentDataProvider {
+    loadSnapshot;
+    didChangeTreeDataEmitter = new vscode.EventEmitter();
+    items = [messageNode("agents-empty", "No active agents.")];
+    onDidChangeTreeData = this.didChangeTreeDataEmitter.event;
+    constructor(loadSnapshot) {
+        this.loadSnapshot = loadSnapshot;
+    }
+    async refresh() {
+        this.items = await loadAgentItems(this.loadSnapshot);
+        this.didChangeTreeDataEmitter.fire(undefined);
+    }
+    getTreeItem(element) {
+        if (element.kind === "message") {
+            const item = new vscode.TreeItem(element.label, vscode.TreeItemCollapsibleState.None);
+            item.description = element.description;
+            item.contextValue = "agenticRelay.message";
+            return item;
+        }
+        const item = new vscode.TreeItem(element.label, vscode.TreeItemCollapsibleState.None);
+        item.id = element.id;
+        item.description = element.description;
+        item.tooltip = element.tooltip;
+        item.iconPath = new vscode.ThemeIcon(element.icon);
+        item.contextValue = "agenticRelay.agent";
+        return item;
+    }
+    getChildren() {
+        return this.items;
+    }
+    dispose() {
+        this.didChangeTreeDataEmitter.dispose();
+    }
+}
+async function loadTaskItems(loadSnapshot) {
+    try {
+        const snapshot = await loadSnapshot();
+        const items = buildTaskTreeItemModels(snapshot.task_tree);
+        return items.length > 0 ? items : [messageNode("task-empty", "No tasks found.")];
+    }
+    catch (error) {
+        return [messageNode("task-error", "Failed to load tasks.", toErrorMessage(error))];
+    }
+}
+async function loadAgentItems(loadSnapshot) {
+    try {
+        const snapshot = await loadSnapshot();
+        const items = buildActiveAgentItemModels(snapshot.active_agents);
+        return items.length > 0 ? items : [messageNode("agents-empty", "No active agents.")];
+    }
+    catch (error) {
+        return [messageNode("agents-error", "Failed to load active agents.", toErrorMessage(error))];
+    }
+}
+export function createSnapshotLoader(workspaceRoot, projectionFactory) {
+    if (!workspaceRoot || !projectionFactory) {
+        return async () => emptySnapshot();
+    }
+    return projectionFactory(workspaceRoot);
+}
+function messageNode(id, label, description) {
+    return {
+        kind: "message",
+        id,
+        label,
+        description,
+    };
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : "Unknown error";
+}
+//# sourceMappingURL=tree-data-providers.js.map

package/dist/interfaces/vscode/tree-data-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-data-providers.js","sourceRoot":"","sources":["../../../src/interfaces/vscode/tree-data-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,aAAa,GAGd,MAAM,iBAAiB,CAAC;AAczB,MAAM,OAAO,oBAAoB;IAQK;IAPnB,wBAAwB,GAAG,IAAI,MAAM,CAAC,YAAY,EAEhE,CAAC;IACI,KAAK,GAAe,CAAC,WAAW,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE3D,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAE1E,YAAoC,YAA4B;QAA5B,iBAAY,GAAZ,YAAY,CAAgB;IAAG,CAAC;IAE7D,KAAK,CAAC,OAAO;QAClB,IAAI,CAAC,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAEM,WAAW,CAAC,OAAiB;QAClC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,CAC9B,OAAO,CAAC,KAAK,EACb,MAAM,CAAC,wBAAwB,CAAC,IAAI,CACrC,CAAC;YACF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YACvC,IAAI,CAAC,YAAY,GAAG,sBAAsB,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,CAC9B,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACpD,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,SAAS;YAC3C,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,IAAI,CACzC,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY;YACf,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,WAAW,CAAC,OAAkB;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,uBAAuB;IAUE;IAPnB,wBAAwB,GAAG,IAAI,MAAM,CAAC,YAAY,EAEhE,CAAC;IACI,KAAK,GAAe,CAAC,WAAW,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAE/D,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAE1E,YAAoC,YAA4B;QAA5B,iBAAY,GAAZ,YAAY,CAAgB;IAAG,CAAC;IAE7D,KAAK,CAAC,OAAO;QAClB,IAAI,CAAC,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAEM,WAAW,CAAC,OAAiB;QAClC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,CAC9B,OAAO,CAAC,KAAK,EACb,MAAM,CAAC,wBAAwB,CAAC,IAAI,CACrC,CAAC;YACF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YACvC,IAAI,CAAC,YAAY,GAAG,sBAAsB,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,CAC9B,OAAO,CAAC,KAAK,EACb,MAAM,CAAC,wBAAwB,CAAC,IAAI,CACrC,CAAC;QACF,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,oBAAoB,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;CACF;AAED,KAAK,UAAU,aAAa,CAAC,YAA4B;IACvD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,uBAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,uBAAuB,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,YAA4B;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,0BAA0B,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,+BAA+B,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,aAAsB,EACtB,iBAA6D;IAE7D,IAAI,CAAC,aAAa,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzC,OAAO,KAAK,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW,CAClB,EAAU,EACV,KAAa,EACb,WAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,SAAS;QACf,EAAE;QACF,KAAK;QACL,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;AAClE,CAAC"}

package/dist/interfaces/vscode/view-model.d.ts

@@ -0,0 +1,27 @@
+import type { ActiveAgentSummary, TaskTreeNode, VisualizationSnapshot } from "../../core/types.js";
+export interface TaskTreeItemModel {
+    kind: "task";
+    id: string;
+    label: string;
+    description: string;
+    tooltip: string;
+    icon: string;
+    children: TaskTreeItemModel[];
+}
+export interface ActiveAgentItemModel {
+    kind: "agent";
+    id: string;
+    label: string;
+    description: string;
+    tooltip: string;
+    icon: string;
+}
+export declare function buildTaskTreeItemModels(nodes: TaskTreeNode[]): TaskTreeItemModel[];
+export declare function buildActiveAgentItemModels(agents: ActiveAgentSummary[]): ActiveAgentItemModel[];
+export declare function emptySnapshot(): VisualizationSnapshot;
+export declare function describeTaskNode(node: TaskTreeNode): string;
+export declare function taskTooltip(node: TaskTreeNode): string;
+export declare function activeAgentLabel(agent: ActiveAgentSummary): string;
+export declare function describeActiveAgent(agent: ActiveAgentSummary): string;
+export declare function activeAgentTooltip(agent: ActiveAgentSummary): string;
+export declare function formatDuration(totalSeconds: number): string;

package/dist/interfaces/vscode/view-model.js

@@ -0,0 +1,107 @@
+export function buildTaskTreeItemModels(nodes) {
+    return nodes.map((node) => ({
+        kind: "task",
+        id: node.task_id,
+        label: node.title,
+        description: describeTaskNode(node),
+        tooltip: taskTooltip(node),
+        icon: iconForTask(node.status),
+        children: buildTaskTreeItemModels(node.children),
+    }));
+}
+export function buildActiveAgentItemModels(agents) {
+    return agents.map((agent) => ({
+        kind: "agent",
+        id: agent.agent_id,
+        label: activeAgentLabel(agent),
+        description: describeActiveAgent(agent),
+        tooltip: activeAgentTooltip(agent),
+        icon: "run",
+    }));
+}
+export function emptySnapshot() {
+    return {
+        generated_at: new Date(0).toISOString(),
+        task_tree: [],
+        active_agents: [],
+    };
+}
+export function describeTaskNode(node) {
+    const parts = [node.status];
+    if (node.agent_id) {
+        parts.push(`agent ${node.agent_id}`);
+    }
+    if (node.depends_on.length > 0) {
+        parts.push(`deps ${node.depends_on.join(", ")}`);
+    }
+    if (node.status === "blocked" && node.blocked_reason) {
+        parts.push(truncate(node.blocked_reason, 80));
+    }
+    return parts.join(" · ");
+}
+export function taskTooltip(node) {
+    const lines = [
+        node.title,
+        `task_id: ${node.task_id}`,
+        `status: ${node.status}`,
+        `agent: ${node.agent_id ?? "-"}`,
+        `depends_on: ${node.depends_on.length > 0 ? node.depends_on.join(", ") : "-"}`,
+    ];
+    if (node.warnings.length > 0) {
+        lines.push(`warnings: ${node.warnings.join(" | ")}`);
+    }
+    if (node.blocked_reason) {
+        lines.push(`blocked_reason: ${node.blocked_reason}`);
+    }
+    return lines.join("\n");
+}
+export function activeAgentLabel(agent) {
+    return agent.task_title ?? agent.task_id ?? agent.agent_id;
+}
+export function describeActiveAgent(agent) {
+    return `${agent.backend ?? "-"} · ${formatDuration(agent.running_for_seconds)}`;
+}
+export function activeAgentTooltip(agent) {
+    return [
+        agent.agent_id,
+        `task: ${agent.task_title ?? "-"} (${agent.task_id ?? "-"})`,
+        `backend: ${agent.backend ?? "-"}`,
+        `running: ${formatDuration(agent.running_for_seconds)}`,
+        `started_at: ${agent.started_at}`,
+    ].join("\n");
+}
+export function formatDuration(totalSeconds) {
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    return [hours, minutes, seconds]
+        .map((value) => String(value).padStart(2, "0"))
+        .join(":");
+}
+function iconForTask(status) {
+    switch (status) {
+        case "backlog":
+            return "history";
+        case "ready":
+            return "circle-large-outline";
+        case "in_progress":
+            return "sync";
+        case "review":
+            return "eye";
+        case "blocked":
+            return "warning";
+        case "done":
+            return "pass";
+        case "superseded":
+            return "debug-step-over";
+        case "archived":
+            return "archive";
+    }
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength - 1)}…`;
+}
+//# sourceMappingURL=view-model.js.map