@junctionpanel/cli 0.1.16

package/dist/output/with-output.js

@@ -0,0 +1,87 @@
+/**
+ * Command wrapper for automatic output rendering.
+ *
+ * Wraps command handlers to automatically render results and handle errors.
+ */
+import { render, renderError, toCommandError, defaultOutputOptions } from './render.js';
+function normalizeFormat(raw) {
+    const value = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
+    // Common user expectation: "cli" means "table/human"
+    if (value === 'cli')
+        return 'table';
+    if (value === 'table' || value === 'json' || value === 'yaml')
+        return value;
+    const error = {
+        code: 'INVALID_FORMAT',
+        message: `Unsupported output format: ${String(raw)}`,
+        details: 'Supported formats: table, json, yaml',
+    };
+    throw error;
+}
+/** Extract output options from command options */
+function extractOutputOptions(options) {
+    const hasStructuredOutputSchema = typeof options.outputSchema === 'string' && options.outputSchema.trim().length > 0;
+    if (hasStructuredOutputSchema) {
+        return {
+            format: 'json',
+            quiet: false,
+            noHeaders: options.headers === false,
+            noColor: options.color === false,
+        };
+    }
+    return {
+        format: options.json ? 'json' : normalizeFormat(options.format ?? defaultOutputOptions.format),
+        quiet: options.quiet ?? defaultOutputOptions.quiet,
+        noHeaders: options.headers === false, // Commander uses --no-headers -> headers: false
+        noColor: options.color === false, // Commander uses --no-color -> color: false
+    };
+}
+/**
+ * Wrap a command handler to automatically render output.
+ *
+ * The wrapped handler should return a CommandResult. The wrapper will:
+ * 1. Call the handler
+ * 2. Render the result using the appropriate format
+ * 3. Write to stdout
+ * 4. Handle errors by rendering to stderr and exiting with code 1
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('list')
+ *   .action(withOutput(async (options) => {
+ *     const data = await fetchData()
+ *     return { type: 'list', data, schema }
+ *   }))
+ * ```
+ */
+export function withOutput(handler) {
+    return async (...args) => {
+        // Last two args are options and command
+        const command = args[args.length - 1];
+        // Use optsWithGlobals() to get both local and global options
+        const options = command.optsWithGlobals();
+        const outputOptions = extractOutputOptions(options);
+        try {
+            const result = await handler(...args);
+            const output = render(result, outputOptions);
+            if (output) {
+                process.stdout.write(output + '\n');
+            }
+        }
+        catch (error) {
+            const commandError = toCommandError(error);
+            const errorOutput = renderError(commandError, outputOptions);
+            process.stderr.write(errorOutput + '\n');
+            process.exit(1);
+        }
+    };
+}
+/**
+ * Helper to create output options from partial input.
+ * Useful for testing or manual rendering.
+ */
+export function createOutputOptions(partial = {}) {
+    return { ...defaultOutputOptions, ...partial };
+}
+//# sourceMappingURL=with-output.js.map

package/dist/output/with-output.js.map

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

package/dist/output/yaml.d.ts

@@ -0,0 +1,11 @@
+/**
+ * YAML renderer for CLI output.
+ *
+ * Renders structured data as YAML for machine consumption and human readability.
+ */
+import type { AnyCommandResult, OutputOptions } from './types.js';
+/** Render command result as YAML */
+export declare function renderYaml<T>(result: AnyCommandResult<T>, _options: OutputOptions): string;
+/** Render a single item as YAML document (for streaming) */
+export declare function renderYamlDoc<T>(item: T, serialize?: (data: T) => unknown): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/output/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEjE,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,aAAa,GACtB,MAAM,CAyBR;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAGlF"}

package/dist/output/yaml.js

