@ironflow/core 0.19.2 → 0.20.0

package/README.md

@@ -106,6 +106,8 @@ interface FunctionConfig<TEventSchema extends z.ZodType = z.ZodType> {
   id: string;
   /** Display name for the function */
   name?: string;
+  /** Human-readable description shown in the dashboard */
+  description?: string;
   /** Event triggers that invoke this function */
   triggers: Trigger[];
   /** Retry configuration for failed steps */
@@ -114,6 +116,8 @@ interface FunctionConfig<TEventSchema extends z.ZodType = z.ZodType> {
   timeout?: number;
   /** Concurrency control configuration */
   concurrency?: ConcurrencyConfig;
+  /** Debounce configuration — collapse rapid-fire events into a single invocation */
+  debounce?: DebounceConfig;
   /** Execution mode: "push" for serverless, "pull" for workers */
   mode?: ExecutionMode;
   /** JSON path for actor-based sticky routing */
@@ -130,6 +134,8 @@ interface FunctionConfig<TEventSchema extends z.ZodType = z.ZodType> {
   recordingRetention?: string;
   /** Pause behavior for scoped injection ("hold" or "release") */
   pauseBehavior?: PauseBehavior;
+  /** Run compensations in reverse order when a pull-mode run is cancelled mid-saga */
+  compensateOnCancel?: boolean;
   /** Custom metadata (e.g., service, team, owner) */
   metadata?: Record<string, unknown>;
 }
@@ -174,6 +180,39 @@ interface ConcurrencyConfig {
 }
 ```
 
+### DebounceConfig
+
+Collapses rapid-fire events into a single invocation after a quiet period. Async-only — `TriggerSync` rejects debounced functions with `FailedPrecondition`.
+
+```typescript
+interface DebounceConfig {
+  /** Quiet period in milliseconds. Floor: 1000 (1 second). */
+  periodMs: number;
+  /** JSON path for per-key debouncing (e.g., "userId"). Omit for a global lane. */
+  key?: string;
+  /**
+   * Optional starvation cap. Handler fires at least once every maxWaitMs
+   * even under continuous resets. Must be >= periodMs. Omit for no cap.
+   */
+  maxWaitMs?: number;
+}
+```
+
+Example — debounce search-as-you-type events per user for 5 seconds:
+
+```typescript
+const processSearch = ironflow.createFunction(
+  {
+    id: "process-search",
+    triggers: [{ event: "search.requested" }],
+    debounce: { periodMs: 5000, key: "userId" },
+  },
+  async ({ event, step }) => {
+    /* ... */
+  }
+);
+```
+
 ### ExecutionMode
 
 ```typescript
@@ -707,6 +746,8 @@ interface AppendOptions {
   idempotencyKey?: string;
   /** Event schema version (default: 1) */
   version?: number;
+  /** Cross-cutting metadata (causation, correlation, tenant, trace) attached to the event */
+  metadata?: Record<string, unknown>;
 }
 ```
 
@@ -716,6 +757,12 @@ interface AppendOptions {
 interface AppendResult {
   entityVersion: number;
   eventId: string;
+  /**
+   * NATS JetStream sequence on the PUBSUB stream. Pass to
+   * projections.waitForCatchup({ minSeq }) for read-your-writes.
+   * 0 (or undefined) means publish failed or unavailable.
+   */
+  sequence?: number;
 }
 ```
 
@@ -1249,15 +1296,21 @@ interface ProjectionStatusInfo {
 
 ### ProjectionStateResult
 
+Returned by `client.projections.get()` (Node) and `ironflow.getProjection()` (browser) after `peelProjectionEnvelope()` strips the server REST wire shape. `name`, `version`, `mode`, `status`, `lastEventSeq`, `updatedAt`, and `errorMessage` come from the registry envelope. `partition`, `state`, `lastEventId`, and `lastEventTime` come from the inner state row. `lastEventTime` is `undefined` when no state row exists yet (projection registered, no events applied); `state` is `{}` in that case. `errorMessage` is omitted when the projection is healthy.
+
 ```typescript
 interface ProjectionStateResult<TState = unknown> {
   name: string;
   partition: string;
   state: TState;
   lastEventId: string;
-  lastEventTime: Date;
+  lastEventTime?: Date;
+  lastEventSeq: number;
   version: number;
   mode: ProjectionMode;
+  status?: ProjectionStatus;
+  errorMessage?: string;
+  updatedAt: Date;
 }
 ```
 

package/dist/errors.d.ts

@@ -183,6 +183,33 @@ export declare class RunCancelledError extends IronflowError {
     readonly runId: string;
     constructor(runId: string);
 }
+/**
+ * Thrown when ironflow.agents.invoke() exceeds opts.timeoutMs before a
+ * terminal run event is observed. SDK best-effort calls cancelRun(runId).
+ */
+export declare class AgentInvokeTimeoutError extends IronflowError {
+    readonly runId: string;
+    readonly timeoutMs: number;
+    constructor(runId: string, timeoutMs: number);
+}
+/**
+ * Thrown when a Trigger response carries no runIds. Indicates server
+ * misconfiguration or a function not registered for the supplied name.
+ */
+export declare class NoRunCreatedError extends IronflowError {
+    readonly functionName: string;
+    constructor(functionName: string);
+}
+/**
+ * Thrown when ironflow.agents.readMemory() exceeds opts.timeoutMs while
+ * waiting for the projection to catch up to opts.minSeq.
+ */
+export declare class MemoryCatchupTimeoutError extends IronflowError {
+    readonly projection: string;
+    readonly minSeq: bigint;
+    readonly timeoutMs: number;
+    constructor(projection: string, minSeq: bigint, timeoutMs: number);
+}
 /**
  * Thrown when no/invalid API key is provided (HTTP 401)
  */

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -296,6 +296,57 @@ export class RunCancelledError extends IronflowError {
         this.runId = runId;
     }
 }
+/**
+ * Thrown when ironflow.agents.invoke() exceeds opts.timeoutMs before a
+ * terminal run event is observed. SDK best-effort calls cancelRun(runId).
+ */
+export class AgentInvokeTimeoutError extends IronflowError {
+    runId;
+    timeoutMs;
+    constructor(runId, timeoutMs) {
+        super(`agents.invoke timed out after ${timeoutMs}ms (runId=${runId})`, {
+            code: "AGENT_INVOKE_TIMEOUT",
+            retryable: true,
+        });
+        this.name = "AgentInvokeTimeoutError";
+        this.runId = runId;
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Thrown when a Trigger response carries no runIds. Indicates server
+ * misconfiguration or a function not registered for the supplied name.
+ */
+export class NoRunCreatedError extends IronflowError {
+    functionName;
+    constructor(functionName) {
+        super(`No run created for "${functionName}" (empty runIds)`, {
+            code: "NO_RUN_CREATED",
+            retryable: false,
+        });
+        this.name = "NoRunCreatedError";
+        this.functionName = functionName;
+    }
+}
+/**
+ * Thrown when ironflow.agents.readMemory() exceeds opts.timeoutMs while
+ * waiting for the projection to catch up to opts.minSeq.
+ */
+export class MemoryCatchupTimeoutError extends IronflowError {
+    projection;
+    minSeq;
+    timeoutMs;
+    constructor(projection, minSeq, timeoutMs) {
+        super(`agents.readMemory timed out after ${timeoutMs}ms waiting for projection "${projection}" to reach minSeq=${minSeq}`, {
+            code: "MEMORY_CATCHUP_TIMEOUT",
+            retryable: true,
+        });
+        this.name = "MemoryCatchupTimeoutError";
+        this.projection = projection;
+        this.minSeq = minSeq;
+        this.timeoutMs = timeoutMs;
+    }
+}
 /**
  * Thrown when no/invalid API key is provided (HTTP 401)
  */

package/dist/errors.js.map

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

package/dist/gen/ironflow/v1/agent_tools_pb.d.ts

@@ -0,0 +1,384 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ironflow/v1/agent_tools.proto.
+ */
+export declare const file_ironflow_v1_agent_tools: GenFile;
+/**
+ * ToolDef describes a single agent-registered tool. Input schema is
+ * supplied as a JSON Schema document (Draft 2020-12). The server
+ * compiles and caches the schema at register time so per-invoke
+ * validation is constant-time.
+ *
+ * @generated from message ironflow.v1.ToolDef
+ */
+export type ToolDef = Message<"ironflow.v1.ToolDef"> & {
+    /**
+     * Tool name, unique within the agent's namespace. The qualified
+     * name surfaced to MCP clients is `{agentName}.{name}`.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Human-readable description shown to MCP clients.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * JSON Schema (Draft 2020-12) for the tool input, serialized as
+     * a JSON string. Validated server-side before dispatch.
+     *
+     * @generated from field: string input_schema_json = 3;
+     */
+    inputSchemaJson: string;
+    /**
+     * Required scopes. The calling API key's tool_scopes must be a
+     * superset of this list. Empty list = no scope check (still
+     * requires the agent:tools:invoke action).
+     *
+     * @generated from field: repeated string required_scopes = 4;
+     */
+    requiredScopes: string[];
+    /**
+     * Per-tool dispatch timeout in milliseconds. Bounded
+     * [1ms, 60000ms] by the SDK contract; server caps at the env
+     * setting IRONFLOW_AGENT_TOOLS_MAX_TIMEOUT_MS (default 60000).
+     * Hard cap is 120000ms.
+     *
+     * @generated from field: uint32 timeout_ms = 5;
+     */
+    timeoutMs: number;
+};
+/**
+ * Describes the message ironflow.v1.ToolDef.
+ * Use `create(ToolDefSchema)` to create a new message.
+ */
+export declare const ToolDefSchema: GenMessage<ToolDef>;
+/**
+ * @generated from message ironflow.v1.RegisterToolRequest
+ */
+export type RegisterToolRequest = Message<"ironflow.v1.RegisterToolRequest"> & {
+    /**
+     * Agent name namespace (e.g. "doc-processor"). Must be unique
+     * within (orgID, envID) for a given owning API key.
+     *
+     * @generated from field: string agent_name = 1;
+     */
+    agentName: string;
+    /**
+     * Callback URL the server will POST dispatch requests to. Must
+     * be http:// or https://. RFC1918 + loopback addresses are
+     * rejected unless the server is started with --dev or the host
+     * matches IRONFLOW_AGENT_TOOLS_URL_ALLOWLIST.
+     *
+     * @generated from field: string callback_url = 2;
+     */
+    callbackUrl: string;
+    /**
+     * Tool definitions registered under this agent name.
+     *
+     * @generated from field: repeated ironflow.v1.ToolDef tools = 3;
+     */
+    tools: ToolDef[];
+};
+/**
+ * Describes the message ironflow.v1.RegisterToolRequest.
+ * Use `create(RegisterToolRequestSchema)` to create a new message.
+ */
+export declare const RegisterToolRequestSchema: GenMessage<RegisterToolRequest>;
+/**
+ * @generated from message ironflow.v1.RegisterToolResponse
+ */
+export type RegisterToolResponse = Message<"ironflow.v1.RegisterToolResponse"> & {
+    /**
+     * HMAC shared secret (32-byte hex). Returned ONCE — SDK must
+     * store it in memory. Re-registration rotates this value.
+     *
+     * @generated from field: string hmac_secret = 1;
+     */
+    hmacSecret: string;
+    /**
+     * Qualified names of registered tools (`{agentName}.{toolName}`).
+     *
+     * @generated from field: repeated string registered_tool_names = 2;
+     */
+    registeredToolNames: string[];
+    /**
+     * Server-assigned registration timestamp.
+     *
+     * @generated from field: google.protobuf.Timestamp registered_at = 3;
+     */
+    registeredAt?: Timestamp;
+};
+/**
+ * Describes the message ironflow.v1.RegisterToolResponse.
+ * Use `create(RegisterToolResponseSchema)` to create a new message.
+ */
+export declare const RegisterToolResponseSchema: GenMessage<RegisterToolResponse>;
+/**
+ * @generated from message ironflow.v1.InvokeToolRequest
+ */
+export type InvokeToolRequest = Message<"ironflow.v1.InvokeToolRequest"> & {
+    /**
+     * Qualified tool name (`{agentName}.{toolName}`).
+     *
+     * @generated from field: string tool_name = 1;
+     */
+    toolName: string;
+    /**
+     * Input arguments. Validated against the tool's input_schema_json.
+     *
+     * @generated from field: google.protobuf.Struct input = 2;
+     */
+    input?: JsonObject;
+};
+/**
+ * Describes the message ironflow.v1.InvokeToolRequest.
+ * Use `create(InvokeToolRequestSchema)` to create a new message.
+ */
+export declare const InvokeToolRequestSchema: GenMessage<InvokeToolRequest>;
+/**
+ * @generated from message ironflow.v1.InvokeToolResponse
+ */
+export type InvokeToolResponse = Message<"ironflow.v1.InvokeToolResponse"> & {
+    /**
+     * Successful tool output. Set when the SDK handler returned
+     * a value. Mutually exclusive with error.
+     *
+     * @generated from field: google.protobuf.Struct output = 1;
+     */
+    output?: JsonObject;
+    /**
+     * Error envelope. Set when dispatch failed or the SDK handler
+     * returned an error. Mutually exclusive with output.
+     *
+     * @generated from field: ironflow.v1.ToolError error = 2;
+     */
+    error?: ToolError;
+};
+/**
+ * Describes the message ironflow.v1.InvokeToolResponse.
+ * Use `create(InvokeToolResponseSchema)` to create a new message.
+ */
+export declare const InvokeToolResponseSchema: GenMessage<InvokeToolResponse>;
+/**
+ * @generated from message ironflow.v1.ToolError
+ */
+export type ToolError = Message<"ironflow.v1.ToolError"> & {
+    /**
+     * Stable error code. One of:
+     *   TOOL_NOT_FOUND
+     *   SCOPE_MISMATCH
+     *   INPUT_SCHEMA_INVALID
+     *   CALLBACK_UNREACHABLE
+     *   CALLBACK_TIMEOUT
+     *   CALLBACK_INVALID_RESPONSE
+     *   HANDLER_ERROR
+     *
+     * @generated from field: string code = 1;
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     *
+     * @generated from field: string message = 2;
+     */
+    message: string;
+};
+/**
+ * Describes the message ironflow.v1.ToolError.
+ * Use `create(ToolErrorSchema)` to create a new message.
+ */
+export declare const ToolErrorSchema: GenMessage<ToolError>;
+/**
+ * @generated from message ironflow.v1.UnregisterToolRequest
+ */
+export type UnregisterToolRequest = Message<"ironflow.v1.UnregisterToolRequest"> & {
+    /**
+     * @generated from field: string agent_name = 1;
+     */
+    agentName: string;
+};
+/**
+ * Describes the message ironflow.v1.UnregisterToolRequest.
+ * Use `create(UnregisterToolRequestSchema)` to create a new message.
+ */
+export declare const UnregisterToolRequestSchema: GenMessage<UnregisterToolRequest>;
+/**
+ * @generated from message ironflow.v1.UnregisterToolResponse
+ */
+export type UnregisterToolResponse = Message<"ironflow.v1.UnregisterToolResponse"> & {
+    /**
+     * Number of tools removed. Zero indicates the agent name was
+     * not registered (idempotent).
+     *
+     * @generated from field: uint32 removed_count = 1;
+     */
+    removedCount: number;
+};
+/**
+ * Describes the message ironflow.v1.UnregisterToolResponse.
+ * Use `create(UnregisterToolResponseSchema)` to create a new message.
+ */
+export declare const UnregisterToolResponseSchema: GenMessage<UnregisterToolResponse>;
+/**
+ * @generated from message ironflow.v1.ListToolsRequest
+ */
+export type ListToolsRequest = Message<"ironflow.v1.ListToolsRequest"> & {
+    /**
+     * Optional cursor for pagination. v1 always returns full list
+     * (capped at 1000); cursor reserved for future use.
+     *
+     * @generated from field: string cursor = 1;
+     */
+    cursor: string;
+};
+/**
+ * Describes the message ironflow.v1.ListToolsRequest.
+ * Use `create(ListToolsRequestSchema)` to create a new message.
+ */
+export declare const ListToolsRequestSchema: GenMessage<ListToolsRequest>;
+/**
+ * @generated from message ironflow.v1.ListToolsResponse
+ */
+export type ListToolsResponse = Message<"ironflow.v1.ListToolsResponse"> & {
+    /**
+     * Tools visible to the calling API key, filtered by scope
+     * intersection. Each entry includes the qualified tool name.
+     *
+     * @generated from field: repeated ironflow.v1.VisibleTool tools = 1;
+     */
+    tools: VisibleTool[];
+    /**
+     * Reserved for future pagination. Empty in v1.
+     *
+     * @generated from field: string next_cursor = 2;
+     */
+    nextCursor: string;
+};
+/**
+ * Describes the message ironflow.v1.ListToolsResponse.
+ * Use `create(ListToolsResponseSchema)` to create a new message.
+ */
+export declare const ListToolsResponseSchema: GenMessage<ListToolsResponse>;
+/**
+ * @generated from message ironflow.v1.VisibleTool
+ */
+export type VisibleTool = Message<"ironflow.v1.VisibleTool"> & {
+    /**
+     * Qualified name (`{agentName}.{toolName}`).
+     *
+     * @generated from field: string qualified_name = 1;
+     */
+    qualifiedName: string;
+    /**
+     * Human-readable description.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * JSON Schema (Draft 2020-12) for tool input.
+     *
+     * @generated from field: string input_schema_json = 3;
+     */
+    inputSchemaJson: string;
+    /**
+     * Scopes required to invoke. Caller is guaranteed to satisfy
+     * these (the listing already filtered).
+     *
+     * @generated from field: repeated string required_scopes = 4;
+     */
+    requiredScopes: string[];
+};
+/**
+ * Describes the message ironflow.v1.VisibleTool.
+ * Use `create(VisibleToolSchema)` to create a new message.
+ */
+export declare const VisibleToolSchema: GenMessage<VisibleTool>;
+/**
+ * AgentToolsService — runtime path for SDK-defined MCP tools.
+ *
+ * SDK clients register agent tools at boot via RegisterTool. Ironflow
+ * surfaces them through its built-in MCP server (`ironflow mcp`).
+ * MCP clients (Claude Code, Cursor, Windsurf) discover via ListTools
+ * and dispatch via InvokeTool. The server forwards invocation to the
+ * SDK process over HTTP using the registered callback URL.
+ *
+ * Authorization is two-stage:
+ *   Stage 1 (pre-route): API key must hold the action
+ *     agent:tools:{register|invoke|unregister}.
+ *   Stage 2 (in-handler for InvokeTool): the API key's tool_scopes
+ *     must be a superset of the tool's required_scopes.
+ *
+ * Both stages emit auth audit decisions.
+ *
+ * Callback dispatch is signed with HMAC-SHA256 using a shared secret
+ * returned ONCE at register time. The SDK callback handler verifies
+ * X-Ironflow-Signature against the secret. A timestamp header
+ * (X-Ironflow-Timestamp) gates replay within a 5-minute window.
+ *
+ * Registry storage is environment-scoped: keys are
+ * (orgID, envID, agentName, toolName). Single-node SQLite uses an
+ * in-memory map; cluster mode uses NATS KV bucket
+ * SYS_agent_tools_{envID}.
+ *
+ * @generated from service ironflow.v1.AgentToolsService
+ */
+export declare const AgentToolsService: GenService<{
+    /**
+     * Register a set of agent tools under a single agent name.
+     * Returns the HMAC secret used to sign dispatch requests. The
+     * secret is returned ONCE — re-registering the same agent name
+     * (by the same API key) rotates the secret. Registering with
+     * an agent name owned by a different API key returns 409.
+     *
+     * @generated from rpc ironflow.v1.AgentToolsService.RegisterTool
+     */
+    registerTool: {
+        methodKind: "unary";
+        input: typeof RegisterToolRequestSchema;
+        output: typeof RegisterToolResponseSchema;
+    };
+    /**
+     * Invoke a registered tool by qualified name (`{agentName}.{toolName}`).
+     * The server validates input against the tool's JSON Schema, then
+     * POSTs an HMAC-signed dispatch to the registered callback URL.
+     * Returns the SDK handler's response or an error envelope.
+     *
+     * @generated from rpc ironflow.v1.AgentToolsService.InvokeTool
+     */
+    invokeTool: {
+        methodKind: "unary";
+        input: typeof InvokeToolRequestSchema;
+        output: typeof InvokeToolResponseSchema;
+    };
+    /**
+     * Remove all tools registered under an agent name. Idempotent —
+     * unregistering an unknown agent name returns 200. Only the
+     * owning API key may unregister.
+     *
+     * @generated from rpc ironflow.v1.AgentToolsService.UnregisterTool
+     */
+    unregisterTool: {
+        methodKind: "unary";
+        input: typeof UnregisterToolRequestSchema;
+        output: typeof UnregisterToolResponseSchema;
+    };
+    /**
+     * List all tools visible to the calling API key, filtered by
+     * tool_scopes intersection with the calling key's scope set.
+     * Soft-capped at 1000 tools per environment.
+     *
+     * @generated from rpc ironflow.v1.AgentToolsService.ListTools
+     */
+    listTools: {
+        methodKind: "unary";
+        input: typeof ListToolsRequestSchema;
+        output: typeof ListToolsResponseSchema;
+    };
+}>;
+//# sourceMappingURL=agent_tools_pb.d.ts.map

package/dist/gen/ironflow/v1/agent_tools_pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_tools_pb.d.ts","sourceRoot":"","sources":["../../../../src/gen/ironflow/v1/agent_tools_pb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAC4zD,CAAC;AAEx2D;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,GAAG;IACrD;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,OAAO,CACA,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,iCAAiC,CAAC,GAAG;IAC7E;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAAC,mBAAmB,CACxB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,kCAAkC,CAAC,GAAG;IAC/E;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAE9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,UAAU,CAAC,oBAAoB,CAC1B,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,GAAG;IACzE;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,UAAU,CAAC,iBAAiB,CACpB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,gCAAgC,CAAC,GAAG;IAC3E;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAAC,kBAAkB,CACtB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,uBAAuB,CAAC,GAAG;IACzD;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,SAAS,CACJ,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,mCAAmC,CAAC,GAAG;IACjF;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,UAAU,CAAC,qBAAqB,CAC5B,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oCAAoC,CAAC,GAAG;IACnF;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,UAAU,CAAC,sBAAsB,CAC9B,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,8BAA8B,CAAC,GAAG;IACvE;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,UAAU,CAAC,gBAAgB,CAClB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,GAAG;IACzE;;;;;OAKG;IACH,KAAK,EAAE,WAAW,EAAE,CAAC;IAErB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,UAAU,CAAC,iBAAiB,CACpB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,GAAG;IAC7D;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,CAAC,WAAW,CACP,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,CAAC;IACzC;;;;;;;;OAQG;IACH,YAAY,EAAE;QACZ,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,yBAAyB,CAAC;QACxC,MAAM,EAAE,OAAO,0BAA0B,CAAC;KAC3C,CAAC;IACF;;;;;;;OAOG;IACH,UAAU,EAAE;QACV,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,uBAAuB,CAAC;QACtC,MAAM,EAAE,OAAO,wBAAwB,CAAC;KACzC,CAAC;IACF;;;;;;OAMG;IACH,cAAc,EAAE;QACd,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,2BAA2B,CAAC;QAC1C,MAAM,EAAE,OAAO,4BAA4B,CAAC;KAC7C,CAAC;IACF;;;;;;OAMG;IACH,SAAS,EAAE;QACT,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,sBAAsB,CAAC;QACrC,MAAM,EAAE,OAAO,uBAAuB,CAAC;KACxC,CAAC;CACH,CAC6C,CAAC"}