@illalabs/interfaces 0.3.0-canary.361ed2fa → 0.3.0-canary.4647332c

package/dist/types/telemetry.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Telemetry event types for real-time orchestration monitoring.
+ * Event types are inferred from Zod schemas for type-safe runtime validation.
+ */
+import { z } from "zod";
+import { baseTelemetryEventSchema, connectedEventSchema, errorEventDataSchema, errorTelemetryEventSchema, finishEventSchema, iterationEndEventSchema, iterationStartEventSchema, llmEndEventSchema, llmStartEventSchema, resultEventDataSchema, scratchpadResetEventSchema, streamEndEventDataSchema, streamEndTelemetryEventSchema, streamEventDataSchema, telemetryEventSchema, telemetryEventTypes, textDeltaEventSchema, toolCallBatchEventSchema, toolResultEventSchema } from "../schemas/telemetryEvents.js";
+/**
+ * Types of telemetry events that can be emitted during orchestration.
+ * Inferred from telemetryEventTypes schema constant.
+ */
+export type TelemetryEventType = (typeof telemetryEventTypes)[number];
+/**
+ * Base telemetry event structure.
+ * Inferred from baseTelemetryEventSchema.
+ */
+export type BaseTelemetryEvent = z.infer<typeof baseTelemetryEventSchema>;
+/**
+ * Event emitted when connected to telemetry stream.
+ * Inferred from connectedEventSchema.
+ */
+export type ConnectedEvent = z.infer<typeof connectedEventSchema>;
+/**
+ * Event emitted when stream ends.
+ * Inferred from streamEndTelemetryEventSchema.
+ */
+export type StreamEndEvent = z.infer<typeof streamEndTelemetryEventSchema>;
+/**
+ * Event emitted when an iteration starts.
+ * Inferred from iterationStartEventSchema.
+ */
+export type IterationStartEvent = z.infer<typeof iterationStartEventSchema>;
+/**
+ * Event emitted when an iteration ends.
+ * Inferred from iterationEndEventSchema.
+ */
+export type IterationEndEvent = z.infer<typeof iterationEndEventSchema>;
+/**
+ * Event emitted when tool calls are batched for execution.
+ * Inferred from toolCallBatchEventSchema.
+ */
+export type ToolCallBatchEvent = z.infer<typeof toolCallBatchEventSchema>;
+/**
+ * Status of a tool execution result.
+ * Inferred from toolResultEventSchema data discriminator.
+ */
+export type ToolResultStatus = z.infer<typeof toolResultEventSchema>["data"]["status"];
+/**
+ * Tool result data with discriminated status field.
+ * - "pending": Tool execution is waiting for user action (e.g., signature)
+ * - "success": Tool executed successfully
+ * - "failure": Tool execution failed, error field contains details
+ *
+ * Extracted from toolResultEventSchema data field.
+ */
+export type ToolResultData = z.infer<typeof toolResultEventSchema>["data"];
+/**
+ * Event emitted when a tool execution completes.
+ * Inferred from toolResultEventSchema.
+ */
+export type ToolResultEvent = z.infer<typeof toolResultEventSchema>;
+/**
+ * Event emitted when the scratchpad is reset.
+ * Inferred from scratchpadResetEventSchema.
+ */
+export type ScratchpadResetEvent = z.infer<typeof scratchpadResetEventSchema>;
+/**
+ * Event emitted when LLM generation starts.
+ * Inferred from llmStartEventSchema.
+ */
+export type LLMStartEvent = z.infer<typeof llmStartEventSchema>;
+/**
+ * Event emitted when LLM generation ends.
+ * Inferred from llmEndEventSchema.
+ */
+export type LLMEndEvent = z.infer<typeof llmEndEventSchema>;
+/**
+ * Event emitted when a text chunk is received from the LLM during streaming.
+ * Inferred from textDeltaEventSchema.
+ */
+export type TextDeltaEvent = z.infer<typeof textDeltaEventSchema>;
+/**
+ * Event emitted when orchestration finishes.
+ * Inferred from finishEventSchema.
+ */
+export type FinishEvent = z.infer<typeof finishEventSchema>;
+/**
+ * Event emitted when an error occurs.
+ * The data field is required and always contains error details.
+ * Inferred from errorTelemetryEventSchema.
+ */
+export type ErrorEvent = z.infer<typeof errorTelemetryEventSchema>;
+/**
+ * Union type of all telemetry events.
+ * Inferred from telemetryEventSchema discriminated union.
+ */
+export type TelemetryEvent = z.infer<typeof telemetryEventSchema>;
+/**
+ * Inferred type for result event data from Zod schema.
+ * Used by ResultStreamEvent for type-safe runtime validation.
+ */
+export type ValidatedResultEventData = z.infer<typeof resultEventDataSchema>;
+/**
+ * Inferred type for error event data from Zod schema.
+ * Used by ErrorStreamEvent for type-safe runtime validation.
+ */
+export type ValidatedErrorEventData = z.infer<typeof errorEventDataSchema>;
+/**
+ * Inferred type for stream_end event data from Zod schema.
+ * Used by StreamEndEvent for type-safe runtime validation.
+ */
+export type ValidatedStreamEndEventData = z.infer<typeof streamEndEventDataSchema>;
+/**
+ * Inferred union type for all stream event data.
+ */
+export type ValidatedStreamEventData = z.infer<typeof streamEventDataSchema>;
+/**
+ * Response type that includes requestId for telemetry subscription
+ */
+export type TelemetryEnabledResponse = {
+    /** Request ID for subscribing to telemetry stream */
+    requestId: string;
+};
+/**
+ * Orchestrator phases for UI display
+ */
+export type OrchestratorPhase = "idle" | "thinking" | "streaming" | "calling_tools" | "executing_tools" | "processing_results" | "complete" | "error";
+/**
+ * Observer interface for receiving telemetry events from the orchestrator.
+ * Implement this interface to receive real-time events during orchestration.
+ */
+export interface OrchestratorObserver {
+    /** Called when an event occurs */
+    onEvent(event: TelemetryEvent): void;
+    /** Called when orchestration completes */
+    onComplete(): void;
+    /** Called when an error occurs */
+    onError(error: Error): void;
+}
+//# sourceMappingURL=telemetry.d.ts.map

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

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