@@ -0,0 +1,38 @@
+/**
+ * YAML renderer for CLI output.
+ *
+ * Renders structured data as YAML for machine consumption and human readability.
+ */
+import YAML from 'yaml';
+/** Render command result as YAML */
+export function renderYaml(result, _options) {
+    const { schema } = result;
+    // Apply custom serializer if provided
+    if (schema.serialize) {
+        if (result.type === 'list') {
+            // If all items serialize to the same object, return just one
+            // This handles the case where a list of key-value rows should serialize
+            // to a single structured object
+            const serialized = result.data.map((item) => schema.serialize(item));
+            if (serialized.length > 0) {
+                const first = JSON.stringify(serialized[0]);
+                const allSame = serialized.every((s) => JSON.stringify(s) === first);
+                if (allSame) {
+                    return YAML.stringify(serialized[0]);
+                }
+            }
+            return YAML.stringify(serialized);
+        }
+        else {
+            const serialized = schema.serialize(result.data);
+            return YAML.stringify(serialized);
+        }
+    }
+    return YAML.stringify(result.data);
+}
+/** Render a single item as YAML document (for streaming) */
+export function renderYamlDoc(item, serialize) {
+    const output = serialize ? serialize(item) : item;
+    return YAML.stringify(output);
+}
+//# sourceMappingURL=yaml.js.map

package/dist/output/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,oCAAoC;AACpC,MAAM,UAAU,UAAU,CACxB,MAA2B,EAC3B,QAAuB;IAEvB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAEzB,sCAAsC;IACtC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,6DAA6D;YAC7D,wEAAwE;YACxE,gCAAgC;YAChC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAU,CAAC,IAAI,CAAC,CAAC,CAAA;YACrE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;gBACpE,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;gBACtC,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAChD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAI,IAAO,EAAE,SAAgC;IACxE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}

package/dist/utils/client-id.d.ts

@@ -0,0 +1,2 @@
+export declare function getOrCreateCliClientId(): Promise<string>;
+//# sourceMappingURL=client-id.d.ts.map

package/dist/utils/client-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-id.d.ts","sourceRoot":"","sources":["../../src/utils/client-id.ts"],"names":[],"mappings":"AAqBA,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAyB9D"}

package/dist/utils/client-id.js

@@ -0,0 +1,37 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+const CLIENT_SESSION_KEY_FILE = join(process.env.JUNCTION_HOME ?? join(homedir(), ".junction"), "cli-client-id");
+let cachedClientId = null;
+function normalizeClientId(value) {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function generateClientId() {
+    return `cid_${randomUUID().replace(/-/g, "")}`;
+}
+export async function getOrCreateCliClientId() {
+    if (cachedClientId) {
+        return cachedClientId;
+    }
+    try {
+        const existing = normalizeClientId(await readFile(CLIENT_SESSION_KEY_FILE, "utf8"));
+        if (existing) {
+            cachedClientId = existing;
+            return existing;
+        }
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code !== "ENOENT") {
+            throw error;
+        }
+    }
+    const nextValue = generateClientId();
+    await mkdir(dirname(CLIENT_SESSION_KEY_FILE), { recursive: true });
+    await writeFile(CLIENT_SESSION_KEY_FILE, nextValue, { mode: 0o600 });
+    cachedClientId = nextValue;
+    return nextValue;
+}
+//# sourceMappingURL=client-id.js.map

package/dist/utils/client-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-id.js","sourceRoot":"","sources":["../../src/utils/client-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,uBAAuB,GAAG,IAAI,CAClC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,EACzD,eAAe,CAChB,CAAC;AAEF,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,iBAAiB,CAChC,MAAM,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAChD,CAAC;QACF,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,GAAG,QAAQ,CAAC;YAC1B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAAkC,EAAE,IAAI,CAAC;QACvD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,MAAM,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,SAAS,CAAC,uBAAuB,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,cAAc,GAAG,SAAS,CAAC;IAC3B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/client.d.ts

