@homeflare/distilled-litellm 0.2.0

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,KAAK,UAAU,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,KAAK,eAAe,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,KAAK,GAAG,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,WAAW,GACX,eAAe,CAAC,eAAe,CAAC;AAEpC,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC;AAoEnE,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CA0BlD,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,135 @@
+/**
+ * LitellmProtocol — the shared bearer-REST protocol instantiated for
+ * LiteLLM Proxy.
+ *
+ * LiteLLM speaks plain JSON with no consistent success envelope — some
+ * responses are the resource itself, others wrap a list in a named field
+ * (`{"keys": [...]}`, `{"endpoints": [...]}`) per-resource, decoded by each
+ * operation's own generated schema, not by this protocol.
+ *
+ * Authentication: `Authorization: Bearer <key>` — LiteLLM's own `litellm`
+ * CLI client uses it (`litellm/proxy/client/cli/main.py` at tag v1.100.0),
+ * and every `/key`, `/team`, `/user`, `/budget`, `/model` and `/config`
+ * route's `Depends(user_api_key_auth)` accepts it. ⚠️ VERIFIED AGAINST THE
+ * SPEC, AND FOUND WRONG: the vendor's own OpenAPI document (`litellm-openapi`
+ * @ 1.100.0) declares exactly one `securitySchemes` entry —
+ * `APIKeyHeader` (`type: apiKey`, `in: header`, `name: x-litellm-api-key`,
+ * `description: "Bearer token"`) — not a `Bearer`/`http`-scheme security
+ * requirement, and no operation references it (`security` is `null` at the
+ * document root and on every operation). FastAPI's OpenAPI generator only
+ * introspects a route's declared `Security()`/`Depends()` dependency for
+ * the scheme it documents; `user_api_key_auth` accepts an `Authorization:
+ * Bearer <key>` header by reading it directly out of the request in Python
+ * (not through a `Security(APIKeyHeader(...))` FastAPI can introspect), so
+ * the spec's own securityScheme names a header LiteLLM's docs, CLI and this
+ * package do not actually send. `Bearer` is used here because it is what
+ * the vendor's own client sends and what homeflare's existing
+ * `packages/alchemy/src/litellm/client.ts` already verified works — the
+ * spec is necessary input, not sufficient, exactly the case the Typed Error
+ * Doctrine exists for.
+ *
+ * Failure envelope: heterogeneous, measured against the pinned v1.100.0
+ * source (`litellm/proxy/proxy_server.py`'s `ProxyException` handler at the
+ * tag, and every `management_endpoints/*.py` file) — see `errorEnvelope`
+ * below and `errors.ts`'s header for the two shapes and why.
+ *
+ * Pagination: ad hoc per resource (`page`/`size` on some list routes,
+ * `offset`/`limit` on others), no shared cursor/token — see
+ * `scripts/generate.ts`.
+ */
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { makeRestProtocol, } from "@distilled.cloud/core/protocol-rest";
+import { Credentials } from "./credentials.js";
+import { UnknownLitellmError } from "./errors.js";
+/**
+ * Extract `{ message, code }` from a failed response body. Two real shapes,
+ * both observed in the pinned source (see this file's header):
+ *
+ * 1. A genuine `ProxyException` (`proxy_server.py`'s
+ *    `openai_exception_handler`): `{"error": {"message", "type", "param",
+ *    "code"}}` — no `detail` wrapper at all.
+ * 2. Plain FastAPI `HTTPException(status_code, detail=...)` — the vast
+ *    majority of raises across `key_management_endpoints.py`,
+ *    `team_endpoints.py`, `internal_user_endpoints.py`,
+ *    `budget_management_endpoints.py`, `model_management_endpoints.py`,
+ *    `pass_through_endpoints.py` and `litellm_pre_call_utils.py` — where
+ *    `detail` is EITHER a plain string (`detail=f"..."`) →
+ *    `{"detail": "<string>"}`, OR a dict shaped one of two ways:
+ *    `{"error": "<full sentence>"}` (the common `budget_management_endpoints.py`
+ *    shape — the whole message IS the `error` field), or an OpenAI-triple
+ *    `{"error": "<short code>", "message": "<full sentence>", "param": ...}`
+ *    (`litellm_pre_call_utils.py`'s `reject_url_valued_destination`, hit on
+ *    EVERY proxied LLM call via `add_litellm_data_to_request` — not a corner
+ *    case). ⚠️ MEASURED: when both `message` and `error` are present on the
+ *    SAME object, `error` is a short code (`"invalid_request"`) and
+ *    `message` is the human-readable text — `message` must win, or a real,
+ *    actionable error collapses to a code word. There is no consistent
+ *    machine-readable `code` on this path — `code` is only ever a
+ *    `ProxyException`'s stringified HTTP status, so it is not threaded
+ *    through here.
+ */
+const messageFrom = (v) => {
+    if (v === null || typeof v !== "object" || Array.isArray(v)) {
+        return undefined;
+    }
+    const o = v;
+    // A sibling `message` always wins over a short `error` code — see this
+    // function's header (the `reject_url_valued_destination` shape).
+    if (typeof o.message === "string")
+        return o.message;
+    if (typeof o.error === "string")
+        return o.error;
+    if (o.error !== null &&
+        typeof o.error === "object" &&
+        !Array.isArray(o.error)) {
+        const inner = o.error;
+        if (typeof inner.message === "string")
+            return inner.message;
+    }
+    return undefined;
+};
+const errorEnvelope = (body) => {
+    if (body === null || typeof body !== "object")
+        return undefined;
+    const b = body;
+    // Shape 1: a bare ProxyException envelope, or a top-level string `error`
+    // (defensive — not observed, but cheap to accept).
+    if (typeof b.error === "string")
+        return { message: b.error };
+    const proxyExceptionMessage = messageFrom(b);
+    if (proxyExceptionMessage !== undefined)
+        return { message: proxyExceptionMessage };
+    // Shape 2: FastAPI's `{"detail": ...}`.
+    if (typeof b.detail === "string")
+        return { message: b.detail };
+    const detailMessage = messageFrom(b.detail);
+    if (detailMessage !== undefined)
+        return { message: detailMessage };
+    return undefined;
+};
+export const LitellmProtocol = makeRestProtocol({
+    // Resolved on the CALLING fiber per request (the layer is memoized per
+    // process); the Credentials service holds an effect, so a key rotated
+    // between calls is picked up without rebuilding the layer.
+    credentials: Effect.gen(function* () {
+        const resolve = yield* Credentials;
+        return yield* resolve;
+    }),
+    baseUrl: (creds) => creds.apiBaseUrl,
+    headers: (creds) => ({
+        Authorization: `Bearer ${Redacted.value(creds.apiKey)}`,
+        Accept: "application/json",
+    }),
+    errorEnvelope,
+    unknownError: ({ code, message, body }) => new UnknownLitellmError({
+        code: typeof code === "string"
+            ? code
+            : code !== undefined
+                ? String(code)
+                : undefined,
+        message,
+        body,
+    }),
+});
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * LiteLLM retry surface — a veneer over `@distilled.cloud/core/retry`.
+ *
+ * The `Retry` service tag is threaded into every generated operation via
+ * `API.make({ retry: Retry })`, so a caller-installed policy applies to all
+ * LiteLLM calls below it and core's `makeDefault` is the fallback when none
+ * is provided.
+ *
+ * @example
+ * ```ts
+ * import * as Litellm from "@distilled.cloud/litellm";
+ *
+ * myEffect.pipe(Litellm.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Retries from "@distilled.cloud/core/retry";
+export type Options = Retries.Options;
+export type Factory = Retries.Factory;
+export type Policy = Retries.Policy;
+declare const Retry_base: Context.ServiceClass<Retry, "LitellmRetry", Retries.Policy>;
+/** Context tag for configuring retry behavior of LiteLLM API calls. */
+export declare class Retry extends Retry_base {
+}
+/** Provides a custom retry policy to every LiteLLM API call below it. */
+export declare const policy: {
+    (options: Options): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+    (factory: Factory): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+};
+/** Disables all automatic retries. */
+export declare const none: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/**
+ * The default retry policy (core's): transient/throttling/retryable errors,
+ * capped exponential backoff with jitter, server `retryAfter` hints honored
+ * with precedence.
+ */
+export declare const makeDefault: Factory;
+export declare const jittered: <Error, Env>(self: import("effect/Schedule").Schedule<unknown, unknown, Error, Env>) => import("effect/Schedule").Schedule<unknown, unknown, Error, Env>;
+export declare const capped: (max: import("effect/Duration").Duration) => <Error, Env>(self: import("effect/Schedule").Schedule<unknown, unknown, Error, Env>) => import("effect/Schedule").Schedule<unknown, unknown, Error, Env>;
+/** Retry options that retry all throttling errors indefinitely. */
+export declare const throttlingOptions: Options;
+/** Retries all throttling errors indefinitely (honoring server hints). */
+export declare const throttling: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Retry options that retry all transient errors indefinitely. */
+export declare const transientOptions: Options;
+/** Retries all transient errors indefinitely (honoring server hints). */
+export declare const transient: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;AACtC,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;AACtC,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;;AAEpC,uEAAuE;AACvE,qBAAa,KAAM,SAAQ,UAAgD;CAAG;AAE9E,yEAAyE;AACzE,eAAO,MAAM,MAAM,EAAE;IACnB,CACE,OAAO,EAAE,OAAO,GACf,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,CACE,OAAO,EAAE,OAAO,GACf,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;CAEU,CAAC;AAEzD,sCAAsC;AACtC,eAAO,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAEzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,OAA6B,CAAC;AAExD,eAAO,MAAM,QAAQ,0JAAmB,CAAC;AACzC,eAAO,MAAM,MAAM,uMAAiB,CAAC;AAErC,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,OAAmC,CAAC;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAqC,CAAC;AAEhF,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,OAAkC,CAAC;AAElE,yEAAyE;AACzE,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAoC,CAAC"}

package/dist/retry.js

@@ -0,0 +1,43 @@
+/**
+ * LiteLLM retry surface — a veneer over `@distilled.cloud/core/retry`.
+ *
+ * The `Retry` service tag is threaded into every generated operation via
+ * `API.make({ retry: Retry })`, so a caller-installed policy applies to all
+ * LiteLLM calls below it and core's `makeDefault` is the fallback when none
+ * is provided.
+ *
+ * @example
+ * ```ts
+ * import * as Litellm from "@distilled.cloud/litellm";
+ *
+ * myEffect.pipe(Litellm.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Retries from "@distilled.cloud/core/retry";
+/** Context tag for configuring retry behavior of LiteLLM API calls. */
+export class Retry extends Context.Service()("LitellmRetry") {
+}
+/** Provides a custom retry policy to every LiteLLM API call below it. */
+export const policy = (optionsOrFactory) => Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+/** Disables all automatic retries. */
+export const none = Effect.provide(Layer.succeed(Retry, { while: () => false }));
+/**
+ * The default retry policy (core's): transient/throttling/retryable errors,
+ * capped exponential backoff with jitter, server `retryAfter` hints honored
+ * with precedence.
+ */
+export const makeDefault = Retries.makeDefault;
+export const jittered = Retries.jittered;
+export const capped = Retries.capped;
+/** Retry options that retry all throttling errors indefinitely. */
+export const throttlingOptions = Retries.throttlingOptions;
+/** Retries all throttling errors indefinitely (honoring server hints). */
+export const throttling = policy(Retries.throttlingFactory);
+/** Retry options that retry all transient errors indefinitely. */
+export const transientOptions = Retries.transientOptions;
+/** Retries all transient errors indefinitely (honoring server hints). */
+export const transient = policy(Retries.transientFactory);
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAMvD,uEAAuE;AACvE,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,cAAc,CAAC;CAAG;AAE9E,yEAAyE;AACzE,MAAM,CAAC,MAAM,MAAM,GAWf,CAAC,gBAAmC,EAAE,EAAE,CAC1C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzD,sCAAsC;AACtC,MAAM,CAAC,MAAM,IAAI,GAE6B,MAAM,CAAC,OAAO,CAC1D,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAY,OAAO,CAAC,WAAW,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AAErC,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAEuB,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAY,OAAO,CAAC,gBAAgB,CAAC;AAElE,yEAAyE;AACzE,MAAM,CAAC,MAAM,SAAS,GAEwB,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/services/a2a.d.ts

@@ -0,0 +1,70 @@
+import * as S from "@distilled.cloud/core/schema";
+import * as API from "@distilled.cloud/core/api";
+import { type LitellmOpError, type LitellmOpContext } from "../protocol.ts";
+export type { LitellmOpError, LitellmOpContext };
+declare const UnprocessableEntity_base: S.Class<UnprocessableEntity, S.TaggedStruct<"UnprocessableEntity", {
+    readonly code: any;
+    readonly message: any;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        BadRequestError: true;
+    };
+});
+export declare class UnprocessableEntity extends /*@__PURE__*/ UnprocessableEntity_base {
+}
+export interface GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest {
+    agent_id: string;
+}
+export declare const GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest: S.Schema<GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest>;
+export interface GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse {
+    body: unknown;
+}
+export declare const GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse: S.Schema<GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse>;
+export interface GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest {
+    agent_id: string;
+}
+export declare const GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest: S.Schema<GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest>;
+export interface GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse {
+    body: unknown;
+}
+export declare const GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse: S.Schema<GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse>;
+export interface InvokeAgentA2aA2aAgentIdMessageSendPostRequest {
+    agent_id: string;
+}
+export declare const InvokeAgentA2aA2aAgentIdMessageSendPostRequest: S.Schema<InvokeAgentA2aA2aAgentIdMessageSendPostRequest>;
+export interface InvokeAgentA2aA2aAgentIdMessageSendPostResponse {
+    body: unknown;
+}
+export declare const InvokeAgentA2aA2aAgentIdMessageSendPostResponse: S.Schema<InvokeAgentA2aA2aAgentIdMessageSendPostResponse>;
+export interface InvokeAgentA2aA2aAgentIdPostRequest {
+    agent_id: string;
+}
+export declare const InvokeAgentA2aA2aAgentIdPostRequest: S.Schema<InvokeAgentA2aA2aAgentIdPostRequest>;
+export interface InvokeAgentA2aA2aAgentIdPostResponse {
+    body: unknown;
+}
+export declare const InvokeAgentA2aA2aAgentIdPostResponse: S.Schema<InvokeAgentA2aA2aAgentIdPostResponse>;
+export interface InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest {
+    agent_id: string;
+}
+export declare const InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest: S.Schema<InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest>;
+export interface InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse {
+    body: unknown;
+}
+export declare const InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse: S.Schema<InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse>;
+export type GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetError = UnprocessableEntity | LitellmOpError;
+/** Get Agent Card Get the agent card for an agent (A2A discovery endpoint). Supports both standard paths: - /.well-known/agent-card.json - /.well-known/agent.json The URL in the agent card is rewritten to point to the LiteLLM proxy, so all subsequent A2A calls go through LiteLLM for logging and cost tracking. */
+export declare const getAgentCardA2aAgentIdWellKnownAgentCardJsonGet: API.OperationMethod<GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest, GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse, GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetError, LitellmOpContext>;
+export type GetAgentCardA2aAgentIdWellKnownAgentJsonGetError = UnprocessableEntity | LitellmOpError;
+/** Get Agent Card Get the agent card for an agent (A2A discovery endpoint). Supports both standard paths: - /.well-known/agent-card.json - /.well-known/agent.json The URL in the agent card is rewritten to point to the LiteLLM proxy, so all subsequent A2A calls go through LiteLLM for logging and cost tracking. */
+export declare const getAgentCardA2aAgentIdWellKnownAgentJsonGet: API.OperationMethod<GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest, GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse, GetAgentCardA2aAgentIdWellKnownAgentJsonGetError, LitellmOpContext>;
+export type InvokeAgentA2aA2aAgentIdMessageSendPostError = UnprocessableEntity | LitellmOpError;
+/** Invoke Agent A2A Invoke an agent using the A2A protocol (JSON-RPC 2.0). Supported methods: - message/send: Send a message and get a response - message/stream: Send a message and stream the response */
+export declare const invokeAgentA2aA2aAgentIdMessageSendPost: API.OperationMethod<InvokeAgentA2aA2aAgentIdMessageSendPostRequest, InvokeAgentA2aA2aAgentIdMessageSendPostResponse, InvokeAgentA2aA2aAgentIdMessageSendPostError, LitellmOpContext>;
+export type InvokeAgentA2aA2aAgentIdPostError = UnprocessableEntity | LitellmOpError;
+/** Invoke Agent A2A Invoke an agent using the A2A protocol (JSON-RPC 2.0). Supported methods: - message/send: Send a message and get a response - message/stream: Send a message and stream the response */
+export declare const invokeAgentA2aA2aAgentIdPost: API.OperationMethod<InvokeAgentA2aA2aAgentIdPostRequest, InvokeAgentA2aA2aAgentIdPostResponse, InvokeAgentA2aA2aAgentIdPostError, LitellmOpContext>;
+export type InvokeAgentA2aV1A2aAgentIdMessageSendPostError = UnprocessableEntity | LitellmOpError;
+/** Invoke Agent A2A Invoke an agent using the A2A protocol (JSON-RPC 2.0). Supported methods: - message/send: Send a message and get a response - message/stream: Send a message and stream the response */
+export declare const invokeAgentA2aV1A2aAgentIdMessageSendPost: API.OperationMethod<InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest, InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse, InvokeAgentA2aV1A2aAgentIdMessageSendPostError, LitellmOpContext>;
+//# sourceMappingURL=a2a.d.ts.map

