@animalabs/membrane 0.5.50 → 0.5.52

package/dist/types/content.js

@@ -0,0 +1,40 @@
+/**
+ * Content block types for normalized messages
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+export function isTextContent(block) {
+    return block.type === 'text';
+}
+export function isImageContent(block) {
+    return block.type === 'image';
+}
+export function isDocumentContent(block) {
+    return block.type === 'document';
+}
+export function isAudioContent(block) {
+    return block.type === 'audio';
+}
+export function isVideoContent(block) {
+    return block.type === 'video';
+}
+export function isGeneratedImageContent(block) {
+    return block.type === 'generated_image';
+}
+export function isToolUseContent(block) {
+    return block.type === 'tool_use';
+}
+export function isToolResultContent(block) {
+    return block.type === 'tool_result';
+}
+export function isThinkingContent(block) {
+    return block.type === 'thinking';
+}
+export function isRedactedThinkingContent(block) {
+    return block.type === 'redacted_thinking';
+}
+export function isMediaContent(block) {
+    return ['image', 'document', 'audio', 'video'].includes(block.type);
+}
+//# sourceMappingURL=content.js.map

package/dist/types/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwIH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,OAAO,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAmB;IAC3D,OAAO,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAmB;IAEnB,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Error types for membrane
+ */
+/**
+ * Serialize an error for storage in rawError field.
+ * Error objects don't JSON.stringify well (become {}), so we extract key properties.
+ */
+export declare function serializeError(error: unknown): unknown;
+export type MembraneErrorType = 'rate_limit' | 'context_length' | 'invalid_request' | 'auth' | 'server' | 'network' | 'timeout' | 'abort' | 'safety' | 'unsupported' | 'unknown';
+export interface ErrorInfo {
+    /** Normalized error type */
+    type: MembraneErrorType;
+    /** Human-readable message */
+    message: string;
+    /** Whether this error is retryable */
+    retryable: boolean;
+    /** Retry after (milliseconds) - for rate limits */
+    retryAfterMs?: number;
+    /** HTTP status code if available */
+    httpStatus?: number;
+    /** Provider-specific error code */
+    providerErrorCode?: string;
+    /** Raw error object */
+    rawError: unknown;
+    /** Raw request that caused the error (for logging) */
+    rawRequest?: unknown;
+}
+export declare class MembraneError extends Error {
+    readonly type: MembraneErrorType;
+    readonly retryable: boolean;
+    readonly retryAfterMs?: number;
+    readonly httpStatus?: number;
+    readonly providerErrorCode?: string;
+    readonly rawError?: unknown;
+    readonly rawRequest?: unknown;
+    constructor(info: ErrorInfo);
+    toErrorInfo(): ErrorInfo;
+}
+export declare function rateLimitError(message: string, retryAfterMs?: number, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function contextLengthError(message: string, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function invalidRequestError(message: string, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function authError(message: string, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function serverError(message: string, httpStatus?: number, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function networkError(message: string, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function timeoutError(message: string, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function abortError(message?: string, rawRequest?: unknown): MembraneError;
+export declare function safetyError(message: string, raw?: unknown, rawRequest?: unknown): MembraneError;
+export declare function unsupportedError(message: string, rawRequest?: unknown): MembraneError;
+export declare function classifyError(error: unknown): ErrorInfo;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA0BtD;AAMD,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,SAAS,GACT,OAAO,GACP,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAMd,MAAM,WAAW,SAAS;IACxB,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IAExB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IAEnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAElB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,IAAI,EAAE,SAAS;IAa3B,WAAW,IAAI,SAAS;CAYzB;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAUzH;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAStG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CASvG;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAS7F;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CASpH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAQhG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAQhG;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,MAA8B,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAQvG;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAQ/F;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,aAAa,CAQrF;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CA2FvD"}

package/dist/types/errors.js

@@ -0,0 +1,253 @@
+/**
+ * Error types for membrane
+ */
+// ============================================================================
+// Error Serialization Helper
+// ============================================================================
+/**
+ * Serialize an error for storage in rawError field.
+ * Error objects don't JSON.stringify well (become {}), so we extract key properties.
+ */
+export function serializeError(error) {
+    if (error === undefined || error === null) {
+        return error;
+    }
+    if (error instanceof Error) {
+        const serialized = {
+            name: error.name,
+            message: error.message,
+        };
+        // Include stack trace in non-production
+        if (process.env.NODE_ENV !== 'production' && error.stack) {
+            serialized.stack = error.stack;
+        }
+        // Copy any additional enumerable properties (like status, code, etc.)
+        for (const key of Object.keys(error)) {
+            serialized[key] = error[key];
+        }
+        return serialized;
+    }
+    // For non-Error objects, return as-is (they should serialize fine)
+    return error;
+}
+// ============================================================================
+// Membrane Error Class
+// ============================================================================
+export class MembraneError extends Error {
+    type;
+    retryable;
+    retryAfterMs;
+    httpStatus;
+    providerErrorCode;
+    rawError;
+    rawRequest;
+    constructor(info) {
+        super(info.message);
+        this.name = 'MembraneError';
+        this.type = info.type;
+        this.retryable = info.retryable;
+        this.retryAfterMs = info.retryAfterMs;
+        this.httpStatus = info.httpStatus;
+        this.providerErrorCode = info.providerErrorCode;
+        // Serialize error objects so they don't become {} when JSON.stringify'd
+        this.rawError = serializeError(info.rawError);
+        this.rawRequest = info.rawRequest;
+    }
+    toErrorInfo() {
+        return {
+            type: this.type,
+            message: this.message,
+            retryable: this.retryable,
+            retryAfterMs: this.retryAfterMs,
+            httpStatus: this.httpStatus,
+            providerErrorCode: this.providerErrorCode,
+            rawError: this.rawError,
+            rawRequest: this.rawRequest,
+        };
+    }
+}
+// ============================================================================
+// Error Factory Functions
+// ============================================================================
+export function rateLimitError(message, retryAfterMs, raw, rawRequest) {
+    return new MembraneError({
+        type: 'rate_limit',
+        message,
+        retryable: true,
+        retryAfterMs,
+        httpStatus: 429,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function contextLengthError(message, raw, rawRequest) {
+    return new MembraneError({
+        type: 'context_length',
+        message,
+        retryable: false,
+        httpStatus: 400,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function invalidRequestError(message, raw, rawRequest) {
+    return new MembraneError({
+        type: 'invalid_request',
+        message,
+        retryable: false,
+        httpStatus: 400,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function authError(message, raw, rawRequest) {
+    return new MembraneError({
+        type: 'auth',
+        message,
+        retryable: false,
+        httpStatus: 401,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function serverError(message, httpStatus, raw, rawRequest) {
+    return new MembraneError({
+        type: 'server',
+        message,
+        retryable: true,
+        httpStatus: httpStatus ?? 500,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function networkError(message, raw, rawRequest) {
+    return new MembraneError({
+        type: 'network',
+        message,
+        retryable: true,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function timeoutError(message, raw, rawRequest) {
+    return new MembraneError({
+        type: 'timeout',
+        message,
+        retryable: true,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function abortError(message = 'Request was aborted', rawRequest) {
+    return new MembraneError({
+        type: 'abort',
+        message,
+        retryable: false,
+        rawError: undefined,
+        rawRequest,
+    });
+}
+export function safetyError(message, raw, rawRequest) {
+    return new MembraneError({
+        type: 'safety',
+        message,
+        retryable: false,
+        rawError: raw,
+        rawRequest,
+    });
+}
+export function unsupportedError(message, rawRequest) {
+    return new MembraneError({
+        type: 'unsupported',
+        message,
+        retryable: false,
+        rawError: undefined,
+        rawRequest,
+    });
+}
+// ============================================================================
+// Error Classification
+// ============================================================================
+export function classifyError(error) {
+    if (error instanceof MembraneError) {
+        return error.toErrorInfo();
+    }
+    // Serialize the error once for use in all return paths
+    const serializedError = serializeError(error);
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        // Rate limit
+        if (message.includes('rate') || message.includes('429') || message.includes('too many')) {
+            return {
+                type: 'rate_limit',
+                message: error.message,
+                retryable: true,
+                httpStatus: 429,
+                rawError: serializedError,
+            };
+        }
+        // Context length
+        if (message.includes('context') || message.includes('too long') || message.includes('maximum')) {
+            return {
+                type: 'context_length',
+                message: error.message,
+                retryable: false,
+                rawError: serializedError,
+            };
+        }
+        // Auth
+        if (message.includes('auth') || message.includes('401') || message.includes('api key')) {
+            return {
+                type: 'auth',
+                message: error.message,
+                retryable: false,
+                httpStatus: 401,
+                rawError: serializedError,
+            };
+        }
+        // Network
+        if (message.includes('network') || message.includes('econnreset') || message.includes('socket')) {
+            return {
+                type: 'network',
+                message: error.message,
+                retryable: true,
+                rawError: serializedError,
+            };
+        }
+        // Timeout
+        if (message.includes('timeout') || message.includes('timed out')) {
+            return {
+                type: 'timeout',
+                message: error.message,
+                retryable: true,
+                rawError: serializedError,
+            };
+        }
+        // Abort
+        if (message.includes('abort') || error.name === 'AbortError') {
+            return {
+                type: 'abort',
+                message: error.message,
+                retryable: false,
+                rawError: serializedError,
+            };
+        }
+        // Server error
+        if (message.includes('500') || message.includes('502') || message.includes('503') || message.includes('504')) {
+            return {
+                type: 'server',
+                message: error.message,
+                retryable: true,
+                rawError: serializedError,
+            };
+        }
+    }
+    // Unknown
+    return {
+        type: 'unknown',
+        message: error instanceof Error ? error.message : String(error),
+        retryable: false,
+        rawError: serializedError,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Type exports for membrane
+ */
+export type { CacheControl, MediaSource, Base64Source, UrlSource, ContentBlock, TextContent, ImageContent, DocumentContent, AudioContent, VideoContent, GeneratedImageContent, ToolUseContent, ToolResultContent, ThinkingContent, RedactedThinkingContent, } from './content.js';
+export { isTextContent, isImageContent, isDocumentContent, isAudioContent, isVideoContent, isGeneratedImageContent, isToolUseContent, isToolResultContent, isThinkingContent, isRedactedThinkingContent, isMediaContent, } from './content.js';
+export type { MessageMetadata, NormalizedMessage, } from './message.js';
+export { textMessage, extractText, hasMedia, hasToolUse, } from './message.js';
+export type { ToolParameter, ToolDefinition, ToolCall, ToolResult, ToolResultContentBlock, ToolContext, ParsedToolCalls, } from './tools.js';
+export type { GenerationConfig, StopSequenceStrategy, StopSequenceConfig, RequestOptions, NormalizedRequest, ToolMode, } from './request.js';
+export type { StopReason, BasicUsage, DetailedUsage, CostBreakdown, StopInfo, ModelInfo, TimingInfo, CacheInfo, ResponseDetails, RawAccess, NormalizedResponse, AbortedResponse, } from './response.js';
+export { isAbortedResponse } from './response.js';
+export type { ProviderQuirks, MediaCapabilities, ProviderCapabilities, ModelPricing, ModelDefinition, ModelRegistry, ModelFilter, ProviderAdapter, ProviderRequest, ProviderRequestOptions, ProviderResponse, StreamCallbacks, } from './provider.js';
+export type { StreamState, StreamOptions, CompleteOptions, OnChunkCallback, OnContentBlockCallback, OnToolCallsCallback, OnPreToolContentCallback, OnUsageCallback, OnBlockCallback, OnRequestCallback, OnResponseCallback, BlockEvent, BlockDelta, } from './streaming.js';
+export type { TokensEvent, StreamBlockEvent, ToolCallsEvent, UsageEvent, CompleteEvent, ErrorEvent, AbortedEvent, StreamEvent, YieldingStream, YieldingStreamOptions, } from './yielding-stream.js';
+export { isTokensEvent, isToolCallsEvent, isCompleteEvent, isErrorEvent, isAbortedEvent, isTerminalEvent, } from './yielding-stream.js';
+export type { MembraneErrorType, ErrorInfo, } from './errors.js';
+export { MembraneError, serializeError, rateLimitError, contextLengthError, invalidRequestError, authError, serverError, networkError, timeoutError, abortError, safetyError, unsupportedError, classifyError, } from './errors.js';
+export type { RetryConfig, MediaConfig, MembraneHooks, MembraneLogger, MembraneConfig, } from './config.js';
+export { DEFAULT_RETRY_CONFIG, DEFAULT_MEDIA_CONFIG, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -0,0 +1,10 @@
+/**
+ * Type exports for membrane
+ */
+export { isTextContent, isImageContent, isDocumentContent, isAudioContent, isVideoContent, isGeneratedImageContent, isToolUseContent, isToolResultContent, isThinkingContent, isRedactedThinkingContent, isMediaContent, } from './content.js';
+export { textMessage, extractText, hasMedia, hasToolUse, } from './message.js';
+export { isAbortedResponse } from './response.js';
+export { isTokensEvent, isToolCallsEvent, isCompleteEvent, isErrorEvent, isAbortedEvent, isTerminalEvent, } from './yielding-stream.js';
+export { MembraneError, serializeError, rateLimitError, contextLengthError, invalidRequestError, authError, serverError, networkError, timeoutError, abortError, safetyError, unsupportedError, classifyError, } from './errors.js';
+export { DEFAULT_RETRY_CONFIG, DEFAULT_MEDIA_CONFIG, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,GACf,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAuCtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAiDlD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,GACd,MAAM,aAAa,CAAC;AAWrB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/types/message.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Normalized message types
+ */
+import type { ContentBlock, CacheControl } from './content.js';
+export type { CacheControl } from './content.js';
+export interface MessageMetadata {
+    /** Original timestamp */
+    timestamp?: Date;
+    /** Source ID from originating system (Discord message ID, UI message ID, etc.) */
+    sourceId?: string;
+    /** Cache control for this message */
+    cacheControl?: CacheControl;
+    /** Stream routing (for VEIL/connectome compatibility) */
+    streamId?: string;
+    /** Additional metadata (pass-through) */
+    [key: string]: unknown;
+}
+/**
+ * A message from a single participant.
+ * This is the core abstraction - no artificial "user" vs "assistant" roles.
+ */
+export interface NormalizedMessage {
+    /** Participant name: "Alice", "Bob", "Claude", etc. */
+    participant: string;
+    /** Content blocks */
+    content: ContentBlock[];
+    /** Message metadata */
+    metadata?: MessageMetadata;
+    /**
+     * Cache breakpoint for Anthropic prompt caching.
+     * When true, content up to and including this message will have cache_control applied.
+     * Multiple messages can have cacheBreakpoint for multiple cache points.
+     */
+    cacheBreakpoint?: boolean;
+}
+/**
+ * Create a simple text message
+ */
+export declare function textMessage(participant: string, text: string, metadata?: MessageMetadata): NormalizedMessage;
+/**
+ * Extract all text content from a message
+ */
+export declare function extractText(message: NormalizedMessage): string;
+/**
+ * Check if message has any media content
+ */
+export declare function hasMedia(message: NormalizedMessage): boolean;
+/**
+ * Check if message has tool use
+ */
+export declare function hasToolUse(message: NormalizedMessage): boolean;
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG/D,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,qBAAqB;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAM5G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAI5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAE9D"}

package/dist/types/message.js

@@ -0,0 +1,38 @@
+/**
+ * Normalized message types
+ */
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Create a simple text message
+ */
+export function textMessage(participant, text, metadata) {
+    return {
+        participant,
+        content: [{ type: 'text', text }],
+        metadata,
+    };
+}
+/**
+ * Extract all text content from a message
+ */
+export function extractText(message) {
+    return message.content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('\n');
+}
+/**
+ * Check if message has any media content
+ */
+export function hasMedia(message) {
+    return message.content.some((block) => ['image', 'document', 'audio', 'video'].includes(block.type));
+}
+/**
+ * Check if message has tool use
+ */
+export function hasToolUse(message) {
+    return message.content.some((block) => block.type === 'tool_use');
+}
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsDH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,IAAY,EAAE,QAA0B;IACvF,OAAO;QACL,WAAW;QACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,OAAO,OAAO,CAAC,OAAO;SACnB,MAAM,CAAC,CAAC,KAAK,EAA2C,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SACjF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAA0B;IACjD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACpC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AACpE,CAAC"}