cyrus-core 0.2.21 → 0.2.22

package/dist/logging/ILogger.d.ts

@@ -0,0 +1,23 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+export interface LogContext {
+    sessionId?: string;
+    platform?: string;
+    issueIdentifier?: string;
+    repository?: string;
+}
+export interface ILogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    withContext(context: LogContext): ILogger;
+    getLevel(): LogLevel;
+    setLevel(level: LogLevel): void;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/logging/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../src/logging/ILogger.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACV;AAED,MAAM,WAAW,UAAU;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACvB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;IAC1C,QAAQ,IAAI,QAAQ,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC"}

package/dist/logging/ILogger.js

@@ -0,0 +1,9 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+//# sourceMappingURL=ILogger.js.map

package/dist/logging/ILogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.js","sourceRoot":"","sources":["../../src/logging/ILogger.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IACnB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,2CAAU,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB"}

package/dist/logging/Logger.d.ts

@@ -0,0 +1,8 @@
+import type { ILogger, LogContext } from "./ILogger.js";
+import { LogLevel } from "./ILogger.js";
+export declare function createLogger(options: {
+    component: string;
+    level?: LogLevel;
+    context?: LogContext;
+}): ILogger;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logging/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA4GxC,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAEV"}

package/dist/logging/Logger.js