package/dist/services/a2a.d.ts.map

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

package/dist/services/a2a.js

@@ -0,0 +1,128 @@
+// AUTO-GENERATED by scripts/generate.ts from .generated-specs (pinned litellm-openapi @ 1.100.0 — see README). Do not edit.
+import * as S from "@distilled.cloud/core/schema";
+import * as API from "@distilled.cloud/core/api";
+import * as C from "@distilled.cloud/core/category";
+import * as T from "../traits.js";
+import { LitellmProtocol, } from "../protocol.js";
+import * as Retry from "../retry.js";
+export class UnprocessableEntity extends /*@__PURE__*/ /*@__PURE__*/ T.applyErrorMatchers(
+/*@__PURE__*/ S.TaggedError()("UnprocessableEntity", {
+    code: S.Number,
+    message: S.String,
+}).pipe(C.withBadRequestError), [{ status: 422 }]) {
+}
+export const GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    agent_id: S.String.pipe(T.Label()),
+}).pipe(T.Http({
+    method: "GET",
+    uri: "/a2a/{agent_id}/.well-known/agent-card.json",
+    code: 200,
+}))).annotate({
+    identifier: "GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest",
+});
+export const GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    body: S.Unknown,
+})).annotate({
+    identifier: "GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse",
+});
+export const GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    agent_id: S.String.pipe(T.Label()),
+}).pipe(T.Http({
+    method: "GET",
+    uri: "/a2a/{agent_id}/.well-known/agent.json",
+    code: 200,
+}))).annotate({
+    identifier: "GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest",
+});
+export const GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    body: S.Unknown,
+})).annotate({
+    identifier: "GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse",
+});
+export const InvokeAgentA2aA2aAgentIdMessageSendPostRequest = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    agent_id: S.String.pipe(T.Label()),
+}).pipe(T.Http({
+    method: "POST",
+    uri: "/a2a/{agent_id}/message/send",
+    code: 200,
+}))).annotate({
+    identifier: "InvokeAgentA2aA2aAgentIdMessageSendPostRequest",
+});
+export const InvokeAgentA2aA2aAgentIdMessageSendPostResponse = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    body: S.Unknown,
+})).annotate({
+    identifier: "InvokeAgentA2aA2aAgentIdMessageSendPostResponse",
+});
+export const InvokeAgentA2aA2aAgentIdPostRequest = /*@__PURE__*/ S.suspend(() => S.Struct({
+    agent_id: S.String.pipe(T.Label()),
+}).pipe(T.Http({ method: "POST", uri: "/a2a/{agent_id}", code: 200 }))).annotate({
+    identifier: "InvokeAgentA2aA2aAgentIdPostRequest",
+});
+export const InvokeAgentA2aA2aAgentIdPostResponse = /*@__PURE__*/ S.suspend(() => S.Struct({
+    body: S.Unknown,
+})).annotate({
+    identifier: "InvokeAgentA2aA2aAgentIdPostResponse",
+});
+export const InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    agent_id: S.String.pipe(T.Label()),
+}).pipe(T.Http({
+    method: "POST",
+    uri: "/v1/a2a/{agent_id}/message/send",
+    code: 200,
+}))).annotate({
+    identifier: "InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest",
+});
+export const InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    body: S.Unknown,
+})).annotate({
+    identifier: "InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse",
+});
+/** Get Agent Card Get the agent card for an agent (A2A discovery endpoint). Supports both standard paths: - /.well-known/agent-card.json - /.well-known/agent.json The URL in the agent card is rewritten to point to the LiteLLM proxy, so all subsequent A2A calls go through LiteLLM for logging and cost tracking. */
+export const getAgentCardA2aAgentIdWellKnownAgentCardJsonGet = /*@__PURE__*/ API.make(() => ({
+    input: GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetRequest,
+    output: GetAgentCardA2aAgentIdWellKnownAgentCardJsonGetResponse,
+    errors: [UnprocessableEntity],
+    protocol: LitellmProtocol,
+    retry: Retry.Retry,
+}));
+/** Get Agent Card Get the agent card for an agent (A2A discovery endpoint). Supports both standard paths: - /.well-known/agent-card.json - /.well-known/agent.json The URL in the agent card is rewritten to point to the LiteLLM proxy, so all subsequent A2A calls go through LiteLLM for logging and cost tracking. */
+export const getAgentCardA2aAgentIdWellKnownAgentJsonGet = /*@__PURE__*/ API.make(() => ({
+    input: GetAgentCardA2aAgentIdWellKnownAgentJsonGetRequest,
+    output: GetAgentCardA2aAgentIdWellKnownAgentJsonGetResponse,
+    errors: [UnprocessableEntity],
+    protocol: LitellmProtocol,
+    retry: Retry.Retry,
+}));
+/** Invoke Agent A2A Invoke an agent using the A2A protocol (JSON-RPC 2.0). Supported methods: - message/send: Send a message and get a response - message/stream: Send a message and stream the response */
+export const invokeAgentA2aA2aAgentIdMessageSendPost = /*@__PURE__*/ API.make(() => ({
+    input: InvokeAgentA2aA2aAgentIdMessageSendPostRequest,
+    output: InvokeAgentA2aA2aAgentIdMessageSendPostResponse,
+    errors: [UnprocessableEntity],
+    protocol: LitellmProtocol,
+    retry: Retry.Retry,
+}));
+/** Invoke Agent A2A Invoke an agent using the A2A protocol (JSON-RPC 2.0). Supported methods: - message/send: Send a message and get a response - message/stream: Send a message and stream the response */
+export const invokeAgentA2aA2aAgentIdPost = /*@__PURE__*/ API.make(() => ({
+    input: InvokeAgentA2aA2aAgentIdPostRequest,
+    output: InvokeAgentA2aA2aAgentIdPostResponse,
+    errors: [UnprocessableEntity],
+    protocol: LitellmProtocol,
+    retry: Retry.Retry,
+}));
+/** Invoke Agent A2A Invoke an agent using the A2A protocol (JSON-RPC 2.0). Supported methods: - message/send: Send a message and get a response - message/stream: Send a message and stream the response */
+export const invokeAgentA2aV1A2aAgentIdMessageSendPost = /*@__PURE__*/ API.make(() => ({
+    input: InvokeAgentA2aV1A2aAgentIdMessageSendPostRequest,
+    output: InvokeAgentA2aV1A2aAgentIdMessageSendPostResponse,
+    errors: [UnprocessableEntity],
+    protocol: LitellmProtocol,
+    retry: Retry.Retry,
+}));
+//# sourceMappingURL=a2a.js.map

