@makaio/contracts 1.0.0-dev-1779051654000

package/dist/session/schemas/message.d.ts

@@ -0,0 +1,266 @@
+import { z } from 'zod';
+import { type MessageBlock } from '../../shared/index.js';
+/**
+ * Session message block types for structured content within stored messages.
+ *
+ * Unified with MessageBlock — all block types (text, image, document, attachment,
+ * reasoning, tool_call, tool_output) are first-class citizens in both storage
+ * and SDK contexts.
+ */
+export declare const SessionMessageBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attachment">;
+    fileName: z.ZodString;
+    filePath: z.ZodString;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    displayName: z.ZodOptional<z.ZodString>;
+    attachmentType: z.ZodEnum<{
+        directory: "directory";
+        file: "file";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reasoning">;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    toolCallId: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output">;
+    toolCallId: z.ZodString;
+    output: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>], "type">;
+export type SessionMessageBlock = MessageBlock;
+/**
+ * Session message role in a conversation.
+ */
+export declare const SessionMessageRoleSchema: z.ZodEnum<{
+    assistant: "assistant";
+    user: "user";
+}>;
+export type SessionMessageRole = z.infer<typeof SessionMessageRoleSchema>;
+export declare const SessionMessageOriginSchema: z.ZodEnum<{
+    compact: "compact";
+    text: "text";
+    voice: "voice";
+}>;
+export type SessionMessageOrigin = z.infer<typeof SessionMessageOriginSchema>;
+/**
+ * A stored message in a session conversation.
+ *
+ * Distinct from `shared/Message` which is the SDK message format for runtime.
+ * SessionMessage includes storage metadata (messageId, turnId, timestamp, etc.).
+ *
+ * Messages are first-class entities stored in the `messages` table.
+ *
+ * Design principles:
+ * - Single source of truth for conversation content
+ * - Blocks preserve full response fidelity (reasoning, tools)
+ * - contentText extracted for FTS5 search
+ * - Events remain for lifecycle/audit only
+ */
+export declare const SessionMessageSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    turnId: z.ZodNullable<z.ZodString>;
+    sessionId: z.ZodString;
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    contentText: z.ZodString;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"url">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"document">;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"url">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attachment">;
+        fileName: z.ZodString;
+        filePath: z.ZodString;
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"url">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">;
+        displayName: z.ZodOptional<z.ZodString>;
+        attachmentType: z.ZodEnum<{
+            directory: "directory";
+            file: "file";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"reasoning">;
+        content: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_call">;
+        toolCallId: z.ZodString;
+        name: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_output">;
+        toolCallId: z.ZodString;
+        output: z.ZodString;
+        isError: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>], "type">>;
+    agentId: z.ZodOptional<z.ZodString>;
+    adapterSessionId: z.ZodOptional<z.ZodString>;
+    adapterMessageId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodNumber;
+    editOf: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        compact: "compact";
+        text: "text";
+        voice: "voice";
+    }>>;
+}, z.core.$strip>;
+export type SessionMessage = z.infer<typeof SessionMessageSchema>;
+/**
+ * Turn status in the conversation lifecycle.
+ */
+export declare const TurnStatusSchema: z.ZodEnum<{
+    active: "active";
+    completed: "completed";
+    error: "error";
+}>;
+export type TurnStatus = z.infer<typeof TurnStatusSchema>;
+/**
+ * Usage metrics for a single agent or aggregated total.
+ */
+export declare const UsageMetricsSchema: z.ZodObject<{
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    cost: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UsageMetrics = z.infer<typeof UsageMetricsSchema>;
+/**
+ * Aggregated usage for a turn, with optional per-agent breakdown.
+ */
+export declare const TurnUsageSchema: z.ZodObject<{
+    total: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cost: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    byAgent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cost: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TurnUsage = z.infer<typeof TurnUsageSchema>;
+/**
+ * A turn in a session conversation.
+ *
+ * A turn represents a user message and all agent responses to it.
+ * Extracted from events to provide explicit turn boundaries.
+ */
+export declare const TurnSchema: z.ZodObject<{
+    turnId: z.ZodString;
+    sessionId: z.ZodString;
+    turnNumber: z.ZodNumber;
+    startedAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodEnum<{
+        active: "active";
+        completed: "completed";
+        error: "error";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        total: z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            cost: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        byAgent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            cost: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Turn = z.infer<typeof TurnSchema>;
+/**
+ * Message routing status for multi-agent delivery tracking.
+ */
+export declare const MessageRoutingStatusSchema: z.ZodEnum<{
+    acknowledged: "acknowledged";
+    completed: "completed";
+    sent: "sent";
+}>;
+export type MessageRoutingStatus = z.infer<typeof MessageRoutingStatusSchema>;
+/**
+ * Tracks delivery status of a message to agents in multi-agent sessions.
+ */
+export declare const MessageRoutingSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    agentId: z.ZodString;
+    status: z.ZodEnum<{
+        acknowledged: "acknowledged";
+        completed: "completed";
+        sent: "sent";
+    }>;
+    timestamp: z.ZodNumber;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MessageRouting = z.infer<typeof MessageRoutingSchema>;
+//# sourceMappingURL=message.d.ts.map

package/dist/session/schemas/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/session/schemas/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAAqB,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;EAAgC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,eAAO,MAAM,0BAA0B;;;;EAAuC,CAAC;AAC/E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;EAA2C,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAO7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;iBAK1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;iBAiBrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;EAAgD,CAAC;AACxF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAW/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}