@@ -0,0 +1,35 @@
+import { DaemonClient } from '@junctionpanel/server';
+export interface ConnectOptions {
+    host?: string;
+    timeout?: number;
+}
+/**
+ * Get the daemon host from environment or options
+ */
+export declare function getDaemonHost(options?: ConnectOptions): string;
+/**
+ * Create and connect a daemon client
+ * Returns the connected client or throws if connection fails
+ */
+export declare function connectToDaemon(options?: ConnectOptions): Promise<DaemonClient>;
+/**
+ * Try to connect to the daemon, returns null if connection fails
+ */
+export declare function tryConnectToDaemon(options?: ConnectOptions): Promise<DaemonClient | null>;
+/** Minimal agent type for ID resolution */
+interface AgentLike {
+    id: string;
+    title?: string | null;
+}
+/**
+ * Resolve an agent ID from a partial ID or name.
+ * Supports:
+ * - Full ID match
+ * - Prefix match (first N characters)
+ * - Title/name match (case-insensitive)
+ *
+ * Returns the full agent ID if found, null otherwise.
+ */
+export declare function resolveAgentId(idOrName: string, agents: AgentLike[]): string | null;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/utils/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAIpD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAKD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAE9D;AAkBD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAwCrF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM/F;AAED,2CAA2C;AAC3C,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAsCnF"}

package/dist/utils/client.js