package/dist/services/a2a.js.map

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

package/dist/services/a2a_registration.d.ts

@@ -0,0 +1,43 @@
+import * as S from "@distilled.cloud/core/schema";
+import * as API from "@distilled.cloud/core/api";
+import { type LitellmOpError, type LitellmOpContext } from "../protocol.ts";
+export type { LitellmOpError, LitellmOpContext };
+declare const UnprocessableEntity_base: S.Class<UnprocessableEntity, S.TaggedStruct<"UnprocessableEntity", {
+    readonly code: any;
+    readonly message: any;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        BadRequestError: true;
+    };
+});
+export declare class UnprocessableEntity extends /*@__PURE__*/ UnprocessableEntity_base {
+}
+/** How to locate the upstream agent card. String-valued so it serializes cleanly over JSON / Pydantic. */
+export type DiscoveryMode = "well_known_fallback" | "langgraph_platform";
+export declare const DiscoveryMode: any;
+export type PostDiscoverAgentCardV1A2aDiscoverRequestParamsMap = {
+    [key: string]: unknown | undefined;
+};
+export declare const PostDiscoverAgentCardV1A2aDiscoverRequestParamsMap: S.Schema<PostDiscoverAgentCardV1A2aDiscoverRequestParamsMap>;
+export interface PostDiscoverAgentCardV1A2aDiscoverRequest {
+    /** How to locate the upstream card. ``well_known_fallback`` for pure A2A agents (try standard paths); ``langgraph_platform`` for LangGraph Platform deployments where the card is shared across assistants and disambiguated by a query parameter. */
+    discovery_mode?: DiscoveryMode | (string & {});
+    /** Mode-specific parameters. ``langgraph_platform`` requires ``{'assistant_id': <id>}``. ``well_known_fallback`` ignores this. */
+    params?: PostDiscoverAgentCardV1A2aDiscoverRequestParamsMap | null;
+    /** Base URL of the upstream agent. Behavior depends on ``discovery_mode``: ``well_known_fallback`` (default) tries /.well-known/agent-card.json, /.well-known/agent.json, /agent.json under this URL in order; ``langgraph_platform`` hits ``/.well-known/agent-card.json?assistant_id=<id>`` instead. */
+    url: string;
+}
+export declare const PostDiscoverAgentCardV1A2aDiscoverRequest: S.Schema<PostDiscoverAgentCardV1A2aDiscoverRequest>;
+export type DiscoverAgentResponseAgentCardMap = {
+    [key: string]: unknown | undefined;
+};
+export declare const DiscoverAgentResponseAgentCardMap: S.Schema<DiscoverAgentResponseAgentCardMap>;
+export interface DiscoverAgentResponse {
+    agent_card: DiscoverAgentResponseAgentCardMap;
+    url: string;
+}
+export declare const DiscoverAgentResponse: S.Schema<DiscoverAgentResponse>;
+export type PostDiscoverAgentCardV1A2aDiscoverError = UnprocessableEntity | LitellmOpError;
+/** Discover Agent Card Fetch the upstream agent's well-known card so the UI can show the admin which skills/capabilities the agent exposes. Only proxy admins can call this — the UI uses it during agent registration, and we don't want arbitrary keys probing internal URLs. Example: ```bash curl -X POST "http://localhost:4000/v1/a2a/discover" \ -H "Authorization: Bearer <admin_key>" \ -H "Content-Type: application/json" \ -d '{"url": "https://upstream-agent.example.com"}' ``` */
+export declare const postDiscoverAgentCardV1A2aDiscover: API.OperationMethod<PostDiscoverAgentCardV1A2aDiscoverRequest, DiscoverAgentResponse, PostDiscoverAgentCardV1A2aDiscoverError, LitellmOpContext>;
+//# sourceMappingURL=a2a_registration.d.ts.map

