@illalabs/interfaces 0.8.0 → 0.8.1-canary-beta-9cda8b33

package/dist/types/illaMessage.d.ts

@@ -0,0 +1,57 @@
+import type { FilePart, ProviderOptions, ReasoningPart, SystemModelMessage, TextPart, ToolApprovalRequest, ToolApprovalResponse, UserModelMessage } from "@ai-sdk/provider-utils";
+import type { SupportedAction } from "../utils/constants.js";
+import type { ActionOutputMapping } from "./actions/outputs.js";
+export type IllaToolCallPart<A extends SupportedAction = SupportedAction> = {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: A;
+    input: unknown;
+    providerOptions?: ProviderOptions;
+    providerExecuted?: boolean;
+};
+export type IllaToolResultOutput<A extends SupportedAction = SupportedAction> = {
+    type: "json";
+    value: ActionOutputMapping[A];
+    providerOptions?: ProviderOptions;
+} | {
+    type: "text";
+    value: string;
+    providerOptions?: ProviderOptions;
+} | {
+    type: "error-text";
+    value: string;
+    providerOptions?: ProviderOptions;
+} | {
+    type: "error-json";
+    value: unknown;
+    providerOptions?: ProviderOptions;
+} | {
+    type: "execution-denied";
+    reason?: string;
+    providerOptions?: ProviderOptions;
+};
+export type IllaToolResultPart<A extends SupportedAction = SupportedAction> = {
+    type: "tool-result";
+    toolCallId: string;
+    toolName: A;
+    output: IllaToolResultOutput<A>;
+    providerOptions?: ProviderOptions;
+};
+export type TypedToolCallPart = {
+    [A in SupportedAction]: IllaToolCallPart<A>;
+}[SupportedAction];
+export type TypedToolResultPart = {
+    [A in SupportedAction]: IllaToolResultPart<A>;
+}[SupportedAction];
+export type IllaAssistantMessage = {
+    role: "assistant";
+    content: string | Array<TextPart | FilePart | ReasoningPart | TypedToolCallPart | TypedToolResultPart | ToolApprovalRequest>;
+    providerOptions?: ProviderOptions;
+};
+export type IllaToolMessage = {
+    role: "tool";
+    content: Array<TypedToolResultPart | ToolApprovalResponse>;
+    providerOptions?: ProviderOptions;
+};
+export type IllaMessage = SystemModelMessage | UserModelMessage | IllaAssistantMessage | IllaToolMessage;
+//# sourceMappingURL=illaMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"illaMessage.d.ts","sourceRoot":"","sources":["../../src/types/illaMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,QAAQ,EACR,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IACxE,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IACtE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IAC1E,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG;KAC3B,CAAC,IAAI,eAAe,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAC9C,CAAC,eAAe,CAAC,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAAG;KAC7B,CAAC,IAAI,eAAe,GAAG,kBAAkB,CAAC,CAAC,CAAC;CAChD,CAAC,eAAe,CAAC,CAAC;AAInB,MAAM,MAAM,oBAAoB,GAAG;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EACD,MAAM,GACN,KAAK,CACC,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,CACxB,CAAC;IACR,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,CAAC;IAC3D,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,WAAW,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,oBAAoB,GACpB,eAAe,CAAC"}

package/dist/types/illaMessage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=illaMessage.js.map

package/dist/types/illaMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"illaMessage.js","sourceRoot":"","sources":["../../src/types/illaMessage.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -4,4 +4,6 @@ export * from "./planning.js";
 export * from "./telemetry.js";
 export * from "./streaming.js";
 export * from "./planningRuntime.js";
+export * from "./illaMessage.js";
+export * from "./typedToolTypes.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/types/index.js

@@ -4,4 +4,6 @@ export * from "./planning.js";
 export * from "./telemetry.js";
 export * from "./streaming.js";
 export * from "./planningRuntime.js";
+export * from "./illaMessage.js";
+export * from "./typedToolTypes.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/types/telemetry.d.ts

@@ -3,7 +3,10 @@
  * 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, planExecutionCompleteEventSchema, planExecutionFailedEventSchema, planExpiredEventSchema, planGeneratedEventSchema, planGeneratingEventSchema, planInvalidatedEventSchema, planStepCompletedEventSchema, planStepRetryingEventSchema, planStepSimulatedEventSchema, planStepStartedEventSchema, planStepVerificationFailedEventSchema, planStepVerificationPassedEventSchema, replanCompleteEventSchema, replanStartedEventSchema, resultEventDataSchema, RetryPhaseSchema, scratchpadResetEventSchema, streamEndEventDataSchema, streamEndTelemetryEventSchema, streamEventDataSchema, telemetryEventSchema, telemetryEventTypes, textDeltaEventSchema, toolCallBatchEventSchema, toolResultEventSchema } from "../schemas/telemetryEvents.js";
