@zhuoyuezs/ml-platform 0.2.3 → 0.2.4

package/checksums.json

@@ -7,12 +7,12 @@
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:fcc57e214724294f6208ec192dbe42b9cabbb6324945b0e93471bf991f76f0bc",
+      "sha256": "sha256:744e49f72a879478a18899c6eb64cf3bbdc22700e9d8a4b61d45ad3a5927deb9",
       "size_bytes": 1628
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:61b2a01e7611af07ad49a1789cbaddb5f8ec36d70b78ef72d54227039990e8dc",
+      "sha256": "sha256:97145119a4080392bbd2242b6a5a67046aa45e720c38977686fa0f4346c41bf0",
       "size_bytes": 671
     },
     {
@@ -22,8 +22,8 @@
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:3913154693561ea4cea1538f560bf5e4f4b4488398abf69332f23f302481ee04",
-      "size_bytes": 66966
+      "sha256": "sha256:6ad8fb06e410cb5a197a696f3cb9819e9e3b06919d443d303a3e9d285cf4c0e2",
+      "size_bytes": 68793
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -32,13 +32,13 @@
     },
     {
       "path": "runtime/business-client/src/http.js",
-      "sha256": "sha256:517ad46944f3a4068a00a570dc09975c5b59de61b730e0acf8e009ee1f18c89d",
-      "size_bytes": 18865
+      "sha256": "sha256:088ef5fa067cc830a95db7d8ad3887ae58276179b524533f338daa781e243979",
+      "size_bytes": 19452
     },
     {
       "path": "skills/data-source-exploration/SKILL.md",
-      "sha256": "sha256:11b20671ad81b42cd2ddb1cb146196b9f5ab15e962249e7e07cfa148c601e881",
-      "size_bytes": 4172
+      "sha256": "sha256:1f1f89d4ca41c3f7b206287e983027f50f65e462897584511259067fe94f2707",
+      "size_bytes": 5631
     },
     {
       "path": "skills/data-source-exploration/agents/openai.yaml",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"

package/release.json

@@ -13,8 +13,8 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:a002eb1fb35605ad13ad071b2131233fd4b798e3438984ae1c4c6f4ddf262902",
-    "version": "0.8.4"
+    "sha256": "sha256:3cf1b6b441fc99bfc8e1615f7c0949a3234da0e4ccaa70fca2ddb4ed7b96cae4",
+    "version": "0.8.5"
   },
   "policy_sha256": "sha256:02fbde0134696b78c0c365d6e0b76c9814227208da5b2b3d4e5dbd82dc4a3606",
   "public_schema_versions": [
@@ -25,7 +25,7 @@
     "ml_data_platform.feature_set/v1",
     "ml_data_platform.dataset_manifest/v1"
   ],
-  "release_version": "0.2.3",
+  "release_version": "0.2.4",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,34 +37,34 @@
   "skills": {
     "data-source-exploration": {
       "path": "skills/data-source-exploration",
-      "requires_cli": ">=0.8.4 <0.9.0",
-      "revision": "0.2.3",
-      "sha256": "sha256:2fa1e1802d799ee0c47b10263f2fde57b604e505fea5c98bfa23f51f382bbf69"
+      "requires_cli": ">=0.8.5 <0.9.0",
+      "revision": "0.2.4",
+      "sha256": "sha256:6cb1cad3e9531e5098582c532288edd9838c2acab2b324794ec99d2550418f32"
     },
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.8.4 <0.9.0",
-      "revision": "0.2.3",
+      "requires_cli": ">=0.8.5 <0.9.0",
+      "revision": "0.2.4",
       "sha256": "sha256:6dfa708172c3b5b23af75997c82a6d43bc2eb8ca67cc2275c8b95022455b0c42"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.8.4 <0.9.0",
-      "revision": "0.2.3",
+      "requires_cli": ">=0.8.5 <0.9.0",
+      "revision": "0.2.4",
       "sha256": "sha256:d3f3fe0e4a11b93d8f6f57758164aa236b84a49c1b9f0d0b700fd9d6d615a8d7"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.8.4 <0.9.0",
-      "revision": "0.2.3",
+      "requires_cli": ">=0.8.5 <0.9.0",
+      "revision": "0.2.4",
       "sha256": "sha256:8822fbec7037c2312d18b1d18648b60757fc569e6bf5f2856ea41592f3ba987d"
     },
     "prediction-report-management": {
       "path": "skills/prediction-report-management",
-      "requires_cli": ">=0.8.4 <0.9.0",
-      "revision": "0.2.3",
+      "requires_cli": ">=0.8.5 <0.9.0",
+      "revision": "0.2.4",
       "sha256": "sha256:3a6991eec5cfa6bf30eaf43295f0c7d5c1e70e4f638904dfde1be2a39965d64f"
     }
   },
