@thanh01.pmt/domain-kit 0.6.0 → 0.6.1

package/dist/utils/llmTransportResult.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+// src/utils/llmTransportResult.ts
+function transportResultFrom(provider, model, options) {
+  return {
+    provider,
+    model,
+    framingStripped: !!options?.framingStripped,
+    upstreamError: options?.upstreamError,
+    usage: options?.usage
+  };
+}
+
+exports.transportResultFrom = transportResultFrom;
+//# sourceMappingURL=llmTransportResult.cjs.map
+//# sourceMappingURL=llmTransportResult.cjs.map

package/dist/utils/llmTransportResult.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/llmTransportResult.ts"],"names":[],"mappings":";;;AA8BO,SAAS,mBAAA,CACd,QAAA,EACA,KAAA,EACA,OAAA,EAKoB;AACpB,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,KAAA;AAAA,IACA,eAAA,EAAiB,CAAC,CAAC,OAAA,EAAS,eAAA;AAAA,IAC5B,eAAe,OAAA,EAAS,aAAA;AAAA,IACxB,OAAO,OAAA,EAAS;AAAA,GAClB;AACF","file":"llmTransportResult.cjs","sourcesContent":["/**\n * Single source of truth for ONE LLM response through the kit.\n *\n * Every `LlmClient.chat` return path attaches one of these so downstream\n * code inspects the ACTUAL resolved provider/model and framing flags instead\n * of trusting the static client.model card. This is the contract behind the\n * \"no silent cross-gateway rerouting\" policy: each response carries its own\n * provenance and framing metadata.\n */\nexport interface LlmTransportResult {\n  /** Provider label that actually served this response (e.g. '9router'). */\n  provider: string;\n  /** Exact model string sent to and returned by that provider. */\n  model: string;\n  /** True when the response body was stripped of 9router SSE framing. */\n  framingStripped: boolean;\n  /** When present, the upstream returned an error envelope inside HTTP 200. */\n  upstreamError?: string;\n  /** When present, usage record attached to the response. */\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n    finishReason?: string;\n  };\n}\n\n/**\n * Build the transport result that accompanies a successful chat completion.\n */\nexport function transportResultFrom(\n  provider: string,\n  model: string,\n  options?: {\n    framingStripped?: boolean;\n    upstreamError?: string;\n    usage?: LlmTransportResult['usage'];\n  },\n): LlmTransportResult {\n  return {\n    provider,\n    model,\n    framingStripped: !!options?.framingStripped,\n    upstreamError: options?.upstreamError,\n    usage: options?.usage,\n  };\n}\n"]}

package/dist/utils/llmTransportResult.d.cts

@@ -0,0 +1,36 @@
+/**
+ * Single source of truth for ONE LLM response through the kit.
+ *
+ * Every `LlmClient.chat` return path attaches one of these so downstream
+ * code inspects the ACTUAL resolved provider/model and framing flags instead
+ * of trusting the static client.model card. This is the contract behind the
+ * "no silent cross-gateway rerouting" policy: each response carries its own
+ * provenance and framing metadata.
+ */
+interface LlmTransportResult {
+    /** Provider label that actually served this response (e.g. '9router'). */
+    provider: string;
+    /** Exact model string sent to and returned by that provider. */
+    model: string;
+    /** True when the response body was stripped of 9router SSE framing. */
+    framingStripped: boolean;
+    /** When present, the upstream returned an error envelope inside HTTP 200. */
+    upstreamError?: string;
+    /** When present, usage record attached to the response. */
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        finishReason?: string;
+    };
+}
+/**
+ * Build the transport result that accompanies a successful chat completion.
+ */
+declare function transportResultFrom(provider: string, model: string, options?: {
+    framingStripped?: boolean;
+    upstreamError?: string;
+    usage?: LlmTransportResult['usage'];
+}): LlmTransportResult;
+
+export { type LlmTransportResult, transportResultFrom };

package/dist/utils/llmTransportResult.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Single source of truth for ONE LLM response through the kit.
+ *
+ * Every `LlmClient.chat` return path attaches one of these so downstream
+ * code inspects the ACTUAL resolved provider/model and framing flags instead
+ * of trusting the static client.model card. This is the contract behind the
+ * "no silent cross-gateway rerouting" policy: each response carries its own
+ * provenance and framing metadata.
+ */
+interface LlmTransportResult {
+    /** Provider label that actually served this response (e.g. '9router'). */
+    provider: string;
+    /** Exact model string sent to and returned by that provider. */
+    model: string;
+    /** True when the response body was stripped of 9router SSE framing. */
+    framingStripped: boolean;
+    /** When present, the upstream returned an error envelope inside HTTP 200. */
+    upstreamError?: string;
+    /** When present, usage record attached to the response. */
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        finishReason?: string;
+    };
+}
+/**
+ * Build the transport result that accompanies a successful chat completion.
+ */
+declare function transportResultFrom(provider: string, model: string, options?: {
+    framingStripped?: boolean;
+    upstreamError?: string;
+    usage?: LlmTransportResult['usage'];
+}): LlmTransportResult;
+
+export { type LlmTransportResult, transportResultFrom };

package/dist/utils/llmTransportResult.mjs

@@ -0,0 +1,3 @@
+export { transportResultFrom } from '../chunk-IBVXXVGE.mjs';
+//# sourceMappingURL=llmTransportResult.mjs.map
+//# sourceMappingURL=llmTransportResult.mjs.map

package/dist/utils/llmTransportResult.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"llmTransportResult.mjs"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/domain-kit",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Domain graph generation engine — decomposes any domain (software, hardware, math, science...) into structured domain graphs for curriculum planning.",
   "author": "Thanh Pham <https://github.com/thanh01pmt>",
   "license": "MIT",
@@ -51,14 +51,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build": "npm run clean && tsup",
-    "lint": "eslint . --ext .ts",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
   "dependencies": {
     "zod": "^3.23.8"
   },
@@ -67,5 +59,12 @@
     "tsup": "^8.3.6",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsup",
+    "lint": "eslint . --ext .ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}