@effect-uai/core 0.15.0 → 0.17.0

package/dist/decision-model/Decision.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Decision.test.mjs","names":["Decision.make","Decision.classify","Decision.rate","Decision.probability","Decision.probabilitiesOf","Decision.ranked","Decision.winner","Decision.topLevel","Decision.expectedLevel","Decision.confidence","Decision.margin","Decision.assertKinds","AiError.Unsupported"],"sources":["../../src/decision-model/Decision.test.ts"],"sourcesContent":["import { describe, it } from \"@effect/vitest\"\nimport { Effect, Layer, Option, Ref, Schema } from \"effect\"\nimport { expect, expectTypeOf } from \"vitest\"\nimport * as AiError from \"../domain/AiError.js\"\nimport * as Decision from \"./Decision.js\"\nimport { decide, DecisionModel, type DecisionModelService } from \"./DecisionModel.js\"\n\nconst triage = Decision.make({\n  inputSchema: Schema.Struct({ message: Schema.String }),\n  decisions: {\n    department: Decision.classify({\n      instructions: \"Which team should handle this?\",\n      criteria: { billing: \"Payments, invoicing\", technical: \"Bugs, outages\" },\n    }),\n    severity: Decision.rate({\n      instructions: \"How severe is it?\",\n      criteria: [\"Cosmetic\", \"Degraded\", \"Blocking\"],\n    }),\n    urgent: Decision.probability({ instructions: \"Does this convey urgency?\" }),\n  },\n})\n\nconst fixture = {\n  department: { _tag: \"Classify\", labels: { billing: 0.62, technical: 0.38 } },\n  severity: { _tag: \"Rate\", levels: [0, 0.7, 0.3], legend: [\"Cosmetic\", \"Degraded\", \"Blocking\"] },\n  urgent: { _tag: \"Probability\", probability: 0.94 },\n} as const\n\n/**\n * A fixed fixture cannot prove it satisfies the caller's `Answers<D>`. This is\n * the boundary a provider casts at too, once it has decoded the wire.\n */\nconst fixed = <D extends Decision.Decisions>(\n  answers: Readonly<Record<string, Decision.Answer>>,\n): Decision.Answers<D> => answers as Decision.Answers<D>\n\ntype Call = { readonly input: unknown; readonly model: string }\n\n/** A `DecisionModel` layer that records what reached it. */\nconst recording = Effect.gen(function* () {\n  const calls = yield* Ref.make<ReadonlyArray<Call>>([])\n  const service: DecisionModelService = {\n    decide: (_definition, request) =>\n      Effect.as(\n        Ref.update(calls, (seen) => [...seen, { input: request.input, model: request.model }]),\n        { answers: fixed(fixture), usage: {} },\n      ),\n  }\n  return { calls, layer: Layer.succeed(DecisionModel, service) }\n})\n\ndescribe(\"the answer map is derived from the definition\", () => {\n  it.effect(\"keeps each decision's label keys and rejects labels it never had\", () =>\n    Effect.gen(function* () {\n      const { calls, layer } = yield* recording\n      const result = yield* decide(triage, {\n        model: \"jev-latest\",\n        input: { message: \"hi\" },\n      }).pipe(Effect.provide(layer))\n\n      expectTypeOf(result.answers.department.labels).toEqualTypeOf<{\n        readonly billing: number\n        readonly technical: number\n      }>()\n      // @ts-expect-error shipping is not a label of this decision\n      result.answers.department.labels.shipping\n      // @ts-expect-error a Probability answer has no labels\n      result.answers.urgent.labels\n\n      // `decide` forwards both arguments rather than dropping either.\n      expect(yield* Ref.get(calls)).toEqual([{ input: { message: \"hi\" }, model: \"jev-latest\" }])\n    }),\n  )\n\n  it(\"keeps the rubric as a tuple, so levels are positional rather than parsed\", () => {\n    type Severity = (typeof triage)[\"decisions\"][\"severity\"]\n    expectTypeOf<Decision.AnswerFor<Severity>[\"levels\"]>().toEqualTypeOf<\n      readonly [number, number, number]\n    >()\n    expectTypeOf<Decision.AnswerFor<Severity>[\"legend\"]>().toEqualTypeOf<\n      readonly [\"Cosmetic\", \"Degraded\", \"Blocking\"]\n    >()\n  })\n})\n\ndescribe(\"reading an answer\", () => {\n  it(\"derives a Probability answer's distribution as [p, 1 - p]\", () => {\n    const [yes, no] = Decision.probabilitiesOf(fixture.urgent)\n    expect(yes).toBeCloseTo(0.94, 10)\n    expect(no).toBeCloseTo(0.06, 10)\n  })\n\n  it(\"ranks labels best first and names the winner\", () => {\n    expect(Decision.ranked(fixture.department)).toEqual([\n      { label: \"billing\", probability: 0.62 },\n      { label: \"technical\", probability: 0.38 },\n    ])\n    expect(Decision.winner(fixture.department)).toStrictEqual(Option.some(\"billing\"))\n  })\n\n  it(\"has no winner for an empty label set\", () => {\n    expect(Decision.winner({ _tag: \"Classify\", labels: {} })).toStrictEqual(Option.none())\n  })\n\n  it(\"reads a rubric by index and by expected value\", () => {\n    expect(Decision.topLevel(fixture.severity)).toBe(1)\n    expect(Decision.expectedLevel(fixture.severity)).toBeCloseTo(1.3, 10)\n    expect(fixture.severity.legend[Decision.topLevel(fixture.severity)]).toBe(\"Degraded\")\n  })\n\n  it(\"resolves a level tie to the lowest index\", () => {\n    expect(Decision.topLevel({ _tag: \"Rate\", levels: [0.5, 0.5], legend: [\"a\", \"b\"] })).toBe(0)\n  })\n\n  it(\"computes certainty for every kind, including Probability\", () => {\n    expect(Decision.confidence(fixture.urgent)).toBeCloseTo(0.67, 2)\n    expect(Decision.margin(fixture.urgent)).toBeCloseTo(0.88, 10)\n    expect(Decision.margin(fixture.department)).toBeCloseTo(0.24, 10)\n  })\n})\n\ndescribe(\"assertKinds\", () => {\n  const supported = [\"Classify\", \"Probability\"] as const\n\n  it.effect(\"passes when every kind is supported\", () => {\n    const { department, urgent } = triage.decisions\n    return Decision.assertKinds({ department, urgent }, supported, \"nli\")\n  })\n\n  it.effect(\"fails Unsupported and names every offender at once\", () =>\n    Effect.gen(function* () {\n      const decisions = {\n        ...triage.decisions,\n        impact: Decision.rate({ instructions: \"How bad?\", criteria: [\"low\", \"high\"] }),\n      }\n      const error = yield* Effect.flip(Decision.assertKinds(decisions, supported, \"nli\"))\n\n      expect(error).toBeInstanceOf(AiError.Unsupported)\n      if (error._tag !== \"Unsupported\") return\n\n      expect(error.reason).toContain('\"severity\" is a Rate')\n      expect(error.reason).toContain('\"impact\" is a Rate')\n      expect(error.reason).not.toContain(\"department\")\n    }),\n  )\n})\n"],"mappings":"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"}

