@holokai/sdk 0.1.0

package/dist/provider/wire/base.js

@@ -0,0 +1,99 @@
+import { ClassLogger, pickDefined } from '../../core/index';
+export class BaseWireAdapter extends ClassLogger {
+    requestId;
+    isStreaming;
+    wireSeq = 0;
+    constructor(requestId, isStreaming) {
+        super();
+        this.requestId = requestId;
+        this.isStreaming = isStreaming;
+    }
+    fromProviderEvent(ev) {
+        if (!this.isStreaming)
+            return this.fromNonStreaming(ev);
+        return this.fromStreaming(ev);
+    }
+    // --- defaults ---
+    nonStreamingHeaders() {
+        return { 'Content-Type': 'application/json' };
+    }
+    streamingHeaders() {
+        return {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        };
+    }
+    defaultHeadersForFirst(ev) {
+        return (ev.type === 'error' || !this.isStreaming) ? this.nonStreamingHeaders() : this.streamingHeaders();
+    }
+    stringifyResponse(err) {
+        return typeof err === 'string' ? err : JSON.stringify(err);
+    }
+    chunkify(response, ev, done, override) {
+        const isFirst = this.wireSeq == 0;
+        const seq = this.wireSeq++;
+        const body = response === undefined ? '' :
+            ev.type === 'error' || ev.type === 'done' ? this.stringifyResponse(response) : this.formatWire(response);
+        const chunk = pickDefined({
+            requestId: this.requestId,
+            seq,
+            eventSeq: ev.seq,
+            body,
+            done,
+        });
+        if (isFirst) {
+            const status = override?.status ?? (ev.type === 'error' ? (ev.status ?? 400) : 200);
+            const headers = override?.headers ??
+                (ev.type === 'error' && ev.headers ? ev.headers : undefined) ?? this.defaultHeadersForFirst(ev);
+            chunk.status = status;
+            chunk.headers = headers;
+        }
+        else {
+            // generally do NOT send headers/status after first chunk; allow explicit override if needed
+            if (override?.status !== undefined)
+                chunk.status = override.status;
+            if (override?.headers)
+                chunk.headers = override.headers;
+        }
+        return chunk;
+    }
+    // --- non-streaming ---
+    fromNonStreaming(ev) {
+        if (ev.type === 'done') {
+            return [this.chunkify(ev.message, ev, true)];
+        }
+        if (ev.type === 'error') {
+            return [this.chunkify(ev.error, ev, true, pickDefined({ status: ev.status ?? 400, headers: ev.headers }))];
+        }
+        return [];
+    }
+    // --- streaming ---
+    fromStreaming(ev) {
+        switch (ev.type) {
+            case 'stream_event':
+                return this.onStreamEvent(ev);
+            case 'done':
+                return this.onDoneStreaming(ev);
+            case 'error':
+                return this.onErrorStreaming(ev);
+            case 'text_delta':
+            default:
+                return [];
+        }
+    }
+    onStreamEvent(ev) {
+        return [this.chunkify(ev.event, ev)];
+    }
+    onDoneStreaming(ev) {
+        return [this.chunkify(ev.text, ev, true)];
+    }
+    onErrorStreaming(ev) {
+        if (this.wireSeq === 0) {
+            return this.fromNonStreaming(ev);
+        }
+        // Mid-stream: default behavior (provider adapters should usually override)
+        return [this.chunkify(ev.error, ev, true)];
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/provider/wire/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/provider/wire/base.ts"],"names":[],"mappings":"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"}

package/dist/provider/wire/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/wire/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/provider/wire/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/provider/wire/index.js

@@ -0,0 +1,2 @@
+export * from './base';
+//# sourceMappingURL=index.js.map

package/dist/provider/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/provider/wire/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@holokai/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Common SDK for Holo plugin system - contracts, types, and validators",
+  "author": "Holokai",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/holokai/holo-plugin-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/holokai/holo-plugin-sdk/issues"
+  },
+  "homepage": "https://github.com/holokai/holo-plugin-sdk#readme",
+  "keywords": [
+    "holokai",
+    "holo",
+    "plugin",
+    "sdk",
+    "ai",
+    "llm"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js",
+      "require": "./dist/plugin/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider/index.d.ts",
+      "import": "./dist/provider/index.js",
+      "require": "./dist/provider/index.js"
+    },
+    "./holo": {
+      "types": "./dist/holo/index.d.ts",
+      "import": "./dist/holo/index.js",
+      "require": "./dist/holo/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.js"
+    },
+    "./core/entities": {
+      "types": "./dist/core/entities/index.d.ts",
+      "import": "./dist/core/entities/index.js",
+      "require": "./dist/core/entities/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc --build",
+    "build:watch": "tsc --build --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "express": "^4.21.0",
+    "tsyringe": "^4.10.0",
+    "winston": "^3.18.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "typescript": "^5.0.0"
+  }
+}