@saleso.innovations/bridge 0.1.5 → 0.1.7

package/INTEGRATION.md

@@ -53,6 +53,38 @@ export async function resumeCleosConnection() {
 - Relay routing (Railway) between iOS app and Hermes WebSocket
 - Message history in Convex
 
+## Cron job delivery
+
+Hermes writes every cron run to `~/.hermes/cron/output/{job_id}/{timestamp}.md`. The bridge watches that folder automatically and forwards new results to Cleos as Jobs (not chat).
+
+No Hermes changes are required. Keep `cleos-bridge start` running on the VPS.
+
+When a cron job completes:
+
+1. Hermes saves output under `~/.hermes/cron/output/`
+2. The bridge detects the new file
+3. The bridge sends `agent.message` with `metadata.cron` over the Cleos WebSocket
+4. Cleos routes it to the Jobs tab
+
+The bridge resolves the Cleos `conversationId` from saved credentials or Convex (`/bridge/active-conversation`).
+
+### Manual delivery (optional)
+
+For custom integrations you can still call:
+
+```typescript
+import { reconnectHermesAgent } from "@saleso.innovations/bridge";
+
+const connection = await reconnectHermesAgent({ onUserMessage: handleCleosMessage });
+
+connection.deliverCronResult(finalText, {
+  conversationId: "<convex-conversation-id>",
+  jobId: job.id,
+  jobName: job.name,
+  runAt: Date.now(),
+});
+```
+
 ## What Hermes handles
 
 - Pairing UI (code entry)
@@ -72,7 +104,7 @@ Codes expire after 10 minutes. Each code links **one** Hermes instance to **one*
 
 ## Credentials
 
-After first pairing, credentials are saved to `~/.cleos/agent.json`. Use `reconnectHermesAgent()` on restart — no new code required.
+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.
 
 ## Self-hosting Cleos
 

package/README.md

@@ -34,6 +34,8 @@ cleos-bridge start              # reconnecting daemon (systemd)
 
 Credentials are saved to `~/.cleos/agent.json`.
 
+The daemon watches `~/.hermes/cron/output/` and forwards new cron results to the Cleos Jobs tab automatically.
+
 ## Hermes API
 
 By default the bridge forwards chat to Hermes at `http://127.0.0.1:8642/v1/chat/completions`.

package/dist/activeConversation.d.ts

@@ -0,0 +1,4 @@
+import { type SavedAgentCredentials } from "./credentials.js";
+export declare function resolveActiveConversationId(credentials?: SavedAgentCredentials): Promise<string>;
+export declare function rememberConversationId(conversationId: string): void;
+//# sourceMappingURL=activeConversation.d.ts.map

package/dist/activeConversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeConversation.d.ts","sourceRoot":"","sources":["../src/activeConversation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEjG,wBAAsB,2BAA2B,CAC/C,WAAW,CAAC,EAAE,qBAAqB,GAClC,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAEnE"}

package/dist/activeConversation.js

@@ -0,0 +1,34 @@
+import { convexSiteUrlFromEnv } from "./resolve.js";
+import { hashToken } from "./token.js";
+import { loadCredentials, patchCredentials } from "./credentials.js";
+export async function resolveActiveConversationId(credentials) {
+    const resolved = credentials ?? loadCredentials();
+    if (!resolved) {
+        throw new Error("No saved Cleos agent credentials");
+    }
+    if (resolved.conversationId) {
+        return resolved.conversationId;
+    }
+    const convexSiteUrl = resolved.convexSiteUrl ?? convexSiteUrlFromEnv();
+    const response = await fetch(`${convexSiteUrl.replace(/\/$/, "")}/bridge/active-conversation`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+            agentId: resolved.agentId,
+            tokenHash: hashToken(resolved.agentToken),
+        }),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Active conversation lookup failed (${response.status}): ${body}`);
+    }
+    const payload = (await response.json());
+    if (!payload.conversationId) {
+        throw new Error("Active conversation lookup returned no conversationId");
+    }
+    patchCredentials({ conversationId: payload.conversationId });
+    return payload.conversationId;
+}
+export function rememberConversationId(conversationId) {
+    patchCredentials({ conversationId });
+}

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { credentialsPathForDisplay, loadCredentials } from "./credentials.js";
 import { connectHermesAgent, pairCleosAgent, reconnectHermesAgent } from "./client.js";
+import { startCronWatcher } from "./cronWatcher.js";
 import { runBridgeDaemon } from "./daemon.js";
 import { prepareHermesForBridge } from "./ensureHermesApi.js";
 import { createHermesMessageHandler } from "./hermesForwarder.js";
@@ -38,7 +39,7 @@ async function main() {
         console.log(`Connected agent ${session.agentId}.`);
         console.log(`Credentials saved to ${credentialsPathForDisplay()}`);
         console.log("Press Ctrl+C to exit.");
-        await waitForExit(session);
+        await waitForExit(session, () => startCronWatcher({ session }));
         return;
     }
     if (command === "start") {
@@ -61,7 +62,7 @@ async function main() {
         });
         console.log(`Reconnected agent ${session.agentId}.`);
         console.log("Press Ctrl+C to exit.");
-        await waitForExit(session);
+        await waitForExit(session, () => startCronWatcher({ session }));
         return;
     }
     printUsage();
@@ -74,9 +75,11 @@ function printUsage() {
     console.error("  cleos-bridge start [CODE]     Run as a reconnecting daemon (systemd)");
     console.error("  cleos-bridge reconnect        Reconnect once using saved credentials");
 }
-async function waitForExit(session) {
+async function waitForExit(session, onStart) {
+    const stop = onStart?.();
     await new Promise((resolve) => {
         const onSignal = () => {
+            stop?.();
             session.close();
             resolve();
             process.exit(0);

package/dist/client.d.ts

@@ -8,20 +8,35 @@ export type ConnectOptions = {
     capabilities?: string[];
     onUserMessage?: (content: string, meta: UserMessageMeta, reply: AgentReply) => Promise<void> | void;
 };
+export type UserMessageAttachment = {
+    storageId: string;
+    mimeType: string;
+    fileName: string;
+    size?: number;
+    url?: string;
+};
 export type UserMessageMeta = {
     agentId: string;
     conversationId: string;
     messageId: string;
+    attachments?: UserMessageAttachment[];
 };
 export type AgentReply = {
     delta: (text: string, sequence: number) => void;
     complete: (text: string, sequence: number) => void;
 };
+export type CronDeliveryMeta = {
+    conversationId: string;
+    jobId: string;
+    jobName: string;
+    runAt?: number;
+};
 export type ConnectResult = {
     agentId: string;
     agentToken: string;
     close: () => void;
     closed: Promise<void>;
+    deliverCronResult: (content: string, meta: CronDeliveryMeta) => void;
 };
 export declare function pairCleosAgent(options: Omit<ConnectOptions, "onUserMessage">): Promise<{
     agentId: string;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAIhG,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,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,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,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,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;CACvB,CAAC;AA8HF,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,CA0BD;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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAKhG,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,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD,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;AA2LF,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

@@ -1,8 +1,50 @@
 import { randomUUID } from "node:crypto";
 import WebSocket from "ws";
 import { saveCredentials, loadCredentials } from "./credentials.js";
+import { rememberConversationId } from "./activeConversation.js";
 import { convexSiteUrlFromEnv, resolvePairingCode } from "./resolve.js";
 import { normalizePairingCode } from "./normalizePairingCode.js";
+function parseUserMessageAttachments(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const attachments = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const record = item;
+        const storageId = typeof record.storageId === "string" ? record.storageId : "";
+        const mimeType = typeof record.mimeType === "string" ? record.mimeType : "";
+        const fileName = typeof record.fileName === "string" ? record.fileName : "";
+        if (!storageId || !mimeType || !fileName)
+            continue;
+        attachments.push({
+            storageId,
+            mimeType,
+            fileName,
+            size: typeof record.size === "number" ? record.size : undefined,
+            url: typeof record.url === "string" ? record.url : undefined,
+        });
+    }
+    return attachments.length > 0 ? attachments : undefined;
+}
+function sendCronResult(ws, agentId, content, meta) {
+    ws.send(JSON.stringify({
+        type: "agent.message",
+        agentId,
+        conversationId: meta.conversationId,
+        messageId: randomUUID(),
+        content,
+        sequence: 0,
+        final: true,
+        metadata: {
+            cron: {
+                jobId: meta.jobId,
+                jobName: meta.jobName,
+                runAt: meta.runAt,
+            },
+        },
+    }));
+}
 function createReplySender(ws, agentId, conversationId, messageId) {
     return {
         delta(text, sequence) {
@@ -52,10 +94,14 @@ async function openAgentConnection(options) {
             const content = typeof envelope.content === "string" ? envelope.content : "";
             const agentId = typeof envelope.agentId === "string" ? envelope.agentId : options.agentId;
             const conversationId = typeof envelope.conversationId === "string" ? envelope.conversationId : "unknown";
+            if (conversationId !== "unknown") {
+                rememberConversationId(conversationId);
+            }
+            const attachments = parseUserMessageAttachments(envelope.attachments);
             const replyMessageId = randomUUID();
             const reply = createReplySender(ws, agentId, conversationId, replyMessageId);
             if (options.onUserMessage) {
-                await options.onUserMessage(content, { agentId, conversationId, messageId: replyMessageId }, reply);
+                await options.onUserMessage(content, { agentId, conversationId, messageId: replyMessageId, attachments }, reply);
                 return;
             }
             const echo = `Echo: ${content}`;
@@ -80,6 +126,12 @@ async function openAgentConnection(options) {
             ws.close();
         },
         closed,
+        deliverCronResult(content, meta) {
+            if (ws.readyState !== WebSocket.OPEN) {
+                throw new Error("Cleos relay connection is not open");
+            }
+            sendCronResult(ws, options.agentId, content, meta);
+        },
     };
 }
 async function resolveRelayTargets(options) {
@@ -116,6 +168,7 @@ export async function pairCleosAgent(options) {
         agentToken: payload.agentToken,
         relayHttpUrl: pairing.relayHttpUrl,
         relayWsUrl: pairing.relayWsUrl,
+        convexSiteUrl: options.convexSiteUrl ?? convexSiteUrlFromEnv(),
         agentName: options.agentName ?? "Hermes",
         savedAt: Date.now(),
     });

package/dist/credentials.d.ts

@@ -3,10 +3,13 @@ export type SavedAgentCredentials = {
     agentToken: string;
     relayHttpUrl: string;
     relayWsUrl: string;
+    convexSiteUrl?: string;
+    conversationId?: string;
     agentName?: string;
     savedAt: number;
 };
 export declare function loadCredentials(): SavedAgentCredentials | null;
 export declare function saveCredentials(credentials: SavedAgentCredentials): void;
+export declare function patchCredentials(patch: Partial<SavedAgentCredentials>): SavedAgentCredentials | null;
 export declare function credentialsPathForDisplay(): string;
 //# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wBAAgB,eAAe,IAAI,qBAAqB,GAAG,IAAI,CAS9D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAGxE;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wBAAgB,eAAe,IAAI,qBAAqB,GAAG,IAAI,CAS9D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAGxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,GAAG,IAAI,CAMpG;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}

package/dist/credentials.js

@@ -18,6 +18,14 @@ export function saveCredentials(credentials) {
     mkdirSync(dirname(credentialsPath), { recursive: true });
     writeFileSync(credentialsPath, JSON.stringify(credentials, null, 2));
 }
+export function patchCredentials(patch) {
+    const existing = loadCredentials();
+    if (!existing)
+        return null;
+    const next = { ...existing, ...patch, savedAt: Date.now() };
+    saveCredentials(next);
+    return next;
+}
 export function credentialsPathForDisplay() {
     return credentialsPath;
 }

package/dist/cronWatcher.d.ts

@@ -0,0 +1,13 @@
+import type { ConnectResult } from "./client.js";
+type CronWatcherOptions = {
+    session: ConnectResult;
+    onDelivered?: (info: {
+        jobId: string;
+        jobName: string;
+        filePath: string;
+    }) => void;
+    onError?: (message: string) => void;
+};
+export declare function startCronWatcher(options: CronWatcherOptions): () => void;
+export {};
+//# sourceMappingURL=cronWatcher.d.ts.map

package/dist/cronWatcher.d.ts.map

@@ -0,0 +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"}

package/dist/cronWatcher.js

@@ -0,0 +1,165 @@
+import { mkdirSync, readFileSync, readdirSync, statSync, existsSync, writeFileSync } from "node:fs";
+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");
+const HERMES_CRON_JOBS_FILE = join(homedir(), ".hermes", "cron", "jobs.json");
+const DELIVERED_INDEX_PATH = join(homedir(), ".cleos", "cron-delivered.json");
+const POLL_INTERVAL_MS = 5_000;
+const FILE_SETTLE_MS = 750;
+function readDeliveredIndex() {
+    try {
+        const parsed = JSON.parse(readFileSync(DELIVERED_INDEX_PATH, "utf8"));
+        if (!Array.isArray(parsed))
+            return new Set();
+        return new Set(parsed.filter((item) => typeof item === "string"));
+    }
+    catch {
+        return new Set();
+    }
+}
+function writeDeliveredIndex(delivered) {
+    mkdirSync(dirname(DELIVERED_INDEX_PATH), { recursive: true });
+    writeFileSync(DELIVERED_INDEX_PATH, JSON.stringify([...delivered].sort(), null, 2));
+}
+function listCronOutputFiles(rootDir) {
+    if (!existsSync(rootDir))
+        return [];
+    const files = [];
+    for (const jobId of readdirSync(rootDir)) {
+        const jobDir = join(rootDir, jobId);
+        let stat;
+        try {
+            stat = statSync(jobDir);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        for (const fileName of readdirSync(jobDir)) {
+            if (!fileName.endsWith(".md"))
+                continue;
+            files.push(join(jobDir, fileName));
+        }
+    }
+    return files.sort();
+}
+function loadHermesCronJobs() {
+    const names = new Map();
+    if (!existsSync(HERMES_CRON_JOBS_FILE))
+        return names;
+    try {
+        const parsed = JSON.parse(readFileSync(HERMES_CRON_JOBS_FILE, "utf8"));
+        const jobs = Array.isArray(parsed)
+            ? parsed
+            : parsed && typeof parsed === "object" && Array.isArray(parsed.jobs)
+                ? (parsed.jobs ?? [])
+                : [];
+        for (const job of jobs) {
+            if (!job?.id)
+                continue;
+            names.set(job.id, job.name?.trim() || job.id);
+        }
+    }
+    catch {
+        // Ignore malformed jobs file; fall back to job id as name.
+    }
+    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)
+        return undefined;
+    const asNumber = Number(base);
+    if (Number.isFinite(asNumber) && asNumber > 0)
+        return asNumber;
+    const asDate = Date.parse(base);
+    if (Number.isFinite(asDate))
+        return asDate;
+    try {
+        return statSync(filePath).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readFileWhenStable(filePath) {
+    let lastSize = -1;
+    for (let attempt = 0; attempt < 4; attempt += 1) {
+        const content = readFileSync(filePath, "utf8");
+        if (content.length === lastSize) {
+            return content.trim();
+        }
+        lastSize = content.length;
+        await sleep(FILE_SETTLE_MS);
+    }
+    return readFileSync(filePath, "utf8").trim();
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+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)
+                return;
+            try {
+                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,
+                    }));
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                options.onError?.(message);
+                console.error(JSON.stringify({ event: "cleos-bridge.cron-error", message }));
+            }
+        })();
+    };
+    const timer = setInterval(tick, POLL_INTERVAL_MS);
+    tick();
+    return () => {
+        stopped = true;
+        clearInterval(timer);
+    };
+}

package/dist/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,CAAC,CA8BpF"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,CAAC,CAmCpF"}

package/dist/daemon.js

@@ -1,4 +1,5 @@
 import { connectHermesAgent, reconnectHermesAgent } from "./client.js";
+import { startCronWatcher } from "./cronWatcher.js";
 import { createHermesMessageHandler } from "./hermesForwarder.js";
 const RECONNECT_DELAY_MS = 5_000;
 export async function runBridgeDaemon(options = {}) {
@@ -20,7 +21,13 @@ export async function runBridgeDaemon(options = {}) {
                 session = await reconnectHermesAgent({ onUserMessage });
                 console.log(JSON.stringify({ event: "cleos-bridge.connected", agentId: session.agentId, mode: "reconnect" }));
             }
-            await session.closed;
+            const stopCronWatcher = startCronWatcher({ session });
+            try {
+                await session.closed;
+            }
+            finally {
+                stopCronWatcher();
+            }
             session.close();
             console.log(JSON.stringify({ event: "cleos-bridge.disconnected", retryInMs: RECONNECT_DELAY_MS }));
         }

package/dist/hermesForwarder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesForwarder.d.ts","sourceRoot":"","sources":["../src/hermesForwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAkBF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AAqCD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAwEf;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,sBAA2B,IAC/D,SAAS,MAAM,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CAMxF"}
+{"version":3,"file":"hermesForwarder.d.ts","sourceRoot":"","sources":["../src/hermesForwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAyB,eAAe,EAAE,MAAM,aAAa,CAAC;AAGtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAkBF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AA2ED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,sBAA2B,IAC/D,SAAS,MAAM,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC,CAMxF"}

package/dist/hermesForwarder.js

@@ -64,6 +64,32 @@ function extractDeltaFromChunk(payload) {
     const content = delta.content;
     return typeof content === "string" ? content : null;
 }
+function buildHermesUserContent(text, attachments) {
+    const trimmed = text.trim();
+    const imageParts = (attachments ?? [])
+        .filter((attachment) => attachment.mimeType.startsWith("image/") && attachment.url)
+        .map((attachment) => ({
+        type: "image_url",
+        image_url: { url: attachment.url },
+    }));
+    const fileNames = (attachments ?? [])
+        .filter((attachment) => !attachment.mimeType.startsWith("image/"))
+        .map((attachment) => attachment.fileName);
+    let prose = trimmed;
+    if (fileNames.length > 0) {
+        const fileNote = `[Attached files: ${fileNames.join(", ")}]`;
+        prose = prose.length === 0 ? fileNote : `${prose}\n\n${fileNote}`;
+    }
+    if (imageParts.length === 0) {
+        return prose.length === 0 ? "(attachment)" : prose;
+    }
+    const parts = [];
+    if (prose.length > 0) {
+        parts.push({ type: "text", text: prose });
+    }
+    parts.push(...imageParts);
+    return parts;
+}
 export async function forwardToHermes(content, meta, reply, options = {}) {
     const { apiUrl, apiKey, model } = resolveHermesApiConfig(options);
     await ensureHermesReachable(apiUrl, apiKey);
@@ -73,10 +99,11 @@ export async function forwardToHermes(content, meta, reply, options = {}) {
     if (apiKey)
         headers.authorization = `Bearer ${apiKey}`;
     const conversationKey = options.conversationId ?? meta.conversationId;
+    const userContent = buildHermesUserContent(content, meta.attachments);
     const body = {
         model,
         stream: true,
-        messages: [{ role: "user", content }],
+        messages: [{ role: "user", content: userContent }],
         user: conversationKey,
     };
     const response = await fetch(apiUrl, {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { connectHermesAgent, pairCleosAgent, reconnectHermesAgent } from "./client.js";
-export type { AgentReply, ConnectOptions, ConnectResult, UserMessageMeta } from "./client.js";
+export type { AgentReply, ConnectOptions, ConnectResult, CronDeliveryMeta, UserMessageMeta } from "./client.js";
 export { loadCredentials, saveCredentials, credentialsPathForDisplay } from "./credentials.js";
 export type { SavedAgentCredentials } from "./credentials.js";
 export { resolvePairingCode, convexSiteUrlFromEnv } from "./resolve.js";
@@ -7,6 +7,8 @@ export type { PairingInfo } from "./resolve.js";
 export { pairWithCleos } from "./pairWithCleos.js";
 export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } from "./hermesForwarder.js";
 export type { HermesForwarderOptions } from "./hermesForwarder.js";
+export { startCronWatcher } from "./cronWatcher.js";
+export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
 export type { RunBridgeOptions } from "./daemon.js";
 export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, bridgeInstallCommand, } from "./constants.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -3,5 +3,7 @@ export { loadCredentials, saveCredentials, credentialsPathForDisplay } from "./c
 export { resolvePairingCode, convexSiteUrlFromEnv } from "./resolve.js";
 export { pairWithCleos } from "./pairWithCleos.js";
 export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } from "./hermesForwarder.js";
+export { startCronWatcher } from "./cronWatcher.js";
+export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
 export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, bridgeInstallCommand, } from "./constants.js";

package/dist/token.d.ts

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

package/dist/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/token.js

@@ -0,0 +1,4 @@
+import { createHash } from "node:crypto";
+export function hashToken(token) {
+    return createHash("sha256").update(token).digest("hex");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Connect your Hermes agent to the Cleos iOS app via pairing code.",
   "type": "module",
   "license": "MIT",