@bytetrue/byspace 0.1.0

package/dist/commands/agent/logs.js

@@ -0,0 +1,180 @@
+import { connectToDaemon, getDaemonHost } from "../../utils/client.js";
+import { fetchProjectedTimelineItems, LIVE_HISTORY_FETCH_TIMEOUT_MS, } from "../../utils/timeline.js";
+import { curateAgentActivity } from "@bytetrue/byspace-server";
+export function addLogsOptions(cmd) {
+    return cmd
+        .description("View agent activity/timeline")
+        .argument("<id>", "Agent ID (or prefix)")
+        .option("-f, --follow", "Follow log output (streaming)")
+        .option("--tail <n>", "Show last n entries")
+        .option("--filter <type>", "Filter by event type (tools, text, errors, permissions)")
+        .option("--since <time>", "Show logs since timestamp");
+}
+export const NO_ACTIVITY_MESSAGE = "No activity to display.";
+export async function fetchAgentTimelineItems(client, agentId, options) {
+    return fetchProjectedTimelineItems({ client, agentId, timeoutMs: options?.timeoutMs });
+}
+export function formatAgentActivityTranscript(timelineItems, tailCount) {
+    if (tailCount === 0) {
+        return "";
+    }
+    return curateAgentActivity(timelineItems, tailCount !== undefined ? { maxItems: tailCount } : undefined);
+}
+function parseTailCount(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number.parseInt(raw, 10);
+    if (Number.isNaN(parsed) || parsed < 0) {
+        return undefined;
+    }
+    return parsed;
+}
+/**
+ * Check if a timeline item matches the filter type
+ */
+function matchesFilter(item, filter) {
+    if (!filter)
+        return true;
+    const filterLower = filter.toLowerCase();
+    const type = item.type.toLowerCase();
+    switch (filterLower) {
+        case "tools":
+            return type === "tool_call";
+        case "text":
+            return type === "user_message" || type === "assistant_message" || type === "reasoning";
+        case "errors":
+            return type === "error";
+        case "permissions":
+            // Permissions might be in tool_call status or a separate event type
+            return type.includes("permission");
+        default:
+            // If filter doesn't match predefined types, match against the actual type
+            return type.includes(filterLower);
+    }
+}
+export async function runLogsCommand(id, options, _command) {
+    const host = getDaemonHost({ host: options.host });
+    if (!id) {
+        console.error("Error: Agent ID required");
+        console.error("Usage: byspace agent logs <id>");
+        process.exit(1);
+    }
+    let client;
+    try {
+        client = await connectToDaemon({ host: options.host });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: Cannot connect to daemon at ${host}: ${message}`);
+        console.error("Start the daemon with: byspace daemon start");
+        process.exit(1);
+    }
+    try {
+        const fetchResult = await client.fetchAgent({ agentId: id });
+        if (!fetchResult) {
+            console.error(`Error: No agent found matching: ${id}`);
+            console.error("Use `byspace ls` to list available agents");
+            await client.close();
+            process.exit(1);
+        }
+        const resolvedId = fetchResult.agent.id;
+        // For follow mode, we stream events continuously
+        if (options.follow) {
+            if (options.tail !== undefined && parseTailCount(options.tail) === undefined) {
+                console.error(`Error: Invalid --tail value: ${options.tail}`);
+                console.error("Usage: --tail <n> (where n is >= 0)");
+                await client.close().catch(() => { });
+                process.exit(1);
+            }
+            await runFollowMode(client, resolvedId, options);
+            return;
+        }
+        // Fetch timeline directly via cursor RPC.
+        let timelineItems = await fetchAgentTimelineItems(client, resolvedId);
+        // Apply filter
+        if (options.filter) {
+            timelineItems = timelineItems.filter((item) => matchesFilter(item, options.filter));
+        }
+        const tailCount = parseTailCount(options.tail);
+        if (options.tail !== undefined && tailCount === undefined) {
+            console.error(`Error: Invalid --tail value: ${options.tail}`);
+            console.error("Usage: --tail <n> (where n is >= 0)");
+            await client.close().catch(() => { });
+            process.exit(1);
+        }
+        await client.close();
+        // Use curateAgentActivity to format the transcript
+        if (tailCount === 0) {
+            return;
+        }
+        const transcript = formatAgentActivityTranscript(timelineItems, tailCount);
+        console.log(transcript);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: Failed to get logs: ${message}`);
+        await client.close().catch(() => { });
+        process.exit(1);
+    }
+}
+/**
+ * Follow mode: stream logs in real-time until interrupted
+ */
+async function runFollowMode(client, agentId, options) {
+    const DEFAULT_FOLLOW_TAIL = 10;
+    const tailCount = parseTailCount(options.tail) ?? DEFAULT_FOLLOW_TAIL;
+    // First, get existing timeline.
+    let existingItems = [];
+    try {
+        existingItems = await fetchAgentTimelineItems(client, agentId, {
+            timeoutMs: LIVE_HISTORY_FETCH_TIMEOUT_MS,
+        });
+    }
+    catch (error) {
+        console.warn("Warning: failed to fetch existing timeline", error);
+    }
+    // Apply filter to existing items
+    if (options.filter) {
+        existingItems = existingItems.filter((item) => matchesFilter(item, options.filter));
+    }
+    // Print existing transcript (tail-like behavior)
+    if (tailCount > 0) {
+        const existingTranscript = formatAgentActivityTranscript(existingItems, tailCount);
+        if (existingTranscript !== NO_ACTIVITY_MESSAGE) {
+            console.log(existingTranscript);
+        }
+    }
+    // Subscribe to new events
+    const tailLabel = tailCount === 0 ? "no history" : `last ${tailCount} entr${tailCount === 1 ? "y" : "ies"}`;
+    console.log(`\n--- Following logs (${tailLabel}; Ctrl+C to stop) ---\n`);
+    const unsubscribe = client.on("agent_stream", (msg) => {
+        const message = msg;
+        if (message.type !== "agent_stream")
+            return;
+        if (message.payload.agentId !== agentId)
+            return;
+        if (message.payload.event.type === "timeline") {
+            const item = message.payload.event.item;
+            // Apply filter
+            if (options.filter && !matchesFilter(item, options.filter)) {
+                return;
+            }
+            // Print each timeline item as it arrives using the curator format
+            const transcript = formatAgentActivityTranscript([item]);
+            if (transcript !== NO_ACTIVITY_MESSAGE) {
+                console.log(transcript);
+            }
+        }
+    });
+    // Wait for interrupt
+    await new Promise((resolve) => {
+        const cleanup = () => {
+            unsubscribe();
+            resolve();
+        };
+        process.on("SIGINT", cleanup);
+        process.on("SIGTERM", cleanup);
+    });
+    await client.close();
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/agent/logs.js.map

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

package/dist/commands/agent/ls.d.ts

@@ -0,0 +1,44 @@
+import type { Command } from "commander";
+import { connectToDaemon } from "../../utils/client.js";
+import type { CommandOptions, ListResult, OutputSchema } from "../../output/index.js";
+type FetchAgentsOptions = NonNullable<Parameters<Awaited<ReturnType<typeof connectToDaemon>>["fetchAgents"]>[0]>;
+export declare function addLsOptions(cmd: Command): Command;
+/** Agent list item for display */
+export interface AgentListItem {
+    id: string;
+    shortId: string;
+    name: string;
+    provider: string;
+    thinking: string;
+    status: string;
+    cwd: string;
+    created: string;
+}
+/** Schema for agent ls output */
+export declare const agentLsSchema: OutputSchema<AgentListItem>;
+export type AgentLsResult = ListResult<AgentListItem>;
+export interface AgentLsOptions extends CommandOptions {
+    /** -a: Include archived agents */
+    all?: boolean;
+    /** -g: List agents across all directories */
+    global?: boolean;
+    /** Filter by specific status */
+    status?: string;
+    /** Filter by specific cwd */
+    cwd?: string;
+    /** Filter by labels (key=value format) */
+    label?: string[];
+    /** Filter by thinking option ID */
+    thinking?: string;
+}
+export declare function buildAgentLsFetchOptions(options: Pick<AgentLsOptions, "all" | "global" | "label" | "thinking">): FetchAgentsOptions;
+/**
+ * Agent ls command semantics:
+ * - `byspace agent ls`    → active non-archived agents
+ * - `byspace agent ls -g` → global non-archived agents
+ * - `byspace agent ls -a` → active agents, including archived
+ * - `byspace agent ls -ag` → global agents, including archived
+ */
+export declare function runLsCommand(options: AgentLsOptions, _command: Command): Promise<AgentLsResult>;
+export {};
+//# sourceMappingURL=ls.d.ts.map

package/dist/commands/agent/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/ls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAiB,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAgB,MAAM,uBAAuB,CAAC;AAIpG,KAAK,kBAAkB,GAAG,WAAW,CACnC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1E,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAYlD;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AA8BD,iCAAiC;AACjC,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,aAAa,CAqBrD,CAAC;AAiBF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AAEtD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,kCAAkC;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC,GACrE,kBAAkB,CAuBpB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,aAAa,CAAC,CA2FxB"}

package/dist/commands/agent/ls.js

@@ -0,0 +1,204 @@
+import { connectToDaemon, getDaemonHost } from "../../utils/client.js";
+import { collectMultiple } from "../../utils/command-options.js";
+import { isSameOrDescendantPath } from "../../utils/paths.js";
+export function addLsOptions(cmd) {
+    return cmd
+        .description("List agents. By default excludes archived agents.")
+        .option("-a, --all", "Include archived agents")
+        .option("-g, --global", "List agents across all directories")
+        .option("--label <key=value>", "Filter by label (can be used multiple times)", collectMultiple, [])
+        .option("--thinking <id>", "Filter by thinking option ID");
+}
+/** Helper to get relative time string */
+function relativeTime(date) {
+    const now = Date.now();
+    const then = new Date(date).getTime();
+    const seconds = Math.floor((now - then) / 1000);
+    if (seconds < 60)
+        return "just now";
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)} minutes ago`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)} hours ago`;
+    return `${Math.floor(seconds / 86400)} days ago`;
+}
+/** Shorten home directory in path */
+function shortenPath(path) {
+    const home = process.env.HOME;
+    if (home && path.startsWith(home)) {
+        return "~" + path.slice(home.length);
+    }
+    return path;
+}
+function normalizeModelId(modelId) {
+    if (typeof modelId !== "string")
+        return null;
+    const normalized = modelId.trim();
+    if (!normalized || normalized.toLowerCase() === "default")
+        return null;
+    return normalized;
+}
+/** Schema for agent ls output */
+export const agentLsSchema = {
+    idField: "shortId",
+    columns: [
+        { header: "AGENT ID", field: "shortId", width: 12 },
+        { header: "NAME", field: "name", width: 20 },
+        { header: "PROVIDER", field: "provider", width: 15 },
+        { header: "THINKING", field: "thinking", width: 12 },
+        {
+            header: "STATUS",
+            field: "status",
+            width: 10,
+            color: (value) => {
+                if (value === "running")
+                    return "green";
+                if (value === "idle")
+                    return "yellow";
+                if (value === "error")
+                    return "red";
+                return undefined;
+            },
+        },
+        { header: "CWD", field: "cwd", width: 30 },
+        { header: "CREATED", field: "created", width: 15 },
+    ],
+};
+/** Transform agent snapshot to AgentListItem */
+function toListItem(agent) {
+    const model = normalizeModelId(agent.runtimeInfo?.model) ?? normalizeModelId(agent.model);
+    return {
+        id: agent.id,
+        shortId: agent.id.slice(0, 7),
+        name: agent.title ?? "-",
+        provider: model ? `${agent.provider}/${model}` : agent.provider,
+        thinking: agent.effectiveThinkingOptionId ?? "auto",
+        status: agent.status,
+        cwd: shortenPath(agent.cwd),
+        created: relativeTime(agent.createdAt),
+    };
+}
+function parseLabelFilters(labels) {
+    const labelFilters = {};
+    for (const labelStr of labels ?? []) {
+        const eqIndex = labelStr.indexOf("=");
+        if (eqIndex !== -1) {
+            const key = labelStr.slice(0, eqIndex);
+            const value = labelStr.slice(eqIndex + 1);
+            labelFilters[key] = value;
+        }
+    }
+    return labelFilters;
+}
+export function buildAgentLsFetchOptions(options) {
+    const labelFilters = parseLabelFilters(options.label);
+    const normalizedThinkingOptionId = options.thinking?.trim();
+    const daemonFilter = {};
+    if (options.all) {
+        daemonFilter.includeArchived = true;
+    }
+    if (Object.keys(labelFilters).length > 0) {
+        daemonFilter.labels = labelFilters;
+    }
+    if (normalizedThinkingOptionId) {
+        daemonFilter.thinkingOptionId = normalizedThinkingOptionId;
+    }
+    const fetchOptions = {};
+    if (!options.global) {
+        fetchOptions.scope = "active";
+    }
+    if (Object.keys(daemonFilter).length > 0) {
+        fetchOptions.filter = daemonFilter;
+    }
+    return fetchOptions;
+}
+/**
+ * Agent ls command semantics:
+ * - `byspace agent ls`    → active non-archived agents
+ * - `byspace agent ls -g` → global non-archived agents
+ * - `byspace agent ls -a` → active agents, including archived
+ * - `byspace agent ls -ag` → global agents, including archived
+ */
+export async function runLsCommand(options, _command) {
+    const host = getDaemonHost({ host: options.host });
+    let client;
+    try {
+        client = await connectToDaemon({ host: options.host });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: "DAEMON_NOT_RUNNING",
+            message: `Cannot connect to daemon at ${host}: ${message}`,
+            details: "Start the daemon with: byspace daemon start\nFor a remote daemon, pass --host <host:port> or set BYSPACE_HOST.",
+        };
+        throw error;
+    }
+    try {
+        const normalizedThinkingOptionId = options.thinking?.trim();
+        if (options.thinking !== undefined && !normalizedThinkingOptionId) {
+            const error = {
+                code: "INVALID_THINKING_OPTION",
+                message: "--thinking cannot be empty",
+            };
+            throw error;
+        }
+        const labelFilters = parseLabelFilters(options.label);
+        const fetchPayload = await client.fetchAgents(buildAgentLsFetchOptions(options));
+        let agents = fetchPayload.entries.map((entry) => entry.agent);
+        // By default, exclude archived agents. `-a` includes them.
+        if (!options.all) {
+            agents = agents.filter((a) => !a.archivedAt);
+        }
+        // If explicit status filter is provided, apply it.
+        if (options.status) {
+            agents = agents.filter((a) => a.status === options.status);
+        }
+        // Optional cwd filter.
+        if (options.cwd) {
+            agents = agents.filter((a) => isSameOrDescendantPath(options.cwd, a.cwd));
+        }
+        // Apply label filtering only when explicitly requested.
+        if (Object.keys(labelFilters).length > 0) {
+            agents = agents.filter((a) => {
+                const agentLabels = a.labels;
+                for (const [key, value] of Object.entries(labelFilters)) {
+                    if (agentLabels[key] !== value) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+        }
+        await client.close();
+        // Sort agents: running first, then idle, then others; within each group, most recent first
+        const statusOrder = { running: 0, idle: 1 };
+        agents.sort((a, b) => {
+            // Primary sort: by status
+            const aOrder = statusOrder[a.status] ?? 999;
+            const bOrder = statusOrder[b.status] ?? 999;
+            if (aOrder !== bOrder)
+                return aOrder - bOrder;
+            // Secondary sort: by creation time (most recent first)
+            const aTime = new Date(a.createdAt).getTime();
+            const bTime = new Date(b.createdAt).getTime();
+            return bTime - aTime;
+        });
+        const items = agents.map(toListItem);
+        return {
+            type: "list",
+            data: items,
+            schema: agentLsSchema,
+        };
+    }
+    catch (err) {
+        await client.close().catch(() => { });
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: "LIST_AGENTS_FAILED",
+            message: `Failed to list agents: ${message}`,
+        };
+        throw error;
+    }
+}
+//# sourceMappingURL=ls.js.map

package/dist/commands/agent/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/commands/agent/ls.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAM9D,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG;SACP,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,WAAW,EAAE,yBAAyB,CAAC;SAC9C,MAAM,CAAC,cAAc,EAAE,oCAAoC,CAAC;SAC5D,MAAM,CACL,qBAAqB,EACrB,8CAA8C,EAC9C,eAAe,EACf,EAAE,CACH;SACA,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC,CAAC;AAC/D,CAAC;AAcD,yCAAyC;AACzC,SAAS,YAAY,CAAC,IAAmB;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAEhD,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,UAAU,CAAC;IACpC,IAAI,OAAO,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC;IACrE,IAAI,OAAO,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;IACtE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC;AACnD,CAAC;AAED,qCAAqC;AACrC,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAkC;IAC1D,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;QACnD,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5C,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QACpD,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QACpD;YACE,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;gBACf,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,OAAO,CAAC;gBACxC,IAAI,KAAK,KAAK,MAAM;oBAAE,OAAO,QAAQ,CAAC;gBACtC,IAAI,KAAK,KAAK,OAAO;oBAAE,OAAO,KAAK,CAAC;gBACpC,OAAO,SAAS,CAAC;YACnB,CAAC;SACF;QACD,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QAC1C,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;KACnD;CACF,CAAC;AAEF,gDAAgD;AAChD,SAAS,UAAU,CAAC,KAA2B;IAC7C,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1F,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG;QACxB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ;QAC/D,QAAQ,EAAE,KAAK,CAAC,yBAAyB,IAAI,MAAM;QACnD,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC;QAC3B,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC;KACvC,CAAC;AACJ,CAAC;AAmBD,SAAS,iBAAiB,CAAC,MAA4B;IACrD,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,QAAQ,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC1C,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAsE;IAEtE,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,0BAA0B,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5D,MAAM,YAAY,GAA8C,EAAE,CAAC;IAEnE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,YAAY,CAAC,eAAe,GAAG,IAAI,CAAC;IACtC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC;IACrC,CAAC;IACD,IAAI,0BAA0B,EAAE,CAAC;QAC/B,YAAY,CAAC,gBAAgB,GAAG,0BAA0B,CAAC;IAC7D,CAAC;IAED,MAAM,YAAY,GAAuB,EAAE,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,KAAK,GAAG,QAAQ,CAAC;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC;IACrC,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,QAAiB;IAEjB,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,KAAK,GAAiB;YAC1B,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,+BAA+B,IAAI,KAAK,OAAO,EAAE;YAC1D,OAAO,EACL,gHAAgH;SACnH,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,0BAA0B,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5D,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,0BAA0B,EAAE,CAAC;YAClE,MAAM,KAAK,GAAiB;gBAC1B,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,4BAA4B;aACtC,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,IAAI,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE9D,2DAA2D;QAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,mDAAmD;QACnD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,wDAAwD;QACxD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;gBAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;oBACxD,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;wBAC/B,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,2FAA2F;QAC3F,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAA4B,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACnB,0BAA0B;YAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;YAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;YAC5C,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,MAAM,GAAG,MAAM,CAAC;YAE9C,uDAAuD;YACvD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YAC9C,OAAO,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAErC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,aAAa;SACtB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,KAAK,GAAiB;YAC1B,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,0BAA0B,OAAO,EAAE;SAC7C,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/commands/agent/mode.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+import type { CommandOptions, OutputSchema, AnyCommandResult } from "../../output/index.js";
+import type { AgentMode } from "@bytetrue/byspace-protocol/agent-types";
+/** Result for setting mode */
+export interface SetModeResult {
+    agentId: string;
+    mode: string;
+}
+/** Schema for mode list output */
+export declare const modeListSchema: OutputSchema<AgentMode>;
+/** Schema for set mode output */
+export declare const setModeSchema: OutputSchema<SetModeResult>;
+export interface AgentModeOptions extends CommandOptions {
+    list?: boolean;
+}
+export type AgentModeResult = AnyCommandResult<any>;
+export declare function runModeCommand(id: string, mode: string | undefined, options: AgentModeOptions, _command: Command): Promise<AgentModeResult>;
+//# sourceMappingURL=mode.d.ts.map

package/dist/commands/agent/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAEZ,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAExE,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kCAAkC;AAClC,eAAO,MAAM,cAAc,EAAE,YAAY,CAAC,SAAS,CAOlD,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,aAAa,CAMrD,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAWD,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAEpD,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,eAAe,CAAC,CAmF1B"}

package/dist/commands/agent/mode.js

@@ -0,0 +1,100 @@
+import { connectToDaemon, getDaemonHost } from "../../utils/client.js";
+/** Schema for mode list output */
+export const modeListSchema = {
+    idField: "id",
+    columns: [
+        { header: "MODE", field: "id", width: 15 },
+        { header: "LABEL", field: "label", width: 25 },
+        { header: "DESCRIPTION", field: "description", width: 40 },
+    ],
+};
+/** Schema for set mode output */
+export const setModeSchema = {
+    idField: "agentId",
+    columns: [
+        { header: "AGENT ID", field: "agentId", width: 12 },
+        { header: "MODE", field: "mode", width: 20 },
+    ],
+};
+const missingModeError = () => ({
+    code: "MISSING_ARGUMENT",
+    message: "Mode argument required unless --list is specified",
+    details: "Usage: byspace agent mode <id> <mode> | byspace agent mode --list <id>",
+});
+export async function runModeCommand(id, mode, options, _command) {
+    const normalizedMode = mode?.trim();
+    const host = getDaemonHost({ host: options.host });
+    // Validate arguments
+    if (!options.list && !normalizedMode) {
+        throw missingModeError();
+    }
+    let client;
+    try {
+        client = await connectToDaemon({ host: options.host });
+        const fetchResult = await client.fetchAgent({ agentId: id });
+        if (!fetchResult) {
+            const error = {
+                code: "AGENT_NOT_FOUND",
+                message: `No agent found matching: ${id}`,
+                details: "Use `byspace ls` to list available agents",
+            };
+            throw error;
+        }
+        const agent = fetchResult.agent;
+        const resolvedId = agent.id;
+        if (options.list) {
+            // List available modes for this agent
+            const availableModes = agent.availableModes ?? [];
+            const items = availableModes.map((m) => ({
+                id: m.id,
+                label: m.label,
+                description: m.description,
+            }));
+            return {
+                type: "list",
+                data: items,
+                schema: modeListSchema,
+            };
+        }
+        if (!normalizedMode) {
+            throw missingModeError();
+        }
+        // Set the agent mode
+        await client.setAgentMode(resolvedId, normalizedMode);
+        return {
+            type: "single",
+            data: {
+                agentId: resolvedId.slice(0, 7),
+                mode: normalizedMode,
+            },
+            schema: setModeSchema,
+        };
+    }
+    catch (err) {
+        // Re-throw if it's already a CommandError
+        if (err && typeof err === "object" && "code" in err) {
+            throw err;
+        }
+        if (!client) {
+            const message = err instanceof Error ? err.message : String(err);
+            const error = {
+                code: "DAEMON_NOT_RUNNING",
+                message: `Cannot connect to daemon at ${host}: ${message}`,
+                details: "Start the daemon with: byspace daemon start",
+            };
+            throw error;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: "MODE_OPERATION_FAILED",
+            message: `Failed to ${options.list ? "list modes" : "set mode"}: ${message}`,
+        };
+        throw error;
+    }
+    finally {
+        if (client) {
+            await client.close().catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=mode.js.map

package/dist/commands/agent/mode.js.map

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

package/dist/commands/agent/reload.d.ts

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import type { CommandOptions, SingleResult, OutputSchema } from "../../output/index.js";
+export interface AgentReloadResult {
+    agentId: string;
+    status: "reloaded";
+    timelineSize: number;
+}
+export declare const reloadSchema: OutputSchema<AgentReloadResult>;
+export declare function addReloadOptions(cmd: Command): Command;
+export interface AgentReloadOptions extends CommandOptions {
+    host?: string;
+}
+export type AgentReloadCommandResult = SingleResult<AgentReloadResult>;
+export declare function runReloadCommand(agentIdArg: string, options: AgentReloadOptions, _command: Command): Promise<AgentReloadCommandResult>;
+//# sourceMappingURL=reload.d.ts.map

package/dist/commands/agent/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,iBAAiB,CAOxD,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAEvE,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,wBAAwB,CAAC,CAiEnC"}