openryoko 0.9.4-ryoko.2

package/dist/src/shared/__tests__/rateLimit.test.js

@@ -0,0 +1,108 @@
+import { describe, it, expect } from "vitest";
+import { isDeadSessionError, detectRateLimit } from "../rateLimit.js";
+function makeResult(overrides = {}) {
+    return {
+        sessionId: "test-session",
+        result: "",
+        ...overrides,
+    };
+}
+describe("isDeadSessionError", () => {
+    it("returns true for error with zero cost and no rate limit", () => {
+        const result = makeResult({
+            error: "Claude exited with code 1 (no stderr output)",
+            cost: 0,
+            numTurns: 0,
+        });
+        expect(isDeadSessionError(result)).toBe(true);
+    });
+    it("returns true for error with undefined cost/turns (no work done)", () => {
+        const result = makeResult({
+            error: "Claude exited with code 1",
+        });
+        expect(isDeadSessionError(result)).toBe(true);
+    });
+    it("returns false when rate limit status is present", () => {
+        const result = makeResult({
+            error: "Claude usage limit reached",
+            cost: 0,
+            rateLimit: { status: "rejected" },
+        });
+        expect(isDeadSessionError(result)).toBe(false);
+    });
+    it("returns false when cost > 0 (work was done)", () => {
+        const result = makeResult({
+            error: "Some error after work",
+            cost: 0.05,
+            numTurns: 3,
+        });
+        expect(isDeadSessionError(result)).toBe(false);
+    });
+    it("returns false when numTurns > 0 (work was done)", () => {
+        const result = makeResult({
+            error: "Some error after work",
+            cost: 0,
+            numTurns: 1,
+        });
+        expect(isDeadSessionError(result)).toBe(false);
+    });
+    it("returns false when there is no error", () => {
+        const result = makeResult({ result: "success" });
+        expect(isDeadSessionError(result)).toBe(false);
+    });
+    // Secondary pattern matching — requires zero cost as conjunction
+    it("returns true for 'error_during_execution' with zero cost", () => {
+        const result = makeResult({
+            error: "error_during_execution",
+            cost: 0,
+            numTurns: 0,
+        });
+        expect(isDeadSessionError(result)).toBe(true);
+    });
+    it("returns false for 'error_during_execution' when cost > 0 (real work done)", () => {
+        const result = makeResult({
+            error: "error_during_execution",
+            cost: 0.05,
+            numTurns: 1,
+        });
+        expect(isDeadSessionError(result)).toBe(false);
+    });
+    it("returns true for 'session not found' in error text", () => {
+        const result = makeResult({
+            error: "Session not found or expired",
+            cost: 0,
+        });
+        expect(isDeadSessionError(result)).toBe(true);
+    });
+    it("returns true for 'invalid session' in error text", () => {
+        const result = makeResult({
+            error: "Invalid session ID provided",
+            cost: 0,
+        });
+        expect(isDeadSessionError(result)).toBe(true);
+    });
+    it("returns true for 'session expired' in error text", () => {
+        const result = makeResult({
+            error: "The session has expired",
+            cost: 0,
+        });
+        expect(isDeadSessionError(result)).toBe(true);
+    });
+    it("does not false-positive on rate limit errors with no cost", () => {
+        const result = makeResult({
+            error: "rate limit exceeded",
+            cost: 0,
+            rateLimit: { status: "rejected", resetsAt: 1234567890 },
+        });
+        expect(isDeadSessionError(result)).toBe(false);
+    });
+    it("does not interfere with detectRateLimit", () => {
+        const rateLimited = makeResult({
+            error: "Claude usage limit reached",
+            rateLimit: { status: "rejected", resetsAt: 9999999999 },
+        });
+        expect(detectRateLimit(rateLimited).limited).toBe(true);
+        expect(isDeadSessionError(rateLimited)).toBe(false);
+    });
+});
+//# sourceMappingURL=rateLimit.test.js.map

package/dist/src/shared/__tests__/rateLimit.test.js.map

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

