@yejiming/dsh-data-agent 0.0.12 → 0.1.0

package/conformance/dsh-ecosystem/fixtures/profiles/native-only/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "dsh-data-agent-native-only-fixture",
+  "private": true,
+  "fixture": true,
+  "dependencies": {
+    "@yejiming/dsh-data-agent": "file:../../../../.."
+  }
+}

package/conformance/dsh-ecosystem/fixtures/profiles/native-plus-adapter/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "dsh-data-agent-native-plus-adapter-fixture",
+  "private": true,
+  "fixture": true,
+  "dependencies": {
+    "@dsh-std/adapter-dsh": "0.1.0-rc3",
+    "@yejiming/dsh-data-agent": "file:../../../../.."
+  }
+}

package/conformance/dsh-ecosystem/inventory.json

@@ -0,0 +1,100 @@
+{
+  "inventoryVersion": "1",
+  "packageName": "@yejiming/dsh-data-agent",
+  "nativeRuntime": {
+    "bundleRows": [
+      "@yejiming/dsh-data-agent",
+      "@yejiming/dsh-data-agent/routes"
+    ],
+    "presetRows": [
+      "@deepseek-ai/dsh-persona",
+      "@deepseek-ai/dsh-tool-str-replace-editor"
+    ],
+    "commands": ["catalog", "database"],
+    "tools": [
+      "render-analysis",
+      "catalog-get",
+      "catalog-search",
+      "metric-get",
+      "sql-cmd",
+      "sql-query",
+      "sql-write",
+      "str_replace_editor"
+    ],
+    "services": [
+      "dataAgentCatalog",
+      "dataAgentCatalogReview",
+      "dataAgentCatalogScanner",
+      "dataAgentConnections"
+    ],
+    "routes": [
+      "GET describe",
+      "GET catalog/assets/:assetId",
+      "GET catalog/diff",
+      "GET catalog/runs",
+      "GET catalog/search",
+      "GET catalog/semantics/:semanticId",
+      "GET catalog/sources",
+      "GET catalog/status",
+      "GET schemas",
+      "GET status",
+      "GET tables",
+      "POST connect",
+      "POST catalog/cancel",
+      "POST catalog/scan",
+      "POST catalog/semantics",
+      "POST catalog/semantics/:semanticId/dismiss",
+      "POST catalog/semantics/:semanticId/retire",
+      "POST catalog/semantics/:semanticId/verify",
+      "POST disconnect",
+      "POST query"
+    ],
+    "webSlots": [
+      "conversation.input.right",
+      "tool.call.toolview"
+    ],
+    "storageDomains": ["data_agent_catalog@1", "data_agent_connections@1"],
+    "surfaces": ["desktop", "headless", "tui", "web"],
+    "databaseTypes": [
+      "clickhouse",
+      "doris",
+      "hive",
+      "impala",
+      "mysql",
+      "oracle",
+      "postgres",
+      "sqlite",
+      "sqlserver"
+    ],
+    "publicExports": [
+      ".",
+      "./client",
+      "./command",
+      "./cordis.patch.yml",
+      "./invariant",
+      "./package.json",
+      "./routes",
+      "./src/*",
+      "./tool"
+    ],
+    "packageFiles": [
+      "cordis.patch.yml",
+      "lib/**",
+      "preset/**"
+    ]
+  },
+  "abilities": [
+    { "id": "command:catalog", "disposition": "declared", "manifestReference": "io.github.omdsh-dev.dsh-data-agent.catalog" },
+    { "id": "command:database", "disposition": "declared", "manifestReference": "io.github.omdsh-dev.dsh-data-agent.database" },
+    { "id": "tools:model", "disposition": "upstream-gap", "restrictionId": "tool-extension-not-in-tui-profile" },
+    { "id": "preset:data-agent", "disposition": "upstream-gap", "restrictionId": "agent-preset-not-in-tui-profile" },
+    { "id": "service:dataAgentConnections", "disposition": "upstream-gap", "restrictionId": "cordis-service-not-in-tui-profile" },
+    { "id": "routes:data-agent", "disposition": "restriction", "restrictionId": "http-routes-native-only" },
+    { "id": "ui:web-slots", "disposition": "restriction", "restrictionId": "web-slots-native-only" },
+    { "id": "storage:data_agent_connections", "disposition": "restriction", "restrictionId": "storage-domain-native-only" },
+    { "id": "storage:data_agent_catalog", "disposition": "restriction", "restrictionId": "storage-domain-native-only" },
+    { "id": "credentials:resolve", "disposition": "restriction", "restrictionId": "credential-resolution-native-only" },
+    { "id": "subprocess:database-clients", "disposition": "restriction", "restrictionId": "database-execution-native-only" },
+    { "id": "presentation:local-tty", "disposition": "restriction", "restrictionId": "legacy-local-tty" }
+  ]
+}

package/conformance/dsh-ecosystem/restrictions.json