package/dist/decision-model/DecisionModel.d.mts

@@ -0,0 +1,45 @@
+import { t as AiError } from "../AiError-DvhLIbmd.mjs";
+import { Answers, Decisions, Definition } from "./Decision.mjs";
+import { Context, Effect } from "effect";
+declare namespace DecisionModel_d_exports {
+  export { CommonDecideRequest, DecideResponse, DecideUsage, DecisionModel, DecisionModelService, decide };
+}
+/** Optional throughout: not every backing reports token counts. */
+type DecideUsage = {
+  readonly inputTokens?: number;
+  readonly outputTokens?: number;
+};
+type DecideResponse<D extends Decisions = Decisions> = {
+  readonly answers: Answers<D>;
+  readonly usage: DecideUsage;
+};
+/**
+ * Cross-provider decide request. The input is billed once for the whole
+ * definition, so batching decisions is cheaper than repeating the input.
+ */
+type CommonDecideRequest<A> = {
+  readonly input: A;
+  /** Each provider narrows this to its typed literal union. */
+  readonly model: string;
+};
+type DecisionModelService = {
+  readonly decide: <A, D extends Decisions>(definition: Definition<A, D>, request: CommonDecideRequest<A>) => Effect.Effect<DecideResponse<D>, AiError>;
+};
+declare const DecisionModel_base: Context.ServiceClass<DecisionModel, "@betalyra/effect-uai/DecisionModel", DecisionModelService>;
+/**
+ * Answering typed questions about an input with probabilities instead of
+ * generating text. The model reports beliefs; the decision stays in the
+ * caller's code.
+ *
+ * Implementor contract: answer every decision or fail. Omitting one leaves a
+ * hole where {@link DecideResponse} promises a key, so a kind the backing
+ * cannot express is rejected up front with `Decision.assertKinds`.
+ *
+ * @experimental The model class this abstracts is new and the shape may change.
+ */
+declare class DecisionModel extends DecisionModel_base {}
+/** Answer a definition's decisions about one input in one call. */
+declare const decide: <A, D extends Decisions>(definition: Definition<A, D>, request: CommonDecideRequest<A>) => Effect.Effect<DecideResponse<D>, AiError, DecisionModel>;
+//#endregion
+export { CommonDecideRequest, DecideResponse, DecideUsage, DecisionModel, DecisionModelService, decide, DecisionModel_d_exports as t };
+//# sourceMappingURL=DecisionModel.d.mts.map