package/dist/src/shared/__tests__/usageAwareness.test.d.ts

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

package/dist/src/shared/__tests__/usageAwareness.test.d.ts.map

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

package/dist/src/shared/__tests__/usageAwareness.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import fs from "node:fs";
+import path from "node:path";
+// vi.mock factory is hoisted — cannot reference local variables.
+// Use a fixed path that the mock can resolve at hoist time.
+vi.mock("../paths.js", () => ({
+    JINN_HOME: path.join(import.meta.dirname || __dirname, ".tmp-usage-test"),
+}));
+import { isLikelyNearClaudeUsageLimit, recordClaudeRateLimit, } from "../usageAwareness.js";
+const TEMP_DIR = path.join(import.meta.dirname || __dirname, ".tmp-usage-test");
+const STATE_PATH = path.join(TEMP_DIR, "tmp", "claude-usage.json");
+beforeEach(() => {
+    fs.mkdirSync(path.join(TEMP_DIR, "tmp"), { recursive: true });
+});
+afterEach(() => {
+    fs.rmSync(TEMP_DIR, { recursive: true, force: true });
+});
+describe("isLikelyNearClaudeUsageLimit", () => {
+    it("returns false when no state file exists", () => {
+        expect(isLikelyNearClaudeUsageLimit()).toBe(false);
+    });
+    it("returns true when rate limit was hit recently (within 6h)", () => {
+        const recentHit = new Date(Date.now() - 30 * 60_000).toISOString(); // 30 min ago
+        fs.writeFileSync(STATE_PATH, JSON.stringify({ lastRateLimitAt: recentHit }));
+        expect(isLikelyNearClaudeUsageLimit()).toBe(true);
+    });
+    it("returns false when rate limit was hit more than 6h ago", () => {
+        const oldHit = new Date(Date.now() - 7 * 60 * 60_000).toISOString(); // 7h ago
+        fs.writeFileSync(STATE_PATH, JSON.stringify({ lastRateLimitAt: oldHit }));
+        expect(isLikelyNearClaudeUsageLimit()).toBe(false);
+    });
+    it("returns false when lastResetsAt has passed, even if lastRateLimitAt is recent", () => {
+        const recentHit = new Date(Date.now() - 30 * 60_000).toISOString(); // 30 min ago
+        const pastReset = new Date(Date.now() - 10 * 60_000).toISOString(); // 10 min ago
+        fs.writeFileSync(STATE_PATH, JSON.stringify({ lastRateLimitAt: recentHit, lastResetsAt: pastReset }));
+        expect(isLikelyNearClaudeUsageLimit()).toBe(false);
+    });
+    it("returns true when lastResetsAt is in the future", () => {
+        const recentHit = new Date(Date.now() - 30 * 60_000).toISOString(); // 30 min ago
+        const futureReset = new Date(Date.now() + 60 * 60_000).toISOString(); // 1h from now
+        fs.writeFileSync(STATE_PATH, JSON.stringify({ lastRateLimitAt: recentHit, lastResetsAt: futureReset }));
+        expect(isLikelyNearClaudeUsageLimit()).toBe(true);
+    });
+    it("ignores invalid lastResetsAt and falls back to 6h heuristic", () => {
+        const recentHit = new Date(Date.now() - 30 * 60_000).toISOString();
+        fs.writeFileSync(STATE_PATH, JSON.stringify({ lastRateLimitAt: recentHit, lastResetsAt: "not-a-date" }));
+        expect(isLikelyNearClaudeUsageLimit()).toBe(true);
+    });
+    it("works end-to-end with recordClaudeRateLimit", () => {
+        const futureResetSeconds = (Date.now() + 2 * 60 * 60_000) / 1000; // 2h from now
+        recordClaudeRateLimit(futureResetSeconds);
+        expect(isLikelyNearClaudeUsageLimit()).toBe(true);
+        // Simulate time passing beyond the reset
+        const pastResetTime = new Date(futureResetSeconds * 1000 + 1000);
+        expect(isLikelyNearClaudeUsageLimit(pastResetTime)).toBe(false);
+    });
+});
+//# sourceMappingURL=usageAwareness.test.js.map

