@saleso.innovations/bridge 0.1.24 → 0.1.26

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":"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"}

package/dist/client.js

@@ -135,7 +135,20 @@ async function handleHermesCommandEnvelope(ws, envelope, fallbackAgentId) {
         status: "accepted",
     }));
     try {
-        const result = await executeHermesCommand(command, parseCommandArgs(envelope.args));
+        const onDelta = command === "shell.exec"
+            ? (stream, delta, deltaSequence) => {
+                ws.send(JSON.stringify({
+                    type: "hermes.command.delta",
+                    requestId,
+                    agentId,
+                    command,
+                    stream,
+                    delta,
+                    sequence: deltaSequence,
+                }));
+            }
+            : undefined;
+        const result = await executeHermesCommand(command, parseCommandArgs(envelope.args), { onDelta });
         ws.send(JSON.stringify({
             type: "hermes.command.result",
             requestId,

package/dist/constants.d.ts

@@ -6,6 +6,10 @@ export declare const DEFAULT_HERMES_API_URL = "http://127.0.0.1:8642/v1/chat/com
 export declare const HERMES_COMMANDS_CAPABILITY = "hermes.commands.v1";
 /** Bridge can resolve auto-generated session titles from ~/.hermes/state.db. */
 export declare const HERMES_SESSION_TITLES_CAPABILITY = "hermes.commands.sessions.titles.v1";
+/** Bridge can list all Hermes sessions from ~/.hermes/state.db (CLI + Cleos + other clients). */
+export declare const HERMES_SESSIONS_LIST_CAPABILITY = "hermes.commands.sessions.list.v1";
+/** Remote shell command execution over relay. */
+export declare const TERMINAL_SHELL_CAPABILITY = "terminal.shell.v1";
 export declare const DEFAULT_BRIDGE_CAPABILITIES: string[];
 /** VPS one-line installer (served from public Convex HTTP). */
 export declare const DEFAULT_BRIDGE_INSTALL_URL = "https://amicable-elephant-407.convex.site/install-bridge.sh";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,8CAA8C,CAAC;AAEzF,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,8CAA8C,CAAC;AAElF,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAE/D,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,uCAAuC,CAAC;AAErF,eAAO,MAAM,2BAA2B,UAIvC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,gEACwB,CAAC;AAEhE,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,+DACwB,CAAC;AAE/D,uGAAuG;AACvG,eAAO,MAAM,mBAAmB,gCAAgC,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,8CAA8C,CAAC;AAEzF,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,8CAA8C,CAAC;AAElF,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAE/D,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,uCAAuC,CAAC;AAErF,iGAAiG;AACjG,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAElF,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAE7D,eAAO,MAAM,2BAA2B,UAMvC,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,gEACwB,CAAC;AAEhE,6DAA6D;AAC7D,eAAO,MAAM,yBAAyB,+DACwB,CAAC;AAE/D,uGAAuG;AACvG,eAAO,MAAM,mBAAmB,gCAAgC,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/constants.js

@@ -6,10 +6,16 @@ export const DEFAULT_HERMES_API_URL = "http://127.0.0.1:8642/v1/chat/completions
 export const HERMES_COMMANDS_CAPABILITY = "hermes.commands.v1";
 /** Bridge can resolve auto-generated session titles from ~/.hermes/state.db. */
 export const HERMES_SESSION_TITLES_CAPABILITY = "hermes.commands.sessions.titles.v1";
+/** Bridge can list all Hermes sessions from ~/.hermes/state.db (CLI + Cleos + other clients). */
+export const HERMES_SESSIONS_LIST_CAPABILITY = "hermes.commands.sessions.list.v1";
+/** Remote shell command execution over relay. */
+export const TERMINAL_SHELL_CAPABILITY = "terminal.shell.v1";
 export const DEFAULT_BRIDGE_CAPABILITIES = [
     "chat",
     HERMES_COMMANDS_CAPABILITY,
     HERMES_SESSION_TITLES_CAPABILITY,
+    HERMES_SESSIONS_LIST_CAPABILITY,
+    TERMINAL_SHELL_CAPABILITY,
 ];
 /** VPS one-line installer (served from public Convex HTTP). */
 export const DEFAULT_BRIDGE_INSTALL_URL = "https://amicable-elephant-407.convex.site/install-bridge.sh";

package/dist/hermesCommands.d.ts

@@ -1,4 +1,5 @@
-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", "sessions.titles.resolve", "skills.list", "files.list", "files.read", "files.write", "memories.list"];
+import { type ShellDeltaEmitter } from "./shellSession.js";
+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", "sessions.titles.resolve", "sessions.list", "skills.list", "files.list", "files.read", "files.write", "memories.list", "shell.exec", "shell.session.reset"];
 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";
@@ -10,6 +11,7 @@ export declare function executeHermesCommand(command: HermesCommandName, args: R
     apiUrl?: string;
     apiKey?: string;
     model?: string;
+    onDelta?: ShellDeltaEmitter;
 }): Promise<unknown>;
 export declare function userSafeCommandError(error: unknown): {
     code: HermesCommandErrorCode;

package/dist/hermesCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,oBAAoB,ujBAiCvB,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;AA6GD,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,CAyMlB;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":"AAiBA,OAAO,EAAuC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGhG,eAAO,MAAM,oBAAoB,6mBAoCvB,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;AA6GD,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,CAAC;IAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAC9F,OAAO,CAAC,OAAO,CAAC,CAsNlB;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,11 @@
 import { resolveHermesApiConfig } from "./hermesForwarder.js";
 import { restartHermesGateway, startHermesGateway, stopHermesGateway } from "./gatewayControl.js";
 import { listHermesCronJobs } from "./cronList.js";
-import { listSessionMessages, countUserMessagesSent, resolveSessionTitles } from "./hermesSessionDb.js";
+import { listHermesSessions, listSessionMessages, countUserMessagesSent, resolveSessionTitles, } from "./hermesSessionDb.js";
 import { listHermesSkills } from "./skillsList.js";
 import { runHermesUpdate } from "./hermesUpdate.js";
 import { executeFilesList, executeFilesRead, executeFilesWrite, executeMemoriesList, } from "./hermesFileCommands.js";
+import { executeShellExec, resetShellSession } from "./shellSession.js";
 import { fetchHermesRuntimeVersion } from "./runtimeVersion.js";
 export const HERMES_COMMAND_NAMES = [
     "runtime.health",
@@ -34,11 +35,14 @@ export const HERMES_COMMAND_NAMES = [
     "sessions.messages.list",
     "sessions.messages.countSent",
     "sessions.titles.resolve",
+    "sessions.list",
     "skills.list",
     "files.list",
     "files.read",
     "files.write",
     "memories.list",
+    "shell.exec",
+    "shell.session.reset",
 ];
 export function isHermesCommandName(value) {
     return HERMES_COMMAND_NAMES.includes(value);
@@ -139,6 +143,7 @@ async function hermesFetchVoid(config, path, init = {}) {
 }
 export async function executeHermesCommand(command, args, options = {}) {
     const config = resolveHermesApiConfig(options);
+    const { onDelta } = options;
     switch (command) {
         case "runtime.health":
             return await hermesFetchJson(config, "/health");
@@ -306,6 +311,10 @@ export async function executeHermesCommand(command, args, options = {}) {
             const sessionIds = optionalStringArray(args, "sessionIds") ?? [];
             return { titles: resolveSessionTitles(sessionIds) };
         }
+        case "sessions.list": {
+            const limit = optionalNumber(args, "limit");
+            return { sessions: listHermesSessions({ limit: limit ?? 200 }) };
+        }
         case "skills.list":
             return await listHermesSkills();
         case "files.list":
@@ -330,6 +339,14 @@ export async function executeHermesCommand(command, args, options = {}) {
         }
         case "memories.list":
             return await executeMemoriesList();
+        case "shell.exec": {
+            if (!onDelta) {
+                throw new HermesCommandError("invalid_command_args", "shell.exec requires streaming support");
+            }
+            return await executeShellExec(args, onDelta);
+        }
+        case "shell.session.reset":
+            return resetShellSession(requireString(args, "sessionId"));
         default: {
             const _exhaustive = command;
             throw new HermesCommandError("command_unsupported", `Unsupported command: ${String(_exhaustive)}`);

package/dist/hermesSessionDb.d.ts

@@ -16,6 +16,17 @@ export declare function getLatestTurnMessageIds(sessionId: string): {
     userMessageId?: number;
     assistantMessageId?: number;
 };
+export type HermesSessionListEntry = {
+    id: string;
+    title: string | null;
+    startedAt: number;
+    lastMessageAt: number;
+    previewText: string;
+    messageCount: number;
+};
+export declare function listHermesSessions(options?: {
+    limit?: number;
+}): HermesSessionListEntry[];
 export declare function hermesStateDbExists(): boolean;
 export declare function countUserMessagesSent(): {
     count: number;

package/dist/hermesSessionDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesSessionDb.d.ts","sourceRoot":"","sources":["../src/hermesSessionDb.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAqHF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAapE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAuBxF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACxE,oBAAoB,EAAE,CAwCxB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCzD;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,qBAAqB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBzD"}
+{"version":3,"file":"hermesSessionDb.d.ts","sourceRoot":"","sources":["../src/hermesSessionDb.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAyIF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAapE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAuBxF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACxE,oBAAoB,EAAE,CAwCxB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCzD;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,sBAAsB,EAAE,CAyD7F;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,qBAAqB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBzD"}

package/dist/hermesSessionDb.js

@@ -93,13 +93,29 @@ function sessionTitleFromChain(db, sessionId) {
     }
     return null;
 }
+function sessionTitleFromFirstUserMessage(db, sessionId) {
+    const resolved = resolveResumeSessionId(db, sessionId);
+    const chain = sessionAncestorChain(db, resolved);
+    const placeholders = chain.map(() => "?").join(", ");
+    const row = db
+        .prepare(`SELECT content FROM messages
+       WHERE session_id IN (${placeholders}) AND role = 'user'
+       ORDER BY timestamp ASC, id ASC
+       LIMIT 1`)
+        .get(...chain);
+    const snippet = decodeMessageContent(row?.content ?? null).trim().slice(0, 120);
+    return snippet || null;
+}
+function sessionTitleForLookupId(db, sessionId) {
+    return sessionTitleFromChain(db, sessionId) ?? sessionTitleFromFirstUserMessage(db, sessionId);
+}
 export function resolveSessionTitle(sessionId) {
     if (!sessionId.trim() || !hermesStateDbExists()) {
         return null;
     }
     const db = openReadOnlyDb();
     try {
-        return sessionTitleFromChain(db, sessionId);
+        return sessionTitleForLookupId(db, sessionId);
     }
     catch {
         return null;
@@ -120,7 +136,7 @@ export function resolveSessionTitles(sessionIds) {
     const db = openReadOnlyDb();
     try {
         for (const sessionId of uniqueIds) {
-            titles[sessionId] = sessionTitleFromChain(db, sessionId);
+            titles[sessionId] = sessionTitleForLookupId(db, sessionId);
         }
     }
     catch {
@@ -197,6 +213,55 @@ export function getLatestTurnMessageIds(sessionId) {
         db.close();
     }
 }
+function normalizeTimestampMs(value) {
+    return value < 1_000_000_000_000 ? value * 1000 : value;
+}
+export function listHermesSessions(options = {}) {
+    if (!hermesStateDbExists()) {
+        return [];
+    }
+    const limit = Math.min(Math.max(options.limit ?? 200, 1), 500);
+    const db = openReadOnlyDb();
+    try {
+        const rows = db
+            .prepare(`SELECT
+           s.id AS id,
+           s.title AS title,
+           s.started_at AS started_at,
+           MAX(m.timestamp) AS last_message_at,
+           COUNT(m.id) AS message_count
+         FROM sessions s
+         INNER JOIN messages m ON m.session_id = s.id AND m.role IN ('user', 'assistant')
+         GROUP BY s.id
+         ORDER BY last_message_at DESC
+         LIMIT ?`)
+            .all(limit);
+        return rows.map((row) => {
+            const previewRow = db
+                .prepare(`SELECT content FROM messages
+           WHERE session_id = ? AND role IN ('user', 'assistant')
+           ORDER BY timestamp DESC, id DESC
+           LIMIT 1`)
+                .get(row.id);
+            const resolvedTitle = sessionTitleForLookupId(db, row.id);
+            const previewText = decodeMessageContent(previewRow?.content ?? null).trim().slice(0, 120);
+            return {
+                id: row.id,
+                title: resolvedTitle ?? row.title?.trim() ?? null,
+                startedAt: normalizeTimestampMs(row.started_at ?? row.last_message_at),
+                lastMessageAt: normalizeTimestampMs(row.last_message_at),
+                previewText,
+                messageCount: row.message_count,
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+    finally {
+        db.close();
+    }
+}
 export function hermesStateDbExists() {
     try {
         readFileSync(hermesStateDbPath());

package/dist/index.d.ts

@@ -7,7 +7,8 @@ export type { PairingInfo } from "./resolve.js";
 export { pairWithCleos } from "./pairWithCleos.js";
 export { createHermesMessageHandler, forwardToHermes, resolveHermesApiConfig } from "./hermesForwarder.js";
 export type { HermesForwarderOptions, HermesForwardResult } from "./hermesForwarder.js";
-export { listSessionMessages, resolveSessionTitle, resolveSessionTitles } from "./hermesSessionDb.js";
+export { listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
+export type { HermesSessionListEntry } from "./hermesSessionDb.js";
 export type { HermesSessionMessage } from "./hermesSessionDb.js";
 export { executeHermesCommand, HERMES_COMMAND_NAMES, isHermesCommandName, userSafeCommandError, } from "./hermesCommands.js";
 export type { HermesCommandErrorCode, HermesCommandName } from "./hermesCommands.js";
@@ -16,5 +17,5 @@ export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfil
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
 export type { RunBridgeOptions } from "./daemon.js";
-export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
+export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, HERMES_SESSIONS_LIST_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
 //# sourceMappingURL=index.d.ts.map

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,EACV,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,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,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtG,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACtF,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,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,oBAAoB,EACpB,mBAAmB,GACpB,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,EACV,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,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,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACtF,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,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -3,10 +3,10 @@ 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 { listSessionMessages, resolveSessionTitle, resolveSessionTitles } from "./hermesSessionDb.js";
+export { listHermesSessions, listSessionMessages, resolveSessionTitle, resolveSessionTitles, } from "./hermesSessionDb.js";
 export { executeHermesCommand, HERMES_COMMAND_NAMES, isHermesCommandName, userSafeCommandError, } from "./hermesCommands.js";
 export { startCronWatcher, listPendingCronFiles, clearDeliveredIndex } from "./cronWatcher.js";
 export { backfillCronDeliveries, describeCronDeliveryState } from "./cronBackfill.js";
 export { resolveActiveConversationId, rememberConversationId } from "./activeConversation.js";
 export { runBridgeDaemon } from "./daemon.js";
-export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";
+export { DEFAULT_BRIDGE_INSTALL_URL, DEFAULT_BRIDGE_UPDATE_URL, DEFAULT_CLEOS_CONVEX_SITE_URL, DEFAULT_HERMES_API_URL, DEFAULT_BRIDGE_CAPABILITIES, HERMES_COMMANDS_CAPABILITY, HERMES_SESSION_TITLES_CAPABILITY, HERMES_SESSIONS_LIST_CAPABILITY, bridgeInstallCommand, bridgeUpdateCommand, } from "./constants.js";

package/dist/shellSession.d.ts

@@ -0,0 +1,21 @@
+export declare const EXIT_SENTINEL_PREFIX = "__CLEOS_EXIT_";
+export declare const EXIT_SENTINEL_SUFFIX = "__";
+export declare const MAX_OUTPUT_BYTES: number;
+export declare const DEFAULT_COMMAND_TIMEOUT_MS = 120000;
+export type ShellDeltaEmitter = (stream: "stdout" | "stderr", delta: string, sequence: number) => void;
+export type ParsedShellFooter = {
+    output: string;
+    exitCode: number;
+    cwd: string;
+};
+export declare function buildWrappedCommand(userCommand: string): string;
+export declare function parseShellFooter(raw: string): ParsedShellFooter | null;
+export declare function executeShellExec(args: Record<string, unknown>, onDelta: ShellDeltaEmitter, timeoutMs?: number): Promise<{
+    exitCode: number;
+    sessionId: string;
+}>;
+export declare function resetShellSession(sessionId: string): {
+    sessionId: string;
+};
+export declare function clearShellSessionsForTests(): void;
+//# sourceMappingURL=shellSession.d.ts.map

package/dist/shellSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellSession.d.ts","sourceRoot":"","sources":["../src/shellSession.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,gBAAgB,QAAa,CAAC;AAC3C,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAGlD,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAmBF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAWtE;AAmJD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,iBAAiB,EAC1B,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAwClD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAU1E;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAOjD"}

package/dist/shellSession.js

@@ -0,0 +1,210 @@
+import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+export const EXIT_SENTINEL_PREFIX = "__CLEOS_EXIT_";
+export const EXIT_SENTINEL_SUFFIX = "__";
+export const MAX_OUTPUT_BYTES = 512 * 1024;
+export const DEFAULT_COMMAND_TIMEOUT_MS = 120_000;
+const SENTINEL_TAIL_RESERVE = 64;
+const sessions = new Map();
+export function buildWrappedCommand(userCommand) {
+    const encoded = Buffer.from(userCommand, "utf8").toString("base64");
+    return `{ eval "$(printf '%s' '${encoded}' | base64 -d)"; ec=$?; echo "${EXIT_SENTINEL_PREFIX}\${ec}${EXIT_SENTINEL_SUFFIX}"; pwd; } 2>&1\n`;
+}
+export function parseShellFooter(raw) {
+    const pattern = new RegExp(`\\n${EXIT_SENTINEL_PREFIX}(\\d+)${EXIT_SENTINEL_SUFFIX}\\n([^\\n]*)\\n?$`);
+    const match = raw.match(pattern);
+    if (!match || match.index === undefined)
+        return null;
+    return {
+        output: raw.slice(0, match.index),
+        exitCode: Number.parseInt(match[1] ?? "0", 10),
+        cwd: match[2] ?? "",
+    };
+}
+function truncateNotice() {
+    return `\n[output truncated at ${MAX_OUTPUT_BYTES} bytes]\n`;
+}
+function emitDelta(session, delta) {
+    if (!delta || !session.pendingOnDelta)
+        return;
+    session.pendingSequence += 1;
+    session.pendingOnDelta("stdout", delta, session.pendingSequence);
+}
+function flushStreamableOutput(session) {
+    const footer = parseShellFooter(session.pendingBuffer);
+    if (footer) {
+        const newOutput = footer.output.slice(session.streamedLength);
+        emitDelta(session, newOutput);
+        session.streamedLength = footer.output.length;
+        return;
+    }
+    const reserveStart = Math.max(0, session.pendingBuffer.length - SENTINEL_TAIL_RESERVE);
+    const streamableEnd = reserveStart;
+    if (streamableEnd > session.streamedLength) {
+        emitDelta(session, session.pendingBuffer.slice(session.streamedLength, streamableEnd));
+        session.streamedLength = streamableEnd;
+    }
+}
+function finishPending(session, footer) {
+    if (session.pendingTimeout) {
+        clearTimeout(session.pendingTimeout);
+        session.pendingTimeout = null;
+    }
+    const resolve = session.pendingResolve;
+    session.pendingResolve = null;
+    session.pendingReject = null;
+    session.pendingOnDelta = null;
+    session.pendingBuffer = "";
+    session.streamedLength = 0;
+    session.pendingBytes = 0;
+    session.pendingTruncated = false;
+    session.busy = false;
+    if (footer.cwd)
+        session.cwd = footer.cwd;
+    resolve?.(footer);
+}
+function failPending(session, error) {
+    if (session.pendingTimeout) {
+        clearTimeout(session.pendingTimeout);
+        session.pendingTimeout = null;
+    }
+    const reject = session.pendingReject;
+    session.pendingResolve = null;
+    session.pendingReject = null;
+    session.pendingOnDelta = null;
+    session.pendingBuffer = "";
+    session.streamedLength = 0;
+    session.pendingBytes = 0;
+    session.pendingTruncated = false;
+    session.busy = false;
+    reject?.(error);
+}
+function appendPendingData(session, chunk) {
+    session.pendingBytes += Buffer.byteLength(chunk, "utf8");
+    if (session.pendingBytes > MAX_OUTPUT_BYTES) {
+        if (!session.pendingTruncated) {
+            session.pendingTruncated = true;
+            const allowed = MAX_OUTPUT_BYTES - Buffer.byteLength(truncateNotice(), "utf8");
+            const currentBytes = Buffer.byteLength(session.pendingBuffer, "utf8");
+            if (currentBytes > allowed) {
+                session.pendingBuffer = Buffer.from(session.pendingBuffer, "utf8")
+                    .subarray(0, allowed)
+                    .toString("utf8");
+            }
+            session.pendingBuffer += truncateNotice();
+            flushStreamableOutput(session);
+        }
+        return;
+    }
+    session.pendingBuffer += chunk;
+    flushStreamableOutput(session);
+    const footer = parseShellFooter(session.pendingBuffer);
+    if (footer) {
+        finishPending(session, footer);
+    }
+}
+function attachSessionHandlers(sessionId, session) {
+    session.process.stdout.on("data", (data) => {
+        appendPendingData(session, data.toString("utf8"));
+    });
+    session.process.stderr.on("data", (data) => {
+        if (session.pendingOnDelta && session.busy) {
+            session.pendingSequence += 1;
+            session.pendingOnDelta("stderr", data.toString("utf8"), session.pendingSequence);
+        }
+    });
+    session.process.on("exit", () => {
+        sessions.delete(sessionId);
+        if (session.busy) {
+            failPending(session, new Error("Shell session exited unexpectedly"));
+        }
+    });
+}
+function createSession(sessionId) {
+    const child = spawn("bash", ["--login"], {
+        cwd: homedir(),
+        env: process.env,
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    const session = {
+        process: child,
+        cwd: homedir(),
+        busy: false,
+        pendingBuffer: "",
+        pendingResolve: null,
+        pendingReject: null,
+        pendingTimeout: null,
+        pendingSequence: 0,
+        pendingBytes: 0,
+        pendingTruncated: false,
+        pendingOnDelta: null,
+        streamedLength: 0,
+    };
+    attachSessionHandlers(sessionId, session);
+    sessions.set(sessionId, session);
+    return session;
+}
+function getOrCreateSession(sessionId) {
+    const existing = sessions.get(sessionId);
+    if (existing && existing.process.exitCode === null && !existing.process.killed) {
+        return existing;
+    }
+    if (existing)
+        sessions.delete(sessionId);
+    return createSession(sessionId);
+}
+export async function executeShellExec(args, onDelta, timeoutMs = DEFAULT_COMMAND_TIMEOUT_MS) {
+    const command = args.command;
+    const sessionIdRaw = args.sessionId;
+    if (typeof command !== "string" || command.trim().length === 0) {
+        throw new Error('Missing "command"');
+    }
+    if (typeof sessionIdRaw !== "string" || sessionIdRaw.trim().length === 0) {
+        throw new Error('Missing "sessionId"');
+    }
+    const sessionId = sessionIdRaw.trim();
+    const session = getOrCreateSession(sessionId);
+    if (session.busy) {
+        throw new Error("Shell session is busy");
+    }
+    session.busy = true;
+    session.pendingBuffer = "";
+    session.streamedLength = 0;
+    session.pendingBytes = 0;
+    session.pendingTruncated = false;
+    session.pendingSequence = 0;
+    session.pendingOnDelta = onDelta;
+    const wrapped = buildWrappedCommand(command);
+    return await new Promise((resolve, reject) => {
+        session.pendingResolve = (footer) => {
+            resolve({ exitCode: footer.exitCode, sessionId });
+        };
+        session.pendingReject = reject;
+        session.pendingTimeout = setTimeout(() => {
+            failPending(session, new Error(`Command timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        const wrote = session.process.stdin.write(wrapped);
+        if (!wrote) {
+            session.process.stdin.once("drain", () => undefined);
+        }
+    });
+}
+export function resetShellSession(sessionId) {
+    const existing = sessions.get(sessionId);
+    if (existing) {
+        if (existing.busy) {
+            throw new Error("Shell session is busy");
+        }
+        existing.process.kill("SIGTERM");
+        sessions.delete(sessionId);
+    }
+    return { sessionId };
+}
+export function clearShellSessionsForTests() {
+    for (const [sessionId, session] of sessions.entries()) {
+        if (!session.busy) {
+            session.process.kill("SIGTERM");
+        }
+        sessions.delete(sessionId);
+    }
+}

package/dist/shellSession.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shellSession.test.d.ts.map

package/dist/shellSession.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellSession.test.d.ts","sourceRoot":"","sources":["../src/shellSession.test.ts"],"names":[],"mappings":""}

package/dist/shellSession.test.js

@@ -0,0 +1,27 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { buildWrappedCommand, parseShellFooter, EXIT_SENTINEL_PREFIX, EXIT_SENTINEL_SUFFIX, } from "./shellSession.js";
+test("parseShellFooter extracts output, exit code, and cwd", () => {
+    const raw = "line one\nline two\n" + `${EXIT_SENTINEL_PREFIX}1${EXIT_SENTINEL_SUFFIX}\n/tmp\n`;
+    const parsed = parseShellFooter(raw);
+    assert.ok(parsed);
+    assert.equal(parsed.output, "line one\nline two");
+    assert.equal(parsed.exitCode, 1);
+    assert.equal(parsed.cwd, "/tmp");
+});
+test("parseShellFooter returns null when sentinel is missing", () => {
+    assert.equal(parseShellFooter("hello\nworld\n"), null);
+});
+test("parseShellFooter handles exit code zero", () => {
+    const raw = "ok\n" + `${EXIT_SENTINEL_PREFIX}0${EXIT_SENTINEL_SUFFIX}\n/home/user\n`;
+    const parsed = parseShellFooter(raw);
+    assert.ok(parsed);
+    assert.equal(parsed.exitCode, 0);
+    assert.equal(parsed.cwd, "/home/user");
+});
+test("buildWrappedCommand base64-encodes user input", () => {
+    const wrapped = buildWrappedCommand("echo hello");
+    assert.match(wrapped, /base64 -d/);
+    assert.match(wrapped, new RegExp(`${EXIT_SENTINEL_PREFIX}\\$\\{ec\\}${EXIT_SENTINEL_SUFFIX}`));
+    assert.match(wrapped, /pwd/);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Connect your Hermes agent to the Cleos iOS app via pairing code.",
   "type": "module",
   "license": "MIT",
@@ -36,7 +36,7 @@
     "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
     "prepublishOnly": "npm run build",
-    "test": "node --import tsx --test src/hermesFiles.test.ts"
+    "test": "node --import tsx --test src/hermesFiles.test.ts src/shellSession.test.ts"
   },
   "dependencies": {
     "better-sqlite3": "^11.10.0",