@fungi.computer/mule 0.2.1 → 0.2.2

package/README.md

@@ -12,10 +12,10 @@ npm install @fungi.computer/mule
 ```
 
 The package ships ESM only and depends on `effect` and Pi
-(`@earendil-works/pi-ai`) at runtime, plus `@fungi.computer/cairn` for IDs. Mule
-does not require or install the MCP SDK. Consumers that type-check dependency
-declarations (`skipLibCheck: false`) must install Pi’s Google GenAI optional
-declaration dependency themselves:
+(`@earendil-works/pi-ai`) at runtime, plus TypeBox and `@fungi.computer/cairn`
+for IDs. Mule does not require or install the MCP SDK. Consumers that type-check
+dependency declarations (`skipLibCheck: false`) must install Pi’s Google GenAI
+optional declaration dependency themselves:
 
 ```sh
 npm install --save-dev @modelcontextprotocol/sdk

package/dist/provider-status.js

@@ -11,6 +11,12 @@ const decodeFailedEvent = Schema.decodeUnknownOption(Schema.Struct({
     response: providerError,
 }));
 const decodeErrorReply = Schema.decodeUnknownOption(Schema.fromJsonString(providerError));
+const decodeErrorEvent = Schema.decodeUnknownOption(Schema.Struct({
+    type: Schema.Literal("error"),
+    status: Schema.optional(Schema.Number.check(Schema.isInt(), Schema.isBetween({ minimum: 100, maximum: 599 }))),
+    code: Schema.optional(Schema.String),
+    error: Schema.optional(providerError.fields.error),
+}));
 const decodeBodyChunk = Schema.decodeUnknownSync(Schema.instanceOf(Uint8Array));
 const errorBodyBytes = 16 * 1024;
 const decodeSeconds = Schema.decodeUnknownOption(Schema.NumberFromString.check(Schema.isBetween({ minimum: 0, maximum: 60 })));
@@ -24,7 +30,9 @@ const decodeLimit = Schema.decodeUnknownOption(Schema.Literals([
 const decodeRejected = Schema.decodeUnknownOption(Schema.Literal("rejected"));
 const decodeExhausted = Schema.decodeUnknownOption(Schema.Literal("0"));
 const decodeDate = Schema.decodeUnknownOption(Schema.DateTimeUtcFromString);
-const decodeOverloaded = Schema.decodeUnknownOption(Schema.Struct({
+const decodeOverloaded = Schema.decodeUnknownOption(
+// https://docs.anthropic.com/en/api/errors#http-errors
+Schema.Struct({
     type: Schema.Literal("error"),
     error: Schema.Struct({ type: Schema.Literal("overloaded_error") }),
 }));
@@ -171,6 +179,22 @@ export function observeProviderStatus(options) {
             if (Option.isSome(failed) &&
                 failed.value.response.error.code === usageLimitCode)
                 rejection = { code: "usage-limit-reached" };
+            // OpenAI's Responses error code, not an inference from overload prose:
+            // https://platform.openai.com/docs/api-reference/responses/object#responses/object-error
+            if (Option.isSome(failed) &&
+                failed.value.response.error.code === "server_error")
+                rejection = { code: "provider_unavailable" };
+            // WebSocket API errors retain HTTP status in the parsed event:
+            // https://developers.openai.com/api/docs/guides/websocket-mode/#handling-errors
+            const error = decodeErrorEvent(data);
+            if (Option.isSome(error)) {
+                const status = error.value.status;
+                if (status !== undefined && status >= 500)
+                    rejection = { code: "provider_unavailable", status };
+                else if (status === undefined &&
+                    (error.value.code ?? error.value.error?.code) === "server_error")
+                    rejection = { code: "provider_unavailable" };
+            }
             if (Option.isSome(decodeOverloaded(data)))
                 rejection = { code: "overloaded" };
             await options?.onProviderStreamEvent?.(data, model);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/mule",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Effect-native Pi model and tool loop",
   "type": "module",