package/dist/src/shared/__tests__/usageAwareness.test.js.map

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

package/dist/src/shared/config.d.ts

@@ -0,0 +1,3 @@
+import type { JinnConfig } from "./types.js";
+export declare function loadConfig(): JinnConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/shared/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/shared/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,UAAU,IAAI,UAAU,CAQvC"}

package/dist/src/shared/config.js

@@ -0,0 +1,11 @@
+import fs from "node:fs";
+import yaml from "js-yaml";
+import { CONFIG_PATH } from "./paths.js";
+export function loadConfig() {
+    if (!fs.existsSync(CONFIG_PATH)) {
+        throw new Error(`Jinn config not found at ${CONFIG_PATH}. Run "jinn setup" first.`);
+    }
+    const raw = fs.readFileSync(CONFIG_PATH, "utf-8");
+    return yaml.load(raw);
+}
+//# sourceMappingURL=config.js.map

package/dist/src/shared/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,2BAA2B,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,CAAC;AACtC,CAAC"}

package/dist/src/shared/effort.d.ts

@@ -0,0 +1,17 @@
+import type { Employee, Session } from "./types.js";
+/**
+ * Resolve the effort level for a session.
+ *
+ * For child sessions (has parentSessionId), resolution chain:
+ *   1. config.engines.<engine>.childEffortOverride — global cost-control knob
+ *   2. session.effortLevel — COO's per-task judgment (from API body)
+ *   3. employee.effortLevel — employee YAML default
+ *   4. config.engines.<engine>.effortLevel — engine fallback
+ *
+ * For non-child sessions (COO's own), use engine effortLevel directly.
+ */
+export declare function resolveEffort(engineConfig: {
+    effortLevel?: string;
+    childEffortOverride?: string;
+}, session: Pick<Session, "parentSessionId" | "effortLevel">, employee?: Pick<Employee, "effortLevel"> | null): string;
+//# sourceMappingURL=effort.d.ts.map

package/dist/src/shared/effort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort.d.ts","sourceRoot":"","sources":["../../../src/shared/effort.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAIpD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,EACzD,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,IAAI,GAC9C,MAAM,CA4BR"}

package/dist/src/shared/effort.js

@@ -0,0 +1,44 @@
+import { logger } from "./logger.js";
+const VALID_EFFORTS = new Set(["low", "medium", "high"]);
+/**
+ * Resolve the effort level for a session.
+ *
+ * For child sessions (has parentSessionId), resolution chain:
+ *   1. config.engines.<engine>.childEffortOverride — global cost-control knob
+ *   2. session.effortLevel — COO's per-task judgment (from API body)
+ *   3. employee.effortLevel — employee YAML default
+ *   4. config.engines.<engine>.effortLevel — engine fallback
+ *
+ * For non-child sessions (COO's own), use engine effortLevel directly.
+ */
+export function resolveEffort(engineConfig, session, employee) {
+    if (session.parentSessionId) {
+        const override = engineConfig.childEffortOverride;
+        if (override) {
+            if (VALID_EFFORTS.has(override))
+                return override;
+            logger.warn(`Invalid childEffortOverride "${override}" in engine config, skipping`);
+        }
+        const requested = session.effortLevel;
+        if (requested) {
+            if (VALID_EFFORTS.has(requested))
+                return requested;
+            logger.warn(`Invalid effortLevel "${requested}" on session, skipping`);
+        }
+        const empDefault = employee?.effortLevel;
+        if (empDefault) {
+            if (VALID_EFFORTS.has(empDefault))
+                return empDefault;
+            logger.warn(`Invalid effortLevel "${empDefault}" on employee, skipping`);
+        }
+    }
+    // Non-child sessions (COO) or fallback
+    const engineDefault = engineConfig.effortLevel;
+    if (engineDefault && VALID_EFFORTS.has(engineDefault))
+        return engineDefault;
+    if (engineDefault) {
+        logger.warn(`Invalid effortLevel "${engineDefault}" in engine config, defaulting to "medium"`);
+    }
+    return "medium";
+}
+//# sourceMappingURL=effort.js.map

