@hyperdrive.bot/paseo-cli 0.2.6

package/dist/utils/duration.js

@@ -0,0 +1,38 @@
+/**
+ * Parse duration string to milliseconds.
+ * Supports formats like: 5m, 30s, 1h, 2h30m, 90, etc.
+ * If no unit is specified, assumes seconds.
+ */
+export function parseDuration(input) {
+    const trimmed = input.trim();
+    // If it's just a number, treat as seconds
+    if (/^\d+$/.test(trimmed)) {
+        return parseInt(trimmed, 10) * 1000;
+    }
+    // Parse duration with units
+    let totalMs = 0;
+    const regex = /(\d+)([smh])/g;
+    let match;
+    let hasMatch = false;
+    while ((match = regex.exec(trimmed)) !== null) {
+        hasMatch = true;
+        const value = parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case "s":
+                totalMs += value * 1000;
+                break;
+            case "m":
+                totalMs += value * 60 * 1000;
+                break;
+            case "h":
+                totalMs += value * 60 * 60 * 1000;
+                break;
+        }
+    }
+    if (!hasMatch) {
+        throw new Error(`Invalid duration format: ${input}. Use formats like: 5m, 30s, 1h, 2h30m`);
+    }
+    return totalMs;
+}
+//# sourceMappingURL=duration.js.map

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.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/hook-socket.d.ts

@@ -0,0 +1,2 @@
+export declare function sendHookEvent(socketPath: string, payload: unknown, timeoutMs: number): Promise<unknown>;
+//# sourceMappingURL=hook-socket.d.ts.map

package/dist/utils/hook-socket.js

@@ -0,0 +1,35 @@
+import * as net from "node:net";
+export function sendHookEvent(socketPath, payload, timeoutMs) {
+    return new Promise((resolve) => {
+        const socket = net.createConnection(socketPath);
+        let raw = "";
+        let settled = false;
+        const settle = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolve(value);
+        };
+        socket.setTimeout(timeoutMs);
+        socket.on("timeout", () => settle(undefined));
+        socket.on("error", () => settle(undefined));
+        socket.on("connect", () => {
+            socket.write(JSON.stringify(payload) + "\n");
+        });
+        socket.on("data", (chunk) => {
+            raw += chunk.toString();
+            const line = raw.split("\n")[0];
+            if (line) {
+                try {
+                    settle(JSON.parse(line));
+                }
+                catch {
+                    settle(undefined);
+                }
+            }
+        });
+        socket.on("end", () => settle(undefined));
+    });
+}
+//# sourceMappingURL=hook-socket.js.map

