@saleso.innovations/bridge 0.1.15 → 0.1.17

package/INTEGRATION.md

@@ -109,6 +109,17 @@ Codes expire after 10 minutes. Each code links **one** Hermes instance to **one*
 
 After first pairing, credentials are saved to `~/.cleos/agent.json`. Delivered cron files are tracked in `~/.cleos/cron-delivered.json` so restarts do not duplicate Jobs. Use `reconnectHermesAgent()` on restart — no new pairing code required.
 
+### Recover missed cron results
+
+If cron results reached Telegram but not Cleos (for example after a bridge restart), re-deliver pending output files:
+
+```bash
+cleos-bridge cron-backfill --list    # inspect pending files
+cleos-bridge cron-backfill --reset   # clear delivery index and re-send all output files
+```
+
+Keep `cleos-bridge start` running so new cron runs are forwarded automatically.
+
 ## Self-hosting Cleos
 
 Set `CLEOS_CONVEX_SITE_URL` in the Hermes build to your Convex `.site` URL instead of the default.

package/README.md

@@ -34,7 +34,7 @@ This installs the latest package, refreshes the CLI symlink, and restarts `cleos
 To pin a specific release (e.g. after a Cleos update):
 
 ```bash
-curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash -s -- 0.1.15
+curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash -s -- 0.1.17
 ```
 
 ## Manual usage
@@ -58,6 +58,13 @@ Credentials are saved to `~/.cleos/agent.json`.
 
 The daemon watches `~/.hermes/cron/output/` and forwards new cron results to the Cleos Jobs tab automatically.
 
+To recover missed cron output (for example after a bridge restart):
+
+```bash
+cleos-bridge cron-backfill --list
+cleos-bridge cron-backfill --reset
+```
+
 ## Hermes API
 
 By default the bridge forwards chat to Hermes at `http://127.0.0.1:8642/v1/chat/completions`.

package/dist/cli.js

@@ -8,6 +8,7 @@ import { prepareHermesForBridge } from "./ensureHermesApi.js";
 import { createHermesMessageHandler } from "./hermesForwarder.js";
 import { convexSiteUrlFromEnv } from "./resolve.js";
 import { normalizePairingCode } from "./normalizePairingCode.js";
