feat: propose HTTP Arrow execution profile and TypeScript client

.github/workflows/execution-client-ci.yml

@@ -0,0 +1,90 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you 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
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+#
+
+name: Execution Client CI
+
+on:
+  push:
+    branches: ["main"]
+    paths:
+      - "typescript/execution/**"
+      - "examples/execution-adbc/**"
+      - "docs/proposals/execute-query-http.md"
+      - "docs/proposals/execution-http/**"
+      - ".github/workflows/execution-client-ci.yml"
+  pull_request:
+    branches: ["main"]
+    paths:
+      - "typescript/execution/**"
+      - "examples/execution-adbc/**"
+      - "docs/proposals/execute-query-http.md"
+      - "docs/proposals/execution-http/**"
+      - ".github/workflows/execution-client-ci.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: ["22", "24"]
+    defaults:
+      run:
+        working-directory: typescript/execution
+    steps:
+      - name: Checkout project
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Set up Node.js
+        uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+          cache-dependency-path: typescript/execution/package-lock.json
+      - name: Install locked dependencies
+        run: npm ci
+      - name: Check types, contract and client
+        run: npm test
+      - name: Exercise a real browser
+        if: matrix.node-version == '24'
+        run: |
+          export OSSIE_BROWSER_BINARY="$(command -v google-chrome)"
+          test -n "$OSSIE_BROWSER_BINARY"
+          npm run test:browser
+      - name: Set up Python for ADBC example
+        if: matrix.node-version == '24'
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.13"
+      - name: Install uv
+        if: matrix.node-version == '24'
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          version: "0.12.19"
+      - name: Exercise ADBC-to-TypeScript materialization
+        if: matrix.node-version == '24'
+        working-directory: .
+        run: |
+          uv run --frozen --project examples/execution-adbc pytest examples/execution-adbc
+          uv run --frozen --project examples/execution-adbc python examples/execution-adbc/demo.py --output "$RUNNER_TEMP/ossie-adbc-capture"
+          node examples/execution-adbc/verify-client.mjs "$RUNNER_TEMP/ossie-adbc-capture"

.gitignore

@@ -24,6 +24,7 @@
 **/coverage.xml
 **/htmlcov/
 **/dist/
+**/node_modules/
 **/target/
 **/.tom/
 *.py[cod]

README.md

@@ -31,6 +31,7 @@ Apache Ossie provides a single JSON- and YAML-based specification that any tool
 - [`examples/`](examples/) — Example semantic models, including a complete TPC-DS model.
 - [`validation/`](validation/) — Tooling for validating semantic models against the Ossie schema.
 - [`docs/`](docs/) — Project documentation and overview.
+- [`typescript/execution/`](typescript/execution/) — Experimental browser-first HTTP/Arrow execution client for the [proposed Layer 3 execution profile](docs/proposals/execute-query-http.md), not an adopted standard or query engine.
 
 Reference converters that translate between Ossie and other semantic formats (e.g., dbt, GoodData, Polaris, Salesforce) live in the [apache/ossie-converters](https://github.com/apache/ossie-converters) repository.
 

docs/index.md

@@ -63,6 +63,15 @@ The specification supports multiple SQL dialects (`ANSI_SQL`, `SNOWFLAKE`, `DATA
 
 For the full specification, see [core-spec/spec.md](../core-spec/spec.md). For validation tooling, see [validation/validate.py](../validation/validate.py). For a complete example, see the [TPC-DS semantic model](../examples/tpcds_semantic_model.yaml).
 
+### Proposed Query Execution Profile
+
+The optional [HTTP/Arrow execution proposal](proposals/execute-query-http.md)
+defines a browser-first binding for model-resolved Layer 3 queries, execution
+status and typed results. Its [experimental TypeScript client](../typescript/execution/README.md)
+implements the proposed wire contract; it is not a query engine, a native vendor
+adapter, or proof of equivalent answers across engines. The profile and its
+Foundation/MCP dependencies remain proposals and do not change core model conformance.
+
 ### Participating Organizations
 
 Ossie is supported by a broad coalition of 50+ organizations across the data ecosystem, including: