pulseed 0.4.17 → 0.4.19

package/dist/interface/cli/commands/suggest.js.map

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

package/dist/interface/cli/commands/task-read.d.ts

@@ -0,0 +1,4 @@
+import { StateManager } from "../../../base/state/state-manager.js";
+export declare function cmdTaskList(stateManager: StateManager, args: string[]): Promise<number>;
+export declare function cmdTaskShow(stateManager: StateManager, args: string[]): Promise<number>;
+//# sourceMappingURL=task-read.d.ts.map

package/dist/interface/cli/commands/task-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-read.d.ts","sourceRoot":"","sources":["../../../../src/interface/cli/commands/task-read.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AA2DpE,wBAAsB,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD7F;AAID,wBAAsB,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwG7F"}

package/dist/interface/cli/commands/task-read.js

@@ -0,0 +1,195 @@
+// ─── pulseed task read commands (read-only) ───
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { parseArgs } from "node:util";
+import { TaskSchema } from "../../../base/types/task.js";
+import { getCliLogger } from "../cli-logger.js";
+import { formatOperationError } from "../utils.js";
+// ─── helpers ───
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + "...";
+}
+function shortId(id) {
+    return id.length > 8 ? id.slice(0, 8) : id;
+}
+function elapsedLabel(task) {
+    if (!task.started_at)
+        return "-";
+    const start = new Date(task.started_at).getTime();
+    const end = task.completed_at ? new Date(task.completed_at).getTime() : Date.now();
+    const ms = end - start;
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m${seconds % 60}s`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h${minutes % 60}m`;
+}
+async function readAllTasksForGoal(stateManager, goalId) {
+    const baseDir = stateManager.getBaseDir();
+    const tasksDir = path.join(baseDir, "tasks", goalId);
+    let entries = [];
+    try {
+        entries = await fsp.readdir(tasksDir);
+    }
+    catch {
+        return [];
+    }
+    const tasks = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".json") || entry === "task-history.json" || entry === "last-failure-context.json")
+            continue;
+        const raw = await stateManager.readRaw(`tasks/${goalId}/${entry}`);
+        if (!raw)
+            continue;
+        const parsed = TaskSchema.safeParse(raw);
+        if (parsed.success) {
+            tasks.push(parsed.data);
+        }
+        else {
+            getCliLogger().error(formatOperationError(`parse task file "${entry}"`, parsed.error));
+        }
+    }
+    return tasks;
+}
+// ─── cmdTaskList ───
+export async function cmdTaskList(stateManager, args) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args,
+            options: {
+                goal: { type: "string" },
+            },
+            strict: false,
+        }));
+    }
+    catch (err) {
+        getCliLogger().error(formatOperationError("parse task list arguments", err));
+        values = {};
+    }
+    const goalId = values.goal;
+    if (!goalId) {
+        getCliLogger().error("Error: --goal <goalId> is required for `pulseed task list`.");
+        return 1;
+    }
+    const tasks = await readAllTasksForGoal(stateManager, goalId);
+    if (tasks.length === 0) {
+        console.log(`No tasks found for goal "${goalId}".`);
+        return 0;
+    }
+    // Sort by created_at descending (most recent first)
+    const sorted = [...tasks].sort((a, b) => (a.created_at < b.created_at ? 1 : -1));
+    console.log(`Tasks for goal: ${goalId}\n`);
+    console.log(`${"ID".padEnd(10)} ${"STATUS".padEnd(12)} ${"VERDICT".padEnd(10)} ${"ELAPSED".padEnd(8)} DESCRIPTION`);
+    console.log("-".repeat(90));
+    for (const task of sorted) {
+        const id = shortId(task.id);
+        const status = (task.status ?? "pending").padEnd(12);
+        const verdict = (task.verification_verdict ?? "-").padEnd(10);
+        const elapsed = elapsedLabel(task).padEnd(8);
+        const desc = truncate(task.work_description, 60);
+        console.log(`${id.padEnd(10)} ${status} ${verdict} ${elapsed} ${desc}`);
+    }
+    console.log(`\nTotal: ${tasks.length} task(s)`);
+    return 0;
+}
+// ─── cmdTaskShow ───
+export async function cmdTaskShow(stateManager, args) {
+    let positionals = [];
+    let values;
+    try {
+        const parsed = parseArgs({
+            args,
+            options: {
+                goal: { type: "string" },
+            },
+            allowPositionals: true,
+            strict: false,
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (err) {
+        getCliLogger().error(formatOperationError("parse task show arguments", err));
+        values = {};
+    }
+    const taskId = positionals[0];
+    const goalId = values.goal;
+    if (!taskId) {
+        getCliLogger().error("Error: <taskId> is required. Usage: pulseed task show <taskId> --goal <goalId>");
+        return 1;
+    }
+    if (!goalId) {
+        getCliLogger().error("Error: --goal <goalId> is required for `pulseed task show`.");
+        return 1;
+    }
+    const raw = await stateManager.readRaw(`tasks/${goalId}/${taskId}.json`);
+    if (!raw) {
+        getCliLogger().error(`Error: Task "${taskId}" not found for goal "${goalId}".`);
+        return 1;
+    }
+    const parsed = TaskSchema.safeParse(raw);
+    if (!parsed.success) {
+        getCliLogger().error(formatOperationError(`parse task "${taskId}"`, parsed.error));
+        return 1;
+    }
+    const task = parsed.data;
+    console.log(`# Task: ${task.id}`);
+    console.log();
+    console.log(`Status:        ${task.status}`);
+    console.log(`Category:      ${task.task_category}`);
+    console.log(`Reversibility: ${task.reversibility}`);
+    console.log(`Created at:    ${task.created_at}`);
+    if (task.started_at) {
+        console.log(`Started at:    ${task.started_at}`);
+    }
+    if (task.completed_at) {
+        console.log(`Completed at:  ${task.completed_at}`);
+    }
+    if (task.started_at) {
+        console.log(`Elapsed:       ${elapsedLabel(task)}`);
+    }
+    console.log();
+    console.log(`## Work Description`);
+    console.log(task.work_description);
+    console.log();
+    console.log(`## Approach`);
+    console.log(task.approach);
+    if (task.success_criteria.length > 0) {
+        console.log();
+        console.log(`## Success Criteria`);
+        for (const criterion of task.success_criteria) {
+            const blocking = criterion.is_blocking ? "[blocking]" : "[optional]";
+            console.log(`  ${blocking} ${criterion.description}`);
+            console.log(`    Verification: ${criterion.verification_method}`);
+        }
+    }
+    if (task.execution_output) {
+        console.log();
+        console.log(`## Execution Output`);
+        console.log(task.execution_output);
+    }
+    if (task.verification_verdict) {
+        console.log();
+        console.log(`## Verification`);
+        console.log(`Verdict: ${task.verification_verdict}`);
+        if (task.verification_evidence && task.verification_evidence.length > 0) {
+            console.log(`Evidence:`);
+            for (const evidence of task.verification_evidence) {
+                console.log(`  - ${evidence}`);
+            }
+        }
+    }
+    if (task.rationale) {
+        console.log();
+        console.log(`## Rationale`);
+        console.log(task.rationale);
+    }
+    return 0;
+}
+//# sourceMappingURL=task-read.js.map

package/dist/interface/cli/commands/task-read.js.map

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

package/dist/interface/cli/commands/telegram.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdTelegramSetup(_args: string[]): Promise<number>;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/interface/cli/commands/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../../../src/interface/cli/commands/telegram.ts"],"names":[],"mappings":"AAqEA,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuGvE"}

package/dist/interface/cli/commands/telegram.js

@@ -0,0 +1,139 @@
+// ─── pulseed telegram setup — Telegram Bot gateway configuration wizard ───
+//
+// Guides the user through configuring the Telegram Bot gateway channel:
+//   1. Bot token (from @BotFather) — verified via getMe API
+//   2. allowed_user_ids (optional, comma-separated)
+//   3. home chat_id (optional) — can be set later by sending /sethome
+//   4. identity_key (optional) — share one PulSeed session across chat platforms
+//
+// Writes config to ~/.pulseed/gateway/channels/telegram-bot/config.json
+import * as readline from "node:readline";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getGatewayChannelDir } from "../../../base/utils/paths.js";
+// ─── Readline helpers ───
+function createInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+async function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+async function verifyBotToken(token) {
+    try {
+        const resp = await fetch(`https://api.telegram.org/bot${token}/getMe`);
+        const data = (await resp.json());
+        if (data.ok && data.result) {
+            return data.result;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Gateway channel directory helpers ───
+function getChannelDir() {
+    return getGatewayChannelDir("telegram-bot");
+}
+async function ensureChannelDir(channelDir) {
+    await fsp.mkdir(channelDir, { recursive: true });
+}
+// ─── Public entry point ───
+export async function cmdTelegramSetup(_args) {
+    console.log("\nPulSeed — Telegram Bot Setup\n");
+    const rl = createInterface();
+    try {
+        // Step 1: Bot token
+        console.log("Step 1: Bot token");
+        console.log("  Create a bot via @BotFather on Telegram and copy the token.\n");
+        const token = await ask(rl, "Enter bot token: ");
+        if (!token) {
+            console.error("Error: bot token cannot be empty.");
+            return 1;
+        }
+        process.stdout.write("  Verifying token...");
+        const botInfo = await verifyBotToken(token);
+        if (!botInfo) {
+            console.log(" failed.");
+            console.error("Error: token verification failed. Check the token and try again.");
+            return 1;
+        }
+        console.log(` OK (@${botInfo.username ?? botInfo.first_name})\n`);
+        // Step 2: allowed_user_ids (optional)
+        console.log("\nStep 2: Allowed user IDs (recommended)");
+        console.log("  Comma-separated Telegram user IDs that may send commands to the bot.");
+        console.log("  Hermes-style setup uses user IDs for access control instead of requiring chat_id up front.");
+        console.log("  Message @userinfobot if you need your numeric user ID.\n");
+        const allowedStr = await ask(rl, "Allowed user IDs (e.g. 123456,789012) or press Enter to skip: ");
+        const allowedUserIds = [];
+        if (allowedStr) {
+            for (const part of allowedStr.split(",")) {
+                const n = parseInt(part.trim(), 10);
+                if (!isNaN(n)) {
+                    allowedUserIds.push(n);
+                }
+            }
+        }
+        // Step 3: home chat_id (optional)
+        console.log("\nStep 3: Home chat (optional)");
+        console.log("  Leave empty now, then send /sethome to the bot from Telegram after the daemon is running.");
+        console.log("  Notifications will use that chat.\n");
+        const chatIdStr = await ask(rl, "Home chat_id (number) or press Enter to set later with /sethome: ");
+        let chatId;
+        if (chatIdStr) {
+            const parsed = parseInt(chatIdStr, 10);
+            if (isNaN(parsed)) {
+                console.error("Error: chat_id must be a number when provided.");
+                return 1;
+            }
+            chatId = parsed;
+        }
+        // Step 4: identity_key (optional)
+        console.log("\nStep 4: Cross-platform identity (optional)");
+        console.log("  Use the same key in Telegram, Discord, WhatsApp, and Signal configs");
+        console.log("  when they should continue the same PulSeed chat session.");
+        console.log("  Leave empty to keep this Telegram chat separate.\n");
+        const identityKey = await ask(rl, "Identity key (e.g. personal) or press Enter to skip: ");
+        // Step 5: Write config
+        const channelDir = getChannelDir();
+        await ensureChannelDir(channelDir);
+        const config = {
+            bot_token: token,
+            allowed_user_ids: allowedUserIds,
+            allow_all: allowedUserIds.length === 0,
+            polling_timeout: 30,
+            ...(chatId !== undefined ? { chat_id: chatId } : {}),
+            ...(identityKey ? { identity_key: identityKey } : {}),
+        };
+        const configPath = path.join(channelDir, "config.json");
+        await fsp.writeFile(configPath, JSON.stringify(config, null, 2), "utf8");
+        // Summary
+        console.log("\nTelegram Bot setup complete!");
+        console.log(`  Config: ${configPath}`);
+        console.log(`  Bot:    @${botInfo.username ?? botInfo.first_name}`);
+        console.log(`  Home:   ${chatId !== undefined ? chatId : "(send /sethome to set later)"}`);
+        if (allowedUserIds.length > 0) {
+            console.log(`  Allowed users: ${allowedUserIds.join(", ")}`);
+        }
+        else {
+            console.log("  Allowed users: (all)");
+        }
+        if (identityKey) {
+            console.log(`  Identity key: ${identityKey}`);
+        }
+        else {
+            console.log("  Identity key: (not set)");
+        }
+        console.log("\nThe daemon will pick this up automatically as a built-in gateway channel.");
+        return 0;
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/interface/cli/commands/telegram.js.map

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

package/dist/interface/cli/commands/usage.d.ts

@@ -0,0 +1,3 @@
+import type { StateManager } from "../../../base/state/state-manager.js";
+export declare function cmdUsage(stateManager: StateManager, argv: string[]): Promise<number>;
+//# sourceMappingURL=usage.d.ts.map

package/dist/interface/cli/commands/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../src/interface/cli/commands/usage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AA6KzE,wBAAsB,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyF1F"}

package/dist/interface/cli/commands/usage.js

@@ -0,0 +1,233 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { parseArgs } from "node:util";
+function zeroUsageCounter() {
+    return { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+}
+function normalizeUsageCounter(raw) {
+    if (!raw || typeof raw !== "object")
+        return zeroUsageCounter();
+    const value = raw;
+    const inputValue = Number(value.inputTokens);
+    const outputValue = Number(value.outputTokens);
+    const totalValue = Number(value.totalTokens);
+    const inputTokens = Number.isFinite(inputValue) ? Math.max(0, Math.floor(inputValue)) : 0;
+    const outputTokens = Number.isFinite(outputValue) ? Math.max(0, Math.floor(outputValue)) : 0;
+    const totalTokens = Number.isFinite(totalValue)
+        ? Math.max(0, Math.floor(totalValue))
+        : inputTokens + outputTokens;
+    return { inputTokens, outputTokens, totalTokens };
+}
+function parseUsagePeriodMs(period) {
+    const match = /^(\d+)([dhw])$/i.exec(period.trim());
+    if (!match) {
+        throw new Error("period must look like 7d, 24h, or 2w");
+    }
+    const value = Number(match[1]);
+    const unit = match[2]?.toLowerCase();
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error("period value must be positive");
+    }
+    if (unit === "h")
+        return value * 60 * 60 * 1000;
+    if (unit === "w")
+        return value * 7 * 24 * 60 * 60 * 1000;
+    return value * 24 * 60 * 60 * 1000;
+}
+async function collectGoalUsage(stateManager, goalId) {
+    const ledgerDir = path.join(stateManager.getBaseDir(), "tasks", goalId, "ledger");
+    let entries = [];
+    try {
+        entries = await fsp.readdir(ledgerDir);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+        return { goalId, totalTokens: 0, taskCount: 0, terminalTaskCount: 0 };
+    }
+    let totalTokens = 0;
+    let taskCount = 0;
+    let terminalTaskCount = 0;
+    for (const entry of entries) {
+        if (!entry.endsWith(".json"))
+            continue;
+        taskCount += 1;
+        try {
+            const raw = await fsp.readFile(path.join(ledgerDir, entry), "utf-8");
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.summary?.tokens_used === "number") {
+                totalTokens += parsed.summary.tokens_used;
+            }
+            if (parsed.summary?.latest_event_type === "succeeded"
+                || parsed.summary?.latest_event_type === "failed"
+                || parsed.summary?.latest_event_type === "abandoned") {
+                terminalTaskCount += 1;
+            }
+        }
+        catch {
+            // Ignore malformed ledger entries.
+        }
+    }
+    return { goalId, totalTokens, taskCount, terminalTaskCount };
+}
+async function collectScheduleUsage(stateManager, period) {
+    const periodMs = parseUsagePeriodMs(period);
+    const since = Date.now() - periodMs;
+    const historyPath = path.join(stateManager.getBaseDir(), "schedule-history.json");
+    let raw;
+    try {
+        raw = JSON.parse(await fsp.readFile(historyPath, "utf-8"));
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return { period, runs: 0, totalTokens: 0 };
+        }
+        throw err;
+    }
+    if (!Array.isArray(raw)) {
+        return { period, runs: 0, totalTokens: 0 };
+    }
+    let runs = 0;
+    let totalTokens = 0;
+    for (const record of raw) {
+        if (!record || typeof record !== "object")
+            continue;
+        const finishedAt = record["finished_at"];
+        const firedAt = typeof finishedAt === "string" ? Date.parse(finishedAt) : Number.NaN;
+        if (!Number.isFinite(firedAt) || firedAt < since)
+            continue;
+        runs += 1;
+        const tokensUsed = record["tokens_used"];
+        if (typeof tokensUsed === "number" && Number.isFinite(tokensUsed)) {
+            totalTokens += tokensUsed;
+        }
+    }
+    return { period, runs, totalTokens };
+}
+async function readSessionUsage(stateManager, sessionId) {
+    const raw = await stateManager.readRaw(`chat/sessions/${sessionId}.json`);
+    if (!raw || typeof raw !== "object") {
+        throw new Error(`chat session not found: ${sessionId}`);
+    }
+    const session = raw;
+    const byPhase = Object.fromEntries(Object.entries(session.usage?.byPhase ?? {}).map(([phase, usage]) => [phase, normalizeUsageCounter(usage)]));
+    return {
+        sessionId,
+        totals: normalizeUsageCounter(session.usage?.totals),
+        byPhase,
+    };
+}
+function printSessionSummary(summary) {
+    console.log(`Usage summary (session ${summary.sessionId})`);
+    console.log(`Session total tokens:  ${summary.totals.totalTokens}`);
+    console.log(`Session input tokens:  ${summary.totals.inputTokens}`);
+    console.log(`Session output tokens: ${summary.totals.outputTokens}`);
+    const phaseEntries = Object.entries(summary.byPhase)
+        .filter(([, usage]) => usage.totalTokens > 0)
+        .sort((left, right) => right[1].totalTokens - left[1].totalTokens);
+    if (phaseEntries.length === 0)
+        return;
+    console.log("");
+    console.log("By phase:");
+    for (const [phase, usage] of phaseEntries) {
+        console.log(`- ${phase}: ${usage.totalTokens} (in=${usage.inputTokens}, out=${usage.outputTokens})`);
+    }
+}
+function printUsageHelp() {
+    console.log("Usage: pulseed usage <session|goal|daemon|schedule> [args]");
+    console.log("  session <id>                     Show usage for one chat session");
+    console.log("  goal <goal-id>                   Show usage from task ledgers for a goal");
+    console.log("  daemon <goal-id>                 Alias of goal scope for daemon-triggered runs");
+    console.log("  schedule [--period <7d|24h|2w>]  Show schedule token usage for a period");
+}
+export async function cmdUsage(stateManager, argv) {
+    const scope = argv[0]?.toLowerCase();
+    if (!scope || scope === "help" || scope === "--help" || scope === "-h") {
+        printUsageHelp();
+        return 0;
+    }
+    if (scope === "session") {
+        let parsed;
+        try {
+            parsed = parseArgs({
+                args: argv.slice(1),
+                allowPositionals: true,
+                options: {
+                    session: { type: "string" },
+                },
+                strict: false,
+            });
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            return 1;
+        }
+        const sessionId = String(parsed.values.session ?? parsed.positionals[0] ?? "");
+        if (!sessionId) {
+            console.error("Usage: pulseed usage session <session-id>");
+            return 1;
+        }
+        try {
+            const summary = await readSessionUsage(stateManager, sessionId);
+            printSessionSummary(summary);
+            return 0;
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            return 1;
+        }
+    }
+    if (scope === "goal" || scope === "daemon") {
+        const goalId = argv[1];
+        if (!goalId) {
+            console.error(`Usage: pulseed usage ${scope} <goal-id>`);
+            return 1;
+        }
+        try {
+            const summary = await collectGoalUsage(stateManager, goalId);
+            console.log(`Usage summary (${scope} scope)`);
+            console.log(`Goal: ${summary.goalId}`);
+            console.log(`Tasks observed: ${summary.taskCount}`);
+            console.log(`Terminal tasks: ${summary.terminalTaskCount}`);
+            console.log(`Total tokens: ${summary.totalTokens}`);
+            return 0;
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            return 1;
+        }
+    }
+    if (scope === "schedule") {
+        let parsed;
+        try {
+            parsed = parseArgs({
+                args: argv.slice(1),
+                allowPositionals: true,
+                options: {
+                    period: { type: "string", default: "7d" },
+                },
+                strict: false,
+            });
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            return 1;
+        }
+        const period = String(parsed.values.period ?? parsed.positionals[0] ?? "7d");
+        try {
+            const summary = await collectScheduleUsage(stateManager, period);
+            console.log(`Usage summary (schedule, ${summary.period})`);
+            console.log(`Runs: ${summary.runs}`);
+            console.log(`Total tokens: ${summary.totalTokens}`);
+            return 0;
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            return 1;
+        }
+    }
+    console.error("Unknown usage scope.");
+    printUsageHelp();
+    return 1;
+}
+//# sourceMappingURL=usage.js.map

package/dist/interface/cli/commands/usage.js.map

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