@flowy-agent-store/protocol 0.1.0-beta.2

package/dist/index.mjs

@@ -0,0 +1,80 @@
+//#region src/protocol.ts
+/**
+* Agent Store App Server Protocol types.
+*
+* The chat surface uses only opaque public conversation/message IDs. Internal
+* execution/session/step/attempt IDs never appear in this module.
+*/
+const APP_SERVER_PROTOCOL_VERSION = "2026-08-26";
+//#endregion
+//#region src/errors.ts
+var AppServerError = class extends Error {
+	code;
+	requestId;
+	retryable;
+	details;
+	constructor(wire) {
+		super(wire.message);
+		this.name = "AppServerError";
+		this.code = wire.code;
+		this.requestId = wire.request_id;
+		this.retryable = wire.retryable;
+		this.details = wire.details ?? {};
+	}
+};
+var TransportError = class extends Error {
+	phase;
+	retryable;
+	cause;
+	constructor(phase, message, options) {
+		super(message);
+		this.name = "TransportError";
+		this.phase = phase;
+		this.retryable = options?.retryable ?? false;
+		this.cause = options?.cause;
+	}
+};
+var ProtocolError = class extends Error {
+	kind;
+	constructor(kind, message) {
+		super(message);
+		this.name = "ProtocolError";
+		this.kind = kind;
+	}
+};
+var RequestTimeoutError = class extends Error {
+	method;
+	timeoutMs;
+	constructor(method, timeoutMs) {
+		super(`app-server request timed out after ${timeoutMs}ms: ${method}`);
+		this.name = "RequestTimeoutError";
+		this.method = method;
+		this.timeoutMs = timeoutMs;
+	}
+};
+function isAppServerError(error) {
+	return error instanceof AppServerError;
+}
+function isRetryableTransportError(error) {
+	return error instanceof TransportError && error.retryable;
+}
+/**
+* Single human-readable rendering of a caught error.
+*
+* Every UI surface shares this one: a bare `Error` contributes only its
+* message, while a protocol error contributes its stable `code` plus the
+* server's retry hint. Components must not grow their own variants — a
+* second spelling means the two drift apart on the retry hint.
+*/
+function formatError(error) {
+	if (error instanceof AppServerError) return `${error.code}: ${error.message}`;
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+/** Whether the caught error is retryable — used by UI surfaces to append a
+*  localized "（可重试）" hint without baking wording into this lib. */
+function isRetryableError(error) {
+	return (error instanceof AppServerError || error instanceof TransportError) && error.retryable;
+}
+//#endregion
+export { APP_SERVER_PROTOCOL_VERSION, AppServerError, ProtocolError, RequestTimeoutError, TransportError, formatError, isAppServerError, isRetryableError, isRetryableTransportError };

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@flowy-agent-store/protocol",
+  "version": "0.1.0-beta.2",
+  "description": "Versioned App Server Protocol types and wire errors (no runtime, no DOM/Node deps)",
+  "type": "module",
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "tsdown"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts"
+}