@hanger-source/agentic-olap 0.15.3 → 0.17.2

package/licenses/jvm/dependencies.json

@@ -69,6 +69,22 @@
             "com.fasterxml.jackson.module/jackson-module-kotlin/2.18.6/META-INF/NOTICE"
         ]
     },
+    {
+        "coordinate": "com.google.code.findbugs:jsr305:3.0.2",
+        "jar": "jsr305-3.0.2.jar",
+        "sha256": "766ad2a0783f2687962c8ad74ceecc38a28b9f72a2d085ee438b7813e928d0c7",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "com.google.code.gson:gson:2.8.9",
+        "jar": "gson-2.8.9.jar",
+        "sha256": "d3999291855de495c94c743761b8ab5176cfeabe281a5ab0d8e8d45326fd703e",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "com.google.errorprone:error_prone_annotations:2.36.0",
         "jar": "error_prone_annotations-2.36.0.jar",
@@ -109,6 +125,14 @@
             
         ]
     },
+    {
+        "coordinate": "com.google.protobuf:protobuf-java-util:4.33.2",
+        "jar": "protobuf-java-util-4.33.2.jar",
+        "sha256": "810ecf895fde89e0f0f0bc34f3fec0bfa949c8173e941c15f9f2bb9f0ed7644a",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "com.google.protobuf:protobuf-java:4.33.2",
         "jar": "protobuf-java-4.33.2.jar",
@@ -149,6 +173,14 @@
             
         ]
     },
+    {
+        "coordinate": "com.typesafe:config:1.4.9",
+        "jar": "config-1.4.9.jar",
+        "sha256": "47d13e3196c84f2a8ccd014ae563738c3da5b7406b38e03505ec0601a2f4fc37",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "com.yahoo.datasketches:memory:0.9.0",
         "jar": "memory-0.9.0.jar",
@@ -192,6 +224,182 @@
             "commons-logging/commons-logging/1.3.5/META-INF/NOTICE.txt"
         ]
     },
