@runeachai/server 2026.322.0-canary.0

package/dist/storage/service.js

@@ -0,0 +1,120 @@
+import { createHash, randomUUID } from "node:crypto";
+import path from "node:path";
+import { badRequest, forbidden, unprocessable } from "../errors.js";
+const MAX_SEGMENT_LENGTH = 120;
+function sanitizeSegment(value) {
+    const cleaned = value
+        .trim()
+        .replace(/[^a-zA-Z0-9._-]+/g, "_")
+        .replace(/_{2,}/g, "_")
+        .replace(/^_+|_+$/g, "");
+    if (!cleaned)
+        return "file";
+    return cleaned.slice(0, MAX_SEGMENT_LENGTH);
+}
+function normalizeNamespace(namespace) {
+    const normalized = namespace
+        .split("/")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0)
+        .map((entry) => sanitizeSegment(entry));
+    if (normalized.length === 0)
+        return "misc";
+    return normalized.join("/");
+}
+function splitFilename(filename) {
+    if (!filename)
+        return { stem: "file", ext: "" };
+    const base = path.basename(filename).trim();
+    if (!base)
+        return { stem: "file", ext: "" };
+    const extRaw = path.extname(base);
+    const stemRaw = extRaw ? base.slice(0, base.length - extRaw.length) : base;
+    const stem = sanitizeSegment(stemRaw);
+    const ext = extRaw
+        .toLowerCase()
+        .replace(/[^a-z0-9.]/g, "")
+        .slice(0, 16);
+    return {
+        stem,
+        ext,
+    };
+}
+function ensureCompanyPrefix(companyId, objectKey) {
+    const expectedPrefix = `${companyId}/`;
+    if (!objectKey.startsWith(expectedPrefix)) {
+        throw forbidden("Object does not belong to company");
+    }
+    if (objectKey.includes("..")) {
+        throw badRequest("Invalid object key");
+    }
+}
+function hashBuffer(input) {
+    return createHash("sha256").update(input).digest("hex");
+}
+function buildObjectKey(companyId, namespace, originalFilename) {
+    const ns = normalizeNamespace(namespace);
+    const now = new Date();
+    const year = String(now.getUTCFullYear());
+    const month = String(now.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(now.getUTCDate()).padStart(2, "0");
+    const { stem, ext } = splitFilename(originalFilename);
+    const suffix = randomUUID();
+    const filename = `${suffix}-${stem}${ext}`;
+    return `${companyId}/${ns}/${year}/${month}/${day}/${filename}`;
+}
+function assertPutFileInput(input) {
+    if (!input.companyId || input.companyId.trim().length === 0) {
+        throw unprocessable("companyId is required");
+    }
+    if (!input.namespace || input.namespace.trim().length === 0) {
+        throw unprocessable("namespace is required");
+    }
+    if (!input.contentType || input.contentType.trim().length === 0) {
+        throw unprocessable("contentType is required");
+    }
+    if (!(input.body instanceof Buffer)) {
+        throw unprocessable("body must be a Buffer");
+    }
+    if (input.body.length <= 0) {
+        throw unprocessable("File is empty");
+    }
+}
+export function createStorageService(provider) {
+    return {
+        provider: provider.id,
+        async putFile(input) {
+            assertPutFileInput(input);
+            const objectKey = buildObjectKey(input.companyId, input.namespace, input.originalFilename);
+            const byteSize = input.body.length;
+            const contentType = input.contentType.trim().toLowerCase();
+            await provider.putObject({
+                objectKey,
+                body: input.body,
+                contentType,
+                contentLength: byteSize,
+            });
+            return {
+                provider: provider.id,
+                objectKey,
+                contentType,
+                byteSize,
+                sha256: hashBuffer(input.body),
+                originalFilename: input.originalFilename,
+            };
+        },
+        async getObject(companyId, objectKey) {
+            ensureCompanyPrefix(companyId, objectKey);
+            return provider.getObject({ objectKey });
+        },
+        async headObject(companyId, objectKey) {
+            ensureCompanyPrefix(companyId, objectKey);
+            return provider.headObject({ objectKey });
+        },
+        async deleteObject(companyId, objectKey) {
+            ensureCompanyPrefix(companyId, objectKey);
+            await provider.deleteObject({ objectKey });
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/storage/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/storage/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,OAAO,GAAG,KAAK;SAClB,IAAI,EAAE;SACN,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC5B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,MAAM,UAAU,GAAG,SAAS;SACzB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,aAAa,CAAC,QAAuB;IAC5C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM;SACf,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO;QACL,IAAI;QACJ,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAiB,EAAE,SAAiB;IAC/D,MAAM,cAAc,GAAG,GAAG,SAAS,GAAG,CAAC;IACvC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1C,MAAM,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB,EAAE,SAAiB,EAAE,gBAA+B;IAC3F,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;IAC3C,OAAO,GAAG,SAAS,IAAI,EAAE,IAAI,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAmB;IAC7C,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,YAAY,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,aAAa,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAyB;IAC5D,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QAErB,KAAK,CAAC,OAAO,CAAC,KAAmB;YAC/B,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC3F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACnC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3D,MAAM,QAAQ,CAAC,SAAS,CAAC;gBACvB,SAAS;gBACT,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW;gBACX,aAAa,EAAE,QAAQ;aACxB,CAAC,CAAC;YAEH,OAAO;gBACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;gBACrB,SAAS;gBACT,WAAW;gBACX,QAAQ;gBACR,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC9B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;aACzC,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,SAAiB;YAClD,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC1C,OAAO,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,SAAiB;YACnD,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC1C,OAAO,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,SAAiB;YACrD,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/storage/types.d.ts

@@ -0,0 +1,55 @@
+import type { StorageProvider as StorageProviderId } from "@runeachai/shared";
+import type { Readable } from "node:stream";
+export interface PutObjectInput {
+    objectKey: string;
+    body: Buffer;
+    contentType: string;
+    contentLength: number;
+}
+export interface GetObjectInput {
+    objectKey: string;
+}
+export interface GetObjectResult {
+    stream: Readable;
+    contentType?: string;
+    contentLength?: number;
+    etag?: string;
+    lastModified?: Date;
+}
+export interface HeadObjectResult {
+    exists: boolean;
+    contentType?: string;
+    contentLength?: number;
+    etag?: string;
+    lastModified?: Date;
+}
+export interface StorageProvider {
+    id: StorageProviderId;
+    putObject(input: PutObjectInput): Promise<void>;
+    getObject(input: GetObjectInput): Promise<GetObjectResult>;
+    headObject(input: GetObjectInput): Promise<HeadObjectResult>;
+    deleteObject(input: GetObjectInput): Promise<void>;
+}
+export interface PutFileInput {
+    companyId: string;
+    namespace: string;
+    originalFilename: string | null;
+    contentType: string;
+    body: Buffer;
+}
+export interface PutFileResult {
+    provider: StorageProviderId;
+    objectKey: string;
+    contentType: string;
+    byteSize: number;
+    sha256: string;
+    originalFilename: string | null;
+}
+export interface StorageService {
+    provider: StorageProviderId;
+    putFile(input: PutFileInput): Promise<PutFileResult>;
+    getObject(companyId: string, objectKey: string): Promise<GetObjectResult>;
+    headObject(companyId: string, objectKey: string): Promise<HeadObjectResult>;
+    deleteObject(companyId: string, objectKey: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,iBAAiB,CAAC;IACtB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3D,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE"}

package/dist/storage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":""}

package/dist/ui-branding.d.ts

@@ -0,0 +1,4 @@
+export declare function isWorktreeUiBrandingEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function renderFaviconLinks(worktree: boolean): string;
+export declare function applyUiBranding(html: string, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=ui-branding.d.ts.map

package/dist/ui-branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-branding.d.ts","sourceRoot":"","sources":["../src/ui-branding.ts"],"names":[],"mappings":"AAuBA,wBAAgB,2BAA2B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAS1F"}

package/dist/ui-branding.js

@@ -0,0 +1,37 @@
+const FAVICON_BLOCK_START = "<!-- RUNEACH_FAVICON_START -->";
+const FAVICON_BLOCK_END = "<!-- RUNEACH_FAVICON_END -->";
+const DEFAULT_FAVICON_LINKS = [
+    '<link rel="icon" href="/favicon.ico" sizes="48x48" />',
+    '<link rel="icon" href="/favicon.svg" type="image/svg+xml" />',
+    '<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" />',
+    '<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" />',
+].join("\n");
+const WORKTREE_FAVICON_LINKS = [
+    '<link rel="icon" href="/worktree-favicon.ico" sizes="48x48" />',
+    '<link rel="icon" href="/worktree-favicon.svg" type="image/svg+xml" />',
+    '<link rel="icon" type="image/png" sizes="32x32" href="/worktree-favicon-32x32.png" />',
+    '<link rel="icon" type="image/png" sizes="16x16" href="/worktree-favicon-16x16.png" />',
+].join("\n");
+function isTruthyEnvValue(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+}
+export function isWorktreeUiBrandingEnabled(env = process.env) {
+    return isTruthyEnvValue(env.RUNEACH_IN_WORKTREE);
+}
+export function renderFaviconLinks(worktree) {
+    return worktree ? WORKTREE_FAVICON_LINKS : DEFAULT_FAVICON_LINKS;
+}
+export function applyUiBranding(html, env = process.env) {
+    const start = html.indexOf(FAVICON_BLOCK_START);
+    const end = html.indexOf(FAVICON_BLOCK_END);
+    if (start === -1 || end === -1 || end < start)
+        return html;
+    const before = html.slice(0, start + FAVICON_BLOCK_START.length);
+    const after = html.slice(end);
+    const links = renderFaviconLinks(isWorktreeUiBrandingEnabled(env));
+    return `${before}\n${links}\n    ${after}`;
+}
+//# sourceMappingURL=ui-branding.js.map

package/dist/ui-branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-branding.js","sourceRoot":"","sources":["../src/ui-branding.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,gCAAgC,CAAC;AAC7D,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAEzD,MAAM,qBAAqB,GAAG;IAC5B,uDAAuD;IACvD,8DAA8D;IAC9D,8EAA8E;IAC9E,8EAA8E;CAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,sBAAsB,GAAG;IAC7B,gEAAgE;IAChE,uEAAuE;IACvE,uFAAuF;IACvF,uFAAuF;CACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,gBAAgB,CAAC,KAAyB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9E,OAAO,gBAAgB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,OAAO,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,qBAAqB,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAyB,OAAO,CAAC,GAAG;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IAE3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,kBAAkB,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,OAAO,GAAG,MAAM,KAAK,KAAK,SAAS,KAAK,EAAE,CAAC;AAC7C,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const serverVersion: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,aAAa,QAAyB,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export const serverVersion = pkg.version ?? "0.0.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAgB,CAAC;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@runeachai/server",
+  "version": "2026.322.0-canary.0",
+  "license": "MIT",
+  "homepage": "https://github.com/runeachai/runeach",
+  "bugs": {
+    "url": "https://github.com/runeachai/runeach/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/runeachai/runeach",
+    "directory": "server"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "ui-dist",
+    "skills"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.888.0",
+    "@runeachai/adapter-claude-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-codebuddy-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-codex-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-cursor-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-gemini-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-openclaw-gateway": "2026.322.0-canary.0",
+    "@runeachai/adapter-opencode-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-pi-local": "2026.322.0-canary.0",
+    "@runeachai/adapter-utils": "2026.322.0-canary.0",
+    "@runeachai/db": "2026.322.0-canary.0",
+    "@runeachai/plugin-sdk": "2026.322.0-canary.0",
+    "@runeachai/shared": "2026.322.0-canary.0",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
+    "better-auth": "1.4.18",
+    "chokidar": "^4.0.3",
+    "detect-port": "^2.1.0",
+    "dompurify": "^3.3.2",
+    "dotenv": "^17.0.1",
+    "drizzle-orm": "^0.38.4",
+    "embedded-postgres": "^18.1.0-beta.16",
+    "express": "^5.1.0",
+    "hermes-paperclip-adapter": "0.1.1",
+    "jsdom": "^28.1.0",
+    "multer": "^2.0.2",
+    "open": "^11.0.0",
+    "pino": "^9.6.0",
+    "pino-http": "^10.4.0",
+    "pino-pretty": "^13.1.3",
+    "sharp": "^0.34.5",
+    "ws": "^8.19.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/express-serve-static-core": "^5.0.0",
+    "@types/jsdom": "^28.0.0",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.6.0",
+    "@types/sharp": "^0.32.0",
+    "@types/supertest": "^6.0.2",
+    "@types/ws": "^8.18.1",
+    "cross-env": "^10.1.0",
+    "supertest": "^7.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.1.0",
+    "vitest": "^3.0.5"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "dev:watch": "cross-env RUNEACH_MIGRATION_PROMPT=never RUNEACH_MIGRATION_AUTO_APPLY=true tsx watch --ignore ../ui/node_modules --ignore ../ui/.vite --ignore ../ui/dist src/index.ts",
+    "prepare:ui-dist": "bash ../scripts/prepare-server-ui-dist.sh",
+    "build": "tsc && node -e \"const fs=require('node:fs'); fs.mkdirSync('dist/onboarding-assets',{recursive:true}); fs.cpSync('src/onboarding-assets','dist/onboarding-assets',{recursive:true});\"",
+    "clean": "rm -rf dist",
+    "start": "node dist/index.js",
+    "typecheck": "pnpm --filter @runeachai/plugin-sdk build && tsc --noEmit"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/skills/para-memory-files/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: para-memory-files
+description: >
+  File-based memory system using Tiago Forte's PARA method. Use this skill whenever
+  you need to store, retrieve, update, or organize knowledge across sessions. Covers
+  three memory layers: (1) Knowledge graph in PARA folders with atomic YAML facts,
+  (2) Daily notes as raw timeline, (3) Tacit knowledge about user patterns. Also
+  handles planning files, memory decay, weekly synthesis, and recall via qmd.
+  Trigger on any memory operation: saving facts, writing daily notes, creating
+  entities, running weekly synthesis, recalling past context, or managing plans.
+---
+
+# PARA Memory Files
+
+Persistent, file-based memory organized by Tiago Forte's PARA method. Three layers: a knowledge graph, daily notes, and tacit knowledge. All paths are relative to `$AGENT_HOME`.
+
+## Three Memory Layers
+
+### Layer 1: Knowledge Graph (`$AGENT_HOME/life/` -- PARA)
+
+Entity-based storage. Each entity gets a folder with two tiers:
+
+1. `summary.md` -- quick context, load first.
+2. `items.yaml` -- atomic facts, load on demand.
+
+```text
+$AGENT_HOME/life/
+  projects/          # Active work with clear goals/deadlines
+    <name>/
+      summary.md
+      items.yaml
+  areas/             # Ongoing responsibilities, no end date
+    people/<name>/
+    companies/<name>/
+  resources/         # Reference material, topics of interest
+    <topic>/
+  archives/          # Inactive items from the other three
+  index.md
+```
+
+**PARA rules:**
+
+- **Projects** -- active work with a goal or deadline. Move to archives when complete.
+- **Areas** -- ongoing (people, companies, responsibilities). No end date.
+- **Resources** -- reference material, topics of interest.
+- **Archives** -- inactive items from any category.
+
+**Fact rules:**
+
+- Save durable facts immediately to `items.yaml`.
+- Weekly: rewrite `summary.md` from active facts.
+- Never delete facts. Supersede instead (`status: superseded`, add `superseded_by`).
+- When an entity goes inactive, move its folder to `$AGENT_HOME/life/archives/`.
+
+**When to create an entity:**
+
+- Mentioned 3+ times, OR
+- Direct relationship to the user (family, coworker, partner, client), OR
+- Significant project or company in the user's life.
+- Otherwise, note it in daily notes.
+
+For the atomic fact YAML schema and memory decay rules, see [references/schemas.md](references/schemas.md).
+
+### Layer 2: Daily Notes (`$AGENT_HOME/memory/YYYY-MM-DD.md`)
+
+Raw timeline of events -- the "when" layer.
+
+- Write continuously during conversations.
+- Extract durable facts to Layer 1 during heartbeats.
+
+### Layer 3: Tacit Knowledge (`$AGENT_HOME/MEMORY.md`)
+
+How the user operates -- patterns, preferences, lessons learned.
+
+- Not facts about the world; facts about the user.
+- Update whenever you learn new operating patterns.
+
+## Write It Down -- No Mental Notes
+
+Memory does not survive session restarts. Files do.
+
+- Want to remember something -> WRITE IT TO A FILE.
+- "Remember this" -> update `$AGENT_HOME/memory/YYYY-MM-DD.md` or the relevant entity file.
+- Learn a lesson -> update AGENTS.md, TOOLS.md, or the relevant skill file.
+- Make a mistake -> document it so future-you does not repeat it.
+- On-disk text files are always better than holding it in temporary context.
+
+## Memory Recall -- Use qmd
+
+Use `qmd` rather than grepping files:
+
+```bash
+qmd query "what happened at Christmas"   # Semantic search with reranking
+qmd search "specific phrase"              # BM25 keyword search
+qmd vsearch "conceptual question"         # Pure vector similarity
+```
+
+Index your personal folder: `qmd index $AGENT_HOME`
+
+Vectors + BM25 + reranking finds things even when the wording differs.
+
+## Planning
+
+Keep plans in timestamped files in `plans/` at the project root (outside personal memory so other agents can access them). Use `qmd` to search plans. Plans go stale -- if a newer plan exists, do not confuse yourself with an older version. If you notice staleness, update the file to note what it is supersededBy.

package/skills/para-memory-files/references/schemas.md

@@ -0,0 +1,35 @@
+# Schemas and Memory Decay
+
+## Atomic Fact Schema (items.yaml)
+
+```yaml
+- id: entity-001
+  fact: "The actual fact"
+  category: relationship | milestone | status | preference
+  timestamp: "YYYY-MM-DD"
+  source: "YYYY-MM-DD"
+  status: active # active | superseded
+  superseded_by: null # e.g. entity-002
+  related_entities:
+    - companies/acme
+    - people/jeff
+  last_accessed: "YYYY-MM-DD"
+  access_count: 0
+```
+
+## Memory Decay
+
+Facts decay in retrieval priority over time so stale info does not crowd out recent context.
+
+**Access tracking:** When a fact is used in conversation, bump `access_count` and set `last_accessed` to today. During heartbeat extraction, scan the session for referenced entity facts and update their access metadata.
+
+**Recency tiers (for summary.md rewriting):**
+
+- **Hot** (accessed in last 7 days) -- include prominently in summary.md.
+- **Warm** (8-30 days ago) -- include at lower priority.
+- **Cold** (30+ days or never accessed) -- omit from summary.md. Still in items.yaml, retrievable on demand.
+- High `access_count` resists decay -- frequently used facts stay warm longer.
+
+**Weekly synthesis:** Sort by recency tier, then by access_count within tier. Cold facts drop out of the summary but remain in items.yaml. Accessing a cold fact reheats it.
+
+No deletion. Decay only affects retrieval priority via summary.md curation. The full record always lives in items.yaml.