@alquimia-ai/tools 2.0.1 → 2.2.0

package/dist/types/index.d.mts

@@ -24,10 +24,9 @@ interface AIMessageChunk {
     tooler?: ToolEvent[];
     error_code?: string;
     error_detail?: string;
-    stream_id?: string;
+    taskid?: string;
     loading?: boolean;
     thinkings?: ThinkingsInferenceResponse[];
-    evaluation_strategy?: string;
 }
 interface AIMessageChunkData {
     content: string;
@@ -76,13 +75,12 @@ interface AttachmentPayload {
 type AlquimiaMessage = Message & {
     error_code?: string;
     error_detail?: string;
-    stream_id?: string;
+    taskid?: string;
     loading?: boolean;
     created_at?: string;
     additionalInfo?: string;
     tooler?: Tooler[];
     thinkings?: ThinkingsInferenceResponse[];
-    evaluation_strategy?: string;
     attachments?: AttachmentPayload[];
 };
 interface ActionResponse<T = void> {
@@ -161,19 +159,21 @@ type TTSResult = {
     type: 'error';
     message: string;
 };
+/** One SSE `data:` JSON frame (`event_class` at top level). */
 interface AlquimiaEventData {
-    stream_id: string;
-    response: AssistantInferenceResponse;
-    experts: ExpertInferenceResponse[];
-    thinkings: ThinkingsInferenceResponse[];
-    tools_output: ToolEvent[];
-    agents_output: any[];
-    tools_pending_approval: any[];
-    tools_pending_execution: any[];
-    errors: any[];
-    event_class: string;
-    date_submitted: string;
-    control_id: string;
+    taskid?: string;
+    event_class?: string;
+    control_id?: string;
+    date_submitted?: string;
+    status?: string | null;
+    data?: unknown;
+    experts?: ExpertInferenceResponse[];
+    thinkings?: ThinkingsInferenceResponse[];
+    tools_output?: ToolEvent[];
+    agents_output?: any[];
+    tools_pending_approval?: any[];
+    tools_pending_execution?: any[];
+    errors?: any[];
 }
 interface AssistantInferenceResponse {
     event_class: string;
@@ -181,8 +181,69 @@ interface AssistantInferenceResponse {
     data: string;
     status: string;
     date_submitted: string;
-    stream_id?: string;
+    message?: string | null;
+    extras?: Record<string, unknown> | null;
+    extra_data?: ExtraDataContext | null;
+    channel?: unknown | null;
+    depth?: number;
+    taskid?: string;
+}
+/**
+ * Channel-scoped context returned alongside an inference response (was
+ * `ExtraDataConfig` in v0.2.0). Carries message metadata from the channel
+ * the inference was triggered from.
+ */
+interface ExtraDataContext {
+    whatsapp_message_id?: string;
+    whatsapp_message_from?: string;
+    email_message_recipient?: string;
+    email_message_subject?: string;
+    email_message_id?: string;
+    email_message_body?: string;
+    slack_team_id?: string;
+    slack_user_id?: string;
+    slack_channel_id?: string;
+    slack_response_url?: string;
+}
+/**
+ * JSON body returned by `POST /event/infer/{assistantId}` (and channel
+ * variants). Keys match the runtime wire format (lowercase, no underscores).
+ * `taskid` is the id used for the SSE stream.
+ */
+interface CommonAttributes {
+    taskid?: string | null;
+    parenttaskid?: string | null;
+    sessionid?: string | null;
+    userid?: string | null;
+    assistantid?: string | null;
+    agentspaceid?: string | null;
+    channelid?: string | null;
+    depth?: string;
+    attachments?: string[];
+}
+type InferInitResponse = CommonAttributes;
+/**
+ * Native-tools evaluation strategy. Wraps the client-side tool schemas
+ * the SDK previously sent at the top level of the infer payload.
+ */
+interface NativeToolsEvaluationStrategy {
+    evaluation_strategy_id: 'native';
+    tool_schemas?: unknown[];
+    max_steps?: number;
+    current_step?: number;
+    max_concurrent_tools?: number;
+    decorators?: unknown[];
+    tool_choice?: unknown;
+    structured_output?: unknown;
+}
+interface RawToolsEvaluationStrategy {
+    evaluation_strategy_id: 'raw';
+    tool_schemas?: unknown[];
+}
+interface OneShootEvaluationStrategy {
+    evaluation_strategy_id: 'one-shoot';
 }
+type EvaluationStrategy = NativeToolsEvaluationStrategy | RawToolsEvaluationStrategy | OneShootEvaluationStrategy;
 interface AssistantResponseData {
     content: string;
     additional_kwargs: Record<string, any>;
@@ -237,4 +298,4 @@ interface ThinkingsInferenceResponse {
     };
 }
 
-export { type AIMessageChunk, type AIMessageChunkData, type ActionResponse, type AlquimiaEventData, type AlquimiaMessage, type ApiError, type ApmSpan, type AssistantInferenceResponse, type AssistantResponseData, type AttachmentPayload, type BaseAPIConfig, type ConversationsMap, type DocumentSearchResult, type ElevenLabsRequestSpecs, type ElevenLabsVoiceSettings, type ExpertInferenceResponse, type IToolSpec, type ITooler, type RatingData, type ResponseMetadata, type TTSResult, type ThinkingsInferenceResponse, type TokenUsage, type ToolEvent, ToolFactory, type ToolOutput, type ToolSummary, type Tooler, type UsageMetadata };
+export { type AIMessageChunk, type AIMessageChunkData, type ActionResponse, type AlquimiaEventData, type AlquimiaMessage, type ApiError, type ApmSpan, type AssistantInferenceResponse, type AssistantResponseData, type AttachmentPayload, type BaseAPIConfig, type CommonAttributes, type ConversationsMap, type DocumentSearchResult, type ElevenLabsRequestSpecs, type ElevenLabsVoiceSettings, type EvaluationStrategy, type ExpertInferenceResponse, type ExtraDataContext, type IToolSpec, type ITooler, type InferInitResponse, type NativeToolsEvaluationStrategy, type OneShootEvaluationStrategy, type RatingData, type RawToolsEvaluationStrategy, type ResponseMetadata, type TTSResult, type ThinkingsInferenceResponse, type TokenUsage, type ToolEvent, ToolFactory, type ToolOutput, type ToolSummary, type Tooler, type UsageMetadata };

package/dist/types/index.d.ts

@@ -24,10 +24,9 @@ interface AIMessageChunk {
     tooler?: ToolEvent[];
     error_code?: string;
     error_detail?: string;
-    stream_id?: string;
+    taskid?: string;
     loading?: boolean;
     thinkings?: ThinkingsInferenceResponse[];
-    evaluation_strategy?: string;
 }
 interface AIMessageChunkData {
     content: string;
@@ -76,13 +75,12 @@ interface AttachmentPayload {
 type AlquimiaMessage = Message & {
     error_code?: string;
     error_detail?: string;
-    stream_id?: string;
+    taskid?: string;
     loading?: boolean;
     created_at?: string;
     additionalInfo?: string;
     tooler?: Tooler[];
     thinkings?: ThinkingsInferenceResponse[];
-    evaluation_strategy?: string;
     attachments?: AttachmentPayload[];
 };
 interface ActionResponse<T = void> {
@@ -161,19 +159,21 @@ type TTSResult = {
     type: 'error';
     message: string;
 };
+/** One SSE `data:` JSON frame (`event_class` at top level). */
 interface AlquimiaEventData {
-    stream_id: string;
-    response: AssistantInferenceResponse;
-    experts: ExpertInferenceResponse[];
-    thinkings: ThinkingsInferenceResponse[];
-    tools_output: ToolEvent[];
-    agents_output: any[];
-    tools_pending_approval: any[];
-    tools_pending_execution: any[];
-    errors: any[];
-    event_class: string;
-    date_submitted: string;
-    control_id: string;
+    taskid?: string;
+    event_class?: string;
+    control_id?: string;
+    date_submitted?: string;
+    status?: string | null;
+    data?: unknown;
+    experts?: ExpertInferenceResponse[];
+    thinkings?: ThinkingsInferenceResponse[];
+    tools_output?: ToolEvent[];
+    agents_output?: any[];
+    tools_pending_approval?: any[];
+    tools_pending_execution?: any[];
+    errors?: any[];
 }
 interface AssistantInferenceResponse {
     event_class: string;
@@ -181,8 +181,69 @@ interface AssistantInferenceResponse {
     data: string;
     status: string;
     date_submitted: string;
-    stream_id?: string;
+    message?: string | null;
+    extras?: Record<string, unknown> | null;
+    extra_data?: ExtraDataContext | null;
+    channel?: unknown | null;
+    depth?: number;
+    taskid?: string;
+}
+/**
+ * Channel-scoped context returned alongside an inference response (was
+ * `ExtraDataConfig` in v0.2.0). Carries message metadata from the channel
+ * the inference was triggered from.
+ */
+interface ExtraDataContext {
+    whatsapp_message_id?: string;
+    whatsapp_message_from?: string;
+    email_message_recipient?: string;
+    email_message_subject?: string;
+    email_message_id?: string;
+    email_message_body?: string;
+    slack_team_id?: string;
+    slack_user_id?: string;
+    slack_channel_id?: string;
+    slack_response_url?: string;
+}
+/**
+ * JSON body returned by `POST /event/infer/{assistantId}` (and channel
+ * variants). Keys match the runtime wire format (lowercase, no underscores).
+ * `taskid` is the id used for the SSE stream.
+ */
+interface CommonAttributes {
+    taskid?: string | null;
+    parenttaskid?: string | null;
+    sessionid?: string | null;
+    userid?: string | null;
+    assistantid?: string | null;
+    agentspaceid?: string | null;
+    channelid?: string | null;
+    depth?: string;
+    attachments?: string[];
+}
+type InferInitResponse = CommonAttributes;
+/**
+ * Native-tools evaluation strategy. Wraps the client-side tool schemas
+ * the SDK previously sent at the top level of the infer payload.
+ */
+interface NativeToolsEvaluationStrategy {
+    evaluation_strategy_id: 'native';
+    tool_schemas?: unknown[];
+    max_steps?: number;
+    current_step?: number;
+    max_concurrent_tools?: number;
+    decorators?: unknown[];
+    tool_choice?: unknown;
+    structured_output?: unknown;
+}
+interface RawToolsEvaluationStrategy {
+    evaluation_strategy_id: 'raw';
+    tool_schemas?: unknown[];
+}
+interface OneShootEvaluationStrategy {
+    evaluation_strategy_id: 'one-shoot';
 }
+type EvaluationStrategy = NativeToolsEvaluationStrategy | RawToolsEvaluationStrategy | OneShootEvaluationStrategy;
 interface AssistantResponseData {
     content: string;
     additional_kwargs: Record<string, any>;
@@ -237,4 +298,4 @@ interface ThinkingsInferenceResponse {
     };
 }
 
-export { type AIMessageChunk, type AIMessageChunkData, type ActionResponse, type AlquimiaEventData, type AlquimiaMessage, type ApiError, type ApmSpan, type AssistantInferenceResponse, type AssistantResponseData, type AttachmentPayload, type BaseAPIConfig, type ConversationsMap, type DocumentSearchResult, type ElevenLabsRequestSpecs, type ElevenLabsVoiceSettings, type ExpertInferenceResponse, type IToolSpec, type ITooler, type RatingData, type ResponseMetadata, type TTSResult, type ThinkingsInferenceResponse, type TokenUsage, type ToolEvent, ToolFactory, type ToolOutput, type ToolSummary, type Tooler, type UsageMetadata };
+export { type AIMessageChunk, type AIMessageChunkData, type ActionResponse, type AlquimiaEventData, type AlquimiaMessage, type ApiError, type ApmSpan, type AssistantInferenceResponse, type AssistantResponseData, type AttachmentPayload, type BaseAPIConfig, type CommonAttributes, type ConversationsMap, type DocumentSearchResult, type ElevenLabsRequestSpecs, type ElevenLabsVoiceSettings, type EvaluationStrategy, type ExpertInferenceResponse, type ExtraDataContext, type IToolSpec, type ITooler, type InferInitResponse, type NativeToolsEvaluationStrategy, type OneShootEvaluationStrategy, type RatingData, type RawToolsEvaluationStrategy, type ResponseMetadata, type TTSResult, type ThinkingsInferenceResponse, type TokenUsage, type ToolEvent, ToolFactory, type ToolOutput, type ToolSummary, type Tooler, type UsageMetadata };

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts","../../src/types/type.ts"],"sourcesContent":["export * from './type'","import { Span } from \"@elastic/apm-rum\";\nimport { Message } from \"ai\";\nexport interface ITooler {\n  tooler: Array<{\n    name: string;\n    parameters: Record<string, any>;\n  }>;\n}\n\nexport interface IToolSpec {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport abstract class ToolFactory {\n  protected toolSpec: IToolSpec | null = null;\n\n  constructor(toolSpec: IToolSpec) {\n    this.toolSpec = toolSpec;\n  }\n\n  static createTool(toolSpec: IToolSpec): IToolSpec {\n    return toolSpec;\n  }\n\n  abstract execute(): Promise<any>;\n}\n\nexport interface AIMessageChunk {\n  type: string;\n  data?: AIMessageChunkData;\n  answer?: string;\n  tooler?: ToolEvent[];\n  error_code?: string;\n  error_detail?: string;\n  stream_id?: string;\n  loading?: boolean;\n  thinkings?: ThinkingsInferenceResponse[];\n  evaluation_strategy?: string;\n}\n\nexport interface AIMessageChunkData {\n  content: string;\n  additional_kwargs?: Record<string, unknown>;\n  response_metadata?: Record<string, unknown>;\n  type: string;\n  name?: string | null;\n  id?: string | null;\n  example?: boolean;\n  tool_calls?: ToolCall[];\n  invalid_tool_calls?: InvalidToolCall[];\n  usage_metadata?: any;\n  tool_call_chunks?: unknown[];\n  error_code?: string;\n  error_detail?: string;\n}\n\ntype ToolCall = {\n  name: string;\n  args: Record<string, any>;\n  id?: string | null;\n};\n\ntype InvalidToolCall = {\n  name: string | null;\n  args: string | null;\n  id: string | null;\n  error: string | null;\n};\n\nexport interface BaseAPIConfig {\n  baseUrl: string;\n  route: string;\n  token?: string;\n  headers?: Record<string, string>;\n}\n\nexport interface RatingData {\n  assistantId: string;\n  sessionId: string;\n  topicId: number;\n  score?: number;\n  description?: string;\n}\n\nexport interface AttachmentPayload {\n  filename: string;\n  content_type: string;\n  content_size: number;\n}\n\nexport type AlquimiaMessage = Message & {\n  error_code?: string;\n  error_detail?: string;\n  stream_id?: string;\n  loading?: boolean;\n  created_at?: string;\n  additionalInfo?: string;\n  tooler?: Tooler[];\n  thinkings?: ThinkingsInferenceResponse[];\n  evaluation_strategy?: string;\n  attachments?: AttachmentPayload[];\n};\n\nexport interface ActionResponse<T = void> {\n  success: boolean;\n  data?: T;\n  error?: {\n    message: string;\n    code?: string;\n    details?: any;\n    name?: string;\n    cause?: string;\n    status?: string;\n  };\n}\n\nexport type ApmSpan = Span & {\n  id?: string \n  traceId?: string\n} | undefined\n\nexport type ApiError = Error & {\n  message: string;\n  name: string;\n  cause: string;\n  code?: string | number;\n  status?: string | number;\n}\n\nexport type Tooler = {\n  control_id: string;\n  tool_summary?: ToolSummary;\n  tool_output?: ToolOutput;\n}\n\nexport type ToolSummary = {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport type ToolOutput = {\n  result: any;\n  status: string;\n}\n\nexport type ToolEvent = {\n  event_class: string;\n  control_id: string;\n  data: any;\n  status: string;\n}\n\nexport interface ConversationsMap {\n  [topicId: string]: string;\n}\n\nexport interface DocumentSearchResult {\n  pageContent: string;\n  metadata: {\n    source: string;\n    _id: string;\n    _collection_name: string;\n  };\n  score: number;\n}\n\nexport type ElevenLabsVoiceSettings = {\n  stability: number;\n  similarity_boost: number;\n  style: number;\n};\n\nexport type ElevenLabsRequestSpecs = {\n  optimize_streaming_latency: string;\n  output_format: string;\n  model_id: string;\n  language: string;\n  voice_settings: ElevenLabsVoiceSettings;\n};\n\nexport type TTSResult =\n  | { type: 'blob'; data: Blob }\n  | { type: 'url'; data: string }\n  | { type: 'error'; message: string };\n\n  export interface AlquimiaEventData {\n    stream_id: string;\n    response: AssistantInferenceResponse;\n    experts: ExpertInferenceResponse[];\n    thinkings: ThinkingsInferenceResponse[];\n    tools_output: ToolEvent[];\n    agents_output: any[];\n    tools_pending_approval: any[];\n    tools_pending_execution: any[];\n    errors: any[];\n    event_class: string;\n    date_submitted: string;\n    control_id: string;\n  }\n\n  export interface AssistantInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: string;\n    status: string;\n    date_submitted: string;\n    stream_id?: string;\n  }\n\n  export interface AssistantResponseData {\n    content: string;\n    additional_kwargs: Record<string, any>;\n    response_metadata: ResponseMetadata;\n    type: string;\n    id: string;\n    example: boolean;\n    tool_calls: any[];\n    invalid_tool_calls: any[];\n    usage_metadata: UsageMetadata;\n  }\n\n  export interface ResponseMetadata {\n    token_usage: TokenUsage;\n    model_name: string;\n    system_fingerprint: string;\n    finish_reason: string;\n    logprobs: any | null;\n  }\n\n  export interface TokenUsage {\n    completion_tokens: number;\n    prompt_tokens: number;\n    total_tokens: number;\n    completion_time: number;\n    prompt_time: number;\n    queue_time: number;\n    total_time: number;\n  }\n\n  export interface UsageMetadata {\n    input_tokens: number;\n    output_tokens: number;\n    total_tokens: number;\n  }\n\n  export interface ExpertInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: {\n      label: string;\n      score: number;\n    };\n    status: string;\n    date_submitted: string;\n  }\n\n  export interface ThinkingsInferenceResponse {\n    event_class: string;\n    control_id: string;\n    status: string;\n    date_submitted: string;\n    data: {\n      content: AssistantResponseData;\n      is_complete: boolean;\n      is_partial: boolean;\n    };\n  }"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcO,IAAe,cAAf,MAA2B;AAAA,EAGhC,YAAY,UAAqB;AAFjC,SAAU,WAA6B;AAGrC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,WAAW,UAAgC;AAChD,WAAO;AAAA,EACT;AAGF;","names":[]}
+{"version":3,"sources":["../../src/types/index.ts","../../src/types/type.ts"],"sourcesContent":["export * from './type'","import { Span } from \"@elastic/apm-rum\";\nimport { Message } from \"ai\";\nexport interface ITooler {\n  tooler: Array<{\n    name: string;\n    parameters: Record<string, any>;\n  }>;\n}\n\nexport interface IToolSpec {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport abstract class ToolFactory {\n  protected toolSpec: IToolSpec | null = null;\n\n  constructor(toolSpec: IToolSpec) {\n    this.toolSpec = toolSpec;\n  }\n\n  static createTool(toolSpec: IToolSpec): IToolSpec {\n    return toolSpec;\n  }\n\n  abstract execute(): Promise<any>;\n}\n\nexport interface AIMessageChunk {\n  type: string;\n  data?: AIMessageChunkData;\n  answer?: string;\n  tooler?: ToolEvent[];\n  error_code?: string;\n  error_detail?: string;\n  taskid?: string;\n  loading?: boolean;\n  thinkings?: ThinkingsInferenceResponse[];\n}\n\nexport interface AIMessageChunkData {\n  content: string;\n  additional_kwargs?: Record<string, unknown>;\n  response_metadata?: Record<string, unknown>;\n  type: string;\n  name?: string | null;\n  id?: string | null;\n  example?: boolean;\n  tool_calls?: ToolCall[];\n  invalid_tool_calls?: InvalidToolCall[];\n  usage_metadata?: any;\n  tool_call_chunks?: unknown[];\n  error_code?: string;\n  error_detail?: string;\n}\n\ntype ToolCall = {\n  name: string;\n  args: Record<string, any>;\n  id?: string | null;\n};\n\ntype InvalidToolCall = {\n  name: string | null;\n  args: string | null;\n  id: string | null;\n  error: string | null;\n};\n\nexport interface BaseAPIConfig {\n  baseUrl: string;\n  route: string;\n  token?: string;\n  headers?: Record<string, string>;\n}\n\nexport interface RatingData {\n  assistantId: string;\n  sessionId: string;\n  topicId: number;\n  score?: number;\n  description?: string;\n}\n\nexport interface AttachmentPayload {\n  filename: string;\n  content_type: string;\n  content_size: number;\n}\n\nexport type AlquimiaMessage = Message & {\n  error_code?: string;\n  error_detail?: string;\n  taskid?: string;\n  loading?: boolean;\n  created_at?: string;\n  additionalInfo?: string;\n  tooler?: Tooler[];\n  thinkings?: ThinkingsInferenceResponse[];\n  attachments?: AttachmentPayload[];\n};\n\nexport interface ActionResponse<T = void> {\n  success: boolean;\n  data?: T;\n  error?: {\n    message: string;\n    code?: string;\n    details?: any;\n    name?: string;\n    cause?: string;\n    status?: string;\n  };\n}\n\nexport type ApmSpan = Span & {\n  id?: string \n  traceId?: string\n} | undefined\n\nexport type ApiError = Error & {\n  message: string;\n  name: string;\n  cause: string;\n  code?: string | number;\n  status?: string | number;\n}\n\nexport type Tooler = {\n  control_id: string;\n  tool_summary?: ToolSummary;\n  tool_output?: ToolOutput;\n}\n\nexport type ToolSummary = {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport type ToolOutput = {\n  result: any;\n  status: string;\n}\n\nexport type ToolEvent = {\n  event_class: string;\n  control_id: string;\n  data: any;\n  status: string;\n}\n\nexport interface ConversationsMap {\n  [topicId: string]: string;\n}\n\nexport interface DocumentSearchResult {\n  pageContent: string;\n  metadata: {\n    source: string;\n    _id: string;\n    _collection_name: string;\n  };\n  score: number;\n}\n\nexport type ElevenLabsVoiceSettings = {\n  stability: number;\n  similarity_boost: number;\n  style: number;\n};\n\nexport type ElevenLabsRequestSpecs = {\n  optimize_streaming_latency: string;\n  output_format: string;\n  model_id: string;\n  language: string;\n  voice_settings: ElevenLabsVoiceSettings;\n};\n\nexport type TTSResult =\n  | { type: 'blob'; data: Blob }\n  | { type: 'url'; data: string }\n  | { type: 'error'; message: string };\n\n  /** One SSE `data:` JSON frame (`event_class` at top level). */\n  export interface AlquimiaEventData {\n    taskid?: string;\n    event_class?: string;\n    control_id?: string;\n    date_submitted?: string;\n    status?: string | null;\n    data?: unknown;\n    experts?: ExpertInferenceResponse[];\n    thinkings?: ThinkingsInferenceResponse[];\n    tools_output?: ToolEvent[];\n    agents_output?: any[];\n    tools_pending_approval?: any[];\n    tools_pending_execution?: any[];\n    errors?: any[];\n  }\n\n  export interface AssistantInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: string;\n    status: string;\n    date_submitted: string;\n    message?: string | null;\n    extras?: Record<string, unknown> | null;\n    extra_data?: ExtraDataContext | null;\n    channel?: unknown | null;\n    depth?: number;\n    taskid?: string;\n  }\n\n  /**\n   * Channel-scoped context returned alongside an inference response (was\n   * `ExtraDataConfig` in v0.2.0). Carries message metadata from the channel\n   * the inference was triggered from.\n   */\n  export interface ExtraDataContext {\n    whatsapp_message_id?: string;\n    whatsapp_message_from?: string;\n    email_message_recipient?: string;\n    email_message_subject?: string;\n    email_message_id?: string;\n    email_message_body?: string;\n    slack_team_id?: string;\n    slack_user_id?: string;\n    slack_channel_id?: string;\n    slack_response_url?: string;\n  }\n\n  /**\n   * JSON body returned by `POST /event/infer/{assistantId}` (and channel\n   * variants). Keys match the runtime wire format (lowercase, no underscores).\n   * `taskid` is the id used for the SSE stream.\n   */\n  export interface CommonAttributes {\n    taskid?: string | null;\n    parenttaskid?: string | null;\n    sessionid?: string | null;\n    userid?: string | null;\n    assistantid?: string | null;\n    agentspaceid?: string | null;\n    channelid?: string | null;\n    depth?: string;\n    attachments?: string[];\n  }\n\n  export type InferInitResponse = CommonAttributes;\n\n  /**\n   * Native-tools evaluation strategy. Wraps the client-side tool schemas\n   * the SDK previously sent at the top level of the infer payload.\n   */\n  export interface NativeToolsEvaluationStrategy {\n    evaluation_strategy_id: 'native';\n    tool_schemas?: unknown[];\n    max_steps?: number;\n    current_step?: number;\n    max_concurrent_tools?: number;\n    decorators?: unknown[];\n    tool_choice?: unknown;\n    structured_output?: unknown;\n  }\n\n  export interface RawToolsEvaluationStrategy {\n    evaluation_strategy_id: 'raw';\n    tool_schemas?: unknown[];\n  }\n\n  export interface OneShootEvaluationStrategy {\n    evaluation_strategy_id: 'one-shoot';\n  }\n\n  export type EvaluationStrategy =\n    | NativeToolsEvaluationStrategy\n    | RawToolsEvaluationStrategy\n    | OneShootEvaluationStrategy;\n\n  export interface AssistantResponseData {\n    content: string;\n    additional_kwargs: Record<string, any>;\n    response_metadata: ResponseMetadata;\n    type: string;\n    id: string;\n    example: boolean;\n    tool_calls: any[];\n    invalid_tool_calls: any[];\n    usage_metadata: UsageMetadata;\n  }\n\n  export interface ResponseMetadata {\n    token_usage: TokenUsage;\n    model_name: string;\n    system_fingerprint: string;\n    finish_reason: string;\n    logprobs: any | null;\n  }\n\n  export interface TokenUsage {\n    completion_tokens: number;\n    prompt_tokens: number;\n    total_tokens: number;\n    completion_time: number;\n    prompt_time: number;\n    queue_time: number;\n    total_time: number;\n  }\n\n  export interface UsageMetadata {\n    input_tokens: number;\n    output_tokens: number;\n    total_tokens: number;\n  }\n\n  export interface ExpertInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: {\n      label: string;\n      score: number;\n    };\n    status: string;\n    date_submitted: string;\n  }\n\n  export interface ThinkingsInferenceResponse {\n    event_class: string;\n    control_id: string;\n    status: string;\n    date_submitted: string;\n    data: {\n      content: AssistantResponseData;\n      is_complete: boolean;\n      is_partial: boolean;\n    };\n  }"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcO,IAAe,cAAf,MAA2B;AAAA,EAGhC,YAAY,UAAqB;AAFjC,SAAU,WAA6B;AAGrC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,WAAW,UAAgC;AAChD,WAAO;AAAA,EACT;AAGF;","names":[]}

package/dist/types/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/type.ts"],"sourcesContent":["import { Span } from \"@elastic/apm-rum\";\nimport { Message } from \"ai\";\nexport interface ITooler {\n  tooler: Array<{\n    name: string;\n    parameters: Record<string, any>;\n  }>;\n}\n\nexport interface IToolSpec {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport abstract class ToolFactory {\n  protected toolSpec: IToolSpec | null = null;\n\n  constructor(toolSpec: IToolSpec) {\n    this.toolSpec = toolSpec;\n  }\n\n  static createTool(toolSpec: IToolSpec): IToolSpec {\n    return toolSpec;\n  }\n\n  abstract execute(): Promise<any>;\n}\n\nexport interface AIMessageChunk {\n  type: string;\n  data?: AIMessageChunkData;\n  answer?: string;\n  tooler?: ToolEvent[];\n  error_code?: string;\n  error_detail?: string;\n  stream_id?: string;\n  loading?: boolean;\n  thinkings?: ThinkingsInferenceResponse[];\n  evaluation_strategy?: string;\n}\n\nexport interface AIMessageChunkData {\n  content: string;\n  additional_kwargs?: Record<string, unknown>;\n  response_metadata?: Record<string, unknown>;\n  type: string;\n  name?: string | null;\n  id?: string | null;\n  example?: boolean;\n  tool_calls?: ToolCall[];\n  invalid_tool_calls?: InvalidToolCall[];\n  usage_metadata?: any;\n  tool_call_chunks?: unknown[];\n  error_code?: string;\n  error_detail?: string;\n}\n\ntype ToolCall = {\n  name: string;\n  args: Record<string, any>;\n  id?: string | null;\n};\n\ntype InvalidToolCall = {\n  name: string | null;\n  args: string | null;\n  id: string | null;\n  error: string | null;\n};\n\nexport interface BaseAPIConfig {\n  baseUrl: string;\n  route: string;\n  token?: string;\n  headers?: Record<string, string>;\n}\n\nexport interface RatingData {\n  assistantId: string;\n  sessionId: string;\n  topicId: number;\n  score?: number;\n  description?: string;\n}\n\nexport interface AttachmentPayload {\n  filename: string;\n  content_type: string;\n  content_size: number;\n}\n\nexport type AlquimiaMessage = Message & {\n  error_code?: string;\n  error_detail?: string;\n  stream_id?: string;\n  loading?: boolean;\n  created_at?: string;\n  additionalInfo?: string;\n  tooler?: Tooler[];\n  thinkings?: ThinkingsInferenceResponse[];\n  evaluation_strategy?: string;\n  attachments?: AttachmentPayload[];\n};\n\nexport interface ActionResponse<T = void> {\n  success: boolean;\n  data?: T;\n  error?: {\n    message: string;\n    code?: string;\n    details?: any;\n    name?: string;\n    cause?: string;\n    status?: string;\n  };\n}\n\nexport type ApmSpan = Span & {\n  id?: string \n  traceId?: string\n} | undefined\n\nexport type ApiError = Error & {\n  message: string;\n  name: string;\n  cause: string;\n  code?: string | number;\n  status?: string | number;\n}\n\nexport type Tooler = {\n  control_id: string;\n  tool_summary?: ToolSummary;\n  tool_output?: ToolOutput;\n}\n\nexport type ToolSummary = {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport type ToolOutput = {\n  result: any;\n  status: string;\n}\n\nexport type ToolEvent = {\n  event_class: string;\n  control_id: string;\n  data: any;\n  status: string;\n}\n\nexport interface ConversationsMap {\n  [topicId: string]: string;\n}\n\nexport interface DocumentSearchResult {\n  pageContent: string;\n  metadata: {\n    source: string;\n    _id: string;\n    _collection_name: string;\n  };\n  score: number;\n}\n\nexport type ElevenLabsVoiceSettings = {\n  stability: number;\n  similarity_boost: number;\n  style: number;\n};\n\nexport type ElevenLabsRequestSpecs = {\n  optimize_streaming_latency: string;\n  output_format: string;\n  model_id: string;\n  language: string;\n  voice_settings: ElevenLabsVoiceSettings;\n};\n\nexport type TTSResult =\n  | { type: 'blob'; data: Blob }\n  | { type: 'url'; data: string }\n  | { type: 'error'; message: string };\n\n  export interface AlquimiaEventData {\n    stream_id: string;\n    response: AssistantInferenceResponse;\n    experts: ExpertInferenceResponse[];\n    thinkings: ThinkingsInferenceResponse[];\n    tools_output: ToolEvent[];\n    agents_output: any[];\n    tools_pending_approval: any[];\n    tools_pending_execution: any[];\n    errors: any[];\n    event_class: string;\n    date_submitted: string;\n    control_id: string;\n  }\n\n  export interface AssistantInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: string;\n    status: string;\n    date_submitted: string;\n    stream_id?: string;\n  }\n\n  export interface AssistantResponseData {\n    content: string;\n    additional_kwargs: Record<string, any>;\n    response_metadata: ResponseMetadata;\n    type: string;\n    id: string;\n    example: boolean;\n    tool_calls: any[];\n    invalid_tool_calls: any[];\n    usage_metadata: UsageMetadata;\n  }\n\n  export interface ResponseMetadata {\n    token_usage: TokenUsage;\n    model_name: string;\n    system_fingerprint: string;\n    finish_reason: string;\n    logprobs: any | null;\n  }\n\n  export interface TokenUsage {\n    completion_tokens: number;\n    prompt_tokens: number;\n    total_tokens: number;\n    completion_time: number;\n    prompt_time: number;\n    queue_time: number;\n    total_time: number;\n  }\n\n  export interface UsageMetadata {\n    input_tokens: number;\n    output_tokens: number;\n    total_tokens: number;\n  }\n\n  export interface ExpertInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: {\n      label: string;\n      score: number;\n    };\n    status: string;\n    date_submitted: string;\n  }\n\n  export interface ThinkingsInferenceResponse {\n    event_class: string;\n    control_id: string;\n    status: string;\n    date_submitted: string;\n    data: {\n      content: AssistantResponseData;\n      is_complete: boolean;\n      is_partial: boolean;\n    };\n  }"],"mappings":";AAcO,IAAe,cAAf,MAA2B;AAAA,EAGhC,YAAY,UAAqB;AAFjC,SAAU,WAA6B;AAGrC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,WAAW,UAAgC;AAChD,WAAO;AAAA,EACT;AAGF;","names":[]}
+{"version":3,"sources":["../../src/types/type.ts"],"sourcesContent":["import { Span } from \"@elastic/apm-rum\";\nimport { Message } from \"ai\";\nexport interface ITooler {\n  tooler: Array<{\n    name: string;\n    parameters: Record<string, any>;\n  }>;\n}\n\nexport interface IToolSpec {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport abstract class ToolFactory {\n  protected toolSpec: IToolSpec | null = null;\n\n  constructor(toolSpec: IToolSpec) {\n    this.toolSpec = toolSpec;\n  }\n\n  static createTool(toolSpec: IToolSpec): IToolSpec {\n    return toolSpec;\n  }\n\n  abstract execute(): Promise<any>;\n}\n\nexport interface AIMessageChunk {\n  type: string;\n  data?: AIMessageChunkData;\n  answer?: string;\n  tooler?: ToolEvent[];\n  error_code?: string;\n  error_detail?: string;\n  taskid?: string;\n  loading?: boolean;\n  thinkings?: ThinkingsInferenceResponse[];\n}\n\nexport interface AIMessageChunkData {\n  content: string;\n  additional_kwargs?: Record<string, unknown>;\n  response_metadata?: Record<string, unknown>;\n  type: string;\n  name?: string | null;\n  id?: string | null;\n  example?: boolean;\n  tool_calls?: ToolCall[];\n  invalid_tool_calls?: InvalidToolCall[];\n  usage_metadata?: any;\n  tool_call_chunks?: unknown[];\n  error_code?: string;\n  error_detail?: string;\n}\n\ntype ToolCall = {\n  name: string;\n  args: Record<string, any>;\n  id?: string | null;\n};\n\ntype InvalidToolCall = {\n  name: string | null;\n  args: string | null;\n  id: string | null;\n  error: string | null;\n};\n\nexport interface BaseAPIConfig {\n  baseUrl: string;\n  route: string;\n  token?: string;\n  headers?: Record<string, string>;\n}\n\nexport interface RatingData {\n  assistantId: string;\n  sessionId: string;\n  topicId: number;\n  score?: number;\n  description?: string;\n}\n\nexport interface AttachmentPayload {\n  filename: string;\n  content_type: string;\n  content_size: number;\n}\n\nexport type AlquimiaMessage = Message & {\n  error_code?: string;\n  error_detail?: string;\n  taskid?: string;\n  loading?: boolean;\n  created_at?: string;\n  additionalInfo?: string;\n  tooler?: Tooler[];\n  thinkings?: ThinkingsInferenceResponse[];\n  attachments?: AttachmentPayload[];\n};\n\nexport interface ActionResponse<T = void> {\n  success: boolean;\n  data?: T;\n  error?: {\n    message: string;\n    code?: string;\n    details?: any;\n    name?: string;\n    cause?: string;\n    status?: string;\n  };\n}\n\nexport type ApmSpan = Span & {\n  id?: string \n  traceId?: string\n} | undefined\n\nexport type ApiError = Error & {\n  message: string;\n  name: string;\n  cause: string;\n  code?: string | number;\n  status?: string | number;\n}\n\nexport type Tooler = {\n  control_id: string;\n  tool_summary?: ToolSummary;\n  tool_output?: ToolOutput;\n}\n\nexport type ToolSummary = {\n  name: string;\n  parameters: Record<string, any>;\n}\n\nexport type ToolOutput = {\n  result: any;\n  status: string;\n}\n\nexport type ToolEvent = {\n  event_class: string;\n  control_id: string;\n  data: any;\n  status: string;\n}\n\nexport interface ConversationsMap {\n  [topicId: string]: string;\n}\n\nexport interface DocumentSearchResult {\n  pageContent: string;\n  metadata: {\n    source: string;\n    _id: string;\n    _collection_name: string;\n  };\n  score: number;\n}\n\nexport type ElevenLabsVoiceSettings = {\n  stability: number;\n  similarity_boost: number;\n  style: number;\n};\n\nexport type ElevenLabsRequestSpecs = {\n  optimize_streaming_latency: string;\n  output_format: string;\n  model_id: string;\n  language: string;\n  voice_settings: ElevenLabsVoiceSettings;\n};\n\nexport type TTSResult =\n  | { type: 'blob'; data: Blob }\n  | { type: 'url'; data: string }\n  | { type: 'error'; message: string };\n\n  /** One SSE `data:` JSON frame (`event_class` at top level). */\n  export interface AlquimiaEventData {\n    taskid?: string;\n    event_class?: string;\n    control_id?: string;\n    date_submitted?: string;\n    status?: string | null;\n    data?: unknown;\n    experts?: ExpertInferenceResponse[];\n    thinkings?: ThinkingsInferenceResponse[];\n    tools_output?: ToolEvent[];\n    agents_output?: any[];\n    tools_pending_approval?: any[];\n    tools_pending_execution?: any[];\n    errors?: any[];\n  }\n\n  export interface AssistantInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: string;\n    status: string;\n    date_submitted: string;\n    message?: string | null;\n    extras?: Record<string, unknown> | null;\n    extra_data?: ExtraDataContext | null;\n    channel?: unknown | null;\n    depth?: number;\n    taskid?: string;\n  }\n\n  /**\n   * Channel-scoped context returned alongside an inference response (was\n   * `ExtraDataConfig` in v0.2.0). Carries message metadata from the channel\n   * the inference was triggered from.\n   */\n  export interface ExtraDataContext {\n    whatsapp_message_id?: string;\n    whatsapp_message_from?: string;\n    email_message_recipient?: string;\n    email_message_subject?: string;\n    email_message_id?: string;\n    email_message_body?: string;\n    slack_team_id?: string;\n    slack_user_id?: string;\n    slack_channel_id?: string;\n    slack_response_url?: string;\n  }\n\n  /**\n   * JSON body returned by `POST /event/infer/{assistantId}` (and channel\n   * variants). Keys match the runtime wire format (lowercase, no underscores).\n   * `taskid` is the id used for the SSE stream.\n   */\n  export interface CommonAttributes {\n    taskid?: string | null;\n    parenttaskid?: string | null;\n    sessionid?: string | null;\n    userid?: string | null;\n    assistantid?: string | null;\n    agentspaceid?: string | null;\n    channelid?: string | null;\n    depth?: string;\n    attachments?: string[];\n  }\n\n  export type InferInitResponse = CommonAttributes;\n\n  /**\n   * Native-tools evaluation strategy. Wraps the client-side tool schemas\n   * the SDK previously sent at the top level of the infer payload.\n   */\n  export interface NativeToolsEvaluationStrategy {\n    evaluation_strategy_id: 'native';\n    tool_schemas?: unknown[];\n    max_steps?: number;\n    current_step?: number;\n    max_concurrent_tools?: number;\n    decorators?: unknown[];\n    tool_choice?: unknown;\n    structured_output?: unknown;\n  }\n\n  export interface RawToolsEvaluationStrategy {\n    evaluation_strategy_id: 'raw';\n    tool_schemas?: unknown[];\n  }\n\n  export interface OneShootEvaluationStrategy {\n    evaluation_strategy_id: 'one-shoot';\n  }\n\n  export type EvaluationStrategy =\n    | NativeToolsEvaluationStrategy\n    | RawToolsEvaluationStrategy\n    | OneShootEvaluationStrategy;\n\n  export interface AssistantResponseData {\n    content: string;\n    additional_kwargs: Record<string, any>;\n    response_metadata: ResponseMetadata;\n    type: string;\n    id: string;\n    example: boolean;\n    tool_calls: any[];\n    invalid_tool_calls: any[];\n    usage_metadata: UsageMetadata;\n  }\n\n  export interface ResponseMetadata {\n    token_usage: TokenUsage;\n    model_name: string;\n    system_fingerprint: string;\n    finish_reason: string;\n    logprobs: any | null;\n  }\n\n  export interface TokenUsage {\n    completion_tokens: number;\n    prompt_tokens: number;\n    total_tokens: number;\n    completion_time: number;\n    prompt_time: number;\n    queue_time: number;\n    total_time: number;\n  }\n\n  export interface UsageMetadata {\n    input_tokens: number;\n    output_tokens: number;\n    total_tokens: number;\n  }\n\n  export interface ExpertInferenceResponse {\n    event_class: string;\n    control_id: string;\n    data: {\n      label: string;\n      score: number;\n    };\n    status: string;\n    date_submitted: string;\n  }\n\n  export interface ThinkingsInferenceResponse {\n    event_class: string;\n    control_id: string;\n    status: string;\n    date_submitted: string;\n    data: {\n      content: AssistantResponseData;\n      is_complete: boolean;\n      is_partial: boolean;\n    };\n  }"],"mappings":";AAcO,IAAe,cAAf,MAA2B;AAAA,EAGhC,YAAY,UAAqB;AAFjC,SAAU,WAA6B;AAGrC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,WAAW,UAAgC;AAChD,WAAO;AAAA,EACT;AAGF;","names":[]}

package/dist/types-CIqszY3g.d.mts

@@ -0,0 +1,53 @@
+/** One granular Runtime worklog record (a `bus_mode` SSE frame or a `/worklog/{task_id}/events` item). */
+interface WorklogRecord {
+    event_class: string;
+    control_id: string | null;
+    data: unknown;
+    status: "success" | "error" | null;
+    date_submitted: string;
+}
+/** Semantic bucket a node belongs to. */
+type NodeKind = "safeguard" | "reasoning" | "tool" | "a2a" | "memory" | "answer" | "unknown";
+/** Lifecycle state of a single node. */
+type NodeStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+/** Overall run status. */
+type RunStatus = "idle" | "running" | "success" | "error";
+/** A single step in the execution chain (command + its response merged by control_id). */
+interface WorklogNode {
+    id: string;
+    kind: NodeKind;
+    eventClass: string;
+    status: NodeStatus;
+    title: string;
+    startedAt?: string;
+    endedAt?: string;
+    depth: number;
+    parentId?: string;
+    children: WorklogNode[];
+    command?: unknown;
+    response?: unknown;
+    error?: string;
+    raw: WorklogRecord[];
+}
+/** Normalized execution model produced by the reducer. */
+interface WorklogState {
+    taskId: string | null;
+    status: RunStatus;
+    answer: string | null;
+    nodes: WorklogNode[];
+    index: Record<string, number>;
+    raw: WorklogRecord[];
+}
+/** How a record acts on the model. */
+type EventRole = "open" | "close" | "run-open" | "run-close" | "ignore";
+/** Registry descriptor for one event_class. */
+interface EventInterpreter {
+    kind: NodeKind;
+    role: EventRole;
+    title: (record: WorklogRecord) => string;
+    /** If true, an opened node starts in "pending" (awaiting external input) rather than "running". */
+    pending?: boolean;
+}
+declare function initialWorklogState(taskId?: string | null): WorklogState;
+
+export { type EventInterpreter as E, type NodeKind as N, type RunStatus as R, type WorklogState as W, type WorklogRecord as a, type NodeStatus as b, type WorklogNode as c, type EventRole as d, initialWorklogState as i };

package/dist/types-CIqszY3g.d.ts

@@ -0,0 +1,53 @@
+/** One granular Runtime worklog record (a `bus_mode` SSE frame or a `/worklog/{task_id}/events` item). */
+interface WorklogRecord {
+    event_class: string;
+    control_id: string | null;
+    data: unknown;
+    status: "success" | "error" | null;
+    date_submitted: string;
+}
+/** Semantic bucket a node belongs to. */
+type NodeKind = "safeguard" | "reasoning" | "tool" | "a2a" | "memory" | "answer" | "unknown";
+/** Lifecycle state of a single node. */
+type NodeStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+/** Overall run status. */
+type RunStatus = "idle" | "running" | "success" | "error";
+/** A single step in the execution chain (command + its response merged by control_id). */
+interface WorklogNode {
+    id: string;
+    kind: NodeKind;
+    eventClass: string;
+    status: NodeStatus;
+    title: string;
+    startedAt?: string;
+    endedAt?: string;
+    depth: number;
+    parentId?: string;
+    children: WorklogNode[];
+    command?: unknown;
+    response?: unknown;
+    error?: string;
+    raw: WorklogRecord[];
+}
+/** Normalized execution model produced by the reducer. */
+interface WorklogState {
+    taskId: string | null;
+    status: RunStatus;
+    answer: string | null;
+    nodes: WorklogNode[];
+    index: Record<string, number>;
+    raw: WorklogRecord[];
+}
+/** How a record acts on the model. */
+type EventRole = "open" | "close" | "run-open" | "run-close" | "ignore";
+/** Registry descriptor for one event_class. */
+interface EventInterpreter {
+    kind: NodeKind;
+    role: EventRole;
+    title: (record: WorklogRecord) => string;
+    /** If true, an opened node starts in "pending" (awaiting external input) rather than "running". */
+    pending?: boolean;
+}
+declare function initialWorklogState(taskId?: string | null): WorklogState;
+
+export { type EventInterpreter as E, type NodeKind as N, type RunStatus as R, type WorklogState as W, type WorklogRecord as a, type NodeStatus as b, type WorklogNode as c, type EventRole as d, initialWorklogState as i };

package/dist/worklog/index.d.mts

@@ -0,0 +1,29 @@
+import { E as EventInterpreter, W as WorklogState, a as WorklogRecord } from '../types-CIqszY3g.mjs';
+export { d as EventRole, N as NodeKind, b as NodeStatus, R as RunStatus, c as WorklogNode, i as initialWorklogState } from '../types-CIqszY3g.mjs';
+
+declare const EVENT_REGISTRY: Record<string, EventInterpreter>;
+declare function resolveInterpreter(eventClass: string): EventInterpreter;
+
+declare function reduceWorklog(state: WorklogState, record: WorklogRecord): WorklogState;
+declare function foldWorklog(records: WorklogRecord[], taskId?: string | null): WorklogState;
+
+/** Live worklog accumulator. Feed it `bus_mode` records via `ingest`; use `foldWorklog` for history. */
+declare function useWorklog(taskId?: string | null): {
+    worklog: WorklogState;
+    ingest: (record: WorklogRecord) => void;
+    ingestMany: (records: WorklogRecord[]) => void;
+    reset: (id?: string | null) => void;
+};
+
+/** Loosely-typed shape of a parsed SSE `data:` frame from the granular Runtime stream. */
+interface RawFrame {
+    event_class?: string;
+    control_id?: string | null;
+    data?: unknown;
+    status?: string | null;
+    date_submitted?: string;
+}
+/** Normalize a parsed SSE frame into a WorklogRecord (defaults missing fields; never throws). */
+declare function frameToRecord(frame: RawFrame): WorklogRecord;
+
+export { EVENT_REGISTRY, EventInterpreter, type RawFrame, WorklogRecord, WorklogState, foldWorklog, frameToRecord, reduceWorklog, resolveInterpreter, useWorklog };

package/dist/worklog/index.d.ts

@@ -0,0 +1,29 @@
+import { E as EventInterpreter, W as WorklogState, a as WorklogRecord } from '../types-CIqszY3g.js';
+export { d as EventRole, N as NodeKind, b as NodeStatus, R as RunStatus, c as WorklogNode, i as initialWorklogState } from '../types-CIqszY3g.js';
+
+declare const EVENT_REGISTRY: Record<string, EventInterpreter>;
+declare function resolveInterpreter(eventClass: string): EventInterpreter;
+
+declare function reduceWorklog(state: WorklogState, record: WorklogRecord): WorklogState;
+declare function foldWorklog(records: WorklogRecord[], taskId?: string | null): WorklogState;
+
+/** Live worklog accumulator. Feed it `bus_mode` records via `ingest`; use `foldWorklog` for history. */
+declare function useWorklog(taskId?: string | null): {
+    worklog: WorklogState;
+    ingest: (record: WorklogRecord) => void;
+    ingestMany: (records: WorklogRecord[]) => void;
+    reset: (id?: string | null) => void;
+};
+
+/** Loosely-typed shape of a parsed SSE `data:` frame from the granular Runtime stream. */
+interface RawFrame {
+    event_class?: string;
+    control_id?: string | null;
+    data?: unknown;
+    status?: string | null;
+    date_submitted?: string;
+}
+/** Normalize a parsed SSE frame into a WorklogRecord (defaults missing fields; never throws). */
+declare function frameToRecord(frame: RawFrame): WorklogRecord;
+
+export { EVENT_REGISTRY, EventInterpreter, type RawFrame, WorklogRecord, WorklogState, foldWorklog, frameToRecord, reduceWorklog, resolveInterpreter, useWorklog };