@teodorruskvi/chat-core 0.1.45 → 0.1.47

package/dist/types/domain/chat.d.ts

@@ -55,9 +55,16 @@ export interface ChatMessage extends TemporalMetadata {
     checkpointNs?: string | null;
     toolStreaming?: boolean;
     artifact?: any;
+    scope?: string;
+    origin?: string;
     additionalKwargs?: Record<string, any>;
     responseMetadata?: Record<string, any>;
 }
+export interface ChatPayload extends Record<string, any> {
+    creativityLevel: "low" | "medium" | "high" | null;
+    activeAgent?: string;
+    modelName?: string;
+}
 /**
  * Feature-specific request/command types
  */
@@ -67,10 +74,10 @@ export interface ChatRequest {
     checkpointId?: string;
     checkpointNs?: string;
     attachments?: File[];
-    payload?: Record<string, any>;
+    payload?: ChatPayload;
     config?: Record<string, any>;
     command?: GraphCommand;
-    edit?: boolean;
+    edit: boolean;
 }
 export interface GraphCommand {
     kind: "resume" | "goto";

package/dist/types/domain/streaming.d.ts

@@ -61,6 +61,7 @@ export type ActiveRunContext = {
 export type StreamEventMeta = {
     origin?: "agent" | "task";
     scope?: string;
+    seq?: number;
 };
 export type StreamFinishInfo = {
     lastSeq: number;
@@ -72,22 +73,38 @@ export type ToolEventIdentity = {
     id?: string;
     callId?: string;
 };
+/**
+ * Emitted when a tool begins execution.
+ */
 export type ToolStartEvent = {
     type: "tool.start";
+    /** Arguments passed to the tool */
     args: Record<string, unknown>;
+    /** Unique name of the tool */
     name?: string;
+    /** Legacy tool identifier */
     tool?: string;
     seq?: number;
+    scope?: string;
+    origin?: "agent" | "task";
     additionalKwargs?: Record<string, unknown>;
 } & ToolEventIdentity;
+/**
+ * Emitted when a tool finishes execution, providing the result.
+ */
 export type ToolEndEvent = {
     type: "tool.end";
+    /** The final output/response from the tool */
     content: string;
+    /** Optional structured data returned by the tool */
     artifact?: unknown;
+    /** Error message if execution failed */
     error?: string;
     name?: string;
     tool?: string;
     seq?: number;
+    scope?: string;
+    origin?: "agent" | "task";
     additionalKwargs?: Record<string, unknown>;
     status?: "completed" | "failed";
 } & ToolEventIdentity;
@@ -119,15 +136,45 @@ export type TaskStartEvent = {
     subagentType?: string;
     seq?: number;
 } & StreamEventMeta;
-export type MessageStreamEvent = ToolProgressEvent | {
+export type MessageStartEvent = {
+    type: "message.start";
+    role: "assistant";
+    id: string;
+    model?: string;
+    seq?: number;
+};
+export type MessageDeltaEvent = {
+    type: "message.delta";
+    delta: any[];
+    seq?: number;
+};
+export type MessageEndEvent = {
+    type: "message.end";
+    seq?: number;
+};
+export type MessageStreamEvent = MessageStartEvent | MessageDeltaEvent | MessageEndEvent | ToolProgressEvent | {
+    type: "messages/metadata";
+    metadata: MessagesMetadataMap;
+    seq?: number;
+} | {
     type: "messages/partial";
-    messages: Array<{
-        content: string | any[];
-        id: string;
-        type: string;
-        responseMetadata?: Record<string, unknown>;
-    }>;
+    messages: PartialMessageChunk[];
+    seq?: number;
+};
+export type PartialMessageChunk = {
+    id: string;
+    type: string;
+    role?: string;
+    content: string | unknown[];
+    responseMetadata?: Record<string, unknown>;
+    seq?: number;
+    scope?: string;
+    origin?: "agent" | "task";
 };
+export type MessagesMetadataEntry = {
+    metadata?: Record<string, unknown>;
+};
+export type MessagesMetadataMap = Record<string, MessagesMetadataEntry>;
 export type ThreadStreamEvent = {
     type: "thread_info";
     threadId: string;
@@ -183,9 +230,6 @@ export type SystemStreamEvent = {
     type: "updates";
     tools?: Record<string, unknown>;
     [key: string]: unknown;
-} | {
-    type: "values";
-    [key: string]: unknown;
 } | {
     type: "token";
     token: string;
@@ -201,6 +245,10 @@ export type HeartbeatEvent = Extract<SystemStreamEvent, {
 export type ValuesEvent = Extract<SystemStreamEvent, {
     type: "values";
 }>;
+/**
+ * The primary union of all possible streaming events.
+ * Use the 'type' field to discriminate between different event payloads.
+ */
 export type StreamEvent = (MessageStreamEvent | ToolStreamEvent | ThreadStreamEvent | SystemStreamEvent | TaskStartEvent) & StreamEventMeta;
 export interface StreamEventHandlers {
     onConnectionError?: (error: string) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teodorruskvi/chat-core",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "description": "Core chat protocols, hooks, and utilities (UI-agnostic)",
   "type": "module",
   "main": "dist/index.umd.js",
@@ -11,6 +11,9 @@
       "import": "./dist/index.esm.js",
       "require": "./dist/index.umd.js",
       "types": "./dist/lib/core.d.ts"
+    },
+    "./contracts": {
+      "types": "./dist/lib/contracts.d.ts"
     }
   },
   "files": [