-  "source_commit": "fc09e3233f9ba919b3c8ce7ff5044527ed0f7415"
+  "source_commit": "a8bb3f066537b312a7d146b7a9c1bf59484f6f51"
 }

package/runtime/business-client/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.8.4",
+      "version": "0.8.5",
       "license": "UNLICENSED",
       "bin": {
         "ml-platform": "src/cli.js"

package/runtime/business-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "private": true,
   "description": "JavaScript implementation of the ML Platform business client",
   "bin": {

package/runtime/business-client/src/cli.js

@@ -15,7 +15,9 @@ const BUSINESS_COMMANDS = new Set([
     "version", "create-project", "list-projects", "get-project", "delete-project",
     "configure", "show-config", "health",
     "list-datasource-connections", "list-datasource-namespaces", "list-datasource-objects",
-    "list-datasource-fields", "query-datasource-object",
+    "list-datasource-fields", "query-datasource-object", "create-datasource-connection",
+    "get-datasource-connection", "update-datasource-connection", "delete-datasource-connection",
+    "test-datasource-connection",
     "list-parameters", "list-operators", "list-features",
     "list-feature-sets", "list-datasets", "get-dataset", "list-jobs", "resolve-manifest",
     "resolve-dataset", "build-dataset", "build-registered-dataset",
@@ -62,6 +64,11 @@ const COMMAND_USAGE = {
     "list-datasource-objects": "list-datasource-objects CONNECTION_ID NAMESPACE_ID [--limit N] [--cursor CURSOR]",
     "list-datasource-fields": "list-datasource-fields CONNECTION_ID OBJECT_ID [--limit N] [--cursor CURSOR]",
     "query-datasource-object": "query-datasource-object CONNECTION_ID OBJECT_ID SPEC_JSON [--cursor CURSOR]",
+    "create-datasource-connection": "create-datasource-connection SPEC_JSON",
+    "get-datasource-connection": "get-datasource-connection CONNECTION_ID",
+    "update-datasource-connection": "update-datasource-connection CONNECTION_ID SPEC_JSON",
+    "delete-datasource-connection": "delete-datasource-connection CONNECTION_ID",
+    "test-datasource-connection": "test-datasource-connection CONNECTION_ID",
     "create-project": "create-project NAME [--display-name TEXT] [--description TEXT] [--owner OWNER]",
     "list-projects": "list-projects",
     "get-project": "get-project NAME",
@@ -445,6 +452,25 @@ async function runBusinessCli(argv) {
             spec.cursor = cursor;
         result = await client(options).post(`/datasource-connections/${encodeURIComponent(connectionId)}/objects/${encodeURIComponent(objectId)}/query`, spec);
     }
+    else if (options.command === "create-datasource-connection") {
+        result = await client(options).post("/datasource-connections", readSpec(positional(rest, "connection spec JSON")));
+    }
+    else if (options.command === "get-datasource-connection") {
+        const connectionId = positional(rest, "connection id");
+        result = await client(options).get(`/datasource-connections/${encodeURIComponent(connectionId)}`);
+    }
+    else if (options.command === "update-datasource-connection") {
+        const connectionId = positional(rest, "connection id");
+        result = await client(options).put(`/datasource-connections/${encodeURIComponent(connectionId)}`, readSpec(positional(rest, "connection spec JSON")));
+    }
+    else if (options.command === "delete-datasource-connection") {
+        const connectionId = positional(rest, "connection id");
+        result = await client(options).delete(`/datasource-connections/${encodeURIComponent(connectionId)}`);
+    }
+    else if (options.command === "test-datasource-connection") {
+        const connectionId = positional(rest, "connection id");
+        result = await client(options).post(`/datasource-connections/${encodeURIComponent(connectionId)}/test`, {});
+    }
     else if (options.command === "create-project") {
         const name = positional(rest, "project name");
         result = await client(options).post("/projects", { schema_version: "ml_data_platform.project/v1", name, display_name: take(rest, "--display-name", name), description: take(rest, "--description", ""), owner: take(rest, "--owner", "demo") });
@@ -727,7 +753,7 @@ async function runBusinessCli(argv) {
             realtime.validate_freshness = false;
         if (boolean(rest, "--allow-missing"))
             realtime.allow_missing = true;
-        const request = { manifest: readDataset(manifest), cutoff_time: cutoffTime };
+        const request = { manifest: normalizeRegistryDataset(readObject(manifest)), cutoff_time: cutoffTime };
         if (Object.keys(realtime).length)
             request.realtime_fetch = realtime;
         result = await client(options).post("/inference-data/fetch", request);

package/runtime/business-client/src/http.js

@@ -5,6 +5,17 @@ const os = require("os");
 const path = require("path");
 const zlib = require("zlib");
 const { expandHome } = require("./config");
+function apiErrorDetail(result, fallback) {
+    if (result === null || result === undefined)
+        return fallback;
+    if (typeof result === "string")
+        return result || fallback;
+    // Keep the familiar string detail, but serialize structured error responses
+    // in full so nested field errors and sibling diagnostics remain visible.
+    if (typeof result.detail === "string" && Object.keys(result).length === 1)
+        return result.detail;
+    return JSON.stringify(result, null, 2);
+}
 class PlatformApiClient {
     constructor(baseUrl, timeoutSeconds = 30) {
         this.baseUrl = String(baseUrl).trim().replace(/\/+$/, "");
@@ -50,10 +61,11 @@ class PlatformApiClient {
             result = JSON.parse(text);
         }
         catch (_) {
-            throw new Error("platform API returned invalid JSON");
+            if (response.ok)
+                throw new Error("platform API returned invalid JSON");
         }
         if (!response.ok)
-            throw new Error(`platform API request failed: ${method} ${response.url}: HTTP ${response.status}: ${result?.detail ?? response.statusText}`);
+            throw new Error(`platform API request failed: ${method} ${response.url || this.url(endpoint, params)}: HTTP ${response.status}: ${apiErrorDetail(result, text.trim() || response.statusText)}`);
         if (!result || typeof result !== "object")
             throw new Error("platform API returned an unsupported JSON response");
         return result;

package/skills/data-source-exploration/SKILL.md

@@ -6,7 +6,41 @@ description: Discover platform-configured PostgreSQL, MySQL, SQL Server, or Infl
 # Data Source Exploration
 
 Use the platform API through `ml-platform`; never connect to a business database directly and
-never request credentials. The platform exposes configured connections and their discoverable objects.
+never request credentials in chat. The platform exposes managed connections and their discoverable
+objects. Connection credentials are write-only control-plane input and are never returned by the
+platform.
+
+## Manage Connections
+
+Datasource connections are business-owned platform resources, not ConfigMap entries. An operator
+with the required platform permission can create or change one from a JSON file; the API encrypts
+the connection configuration at rest and returns only metadata:
+
+```json
+{
+  "connection_id": "postgresql_bf_monitoring",
+  "name": "BF monitoring",
+  "adapter": "postgresql_direct",
+  "connection_config": {
+    "dsn": "postgresql://readonly:password@db.example:5432/bf_monitoring_dev_db",
+    "timeout_seconds": 30
+  }
+}
+```
+
+```bash
+ml-platform create-datasource-connection connection.json
+ml-platform test-datasource-connection postgresql_bf_monitoring
+ml-platform list-datasource-connections
+ml-platform update-datasource-connection postgresql_bf_monitoring connection.json
+ml-platform delete-datasource-connection postgresql_bf_monitoring
+```
+
+Do not put the JSON file in the repository or paste real credentials into logs or issue comments.
+Updating a connection creates a new internal revision. Dataset Workers and realtime reads resolve
+the latest enabled revision from platform storage when they start or when the API handles a request;
+the business connection does not require a Pod restart. A platform-level encryption key remains
+system security configuration, but the connection itself is managed through this resource API.
 
 ## Establish The Target