@sayknow-cli/bridge-client 0.3.16 → 0.4.2

package/README.md

@@ -0,0 +1,29 @@
+# @sayknow-cli/bridge-client
+
+`@sayknow-cli/bridge-client` is the standalone SDK v3 WebSocket transport client for Sayknow-CLI. It exports `SdkClient`, `SdkClientError`, and the associated frame, request, reconnect, and options types.
+
+```ts
+import { SdkClient } from "@sayknow-cli/bridge-client";
+
+const client = await SdkClient.connect(endpoint.url, endpoint.token);
+try {
+	const metadata = await client.query("session.metadata");
+	console.log(metadata);
+} finally {
+	await client.close();
+}
+```
+
+## Transport contract
+
+The client adds the endpoint token as a WebSocket query parameter, waits for a server `hello` frame before requests are sent, and correlates responses by request ID. A server error response rejects with `SdkClientError`, whose `code`, `message`, and `details` preserve the wire error. It bounds open, hello, retry, and request work with the configured timeout and optional absolute deadline.
+
+A request that has been sent is never replayed after reconnect. Callers that need retry semantics must decide whether retrying their operation is safe and provide their own idempotency protocol where appropriate.
+
+## Scope and compatibility
+
+This package is transport-only. It does not import, instantiate, dispatch to, or otherwise own `AgentSession`, broker lifecycle, backend process management, or application operation handlers.
+
+It is SDK v3 only. The historical BridgeClient/backend-bridge protocol, RPC ingress, and compatibility behavior are intentionally unsupported and must not be restored. Use the documented SDK v3 WebSocket endpoint and frames instead.
+
+`@sayknow-cli/coding-agent/sdk` re-exports this package for compatibility; both entrypoints expose the same `SdkClient` class identity.

package/package.json

@@ -1,10 +1,10 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/bridge-client",
-	"version": "0.3.16",
-	"description": "TypeScript client SDK for the SKC backend bridge protocol",
+	"version": "0.4.2",
+	"description": "Transport-only v3 SDK WebSocket client",
 	"homepage": "https://sayknow-cli.com",
-	"author": "jaybeyond",
+	"author": "jaybeyond and Sayknow-CLI Contributors",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
@@ -15,12 +15,13 @@
 		"url": "https://github.com/jaybeyond/Sayknow_CLI/issues"
 	},
 	"keywords": [
-		"skc",
-		"bridge",
-		"sdk"
+		"sdk",
+		"websocket",
+		"transport",
+		"client"
 	],
 	"main": "./src/index.ts",
-	"types": "./dist/types/index.d.ts",
+	"types": "./src/index.ts",
 	"scripts": {
 		"check": "biome check . && bun run check:types",
 		"check:types": "tsc -p tsconfig.json --noEmit",
@@ -36,17 +37,12 @@
 		"bun": ">=1.3.14"
 	},
 	"files": [
-		"src",
-		"dist/types"
+		"src"
 	],
 	"exports": {
 		".": {
-			"types": "./dist/types/index.d.ts",
+			"types": "./src/index.ts",
 			"import": "./src/index.ts"
-		},
-		"./*": {
-			"types": "./dist/types/*.d.ts",
-			"import": "./src/*.ts"
 		}
 	}
 }