+import type { SupportedAction } from "../utils/constants.js";
+import type { IllaMessage } from "./illaMessage.js";
+import type { TypedIllaToolErrorUnion, TypedPendingToolCallUnion } from "./typedToolTypes.js";
+import { baseTelemetryEventSchema, connectedEventSchema, errorEventDataSchema, errorTelemetryEventSchema, finishEventSchema, iterationEndEventSchema, iterationStartEventSchema, llmEndEventSchema, llmStartEventSchema, planExecutionCompleteEventSchema, planExecutionFailedEventSchema, planExpiredEventSchema, planGeneratedEventSchema, planGeneratingEventSchema, planInvalidatedEventSchema, planStepCompletedEventSchema, planStepRetryingEventSchema, planStepSimulatedEventSchema, planStepStartedEventSchema, planStepVerificationFailedEventSchema, planStepVerificationPassedEventSchema, replanCompleteEventSchema, replanStartedEventSchema, RetryPhaseSchema, 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.
@@ -95,10 +98,30 @@ export type ErrorEvent = z.infer<typeof errorTelemetryEventSchema>;
  */
 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>;
+ * Result event data with strongly-typed fields for switch narrowing.
+ *
+ * Decoupled from `z.infer<typeof resultEventDataSchema>` because Zod infers
+ * `pendingTools` as `PendingToolCallType[]` (with `input: unknown`) and
+ * `toolErrors` as `IllaToolErrorJSON[]`, neither of which supports
+ * discriminated-union narrowing on `toolName`/`name`.
+ *
+ * The Zod schema is still used for **runtime** validation; this type is
+ * the **compile-time** contract that consumers see.
+ */
+export type ValidatedResultEventData = {
+    readonly type: "result";
+    readonly status: 200;
+    readonly messages: IllaMessage[];
+    readonly text: string;
+    readonly pendingTools?: ReadonlyArray<TypedPendingToolCallUnion>;
+    readonly incompleteTools?: ReadonlyArray<{
+        readonly toolCallId: string;
+        readonly toolName: SupportedAction;
+        readonly toolInput?: unknown;
+    }>;
+    readonly toolErrors?: ReadonlyArray<TypedIllaToolErrorUnion>;
+    readonly requestId: string;
+};
 /**
  * Inferred type for error event data from Zod schema.
  * Used by ErrorStreamEvent for type-safe runtime validation.

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

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

package/dist/types/telemetry.js

@@ -3,5 +3,5 @@
  * 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, planExecutionCompleteEventSchema, planExecutionFailedEventSchema, planExpiredEventSchema, planGeneratedEventSchema, planGeneratingEventSchema, planInvalidatedEventSchema, planStepCompletedEventSchema, planStepRetryingEventSchema, planStepSimulatedEventSchema, planStepStartedEventSchema, planStepVerificationFailedEventSchema, planStepVerificationPassedEventSchema, replanCompleteEventSchema, replanStartedEventSchema, resultEventDataSchema, RetryPhaseSchema, scratchpadResetEventSchema, streamEndEventDataSchema, streamEndTelemetryEventSchema, streamEventDataSchema, telemetryEventSchema, telemetryEventTypes, textDeltaEventSchema, toolCallBatchEventSchema, toolResultEventSchema, } from "../schemas/telemetryEvents.js";
+import { baseTelemetryEventSchema, connectedEventSchema, errorEventDataSchema, errorTelemetryEventSchema, finishEventSchema, iterationEndEventSchema, iterationStartEventSchema, llmEndEventSchema, llmStartEventSchema, planExecutionCompleteEventSchema, planExecutionFailedEventSchema, planExpiredEventSchema, planGeneratedEventSchema, planGeneratingEventSchema, planInvalidatedEventSchema, planStepCompletedEventSchema, planStepRetryingEventSchema, planStepSimulatedEventSchema, planStepStartedEventSchema, planStepVerificationFailedEventSchema, planStepVerificationPassedEventSchema, replanCompleteEventSchema, replanStartedEventSchema, RetryPhaseSchema, scratchpadResetEventSchema, streamEndEventDataSchema, streamEndTelemetryEventSchema, streamEventDataSchema, telemetryEventSchema, telemetryEventTypes, textDeltaEventSchema, toolCallBatchEventSchema, toolResultEventSchema, } from "../schemas/telemetryEvents.js";
 //# sourceMappingURL=telemetry.js.map

package/dist/types/telemetry.js.map

@@ -1 +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,gCAAgC,EAChC,8BAA8B,EAC9B,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,qCAAqC,EACrC,qCAAqC,EACrC,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,GACxB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/types/telemetry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EACH,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,gCAAgC,EAChC,8BAA8B,EAC9B,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,qCAAqC,EACrC,qCAAqC,EACrC,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,GACxB,MAAM,+BAA+B,CAAC"}

package/dist/types/typedToolTypes.d.ts

@@ -0,0 +1,65 @@
+import type { IllaToolErrorData } from "../schemas/illaTools.js";
+import type { SimulationResult } from "../schemas/messages.js";
+import type { SupportedAction } from "../utils/constants.js";
+import type { ActionBatchTransactionsOutput, ActionOutputMapping, ActionSequenceOutput, ActionSignatureRequestsOutput, ActionSingleTransactionOutput, EvmTransaction } from "./actions/outputs.js";
+/**
+ * Output shapes that produce on-chain operations and appear in pendingTools.
+ * The API's OrchestrateOutputBuilder only includes these in pendingTools.
+ */
+type TransactionLikeOutput = ActionBatchTransactionsOutput<EvmTransaction> | ActionSingleTransactionOutput<EvmTransaction> | ActionSignatureRequestsOutput | ActionSequenceOutput<EvmTransaction>;
+/**
+ * Computes the subset of SupportedAction whose output is transaction-like.
+ * Actions with data-only outputs (ActionDataOutput) are excluded — they
+ * never appear in pendingTools at runtime.
+ */
+type PendingToolAction = {
+    [A in SupportedAction]: Extract<ActionOutputMapping[A], TransactionLikeOutput> extends never ? never : A;
+}[SupportedAction];
+/**
+ * Pending tool call typed by action name.
+ * When switching on toolName, `input` auto-narrows to that action's output shape.
+ *
+ * Note: `input` is named for legacy reasons — it actually holds the action's OUTPUT
+ * (the transaction/sequence the client must execute).
+ */
+export type TypedPendingToolCall<A extends PendingToolAction = PendingToolAction> = {
+    readonly type: "tool-call";
+    readonly toolCallId: string;
+    readonly toolName: A;
+    readonly input: Extract<ActionOutputMapping[A], TransactionLikeOutput>;
+    readonly simulated?: boolean;
+    readonly simulation?: SimulationResult;
+};
+/**
+ * Union of all typed pending tool calls, enabling switch narrowing:
+ *
+ * ```typescript
+ * for (const tool of response.pendingTools) {
+ *   switch (tool.toolName) {
+ *     case "swap":
+ *       tool.input // ActionBatchTransactionsOutput<EvmTransaction>
+ *       break;
+ *     case "predictionMarketsBet":
+ *       tool.input // ActionSequenceOutput<EvmTransaction>
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type TypedPendingToolCallUnion = {
+    [A in PendingToolAction]: TypedPendingToolCall<A>;
+}[PendingToolAction];
+/**
+ * Tool error typed by action name.
+ */
+export type TypedIllaToolError<A extends SupportedAction = SupportedAction> = {
+    readonly id: string;
+    readonly name: A;
+    readonly data: IllaToolErrorData;
+};
+/** Union enabling switch narrowing on name */
+export type TypedIllaToolErrorUnion = {
+    [A in SupportedAction]: TypedIllaToolError<A>;
+}[SupportedAction];
+export {};
+//# sourceMappingURL=typedToolTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typedToolTypes.d.ts","sourceRoot":"","sources":["../../src/types/typedToolTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACR,6BAA6B,EAC7B,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,6BAA6B,EAC7B,cAAc,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,KAAK,qBAAqB,GACpB,6BAA6B,CAAC,cAAc,CAAC,GAC7C,6BAA6B,CAAC,cAAc,CAAC,GAC7C,6BAA6B,GAC7B,oBAAoB,CAAC,cAAc,CAAC,CAAC;AAE3C;;;;GAIG;AACH,KAAK,iBAAiB,GAAG;KACpB,CAAC,IAAI,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,SAAS,KAAK,GACtF,KAAK,GACL,CAAC;CACV,CAAC,eAAe,CAAC,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IAAI;IAChF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,yBAAyB,GAAG;KACnC,CAAC,IAAI,iBAAiB,GAAG,oBAAoB,CAAC,CAAC,CAAC;CACpD,CAAC,iBAAiB,CAAC,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CACpC,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,uBAAuB,GAAG;KACjC,CAAC,IAAI,eAAe,GAAG,kBAAkB,CAAC,CAAC,CAAC;CAChD,CAAC,eAAe,CAAC,CAAC"}

package/dist/types/typedToolTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typedToolTypes.js.map

package/dist/types/typedToolTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedToolTypes.js","sourceRoot":"","sources":["../../src/types/typedToolTypes.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illalabs/interfaces",
-  "version": "0.8.0",
+  "version": "0.8.1-canary-beta-9cda8b33",
   "description": "ILLA interfaces and types",
   "repository": {
     "type": "git",