lkr-dev-cli 0.0.60__tar.gz → 0.0.61__tar.gz

lkr_dev_cli-0.0.61/.github/workflows/ci.yml

@@ -0,0 +1,108 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: "write"
+      pull-requests: "write"
+      id-token: "write"
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt, llvm-tools-preview
+          targets: wasm32-unknown-unknown
+
+      - name: Install wasm-bindgen-cli
+        run: |
+          curl -fSL https://github.com/wasm-bindgen/wasm-bindgen/releases/download/0.2.129/wasm-bindgen-0.2.129-x86_64-unknown-linux-musl.tar.gz \
+            | tar -xz -C ~/.cargo/bin --strip-components=1 wasm-bindgen-0.2.129-x86_64-unknown-linux-musl/wasm-bindgen
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: latest
+
+      - name: Install dependencies
+        run: |
+          uv sync --extra all
+
+      - name: Run Rust clippy, unit tests, and build extension
+        run: |
+          cargo clippy --manifest-path lkr/schema/rust/Cargo.toml -- -D warnings
+          cargo test --no-default-features --manifest-path lkr/schema/rust/Cargo.toml
+          make schema-rs
+          cargo clippy --manifest-path lkr/codemode/wasm/Cargo.toml -- -D warnings
+          cargo test --manifest-path lkr/codemode/wasm/Cargo.toml
+          make codemode-wasm
+          cd add-ons/codemode-extension && npm install --no-audit --no-fund && npx tsc --noEmit && npm run build
+
+      - name: Run pytest
+        run: |
+          uv run pytest tests/ -v
+          uv run pytest tests/test_schema.py -v --cov=lkr.schema --cov=scripts.schema --cov-report=term-missing
+
+      - name: Run ruff
+        run: |
+          uv run ruff check .
+
+      - name: Run ty
+        run: |
+          uv run ty check
+
+      - name: Get short SHA
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        id: vars
+        run: echo "short_sha=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+
+      - name: Authenticate to Google Cloud
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        uses: google-github-actions/auth@v3
+        with:
+          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
+          project_id: ${{ secrets.GCP_PROJECT_ID }}
+
+      - name: Upload Code Mode WASM bundles to GCS
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        uses: google-github-actions/upload-cloud-storage@v2
+        with:
+          path: dist
+          destination: "${{ secrets.CDN_BUCKET_NAME }}/cli/codemode/${{ steps.vars.outputs.short_sha }}"
+          parent: false
+          process_gcloudignore: false
+
+      - name: Add CDN links to Job Summary and Commit
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          BODY="### 🚀 Code Mode WASM Deployed to CDN (Commit \`${{ steps.vars.outputs.short_sha }}\`)"$'\n\n'
+          for file in dist/*.js; do
+            filename=$(basename "$file")
+            url="https://cdn.lkr.dev/cli/codemode/${{ steps.vars.outputs.short_sha }}/$filename"
+            BODY+="- **$filename**: [\`$url\`]($url)"$'\n'
+          done
+          echo "$BODY" >> $GITHUB_STEP_SUMMARY
+          gh api "/repos/${{ github.repository }}/commits/${{ github.sha }}/comments" -f body="$BODY"

lkr_dev_cli-0.0.61/.github/workflows/release.yml

@@ -0,0 +1,171 @@
+name: Release Docker Image
+
+on:
+  release:
+    types: [created]
+
+env:
+  REGION: us-central1
+  SERVICE_NAME: cli
+  APP_NAME: lkr-cli
+  TAG: ${{ github.event.release.tag_name }}
+  UV_PUBLISH_TOKEN: ${{ secrets.UV_PUBLISH_TOKEN }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: "read"
+      id-token: "write"
+
+    steps:
+      - name: Set IMAGE_NAME
+        run: echo "IMAGE_NAME=${{ env.REGION }}-docker.pkg.dev/${{ secrets.GCP_PROJECT_ID }}/${{ env.APP_NAME }}/${{ env.SERVICE_NAME }}" >> $GITHUB_ENV
+
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Replace version in pyproject.toml
+        run: |
+          find . -name "pyproject.toml" -exec sed -i "s/^version = .*/version = \"${{ env.TAG }}\"/" {} +
+
+      - name: Authenticate to Google Cloud
+        uses: google-github-actions/auth@v3
+        with:
+          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
+          project_id: ${{ secrets.GCP_PROJECT_ID }}
+
+      - name: Set up Cloud SDK
+        uses: google-github-actions/setup-gcloud@v3
+
+      - name: Build and push Docker image
+        run: |
+          # Build and push the image with both the release tag and latest
+          gcloud builds submit . \
+            --project ${{ secrets.GCP_PROJECT_ID }} \
+            --tag ${{ env.IMAGE_NAME }}:${{ env.TAG }} \
+            --gcs-log-dir=gs://${{ secrets.GCP_LOGS_BUCKET_NAME }}/${{ env.APP_NAME }}
+
+      - name: Add latest tag
+        run: |
+          gcloud artifacts docker tags add ${{ env.IMAGE_NAME }}:${{ env.TAG }} \
+            ${{ env.IMAGE_NAME }}:latest \
+            --project ${{ secrets.GCP_PROJECT_ID }}
+
+      - name: Trigger Website Deploy
+        run: |
+            curl -fSL "$DEPLOY_URL"
+        env:
+            DEPLOY_URL: ${{ secrets.DEPLOY_URL }}
+
+  publish:
+    name: python
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Replace version in pyproject.toml
+        run: |
+          find . -name "pyproject.toml" -exec sed -i "s/^version = .*/version = \"${{ env.TAG }}\"/" {} +
+
+      - name: uv sync
+        run: uv sync --frozen --no-dev
+
+      - name: uv build
+        run: uv build
+
+      - name: uv publish
+        run: uv publish
+
+  codemode-wasm:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: "write"
+      id-token: "write"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install wasm-bindgen-cli
+        run: |
+          curl -fSL https://github.com/wasm-bindgen/wasm-bindgen/releases/download/0.2.129/wasm-bindgen-0.2.129-x86_64-unknown-linux-musl.tar.gz \
+            | tar -xz -C ~/.cargo/bin --strip-components=1 wasm-bindgen-0.2.129-x86_64-unknown-linux-musl/wasm-bindgen
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Build Code Mode WASM and Looker Extension bundles
+        run: |
+          make codemode-wasm
+          cd add-ons/codemode-extension && npm install --no-audit --no-fund && npm run build
+
+      - name: Authenticate to Google Cloud
+        uses: google-github-actions/auth@v3
+        with:
+          workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
+          project_id: ${{ secrets.GCP_PROJECT_ID }}
+
+      - name: Set up Cloud SDK
+        uses: google-github-actions/setup-gcloud@v3
+
+      - name: Upload to GCS (Tagged Version)
+        uses: google-github-actions/upload-cloud-storage@v2
+        with:
+          path: dist
+          destination: "${{ secrets.CDN_BUCKET_NAME }}/cli/codemode/${{ env.TAG }}"
+          parent: false
+          process_gcloudignore: false
+
+      - name: Upload to GCS (Latest)
+        uses: google-github-actions/upload-cloud-storage@v2
+        with:
+          path: dist
+          destination: "${{ secrets.CDN_BUCKET_NAME }}/cli/codemode/latest"
+          parent: false
+          process_gcloudignore: false
+
+      - name: Invalidate Cloud CDN Cache
+        run: |
+          gcloud compute url-maps invalidate-cdn-cache "${{ secrets.CDN_LOAD_BALANCER_NAME }}" \
+            --path "/cli/codemode/latest/*" \
+            --project "${{ secrets.GCP_PROJECT_ID }}" \
+            --async
+
+      - name: Upload assets and update GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release upload "${{ env.TAG }}" dist/*.js --clobber
+          LINKS="### 🚀 Code Mode WASM CDN Links"$'\n'
+          for ver in "${{ env.TAG }}" latest; do
+            LINKS+=$'\n'"#### \`$ver\`"$'\n'
+            for file in dist/*.js; do
+              filename=$(basename "$file")
+              url="https://cdn.lkr.dev/cli/codemode/$ver/$filename"
+              LINKS+="- **$filename**: [\`$url\`]($url)"$'\n'
+            done
+          done
+          echo "$LINKS" >> $GITHUB_STEP_SUMMARY
+          CURRENT_BODY=$(gh release view "${{ env.TAG }}" --json body --jq .body)
+          NEW_BODY="${CURRENT_BODY}"$'\n\n'"${LINKS}"
+          gh release edit "${{ env.TAG }}" --notes "$NEW_BODY"

{lkr_dev_cli-0.0.60 → lkr_dev_cli-0.0.61}/.gitignore

@@ -4,6 +4,9 @@ __pycache__
 tmp
 .env
 lkr/schema/rust/target/
+lkr/codemode/wasm/target/
+dist/
+node_modules/
 coverage.xml
 .coverage
 *.profraw

lkr_dev_cli-0.0.61/.nvmrc

@@ -0,0 +1 @@
+v24.21.0

{lkr_dev_cli-0.0.60 → lkr_dev_cli-0.0.61}/Makefile

@@ -1,4 +1,4 @@
-.PHONY: docs test-deps codemode-test codemode-start schema-rs test-rs coverage-py coverage-rs coverage
+.PHONY: docs test-deps codemode-test codemode-start codemode-wasm schema-rs test-rs coverage-py coverage-rs coverage
 
 docs:
 	uv run --frozen --extra all typer lkr/main.py utils docs --output lkr.md
@@ -12,9 +12,14 @@ codemode-test:
 schema-rs:
 	cargo build --release --manifest-path lkr/schema/rust/Cargo.toml && cp lkr/schema/rust/target/release/lib_schema_rs.so lkr/schema/_schema_rs.so
 
+codemode-wasm:
+	uv run python scripts/build_codemode_wasm.py
+
 test-rs:
 	cargo clippy --manifest-path lkr/schema/rust/Cargo.toml -- -D warnings
 	cargo test --no-default-features --manifest-path lkr/schema/rust/Cargo.toml
+	cargo clippy --manifest-path lkr/codemode/wasm/Cargo.toml -- -D warnings
+	cargo test --manifest-path lkr/codemode/wasm/Cargo.toml
 
 coverage-py:
 	uv run --frozen --extra all pytest tests/ --ignore=tests/test_dependency_resolution.py --cov=lkr/schema --cov=scripts/schema --cov-report=term-missing --cov-report=xml:coverage.xml

{lkr_dev_cli-0.0.60 → lkr_dev_cli-0.0.61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: lkr-dev-cli
-Version: 0.0.60
+Version: 0.0.61
 Summary: lkr: a command line interface for looker
 Author: bwebs
 License-Expression: MIT
@@ -574,15 +574,39 @@ uvx lkr-dev-cli tools agents delete <agent_id> \
 
 ### Generating an A2A Agent Card
 
-`lkr tools agents card` generates an **Agent-to-Agent** (**A2A**) `0.3.0` Agent Card JSON file (`looker-<agent_id>-agent-card.json`) from your Looker agent's name, description, Explore sources, and active golden queries (omitting internal instructions unless `--include-instructions` is set, or replacing `skills[]` via `--skills-file`). Looker `26.10.0+` is required (`26.2.0` added the initial route and `26.6.0` added SSE, with default enablement and instruction support in `26.10.0+`).
+`lkr tools agents card` generates an **Agent-to-Agent** (**A2A**) `0.3.0` Agent Card JSON file (`looker-<agent_id>-agent-card.json`) from your Looker agent's name, description, Explore sources (`tags`), and active golden queries (`examples`). Looker `26.10.0+` is required (`26.2.0` added the initial route and `26.6.0` added SSE, with default enablement and instruction support in `26.10.0+`).
+
+Because Looker agents do not store a dedicated A2A routing summary ("when should another agent call this endpoint?"), `card` handles `skills[]` in three ways while preserving Looker's active golden queries as `examples` unless overridden:
+
+1. **Interactive prompt (default)**: Keeps Looker's `agent.description` on `card.description` and prompts for `skills[0].description` (press Enter to reuse Looker's description).
+2. **Looker project file (`--project-id` + `--skills-file`)**: Reads a JSON skill object or array stored inside a Looker project (for example, `agents/ecommerce_skill.json`), merges any omitted `tags` or `examples` from the Looker agent, and writes `looker-<agent_id>-agent-card.json`.
+3. **Local file (`--skills-file`)**: Reads a JSON skill object or array from local disk.
+
+For example, store `agents/ecommerce_skill.json` in your Looker project (`thelook`):
+
+```json
+{
+  "id": "orders-and-revenue",
+  "name": "Orders & Revenue",
+  "description": "Route here when the user asks about order volume, GMV, returns, or brand performance."
+}
+```
+
+Then read that skill file from Looker and write `looker-<agent_id>-agent-card.json`:
 
 ```bash
-# Fetch agent metadata from Looker and write looker-<agent_id>-agent-card.json (OAuth2 default)
+# Read skill JSON from a Looker project (pass `lkr --dev` before `tools` if only on your dev branch) and write looker-<agent_id>-agent-card.json
+uvx lkr-dev-cli tools agents card <agent_id> \
+  --project-id thelook \
+  --skills-file agents/ecommerce_skill.json
+
+# Interactive prompt for skills[0].description (OAuth2 default), or read a local skills JSON file
 uvx lkr-dev-cli tools agents card <agent_id>
+uvx lkr-dev-cli tools agents card <agent_id> --skills-file ./skills.json
 
 # Build a bearer-token card offline (zero Looker API calls) and print to stdout
 uvx lkr-dev-cli --base-url https://acme.cloud.looker.com \
-  tools agents card <agent_id> --offline --auth bearer -o -
+  tools agents card <agent_id> --offline --description "Routes order and revenue questions." --auth bearer -o -
 ```
 
 Example `looker-<agent_id>-agent-card.json` output (`--auth oauth2`, default):

{lkr_dev_cli-0.0.60 → lkr_dev_cli-0.0.61}/README.md

@@ -535,15 +535,39 @@ uvx lkr-dev-cli tools agents delete <agent_id> \
 
 ### Generating an A2A Agent Card
 
-`lkr tools agents card` generates an **Agent-to-Agent** (**A2A**) `0.3.0` Agent Card JSON file (`looker-<agent_id>-agent-card.json`) from your Looker agent's name, description, Explore sources, and active golden queries (omitting internal instructions unless `--include-instructions` is set, or replacing `skills[]` via `--skills-file`). Looker `26.10.0+` is required (`26.2.0` added the initial route and `26.6.0` added SSE, with default enablement and instruction support in `26.10.0+`).
+`lkr tools agents card` generates an **Agent-to-Agent** (**A2A**) `0.3.0` Agent Card JSON file (`looker-<agent_id>-agent-card.json`) from your Looker agent's name, description, Explore sources (`tags`), and active golden queries (`examples`). Looker `26.10.0+` is required (`26.2.0` added the initial route and `26.6.0` added SSE, with default enablement and instruction support in `26.10.0+`).
+
+Because Looker agents do not store a dedicated A2A routing summary ("when should another agent call this endpoint?"), `card` handles `skills[]` in three ways while preserving Looker's active golden queries as `examples` unless overridden:
+
+1. **Interactive prompt (default)**: Keeps Looker's `agent.description` on `card.description` and prompts for `skills[0].description` (press Enter to reuse Looker's description).
+2. **Looker project file (`--project-id` + `--skills-file`)**: Reads a JSON skill object or array stored inside a Looker project (for example, `agents/ecommerce_skill.json`), merges any omitted `tags` or `examples` from the Looker agent, and writes `looker-<agent_id>-agent-card.json`.
+3. **Local file (`--skills-file`)**: Reads a JSON skill object or array from local disk.
+
+For example, store `agents/ecommerce_skill.json` in your Looker project (`thelook`):
+
+```json
+{
+  "id": "orders-and-revenue",
+  "name": "Orders & Revenue",
+  "description": "Route here when the user asks about order volume, GMV, returns, or brand performance."
+}
+```
+
+Then read that skill file from Looker and write `looker-<agent_id>-agent-card.json`:
 
 ```bash
-# Fetch agent metadata from Looker and write looker-<agent_id>-agent-card.json (OAuth2 default)
+# Read skill JSON from a Looker project (pass `lkr --dev` before `tools` if only on your dev branch) and write looker-<agent_id>-agent-card.json
+uvx lkr-dev-cli tools agents card <agent_id> \
+  --project-id thelook \
+  --skills-file agents/ecommerce_skill.json
+
+# Interactive prompt for skills[0].description (OAuth2 default), or read a local skills JSON file
 uvx lkr-dev-cli tools agents card <agent_id>
+uvx lkr-dev-cli tools agents card <agent_id> --skills-file ./skills.json
 
 # Build a bearer-token card offline (zero Looker API calls) and print to stdout
 uvx lkr-dev-cli --base-url https://acme.cloud.looker.com \
-  tools agents card <agent_id> --offline --auth bearer -o -
+  tools agents card <agent_id> --offline --description "Routes order and revenue questions." --auth bearer -o -
 ```
 
 Example `looker-<agent_id>-agent-card.json` output (`--auth oauth2`, default):

lkr_dev_cli-0.0.61/add-ons/codemode-extension/manifest.lkml

@@ -0,0 +1,15 @@
+project_name: "lkr-codemode-extension"
+
+application: lkr-codemode {
+  label: "Looker Code Mode"
+  url: "https://cdn.lkr.dev/cli/codemode/latest/codemode_extension.js"
+  # url: "https://localhost:8080/codemode_extension.js"
+  mount_points: {
+    standalone: yes
+  }
+  entitlements: {
+    raw_api_request: yes
+    use_iframes: yes
+    use_form_submit: yes
+  }
+}