+import { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfill.js";
 async function main() {
     const [, , command, codeArg] = process.argv;
     const onUserMessage = createHermesMessageHandler();
@@ -70,6 +71,28 @@ async function main() {
         runBridgeUpdate({ tag: codeArg || "latest" });
         return;
     }
+    if (command === "cron-backfill") {
+        const reset = process.argv.includes("--reset");
+        const listOnly = process.argv.includes("--list");
+        if (listOnly) {
+            const state = describeCronDeliveryState();
+            console.log(JSON.stringify({ event: "cleos-bridge.cron-backfill.list", ...state }, null, 2));
+            return;
+        }
+        const session = await reconnectHermesAgent({ onUserMessage });
+        try {
+            const summary = await backfillCronDeliveries(session, { reset });
+            console.log(JSON.stringify({ event: "cleos-bridge.cron-backfill.complete", ...summary }, null, 2));
+            if (summary.remainingCount > 0) {
+                console.error(`${summary.remainingCount} cron file(s) still pending. Keep cleos-bridge running or retry when relay is connected.`);
+                process.exitCode = 1;
+            }
+        }
+        finally {
+            session.close();
+        }
+        return;
+    }
     printUsage();
     process.exit(1);
 }
@@ -80,6 +103,8 @@ function printUsage() {
     console.error("  cleos-bridge start [CODE]     Run as a reconnecting daemon (systemd)");
     console.error("  cleos-bridge reconnect        Reconnect once using saved credentials");
     console.error("  cleos-bridge update [TAG]     Update package and restart systemd service");
+    console.error("  cleos-bridge cron-backfill [--reset] [--list]");
+    console.error("                                Re-deliver pending cron output files to Cleos");
 }
 async function waitForExit(session, onStart) {
     const stop = onStart?.();

package/dist/client.d.ts

@@ -18,7 +18,8 @@ export type UserMessageAttachment = {
 export type UserMessageMeta = {
     agentId: string;
     conversationId: string;
-    messageId: string;
+    clientMessageId: string;
+    replyMessageId: string;
     attachments?: UserMessageAttachment[];
 };
 export type AgentActivityPayload = {
@@ -36,7 +37,7 @@ export type AgentFailedPayload = {
 export type AgentReply = {
     delta: (text: string, sequence: number) => void;
     activity: (activity: AgentActivityPayload) => void;
-    complete: (text: string, sequence: number) => void;
+    complete: (text: string, sequence: number, attachments?: UserMessageAttachment[]) => void;
     failed: (failure: AgentFailedPayload) => void;
 };
 export type CronDeliveryMeta = {

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAYhG,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,qBAAqB,EAAE,KAAK,IAAI,CAAC;IAC1F,MAAM,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtE,CAAC;AAyTF,wBAAsB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA2BD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAClD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,aAAa,CAAC,CAc9B"}

package/dist/client.js

@@ -72,7 +72,7 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 sequence: activity.sequence,
             }));
         },
-        complete(text, sequence) {
+        complete(text, sequence, attachments) {
             ws.send(JSON.stringify({
                 type: "agent.message",
                 agentId,
@@ -81,6 +81,7 @@ function createReplySender(ws, agentId, conversationId, messageId) {
                 content: text,
                 sequence,
                 final: true,
+                ...(attachments && attachments.length > 0 ? { attachments } : {}),
             }));
         },
         failed(failure) {
@@ -195,11 +196,14 @@ async function openAgentConnection(options) {
                 rememberConversationId(conversationId);
             }
             const attachments = parseUserMessageAttachments(envelope.attachments);
+            const clientMessageId = typeof envelope.clientMessageId === "string" && envelope.clientMessageId.trim().length > 0
+                ? envelope.clientMessageId.trim()
+                : randomUUID();
             const replyMessageId = randomUUID();
             const reply = createReplySender(ws, agentId, conversationId, replyMessageId);
             if (options.onUserMessage) {
                 try {
-                    await options.onUserMessage(content, { agentId, conversationId, messageId: replyMessageId, attachments }, reply);
+                    await options.onUserMessage(content, { agentId, conversationId, clientMessageId, replyMessageId, attachments }, reply);
                 }
                 catch (error) {
                     const { message, code } = userSafeHermesError(error);

package/dist/convexRelay.d.ts

@@ -0,0 +1,24 @@
+export type ConvexUploadedFile = {
+    storageId: string;
+    url: string | null;
+    mimeType: string;
+    fileName: string;
+    size: number;
+};
+export type HermesMessageLink = {
+    clientMessageId?: string;
+    externalMessageId?: string;
+    hermesMessageId: string;
+};
+export declare function linkHermesMessageIds(args: {
+    agentId: string;
+    conversationId: string;
+    links: HermesMessageLink[];
+}): Promise<void>;
+export declare function uploadFileToConvex(args: {
+    agentId: string;
+    fileName: string;
+    mimeType: string;
+    contentBase64: string;
+}): Promise<ConvexUploadedFile>;
+//# sourceMappingURL=convexRelay.d.ts.map

package/dist/convexRelay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convexRelay.d.ts","sourceRoot":"","sources":["../src/convexRelay.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4C9B"}

package/dist/convexRelay.js

@@ -0,0 +1,70 @@
+import { loadCredentials } from "./credentials.js";
+import { MAX_RELAY_UPLOAD_BYTES } from "./hermesFiles.js";
+import { convexSiteUrlFromEnv } from "./resolve.js";
+export async function linkHermesMessageIds(args) {
+    if (args.links.length === 0)
+        return;
+    const credentials = loadCredentials();
+    const convexSiteUrl = credentials?.convexSiteUrl ?? convexSiteUrlFromEnv();
+    const relaySecret = process.env.CLEOS_RELAY_SECRET?.trim() || "dev-relay-secret";
+    const response = await fetch(`${convexSiteUrl.replace(/\/$/, "")}/relay/messages`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "x-cleos-relay-secret": relaySecret,
+        },
+        body: JSON.stringify({
+            envelope: {
+                type: "hermes.link",
+                agentId: args.agentId,
+                conversationId: args.conversationId,
+                links: args.links,
+            },
+        }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to link Hermes message IDs (${response.status}): ${text}`);
+    }
+}
+export async function uploadFileToConvex(args) {
+    if (args.contentBase64.length === 0) {
+        throw new Error("contentBase64 is required");
+    }
+    const byteLength = Buffer.byteLength(args.contentBase64, "base64");
+    if (byteLength > MAX_RELAY_UPLOAD_BYTES) {
+        throw new Error(`File exceeds maximum upload size (${MAX_RELAY_UPLOAD_BYTES} bytes)`);
+    }
+    const credentials = loadCredentials();
+    const convexSiteUrl = credentials?.convexSiteUrl ?? convexSiteUrlFromEnv();
+    const relaySecret = process.env.CLEOS_RELAY_SECRET?.trim() || "dev-relay-secret";
+    const response = await fetch(`${convexSiteUrl.replace(/\/$/, "")}/relay/files`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "x-cleos-relay-secret": relaySecret,
+        },
+        body: JSON.stringify({
+            agentId: args.agentId,
+            fileName: args.fileName,
+            mimeType: args.mimeType,
+            contentBase64: args.contentBase64,
+        }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to upload file to Convex (${response.status}): ${text}`);
+    }
+    const payload = (await response.json());
+    const storageId = typeof payload.storageId === "string" ? payload.storageId : "";
+    if (!storageId) {
+        throw new Error("Upload response missing storageId");
+    }
+    return {
+        storageId,
+        url: typeof payload.url === "string" ? payload.url : null,
+        mimeType: args.mimeType,
+        fileName: args.fileName,
+        size: byteLength,
+    };
+}

package/dist/cronBackfill.d.ts

@@ -0,0 +1,16 @@
+import type { ConnectResult } from "./client.js";
+export type CronBackfillSummary = {
+    clearedEntries: number;
+    pendingBefore: number;
+    deliveredCount: number;
+    remainingCount: number;
+};
+export declare function describeCronDeliveryState(): {
+    outputFileCount: number;
+    deliveredCount: number;
+    pendingFiles: string[];
+};
+export declare function backfillCronDeliveries(session: ConnectResult, options: {
+    reset: boolean;
+}): Promise<CronBackfillSummary>;
+//# sourceMappingURL=cronBackfill.d.ts.map

package/dist/cronBackfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronBackfill.d.ts","sourceRoot":"","sources":["../src/cronBackfill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,yBAAyB,IAAI;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAUA;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/dist/cronBackfill.js

@@ -0,0 +1,14 @@
+import { listCronOutputFiles, listPendingCronFiles, readDeliveredIndex, relativeOutputKey, runCronBackfill, } from "./cronWatcher.js";
+export function describeCronDeliveryState() {
+    const delivered = readDeliveredIndex();
+    const outputFiles = listCronOutputFiles();
+    const pendingFiles = listPendingCronFiles(delivered);
+    return {
+        outputFileCount: outputFiles.length,
+        deliveredCount: delivered.size,
+        pendingFiles: pendingFiles.map(relativeOutputKey),
+    };
+}
+export async function backfillCronDeliveries(session, options) {
+    return runCronBackfill(session, options.reset);
+}

package/dist/cronWatcher.d.ts

@@ -1,4 +1,6 @@
 import type { ConnectResult } from "./client.js";
+export declare const HERMES_CRON_OUTPUT_DIR: string;
+export declare const DELIVERED_INDEX_PATH: string;
 type CronWatcherOptions = {
     session: ConnectResult;
     onDelivered?: (info: {
@@ -8,6 +10,18 @@ type CronWatcherOptions = {
     }) => void;
     onError?: (message: string) => void;
 };
+export declare function readDeliveredIndex(): Set<string>;
+export declare function writeDeliveredIndex(delivered: Set<string>): void;
+export declare function clearDeliveredIndex(): number;
+export declare function listCronOutputFiles(rootDir?: string): string[];
+export declare function relativeOutputKey(filePath: string): string;
+export declare function listPendingCronFiles(delivered?: Set<string>): string[];
 export declare function startCronWatcher(options: CronWatcherOptions): () => void;
+export declare function runCronBackfill(session: ConnectResult, resetIndex: boolean): Promise<{
+    clearedEntries: number;
+    pendingBefore: number;
+    deliveredCount: number;
+    remainingCount: number;
+}>;
 export {};
 //# sourceMappingURL=cronWatcher.d.ts.map

package/dist/cronWatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cronWatcher.d.ts","sourceRoot":"","sources":["../src/cronWatcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAejD,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAiGF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAoExE"}
+{"version":3,"file":"cronWatcher.d.ts","sourceRoot":"","sources":["../src/cronWatcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,eAAO,MAAM,sBAAsB,QAA+C,CAAC;AAEnF,eAAO,MAAM,oBAAoB,QAAmD,CAAC;AASrF,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,CAAC,CAQhD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAGhE;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,MAA+B,GAAG,MAAM,EAAE,CAoBtF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,GAAG,CAAC,MAAM,CAAwB,GAAG,MAAM,EAAE,CAE5F;AAqHD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI,CA8BxE;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAsBD"}

package/dist/cronWatcher.js

@@ -3,12 +3,12 @@ import { homedir } from "node:os";
 import { dirname, join, relative } from "node:path";
 import { resolveActiveConversationId } from "./activeConversation.js";
 import { loadCredentials } from "./credentials.js";
-const HERMES_CRON_OUTPUT_DIR = join(homedir(), ".hermes", "cron", "output");
+export const HERMES_CRON_OUTPUT_DIR = join(homedir(), ".hermes", "cron", "output");
 const HERMES_CRON_JOBS_FILE = join(homedir(), ".hermes", "cron", "jobs.json");
-const DELIVERED_INDEX_PATH = join(homedir(), ".cleos", "cron-delivered.json");
+export const DELIVERED_INDEX_PATH = join(homedir(), ".cleos", "cron-delivered.json");
 const POLL_INTERVAL_MS = 5_000;
 const FILE_SETTLE_MS = 750;
-function readDeliveredIndex() {
+export function readDeliveredIndex() {
     try {
         const parsed = JSON.parse(readFileSync(DELIVERED_INDEX_PATH, "utf8"));
         if (!Array.isArray(parsed))
@@ -19,11 +19,16 @@ function readDeliveredIndex() {
         return new Set();
     }
 }
-function writeDeliveredIndex(delivered) {
+export function writeDeliveredIndex(delivered) {
     mkdirSync(dirname(DELIVERED_INDEX_PATH), { recursive: true });
     writeFileSync(DELIVERED_INDEX_PATH, JSON.stringify([...delivered].sort(), null, 2));
 }
-function listCronOutputFiles(rootDir) {
+export function clearDeliveredIndex() {
+    const previous = readDeliveredIndex().size;
+    writeDeliveredIndex(new Set());
+    return previous;
+}
+export function listCronOutputFiles(rootDir = HERMES_CRON_OUTPUT_DIR) {
     if (!existsSync(rootDir))
         return [];
     const files = [];
@@ -46,6 +51,12 @@ function listCronOutputFiles(rootDir) {
     }
     return files.sort();
 }
+export function relativeOutputKey(filePath) {
+    return relative(HERMES_CRON_OUTPUT_DIR, filePath).replace(/\\/g, "/");
+}
+export function listPendingCronFiles(delivered = readDeliveredIndex()) {
+    return listCronOutputFiles().filter((filePath) => !delivered.has(relativeOutputKey(filePath)));
+}
 function loadHermesCronJobs() {
     const names = new Map();
     if (!existsSync(HERMES_CRON_JOBS_FILE))
@@ -68,9 +79,6 @@ function loadHermesCronJobs() {
     }
     return names;
 }
-function relativeOutputKey(filePath) {
-    return relative(HERMES_CRON_OUTPUT_DIR, filePath).replace(/\\/g, "/");
-}
 function parseRunAtFromFileName(filePath) {
     const base = filePath.split("/").pop()?.replace(/\.md$/i, "") ?? "";
     if (!base)
@@ -103,14 +111,58 @@ async function readFileWhenStable(filePath) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function isRelayNotOpenError(error) {
+    return error instanceof Error && error.message === "Cleos relay connection is not open";
+}
+async function deliverPendingFiles(session, delivered, conversationId, options) {
+    const jobNames = loadHermesCronJobs();
+    for (const filePath of listCronOutputFiles()) {
+        const key = relativeOutputKey(filePath);
+        if (delivered.has(key))
+            continue;
+        const parts = key.split("/");
+        const jobId = parts[0] ?? "unknown";
+        const jobName = jobNames.get(jobId) ?? jobId;
+        const content = await readFileWhenStable(filePath);
+        if (!content) {
+            delivered.add(key);
+            writeDeliveredIndex(delivered);
+            continue;
+        }
+        try {
+            session.deliverCronResult(content, {
+                conversationId,
+                jobId,
+                jobName,
+                runAt: parseRunAtFromFileName(filePath),
+            });
+        }
+        catch (error) {
+            if (isRelayNotOpenError(error)) {
+                console.log(JSON.stringify({
+                    event: "cleos-bridge.cron-deferred",
+                    file: key,
+                    reason: "relay_not_open",
+                }));
+                return;
+            }
+            throw error;
+        }
+        delivered.add(key);
+        writeDeliveredIndex(delivered);
+        options.onDelivered?.({ jobId, jobName, filePath });
+        console.log(JSON.stringify({
+            event: "cleos-bridge.cron-delivered",
+            jobId,
+            jobName,
+            file: key,
+        }));
+    }
+}
 export function startCronWatcher(options) {
     const delivered = readDeliveredIndex();
     let conversationId = loadCredentials()?.conversationId ?? null;
     let stopped = false;
-    for (const filePath of listCronOutputFiles(HERMES_CRON_OUTPUT_DIR)) {
-        delivered.add(relativeOutputKey(filePath));
-    }
-    writeDeliveredIndex(delivered);
     const tick = () => {
         void (async () => {
             if (stopped)
@@ -119,35 +171,7 @@ export function startCronWatcher(options) {
                 if (!conversationId) {
                     conversationId = await resolveActiveConversationId();
                 }
-                const jobNames = loadHermesCronJobs();
-                for (const filePath of listCronOutputFiles(HERMES_CRON_OUTPUT_DIR)) {
-                    const key = relativeOutputKey(filePath);
-                    if (delivered.has(key))
-                        continue;
-                    const parts = key.split("/");
-                    const jobId = parts[0] ?? "unknown";
-                    const jobName = jobNames.get(jobId) ?? jobId;
-                    const content = await readFileWhenStable(filePath);
-                    if (!content) {
-                        delivered.add(key);
-                        continue;
-                    }
-                    options.session.deliverCronResult(content, {
-                        conversationId: conversationId,
-                        jobId,
-                        jobName,
-                        runAt: parseRunAtFromFileName(filePath),
-                    });
-                    delivered.add(key);
-                    writeDeliveredIndex(delivered);
-                    options.onDelivered?.({ jobId, jobName, filePath });
-                    console.log(JSON.stringify({
-                        event: "cleos-bridge.cron-delivered",
-                        jobId,
-                        jobName,
-                        file: key,
-                    }));
-                }
+                await deliverPendingFiles(options.session, delivered, conversationId, options);
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
@@ -163,3 +187,23 @@ export function startCronWatcher(options) {
         clearInterval(timer);
     };
 }
+export async function runCronBackfill(session, resetIndex) {
+    const pendingBefore = listPendingCronFiles().length;
+    const clearedEntries = resetIndex ? clearDeliveredIndex() : 0;
+    const delivered = readDeliveredIndex();
+    const pendingAfterReset = listPendingCronFiles(delivered).length;
+    let conversationId = loadCredentials()?.conversationId ?? null;
+    if (!conversationId) {
+        conversationId = await resolveActiveConversationId();
+    }
+    const deliveredBefore = delivered.size;
+    await deliverPendingFiles(session, delivered, conversationId, {});
+    const deliveredCount = delivered.size - deliveredBefore;
+    const remainingCount = listPendingCronFiles(delivered).length;
+    return {
+        clearedEntries,
+        pendingBefore: resetIndex ? pendingAfterReset : pendingBefore,
+        deliveredCount,
+        remainingCount,
+    };
+}

package/dist/hermesCommands.d.ts

@@ -1,4 +1,4 @@
-export declare const HERMES_COMMAND_NAMES: readonly ["runtime.health", "runtime.detailedHealth", "runtime.capabilities", "models.list", "model.set", "responses.create", "runs.create", "runs.status", "runs.stop", "jobs.list", "jobs.get", "jobs.create", "jobs.update", "jobs.pause", "jobs.resume", "jobs.runNow", "jobs.delete", "profiles.list", "profiles.create", "gateway.start", "gateway.stop", "gateway.restart", "hermes.update"];
+export declare const HERMES_COMMAND_NAMES: readonly ["runtime.health", "runtime.detailedHealth", "runtime.version", "runtime.capabilities", "models.list", "model.set", "responses.create", "runs.create", "runs.status", "runs.stop", "jobs.list", "jobs.get", "jobs.create", "jobs.update", "jobs.pause", "jobs.resume", "jobs.runNow", "jobs.delete", "profiles.list", "profiles.create", "gateway.start", "gateway.stop", "gateway.restart", "hermes.update", "sessions.messages.list", "sessions.messages.countSent", "skills.list", "files.list", "files.read"];
 export type HermesCommandName = (typeof HERMES_COMMAND_NAMES)[number];
 export declare function isHermesCommandName(value: string): value is HermesCommandName;
 export type HermesCommandErrorCode = "command_unsupported" | "hermes_unreachable" | "hermes_request_failed" | "invalid_command_args" | "unsupported_by_http";

package/dist/hermesCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,qYAwBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAI1D;AAuFD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,OAAO,CAAC,CAkKlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}
+{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB,4fA8BvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAI1D;AAgGD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,OAAO,CAAC,OAAO,CAAC,CAwLlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}

package/dist/hermesCommands.js

@@ -1,10 +1,15 @@
 import { resolveHermesApiConfig } from "./hermesForwarder.js";
 import { restartHermesGateway, startHermesGateway, stopHermesGateway } from "./gatewayControl.js";
 import { listHermesCronJobs } from "./cronList.js";
+import { listSessionMessages, countUserMessagesSent } from "./hermesSessionDb.js";
+import { listHermesSkills } from "./skillsList.js";
 import { runHermesUpdate } from "./hermesUpdate.js";
+import { executeFilesList, executeFilesRead } from "./hermesFileCommands.js";
+import { fetchHermesRuntimeVersion } from "./runtimeVersion.js";
 export const HERMES_COMMAND_NAMES = [
     "runtime.health",
     "runtime.detailedHealth",
+    "runtime.version",
     "runtime.capabilities",
     "models.list",
     "model.set",
@@ -26,6 +31,11 @@ export const HERMES_COMMAND_NAMES = [
     "gateway.stop",
     "gateway.restart",
     "hermes.update",
+    "sessions.messages.list",
+    "sessions.messages.countSent",
+    "skills.list",
+    "files.list",
+    "files.read",
 ];
 export function isHermesCommandName(value) {
     return HERMES_COMMAND_NAMES.includes(value);
@@ -71,6 +81,15 @@ function optionalRecord(args, key) {
     }
     return value;
 }
+function optionalNumber(args, key) {
+    const value = args[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new HermesCommandError("invalid_command_args", `Invalid "${key}"`);
+    }
+    return Math.floor(value);
+}
 async function hermesFetchJson(config, path, init = {}) {
     const url = `${hermesBaseUrl(config.apiUrl)}${path}`;
     const headers = {
@@ -109,6 +128,8 @@ export async function executeHermesCommand(command, args, options = {}) {
             return await hermesFetchJson(config, "/health");
         case "runtime.detailedHealth":
             return await hermesFetchJson(config, "/health/detailed");
+        case "runtime.version":
+            return await fetchHermesRuntimeVersion();
         case "runtime.capabilities":
             return await hermesFetchJson(config, "/v1/capabilities");
         case "models.list":
@@ -256,6 +277,26 @@ export async function executeHermesCommand(command, args, options = {}) {
             const restartGateway = args.restartGateway === true || args.restart_gateway === true;
             return await runHermesUpdate({ restartGateway });
         }
+        case "sessions.messages.list": {
+            const sessionId = requireString(args, "sessionId");
+            const limit = optionalNumber(args, "limit");
+            const offset = optionalNumber(args, "offset");
+            const offsetFromEnd = optionalNumber(args, "offsetFromEnd");
+            return listSessionMessages(sessionId, { limit, offset, offsetFromEnd });
+        }
+        case "sessions.messages.countSent":
+            return countUserMessagesSent();
+        case "skills.list":
+            return await listHermesSkills();
+        case "files.list":
+            return await executeFilesList(args);
+        case "files.read": {
+            const path = optionalString(args, "path");
+            if (!path) {
+                throw new HermesCommandError("invalid_command_args", 'Missing "path"');
+            }
+            return await executeFilesRead({ ...args, path });
+        }
         default: {
             const _exhaustive = command;
             throw new HermesCommandError("command_unsupported", `Unsupported command: ${String(_exhaustive)}`);

package/dist/hermesFileCommands.d.ts

@@ -0,0 +1,19 @@
+export declare function executeFilesList(args: Record<string, unknown>): Promise<{
+    files: import("./hermesFiles.js").HermesFileEntry[];
+}>;
+export declare function executeFilesRead(args: Record<string, unknown>): Promise<{
+    fileName: string;
+    mimeType: string;
+    size: number;
+    contentBase64: string;
+    storageId?: undefined;
+    url?: undefined;
+} | {
+    fileName: string;
+    mimeType: string;
+    size: number;
+    storageId: string;
+    url: string | undefined;
+    contentBase64?: undefined;
+}>;
+//# sourceMappingURL=hermesFileCommands.d.ts.map

package/dist/hermesFileCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermesFileCommands.d.ts","sourceRoot":"","sources":["../src/hermesFileCommands.ts"],"names":[],"mappings":"AA6BA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAKnE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;GAkCnE"}