package/dist/types/telemetry.js

@@ -0,0 +1,7 @@
+/**
+ * Telemetry event types for real-time orchestration monitoring.
+ * Event types are inferred from Zod schemas for type-safe runtime validation.
+ */
+import { z } from "zod";
+import { baseTelemetryEventSchema, connectedEventSchema, errorEventDataSchema, errorTelemetryEventSchema, finishEventSchema, iterationEndEventSchema, iterationStartEventSchema, llmEndEventSchema, llmStartEventSchema, resultEventDataSchema, scratchpadResetEventSchema, streamEndEventDataSchema, streamEndTelemetryEventSchema, streamEventDataSchema, telemetryEventSchema, telemetryEventTypes, textDeltaEventSchema, toolCallBatchEventSchema, toolResultEventSchema, } from "../schemas/telemetryEvents.js";
+//# sourceMappingURL=telemetry.js.map

package/dist/types/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/types/telemetry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACH,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,GACxB,MAAM,+BAA+B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illalabs/interfaces",
-  "version": "0.3.0-canary.361ed2fa",
+  "version": "0.3.0-canary.4647332c",
   "description": "ILLA interfaces and types",
   "repository": {
     "type": "git",
@@ -24,10 +24,10 @@
     "zod": "3.25.76"
   },
   "devDependencies": {
-    "viem": "2.26.2"
+    "viem": "2.37.13"
   },
   "peerDependencies": {
-    "viem": "2.26.x"
+    "viem": "2.37.x"
   },
   "publishConfig": {
     "access": "public"