package/dist/services/a2a_registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a_registration.d.ts","sourceRoot":"","sources":["../../src/services/a2a_registration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,8BAA8B,CAAC;AAClD,OAAO,KAAK,GAAG,MAAM,2BAA2B,CAAC;AAGjD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;;;;;;;;;AAEjD,qBAAa,mBACX,SAAQ,aAAa,CAAC,wBAMrB;CAAG;AAEN,0GAA0G;AAC1G,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AACzE,eAAO,MAAM,aAAa,KAAW,CAAC;AAEtC,MAAM,MAAM,kDAAkD,GAAG;IAC/D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACpC,CAAC;AACF,eAAO,MAAM,kDAAkD,EAIjD,CAAC,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC;AAE3E,MAAM,WAAW,yCAAyC;IACxD,sPAAsP;IACtP,cAAc,CAAC,EAAE,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC/C,kIAAkI;IAClI,MAAM,CAAC,EAAE,kDAAkD,GAAG,IAAI,CAAC;IACnE,0SAA0S;IAC1S,GAAG,EAAE,MAAM,CAAC;CACb;AACD,eAAO,MAAM,yCAAyC,EAWvC,CAAC,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;AAEnE,MAAM,MAAM,iCAAiC,GAAG;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACpC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAGlC,CAAC,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,iCAAiC,CAAC;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AACD,eAAO,MAAM,qBAAqB,EAOrB,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAE7C,MAAM,MAAM,uCAAuC,GAC/C,mBAAmB,GACnB,cAAc,CAAC;AACnB,ieAAie;AACje,eAAO,MAAM,kCAAkC,EAAE,GAAG,CAAC,eAAe,CAClE,yCAAyC,EACzC,qBAAqB,EACrB,uCAAuC,EACvC,gBAAgB,CAOf,CAAC"}