package/dist/decision-model/DecisionModel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionModel.d.mts","names":[],"sources":["../../src/decision-model/DecisionModel.ts"],"mappings":";;;;;;;KAKY;WACD;WACA;;KAGC,eAAe,UAAU,YAAqB;WAC/C,SAAS,QAAiB;WAC1B,OAAO;;;;;;KAON,oBAAoB;WACrB,OAAO;;WAEP;;KAGC;WACD,SAAS,GAAG,UAAU,WAC7B,YAAY,WAAoB,GAAG,IACnC,SAAS,oBAAoB,OAC1B,OAAO,OAAO,eAAe,IAAI;;;;;;;;;;;;;;cAc3B,sBAAsB;;cAKtB,SAAU,GAAG,UAAU,WAAkB,YACxC,WAAoB,GAAG,IAAE,SAC5B,oBAAoB,OAC5B,OAAO,OAAO,eAAe,IAAI,SAAiB"}

package/dist/decision-model/DecisionModel.mjs

@@ -0,0 +1,25 @@
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
+import { Context, Effect } from "effect";
+//#region src/decision-model/DecisionModel.ts
+var DecisionModel_exports = /* @__PURE__ */ __exportAll({
+	DecisionModel: () => DecisionModel,
+	decide: () => decide
+});
+/**
+* Answering typed questions about an input with probabilities instead of
+* generating text. The model reports beliefs; the decision stays in the
+* caller's code.
+*
+* Implementor contract: answer every decision or fail. Omitting one leaves a
+* hole where {@link DecideResponse} promises a key, so a kind the backing
+* cannot express is rejected up front with `Decision.assertKinds`.
+*
+* @experimental The model class this abstracts is new and the shape may change.
+*/
+var DecisionModel = class extends Context.Service()("@betalyra/effect-uai/DecisionModel") {};
+/** Answer a definition's decisions about one input in one call. */
+const decide = (definition, request) => Effect.flatMap(DecisionModel, (m) => m.decide(definition, request));
+//#endregion
+export { DecisionModel, decide, DecisionModel_exports as t };
+
+//# sourceMappingURL=DecisionModel.mjs.map