+    {
+        "coordinate": "io.github.oshai:kotlin-logging-jvm:8.0.4",
+        "jar": "kotlin-logging-jvm-8.0.4.jar",
+        "sha256": "0bbac3f9dac5067b40d02fe461a053782bc8d3ef5162a923581b369adef7e02d",
+        "embeddedNotices": [
+            "io.github.oshai/kotlin-logging-jvm/8.0.4/META-INF/LICENSE"
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-events-jvm:3.5.1",
+        "jar": "ktor-events-jvm-3.5.1.jar",
+        "sha256": "652ce716196b635e7d2988e324cdb06f649b02e526f88680c5c2511e3964bd93",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-http-cio-jvm:3.5.1",
+        "jar": "ktor-http-cio-jvm-3.5.1.jar",
+        "sha256": "c635b73b050ba842f138c19a46a758d094c7ba6f949d74a0e4d14c78b5fd7e64",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-http-jvm:3.5.1",
+        "jar": "ktor-http-jvm-3.5.1.jar",
+        "sha256": "0ba1aad28ec212e54f1a1358510d415259efa483075436375ee48d25f8b6bcf8",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-io-jvm:3.5.1",
+        "jar": "ktor-io-jvm-3.5.1.jar",
+        "sha256": "9c43ed3370e04428b6f3e113fe53c56881459329c18f2ffea2a11008fd096dcf",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-network-jvm:3.5.1",
+        "jar": "ktor-network-jvm-3.5.1.jar",
+        "sha256": "7c972c97aecc9b27db8377e3347e6f66fad4b524112c073bef2d6150d1194492",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-serialization-jvm:3.5.1",
+        "jar": "ktor-serialization-jvm-3.5.1.jar",
+        "sha256": "1d9ee9d0a2d489e8e592552da577cf1dd2d13ce97ab1387c864813381309574a",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-serialization-kotlinx-json-jvm:3.5.1",
+        "jar": "ktor-serialization-kotlinx-json-jvm-3.5.1.jar",
+        "sha256": "68b907facba9caedac5bcfbd6ce3123920fd7606673267ce12d53a8c9a6aa3c3",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-serialization-kotlinx-jvm:3.5.1",
+        "jar": "ktor-serialization-kotlinx-jvm-3.5.1.jar",
+        "sha256": "148cd52661c2e4cbb1c88ca4ce3e6622335b4339a3b369054139d0d11a70f630",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-body-limit-jvm:3.5.1",
+        "jar": "ktor-server-body-limit-jvm-3.5.1.jar",
+        "sha256": "77a96dfe872ddfbe2143d831abd41a60b9bfc0fa4c934f2547553b6ece275e41",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-cio-jvm:3.5.1",
+        "jar": "ktor-server-cio-jvm-3.5.1.jar",
+        "sha256": "6498b6050b724477c520a0c3676c73a30ab80ea2b9870138279e30245b23bae2",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-content-negotiation-jvm:3.5.1",
+        "jar": "ktor-server-content-negotiation-jvm-3.5.1.jar",
+        "sha256": "acb8ed35fa2e0916d6570adbd9c2337828c5d83c1b28d8fc8c90e32cdc86ed61",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-core-jvm:3.5.1",
+        "jar": "ktor-server-core-jvm-3.5.1.jar",
+        "sha256": "907792c40323b18f95fed6caeda79c3bad399509e6cdad002cd9c5ccac95b639",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-double-receive-jvm:3.5.1",
+        "jar": "ktor-server-double-receive-jvm-3.5.1.jar",
+        "sha256": "a3aeaa8ff2f7235db1d4c556fddfc64550bfcb4e307b3f3baf5e7455e7e99b73",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-sse-jvm:3.5.1",
+        "jar": "ktor-server-sse-jvm-3.5.1.jar",
+        "sha256": "de9037bcf8c5a92ecfa7fc7a2fdfa9210652021add821bc3bf36879366dc2aa7",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-server-websockets-jvm:3.5.1",
+        "jar": "ktor-server-websockets-jvm-3.5.1.jar",
+        "sha256": "577d4048ee9475fade2f5b9963e730985f4f8f825407ac436c38dd652f20a040",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-sse-jvm:3.5.1",
+        "jar": "ktor-sse-jvm-3.5.1.jar",
+        "sha256": "0fd6b6dcaded1679a7a55067e8b1de982ed964d4c102637b88ef092913144c39",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-utils-jvm:3.5.1",
+        "jar": "ktor-utils-jvm-3.5.1.jar",
+        "sha256": "daccfd4e43039bec119976cb785356b4cebac927155f501132fb3be83125fa87",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-websocket-serialization-jvm:3.5.1",
+        "jar": "ktor-websocket-serialization-jvm-3.5.1.jar",
+        "sha256": "d2743212e59ae113d0f0bcbd1320e6bd8212013c48ca2ba52b2631035f622f1c",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.ktor:ktor-websockets-jvm:3.5.1",
+        "jar": "ktor-websockets-jvm-3.5.1.jar",
+        "sha256": "4d3f2e13068f2b6441ed2b29a3f0c5b796dce4a55e0958efd354839bd444e07f",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.modelcontextprotocol:kotlin-sdk-core-jvm:0.15.0",
+        "jar": "kotlin-sdk-core-jvm-0.15.0.jar",
+        "sha256": "286b34892ab362365d4d9ba09b6c949199128470f83cf7dd410854f18cc625e1",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "io.modelcontextprotocol:kotlin-sdk-server-jvm:0.15.0",
+        "jar": "kotlin-sdk-server-jvm-0.15.0.jar",
+        "sha256": "2a3720c631a2e1ba15194838ac0244dc93f702e79e6c361bb35b4ab2e15e3c16",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "jakarta.transaction:jakarta.transaction-api:1.3.3",
         "jar": "jakarta.transaction-api-1.3.3.jar",
@@ -208,6 +416,14 @@
             
         ]
     },
+    {
+        "coordinate": "net.java.dev.jna:jna:5.19.1",
+        "jar": "jna-5.19.1.jar",
+        "sha256": "4fb141dd8ef6b0585ffceea4bc49602fbc6312fa977e2c488794ea3e6aafecae",
+        "embeddedNotices": [
+            "net.java.dev.jna/jna/5.19.1/META-INF/LICENSE"
+        ]
+    },
     {
         "coordinate": "net.minidev:accessors-smart:2.6.0",
         "jar": "accessors-smart-2.6.0.jar",
@@ -364,6 +580,14 @@
             
         ]
     },