package/dist/services/a2a_registration.js

@@ -0,0 +1,40 @@
+// AUTO-GENERATED by scripts/generate.ts from .generated-specs (pinned litellm-openapi @ 1.100.0 — see README). Do not edit.
+import * as S from "@distilled.cloud/core/schema";
+import * as API from "@distilled.cloud/core/api";
+import * as C from "@distilled.cloud/core/category";
+import * as T from "../traits.js";
+import { LitellmProtocol, } from "../protocol.js";
+import * as Retry from "../retry.js";
+export class UnprocessableEntity extends /*@__PURE__*/ /*@__PURE__*/ T.applyErrorMatchers(
+/*@__PURE__*/ S.TaggedError()("UnprocessableEntity", {
+    code: S.Number,
+    message: S.String,
+}).pipe(C.withBadRequestError), [{ status: 422 }]) {
+}
+export const DiscoveryMode = S.String;
+export const PostDiscoverAgentCardV1A2aDiscoverRequestParamsMap = 
+/*@__PURE__*/ S.Record(S.String, S.Unknown);
+export const PostDiscoverAgentCardV1A2aDiscoverRequest = 
+/*@__PURE__*/ S.suspend(() => S.Struct({
+    discovery_mode: S.optional(DiscoveryMode),
+    params: S.optional(S.NullOr(PostDiscoverAgentCardV1A2aDiscoverRequestParamsMap)),
+    url: S.String,
+}).pipe(T.Http({ method: "POST", uri: "/v1/a2a/discover", code: 200 }))).annotate({
+    identifier: "PostDiscoverAgentCardV1A2aDiscoverRequest",
+});
+export const DiscoverAgentResponseAgentCardMap = /*@__PURE__*/ S.Record(S.String, S.Unknown);
+export const DiscoverAgentResponse = /*@__PURE__*/ S.suspend(() => S.Struct({
+    agent_card: DiscoverAgentResponseAgentCardMap,
+    url: S.String,
+})).annotate({
+    identifier: "DiscoverAgentResponse",
+});
+/** Discover Agent Card Fetch the upstream agent's well-known card so the UI can show the admin which skills/capabilities the agent exposes. Only proxy admins can call this — the UI uses it during agent registration, and we don't want arbitrary keys probing internal URLs. Example: ```bash curl -X POST "http://localhost:4000/v1/a2a/discover" \ -H "Authorization: Bearer <admin_key>" \ -H "Content-Type: application/json" \ -d '{"url": "https://upstream-agent.example.com"}' ``` */
+export const postDiscoverAgentCardV1A2aDiscover = /*@__PURE__*/ API.make(() => ({
+    input: PostDiscoverAgentCardV1A2aDiscoverRequest,
+    output: DiscoverAgentResponse,
+    errors: [UnprocessableEntity],
+    protocol: LitellmProtocol,
+    retry: Retry.Retry,
+}));
+//# sourceMappingURL=a2a_registration.js.map

