@vincemakes/kiso-core 0.39.0 → 0.39.1

package/dist/errors.d.ts

@@ -13,3 +13,26 @@ import type { StructuredError } from "./protocol/events.js";
  *  rather than retrying early. */
 export declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
 export declare function mapApiError(status: number | undefined, message: string, retryAfterMs?: number): StructuredError;
+/**
+ * A failure that reached us AFTER the response headers did.
+ *
+ * Once a 2xx and the headers are in, the request has been ACCEPTED: no
+ * later failure is a verdict on whether it was valid, because nothing was
+ * left to validate. What remains is the server or the transport failing
+ * mid-flight — a dead socket, a body cut by an intermediary, an in-band
+ * error frame, a stream that simply ends without the terminal event its
+ * protocol mandates. Every one of those is `network` and RETRYABLE, so
+ * the kernel's mid-stream recovery (ADR-0005: retry lives in the kernel;
+ * F4: void the draft durably, then retry) engages instead of ending the
+ * run on a verdict nobody issued.
+ *
+ * Deliberately broader than what can be proven transient: a permanent
+ * fault misclassified here costs `maxRetries` extra requests (2 by
+ * default) and then ends in the same terminal it would have anyway,
+ * while a transient one misclassified the other way costs the whole
+ * session. The asymmetry is the argument.
+ *
+ * An error the provider states BEFORE the stream keeps its status
+ * mapping — `mapApiError` is untouched and stays the authority there.
+ */
+export declare function streamFailure(message: string): StructuredError;

package/dist/errors.js

@@ -52,3 +52,28 @@ export function mapApiError(status, message, retryAfterMs) {
             return withStatus({ code: "unknown", retryable: false, message });
     }
 }
+/**
+ * A failure that reached us AFTER the response headers did.
+ *
+ * Once a 2xx and the headers are in, the request has been ACCEPTED: no
+ * later failure is a verdict on whether it was valid, because nothing was
+ * left to validate. What remains is the server or the transport failing
+ * mid-flight — a dead socket, a body cut by an intermediary, an in-band
+ * error frame, a stream that simply ends without the terminal event its
+ * protocol mandates. Every one of those is `network` and RETRYABLE, so
+ * the kernel's mid-stream recovery (ADR-0005: retry lives in the kernel;
+ * F4: void the draft durably, then retry) engages instead of ending the
+ * run on a verdict nobody issued.
+ *
+ * Deliberately broader than what can be proven transient: a permanent
+ * fault misclassified here costs `maxRetries` extra requests (2 by
+ * default) and then ends in the same terminal it would have anyway,
+ * while a transient one misclassified the other way costs the whole
+ * session. The asymmetry is the argument.
+ *
+ * An error the provider states BEFORE the stream keeps its status
+ * mapping — `mapApiError` is untouched and stays the authority there.
+ */
+export function streamFailure(message) {
+    return { code: "network", retryable: true, message };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-core",
-	"version": "0.39.0",
+	"version": "0.39.1",
 	"description": "kiso core \u2014 protocol, event log, loop, hooks, modes, permissions, compaction, delivery truth. The 2,000-line kernel at the bottom of the kiso framework.",
 	"type": "module",
 	"license": "MIT",
@@ -33,7 +33,7 @@
 		"openai"
 	],
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.39.0",
+		"@vincemakes/kiso-evals": "0.39.1",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"