@saleso.innovations/bridge 0.1.22 → 0.1.23

package/dist/hermesCommands.d.ts

@@ -1,4 +1,4 @@
-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 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", "files.write", "memories.list"];
 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":"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"}
+{"version":3,"file":"hermesCommands.d.ts","sourceRoot":"","sources":["../src/hermesCommands.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,oBAAoB,4hBAgCvB,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,CAqMlB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAetG"}

package/dist/hermesCommands.js

@@ -4,7 +4,7 @@ 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 { executeFilesList, executeFilesRead, executeFilesWrite, executeMemoriesList, } from "./hermesFileCommands.js";
 import { fetchHermesRuntimeVersion } from "./runtimeVersion.js";
 export const HERMES_COMMAND_NAMES = [
     "runtime.health",
@@ -36,6 +36,8 @@ export const HERMES_COMMAND_NAMES = [
     "skills.list",
     "files.list",
     "files.read",
+    "files.write",
+    "memories.list",
 ];
 export function isHermesCommandName(value) {
     return HERMES_COMMAND_NAMES.includes(value);
@@ -297,6 +299,19 @@ export async function executeHermesCommand(command, args, options = {}) {
             }
             return await executeFilesRead({ ...args, path });
         }
+        case "files.write": {
+            const path = optionalString(args, "path");
+            if (!path) {
+                throw new HermesCommandError("invalid_command_args", 'Missing "path"');
+            }
+            const content = args.content;
+            if (typeof content !== "string") {
+                throw new HermesCommandError("invalid_command_args", 'Missing "content"');
+            }
+            return await executeFilesWrite({ path, content });
+        }
+        case "memories.list":
+            return await executeMemoriesList();
         default: {
             const _exhaustive = command;
             throw new HermesCommandError("command_unsupported", `Unsupported command: ${String(_exhaustive)}`);

package/dist/hermesCronJobs.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveHermesHomeForCron(): string;
+export declare function hermesCronJobsFilePath(home?: string): string;
+export declare function loadHermesCronJobNames(home?: string): Map<string, string>;
+//# sourceMappingURL=hermesCronJobs.d.ts.map

package/dist/hermesCronJobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermesCronJobs.d.ts","sourceRoot":"","sources":["../src/hermesCronJobs.ts"],"names":[],"mappings":"AASA,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,MAAmC,GAAG,MAAM,CAExF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,MAAmC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBrG"}

package/dist/hermesCronJobs.js

@@ -0,0 +1,32 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function resolveHermesHomeForCron() {
+    return process.env.HERMES_HOME?.trim() || join(homedir(), ".hermes");
+}
+export function hermesCronJobsFilePath(home = resolveHermesHomeForCron()) {
+    return join(home, "cron", "jobs.json");
+}
+export function loadHermesCronJobNames(home = resolveHermesHomeForCron()) {
+    const names = new Map();
+    const jobsFile = hermesCronJobsFilePath(home);
+    if (!existsSync(jobsFile))
+        return names;
+    try {
+        const parsed = JSON.parse(readFileSync(jobsFile, "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;
+}

package/dist/hermesFileCommands.d.ts

@@ -1,6 +1,14 @@
 export declare function executeFilesList(args: Record<string, unknown>): Promise<{
     files: import("./hermesFiles.js").HermesFileEntry[];
 }>;
+export declare function executeFilesWrite(args: Record<string, unknown>): Promise<{
+    ok: true;
+    relativePath: string;
+    size: number;
+}>;
+export declare function executeMemoriesList(): Promise<{
+    files: import("./hermesFiles.js").HermesFileEntry[];
+}>;
 export declare function executeFilesRead(args: Record<string, unknown>): Promise<{
     fileName: string;
     mimeType: string;

package/dist/hermesFileCommands.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"hermesFileCommands.d.ts","sourceRoot":"","sources":["../src/hermesFileCommands.ts"],"names":[],"mappings":"AA+BA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAKnE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;GAUpE;AAED,wBAAsB,mBAAmB;;GAExC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;GAkCnE"}

package/dist/hermesFileCommands.js

@@ -1,4 +1,4 @@
-import { DEFAULT_FILES_READ_MAX_BYTES, listHermesFiles, readHermesFileBytes, } from "./hermesFiles.js";
+import { DEFAULT_FILES_READ_MAX_BYTES, listHermesFiles, listHermesMemoryFiles, readHermesFileBytes, writeHermesFile, } from "./hermesFiles.js";
 import { uploadFileToConvex } from "./convexRelay.js";
 import { loadCredentials } from "./credentials.js";
 function optionalNumber(args, key) {
@@ -28,6 +28,20 @@ export async function executeFilesList(args) {
     const category = optionalCategory(args);
     return listHermesFiles({ limit, offset, category });
 }
+export async function executeFilesWrite(args) {
+    const path = typeof args.path === "string" ? args.path.trim() : "";
+    if (!path) {
+        throw new Error('Missing "path"');
+    }
+    const content = typeof args.content === "string" ? args.content : undefined;
+    if (content === undefined) {
+        throw new Error('Missing "content"');
+    }
+    return writeHermesFile(path, content);
+}
+export async function executeMemoriesList() {
+    return listHermesMemoryFiles();
+}
 export async function executeFilesRead(args) {
     const path = typeof args.path === "string" ? args.path.trim() : "";
     const maxBytes = optionalNumber(args, "maxBytes") ?? DEFAULT_FILES_READ_MAX_BYTES;

package/dist/hermesFiles.d.ts

@@ -1,6 +1,13 @@
 export declare const MAX_RELAY_UPLOAD_BYTES: number;
 export declare const DEFAULT_FILES_READ_MAX_BYTES: number;
+export declare const SOUL_RELATIVE_PATH = "SOUL.md";
+export declare const MEMORIES_DIR = "memories";
+export declare const MEMORY_MD_RELATIVE_PATH = "memories/MEMORY.md";
+export declare const USER_MD_RELATIVE_PATH = "memories/USER.md";
+export declare const MEMORY_MD_CHAR_LIMIT = 2200;
+export declare const USER_MD_CHAR_LIMIT = 1375;
 export type HermesFileCategory = "image" | "video" | "document" | "other";
+export type HermesFileSource = "cron" | "artifact";
 export type HermesFileEntry = {
     relativePath: string;
     fileName: string;
@@ -8,7 +15,12 @@ export type HermesFileEntry = {
     mtime: number;
     mimeType: string;
     category: HermesFileCategory;
+    source?: HermesFileSource;
+    sourceKey?: string;
+    hermesJobId?: string;
+    hermesJobName?: string;
 };
+export declare function cronOutputSourceKey(relativePath: string): string | undefined;
 export type HermesFileReadResult = {
     fileName: string;
     mimeType: string;
@@ -37,6 +49,16 @@ export declare function listHermesFiles(options?: {
 }): {
     files: HermesFileEntry[];
 };
+export declare function normalizeHermesRelativePath(inputPath: string): string;
+export declare function assertWritableHermesPath(inputPath: string): string;
+export declare function writeHermesFile(inputPath: string, content: string): {
+    ok: true;
+    relativePath: string;
+    size: number;
+};
+export declare function listHermesMemoryFiles(): {
+    files: HermesFileEntry[];
+};
 export declare function readHermesFileBytes(inputPath: string): {
     bytes: Buffer;
     mimeType: string;

package/dist/hermesFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermesFiles.d.ts","sourceRoot":"","sources":["../src/hermesFiles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AACvD,eAAO,MAAM,4BAA4B,QAAa,CAAC;AAgCvD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCtD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAMlE;AAQD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAe9D;AA8DD,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAClC,GAAG;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAepC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAe1H;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CA6BnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,CAMjF;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtJ;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CASzJ"}
+{"version":3,"file":"hermesFiles.d.ts","sourceRoot":"","sources":["../src/hermesFiles.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AACvD,eAAO,MAAM,4BAA4B,QAAa,CAAC;AAEvD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAkCvC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAIF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCtD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAMlE;AAqCD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAc9D;AA4FD,wBAAgB,eAAe,CAAC,OAAO,GAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAClC,GAAG;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAgBpC;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAwBlE;AAQD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkBlD;AA6BD,wBAAgB,qBAAqB,IAAI;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAqBpE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAe1H;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CA6BnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,CAMjF;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtJ;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CASzJ"}

package/dist/hermesFiles.js

@@ -1,8 +1,16 @@
-import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, statSync, writeFileSync, } from "node:fs";
 import { homedir } from "node:os";
-import { basename, join, relative, resolve, sep } from "node:path";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { loadHermesCronJobNames } from "./hermesCronJobs.js";
 export const MAX_RELAY_UPLOAD_BYTES = 25 * 1024 * 1024;
 export const DEFAULT_FILES_READ_MAX_BYTES = 512 * 1024;
+export const SOUL_RELATIVE_PATH = "SOUL.md";
+export const MEMORIES_DIR = "memories";
+export const MEMORY_MD_RELATIVE_PATH = "memories/MEMORY.md";
+export const USER_MD_RELATIVE_PATH = "memories/USER.md";
+export const MEMORY_MD_CHAR_LIMIT = 2200;
+export const USER_MD_CHAR_LIMIT = 1375;
+const KNOWN_MEMORY_FILES = ["MEMORY.md", "USER.md"];
 const HIDDEN_DIR_NAMES = new Set([".git", ".hub"]);
 const IMAGE_EXTENSIONS = new Set(["png", "jpg", "jpeg", "gif", "webp", "bmp", "tiff", "svg"]);
 const VIDEO_EXTENSIONS = new Set(["mp4", "mov", "webm", "mkv", "avi"]);
@@ -31,6 +39,13 @@ const DOCUMENT_EXTENSIONS = new Set([
     "bz2",
     "epub",
 ]);
+const CRON_OUTPUT_PREFIX = "cron/output/";
+export function cronOutputSourceKey(relativePath) {
+    if (!relativePath.startsWith(CRON_OUTPUT_PREFIX))
+        return undefined;
+    const key = relativePath.slice(CRON_OUTPUT_PREFIX.length);
+    return key.length > 0 ? key : undefined;
+}
 export function resolveHermesHome() {
     return process.env.HERMES_HOME?.trim() || join(homedir(), ".hermes");
 }
@@ -78,27 +93,57 @@ export function inferCategory(fileName) {
         return "document";
     return "other";
 }
+function normalizePathForSandbox(root, candidate) {
+    let normalizedRoot = resolve(root);
+    let normalizedCandidate = resolve(candidate);
+    try {
+        if (existsSync(normalizedRoot)) {
+            normalizedRoot = realpathSync(normalizedRoot);
+        }
+    }
+    catch {
+        // Keep resolved path.
+    }
+    try {
+        if (existsSync(normalizedCandidate)) {
+            normalizedCandidate = realpathSync(normalizedCandidate);
+        }
+        else {
+            let parent = normalizedCandidate;
+            while (parent !== dirname(parent)) {
+                parent = dirname(parent);
+                if (existsSync(parent)) {
+                    const resolvedParent = realpathSync(parent);
+                    normalizedCandidate = join(resolvedParent, relative(parent, normalizedCandidate));
+                    break;
+                }
+            }
+        }
+    }
+    catch {
+        // Keep resolved path.
+    }
+    return { root: normalizedRoot, candidate: normalizedCandidate };
+}
 function isPathInsideRoot(root, candidate) {
-    const normalizedRoot = resolve(root);
-    const normalizedCandidate = resolve(candidate);
+    const { root: normalizedRoot, candidate: normalizedCandidate } = normalizePathForSandbox(root, candidate);
     return normalizedCandidate === normalizedRoot || normalizedCandidate.startsWith(`${normalizedRoot}${sep}`);
 }
 export function resolveSandboxedPath(inputPath) {
     const home = resolveHermesHome();
     const candidate = inputPath.startsWith("/") ? resolve(inputPath) : resolve(home, inputPath);
-    let resolved = candidate;
+    if (!isPathInsideRoot(home, candidate)) {
+        throw new Error(`Path is outside Hermes home: ${inputPath}`);
+    }
     try {
         if (existsSync(candidate)) {
-            resolved = realpathSync(candidate);
+            return realpathSync(candidate);
         }
     }
     catch {
         // Fall back to unresolved candidate for not-yet-existing paths.
     }
-    if (!isPathInsideRoot(home, resolved)) {
-        throw new Error(`Path is outside Hermes home: ${inputPath}`);
-    }
-    return resolved;
+    return candidate;
 }
 function artifactScanRoots(home) {
     const roots = [];
@@ -107,6 +152,7 @@ function artifactScanRoots(home) {
         join(home, "cache", "documents"),
         join(home, "cache", "remote-syncs"),
         join(home, "browser_recordings"),
+        join(home, "cron", "output"),
     ];
     for (const dir of direct) {
         if (existsSync(dir))
@@ -124,7 +170,22 @@ function artifactScanRoots(home) {
     }
     return roots;
 }
-function walkFiles(rootDir, home, files) {
+function attachSourceMetadata(entry, jobNames) {
+    const sourceKey = cronOutputSourceKey(entry.relativePath);
+    if (!sourceKey) {
+        return { ...entry, source: "artifact" };
+    }
+    const hermesJobId = sourceKey.split("/")[0] ?? undefined;
+    const hermesJobName = hermesJobId ? jobNames.get(hermesJobId) ?? hermesJobId : undefined;
+    return {
+        ...entry,
+        source: "cron",
+        sourceKey,
+        hermesJobId,
+        hermesJobName,
+    };
+}
+function walkFiles(rootDir, home, files, jobNames) {
     let names;
     try {
         names = readdirSync(rootDir);
@@ -144,7 +205,7 @@ function walkFiles(rootDir, home, files) {
             continue;
         }
         if (stats.isDirectory()) {
-            walkFiles(fullPath, home, files);
+            walkFiles(fullPath, home, files, jobNames);
             continue;
         }
         if (!stats.isFile())
@@ -152,14 +213,15 @@ function walkFiles(rootDir, home, files) {
         const relativePath = relative(home, fullPath).replace(/\\/g, "/");
         const fileName = basename(fullPath);
         const mimeType = inferMimeType(fileName);
-        files.push({
+        const entry = attachSourceMetadata({
             relativePath,
             fileName,
             size: stats.size,
             mtime: stats.mtimeMs,
             mimeType,
             category: inferCategory(fileName),
-        });
+        }, jobNames);
+        files.push(entry);
     }
 }
 export function listHermesFiles(options = {}) {
@@ -167,14 +229,109 @@ export function listHermesFiles(options = {}) {
     const limit = options.limit ?? 200;
     const offset = options.offset ?? 0;
     const category = options.category ?? "all";
+    const jobNames = loadHermesCronJobNames(home);
     const all = [];
     for (const root of artifactScanRoots(home)) {
-        walkFiles(root, home, all);
+        walkFiles(root, home, all, jobNames);
     }
     const filtered = category === "all" ? all : all.filter((file) => file.category === category);
     filtered.sort((left, right) => right.mtime - left.mtime);
     return { files: filtered.slice(offset, offset + limit) };
 }
+export function normalizeHermesRelativePath(inputPath) {
+    return inputPath.trim().replace(/\\/g, "/").replace(/^\/+/, "");
+}
+export function assertWritableHermesPath(inputPath) {
+    const relativePath = normalizeHermesRelativePath(inputPath);
+    if (!relativePath) {
+        throw new Error("Path is required");
+    }
+    if (relativePath === SOUL_RELATIVE_PATH) {
+        return relativePath;
+    }
+    const memoriesPrefix = `${MEMORIES_DIR}/`;
+    if (!relativePath.startsWith(memoriesPrefix)) {
+        throw new Error(`Path is not writable: ${inputPath}`);
+    }
+    const remainder = relativePath.slice(memoriesPrefix.length);
+    if (!remainder || remainder.includes("/") || remainder.includes("..")) {
+        throw new Error(`Path is not writable: ${inputPath}`);
+    }
+    if (!remainder.endsWith(".md")) {
+        throw new Error(`Path is not writable: ${inputPath}`);
+    }
+    return relativePath;
+}
+function memoryCharLimitForPath(relativePath) {
+    if (relativePath === MEMORY_MD_RELATIVE_PATH)
+        return MEMORY_MD_CHAR_LIMIT;
+    if (relativePath === USER_MD_RELATIVE_PATH)
+        return USER_MD_CHAR_LIMIT;
+    return undefined;
+}
+export function writeHermesFile(inputPath, content) {
+    const relativePath = assertWritableHermesPath(inputPath);
+    const charLimit = memoryCharLimitForPath(relativePath);
+    if (charLimit !== undefined && content.length > charLimit) {
+        throw new Error(`Content exceeds ${charLimit} character limit for ${relativePath} (${content.length} chars)`);
+    }
+    const home = resolveHermesHome();
+    const resolved = resolveSandboxedPath(relativePath);
+    if (relativePath.startsWith(`${MEMORIES_DIR}/`)) {
+        mkdirSync(join(home, MEMORIES_DIR), { recursive: true });
+    }
+    const bytes = Buffer.from(content, "utf8");
+    writeFileSync(resolved, bytes);
+    return { ok: true, relativePath, size: bytes.length };
+}
+function memoryFileEntry(home, fileName) {
+    const relativePath = `${MEMORIES_DIR}/${fileName}`;
+    const fullPath = join(home, MEMORIES_DIR, fileName);
+    let size = 0;
+    let mtime = 0;
+    if (existsSync(fullPath)) {
+        try {
+            const stats = statSync(fullPath);
+            if (stats.isFile()) {
+                size = stats.size;
+                mtime = stats.mtimeMs;
+            }
+        }
+        catch {
+            // Keep defaults for unreadable files.
+        }
+    }
+    return {
+        relativePath,
+        fileName,
+        size,
+        mtime,
+        mimeType: inferMimeType(fileName),
+        category: "document",
+        source: "artifact",
+    };
+}
+export function listHermesMemoryFiles() {
+    const home = resolveHermesHome();
+    const memoriesRoot = join(home, MEMORIES_DIR);
+    const discovered = new Set(KNOWN_MEMORY_FILES);
+    if (existsSync(memoriesRoot)) {
+        try {
+            for (const name of readdirSync(memoriesRoot)) {
+                if (name.startsWith(".") || !name.endsWith(".md"))
+                    continue;
+                discovered.add(name);
+            }
+        }
+        catch {
+            // Fall back to known files only.
+        }
+    }
+    const files = [...discovered]
+        .sort((left, right) => left.localeCompare(right))
+        .map((fileName) => memoryFileEntry(home, fileName));
+    return { files };
+}
 export function readHermesFileBytes(inputPath) {
     const resolved = resolveSandboxedPath(inputPath);
     if (!existsSync(resolved)) {

package/dist/hermesFiles.test.d.ts

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

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

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

package/dist/hermesFiles.test.js

@@ -0,0 +1,72 @@
+import assert from "node:assert/strict";
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import test from "node:test";
+import { assertWritableHermesPath, cronOutputSourceKey, listHermesFiles, listHermesMemoryFiles, MEMORY_MD_CHAR_LIMIT, MEMORY_MD_RELATIVE_PATH, readHermesFileBytes, SOUL_RELATIVE_PATH, USER_MD_CHAR_LIMIT, writeHermesFile, } from "./hermesFiles.js";
+test("cronOutputSourceKey extracts jobId/filename from cron output paths", () => {
+    assert.equal(cronOutputSourceKey("cron/output/abc123/2026-05-25_06-30-00.md"), "abc123/2026-05-25_06-30-00.md");
+    assert.equal(cronOutputSourceKey("cache/documents/report.pdf"), undefined);
+});
+test("listHermesFiles includes cron output with source metadata", () => {
+    const home = mkdtempSync(join(tmpdir(), "hermes-files-test-"));
+    const previousHome = process.env.HERMES_HOME;
+    process.env.HERMES_HOME = home;
+    try {
+        const jobId = "job-alpha";
+        const fileName = "2026-05-25_06-30-00.md";
+        const outputDir = join(home, "cron", "output", jobId);
+        mkdirSync(outputDir, { recursive: true });
+        writeFileSync(join(outputDir, fileName), "# Cron output\n", "utf8");
+        writeFileSync(join(home, "cron", "jobs.json"), JSON.stringify([{ id: jobId, name: "AI News Daily Brief" }]), "utf8");
+        const { files } = listHermesFiles({ limit: 50 });
+        const cronFile = files.find((file) => file.sourceKey === `${jobId}/${fileName}`);
+        assert.ok(cronFile, "expected cron output file in list");
+        assert.equal(cronFile?.source, "cron");
+        assert.equal(cronFile?.hermesJobId, jobId);
+        assert.equal(cronFile?.hermesJobName, "AI News Daily Brief");
+        assert.equal(cronFile?.sourceKey, `${jobId}/${fileName}`);
+    }
+    finally {
+        if (previousHome === undefined) {
+            delete process.env.HERMES_HOME;
+        }
+        else {
+            process.env.HERMES_HOME = previousHome;
+        }
+    }
+});
+test("assertWritableHermesPath allows SOUL.md and memories markdown only", () => {
+    assert.equal(assertWritableHermesPath("SOUL.md"), SOUL_RELATIVE_PATH);
+    assert.equal(assertWritableHermesPath("memories/MEMORY.md"), MEMORY_MD_RELATIVE_PATH);
+    assert.throws(() => assertWritableHermesPath("cron/output/x.md"));
+    assert.throws(() => assertWritableHermesPath("memories/nested/x.md"));
+    assert.throws(() => assertWritableHermesPath("../SOUL.md"));
+});
+test("writeHermesFile enforces memory char limits and round-trips", () => {
+    const home = mkdtempSync(join(tmpdir(), "hermes-write-test-"));
+    const previousHome = process.env.HERMES_HOME;
+    process.env.HERMES_HOME = home;
+    try {
+        writeHermesFile(SOUL_RELATIVE_PATH, "# My soul\n");
+        const soul = readHermesFileBytes(SOUL_RELATIVE_PATH);
+        assert.equal(soul.bytes.toString("utf8"), "# My soul\n");
+        const withinLimit = "x".repeat(MEMORY_MD_CHAR_LIMIT);
+        writeHermesFile(MEMORY_MD_RELATIVE_PATH, withinLimit);
+        assert.throws(() => writeHermesFile(MEMORY_MD_RELATIVE_PATH, "x".repeat(MEMORY_MD_CHAR_LIMIT + 1)), /exceeds 2200/);
+        const userOver = "y".repeat(USER_MD_CHAR_LIMIT + 1);
+        assert.throws(() => writeHermesFile("memories/USER.md", userOver), /exceeds 1375/);
+        const { files } = listHermesMemoryFiles();
+        assert.equal(files.length, 2);
+        assert.ok(files.some((file) => file.fileName === "MEMORY.md"));
+        assert.ok(files.some((file) => file.fileName === "USER.md"));
+    }
+    finally {
+        if (previousHome === undefined) {
+            delete process.env.HERMES_HOME;
+        }
+        else {
+            process.env.HERMES_HOME = previousHome;
+        }
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saleso.innovations/bridge",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "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": "echo 'No @saleso.innovations/bridge tests configured'"
+    "test": "node --import tsx --test src/hermesFiles.test.ts"
   },
   "dependencies": {
     "better-sqlite3": "^11.10.0",