openryoko 0.9.4-ryoko.2

package/dist/src/sessions/__tests__/callbacks.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+// Mock dependencies before importing the module under test
+vi.mock("../registry.js", () => ({
+    getSession: vi.fn(),
+}));
+vi.mock("../../shared/config.js", () => ({
+    loadConfig: vi.fn(() => ({ gateway: { port: 7777 } })),
+}));
+vi.mock("../../shared/logger.js", () => ({
+    logger: {
+        warn: vi.fn(),
+        debug: vi.fn(),
+        info: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+import { notifyParentSession } from "../callbacks.js";
+import { getSession } from "../registry.js";
+function makeSession(overrides = {}) {
+    return {
+        id: "child-001",
+        engine: "claude",
+        engineSessionId: null,
+        source: "api",
+        sourceRef: "api:test",
+        connector: null,
+        sessionKey: "test-key",
+        replyContext: null,
+        messageId: null,
+        transportMeta: null,
+        employee: "test-employee",
+        model: "opus",
+        title: null,
+        parentSessionId: "parent-001",
+        status: "idle",
+        effortLevel: null,
+        totalCost: 0,
+        totalTurns: 0,
+        createdAt: new Date().toISOString(),
+        lastActivity: new Date().toISOString(),
+        lastError: null,
+    };
+}
+const originalFetch = globalThis.fetch;
+describe("notifyParentSession — no parent", () => {
+    it("does nothing if child has no parentSessionId", async () => {
+        const spy = vi.fn().mockResolvedValue({ ok: true });
+        globalThis.fetch = spy;
+        const child = makeSession({ parentSessionId: null });
+        notifyParentSession(child, { result: "done" });
+        await new Promise((r) => setTimeout(r, 150));
+        expect(spy).not.toHaveBeenCalled();
+        globalThis.fetch = originalFetch;
+    });
+});
+describe("notifyParentSession", () => {
+    let fetchSpy;
+    beforeEach(() => {
+        fetchSpy = vi.fn().mockResolvedValue({ ok: true });
+        globalThis.fetch = fetchSpy;
+        vi.mocked(getSession).mockReturnValue(makeSession({ id: "parent-001", parentSessionId: null, status: "idle" }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        globalThis.fetch = originalFetch;
+    });
+    it('sends success notification saying "replied in session" with API pointer', async () => {
+        const child = makeSession();
+        notifyParentSession(child, { result: "Some result" });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const [url, opts] = fetchSpy.mock.calls[0];
+        expect(url).toBe("http://127.0.0.1:7777/api/sessions/parent-001/message");
+        const body = JSON.parse(opts.body);
+        expect(body.message).toContain("replied in session");
+        expect(body.message).toContain("GET /api/sessions/child-001?last=N");
+        expect(body.message).not.toContain("completed their task");
+    });
+    it("includes truncated 200-char preview for long results", async () => {
+        const longResult = "x".repeat(300);
+        const child = makeSession();
+        notifyParentSession(child, { result: longResult });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const body = JSON.parse(fetchSpy.mock.calls[0][1].body);
+        // Should contain exactly 200 chars + "..."
+        expect(body.message).toContain("x".repeat(200) + "...");
+        expect(body.message).not.toContain("x".repeat(201));
+    });
+    it("includes full preview for short results", async () => {
+        const shortResult = "Task done successfully";
+        const child = makeSession();
+        notifyParentSession(child, { result: shortResult });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const body = JSON.parse(fetchSpy.mock.calls[0][1].body);
+        expect(body.message).toContain(shortResult);
+        expect(body.message).not.toContain("...");
+    });
+    it("error notifications contain the error message", async () => {
+        const child = makeSession();
+        notifyParentSession(child, { error: "Something broke" });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const body = JSON.parse(fetchSpy.mock.calls[0][1].body);
+        expect(body.message).toContain("Something broke");
+        expect(body.message).toContain("⚠️");
+    });
+    it('sends with "notification" role', async () => {
+        const child = makeSession();
+        notifyParentSession(child, { result: "done" });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+        const body = JSON.parse(fetchSpy.mock.calls[0][1].body);
+        expect(body.role).toBe("notification");
+    });
+});
+describe("notifyParentSession — alwaysNotify suppression", () => {
+    let fetchSpy;
+    beforeEach(() => {
+        fetchSpy = vi.fn().mockResolvedValue({ ok: true });
+        globalThis.fetch = fetchSpy;
+        vi.mocked(getSession).mockReturnValue(makeSession({ id: "parent-001", parentSessionId: null, status: "idle" }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        globalThis.fetch = originalFetch;
+    });
+    it("skips notification when alwaysNotify is false (success)", async () => {
+        const child = makeSession();
+        notifyParentSession(child, { result: "done" }, { alwaysNotify: false });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it("skips notification when alwaysNotify is false (error)", async () => {
+        const child = makeSession();
+        notifyParentSession(child, { error: "Something broke" }, { alwaysNotify: false });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it("sends notification when alwaysNotify is true", async () => {
+        const child = makeSession();
+        notifyParentSession(child, { result: "done" }, { alwaysNotify: true });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+    });
+    it("sends notification when options is undefined (backward compat)", async () => {
+        const child = makeSession();
+        notifyParentSession(child, { result: "done" });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(fetchSpy).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=callbacks.test.js.map

package/dist/src/sessions/__tests__/callbacks.test.js.map

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

package/dist/src/sessions/callbacks.d.ts

@@ -0,0 +1,31 @@
+import type { Session } from "../shared/types.js";
+/**
+ * Notify the parent session that a child session has replied.
+ * Sends an internal message to the parent via the local HTTP API.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export declare function notifyParentSession(childSession: Session, result: {
+    result?: string | null;
+    error?: string | null;
+    cost?: number;
+    durationMs?: number;
+}, options?: {
+    alwaysNotify?: boolean;
+}): void;
+/**
+ * Notify the parent session that a child session has been rate-limited and will auto-resume.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export declare function notifyRateLimited(childSession: Session, estimatedResumeTime?: string): void;
+/**
+ * Notify the parent session that a rate-limited child session has successfully resumed.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export declare function notifyRateLimitResumed(childSession: Session): void;
+/**
+ * Send a hardcoded notification to the configured Discord channel.
+ * Used for rate-limit alerts that must not depend on the LLM.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export declare function notifyDiscordChannel(message: string): void;
+//# sourceMappingURL=callbacks.d.ts.map

package/dist/src/sessions/callbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../../src/sessions/callbacks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7F,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,OAAO,EACrB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,OAAO,GACpB,IAAI,CAON;AAyBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1D"}

package/dist/src/sessions/callbacks.js

@@ -0,0 +1,112 @@
+import { getSession } from "./registry.js";
+import { loadConfig } from "../shared/config.js";
+import { logger } from "../shared/logger.js";
+/**
+ * Notify the parent session that a child session has replied.
+ * Sends an internal message to the parent via the local HTTP API.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export function notifyParentSession(childSession, result, options) {
+    if (!childSession.parentSessionId)
+        return;
+    if (options?.alwaysNotify === false)
+        return;
+    // Run asynchronously — do not await in the caller
+    _sendNotification(childSession, result).catch((err) => {
+        logger.warn(`[callbacks] Failed to notify parent session ${childSession.parentSessionId}: ${err instanceof Error ? err.message : String(err)}`);
+    });
+}
+/**
+ * Notify the parent session that a child session has been rate-limited and will auto-resume.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export function notifyRateLimited(childSession, estimatedResumeTime) {
+    if (!childSession.parentSessionId)
+        return;
+    _sendNotification(childSession, {
+        error: null,
+        result: `⏳ Session is rate-limited and will auto-resume${estimatedResumeTime ? ` around ${estimatedResumeTime}` : ' when the limit resets'}. No action needed.`,
+    }).catch((err) => {
+        logger.warn(`[callbacks] Failed to send rate-limit notification: ${err instanceof Error ? err.message : String(err)}`);
+    });
+}
+/**
+ * Notify the parent session that a rate-limited child session has successfully resumed.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export function notifyRateLimitResumed(childSession) {
+    if (!childSession.parentSessionId)
+        return;
+    const employeeName = childSession.employee || "Unknown";
+    _sendRaw(childSession.parentSessionId, `🔄 Employee "${employeeName}" (session ${childSession.id}) has resumed after rate limit cleared.`).catch((err) => {
+        logger.warn(`[callbacks] Failed to send resume notification: ${err instanceof Error ? err.message : String(err)}`);
+    });
+}
+async function _sendNotification(childSession, result) {
+    const parent = getSession(childSession.parentSessionId);
+    if (!parent)
+        return; // Parent gone or expired
+    if (parent.status === "error")
+        return; // Parent already in error — skip
+    const employeeName = childSession.employee || "Unknown";
+    const childId = childSession.id;
+    let message;
+    if (result.error) {
+        message = `⚠️ Employee "${employeeName}" (session ${childId}) encountered an error: ${result.error}`;
+    }
+    else {
+        const raw = result.result || "(no output)";
+        const preview = raw.length > 200 ? raw.substring(0, 200) + "..." : raw;
+        message = `📩 Employee "${employeeName}" replied in session ${childId}.\nRead the latest messages: GET /api/sessions/${childId}?last=N\n\nPreview: ${preview}`;
+    }
+    await _sendRaw(childSession.parentSessionId, message);
+}
+/**
+ * Send a hardcoded notification to the configured Discord channel.
+ * Used for rate-limit alerts that must not depend on the LLM.
+ * Fire-and-forget — errors are logged but never rethrown.
+ */
+export function notifyDiscordChannel(message) {
+    _sendDiscordNotification(message).catch((err) => {
+        logger.warn(`[callbacks] Failed to send Discord notification: ${err instanceof Error ? err.message : String(err)}`);
+    });
+}
+async function _sendDiscordNotification(message) {
+    let port = 7777;
+    let connector = "discord";
+    let channel;
+    try {
+        const config = loadConfig();
+        port = config.gateway?.port || 7777;
+        connector = config.notifications?.connector || "discord";
+        channel = config.notifications?.channel;
+    }
+    catch {
+        // Use defaults if config is unavailable
+    }
+    if (!channel) {
+        logger.debug("[callbacks] No notifications.channel configured — skipping Discord notification");
+        return;
+    }
+    await fetch(`http://127.0.0.1:${port}/api/connectors/${connector}/send`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ channel, text: message }),
+    });
+}
+async function _sendRaw(parentSessionId, message) {
+    let port = 7777;
+    try {
+        const config = loadConfig();
+        port = config.gateway?.port || 7777;
+    }
+    catch {
+        // Use default port if config is unavailable
+    }
+    await fetch(`http://127.0.0.1:${port}/api/sessions/${parentSessionId}/message`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ message, role: "notification" }),
+    });
+}
+//# sourceMappingURL=callbacks.js.map

package/dist/src/sessions/callbacks.js.map

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

package/dist/src/sessions/context.d.ts

@@ -0,0 +1,36 @@
+import type { Employee, JinnConfig } from "../shared/types.js";
+/**
+ * Build a rich system prompt for engine sessions.
+ * This is what makes Jinn "smart" — the engine sees all of this context
+ * before responding to the user.
+ */
+export declare function buildContext(opts: {
+    source: string;
+    channel: string;
+    thread?: string;
+    user: string;
+    employee?: Employee;
+    connectors?: string[];
+    config?: JinnConfig;
+    sessionId?: string;
+    portalName?: string;
+    operatorName?: string;
+    language?: string;
+    channelName?: string;
+    /** Display name of the actual speaker (from Slack users.info, etc.) */
+    speakerName?: string;
+    /** Speaker's real name (profile real_name) */
+    speakerRealName?: string;
+    /** Speaker's self-chosen display name */
+    speakerDisplayName?: string;
+    /** Speaker's legacy handle (users.name) */
+    speakerHandle?: string;
+    /** Raw connector-native user ID (e.g. Slack U12345) */
+    speakerSlackId?: string;
+    /** Whether the speaker is a bot/integration */
+    speakerIsBot?: boolean;
+    /** Speaker's IANA timezone */
+    speakerTz?: string;
+    hierarchy?: import("../shared/types.js").OrgHierarchy;
+}): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/sessions/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/sessions/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAsC/D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;CACvD,GAAG,MAAM,CAkKT"}