@@ -0,0 +1,94 @@
+import { LogLevel } from "./ILogger.js";
+function formatContext(context) {
+    const parts = [];
+    if (context.sessionId) {
+        parts.push(`session=${context.sessionId.slice(0, 8)}`);
+    }
+    if (context.platform) {
+        parts.push(`platform=${context.platform}`);
+    }
+    if (context.issueIdentifier) {
+        parts.push(`issue=${context.issueIdentifier}`);
+    }
+    if (context.repository) {
+        parts.push(`repo=${context.repository}`);
+    }
+    return parts.length > 0 ? ` {${parts.join(", ")}}` : "";
+}
+function parseLevelFromEnv() {
+    const envLevel = process.env.CYRUS_LOG_LEVEL?.toUpperCase();
+    switch (envLevel) {
+        case "DEBUG":
+            return LogLevel.DEBUG;
+        case "INFO":
+            return LogLevel.INFO;
+        case "WARN":
+            return LogLevel.WARN;
+        case "ERROR":
+            return LogLevel.ERROR;
+        case "SILENT":
+            return LogLevel.SILENT;
+        default:
+            return undefined;
+    }
+}
+const LEVEL_LABELS = {
+    [LogLevel.DEBUG]: "DEBUG",
+    [LogLevel.INFO]: "INFO",
+    [LogLevel.WARN]: "WARN",
+    [LogLevel.ERROR]: "ERROR",
+    [LogLevel.SILENT]: "",
+};
+class Logger {
+    level;
+    component;
+    context;
+    constructor(options) {
+        this.component = options.component;
+        this.level = options.level ?? parseLevelFromEnv() ?? LogLevel.INFO;
+        this.context = options.context ?? {};
+    }
+    formatPrefix(level) {
+        const label = LEVEL_LABELS[level];
+        const padded = label.padEnd(5);
+        const ctx = formatContext(this.context);
+        return `[${padded}] [${this.component}]${ctx}`;
+    }
+    debug(message, ...args) {
+        if (this.level <= LogLevel.DEBUG) {
+            console.log(`${this.formatPrefix(LogLevel.DEBUG)} ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.level <= LogLevel.INFO) {
+            console.log(`${this.formatPrefix(LogLevel.INFO)} ${message}`, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.level <= LogLevel.WARN) {
+            console.warn(`${this.formatPrefix(LogLevel.WARN)} ${message}`, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.level <= LogLevel.ERROR) {
+            console.error(`${this.formatPrefix(LogLevel.ERROR)} ${message}`, ...args);
+        }
+    }
+    withContext(context) {
+        return new Logger({
+            component: this.component,
+            level: this.level,
+            context: { ...this.context, ...context },
+        });
+    }
+    getLevel() {
+        return this.level;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+}
+export function createLogger(options) {
+    return new Logger(options);
+}
+//# sourceMappingURL=Logger.js.map

package/dist/logging/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/logging/Logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,SAAS,aAAa,CAAC,OAAmB;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,iBAAiB;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,EAAE,CAAC;IAC5D,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,OAAO;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,MAAM;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC;QACtB,KAAK,MAAM;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC;QACtB,KAAK,OAAO;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,QAAQ;YACZ,OAAO,QAAQ,CAAC,MAAM,CAAC;QACxB;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED,MAAM,YAAY,GAA6B;IAC9C,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;CACrB,CAAC;AAEF,MAAM,MAAM;IACH,KAAK,CAAW;IAChB,SAAS,CAAS;IAClB,OAAO,CAAa;IAE5B,YAAY,OAIX;QACA,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,iBAAiB,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC;QACnE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,CAAC;IAEO,YAAY,CAAC,KAAe;QACnC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,MAAM,MAAM,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACxC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACzE,CAAC;IACF,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACxE,CAAC;IACF,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACzE,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACxC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3E,CAAC;IACF,CAAC;IAED,WAAW,CAAC,OAAmB;QAC9B,OAAO,IAAI,MAAM,CAAC;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE;SACxC,CAAC,CAAC;IACJ,CAAC;IAED,QAAQ;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,KAAe;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;CACD;AAED,MAAM,UAAU,YAAY,CAAC,OAI5B;IACA,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,4 @@
+export type { ILogger, LogContext } from "./ILogger.js";
+export { LogLevel } from "./ILogger.js";
+export { createLogger } from "./Logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,3 @@
+export { LogLevel } from "./ILogger.js";
+export { createLogger } from "./Logger.js";
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/messages/IMessageTranslator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Message Translator Interface
+ *
+ * This module defines the interface for translating platform-specific webhook
+ * payloads into unified internal messages.
+ *
+ * @module messages/IMessageTranslator
+ */
+import type { InternalMessage } from "./types.js";
+/**
+ * Result of a translation attempt.
+ * Translation can fail if the webhook is not relevant or malformed.
+ */
+export type TranslationResult = {
+    success: true;
+    message: InternalMessage;
+} | {
+    success: false;
+    reason: string;
+};
+/**
+ * Interface for platform-specific message translators.
+ *
+ * Each platform (Linear, GitHub, Slack) implements this interface to translate
+ * their webhook payloads into the unified InternalMessage format.
+ *
+ * @typeParam TWebhook - The platform-specific webhook payload type
+ */
+export interface IMessageTranslator<TWebhook> {
+    /**
+     * Translate a platform-specific webhook into an internal message.
+     *
+     * @param webhook - The platform-specific webhook payload
+     * @param context - Optional additional context needed for translation
+     * @returns TranslationResult indicating success with the message or failure with reason
+     *
+     * @example
+     * ```typescript
+     * const translator = new LinearMessageTranslator();
+     * const result = translator.translate(webhookPayload);
+     *
+     * if (result.success) {
+     *   handleMessage(result.message);
+     * } else {
+     *   console.log('Skipped webhook:', result.reason);
+     * }
+     * ```
+     */
+    translate(webhook: TWebhook, context?: TranslationContext): TranslationResult;
+    /**
+     * Check if this translator can handle the given webhook.
+     *
+     * @param webhook - The webhook payload to check
+     * @returns true if this translator can translate the webhook
+     */
+    canTranslate(webhook: unknown): webhook is TWebhook;
+}
+/**
+ * Context information that may be needed during translation.
+ */
+export interface TranslationContext {
+    /** Organization ID if not in the webhook */
+    organizationId?: string;
+    /** Linear API token for Linear webhooks */
+    linearApiToken?: string;
+    /** GitHub installation token for GitHub webhooks */
+    installationToken?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=IMessageTranslator.d.ts.map

package/dist/messages/IMessageTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMessageTranslator.d.ts","sourceRoot":"","sources":["../../src/messages/IMessageTranslator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC3C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ;IAC3C;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;IAE9E;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/messages/IMessageTranslator.js

@@ -0,0 +1,10 @@
+/**
+ * Message Translator Interface
+ *
+ * This module defines the interface for translating platform-specific webhook
+ * payloads into unified internal messages.
+ *
+ * @module messages/IMessageTranslator
+ */
+export {};
+//# sourceMappingURL=IMessageTranslator.js.map

package/dist/messages/IMessageTranslator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMessageTranslator.js","sourceRoot":"","sources":["../../src/messages/IMessageTranslator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/messages/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Internal Message Bus
+ *
+ * This module exports all types and utilities for the internal message bus
+ * that provides a unified interface for handling events from multiple
+ * webhook sources (Linear, GitHub, Slack, etc.).
+ *
+ * @module messages
+ */
+export type { IMessageTranslator, TranslationContext, TranslationResult, } from "./IMessageTranslator.js";
+export type { GitHubPlatformRef, LinearPlatformRef, SlackPlatformRef, } from "./platform-refs.js";
+export { hasGitHubSessionStartPlatformData, hasGitHubUserPromptPlatformData, hasLinearSessionStartPlatformData, hasLinearUserPromptPlatformData, hasSlackSessionStartPlatformData, hasSlackUserPromptPlatformData, isContentUpdateMessage, isGitHubMessage, isLinearMessage, isSessionStartMessage, isSlackMessage, isStopSignalMessage, isUnassignMessage, isUserPromptMessage, } from "./type-guards.js";
+export type { ContentChanges, ContentUpdateMessage, GitHubSessionStartPlatformData, GitHubUserPromptPlatformData, GuidanceItem, InternalMessage, InternalMessageBase, LinearContentUpdatePlatformData, LinearSessionStartPlatformData, LinearStopSignalPlatformData, LinearUnassignPlatformData, LinearUserPromptPlatformData, MessageAction, MessageAuthor, MessageSource, SessionStartMessage, SlackSessionStartPlatformData, SlackUserPromptPlatformData, StopSignalMessage, UnassignMessage, UserPromptMessage, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACX,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACN,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,+BAA+B,EAE/B,8BAA8B,EAC9B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,aAAa,EACb,aAAa,EACb,aAAa,EACb,mBAAmB,EAEnB,6BAA6B,EAC7B,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GACjB,MAAM,YAAY,CAAC"}

package/dist/messages/index.js

@@ -0,0 +1,12 @@
+/**
+ * Internal Message Bus
+ *
+ * This module exports all types and utilities for the internal message bus
+ * that provides a unified interface for handling events from multiple
+ * webhook sources (Linear, GitHub, Slack, etc.).
+ *
+ * @module messages
+ */
+// Type guards
+export { hasGitHubSessionStartPlatformData, hasGitHubUserPromptPlatformData, hasLinearSessionStartPlatformData, hasLinearUserPromptPlatformData, hasSlackSessionStartPlatformData, hasSlackUserPromptPlatformData, isContentUpdateMessage, isGitHubMessage, isLinearMessage, isSessionStartMessage, isSlackMessage, isStopSignalMessage, isUnassignMessage, isUserPromptMessage, } from "./type-guards.js";
+//# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,cAAc;AACd,OAAO,EACN,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/messages/platform-refs.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Platform-specific Reference Types
+ *
+ * These types define the platform-specific data structures that are preserved
+ * in the platformData field of internal messages. They provide type-safe access
+ * to the original webhook payload data when handlers need platform-specific details.
+ *
+ * @module messages/platform-refs
+ */
+import type * as LinearSDK from "@linear/sdk";
+/**
+ * Linear platform reference types.
+ * These map to Linear SDK types used in webhook payloads.
+ */
+export interface LinearPlatformRef {
+    /** Agent session data from webhook */
+    agentSession: {
+        /** Session ID */
+        id: string;
+        /** Session status */
+        status: string;
+        /** Session type */
+        type?: string;
+        /** External link */
+        externalLink?: string;
+        /** Creator ID */
+        creatorId?: string;
+        /** Comment that triggered the session (if any) */
+        comment?: {
+            id: string;
+            body?: string;
+        };
+        /** Issue associated with the session */
+        issue: LinearPlatformRef["issue"];
+    };
+    /** Issue data from webhook */
+    issue: {
+        /** Issue ID */
+        id: string;
+        /** Human-readable identifier (e.g., "DEF-123") */
+        identifier: string;
+        /** Issue title */
+        title: string;
+        /** Issue description */
+        description?: string;
+        /** Issue URL */
+        url: string;
+        /** Branch name */
+        branchName?: string;
+        /** Team associated with the issue */
+        team?: {
+            id: string;
+            name?: string;
+            key?: string;
+        };
+        /** Project associated with the issue */
+        project?: {
+            id: string;
+            name?: string;
+            key?: string;
+        };
+        /** Labels attached to the issue */
+        labels?: Array<{
+            id: string;
+            name: string;
+        }>;
+    };
+    /** Comment data from webhook */
+    comment: {
+        /** Comment ID */
+        id: string;
+        /** Comment body */
+        body?: string;
+        /** Comment author */
+        user?: {
+            id: string;
+            name?: string;
+            displayName?: string;
+            email?: string;
+        };
+    };
+    /** Agent activity data from webhook */
+    agentActivity: {
+        /** Activity ID */
+        id: string;
+        /** Activity type */
+        type?: string;
+        /** Activity signal (e.g., "stop") */
+        signal?: LinearSDK.AgentActivitySignal;
+        /** Activity content */
+        content?: {
+            /** Content type */
+            type?: string;
+            /** Content body (for user prompts) */
+            body?: string;
+        };
+    };
+}
+/**
+ * GitHub platform reference types.
+ * These map to GitHub webhook payload structures.
+ */
+export interface GitHubPlatformRef {
+    /** Repository data from webhook */
+    repository: {
+        /** Repository ID */
+        id: number;
+        /** Repository name */
+        name: string;
+        /** Full repository name (owner/repo) */
+        fullName: string;
+        /** Repository HTML URL */
+        htmlUrl: string;
+        /** Clone URL */
+        cloneUrl: string;
+        /** SSH URL */
+        sshUrl: string;
+        /** Default branch */
+        defaultBranch: string;
+        /** Repository owner */
+        owner: {
+            login: string;
+            id: number;
+        };
+    };
+    /** Pull request data from webhook */
+    pullRequest: {
+        /** PR ID */
+        id: number;
+        /** PR number */
+        number: number;
+        /** PR title */
+        title: string;
+        /** PR body */
+        body: string | null;
+        /** PR state */
+        state: string;
+        /** PR HTML URL */
+        htmlUrl: string;
+        /** Head branch ref */
+        headRef: string;
+        /** Head branch SHA */
+        headSha: string;
+        /** Base branch ref */
+        baseRef: string;
+        /** PR author */
+        user: {
+            login: string;
+            id: number;
+        };
+    };
+    /** Issue data from webhook (used for issue comments) */
+    issue: {
+        /** Issue ID */
+        id: number;
+        /** Issue number */
+        number: number;
+        /** Issue title */
+        title: string;
+        /** Issue body */
+        body: string | null;
+        /** Issue state */
+        state: string;
+        /** Issue HTML URL */
+        htmlUrl: string;
+        /** Issue author */
+        user: {
+            login: string;
+            id: number;
+        };
+        /** Present when the issue is actually a PR */
+        isPullRequest: boolean;
+    };
+    /** Comment data from webhook */
+    comment: {
+        /** Comment ID */
+        id: number;
+        /** Comment body */
+        body: string;
+        /** Comment HTML URL */
+        htmlUrl: string;
+        /** Comment author */
+        user: {
+            login: string;
+            id: number;
+            avatarUrl: string;
+        };
+        /** Comment creation timestamp */
+        createdAt: string;
+        /** For PR review comments: the file path */
+        path?: string;
+        /** For PR review comments: the diff hunk */
+        diffHunk?: string;
+    };
+}
+/**
+ * Slack platform reference types.
+ * Placeholder for future Slack integration.
+ */
+export interface SlackPlatformRef {
+    /** Channel data */
+    channel: {
+        /** Channel ID */
+        id: string;
+        /** Channel name */
+        name?: string;
+    };
+    /** Thread data */
+    thread: {
+        /** Thread timestamp */
+        ts: string;
+        /** Parent message timestamp */
+        parentTs?: string;
+    };
+    /** Message data */
+    message: {
+        /** Message timestamp */
+        ts: string;
+        /** Message text */
+        text: string;
+        /** Message author */
+        user: {
+            id: string;
+            name?: string;
+        };
+    };
+}
+//# sourceMappingURL=platform-refs.d.ts.map

package/dist/messages/platform-refs.d.ts.map

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

package/dist/messages/platform-refs.js

@@ -0,0 +1,11 @@
+/**
+ * Platform-specific Reference Types
+ *
+ * These types define the platform-specific data structures that are preserved
+ * in the platformData field of internal messages. They provide type-safe access
+ * to the original webhook payload data when handlers need platform-specific details.
+ *
+ * @module messages/platform-refs
+ */
+export {};
+//# sourceMappingURL=platform-refs.js.map

package/dist/messages/platform-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-refs.js","sourceRoot":"","sources":["../../src/messages/platform-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/messages/type-guards.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Type Guards for Internal Messages
+ *
+ * This module provides type guard functions for discriminating between
+ * different internal message types based on the `action` field.
+ *
+ * @module messages/type-guards
+ */
+import type { ContentUpdateMessage, GitHubSessionStartPlatformData, GitHubUserPromptPlatformData, InternalMessage, LinearSessionStartPlatformData, LinearUserPromptPlatformData, SessionStartMessage, SlackSessionStartPlatformData, SlackUserPromptPlatformData, StopSignalMessage, UnassignMessage, UserPromptMessage } from "./types.js";
+/**
+ * Type guard for SessionStartMessage.
+ */
+export declare function isSessionStartMessage(message: InternalMessage): message is SessionStartMessage;
+/**
+ * Type guard for UserPromptMessage.
+ */
+export declare function isUserPromptMessage(message: InternalMessage): message is UserPromptMessage;
+/**
+ * Type guard for StopSignalMessage.
+ */
+export declare function isStopSignalMessage(message: InternalMessage): message is StopSignalMessage;
+/**
+ * Type guard for ContentUpdateMessage.
+ */
+export declare function isContentUpdateMessage(message: InternalMessage): message is ContentUpdateMessage;
+/**
+ * Type guard for UnassignMessage.
+ */
+export declare function isUnassignMessage(message: InternalMessage): message is UnassignMessage;
+/**
+ * Type guard to check if message is from Linear.
+ */
+export declare function isLinearMessage(message: InternalMessage): boolean;
+/**
+ * Type guard to check if message is from GitHub.
+ */
+export declare function isGitHubMessage(message: InternalMessage): boolean;
+/**
+ * Type guard to check if message is from Slack.
+ */
+export declare function isSlackMessage(message: InternalMessage): boolean;
+/**
+ * Type guard for Linear platform data in SessionStartMessage.
+ */
+export declare function hasLinearSessionStartPlatformData(message: SessionStartMessage): message is SessionStartMessage & {
+    platformData: LinearSessionStartPlatformData;
+};
+/**
+ * Type guard for GitHub platform data in SessionStartMessage.
+ */
+export declare function hasGitHubSessionStartPlatformData(message: SessionStartMessage): message is SessionStartMessage & {
+    platformData: GitHubSessionStartPlatformData;
+};
+/**
+ * Type guard for Linear platform data in UserPromptMessage.
+ */
+export declare function hasLinearUserPromptPlatformData(message: UserPromptMessage): message is UserPromptMessage & {
+    platformData: LinearUserPromptPlatformData;
+};
+/**
+ * Type guard for GitHub platform data in UserPromptMessage.
+ */
+export declare function hasGitHubUserPromptPlatformData(message: UserPromptMessage): message is UserPromptMessage & {
+    platformData: GitHubUserPromptPlatformData;
+};
+/**
+ * Type guard for Slack platform data in SessionStartMessage.
+ */
+export declare function hasSlackSessionStartPlatformData(message: SessionStartMessage): message is SessionStartMessage & {
+    platformData: SlackSessionStartPlatformData;
+};
+/**
+ * Type guard for Slack platform data in UserPromptMessage.
+ */
+export declare function hasSlackUserPromptPlatformData(message: UserPromptMessage): message is UserPromptMessage & {
+    platformData: SlackUserPromptPlatformData;
+};
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/messages/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/messages/type-guards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,EAC5B,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,mBAAmB,CAEhC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,iBAAiB,CAE9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,iBAAiB,CAE9B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,oBAAoB,CAEjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,eAAe,GACtB,OAAO,IAAI,eAAe,CAE5B;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEhE;AAMD;;GAEG;AACH,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,mBAAmB,GAC1B,OAAO,IAAI,mBAAmB,GAAG;IACnC,YAAY,EAAE,8BAA8B,CAAC;CAC7C,CAEA;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,mBAAmB,GAC1B,OAAO,IAAI,mBAAmB,GAAG;IACnC,YAAY,EAAE,8BAA8B,CAAC;CAC7C,CAEA;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC9C,OAAO,EAAE,iBAAiB,GACxB,OAAO,IAAI,iBAAiB,GAAG;IACjC,YAAY,EAAE,4BAA4B,CAAC;CAC3C,CAEA;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC9C,OAAO,EAAE,iBAAiB,GACxB,OAAO,IAAI,iBAAiB,GAAG;IACjC,YAAY,EAAE,4BAA4B,CAAC;CAC3C,CAEA;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,mBAAmB,GAC1B,OAAO,IAAI,mBAAmB,GAAG;IACnC,YAAY,EAAE,6BAA6B,CAAC;CAC5C,CAEA;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,iBAAiB,GACxB,OAAO,IAAI,iBAAiB,GAAG;IACjC,YAAY,EAAE,2BAA2B,CAAC;CAC1C,CAEA"}