@@ -0,0 +1,113 @@
+import { DaemonClient } from '@junctionpanel/server';
+import WebSocket from 'ws';
+import { getOrCreateCliClientId } from './client-id.js';
+const DEFAULT_HOST = 'localhost:6767';
+const DEFAULT_TIMEOUT = 5000;
+/**
+ * Get the daemon host from environment or options
+ */
+export function getDaemonHost(options) {
+    return options?.host ?? process.env.JUNCTION_HOST ?? DEFAULT_HOST;
+}
+/**
+ * Create a WebSocket factory that works in Node.js
+ */
+function createNodeWebSocketFactory() {
+    return (url, options) => {
+        return new WebSocket(url, { headers: options?.headers });
+    };
+}
+/**
+ * Create and connect a daemon client
+ * Returns the connected client or throws if connection fails
+ */
+export async function connectToDaemon(options) {
+    const host = getDaemonHost(options);
+    const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    const clientId = await getOrCreateCliClientId();
+    const url = `ws://${host}/ws`;
+    const client = new DaemonClient({
+        url,
+        clientId,
+        clientType: 'cli',
+        webSocketFactory: createNodeWebSocketFactory(),
+        reconnect: { enabled: false },
+    });
+    // Connect with timeout
+    const connectPromise = client.connect();
+    let timeoutHandle = null;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutHandle = setTimeout(() => {
+            reject(new Error(`Connection timeout after ${timeout}ms`));
+        }, timeout);
+    });
+    try {
+        await Promise.race([connectPromise, timeoutPromise]);
+        // Clear the timeout so it doesn't keep the event loop alive
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
+        return client;
+    }
+    catch (err) {
+        // Clear the timeout on error too
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
+        await client.close().catch(() => { });
+        throw err;
+    }
+}
+/**
+ * Try to connect to the daemon, returns null if connection fails
+ */
+export async function tryConnectToDaemon(options) {
+    try {
+        return await connectToDaemon(options);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve an agent ID from a partial ID or name.
+ * Supports:
+ * - Full ID match
+ * - Prefix match (first N characters)
+ * - Title/name match (case-insensitive)
+ *
+ * Returns the full agent ID if found, null otherwise.
+ */
+export function resolveAgentId(idOrName, agents) {
+    if (!idOrName || agents.length === 0) {
+        return null;
+    }
+    const query = idOrName.toLowerCase();
+    // Try exact ID match first
+    const exactMatch = agents.find((a) => a.id === idOrName);
+    if (exactMatch) {
+        return exactMatch.id;
+    }
+    // Try ID prefix match
+    const prefixMatches = agents.filter((a) => a.id.toLowerCase().startsWith(query));
+    if (prefixMatches.length === 1 && prefixMatches[0]) {
+        return prefixMatches[0].id;
+    }
+    // Try title/name match (case-insensitive)
+    const titleMatches = agents.filter((a) => a.title?.toLowerCase() === query);
+    if (titleMatches.length === 1 && titleMatches[0]) {
+        return titleMatches[0].id;
+    }
+    // Try partial title match
+    const partialTitleMatches = agents.filter((a) => a.title?.toLowerCase().includes(query));
+    if (partialTitleMatches.length === 1 && partialTitleMatches[0]) {
+        return partialTitleMatches[0].id;
+    }
+    // If we have multiple prefix matches and no unique title match, return first prefix match
+    const firstPrefixMatch = prefixMatches[0];
+    if (firstPrefixMatch) {
+        return firstPrefixMatch.id;
+    }
+    return null;
+}
+//# sourceMappingURL=client.js.map

package/dist/utils/client.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Convert unknown thrown values into a user-safe error string.
+ */
+export declare function getErrorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD"}

package/dist/utils/errors.js

@@ -0,0 +1,10 @@
+/**
+ * Convert unknown thrown values into a user-safe error string.
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAA;IACtB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}

package/dist/utils/timeline.d.ts

@@ -0,0 +1,8 @@
+import type { AgentTimelineItem, DaemonClient } from '@junctionpanel/server';
+type FetchProjectedTimelineItemsInput = {
+    client: DaemonClient;
+    agentId: string;
+};
+export declare function fetchProjectedTimelineItems(input: FetchProjectedTimelineItemsInput): Promise<AgentTimelineItem[]>;
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/utils/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/utils/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAE5E,KAAK,gCAAgC,GAAG;IACtC,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO9B"}

package/dist/utils/timeline.js

@@ -0,0 +1,9 @@
+export async function fetchProjectedTimelineItems(input) {
+    const timeline = await input.client.fetchAgentTimeline(input.agentId, {
+        direction: 'tail',
+        limit: 0,
+        projection: 'projected',
+    });
+    return timeline.entries.map((entry) => entry.item);
+}
+//# sourceMappingURL=timeline.js.map

package/dist/utils/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../src/utils/timeline.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAAuC;IAEvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE;QACpE,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,WAAW;KACxB,CAAC,CAAA;IACF,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACpD,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@junctionpanel/cli",
+  "version": "0.1.16",
+  "description": "Junction CLI - control your AI coding agents from the command line",
+  "type": "module",
+  "types": "./dist/cli.d.ts",
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/cli.d.ts",
+      "default": [
+        "./dist/cli.js",
+        "./src/cli.ts"
+      ]
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "default": [
+        "./dist/cli.js",
+        "./src/cli.ts"
+      ]
+    },
+    "./daemon-only-cli": {
+      "types": "./dist/daemon-only-cli.d.ts",
+      "default": [
+        "./dist/daemon-only-cli.js",
+        "./src/daemon-only-cli.ts"
+      ]
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "junction": "bin/junction",
+    "junction-daemon": "bin/junction-daemon"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "mime-types": "^2.1.35",
+    "ws": "^8.14.2",
+    "yaml": "^2.8.2",
+    "@junctionpanel/relay": "0.1.16",
+    "@junctionpanel/server": "0.1.16"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1",
+    "@types/ws": "^8.5.8",
+    "tsx": "^4.6.0",
+    "typescript": "^5.2.2",
+    "zx": "^8.8.5"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true })\" && tsc -p tsconfig.json --incremental false",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run test:local",
+    "test:local": "tsx tests/run-all.ts",
+    "test:e2e": "pnpm run test:local",
+    "test:e2e:lifecycle": "pnpm exec tsx tests/e2e/agent-lifecycle.test.ts"
+  }
+}