+    {
+        "coordinate": "org.duckdb:duckdb_jdbc:1.5.6.0",
+        "jar": "duckdb_jdbc-1.5.6.0.jar",
+        "sha256": "04ae3375d7c40dc88dc9bf0014b82ba5e66715564584af4e3abea39c7ba144d3",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "org.jetbrains.kotlin:kotlin-build-tools-api:2.4.21",
         "jar": "kotlin-build-tools-api-2.4.21.jar",
@@ -388,14 +612,6 @@
             
         ]
     },
-    {
-        "coordinate": "org.jetbrains.kotlin:kotlin-reflect:1.6.10",
-        "jar": "kotlin-reflect-1.6.10.jar",
-        "sha256": "3277ac102ae17aad10a55abec75ff5696c8d109790396434b496e75087854203",
-        "embeddedNotices": [
-            
-        ]
-    },
     {
         "coordinate": "org.jetbrains.kotlin:kotlin-reflect:2.4.21",
         "jar": "kotlin-reflect-2.4.21.jar",
@@ -460,6 +676,22 @@
             
         ]
     },
+    {
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-collections-immutable-jvm:0.5.1",
+        "jar": "kotlinx-collections-immutable-jvm-0.5.1.jar",
+        "sha256": "d5e4bb25d6e90f7471662b3500259e247523a410e6a820dcc4000d386b0c248c",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm:1.11.0",
+        "jar": "kotlinx-coroutines-core-jvm-1.11.0.jar",
+        "sha256": "d1d75aa01dffbb4d1c520e67e4c4e7f5f6174718e7cb4632412503f2f0e604fa",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm:1.8.0",
         "jar": "kotlinx-coroutines-core-jvm-1.8.0.jar",
@@ -469,17 +701,41 @@
         ]
     },
     {
-        "coordinate": "org.jetbrains.kotlinx:kotlinx-serialization-core-jvm:1.9.0",
-        "jar": "kotlinx-serialization-core-jvm-1.9.0.jar",
-        "sha256": "1f0afa172110e45a7231ef1b44ae8fd84c1ebaff96f3fc3ad68ef8c48120b59c",
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-io-bytestring-jvm:0.9.1",
+        "jar": "kotlinx-io-bytestring-jvm-0.9.1.jar",
+        "sha256": "8589de0b7c476bfdd02a24641685f609ade72f5e595cf2909c168acdba7e6ba4",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-io-core-jvm:0.9.1",
+        "jar": "kotlinx-io-core-jvm-0.9.1.jar",
+        "sha256": "765d8851d8ca694706931331b92386844800867e041b720f1f193dbda874d370",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-serialization-core-jvm:1.11.0",
+        "jar": "kotlinx-serialization-core-jvm-1.11.0.jar",
+        "sha256": "f4a801c647d4351327cd9e1ac4113e2be9ea37a64ab0abae269c25a52e28f35d",
         "embeddedNotices": [
             
         ]
     },
     {
-        "coordinate": "org.jetbrains.kotlinx:kotlinx-serialization-json-jvm:1.9.0",
-        "jar": "kotlinx-serialization-json-jvm-1.9.0.jar",
-        "sha256": "d94cc34cae39246a1af74fda63f9c4812ce12216ef641d5fa3bbbb539a6922d8",
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-serialization-json-io-jvm:1.11.0",
+        "jar": "kotlinx-serialization-json-io-jvm-1.11.0.jar",
+        "sha256": "bbf3005522426ac4ba2acd6dc38f47ea5a3274ee82b932b8841835c7eaddab74",
+        "embeddedNotices": [
+            
+        ]
+    },
+    {
+        "coordinate": "org.jetbrains.kotlinx:kotlinx-serialization-json-jvm:1.11.0",
+        "jar": "kotlinx-serialization-json-jvm-1.11.0.jar",
+        "sha256": "563a25b4eb5c9128ae9c2479f3d1a5c44dcd176112b91cf03682e906eba5c935",
         "embeddedNotices": [
             
         ]
@@ -492,6 +748,14 @@
             
         ]
     },