package/dist/services/a2a_registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a_registration.js","sourceRoot":"","sources":["../../src/services/a2a_registration.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,OAAO,KAAK,CAAC,MAAM,8BAA8B,CAAC;AAClD,OAAO,KAAK,GAAG,MAAM,2BAA2B,CAAC;AACjD,OAAO,KAAK,CAAC,MAAM,gCAAgC,CAAC;AACpD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EACL,eAAe,GAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AAIrC,MAAM,OAAO,mBACX,SAAQ,aAAa,CAAb,aAAa,CAAC,CAAC,CAAC,kBAAkB;AACxC,aAAa,CAAC,CAAC,CAAC,WAAW,EAAuB,CAAC,qBAAqB,EAAE;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM;IACd,OAAO,EAAE,CAAC,CAAC,MAAM;CAClB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAC9B,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAClB;CAAG;AAIN,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;AAKtC,MAAM,CAAC,MAAM,kDAAkD;AAC7D,aAAa,CAAC,CAAC,CAAC,MAAM,CACpB,CAAC,CAAC,MAAM,EACR,CAAC,CAAC,OAAO,CAC6D,CAAC;AAU3E,MAAM,CAAC,MAAM,yCAAyC;AACpD,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAC3B,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAChB,CAAC,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAC7D;IACD,GAAG,EAAE,CAAC,CAAC,MAAM;CACd,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CACxE,CAAC,QAAQ,CAAC;IACT,UAAU,EAAE,2CAA2C;CACxD,CAA+D,CAAC;AAKnE,MAAM,CAAC,MAAM,iCAAiC,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CACrE,CAAC,CAAC,MAAM,EACR,CAAC,CAAC,OAAO,CAC4C,CAAC;AAMxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAChE,CAAC,CAAC,MAAM,CAAC;IACP,UAAU,EAAE,iCAAiC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM;CACd,CAAC,CACH,CAAC,QAAQ,CAAC;IACT,UAAU,EAAE,uBAAuB;CACpC,CAA2C,CAAC;AAK7C,ieAAie;AACje,MAAM,CAAC,MAAM,kCAAkC,GAK3C,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,KAAK,EAAE,yCAAyC;IAChD,MAAM,EAAE,qBAAqB;IAC7B,MAAM,EAAE,CAAC,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,KAAK,CAAC,KAAK;CACnB,CAAC,CAAC,CAAC"}