@turingfocus/chat-protocol 0.8.0 → 0.8.1

package/dist/resources.d.ts

@@ -17,4 +17,18 @@ export interface ChatResourcePort {
     open?(request: ChatResourceRequest): MaybePromise<void>;
     download?(request: ChatResourceRequest): MaybePromise<void>;
 }
+/** Safe resource outcomes; host diagnostics must never be included in UI state. */
+export type ChatResourceErrorCode = "unauthorized" | "network" | "not-found" | "expired" | "unsupported" | "cancelled" | "unknown";
+export interface ChatResourceFailure {
+    readonly code: ChatResourceErrorCode;
+    /** Explicit retry is useful; this never requests automatic retries. */
+    readonly retryable: boolean;
+}
+/** Hosts may throw this error or reject with an object carrying a supported code. */
+export declare class ChatResourceError extends Error {
+    readonly code: ChatResourceErrorCode;
+    constructor(code: ChatResourceErrorCode);
+}
+/** Whitelist only stable codes, discarding messages, causes, URLs and stacks. */
+export declare function normalizeChatResourceError(error: unknown): ChatResourceFailure;
 //# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAClE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CAC7D"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAClE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAC3E,IAAI,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,mFAAmF;AACnF,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,SAAS,GACT,WAAW,GACX,SAAS,GACT,aAAa,GACb,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,qFAAqF;AACrF,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,IAAI,EAAE,qBAAqB;gBAA3B,IAAI,EAAE,qBAAqB;CAIjD;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,mBAAmB,CA0BrB"}

package/dist/resources.js

@@ -1,2 +1,39 @@
-export {};
+/** Hosts may throw this error or reject with an object carrying a supported code. */
+export class ChatResourceError extends Error {
+    code;
+    constructor(code) {
+        super("Chat resource operation did not complete.");
+        this.code = code;
+        this.name = "ChatResourceError";
+    }
+}
+/** Whitelist only stable codes, discarding messages, causes, URLs and stacks. */
+export function normalizeChatResourceError(error) {
+    let code = "unknown";
+    try {
+        if (typeof error === "object" && error !== null) {
+            if ("code" in error) {
+                const candidate = error.code;
+                switch (candidate) {
+                    case "unauthorized":
+                    case "network":
+                    case "not-found":
+                    case "expired":
+                    case "unsupported":
+                    case "cancelled":
+                        code = candidate;
+                }
+            }
+            if (code === "unknown" && "name" in error && error.name === "AbortError")
+                code = "cancelled";
+        }
+    }
+    catch {
+        // Even malformed host errors must have a safe fallback.
+    }
+    return {
+        code,
+        retryable: ["unauthorized", "network", "expired", "unknown"].includes(code),
+    };
+}
 //# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAqCA,qFAAqF;AACrF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACrB;IAArB,YAAqB,IAA2B;QAC9C,KAAK,CAAC,2CAA2C,CAAC,CAAC;QADhC,SAAI,GAAJ,IAAI,CAAuB;QAE9C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,IAAI,IAAI,GAA0B,SAAS,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;gBACpB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;gBAC7B,QAAQ,SAAS,EAAE,CAAC;oBAClB,KAAK,cAAc,CAAC;oBACpB,KAAK,SAAS,CAAC;oBACf,KAAK,WAAW,CAAC;oBACjB,KAAK,SAAS,CAAC;oBACf,KAAK,aAAa,CAAC;oBACnB,KAAK,WAAW;wBACd,IAAI,GAAG,SAAS,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;gBACtE,IAAI,GAAG,WAAW,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;IACD,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;KAC5E,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turingfocus/chat-protocol",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Host-agnostic chat models, validation contracts, and gateway ports",
   "license": "MIT",
   "repository": {