@@ -0,0 +1,20 @@
+{
+  "restrictionVersion": "1",
+  "claimCeilingWithoutRealHost": "Parsed",
+  "items": [
+    { "id": "tool-extension-not-in-tui-profile", "kind": "upstream-gap", "requirementId": "DECL-CLOSURE-001", "summary": "The pinned TUI profile does not import the complete model Tool/Preset declaration used by the native data-agent scope." },
+    { "id": "agent-preset-not-in-tui-profile", "kind": "upstream-gap", "requirementId": "DECL-CLOSURE-001", "summary": "Agent preset standing-scope composition remains a native DSH contract." },
+    { "id": "cordis-service-not-in-tui-profile", "kind": "upstream-gap", "requirementId": "DECL-CLOSURE-001", "summary": "The dataAgentConnections and Catalog Cordis service faces have no admitted Community v0.15 service definition." },
+    { "id": "http-routes-native-only", "kind": "restriction", "requirementId": "NATIVE-NO-REGRESSION-001", "summary": "HTTP routes remain owned by the native Web bundle row." },
+    { "id": "web-slots-native-only", "kind": "restriction", "requirementId": "NATIVE-NO-REGRESSION-001", "summary": "Web slots remain owned by the native browser client." },
+    { "id": "storage-domain-native-only", "kind": "restriction", "requirementId": "DECL-CLOSURE-001", "summary": "The durable data_agent_connections and data_agent_catalog domains remain owned by native Cordis storage-domain." },
+    { "id": "credential-resolution-native-only", "kind": "restriction", "requirementId": "TRUST-001", "summary": "Credential references resolve only inside the existing native runtime and are excluded from evidence." },
+    { "id": "database-execution-native-only", "kind": "restriction", "requirementId": "DEPENDENCY-CLOSURE-001", "summary": "Database execution remains native and depends on packaged or external database clients." },
+    { "id": "legacy-local-tty", "kind": "restriction", "requirementId": "PRESENTATION-001", "summary": "The masked local TTY form is preserved but is not standard Presentation evidence." },
+    { "id": "user-interaction-negotiation-spec-gap", "kind": "upstream-gap", "requirementId": "PRESENTATION-001", "summary": "UserInteraction is intentionally not declared: Community v0.15 contract rows cannot carry the requirement spec required by the pinned dsh-std protocol definition, and declaring it prevents actual adapter activation." },
+    { "id": "no-standard-effect-ownership", "kind": "restriction", "requirementId": "LIFECYCLE-001", "summary": "Native Cordis effects are implementation evidence, not standard activation-owned ledger effects." },
+    { "id": "real-host-descriptor-unavailable", "kind": "restriction", "requirementId": "CLAIM-CEILING-001", "summary": "Repository Host Descriptors are fixtures and cannot establish real-host compatibility." },
+    { "id": "remote-presentation-unverified", "kind": "restriction", "requirementId": "PRESENTATION-001", "summary": "Local, remote, attach/detach, and multiple-Presentation parity has not been observed on a real Host." },
+    { "id": "external-attestation-unavailable", "kind": "restriction", "requirementId": "CLAIM-CEILING-001", "summary": "No external signer or governance attestation is present." }
+  ]
+}

package/cordis.patch.yml

@@ -1,8 +1,11 @@
 # The dsh-data-agent bundle patch: activates the plugin as a profile layer.
 #
-# Two host rows: `data-agent` provides the connection store, installs the
-# selectable agent preset, and statically preloads that preset's scoped tools
-# and command through the profile bundle path; `data-agent-routes` mounts the
+# Two host rows: `data-agent` provides connection and versioned Catalog stores,
+# installs the selectable agent preset, and statically preloads that preset's
+# scoped tools on every surface and gates the human commands plus optional
+# public status/scene presentation on the actual `dsh-tui` Cordis plugin
+# runtime (independent of profile name);
+# `data-agent-routes` mounts the
 # HTTP routes and only activates where the webserver exists (web profiles).
 # The browser half (lib/client.js) ships in the same package and loads under
 # the data-agent id through the `dsh.client` declaration in package.json.

package/dsh-plugin.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://dsh.community/schemas/dsh-plugin-0.15.json",
+  "manifestVersion": "0.15",
+  "id": "io.github.omdsh-dev.dsh-data-agent",
+  "name": "DSH Data Agent",
+  "version": "0.1.0",
+  "facets": {
+    "host": {
+      "entry": "lib/ecosystem.js",
+      "apiVersion": "v1alpha1"
+    }
+  },
+  "requires": {
+    "contracts": [
+      {
+        "apiVersion": "commands.dsh/v1alpha1",
+        "kind": "Command"
+      },
+      {
+        "apiVersion": "storage.dsh/v1alpha1",
+        "kind": "LocalStorage",
+        "optional": true,
+        "fallback": "use the native Cordis storage-domain, or process-local state when native persistence is disabled"
+      }
+    ],
+    "services": []
+  },
+  "permissions": [
+    {
+      "name": "commands.invoke",
+      "scope": "io.github.omdsh-dev.dsh-data-agent",
+      "reason": "invoke the declared database and human-controlled Catalog commands when the dsh-tui runtime is loaded"
+    }
+  ],
+  "contributes": {
+    "commands": [
+      {
+        "id": "io.github.omdsh-dev.dsh-data-agent.database",
+        "title": "Database",
+        "description": "Manage the native data-agent database connection when the dsh-tui runtime is loaded"
+      },
+      {
+        "id": "io.github.omdsh-dev.dsh-data-agent.catalog",
+        "title": "Data Catalog",
+        "description": "Scan system metadata, follow persistent progress, and browse versioned Catalog results when the dsh-tui runtime is loaded"
+      }
+    ],
+    "panels": []
+  },
+  "subscriptions": [],
+  "license": "MIT",
+  "source": {
+    "repository": "https://github.com/omdsh-dev/dsh-data-agent"
+  },
+  "overrides": [
+    {
+      "target": "package.json#dsh.bundle",
+      "kind": "native",
+      "description": "The existing Cordis bundle remains the sole functional runtime"
+    },
+    {
+      "target": "lib/client.js",
+      "kind": "build",
+      "description": "The Web client is a generated browser closure-factory artifact"
+    },
+    {
+      "target": "database-clients",
+      "kind": "native",
+      "description": "Database execution may require external CLI clients; ClickHouse uses its packaged HTTP client"
+    }
+  ]
+}