@herdctl/discord 0.0.1

package/dist/session-manager/__tests__/types.test.js

@@ -0,0 +1,169 @@
+import { describe, it, expect } from "vitest";
+import { ChannelSessionSchema, DiscordSessionStateSchema, createInitialSessionState, createChannelSession, } from "../types.js";
+// =============================================================================
+// ChannelSessionSchema Tests
+// =============================================================================
+describe("ChannelSessionSchema", () => {
+    it("validates valid channel session", () => {
+        const session = {
+            sessionId: "discord-test-123",
+            lastMessageAt: "2024-01-15T10:30:00.000Z",
+        };
+        const result = ChannelSessionSchema.safeParse(session);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.sessionId).toBe("discord-test-123");
+            expect(result.data.lastMessageAt).toBe("2024-01-15T10:30:00.000Z");
+        }
+    });
+    it("rejects empty sessionId", () => {
+        const session = {
+            sessionId: "",
+            lastMessageAt: "2024-01-15T10:30:00.000Z",
+        };
+        const result = ChannelSessionSchema.safeParse(session);
+        expect(result.success).toBe(false);
+    });
+    it("rejects invalid lastMessageAt", () => {
+        const session = {
+            sessionId: "discord-test-123",
+            lastMessageAt: "not-a-date",
+        };
+        const result = ChannelSessionSchema.safeParse(session);
+        expect(result.success).toBe(false);
+    });
+    it("rejects missing fields", () => {
+        const sessions = [
+            { sessionId: "test" },
+            { lastMessageAt: "2024-01-15T10:30:00.000Z" },
+            {},
+        ];
+        for (const session of sessions) {
+            const result = ChannelSessionSchema.safeParse(session);
+            expect(result.success).toBe(false);
+        }
+    });
+});
+// =============================================================================
+// DiscordSessionStateSchema Tests
+// =============================================================================
+describe("DiscordSessionStateSchema", () => {
+    it("validates valid session state", () => {
+        const state = {
+            version: 1,
+            agentName: "test-agent",
+            channels: {
+                "channel-123": {
+                    sessionId: "discord-test-123",
+                    lastMessageAt: "2024-01-15T10:30:00.000Z",
+                },
+            },
+        };
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.version).toBe(1);
+            expect(result.data.agentName).toBe("test-agent");
+            expect(result.data.channels["channel-123"].sessionId).toBe("discord-test-123");
+        }
+    });
+    it("validates empty channels", () => {
+        const state = {
+            version: 1,
+            agentName: "test-agent",
+            channels: {},
+        };
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(true);
+    });
+    it("rejects wrong version", () => {
+        const state = {
+            version: 2,
+            agentName: "test-agent",
+            channels: {},
+        };
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(false);
+    });
+    it("rejects empty agentName", () => {
+        const state = {
+            version: 1,
+            agentName: "",
+            channels: {},
+        };
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(false);
+    });
+    it("rejects invalid channel session", () => {
+        const state = {
+            version: 1,
+            agentName: "test-agent",
+            channels: {
+                "channel-123": {
+                    sessionId: "",
+                    lastMessageAt: "2024-01-15T10:30:00.000Z",
+                },
+            },
+        };
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(false);
+    });
+    it("validates multiple channels", () => {
+        const state = {
+            version: 1,
+            agentName: "test-agent",
+            channels: {
+                "channel-1": {
+                    sessionId: "session-1",
+                    lastMessageAt: "2024-01-15T10:30:00.000Z",
+                },
+                "channel-2": {
+                    sessionId: "session-2",
+                    lastMessageAt: "2024-01-15T11:30:00.000Z",
+                },
+            },
+        };
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(Object.keys(result.data.channels)).toHaveLength(2);
+        }
+    });
+});
+// =============================================================================
+// Factory Function Tests
+// =============================================================================
+describe("createInitialSessionState", () => {
+    it("creates initial state with correct values", () => {
+        const state = createInitialSessionState("my-agent");
+        expect(state.version).toBe(1);
+        expect(state.agentName).toBe("my-agent");
+        expect(state.channels).toEqual({});
+    });
+    it("creates valid schema-compliant state", () => {
+        const state = createInitialSessionState("test-agent");
+        const result = DiscordSessionStateSchema.safeParse(state);
+        expect(result.success).toBe(true);
+    });
+});
+describe("createChannelSession", () => {
+    it("creates session with provided sessionId", () => {
+        const session = createChannelSession("my-session-id");
+        expect(session.sessionId).toBe("my-session-id");
+        expect(session.lastMessageAt).toBeTruthy();
+    });
+    it("sets lastMessageAt to current time", () => {
+        const before = new Date();
+        const session = createChannelSession("test-session");
+        const after = new Date();
+        const timestamp = new Date(session.lastMessageAt);
+        expect(timestamp.getTime()).toBeGreaterThanOrEqual(before.getTime());
+        expect(timestamp.getTime()).toBeLessThanOrEqual(after.getTime());
+    });
+    it("creates valid schema-compliant session", () => {
+        const session = createChannelSession("test-session");
+        const result = ChannelSessionSchema.safeParse(session);
+        expect(result.success).toBe(true);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/session-manager/__tests__/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../../src/session-manager/__tests__/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,kBAAkB;YAC7B,aAAa,EAAE,0BAA0B;SAC1C,CAAC;QAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,0BAA0B;SAC1C,CAAC;QAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,kBAAkB;YAC7B,aAAa,EAAE,YAAY;SAC5B,CAAC;QAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,QAAQ,GAAG;YACf,EAAE,SAAS,EAAE,MAAM,EAAE;YACrB,EAAE,aAAa,EAAE,0BAA0B,EAAE;YAC7C,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,YAAY;YACvB,QAAQ,EAAE;gBACR,aAAa,EAAE;oBACb,SAAS,EAAE,kBAAkB;oBAC7B,aAAa,EAAE,0BAA0B;iBAC1C;aACF;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CACxD,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,YAAY;YACvB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,YAAY;YACvB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,EAAE;YACb,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,YAAY;YACvB,QAAQ,EAAE;gBACR,aAAa,EAAE;oBACb,SAAS,EAAE,EAAE;oBACb,aAAa,EAAE,0BAA0B;iBAC1C;aACF;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,KAAK,GAAG;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,YAAY;YACvB,QAAQ,EAAE;gBACR,WAAW,EAAE;oBACX,SAAS,EAAE,WAAW;oBACtB,aAAa,EAAE,0BAA0B;iBAC1C;gBACD,WAAW,EAAE;oBACX,SAAS,EAAE,WAAW;oBACtB,aAAa,EAAE,0BAA0B;iBAC1C;aACF;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;QAEpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;QAEtD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QAEzB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/session-manager/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Error classes for Discord session management
+ *
+ * Provides typed errors for session persistence and retrieval failures.
+ */
+/**
+ * Error codes for session manager operations
+ */
+export declare enum SessionErrorCode {
+    STATE_READ_FAILED = "SESSION_STATE_READ_FAILED",
+    STATE_WRITE_FAILED = "SESSION_STATE_WRITE_FAILED",
+    DIRECTORY_CREATE_FAILED = "SESSION_DIRECTORY_CREATE_FAILED",
+    SESSION_NOT_FOUND = "SESSION_NOT_FOUND",
+    SESSION_EXPIRED = "SESSION_EXPIRED",
+    INVALID_STATE = "SESSION_INVALID_STATE"
+}
+/**
+ * Base error class for session manager operations
+ */
+export declare class SessionManagerError extends Error {
+    readonly code: SessionErrorCode;
+    readonly agentName: string;
+    constructor(message: string, code: SessionErrorCode, agentName: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when session state file cannot be read
+ */
+export declare class SessionStateReadError extends SessionManagerError {
+    readonly path: string;
+    constructor(agentName: string, path: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when session state file cannot be written
+ */
+export declare class SessionStateWriteError extends SessionManagerError {
+    readonly path: string;
+    constructor(agentName: string, path: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when session directory cannot be created
+ */
+export declare class SessionDirectoryCreateError extends SessionManagerError {
+    readonly path: string;
+    constructor(agentName: string, path: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Type guard to check if an error is a SessionManagerError
+ */
+export declare function isSessionManagerError(error: unknown): error is SessionManagerError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/session-manager/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/session-manager/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,iBAAiB,8BAA8B;IAC/C,kBAAkB,+BAA+B;IACjD,uBAAuB,oCAAoC;IAC3D,iBAAiB,sBAAsB;IACvC,eAAe,oBAAoB;IACnC,aAAa,0BAA0B;CACxC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IACvC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAO9B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;IAC5D,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAW9B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC7D,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAW9B;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,mBAAmB;IAClE,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAW9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAE9B"}

package/dist/session-manager/errors.js

@@ -0,0 +1,70 @@
+/**
+ * Error classes for Discord session management
+ *
+ * Provides typed errors for session persistence and retrieval failures.
+ */
+/**
+ * Error codes for session manager operations
+ */
+export var SessionErrorCode;
+(function (SessionErrorCode) {
+    SessionErrorCode["STATE_READ_FAILED"] = "SESSION_STATE_READ_FAILED";
+    SessionErrorCode["STATE_WRITE_FAILED"] = "SESSION_STATE_WRITE_FAILED";
+    SessionErrorCode["DIRECTORY_CREATE_FAILED"] = "SESSION_DIRECTORY_CREATE_FAILED";
+    SessionErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+    SessionErrorCode["SESSION_EXPIRED"] = "SESSION_EXPIRED";
+    SessionErrorCode["INVALID_STATE"] = "SESSION_INVALID_STATE";
+})(SessionErrorCode || (SessionErrorCode = {}));
+/**
+ * Base error class for session manager operations
+ */
+export class SessionManagerError extends Error {
+    code;
+    agentName;
+    constructor(message, code, agentName, options) {
+        super(message, options);
+        this.name = "SessionManagerError";
+        this.code = code;
+        this.agentName = agentName;
+    }
+}
+/**
+ * Error thrown when session state file cannot be read
+ */
+export class SessionStateReadError extends SessionManagerError {
+    path;
+    constructor(agentName, path, options) {
+        super(`Failed to read session state for agent '${agentName}' from '${path}'`, SessionErrorCode.STATE_READ_FAILED, agentName, options);
+        this.name = "SessionStateReadError";
+        this.path = path;
+    }
+}
+/**
+ * Error thrown when session state file cannot be written
+ */
+export class SessionStateWriteError extends SessionManagerError {
+    path;
+    constructor(agentName, path, options) {
+        super(`Failed to write session state for agent '${agentName}' to '${path}'`, SessionErrorCode.STATE_WRITE_FAILED, agentName, options);
+        this.name = "SessionStateWriteError";
+        this.path = path;
+    }
+}
+/**
+ * Error thrown when session directory cannot be created
+ */
+export class SessionDirectoryCreateError extends SessionManagerError {
+    path;
+    constructor(agentName, path, options) {
+        super(`Failed to create session directory for agent '${agentName}' at '${path}'`, SessionErrorCode.DIRECTORY_CREATE_FAILED, agentName, options);
+        this.name = "SessionDirectoryCreateError";
+        this.path = path;
+    }
+}
+/**
+ * Type guard to check if an error is a SessionManagerError
+ */
+export function isSessionManagerError(error) {
+    return error instanceof SessionManagerError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/session-manager/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/session-manager/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IAC1B,mEAA+C,CAAA;IAC/C,qEAAiD,CAAA;IACjD,+EAA2D,CAAA;IAC3D,2DAAuC,CAAA;IACvC,uDAAmC,CAAA;IACnC,2DAAuC,CAAA;AACzC,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,SAAS,CAAS;IAElC,YACE,OAAe,EACf,IAAsB,EACtB,SAAiB,EACjB,OAA2B;QAE3B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,mBAAmB;IAC5C,IAAI,CAAS;IAE7B,YACE,SAAiB,EACjB,IAAY,EACZ,OAA2B;QAE3B,KAAK,CACH,2CAA2C,SAAS,WAAW,IAAI,GAAG,EACtE,gBAAgB,CAAC,iBAAiB,EAClC,SAAS,EACT,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAC7C,IAAI,CAAS;IAE7B,YACE,SAAiB,EACjB,IAAY,EACZ,OAA2B;QAE3B,KAAK,CACH,4CAA4C,SAAS,SAAS,IAAI,GAAG,EACrE,gBAAgB,CAAC,kBAAkB,EACnC,SAAS,EACT,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,mBAAmB;IAClD,IAAI,CAAS;IAE7B,YACE,SAAiB,EACjB,IAAY,EACZ,OAA2B;QAE3B,KAAK,CACH,iDAAiD,SAAS,SAAS,IAAI,GAAG,EAC1E,gBAAgB,CAAC,uBAAuB,EACxC,SAAS,EACT,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAc;IAEd,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC9C,CAAC"}

package/dist/session-manager/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Session manager module for Discord channel conversations
+ *
+ * Provides per-channel session management for Claude conversations,
+ * enabling conversation context preservation across Discord channels.
+ */
+export { SessionManager } from "./session-manager.js";
+export type { SessionManagerOptions, SessionManagerLogger, ISessionManager, SessionResult, ChannelSession, DiscordSessionState, } from "./types.js";
+export { DiscordSessionStateSchema, ChannelSessionSchema, createInitialSessionState, createChannelSession, } from "./types.js";
+export { SessionErrorCode, SessionManagerError, SessionStateReadError, SessionStateWriteError, SessionDirectoryCreateError, isSessionManagerError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/session-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session-manager/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/session-manager/index.js

@@ -0,0 +1,12 @@
+/**
+ * Session manager module for Discord channel conversations
+ *
+ * Provides per-channel session management for Claude conversations,
+ * enabling conversation context preservation across Discord channels.
+ */
+// Main class
+export { SessionManager } from "./session-manager.js";
+export { DiscordSessionStateSchema, ChannelSessionSchema, createInitialSessionState, createChannelSession, } from "./types.js";
+// Errors
+export { SessionErrorCode, SessionManagerError, SessionStateReadError, SessionStateWriteError, SessionDirectoryCreateError, isSessionManagerError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/session-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session-manager/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYtD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/session-manager/session-manager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Session manager for Discord channel conversations
+ *
+ * Provides per-channel session management for Claude conversations,
+ * enabling conversation context preservation across Discord channels.
+ *
+ * Sessions are stored at .herdctl/discord-sessions/<agent-name>.yaml
+ */
+import { type SessionManagerOptions, type ISessionManager, type SessionResult, type ChannelSession } from "./types.js";
+/**
+ * SessionManager manages per-channel Claude sessions for a Discord agent.
+ *
+ * Each agent has its own SessionManager instance, storing session mappings
+ * in a YAML file at .herdctl/discord-sessions/<agent-name>.yaml
+ *
+ * Features:
+ * - Create new sessions for channels/DMs
+ * - Resume existing sessions when user sends messages
+ * - Automatic session expiry based on configurable timeout
+ * - Cleanup expired sessions on startup
+ *
+ * @example
+ * ```typescript
+ * const sessionManager = new SessionManager({
+ *   agentName: 'my-agent',
+ *   stateDir: '.herdctl',
+ *   sessionExpiryHours: 24,
+ * });
+ *
+ * // Get or create a session for a channel
+ * const { sessionId, isNew } = await sessionManager.getOrCreateSession('channel-123');
+ *
+ * // After sending/receiving a message
+ * await sessionManager.touchSession('channel-123');
+ *
+ * // Cleanup expired sessions on startup
+ * const cleanedUp = await sessionManager.cleanupExpiredSessions();
+ * ```
+ */
+export declare class SessionManager implements ISessionManager {
+    readonly agentName: string;
+    private readonly stateDir;
+    private readonly sessionExpiryHours;
+    private readonly logger;
+    private readonly stateFilePath;
+    private state;
+    constructor(options: SessionManagerOptions);
+    /**
+     * Get or create a session for a channel/DM
+     *
+     * If an active (non-expired) session exists, returns it.
+     * Otherwise, creates a new session with a generated session ID.
+     */
+    getOrCreateSession(channelId: string): Promise<SessionResult>;
+    /**
+     * Update the last message timestamp for a session
+     */
+    touchSession(channelId: string): Promise<void>;
+    /**
+     * Get an existing session without creating one
+     *
+     * Returns null if no session exists or if the session is expired.
+     */
+    getSession(channelId: string): Promise<ChannelSession | null>;
+    /**
+     * Clear a specific session
+     */
+    clearSession(channelId: string): Promise<boolean>;
+    /**
+     * Clean up all expired sessions
+     *
+     * Should be called on connector startup and periodically.
+     */
+    cleanupExpiredSessions(): Promise<number>;
+    /**
+     * Generate a unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Check if a session is expired
+     */
+    private isSessionExpired;
+    /**
+     * Load session state from disk
+     *
+     * Returns cached state if available, otherwise loads from file.
+     * Creates initial state if file doesn't exist.
+     */
+    private loadState;
+    /**
+     * Save session state to disk atomically
+     */
+    private saveState;
+    /**
+     * Ensure the discord-sessions directory exists
+     */
+    private ensureDirectoryExists;
+    /**
+     * Generate a temp file path for atomic writes
+     */
+    private generateTempPath;
+    /**
+     * Rename with retry logic for Windows compatibility
+     */
+    private renameWithRetry;
+}
+//# sourceMappingURL=session-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session-manager/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EAKpB,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAGvC,OAAO,CAAC,KAAK,CAAoC;gBAErC,OAAO,EAAE,qBAAqB;IAmB1C;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkCnE;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsBnE;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAevD;;;;OAIG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC;IA8B/C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;;;OAKG;YACW,SAAS;IAyDvB;;OAEG;YACW,SAAS;IA8BvB;;OAEG;YACW,qBAAqB;IAiBnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;YACW,eAAe;CA+B9B"}