package/dist/decision-model/DecisionModel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionModel.mjs","names":[],"sources":["../../src/decision-model/DecisionModel.ts"],"sourcesContent":["import { Context, Effect } from \"effect\"\nimport type * as AiError from \"../domain/AiError.js\"\nimport type * as Decision from \"./Decision.js\"\n\n/** Optional throughout: not every backing reports token counts. */\nexport type DecideUsage = {\n  readonly inputTokens?: number\n  readonly outputTokens?: number\n}\n\nexport type DecideResponse<D extends Decision.Decisions = Decision.Decisions> = {\n  readonly answers: Decision.Answers<D>\n  readonly usage: DecideUsage\n}\n\n/**\n * Cross-provider decide request. The input is billed once for the whole\n * definition, so batching decisions is cheaper than repeating the input.\n */\nexport type CommonDecideRequest<A> = {\n  readonly input: A\n  /** Each provider narrows this to its typed literal union. */\n  readonly model: string\n}\n\nexport type DecisionModelService = {\n  readonly decide: <A, D extends Decision.Decisions>(\n    definition: Decision.Definition<A, D>,\n    request: CommonDecideRequest<A>,\n  ) => Effect.Effect<DecideResponse<D>, AiError.AiError>\n}\n\n/**\n * Answering typed questions about an input with probabilities instead of\n * generating text. The model reports beliefs; the decision stays in the\n * caller's code.\n *\n * Implementor contract: answer every decision or fail. Omitting one leaves a\n * hole where {@link DecideResponse} promises a key, so a kind the backing\n * cannot express is rejected up front with `Decision.assertKinds`.\n *\n * @experimental The model class this abstracts is new and the shape may change.\n */\nexport class DecisionModel extends Context.Service<DecisionModel, DecisionModelService>()(\n  \"@betalyra/effect-uai/DecisionModel\",\n) {}\n\n/** Answer a definition's decisions about one input in one call. */\nexport const decide = <A, D extends Decision.Decisions>(\n  definition: Decision.Definition<A, D>,\n  request: CommonDecideRequest<A>,\n): Effect.Effect<DecideResponse<D>, AiError.AiError, DecisionModel> =>\n  Effect.flatMap(DecisionModel, (m) => m.decide(definition, request))\n"],"mappings":";;;;;;;;;;;;;;;;;;AA2CA,IAAa,gBAAb,cAAmC,QAAQ,QAA6C,CAAC,CACvF,oCACF,CAAC,CAAC,CAAC;;AAGH,MAAa,UACX,YACA,YAEA,OAAO,QAAQ,gBAAgB,MAAM,EAAE,OAAO,YAAY,OAAO,CAAC"}

package/dist/domain/AiError.d.mts

@@ -1,2 +1,2 @@
-import { a as Cancelled, c as GenerationFailed, d as RateLimited, f as Scope, g as describe, h as Unsupported, i as AuthSubtype, l as IncompleteTurn, m as Unavailable, o as ContentFiltered, p as Timeout, r as AuthFailed, s as ContextLengthExceeded, t as AiError, u as InvalidRequest } from "../AiError-eLV9t1lU.mjs";
-export { AiError, AuthFailed, AuthSubtype, Cancelled, ContentFiltered, ContextLengthExceeded, GenerationFailed, IncompleteTurn, InvalidRequest, RateLimited, Scope, Timeout, Unavailable, Unsupported, describe };
+import { _ as describe, a as Cancelled, c as GenerationFailed, d as RateLimited, f as Scope, g as Unsupported, h as Unavailable, i as AuthSubtype, l as IncompleteTurn, m as Timeout, o as ContentFiltered, p as SessionExpired, r as AuthFailed, s as ContextLengthExceeded, t as AiError, u as InvalidRequest } from "../AiError-DvhLIbmd.mjs";
+export { AiError, AuthFailed, AuthSubtype, Cancelled, ContentFiltered, ContextLengthExceeded, GenerationFailed, IncompleteTurn, InvalidRequest, RateLimited, Scope, SessionExpired, Timeout, Unavailable, Unsupported, describe };

package/dist/domain/AiError.mjs