+    {
+        "coordinate": "org.jetbrains:annotations:23.0.0",
+        "jar": "annotations-23.0.0.jar",
+        "sha256": "7b0f19724082cbfcbc66e5abea2b9bc92cf08a1ea11e191933ed43801eb3cd05",
+        "embeddedNotices": [
+            
+        ]
+    },
     {
         "coordinate": "org.jooq:joou-java-6:0.9.5",
         "jar": "joou-java-6-0.9.5.jar",

package/licenses/{go/github.com+modelcontextprotocol+go-sdk → jvm/io.github.oshai/kotlin-logging-jvm/8.0.4/META-INF}/LICENSE

@@ -1,10 +1,3 @@
-The MCP project is undergoing a licensing transition from the MIT License to the Apache License, Version 2.0 ("Apache-2.0"). All new code and specification contributions to the project are licensed under Apache-2.0. Documentation contributions (excluding specifications) are licensed under CC-BY-4.0.
-
-Contributions for which relicensing consent has been obtained are licensed under Apache-2.0. Contributions made by authors who originally licensed their work under the MIT License and who have not yet granted explicit permission to relicense remain licensed under the MIT License.
-
-No rights beyond those granted by the applicable original license are conveyed for such contributions.
-
----
 
                                  Apache License
                            Version 2.0, January 2004
@@ -56,9 +49,9 @@ No rights beyond those granted by the applicable original license are conveyed f
       "Contribution" shall mean any work of authorship, including
       the original version of the Work and any modifications or additions
       to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright
-      owner or by an individual or Legal Entity authorized to submit on behalf
-      of the copyright owner. For the purposes of this definition, "submitted"
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
       means any form of electronic, verbal, or written communication sent
       to the Licensor or its representatives, including but not limited to
       communication on electronic mailing lists, source code control systems,
@@ -183,34 +176,27 @@ No rights beyond those granted by the applicable original license are conveyed f
 
    END OF TERMS AND CONDITIONS
 
----
-
-MIT License
-
-Copyright (c) 2024-2025 Model Context Protocol a Series of LF Projects, LLC.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+   APPENDIX: How to apply the Apache License to your work.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+   Copyright [2018] [Ohad Shai]
 
----
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
 
-Creative Commons Attribution 4.0 International (CC-BY-4.0)
+       http://www.apache.org/licenses/LICENSE-2.0
 
-Documentation in this project (excluding specifications) is licensed under
-CC-BY-4.0. See https://creativecommons.org/licenses/by/4.0/legalcode for
-the full license text.
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/licenses/jvm/net.java.dev.jna/jna/5.19.1/META-INF/LICENSE

@@ -0,0 +1,26 @@
+SPDX-License-Identifier: Apache-2.0 OR LGPL-2.1-or-later
+
+Java Native Access (JNA) is licensed under the LGPL, version 2.1
+or later, or (from version 4.0 onward) the Apache License,
+version 2.0.
+
+You can freely decide which license you want to apply to the project.
+
+You may obtain a copy of the LGPL License at:
+
+http://www.gnu.org/licenses/licenses.html
+
+A copy is also included in the downloadable source code package
+containing JNA, in file "LGPL2.1", under the same directory
+as this file.
+
+You may obtain a copy of the Apache License at:
+
+http://www.apache.org/licenses/
+
+A copy is also included in the downloadable source code package
+containing JNA, in file "AL2.0", under the same directory
+as this file.
+
+Commercial support may be available, please e-mail
+twall[at]users[dot]sf[dot]net.

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@hanger-source/agentic-olap",
-  "version": "0.15.3",
+  "version": "0.17.2",
   "description": "Installable Agentic OLAP service and command-line client with bundled runtimes",
   "license": "Apache-2.0",
   "author": "hanger",
-  "bin": { "agentic-olap": "runtime/agentic-olap-runtime" },
+  "bin": { "agentic-olap": "runtime/agentic-olap" },
   "files": ["runtime", "jre", "sdk", "connectors", "licenses", "distribution.json", "server.example.json", "resources.json", "jvm-dependencies.json", "build.json", "README.md", "LICENSE"],
-  "scripts": { "postinstall": "./runtime/agentic-olap-runtime install-jvm-dependencies" },
+  "scripts": { "postinstall": "./jre/bin/java -jar ./runtime/agentic-olap-bootstrap.jar ." },
   "os": ["darwin"],
   "cpu": ["arm64"],
   "engines": { "node": ">=20" },

package/resources.json

@@ -1,21 +1,21 @@
 {
-  "connectorApiVersion": "agentic-olap-connector/v12-kotlin-native-collection-placement-calcite-1.42",
-  "connectors": [
-    "connectors/0001-h2/connector.json",
-    "connectors/0002-duckdb/connector.json"
-  ],
-  "sdk": "sdk",
-  "sdkArtifacts": {
-    "connector-api": "com.github.hanger-source.agentic-olap:connector-api:v0.15.3",
-    "connector-loader": "com.github.hanger-source.agentic-olap:connector-loader:v0.15.3",
-    "engine-core": "com.github.hanger-source.agentic-olap:engine-core:v0.15.3",
-    "execution-calcite": "com.github.hanger-source.agentic-olap:execution-calcite:v0.15.3",
-    "execution-catalog": "com.github.hanger-source.agentic-olap:execution-catalog:v0.15.3",
-    "olap-contracts": "com.github.hanger-source.agentic-olap:olap-contracts:v0.15.3",
-    "semantic-calcite": "com.github.hanger-source.agentic-olap:semantic-calcite:v0.15.3",
-    "warehouse-contracts": "com.github.hanger-source.agentic-olap:warehouse-contracts:v0.15.3",
-    "warehouse-jdbc": "com.github.hanger-source.agentic-olap:warehouse-jdbc:v0.15.3"
-  },
-  "sdkRepository": "https://jitpack.io",
-  "version": "0.15.3"
+    "version": "0.17.2",
+    "connectorApiVersion": "agentic-olap-connector/v12-kotlin-native-collection-placement-calcite-1.42",
+    "sdk": "sdk",
+    "sdkRepository": "https://jitpack.io",
+    "sdkArtifacts": {
+        "connector-api": "com.github.hanger-source.agentic-olap:connector-api:v0.17.2",
+        "connector-loader": "com.github.hanger-source.agentic-olap:connector-loader:v0.17.2",
+        "engine-core": "com.github.hanger-source.agentic-olap:engine-core:v0.17.2",
+        "execution-calcite": "com.github.hanger-source.agentic-olap:execution-calcite:v0.17.2",
+        "execution-catalog": "com.github.hanger-source.agentic-olap:execution-catalog:v0.17.2",
+        "olap-contracts": "com.github.hanger-source.agentic-olap:olap-contracts:v0.17.2",
+        "semantic-calcite": "com.github.hanger-source.agentic-olap:semantic-calcite:v0.17.2",
+        "warehouse-contracts": "com.github.hanger-source.agentic-olap:warehouse-contracts:v0.17.2",
+        "warehouse-jdbc": "com.github.hanger-source.agentic-olap:warehouse-jdbc:v0.17.2"
+    },
+    "connectors": [
+        "connectors/h2/connector.json",
+        "connectors/duckdb/connector.json"
+    ]
 }

package/runtime/agentic-olap

@@ -0,0 +1,14 @@
+#!/bin/sh
+set -eu
+entry=$0
+while [ -L "$entry" ]; do
+  directory=$(CDPATH= cd -P -- "$(/usr/bin/dirname "$entry")" && pwd)
+  link=$(/usr/bin/readlink "$entry")
+  case "$link" in /*) entry=$link ;; *) entry=$directory/$link ;; esac
+done
+root=$(CDPATH= cd -P -- "$(/usr/bin/dirname "$entry")/.." && pwd)
+if [ ! -f "$root/runtime/installed.json" ] || [ ! -f "$root/runtime/server.args" ]; then
+  echo 'Agentic OLAP 的 npm 安装未完成，请重新执行 npm install。' >&2
+  exit 1
+fi
+exec "$root/jre/bin/java" "-Dagentic.olap.home=$root" "@$root/runtime/server.args" "$@"

package/sdk/API.md

@@ -31,7 +31,7 @@ SDK 的 JAR、POM 由插件工程的 Gradle 从 JitPack 匿名取得，第三方
 
 摘要使用 64 位小写十六进制。宿主提供共同合同、连接器 API 和 Calcite，插件不打包这些宿主类。JDBC 插件自行携带 JDBC 实现；仓库参考插件将共同实现重定位到 `com.olap.connectors.jdbc` 后打入插件 JAR。插件实现使用自己的包名，例如 `com.olap.connectors.backend`。独立插件组的类与原生资源从已核验 JAR 读取，宿主同名驱动不能遮蔽它们。
 
-应用侧 `connector-loader` 的唯一装载入口是 `ConnectorPlugins.load(List<Path>)`，接收明确的绝对 manifest 路径列表。完整服务从部署配置的 `connectors` 数组取得路径，Go 按本次工作所需的精确来源将对应列表交给 Kotlin 工作进程，由后者装载并持有资源；应用关闭时关闭装载器。业务请求不接受插件路径。重复精确身份、API 不匹配、字节摘要不符或缺驱动在装载时失败。
+应用侧 `connector-loader` 的唯一装载入口是 `ConnectorPlugins.load(List<Path>)`，接收明确的绝对 manifest 路径列表。完整服务从部署配置的 `connectors` 数组取得路径，主服务按本次工作所需的精确来源将对应列表交给工作进程，由后者装载并持有资源；应用关闭时关闭装载器。业务请求不接受插件路径。重复精确身份、API 不匹配、字节摘要不符或缺驱动在装载时失败。
 
 同一连接器 ID 的不同版本或不同构件摘要可以并存，各插件组使用独立目录。源码装配入口按输入序号隔离目录并返回准确 manifest 列表，发行归档沿该列表收集插件组；目录名不代替精确 `ConnectorRef`，不能只按 ID 推导路径或选择某个版本。
 
@@ -49,6 +49,29 @@ AVG 的类型容量、算术正确性与舍入必须共同成立。`typeSystem.d
 
 `deriveAvgAggType` 接收的是输入技术类型，不接收本次数据的最小值、最大值或行数；发现请求中的 `inputType` 也不是业务值域证明。最终数量容量及 `Approximate.minimum/maximum` 不能充当 AVG 的受限输入合同。当前没有从样本、字段名或过滤文本自动推导“安全评分范围”的机制。仅当来源先给出明确可证明的受限策略、而现有正式表达仍无法承载其前提时，才有依据讨论相应扩展；保证未知时保持拒绝。
 
+`CompilationSupport.division` 是来源表达式和完成关系的共同原生 DIVIDE 入口；SAFE_DIVIDE 也使用它，零分母由核心保留为 `NULLIF`。它可以是自定义 `SqlOperator`：返回类型推导接收实际有序输入类型，`unparse` 映射已证明的原生 SQL AST。采用标准 DECIMAL 除法推导时，实际工作类型来自 `typeSystem.deriveDecimalDivideType`；自定义算子也可以提供自己的返回类型推导，不能假设一定调用该类型系统方法。`maximumDeclaredDecimalPrecision` 限制正式数量输出，不等于插件已证明任何中间除法策略，也不替插件决定工作类型。
+
+除法的原生计算与最终数量输出是两个位置。`ResultNumeric` 的 DECIMAL precision／scale／rounding 在该表达式完成后应用；当前 `division` 入口不接收外围 `MetricValueContract`。例如原生 `DECIMAL(38,0) / BIGINT` 已舍入为六位商，再 CAST 成 DECIMAL(38,18)，只会增加尾零，不能兑现要求十八位 HALF_UP 的数学商。外层类型容量、BigDecimal 解码及结果保存都不能恢复已经丢失的信息；原生 AVG 的 `decimalAverageRounding` 与显式 SUM／COUNT 的 DIVIDE 无关。
+
+插件应先确定真实后端对所接受输入类型的中间容量、舍入、NULL、零分母与溢出行为，再用一致的类型推导和 AST 映射表达。统一的原生策略若能兑现接受域，可以使用现有入口；尚无保证的精确输入应由自定义除法算子的返回类型推导明确拒绝，不返回猜测类型或静默转浮点。不能只把返回类型声明为 DECIMAL(38,18)，也不能为增大商的 scale 将一个需要三十八个整数位的分子提前窄化为只有二十个整数位的 DECIMAL(38,18)。
+
+原生除法绑定或返回类型推导明确抛出 `IllegalArgumentException`／`UnsupportedOperationException` 时，核心以 `NATIVE_ARITHMETIC_MAPPING_UNAVAILABLE` 交付拒绝，附 `operation=DIVIDE` 及两个实际 `inputTypes`。错误不包含插件私有 cause 原文，不执行来源 SQL；作者的非数值输入先按表达式合同拒绝。这个错误说明映射没有建立，不将未知算术写成数据已经违例，也不代表核心能够自动验证一个已经返回成功的原生算子。
+
+下面是尚未建立任何原生除法保证时的明确拒绝方式；建立真实映射后，替换的是同一个算子的类型推导和原生 AST 实现，不在运行失败后切换策略：
+
+```kotlin
+override val division: SqlOperator = SqlBinaryOperator(
+    "/", SqlKind.DIVIDE, 60, true,
+    SqlReturnTypeInference { binding ->
+        val inputs = (0 until binding.operandCount).map { binding.getOperandType(it).fullTypeString }
+        throw UnsupportedOperationException("native division mapping is not established for $inputs")
+    },
+    null, OperandTypes.NUMERIC_NUMERIC
+)
+```
+
+方言 `prepareUnparse(RexNode)` 可以观察仍有类型的 AST；目标 CAST 的 precision／scale 不携带完整业务舍入政策。不能靠反查生成 SQL 或猜目标类型重建该政策，也不能把外围输出量化自动应用到所有嵌套除法：`ROUND((a/b)*c,s)` 与先量化 `a/b` 再乘 `c` 并不普遍等价。只有提供了可兑现的后端策略、并具体说明其必须取得而现有入口确实不提供的信息后，才能据此判断需要的通用扩展。核心不以最终类型合规或少量正常值样本替来源证明算术。
+
 只读属性 `CompilationSupport.parameterSubmission` 必须明确声明 `BIND_PARAMETERS` 或 `TYPED_LITERALS`。前者保留有序参数，后者通过 `parameterLiteral` 将已校验值映射成 SQL AST 字面量并保留编译类型 CAST；共同默认映射覆盖参数编码中的精确数值、文本、布尔与时间值，后端特殊映射由插件明确实现。主查询、关系检查和候选值均使用该选择，不做问号文本替换或运行失败后的自动切换。
 
 `CORRELATED_DERIVED_PROJECTION` 声明派生关系的投影能引用外层查询值。普通 `EXISTS` 条件相关不要求这项能力；数量合同的行内求值槽若必须把外层人口条件绑定在派生投影中，则按本次实际构造检查。缺失时在提交 SQL 前抛出 `NativeCompilationCapabilityException`，公开错误 `NATIVE_COMPILATION_CAPABILITY_MISSING` 包含 `capability` 与 `operation=NUMERIC_EVALUATION_BINDING`。插件依据真实后端行为声明，它不代表来源事务或快照能力。内核不删除人口保护、不重复内联检查，也不在执行失败后切换方案。DuckDB 声明此能力；当前 H2 不声明。
@@ -63,7 +86,13 @@ AVG 的类型容量、算术正确性与舍入必须共同成立。`typeSystem.d
 
 `MetricValueContract.Arithmetic` 区分 `EXACT_DECIMAL`、带结果域及误差容差的 `NATIVE_APPROXIMATION`，以及不声明结果域或误差界限的 `NATIVE_FLOATING`。后者仍核验容量、有限值及溢出，不能经 CAST 或 DECIMAL 结果类型取得输入没有的精确性或容差保证。插件的原生结果类型与算术保证必须分别如实声明。
 
-表达式 `NATIVE_CALL` 保存精确 `connectorRef`、函数 `function` 和 `arguments`。`SCALAR` 参数携带完整 `expression`；`PHYSICAL_TABLE` 参数携带 `physicalTableId/physicalTableVersion`，它是需要冻结与核验的真实物理依赖，不是表名字符串或任意 SQL。`nativeScalarCall` 只负责把核心校验后的 `ScalarArgument(SqlNode)`、`TableArgument(qualifiedPath)` 映射为后端 SQL AST，不接管业务关系规划。
+来源表达式 `SemanticExpression.NativeCall` 保存精确 `connectorRef`、函数 `function` 和 `arguments`。`SCALAR` 参数携带完整 `expression`；`PHYSICAL_TABLE` 参数携带 `physicalTableId/physicalTableVersion`，它是需要冻结与核验的真实物理依赖，不是表名字符串或任意 SQL。`nativeScalarCall` 只负责把核心校验后的 `ScalarArgument(SqlNode)`、`TableArgument(qualifiedPath)` 映射为后端 SQL AST，不接管业务关系规划。
+
+完成关系使用 `ResultExpression.ResultNativeCall(connectorRef,function,arguments)`，实参为有序 `List<ResultExpression>`，只接受该精确来源连接器已经声明的纯 `SCALAR` 签名。它能放在 JOIN 后的 `DERIVE`、条件或 `ResultCaseWhen` 分支，直接消费当前结果符号；函数 ID、参数个数、原生类型和返回类型仍经共同原生编译入口核验。`PHYSICAL_TABLE` 依赖留在来源定义及其采用闭包，不能从完成关系新增表读取。发布的阶段表达式授权须允许 `NATIVE_CALL`，参数树继续逐节点核对授权。构造器、封闭变体和局部规则从正式 `describe-script-api` 发现，不另维护节点清单。
+
+需要有条件解析时，把原生调用直接构造在 CASE 的 THEN 内，并把整个 CASE 放在业务要求的关联之后。核心保留该关系位置与分支结构，不把解析提前到独立源投影或在客户端预取；CASE 所有分支仍做静态函数、类型及授权检查，不能用恒假条件隐藏非法调用。插件负责真实后端的格式解释、NULL、解析错误和 CASE 求值行为，包括后端规划期折叠的适用边界；声明函数不等于已通过目标后端的脏输入试验。原生函数不能借此去重 LEFT bag、补零、选最新或改写业务公式。[作者示例](../../../../examples/agent-client/conditional-native-call.olap.kts)展示关联后的条件格式解析构造，不声明内置插件已经提供某个解析函数。
+
+完成关系原生数值结果保留函数声明的原生容量及 `arithmetic`，数量为维数一；它不从函数名推导天、金额或其他业务单位。Measure 实参只允许在 NUMBER→NUMBER 调用中使用：单位须为维数一，原生结果保证须承接输入，不能把近似或原生浮点升级为 Exact。非数值返回的原生调用只消费分类标量，不能通过 NUMBER→TEXT→CAST 擦除数量含义。原生数值调用保留输入的观察与重复度来源；原始逐行实参可形成逐行贡献，已完成的非线性数量不会重新成为原始独立贡献。CAST、`ResultNumeric` 及最终 DECIMAL 形状也不创造精确性、误差容差或单位变换。后续日期差、贡献人口、均值分解、单位与舍入由正式业务模型明确组合。
 
 `SourceSqlRequest.sourceRequirements` 的 `uses` 明确区分 `ROWS` 与 `NATIVE_TABLE`，同一表可以同时具有两种用途。插件保留两者的精确来源和表身份核对；行约束与有限集合核验只对实际行读取要求执行。原生函数随本次 SQL 求值，不在客户端预取结果。
 

package/sdk/LOADER.md

@@ -19,7 +19,7 @@ ConnectorPlugins.load(listOf(Path.of("/deployment/connectors/backend/manifest.js
 }
 ```
 
-`ConnectorPlugins` 位于 `com.olap.prototype.connector.loader`。`load(List<Path>)` 接收明确的 manifest 列表。完整服务从部署配置读取这些路径，Go 按本次工作所需的精确来源启动工作进程，Kotlin 装载对应插件；业务工具不接受 manifest 路径或插件文件。
+`ConnectorPlugins` 位于 `com.olap.prototype.connector.loader`。`load(List<Path>)` 接收明确的 manifest 列表。完整服务从部署配置读取这些路径，主服务按本次工作所需的精确来源启动工作进程，工作入口装载对应插件；业务工具不接受 manifest 路径或插件文件。
 
 每个 manifest 的 JAR 位于其所在目录，文件名不得包含目录分隔符；实际路径不能越出该组。装载器核每个 JAR 的 SHA-256、完整组摘要、API 版本与 provider 身份，每组只允许一个 provider，注册表拒绝重复精确引用。装载器取得 CompilationSupport 和 SourceAccess；JDBC 实现自行核验驱动，HTTP 实现不要求驱动。发现与编译阶段不连接业务源。