@snoai/mem-claude 1.0.0

package/dist/install.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+declare const settingsSchema: z.ZodObject<{
+    hooks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        hooks: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            command: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>>;
+    permissions: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>;
+    disableAllHooks: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+type Settings = z.infer<typeof settingsSchema>;
+export interface InstallOptions {
+    configDir: string;
+    programPath: string;
+    dryRun?: boolean;
+    writeOutput: (line: string) => void;
+}
+export declare function isOwnedHookCommand(command: string, subcommand: string): boolean;
+export declare function isOwnedPermissionRule(rule: string): boolean;
+export declare function readSettings(configDir: string): Promise<Settings | undefined>;
+export declare function installClaude(options: InstallOptions): Promise<void>;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,QAAA,MAAM,cAAc;;;;;;;;;;;iBAIlB,CAAC;AACH,KAAK,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAUD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAS/E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAiBnF;AA+BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB1E"}

package/dist/install.js

@@ -0,0 +1,118 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join } from "node:path";
+import { CODING_SKIN_HOOKS } from "@snoai/memory/coding-skin";
+import { z } from "zod";
+import { APP_NAME } from "./constants.js";
+import { MESSAGES } from "./messages.js";
+const hookSchema = z.looseObject({ type: z.string(), command: z.string().optional() });
+const groupSchema = z.looseObject({ hooks: z.array(hookSchema) });
+const settingsSchema = z.looseObject({
+    hooks: z.record(z.string(), z.array(groupSchema)).optional(),
+    permissions: z.looseObject({ allow: z.array(z.string()).optional() }).optional(),
+    disableAllHooks: z.boolean().optional(),
+});
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function isOwnedProgram(program) {
+    return basename(program) === APP_NAME || /\/mem-claude\/(?:dist|src)\/cli\.(?:js|ts)$/.test(program);
+}
+export function isOwnedHookCommand(command, subcommand) {
+    const suffix = ` ${subcommand}`;
+    const trimmed = command.trim();
+    if (!trimmed.endsWith(suffix))
+        return false;
+    const encoded = trimmed.slice(0, -suffix.length);
+    const program = encoded.startsWith("'") && encoded.endsWith("'")
+        ? encoded.slice(1, -1).replaceAll("'\\''", "'") : encoded;
+    if (encoded !== shellQuote(program) && !/^[\w./-]+$/.test(encoded))
+        return false;
+    return isOwnedProgram(program);
+}
+export function isOwnedPermissionRule(rule) {
+    return rule.startsWith("Bash(") && rule.endsWith(" *)")
+        && isAbsolute(rule.slice(5, -3)) && isOwnedProgram(rule.slice(5, -3));
+}
+export async function readSettings(configDir) {
+    let text;
+    try {
+        text = await readFile(join(configDir, "settings.json"), "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (!settingsSchema.safeParse(parsed).success)
+            return undefined;
+        // Keep validated user objects intact, including their original key order.
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+}
+function updateSettings(settings, programPath) {
+    settings.hooks ??= {};
+    for (const event of Object.keys(CODING_SKIN_HOOKS)) {
+        const details = CODING_SKIN_HOOKS[event];
+        const groups = settings.hooks[event] ?? [];
+        let installed = false;
+        const hook = {
+            type: "command", command: `${shellQuote(programPath)} ${details.subcommand}`,
+            timeout: details.timeout,
+        };
+        for (const group of groups) {
+            group.hooks = group.hooks.map(current => {
+                if (!current.command || !isOwnedHookCommand(current.command, details.subcommand))
+                    return current;
+                installed = true;
+                return hook;
+            });
+        }
+        if (!installed)
+            groups.push({ hooks: [hook] });
+        settings.hooks[event] = groups;
+    }
+    settings.permissions ??= {};
+    const allow = settings.permissions.allow ?? [];
+    const rule = `Bash(${programPath} *)`;
+    const index = allow.findIndex(isOwnedPermissionRule);
+    if (index < 0)
+        allow.push(rule);
+    else
+        allow[index] = rule;
+    settings.permissions.allow = allow;
+}
+export async function installClaude(options) {
+    const settings = await readSettings(options.configDir);
+    const writes = [{
+            path: join(options.configDir, "skills", APP_NAME, "SKILL.md"),
+            content: await readFile(new URL(`../skills/${APP_NAME}/SKILL.md`, import.meta.url), "utf8"),
+        }];
+    if (settings) {
+        updateSettings(settings, options.programPath);
+        writes.unshift({
+            path: join(options.configDir, "settings.json"),
+            content: `${JSON.stringify(settings, null, 2)}\n`,
+        });
+    }
+    else {
+        options.writeOutput(MESSAGES.settingsUnparsable);
+    }
+    for (const write of writes) {
+        if (options.dryRun)
+            options.writeOutput(`${MESSAGES.dryRunPrefix} ${write.path}`);
+        else {
+            await mkdir(dirname(write.path), { recursive: true, mode: 0o700 });
+            await writeFile(write.path, write.content, { mode: 0o600 });
+        }
+    }
+    if (!options.dryRun && settings)
+        options.writeOutput(MESSAGES.installComplete);
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/memory-client.d.ts

@@ -0,0 +1,4 @@
+import { type DegradedConnection, type MemoryClient } from "@snoai/memory/client";
+export declare function connectMemory(): Promise<MemoryClient | DegradedConnection>;
+export declare function isDegradedConnection(connection: MemoryClient | DegradedConnection): connection is DegradedConnection;
+//# sourceMappingURL=memory-client.d.ts.map

package/dist/memory-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-client.d.ts","sourceRoot":"","sources":["../src/memory-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,MAAM,sBAAsB,CAAC;AAG9B,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,GAAG,kBAAkB,CAAC,CAEhF;AAED,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,YAAY,GAAG,kBAAkB,GAC3C,UAAU,IAAI,kBAAkB,CAElC"}

package/dist/memory-client.js

@@ -0,0 +1,9 @@
+import { connect, } from "@snoai/memory/client";
+import { SKIN_ID } from "./constants.js";
+export async function connectMemory() {
+    return connect({ skinId: SKIN_ID });
+}
+export function isDegradedConnection(connection) {
+    return connection.degraded;
+}
+//# sourceMappingURL=memory-client.js.map

package/dist/memory-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-client.js","sourceRoot":"","sources":["../src/memory-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,OAAO,GAGP,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,aAAa;IAClC,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,UAA6C;IAE7C,OAAO,UAAU,CAAC,QAAQ,CAAC;AAC5B,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,9 @@
+export declare const MESSAGES: {
+    readonly usage: "Usage: sno-mem-claude <session-start|user-prompt-submit|stop|install|doctor|import|recall|get|remember|correct>";
+    readonly dryRunPrefix: "would write";
+    readonly installComplete: "sno-mem-claude install complete";
+    readonly settingsUnparsable: "settings.json parse error; settings preserved";
+    readonly importCaptureDisabled: "Automatic capture is off in settings.json (capture.ambient); imported notes will be skipped.";
+    readonly doctorUnavailable: "doctor: unavailable";
+};
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;aACpB,KAAK,EAAE,iHAAiH;aACxH,YAAY,EAAE,aAAa;aAC3B,eAAe,EAAE,iCAAiC;aAClD,kBAAkB,EAAE,+CAA+C;aACnE,qBAAqB,EAAE,8FAA8F;aACrH,iBAAiB,EAAE,qBAAqB;CAC/B,CAAC"}

package/dist/messages.js

@@ -0,0 +1,9 @@
+export const MESSAGES = {
+    usage: "Usage: sno-mem-claude <session-start|user-prompt-submit|stop|install|doctor|import|recall|get|remember|correct>",
+    dryRunPrefix: "would write",
+    installComplete: "sno-mem-claude install complete",
+    settingsUnparsable: "settings.json parse error; settings preserved",
+    importCaptureDisabled: "Automatic capture is off in settings.json (capture.ambient); imported notes will be skipped.",
+    doctorUnavailable: "doctor: unavailable",
+};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB,KAAK,EAAE,iHAAiH;IACxH,YAAY,EAAE,aAAa;IAC3B,eAAe,EAAE,iCAAiC;IAClD,kBAAkB,EAAE,+CAA+C;IACnE,qBAAqB,EAAE,8FAA8F;IACrH,iBAAiB,EAAE,qBAAqB;CAC/B,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,9 @@
+export declare function profileRoot(): string;
+export declare function appStateRoot(): string;
+export declare function sessionPath(sessionId: string): string;
+export declare function spoolDirectory(): string;
+export declare function workerLockPath(): string;
+export declare function workerLogPath(): string;
+export declare function importDirectory(): string;
+export declare function sidecarDiscoveryPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/paths.js

@@ -0,0 +1,30 @@
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { APP_NAME } from "./constants.js";
+export function profileRoot() {
+    return resolve(process.env["SNO_PROFILE_DIR"] ?? join(homedir(), ".sno"));
+}
+export function appStateRoot() {
+    return join(profileRoot(), APP_NAME);
+}
+export function sessionPath(sessionId) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(sessionId))
+        throw new Error("invalid-session-id");
+    return join(appStateRoot(), "sessions", `${sessionId}.json`);
+}
+export function spoolDirectory() {
+    return join(appStateRoot(), "spool");
+}
+export function workerLockPath() {
+    return join(appStateRoot(), "worker.lock");
+}
+export function workerLogPath() {
+    return join(appStateRoot(), "worker.log");
+}
+export function importDirectory() {
+    return join(appStateRoot(), "import");
+}
+export function sidecarDiscoveryPath() {
+    return join(profileRoot(), "station", "sidecar.json");
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,UAAU,WAAW;IAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,YAAY;IAC3B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC5C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe;IAC9B,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}

package/dist/recall.d.ts

@@ -0,0 +1,2 @@
+export declare function withinDeadline<T>(run: Promise<T>, timeoutMs: number): Promise<T>;
+//# sourceMappingURL=recall.d.ts.map

package/dist/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA,wBAAsB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBtF"}

package/dist/recall.js

@@ -0,0 +1,20 @@
+export async function withinDeadline(run, timeoutMs) {
+    let timer;
+    try {
+        return await Promise.race([
+            run,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    const error = new Error("timeout");
+                    error.name = "TimeoutError";
+                    reject(error);
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=recall.js.map

package/dist/recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,GAAe,EAAE,SAAiB;IACzE,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACzB,GAAG;YACH,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBACvC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACvB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;oBACnC,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC;oBAC5B,MAAM,CAAC,KAAK,CAAC,CAAC;gBACf,CAAC,EAAE,SAAS,CAAC,CAAC;YACf,CAAC,CAAC;SACF,CAAC,CAAC;IACJ,CAAC;YAAS,CAAC;QACV,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACF,CAAC"}

package/dist/scope.d.ts

@@ -0,0 +1,6 @@
+import type { ScopeCtx } from "@snoai/memory/client";
+/** One workspace is the git repository root when `cwd` is inside one, else `cwd` itself. */
+export declare function workspaceRoot(cwd: string): Promise<string>;
+export declare function hookScope(project: string, sessionId: string): ScopeCtx;
+export declare function manualScope(project: string): ScopeCtx;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKrD,4FAA4F;AAC5F,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAOtE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAOrD"}

package/dist/scope.js

@@ -0,0 +1,36 @@
+import { execFile } from "node:child_process";
+import { resolve } from "node:path";
+import { promisify } from "node:util";
+import { CODING_SKIN_MANUAL_SESSION_ID } from "@snoai/memory/coding-skin";
+const execFileAsync = promisify(execFile);
+/** One workspace is the git repository root when `cwd` is inside one, else `cwd` itself. */
+export async function workspaceRoot(cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+            cwd,
+            timeout: 2_000,
+        });
+        const root = stdout.trim();
+        return root.length > 0 ? root : resolve(cwd);
+    }
+    catch {
+        return resolve(cwd);
+    }
+}
+export function hookScope(project, sessionId) {
+    return {
+        principal: "client-replaced-by-sidecar-library",
+        project,
+        session: sessionId,
+        host: { sessionId, workspace: project },
+    };
+}
+export function manualScope(project) {
+    return {
+        principal: "client-replaced-by-sidecar-library",
+        project,
+        session: CODING_SKIN_MANUAL_SESSION_ID,
+        host: { sessionId: CODING_SKIN_MANUAL_SESSION_ID, workspace: project },
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAE1E,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC9C,IAAI,CAAC;QACJ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;YAC/E,GAAG;YACH,OAAO,EAAE,KAAK;SACd,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,SAAiB;IAC3D,OAAO;QACN,SAAS,EAAE,oCAAoC;QAC/C,OAAO;QACP,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;KACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IAC1C,OAAO;QACN,SAAS,EAAE,oCAAoC;QAC/C,OAAO;QACP,OAAO,EAAE,6BAA6B;QACtC,IAAI,EAAE,EAAE,SAAS,EAAE,6BAA6B,EAAE,SAAS,EAAE,OAAO,EAAE;KACtE,CAAC;AACH,CAAC"}

package/dist/session-state.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+declare const lastSessionSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    transcriptPath: z.ZodString;
+}, z.core.$strip>;
+export declare function readLastSession(project: string): Promise<z.infer<typeof lastSessionSchema> | undefined>;
+export declare function writeLastSession(project: string, sessionId: string, transcriptPath: string): Promise<void>;
+declare const sessionStateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    skillRunsReported: z.ZodDefault<z.ZodNumber>;
+    prompts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        prompt: z.ZodString;
+        at: z.ZodNumber;
+    }, z.core.$strip>>>;
+    receipt: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        invocations: z.ZodDefault<z.ZodNumber>;
+        lookups: z.ZodDefault<z.ZodNumber>;
+        itemsInjected: z.ZodDefault<z.ZodNumber>;
+        charsInjected: z.ZodDefault<z.ZodNumber>;
+        skips: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        degraded: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        resets: z.ZodDefault<z.ZodNumber>;
+        latencyMs: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    toolStarts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strip>;
+export type SessionState = z.infer<typeof sessionStateSchema>;
+export declare function readSession(sessionId: string): Promise<SessionState>;
+export declare function writeSession(state: SessionState): Promise<void>;
+/** Applies `change` to the newest session file under a lock: tool hooks run as parallel processes, and a plain read-then-write lets the last one erase the others. */
+export declare function updateSession(sessionId: string, change: (state: SessionState) => void): Promise<void>;
+export declare function recordInvocation(state: SessionState, event: string, latencyMs: number): void;
+export declare function recordSkip(state: SessionState, event: string, reason: string): void;
+export declare function recordDegraded(state: SessionState, event: string, reason: string): void;
+export declare function recordLookup(state: SessionState, event: string): void;
+export declare function recordInjection(state: SessionState, event: string, items: number, chars: number): void;
+export interface SpoolRecord {
+    sessionId: string;
+    turnId: string;
+    project: string;
+    childCwd: string;
+    user: string;
+    assistant?: string;
+    kind?: "turn" | "import";
+    importReceipt?: {
+        path: string;
+        file: string;
+    };
+    at: number;
+    attempts: number;
+    state: "pending" | "failed";
+}
+export declare function appendSpool(record: Omit<SpoolRecord, "attempts" | "state">): Promise<string>;
+export {};
+//# sourceMappingURL=session-state.d.ts.map

package/dist/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,iBAAiB;;;iBAAgF,CAAC;AAMxG,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GAAG,SAAS,CAAC,CAO7G;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhH;AAaD,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;iBAOtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAS1E;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAID,sKAAsK;AACtK,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAK5F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAInF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIvF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKtG;AAED,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlG"}

package/dist/session-state.js

@@ -0,0 +1,112 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
+import { z } from "zod";
+import { acquirePidFileLock, writeJsonAtomic } from "./files.js";
+import { appStateRoot, sessionPath, spoolDirectory } from "./paths.js";
+const lastSessionSchema = z.object({ sessionId: z.string().min(1), transcriptPath: z.string().min(1) });
+function lastSessionPath(project) {
+    return join(appStateRoot(), "last-session", `${createHash("sha256").update(project).digest("hex")}.json`);
+}
+export async function readLastSession(project) {
+    try {
+        return lastSessionSchema.parse(JSON.parse(await readFile(lastSessionPath(project), "utf8")));
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+export async function writeLastSession(project, sessionId, transcriptPath) {
+    await writeJsonAtomic(lastSessionPath(project), { sessionId, transcriptPath });
+}
+const receiptEventSchema = z.object({
+    invocations: z.number().int().nonnegative().default(0),
+    lookups: z.number().int().nonnegative().default(0),
+    itemsInjected: z.number().int().nonnegative().default(0),
+    charsInjected: z.number().int().nonnegative().default(0),
+    skips: z.record(z.string(), z.number().int().nonnegative()).default({}),
+    degraded: z.record(z.string(), z.number().int().nonnegative()).default({}),
+    resets: z.number().int().nonnegative().default(0),
+    latencyMs: z.array(z.number().int().nonnegative()).default([]),
+});
+const sessionStateSchema = z.object({
+    sessionId: z.string().min(1),
+    skillRunsReported: z.number().int().nonnegative().default(0),
+    prompts: z.record(z.string(), z.object({ prompt: z.string(), at: z.number() })).default({}),
+    receipt: z.record(z.string(), receiptEventSchema).default({}),
+    /** PreToolUse arrival time by tool_use_id, consumed by PostToolUse to measure the call. */
+    toolStarts: z.record(z.string(), z.number()).default({}),
+});
+export async function readSession(sessionId) {
+    try {
+        return sessionStateSchema.parse(JSON.parse(await readFile(sessionPath(sessionId), "utf8")));
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return sessionStateSchema.parse({ sessionId });
+        }
+        throw error;
+    }
+}
+export async function writeSession(state) {
+    await writeJsonAtomic(sessionPath(state.sessionId), state);
+}
+const SESSION_LOCK_WAIT_MS = 2000;
+/** Applies `change` to the newest session file under a lock: tool hooks run as parallel processes, and a plain read-then-write lets the last one erase the others. */
+export async function updateSession(sessionId, change) {
+    const lockPath = `${sessionPath(sessionId)}.lock`;
+    const deadline = Date.now() + SESSION_LOCK_WAIT_MS;
+    let lock = await acquirePidFileLock(lockPath, SESSION_LOCK_WAIT_MS);
+    while (!lock) {
+        if (Date.now() >= deadline)
+            throw new Error("session-state-busy");
+        await sleep(10);
+        lock = await acquirePidFileLock(lockPath, SESSION_LOCK_WAIT_MS);
+    }
+    try {
+        const state = await readSession(sessionId);
+        change(state);
+        await writeSession(state);
+    }
+    finally {
+        await lock.release();
+    }
+}
+export function recordInvocation(state, event, latencyMs) {
+    const receipt = state.receipt[event] ?? receiptEventSchema.parse({});
+    receipt.invocations += 1;
+    receipt.latencyMs.push(Math.max(0, Math.round(latencyMs)));
+    state.receipt[event] = receipt;
+}
+export function recordSkip(state, event, reason) {
+    const receipt = state.receipt[event] ?? receiptEventSchema.parse({});
+    receipt.skips[reason] = (receipt.skips[reason] ?? 0) + 1;
+    state.receipt[event] = receipt;
+}
+export function recordDegraded(state, event, reason) {
+    const receipt = state.receipt[event] ?? receiptEventSchema.parse({});
+    receipt.degraded[reason] = (receipt.degraded[reason] ?? 0) + 1;
+    state.receipt[event] = receipt;
+}
+export function recordLookup(state, event) {
+    const receipt = state.receipt[event] ?? receiptEventSchema.parse({});
+    receipt.lookups += 1;
+    state.receipt[event] = receipt;
+}
+export function recordInjection(state, event, items, chars) {
+    const receipt = state.receipt[event] ?? receiptEventSchema.parse({});
+    receipt.itemsInjected += items;
+    receipt.charsInjected += chars;
+    state.receipt[event] = receipt;
+}
+export async function appendSpool(record) {
+    const directory = spoolDirectory();
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const path = join(directory, `${String(record.at).padStart(16, "0")}-${randomUUID()}.json`);
+    await writeJsonAtomic(path, { ...record, attempts: 0, state: "pending" });
+    return path;
+}
+//# sourceMappingURL=session-state.js.map

package/dist/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../src/session-state.ts"],"names":[],"mappings":"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"}

package/dist/settings.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+declare const recallSchema: z.ZodObject<{
+    auto: z.ZodBoolean;
+    sessionStart: z.ZodObject<{
+        limit: z.ZodNumber;
+        maxChars: z.ZodNumber;
+        timeoutMs: z.ZodNumber;
+    }, z.core.$strip>;
+    prompt: z.ZodObject<{
+        limit: z.ZodNumber;
+        maxChars: z.ZodNumber;
+        timeoutMs: z.ZodNumber;
+        minChars: z.ZodNumber;
+        minScore: z.ZodNumber;
+    }, z.core.$strip>;
+    explicitLimit: z.ZodNumber;
+}, z.core.$strip>;
+export declare function readRecallSettings(): z.infer<typeof recallSchema>;
+export declare function readCaptureSettings(): {
+    ambient: boolean;
+};
+export {};
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;iBAKhB,CAAC;AAeH,wBAAgB,kBAAkB,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAEjE;AAED,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAE1D"}

package/dist/settings.js

@@ -0,0 +1,33 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+import { profileRoot } from "./paths.js";
+const recallSchema = z.object({
+    auto: z.boolean(),
+    sessionStart: z.object({ limit: z.number(), maxChars: z.number(), timeoutMs: z.number() }),
+    prompt: z.object({ limit: z.number(), maxChars: z.number(), timeoutMs: z.number(), minChars: z.number(), minScore: z.number() }),
+    explicitLimit: z.number(),
+});
+function readSettings() {
+    const path = join(profileRoot(), "settings.json");
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw new Error(`settings unavailable: ${path}: file; see https://github.com/sno-ai/sno-station/blob/main/docs/memory-setup.md`);
+    }
+    const parsed = z.object({ recall: recallSchema, capture: z.object({ ambient: z.boolean() }), memoryPackage: z.object({ path: z.string().min(1), node: z.string().min(1) }) }).safeParse(raw);
+    if (!parsed.success) {
+        const field = parsed.error.issues[0]?.path.join(".") || "recall";
+        throw new Error(`settings unavailable: ${path}: ${field}; see https://github.com/sno-ai/sno-station/blob/main/docs/memory-setup.md`);
+    }
+    return parsed.data;
+}
+export function readRecallSettings() {
+    return readSettings().recall;
+}
+export function readCaptureSettings() {
+    return readSettings().capture;
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1F,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAChI,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AAEH,SAAS,YAAY;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;IAClD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IACrD,MAAM,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,kFAAkF,CAAC,CAAC;IAAC,CAAC;IAC3I,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7L,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,KAAK,KAAK,4EAA4E,CAAC,CAAC;IACtI,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,OAAO,YAAY,EAAE,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,mBAAmB;IAClC,OAAO,YAAY,EAAE,CAAC,OAAO,CAAC;AAC/B,CAAC"}

package/dist/skill-runs.d.ts

@@ -0,0 +1,7 @@
+import { type appendObserveLedgerRows } from "@snoai/memory/coding-skin";
+export declare function readSkillRuns(input: {
+    session_id: string;
+    cwd: string;
+    transcript_path?: string | undefined;
+}): Promise<Parameters<typeof appendObserveLedgerRows>[1]>;
+//# sourceMappingURL=skill-runs.d.ts.map

package/dist/skill-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-runs.d.ts","sourceRoot":"","sources":["../src/skill-runs.ts"],"names":[],"mappings":"AAGA,OAAO,EAGN,KAAK,uBAAuB,EAC5B,MAAM,2BAA2B,CAAC;AAqFnC,wBAAsB,aAAa,CAAC,KAAK,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAwBzD"}