@@ -10,6 +10,7 @@ var AiError_exports = /* @__PURE__ */ __exportAll({
 	IncompleteTurn: () => IncompleteTurn,
 	InvalidRequest: () => InvalidRequest,
 	RateLimited: () => RateLimited,
+	SessionExpired: () => SessionExpired,
 	Timeout: () => Timeout,
 	Unavailable: () => Unavailable,
 	Unsupported: () => Unsupported,
@@ -51,6 +52,11 @@ var IncompleteTurn = class extends Data.TaggedError("IncompleteTurn") {};
 * (`TtsIncrementalText`, `SttStreaming`) on the R channel instead.
 */
 var Unsupported = class extends Data.TaggedError("Unsupported") {};
+/**
+* A long-lived session hit the provider's lifetime cap. Distinct from
+* `Unavailable`: reconnecting works, retrying the same session does not.
+*/
+var SessionExpired = class extends Data.TaggedError("SessionExpired") {};
 const withReason = (base, reason) => reason === void 0 ? base : `${base}: ${reason}`;
 /**
 * Short human-readable description of an error, for logs and model-facing
@@ -67,9 +73,10 @@ const describe = Match.type().pipe(Match.discriminatorsExhaustive("_tag")({
 	Cancelled: (e) => `the ${e.provider} request was cancelled`,
 	IncompleteTurn: () => "the provider stream ended without completing",
 	GenerationFailed: (e) => e.message ?? `${e.provider} failed mid-generation`,
-	Unsupported: (e) => withReason(`${e.provider} does not support ${e.capability}`, e.reason)
+	Unsupported: (e) => withReason(`${e.provider} does not support ${e.capability}`, e.reason),
+	SessionExpired: (e) => `the ${e.provider} session reached its lifetime limit`
 }));
 //#endregion
-export { AuthFailed, Cancelled, ContentFiltered, ContextLengthExceeded, GenerationFailed, IncompleteTurn, InvalidRequest, RateLimited, Timeout, Unavailable, Unsupported, describe, AiError_exports as t };
+export { AuthFailed, Cancelled, ContentFiltered, ContextLengthExceeded, GenerationFailed, IncompleteTurn, InvalidRequest, RateLimited, SessionExpired, Timeout, Unavailable, Unsupported, describe, AiError_exports as t };
 
 //# sourceMappingURL=AiError.mjs.map

package/dist/domain/AiError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AiError.mjs","names":[],"sources":["../../src/domain/AiError.ts"],"sourcesContent":["import { Data, Duration, Match } from \"effect\"\n\nexport type Scope = \"rpm\" | \"tpm\" | \"rpd\" | \"tpd\"\n\nexport class RateLimited extends Data.TaggedError(\"RateLimited\")<{\n  provider: string\n  retryAfter?: Duration.Duration\n  scope?: Scope\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class Unavailable extends Data.TaggedError(\"Unavailable\")<{\n  provider: string\n  retryAfter?: Duration.Duration\n  status?: number\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class Timeout extends Data.TaggedError(\"Timeout\")<{\n  provider: string\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class ContentFiltered extends Data.TaggedError(\"ContentFiltered\")<{\n  provider: string\n  reason?: string\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class ContextLengthExceeded extends Data.TaggedError(\"ContextLengthExceeded\")<{\n  provider: string\n  modelLimit?: number\n  requested?: number\n  raw: unknown\n}> {}\n\nexport class InvalidRequest extends Data.TaggedError(\"InvalidRequest\")<{\n  provider: string\n  param?: string\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport type AuthSubtype = \"auth\" | \"permission\" | \"billing\" | \"quota\"\n\nexport class AuthFailed extends Data.TaggedError(\"AuthFailed\")<{\n  provider: string\n  subtype: AuthSubtype\n  raw: unknown\n}> {}\n\nexport class Cancelled extends Data.TaggedError(\"Cancelled\")<{\n  provider: string\n}> {}\n\n/**\n * The model errored mid-generation. Distinct from `Unavailable` (transport\n * problem before generation started) and from `IncompleteTurn` (provider\n * stream ended without a terminal event). The provider's own error message,\n * if any, is on `message`.\n */\nexport class GenerationFailed extends Data.TaggedError(\"GenerationFailed\")<{\n  provider: string\n  code?: string\n  message?: string\n  requestId?: string\n  raw: unknown\n}> {}\n\n/**\n * The provider's delta stream ended without a terminal `TurnComplete`.\n * Indicates a misbehaving provider or a connection that dropped mid-flight.\n * Non-terminal deltas seen so far have already been emitted downstream.\n */\nexport class IncompleteTurn extends Data.TaggedError(\"IncompleteTurn\")<{\n  raw?: unknown\n}> {}\n\n/**\n * The provider does not implement the requested capability for this\n * specific request. Distinct from `InvalidRequest` (the request shape is\n * malformed) and `AuthFailed` (the request was rejected).\n *\n * Reserved for request-data-dependent gaps where the provider supports\n * the method in general but not for these inputs — e.g. Google's\n * `streamSynthesisFrom` works only for Chirp 3 HD voices; calling it\n * with a Neural2 voice ID fails `Unsupported`.\n *\n * Blanket provider-level gaps (e.g. OpenAI has no incremental-text-in\n * TTS at all) are gated at compile time via capability marker tags\n * (`TtsIncrementalText`, `SttStreaming`) on the R channel instead.\n */\nexport class Unsupported extends Data.TaggedError(\"Unsupported\")<{\n  provider: string\n  capability: string\n  reason?: string\n}> {}\n\nexport type AiError =\n  | RateLimited\n  | Unavailable\n  | Timeout\n  | ContentFiltered\n  | ContextLengthExceeded\n  | InvalidRequest\n  | AuthFailed\n  | Cancelled\n  | IncompleteTurn\n  | GenerationFailed\n  | Unsupported\n\nconst withReason = (base: string, reason: string | undefined): string =>\n  reason === undefined ? base : `${base}: ${reason}`\n\n/**\n * Short human-readable description of an error, for logs and model-facing\n * failure messages. Prose, not a contract; branch on `_tag` instead.\n */\nexport const describe: (e: AiError) => string = Match.type<AiError>().pipe(\n  Match.discriminatorsExhaustive(\"_tag\")({\n    RateLimited: (e) => `rate limited by ${e.provider}; try again later`,\n    Unavailable: (e) => `${e.provider} is temporarily unavailable`,\n    Timeout: (e) => `the ${e.provider} request timed out`,\n    ContentFiltered: (e) => withReason(`blocked by ${e.provider}'s content filter`, e.reason),\n    ContextLengthExceeded: (e) => `the request exceeded ${e.provider}'s context limit`,\n    InvalidRequest: (e) =>\n      e.param === undefined\n        ? `${e.provider} rejected the request`\n        : `${e.provider} rejected the request (param: ${e.param})`,\n    AuthFailed: (e) => `authentication against ${e.provider} failed (${e.subtype})`,\n    Cancelled: (e) => `the ${e.provider} request was cancelled`,\n    IncompleteTurn: () => \"the provider stream ended without completing\",\n    GenerationFailed: (e) => e.message ?? `${e.provider} failed mid-generation`,\n    Unsupported: (e) => withReason(`${e.provider} does not support ${e.capability}`, e.reason),\n  }),\n)\n"],"mappings":";;;;;;;;;;;;;;;;;AAIA,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAM7D,CAAC;AAEJ,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAM7D,CAAC;AAEJ,IAAa,UAAb,cAA6B,KAAK,YAAY,SAAS,CAAC,CAIrD,CAAC;AAEJ,IAAa,kBAAb,cAAqC,KAAK,YAAY,iBAAiB,CAAC,CAKrE,CAAC;AAEJ,IAAa,wBAAb,cAA2C,KAAK,YAAY,uBAAuB,CAAC,CAKjF,CAAC;AAEJ,IAAa,iBAAb,cAAoC,KAAK,YAAY,gBAAgB,CAAC,CAKnE,CAAC;AAIJ,IAAa,aAAb,cAAgC,KAAK,YAAY,YAAY,CAAC,CAI3D,CAAC;AAEJ,IAAa,YAAb,cAA+B,KAAK,YAAY,WAAW,CAAC,CAEzD,CAAC;;;;;;;AAQJ,IAAa,mBAAb,cAAsC,KAAK,YAAY,kBAAkB,CAAC,CAMvE,CAAC;;;;;;AAOJ,IAAa,iBAAb,cAAoC,KAAK,YAAY,gBAAgB,CAAC,CAEnE,CAAC;;;;;;;;;;;;;;;AAgBJ,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAI7D,CAAC;AAeJ,MAAM,cAAc,MAAc,WAChC,WAAW,KAAA,IAAY,OAAO,GAAG,KAAK,IAAI;;;;;AAM5C,MAAa,WAAmC,MAAM,KAAc,CAAC,CAAC,KACpE,MAAM,yBAAyB,MAAM,CAAC,CAAC;CACrC,cAAc,MAAM,mBAAmB,EAAE,SAAS;CAClD,cAAc,MAAM,GAAG,EAAE,SAAS;CAClC,UAAU,MAAM,OAAO,EAAE,SAAS;CAClC,kBAAkB,MAAM,WAAW,cAAc,EAAE,SAAS,oBAAoB,EAAE,MAAM;CACxF,wBAAwB,MAAM,wBAAwB,EAAE,SAAS;CACjE,iBAAiB,MACf,EAAE,UAAU,KAAA,IACR,GAAG,EAAE,SAAS,yBACd,GAAG,EAAE,SAAS,gCAAgC,EAAE,MAAM;CAC5D,aAAa,MAAM,0BAA0B,EAAE,SAAS,WAAW,EAAE,QAAQ;CAC7E,YAAY,MAAM,OAAO,EAAE,SAAS;CACpC,sBAAsB;CACtB,mBAAmB,MAAM,EAAE,WAAW,GAAG,EAAE,SAAS;CACpD,cAAc,MAAM,WAAW,GAAG,EAAE,SAAS,oBAAoB,EAAE,cAAc,EAAE,MAAM;AAC3F,CAAC,CACH"}
+{"version":3,"file":"AiError.mjs","names":[],"sources":["../../src/domain/AiError.ts"],"sourcesContent":["import { Data, Duration, Match } from \"effect\"\n\nexport type Scope = \"rpm\" | \"tpm\" | \"rpd\" | \"tpd\"\n\nexport class RateLimited extends Data.TaggedError(\"RateLimited\")<{\n  provider: string\n  retryAfter?: Duration.Duration\n  scope?: Scope\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class Unavailable extends Data.TaggedError(\"Unavailable\")<{\n  provider: string\n  retryAfter?: Duration.Duration\n  status?: number\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class Timeout extends Data.TaggedError(\"Timeout\")<{\n  provider: string\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class ContentFiltered extends Data.TaggedError(\"ContentFiltered\")<{\n  provider: string\n  reason?: string\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport class ContextLengthExceeded extends Data.TaggedError(\"ContextLengthExceeded\")<{\n  provider: string\n  modelLimit?: number\n  requested?: number\n  raw: unknown\n}> {}\n\nexport class InvalidRequest extends Data.TaggedError(\"InvalidRequest\")<{\n  provider: string\n  param?: string\n  requestId?: string\n  raw: unknown\n}> {}\n\nexport type AuthSubtype = \"auth\" | \"permission\" | \"billing\" | \"quota\"\n\nexport class AuthFailed extends Data.TaggedError(\"AuthFailed\")<{\n  provider: string\n  subtype: AuthSubtype\n  raw: unknown\n}> {}\n\nexport class Cancelled extends Data.TaggedError(\"Cancelled\")<{\n  provider: string\n}> {}\n\n/**\n * The model errored mid-generation. Distinct from `Unavailable` (transport\n * problem before generation started) and from `IncompleteTurn` (provider\n * stream ended without a terminal event). The provider's own error message,\n * if any, is on `message`.\n */\nexport class GenerationFailed extends Data.TaggedError(\"GenerationFailed\")<{\n  provider: string\n  code?: string\n  message?: string\n  requestId?: string\n  raw: unknown\n}> {}\n\n/**\n * The provider's delta stream ended without a terminal `TurnComplete`.\n * Indicates a misbehaving provider or a connection that dropped mid-flight.\n * Non-terminal deltas seen so far have already been emitted downstream.\n */\nexport class IncompleteTurn extends Data.TaggedError(\"IncompleteTurn\")<{\n  raw?: unknown\n}> {}\n\n/**\n * The provider does not implement the requested capability for this\n * specific request. Distinct from `InvalidRequest` (the request shape is\n * malformed) and `AuthFailed` (the request was rejected).\n *\n * Reserved for request-data-dependent gaps where the provider supports\n * the method in general but not for these inputs — e.g. Google's\n * `streamSynthesisFrom` works only for Chirp 3 HD voices; calling it\n * with a Neural2 voice ID fails `Unsupported`.\n *\n * Blanket provider-level gaps (e.g. OpenAI has no incremental-text-in\n * TTS at all) are gated at compile time via capability marker tags\n * (`TtsIncrementalText`, `SttStreaming`) on the R channel instead.\n */\nexport class Unsupported extends Data.TaggedError(\"Unsupported\")<{\n  provider: string\n  capability: string\n  reason?: string\n}> {}\n\n/**\n * A long-lived session hit the provider's lifetime cap. Distinct from\n * `Unavailable`: reconnecting works, retrying the same session does not.\n */\nexport class SessionExpired extends Data.TaggedError(\"SessionExpired\")<{\n  provider: string\n  raw?: unknown\n}> {}\n\nexport type AiError =\n  | RateLimited\n  | Unavailable\n  | Timeout\n  | ContentFiltered\n  | ContextLengthExceeded\n  | InvalidRequest\n  | AuthFailed\n  | Cancelled\n  | IncompleteTurn\n  | GenerationFailed\n  | Unsupported\n  | SessionExpired\n\nconst withReason = (base: string, reason: string | undefined): string =>\n  reason === undefined ? base : `${base}: ${reason}`\n\n/**\n * Short human-readable description of an error, for logs and model-facing\n * failure messages. Prose, not a contract; branch on `_tag` instead.\n */\nexport const describe: (e: AiError) => string = Match.type<AiError>().pipe(\n  Match.discriminatorsExhaustive(\"_tag\")({\n    RateLimited: (e) => `rate limited by ${e.provider}; try again later`,\n    Unavailable: (e) => `${e.provider} is temporarily unavailable`,\n    Timeout: (e) => `the ${e.provider} request timed out`,\n    ContentFiltered: (e) => withReason(`blocked by ${e.provider}'s content filter`, e.reason),\n    ContextLengthExceeded: (e) => `the request exceeded ${e.provider}'s context limit`,\n    InvalidRequest: (e) =>\n      e.param === undefined\n        ? `${e.provider} rejected the request`\n        : `${e.provider} rejected the request (param: ${e.param})`,\n    AuthFailed: (e) => `authentication against ${e.provider} failed (${e.subtype})`,\n    Cancelled: (e) => `the ${e.provider} request was cancelled`,\n    IncompleteTurn: () => \"the provider stream ended without completing\",\n    GenerationFailed: (e) => e.message ?? `${e.provider} failed mid-generation`,\n    Unsupported: (e) => withReason(`${e.provider} does not support ${e.capability}`, e.reason),\n    SessionExpired: (e) => `the ${e.provider} session reached its lifetime limit`,\n  }),\n)\n"],"mappings":";;;;;;;;;;;;;;;;;;AAIA,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAM7D,CAAC;AAEJ,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAM7D,CAAC;AAEJ,IAAa,UAAb,cAA6B,KAAK,YAAY,SAAS,CAAC,CAIrD,CAAC;AAEJ,IAAa,kBAAb,cAAqC,KAAK,YAAY,iBAAiB,CAAC,CAKrE,CAAC;AAEJ,IAAa,wBAAb,cAA2C,KAAK,YAAY,uBAAuB,CAAC,CAKjF,CAAC;AAEJ,IAAa,iBAAb,cAAoC,KAAK,YAAY,gBAAgB,CAAC,CAKnE,CAAC;AAIJ,IAAa,aAAb,cAAgC,KAAK,YAAY,YAAY,CAAC,CAI3D,CAAC;AAEJ,IAAa,YAAb,cAA+B,KAAK,YAAY,WAAW,CAAC,CAEzD,CAAC;;;;;;;AAQJ,IAAa,mBAAb,cAAsC,KAAK,YAAY,kBAAkB,CAAC,CAMvE,CAAC;;;;;;AAOJ,IAAa,iBAAb,cAAoC,KAAK,YAAY,gBAAgB,CAAC,CAEnE,CAAC;;;;;;;;;;;;;;;AAgBJ,IAAa,cAAb,cAAiC,KAAK,YAAY,aAAa,CAAC,CAI7D,CAAC;;;;;AAMJ,IAAa,iBAAb,cAAoC,KAAK,YAAY,gBAAgB,CAAC,CAGnE,CAAC;AAgBJ,MAAM,cAAc,MAAc,WAChC,WAAW,KAAA,IAAY,OAAO,GAAG,KAAK,IAAI;;;;;AAM5C,MAAa,WAAmC,MAAM,KAAc,CAAC,CAAC,KACpE,MAAM,yBAAyB,MAAM,CAAC,CAAC;CACrC,cAAc,MAAM,mBAAmB,EAAE,SAAS;CAClD,cAAc,MAAM,GAAG,EAAE,SAAS;CAClC,UAAU,MAAM,OAAO,EAAE,SAAS;CAClC,kBAAkB,MAAM,WAAW,cAAc,EAAE,SAAS,oBAAoB,EAAE,MAAM;CACxF,wBAAwB,MAAM,wBAAwB,EAAE,SAAS;CACjE,iBAAiB,MACf,EAAE,UAAU,KAAA,IACR,GAAG,EAAE,SAAS,yBACd,GAAG,EAAE,SAAS,gCAAgC,EAAE,MAAM;CAC5D,aAAa,MAAM,0BAA0B,EAAE,SAAS,WAAW,EAAE,QAAQ;CAC7E,YAAY,MAAM,OAAO,EAAE,SAAS;CACpC,sBAAsB;CACtB,mBAAmB,MAAM,EAAE,WAAW,GAAG,EAAE,SAAS;CACpD,cAAc,MAAM,WAAW,GAAG,EAAE,SAAS,oBAAoB,EAAE,cAAc,EAAE,MAAM;CACzF,iBAAiB,MAAM,OAAO,EAAE,SAAS;AAC3C,CAAC,CACH"}