package/dist/src/shared/effort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort.js","sourceRoot":"","sources":["../../../src/shared/effort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAoE,EACpE,OAAyD,EACzD,QAA+C;IAE/C,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,mBAAmB,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,gCAAgC,QAAQ,8BAA8B,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;QACtC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,wBAAwB,SAAS,wBAAwB,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,EAAE,WAAW,CAAC;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;gBAAE,OAAO,UAAU,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,wBAAwB,UAAU,yBAAyB,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC;IAC/C,IAAI,aAAa,IAAI,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC;IAC5E,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,wBAAwB,aAAa,4CAA4C,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/shared/logger.d.ts

@@ -0,0 +1,12 @@
+export declare function configureLogger(opts: {
+    level?: string;
+    stdout?: boolean;
+    file?: boolean;
+}): void;
+export declare const logger: {
+    debug: (msg: string) => void;
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/shared/logger.ts"],"names":[],"mappings":"AAWA,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,QASA;AASD,eAAO,MAAM,MAAM;iBACJ,MAAM;gBACP,MAAM;gBACN,MAAM;iBACL,MAAM;CACpB,CAAC"}

package/dist/src/shared/logger.js

@@ -0,0 +1,35 @@
+import fs from "node:fs";
+import path from "node:path";
+import { LOGS_DIR } from "./paths.js";
+const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+let minLevel = "info";
+let writeToStdout = true;
+let logStream = null;
+export function configureLogger(opts) {
+    if (opts.level && opts.level in LEVELS)
+        minLevel = opts.level;
+    if (opts.stdout !== undefined)
+        writeToStdout = opts.stdout;
+    if (opts.file !== false) {
+        fs.mkdirSync(LOGS_DIR, { recursive: true });
+        logStream = fs.createWriteStream(path.join(LOGS_DIR, "gateway.log"), {
+            flags: "a",
+        });
+    }
+}
+function log(level, message) {
+    if (LEVELS[level] < LEVELS[minLevel])
+        return;
+    const line = `${new Date().toISOString()} [${level.toUpperCase()}] ${message}`;
+    if (writeToStdout)
+        console.log(line);
+    if (logStream)
+        logStream.write(line + "\n");
+}
+export const logger = {
+    debug: (msg) => log("debug", msg),
+    info: (msg) => log("info", msg),
+    warn: (msg) => log("warn", msg),
+    error: (msg) => log("error", msg),
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/shared/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/shared/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAGjE,IAAI,QAAQ,GAAa,MAAM,CAAC;AAChC,IAAI,aAAa,GAAG,IAAI,CAAC;AACzB,IAAI,SAAS,GAA0B,IAAI,CAAC;AAE5C,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM;QAAE,QAAQ,GAAG,IAAI,CAAC,KAAiB,CAAC;IAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,SAAS,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;YACnE,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe;IAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO;IAC7C,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;IAC/E,IAAI,aAAa;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,SAAS;QAAE,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;IACzC,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IACvC,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IACvC,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;CAC1C,CAAC"}

package/dist/src/shared/paths.d.ts

@@ -0,0 +1,31 @@
+/**
+ * JINN_HOME is kept as the exported constant name for backwards compatibility
+ * with all internal callers. The actual value resolves to ~/.ryoko/ on new
+ * installs and after the one-time migration above.
+ */
+export declare const JINN_HOME: string;
+export declare const CONFIG_PATH: string;
+export declare const SESSIONS_DB: string;
+export declare const CRON_JOBS: string;
+export declare const CRON_RUNS: string;
+export declare const ORG_DIR: string;
+export declare const SKILLS_DIR: string;
+export declare const DOCS_DIR: string;
+export declare const LOGS_DIR: string;
+export declare const TMP_DIR: string;
+export declare const MODELS_DIR: string;
+export declare const STT_MODELS_DIR: string;
+export declare const PID_FILE: string;
+export declare const CLAUDE_SKILLS_DIR: string;
+export declare const AGENTS_SKILLS_DIR: string;
+export declare const TEMPLATE_DIR: string;
+export declare const FILES_DIR: string;
+export declare const MIGRATIONS_DIR: string;
+export declare const TEMPLATE_MIGRATIONS_DIR: string;
+/**
+ * Global instances registry — always at ~/.ryoko/instances.json regardless
+ * of which instance is running, so every instance can discover the others.
+ * Falls back to ~/.jinn/ when only the legacy home exists.
+ */
+export declare const INSTANCES_REGISTRY: string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/shared/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/shared/paths.ts"],"names":[],"mappings":"AAgDA;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAgB,CAAC;AACvC,eAAO,MAAM,WAAW,QAAsC,CAAC;AAC/D,eAAO,MAAM,WAAW,QAAkD,CAAC;AAC3E,eAAO,MAAM,SAAS,QAA4C,CAAC;AACnE,eAAO,MAAM,SAAS,QAAuC,CAAC;AAC9D,eAAO,MAAM,OAAO,QAA8B,CAAC;AACnD,eAAO,MAAM,UAAU,QAAiC,CAAC;AACzD,eAAO,MAAM,QAAQ,QAA+B,CAAC;AACrD,eAAO,MAAM,QAAQ,QAA+B,CAAC;AACrD,eAAO,MAAM,OAAO,QAA8B,CAAC;AACnD,eAAO,MAAM,UAAU,QAAiC,CAAC;AACzD,eAAO,MAAM,cAAc,QAA4C,CAAC;AACxE,eAAO,MAAM,QAAQ,QAAsC,CAAC;AAC5D,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,YAAY,QAAqD,CAAC;AAC/E,eAAO,MAAM,SAAS,QAAgC,CAAC;AACvD,eAAO,MAAM,cAAc,QAAqC,CAAC;AACjE,eAAO,MAAM,uBAAuB,QAAwC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAM3B,CAAC"}

package/dist/src/shared/paths.js

@@ -0,0 +1,92 @@
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * One-time migration: if the user has a legacy ~/.jinn/ but no ~/.ryoko/,
+ * rename the entire directory in place. Runs at module load so every path
+ * constant below already points at the migrated location. Any failure is
+ * silent — resolveHome() still has a legacy fallback.
+ */
+function migrateLegacyHome() {
+    if (process.env.RYOKO_HOME || process.env.JINN_HOME)
+        return;
+    if (process.env.RYOKO_INSTANCE || process.env.JINN_INSTANCE)
+        return;
+    const legacy = path.join(os.homedir(), ".jinn");
+    const target = path.join(os.homedir(), ".ryoko");
+    if (!fs.existsSync(legacy))
+        return;
+    if (fs.existsSync(target))
+        return;
+    try {
+        fs.renameSync(legacy, target);
+        console.log(`[openryoko] migrated ~/.jinn → ~/.ryoko`);
+    }
+    catch {
+        /* leave legacy in place; resolveHome will still find it via fallback */
+    }
+}
+migrateLegacyHome();
+/**
+ * Resolve the home directory for the current instance.
+ * Precedence: RYOKO_HOME > JINN_HOME (legacy) > RYOKO_INSTANCE > JINN_INSTANCE >
+ *             ~/.ryoko (falls back to ~/.jinn if ~/.ryoko doesn't exist yet).
+ */
+function resolveHome() {
+    if (process.env.RYOKO_HOME)
+        return process.env.RYOKO_HOME;
+    if (process.env.JINN_HOME)
+        return process.env.JINN_HOME;
+    const instance = process.env.RYOKO_INSTANCE || process.env.JINN_INSTANCE;
+    if (instance)
+        return path.join(os.homedir(), `.${instance}`);
+    const ryokoHome = path.join(os.homedir(), ".ryoko");
+    const jinnHome = path.join(os.homedir(), ".jinn");
+    if (fs.existsSync(ryokoHome))
+        return ryokoHome;
+    if (fs.existsSync(jinnHome))
+        return jinnHome;
+    return ryokoHome;
+}
+/**
+ * JINN_HOME is kept as the exported constant name for backwards compatibility
+ * with all internal callers. The actual value resolves to ~/.ryoko/ on new
+ * installs and after the one-time migration above.
+ */
+export const JINN_HOME = resolveHome();
+export const CONFIG_PATH = path.join(JINN_HOME, "config.yaml");
+export const SESSIONS_DB = path.join(JINN_HOME, "sessions", "registry.db");
+export const CRON_JOBS = path.join(JINN_HOME, "cron", "jobs.json");
+export const CRON_RUNS = path.join(JINN_HOME, "cron", "runs");
+export const ORG_DIR = path.join(JINN_HOME, "org");
+export const SKILLS_DIR = path.join(JINN_HOME, "skills");
+export const DOCS_DIR = path.join(JINN_HOME, "docs");
+export const LOGS_DIR = path.join(JINN_HOME, "logs");
+export const TMP_DIR = path.join(JINN_HOME, "tmp");
+export const MODELS_DIR = path.join(JINN_HOME, "models");
+export const STT_MODELS_DIR = path.join(JINN_HOME, "models", "whisper");
+export const PID_FILE = path.join(JINN_HOME, "gateway.pid");
+export const CLAUDE_SKILLS_DIR = path.join(JINN_HOME, ".claude", "skills");
+export const AGENTS_SKILLS_DIR = path.join(JINN_HOME, ".agents", "skills");
+export const TEMPLATE_DIR = path.join(__dirname, "..", "..", "..", "template");
+export const FILES_DIR = path.join(JINN_HOME, "files");
+export const MIGRATIONS_DIR = path.join(JINN_HOME, "migrations");
+export const TEMPLATE_MIGRATIONS_DIR = path.join(TEMPLATE_DIR, "migrations");
+/**
+ * Global instances registry — always at ~/.ryoko/instances.json regardless
+ * of which instance is running, so every instance can discover the others.
+ * Falls back to ~/.jinn/ when only the legacy home exists.
+ */
+export const INSTANCES_REGISTRY = (() => {
+    const ryoko = path.join(os.homedir(), ".ryoko", "instances.json");
+    const jinn = path.join(os.homedir(), ".jinn", "instances.json");
+    if (fs.existsSync(path.dirname(ryoko)))
+        return ryoko;
+    if (fs.existsSync(path.dirname(jinn)))
+        return jinn;
+    return ryoko;
+})();
+//# sourceMappingURL=paths.js.map

package/dist/src/shared/paths.js.map

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

package/dist/src/shared/rateLimit.d.ts

@@ -0,0 +1,20 @@
+import type { EngineResult } from "./types.js";
+export interface RateLimitDetection {
+    limited: boolean;
+    /** Unix timestamp in seconds */
+    resetsAt?: number;
+}
+/**
+ * Detect whether an engine result indicates a dead/expired session rather than
+ * a transient or rate-limit error. A dead session is one where the engine exited
+ * with an error but did zero work (no cost, no turns) and there is no rate-limit
+ * signal — meaning the --resume ID is stale and should not be retried.
+ */
+export declare function isDeadSessionError(result: EngineResult): boolean;
+export declare function detectRateLimit(result: EngineResult): RateLimitDetection;
+export declare function computeRateLimitDeadlineMs(resetsAtSeconds?: number, extraMs?: number): number;
+export declare function computeNextRetryDelayMs(resetsAtSeconds?: number): {
+    delayMs: number;
+    resumeAt?: Date;
+};
+//# sourceMappingURL=rateLimit.d.ts.map

package/dist/src/shared/rateLimit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.d.ts","sourceRoot":"","sources":["../../../src/shared/rateLimit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAkBhE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAcxE;AAED,wBAAgB,0BAA0B,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,SAAc,GAAG,MAAM,CAKlG;AAED,wBAAgB,uBAAuB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,CAStG"}

package/dist/src/shared/rateLimit.js

@@ -0,0 +1,61 @@
+const RATE_LIMIT_ERROR_RE = /rate.?limit|too many requests|429|overloaded|usage.*limit|exceeded.*limit|out of extra usage/i;
+/** Patterns that indicate the engine session is dead (expired, not found, etc.) */
+const DEAD_SESSION_PATTERNS = [
+    /error.during.execution/i,
+    /session.not.found/i,
+    /invalid.session/i,
+    /session.*expired/i,
+];
+/**
+ * Detect whether an engine result indicates a dead/expired session rather than
+ * a transient or rate-limit error. A dead session is one where the engine exited
+ * with an error but did zero work (no cost, no turns) and there is no rate-limit
+ * signal — meaning the --resume ID is stale and should not be retried.
+ */
+export function isDeadSessionError(result) {
+    if (!result.error)
+        return false;
+    // If rate limit info is present, this is a rate limit, not a dead session
+    if (result.rateLimit?.status)
+        return false;
+    const zeroCost = result.cost === undefined || result.cost === 0;
+    const zeroTurns = result.numTurns === undefined || result.numTurns === 0;
+    // Primary: error with zero work done and no rate limit
+    if (zeroCost && zeroTurns)
+        return true;
+    // Secondary: known dead-session patterns in error text, but only when no real
+    // work was done (zeroCost) — avoids wiping IDs after a real session that
+    // happened to include a matching substring in its error message.
+    if (zeroCost && DEAD_SESSION_PATTERNS.some((p) => p.test(result.error)))
+        return true;
+    return false;
+}
+export function detectRateLimit(result) {
+    const resetsAt = typeof result.rateLimit?.resetsAt === "number"
+        ? result.rateLimit.resetsAt
+        : undefined;
+    if (result.rateLimit?.status === "rejected") {
+        return { limited: true, resetsAt };
+    }
+    if (result.error && RATE_LIMIT_ERROR_RE.test(result.error)) {
+        return { limited: true, resetsAt };
+    }
+    return { limited: false };
+}
+export function computeRateLimitDeadlineMs(resetsAtSeconds, extraMs = 30 * 60_000) {
+    if (typeof resetsAtSeconds === "number" && Number.isFinite(resetsAtSeconds)) {
+        return resetsAtSeconds * 1000 + extraMs;
+    }
+    return Date.now() + extraMs;
+}
+export function computeNextRetryDelayMs(resetsAtSeconds) {
+    if (typeof resetsAtSeconds === "number" && Number.isFinite(resetsAtSeconds)) {
+        const resumeAt = new Date(resetsAtSeconds * 1000);
+        // Add a small buffer to avoid retrying a few ms before the reset boundary.
+        const bufferMs = 10_000;
+        const delayMs = Math.max(10_000, resumeAt.getTime() - Date.now() + bufferMs);
+        return { delayMs, resumeAt };
+    }
+    return { delayMs: 60_000 };
+}
+//# sourceMappingURL=rateLimit.js.map

package/dist/src/shared/rateLimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.js","sourceRoot":"","sources":["../../../src/shared/rateLimit.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GACvB,+FAA+F,CAAC;AAQlG,mFAAmF;AACnF,MAAM,qBAAqB,GAAG;IAC5B,yBAAyB;IACzB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEhC,0EAA0E;IAC1E,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC;IAE3C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;IAEzE,uDAAuD;IACvD,IAAI,QAAQ,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvC,8EAA8E;IAC9E,yEAAyE;IACzE,iEAAiE;IACjE,IAAI,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,SAAS,EAAE,QAAQ,KAAK,QAAQ;QAC7D,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ;QAC3B,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,eAAwB,EAAE,OAAO,GAAG,EAAE,GAAG,MAAM;IACxF,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,OAAO,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,eAAwB;IAC9D,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;QAClD,2EAA2E;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}