@kweaver-ai/kweaver-sdk 0.4.0

package/dist/utils/http.d.ts

@@ -0,0 +1,17 @@
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: string;
+    constructor(status: number, statusText: string, body: string);
+}
+export declare class NetworkRequestError extends Error {
+    readonly method: string;
+    readonly url: string;
+    readonly causeMessage: string;
+    readonly hint: string;
+    constructor(method: string, url: string, causeMessage: string, hint: string);
+}
+export declare function fetchTextOrThrow(input: RequestInfo | URL, init?: RequestInit): Promise<{
+    response: Response;
+    body: string;
+}>;

package/dist/utils/http.js

@@ -0,0 +1,72 @@
+export class HttpError extends Error {
+    status;
+    statusText;
+    body;
+    constructor(status, statusText, body) {
+        super(`HTTP ${status} ${statusText}`);
+        this.name = "HttpError";
+        this.status = status;
+        this.statusText = statusText;
+        this.body = body;
+    }
+}
+export class NetworkRequestError extends Error {
+    method;
+    url;
+    causeMessage;
+    hint;
+    constructor(method, url, causeMessage, hint) {
+        super(`Network request failed`);
+        this.name = "NetworkRequestError";
+        this.method = method;
+        this.url = url;
+        this.causeMessage = causeMessage;
+        this.hint = hint;
+    }
+}
+function buildNetworkHint(causeMessage) {
+    const normalized = causeMessage.toLowerCase();
+    if (normalized.includes("enotfound") ||
+        normalized.includes("eai_again") ||
+        normalized.includes("getaddrinfo")) {
+        return "DNS lookup failed. Check whether the domain is correct and reachable from your network.";
+    }
+    if (normalized.includes("certificate") ||
+        normalized.includes("self signed") ||
+        normalized.includes("hostname") ||
+        normalized.includes("tls")) {
+        return "TLS handshake failed. Check the HTTPS certificate and whether the host supports this domain.";
+    }
+    if (normalized.includes("econnrefused") ||
+        normalized.includes("econnreset") ||
+        normalized.includes("socket") ||
+        normalized.includes("network is unreachable")) {
+        return "The host could not be reached. Check connectivity, firewall rules, and whether the service is listening.";
+    }
+    return "Check whether the platform URL is correct and whether it exposes /oauth2/clients over HTTPS.";
+}
+export async function fetchTextOrThrow(input, init) {
+    let response;
+    try {
+        response = await fetch(input, init);
+    }
+    catch (error) {
+        const url = typeof input === "string"
+            ? input
+            : input instanceof URL
+                ? input.toString()
+                : input.url;
+        const causeMessage = error instanceof Error && "cause" in error && error.cause instanceof Error
+            ? error.cause.message
+            : error instanceof Error
+                ? error.message
+                : String(error);
+        const method = init?.method ?? "GET";
+        throw new NetworkRequestError(method, url, causeMessage, buildNetworkHint(causeMessage));
+    }
+    const body = await response.text();
+    if (!response.ok) {
+        throw new HttpError(response.status, response.statusText, body);
+    }
+    return { response, body };
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@kweaver-ai/kweaver-sdk",
+  "version": "0.4.0",
+  "description": "KWeaver TypeScript SDK — CLI tool and programmatic API for knowledge networks and Decision Agents.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./kweaver": {
+      "import": "./dist/kweaver.js",
+      "types": "./dist/kweaver.d.ts"
+    }
+  },
+  "bin": {
+    "kweaver": "bin/kweaver.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/cli.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node ./dist/cli.js",
+    "lint": "tsc --noEmit -p tsconfig.json",
+    "test": "node --import tsx --test test/**/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "typescript",
+    "kweaver"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kweaver-ai/kweaver-sdk.git"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "@types/react": "^19.2.14",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "ink": "^6.8.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^11.2.0",
+    "react": "^19.2.4"
+  }
+}