package/dist/utils/paths.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Path utilities for cwd filtering in agent commands.
+ */
+/**
+ * Check if `candidatePath` is the same directory as `basePath` or a descendant of it.
+ *
+ * Handles both Unix (/) and Windows (\) path separators, including mixed separators.
+ * This is important because agent cwd paths come from the agent's OS (could be Windows)
+ * while the CLI filter path comes from the user (could also be Windows or Unix).
+ */
+export declare function isSameOrDescendantPath(basePath: string, candidatePath: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.js

@@ -0,0 +1,22 @@
+/**
+ * Path utilities for cwd filtering in agent commands.
+ */
+/**
+ * Check if `candidatePath` is the same directory as `basePath` or a descendant of it.
+ *
+ * Handles both Unix (/) and Windows (\) path separators, including mixed separators.
+ * This is important because agent cwd paths come from the agent's OS (could be Windows)
+ * while the CLI filter path comes from the user (could also be Windows or Unix).
+ */
+export function isSameOrDescendantPath(basePath, candidatePath) {
+    // Normalize both paths: replace all backslashes with forward slashes, strip trailing separator
+    let normalizedBase = basePath.replace(/\\/g, "/").replace(/\/$/, "");
+    let normalizedCandidate = candidatePath.replace(/\\/g, "/").replace(/\/$/, "");
+    // Windows paths are case-insensitive — detect by drive letter prefix (e.g. "C:/")
+    if (/^[a-zA-Z]:\//.test(normalizedBase) || /^[a-zA-Z]:\//.test(normalizedCandidate)) {
+        normalizedBase = normalizedBase.toLowerCase();
+        normalizedCandidate = normalizedCandidate.toLowerCase();
+    }
+    return (normalizedCandidate === normalizedBase || normalizedCandidate.startsWith(normalizedBase + "/"));
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/provider-model.d.ts

@@ -0,0 +1,11 @@
+export interface ResolveProviderAndModelOptions {
+    provider?: string;
+    model?: string;
+    defaultProvider?: string;
+}
+export interface ResolvedProviderModel {
+    provider: string;
+    model: string | undefined;
+}
+export declare function resolveProviderAndModel(options: ResolveProviderAndModelOptions): ResolvedProviderModel;
+//# sourceMappingURL=provider-model.d.ts.map

package/dist/utils/provider-model.js

@@ -0,0 +1,49 @@
+export function resolveProviderAndModel(options) {
+    const providerInput = options.provider?.trim() || options.defaultProvider;
+    const modelInput = options.model?.trim();
+    if (!providerInput) {
+        const error = {
+            code: "MISSING_PROVIDER",
+            message: "Provider is required",
+            details: "Pass --provider <provider> or --provider <provider>/<model>. Use `paseo provider ls` to see providers and `paseo provider models <provider>` to see models.",
+        };
+        throw error;
+    }
+    if (options.model !== undefined && !modelInput) {
+        const error = {
+            code: "INVALID_MODEL",
+            message: "--model cannot be empty",
+        };
+        throw error;
+    }
+    const slashIndex = providerInput.indexOf("/");
+    if (slashIndex === -1) {
+        return {
+            provider: providerInput,
+            model: modelInput,
+        };
+    }
+    const provider = providerInput.slice(0, slashIndex).trim();
+    const modelFromProvider = providerInput.slice(slashIndex + 1).trim();
+    if (!provider || !modelFromProvider) {
+        const error = {
+            code: "INVALID_PROVIDER",
+            message: "Invalid --provider value",
+            details: "Use --provider <provider> or --provider <provider>/<model>",
+        };
+        throw error;
+    }
+    if (modelInput && modelInput !== modelFromProvider) {
+        const error = {
+            code: "CONFLICTING_MODEL_OPTIONS",
+            message: "Conflicting model values provided",
+            details: `--provider specifies model ${modelFromProvider}, but --model specifies ${modelInput}`,
+        };
+        throw error;
+    }
+    return {
+        provider,
+        model: modelInput ?? modelFromProvider,
+    };
+}
+//# sourceMappingURL=provider-model.js.map

package/dist/utils/timeline.d.ts

@@ -0,0 +1,11 @@
+import type { DaemonClient } from "@hyperdrive.bot/paseo-client/internal/daemon-client";
+import type { AgentTimelineItem } from "@hyperdrive.bot/paseo-protocol/agent-types";
+export declare const LIVE_HISTORY_FETCH_TIMEOUT_MS = 2000;
+interface FetchProjectedTimelineItemsInput {
+    client: DaemonClient;
+    agentId: string;
+    timeoutMs?: number;
+}
+export declare function fetchProjectedTimelineItems(input: FetchProjectedTimelineItemsInput): Promise<AgentTimelineItem[]>;
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/utils/timeline.js

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveCliVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -0,0 +1,10 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export function resolveCliVersion() {
+    const packageJson = require("../package.json");
+    if (typeof packageJson.version === "string" && packageJson.version.trim().length > 0) {
+        return packageJson.version.trim();
+    }
+    throw new Error("Unable to resolve @hyperdrive.bot/paseo-cli version from package.json.");
+}
+//# sourceMappingURL=version.js.map

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@hyperdrive.bot/paseo-cli",
+  "version": "0.2.6",
+  "description": "Paseo CLI - control your AI coding agents from the command line",
+  "bin": {
+    "paseo": "bin/paseo"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node ../../scripts/clean-package-dist.mjs",
+    "build": "tsc -p tsconfig.json --incremental false",
+    "build:clean": "npm run clean && npm run build",
+    "prepack": "npm run build:clean",
+    "typecheck": "tsgo --noEmit",
+    "test": "npm run test:local",
+    "test:local": "tsx tests/run-all.ts",
+    "test:e2e": "npm run test:local",
+    "test:e2e:lifecycle": "npx tsx tests/e2e/agent-lifecycle.test.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@hyperdrive.bot/paseo-client": "0.2.5",
+    "@hyperdrive.bot/paseo-protocol": "0.2.5",
+    "@hyperdrive.bot/paseo-server": "0.2.6",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "mime-types": "^2.1.35",
+    "tree-kill": "^1.2.2",
+    "ws": "^8.14.2",
+    "yaml": "^2.8.4"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1",
+    "@types/ws": "^8.5.8",
+    "tsx": "^4.6.0",
+    "typescript": "^5.2.2",
+    "vitest": "^4.1.6",
+    "zx": "^8.8.5"
+  }
+}