@loxtep/sdk 0.9.20 → 0.9.22

package/docs/sdk-mcp-mapping.md

@@ -50,7 +50,8 @@ Low-level workflow writer escape hatch: `client.build.get_writer(workflow_id, {
 
 Vocabulary: MCP `loxtep_build` trigger operations (backend: connections) and target operations
 (backend: consumptions). Connector OAuth uses `get_oauth_url`; connectivity
-probe uses `test_connector` / `loxtep connectors test <id>`; sample capture uses
+probe uses `test_connector` / `loxtep connectors test <id>`; entity discovery uses
+`list_connector_entities` / `loxtep connectors list-entities <id>`; sample capture uses
 `capture_samples` / `loxtep connectors capture-samples <id> --entity-type <name>`.
 
 When unsure: **MCP for provisioning and agent tool calls**; **SDK/CLI for runtime**.
@@ -155,16 +156,37 @@ single-id PUT (no dedicated batch REST).
 | reject | `.reject(semantic_proposal_id, { resolution_note? })` | `PUT …` `disposition: rejected` |
 | batch accept / reject | `.accept_batch` / `.reject_batch` | N× PUT |
 
-## Meaning: semantic bundles (Phase 2)
+## Meaning: semantic bundles + packages
 
 | MCP operation | SDK | REST |
 | --- | --- | --- |
-| `import_semantic_bundle` | `client.meaning.bundles.import({ bundle, dry_run? })` | `POST /semantic-layer/bundles/import` |
+| `import_semantic_bundle` | `client.meaning.bundles.import({ bundle, dry_run?, activation?, package_id? })` | `POST /semantic-layer/bundles/import` |
+| `export_semantic_bundle` | `client.meaning.bundles.export({ …filters })` | `GET /semantic-layer/bundles/export` |
+| `save_semantic_package` | `client.meaning.packages.save({ bundle, … })` | `POST /semantic-layer/packages` `action=save` |
+| `plan_semantic_package` | `.plan({ package_id, revision })` | `action=plan` |
+| `approve_semantic_package` | `.approve({ package_id, revision, content_hash })` | `action=approve` |
+| `deploy_semantic_package` | `.deploy({ package_id, revision, content_hash })` | `action=deploy` |
+| `verify_semantic_package` | `.verify({ package_id, revision, include_r2rml? })` | `action=verify` |
+| `get_semantic_package_status` | `.status({ package_id, revision? })` | `action=status` |
+| `import_external_semantic_package` | `.import_external({ format, content, … })` | `action=import_external` |
+
+Default import `activation` is `stage` (package revision + approval). Use
+`activation: 'deploy'` only for legacy immediate apply. Phase 0 error contract:
+result always includes `skipped_count` and `errors`. Staged / dry_run responses
+are not treated as failures when plan skips exist.
+
+## Build: query_trigger preview / run (D14)
+
+MCP `loxtep_build` ops for enrichment SQL derivation (`workflow.json` →
+`trigger.query_trigger`). SDK surface: `client.build.workflows`.
+
+| MCP operation | SDK | CLI |
+| --- | --- | --- |
+| `preview_query_trigger` | `client.build.workflows.preview_query_trigger({ workflow_id, query?, primary_key?, limit? })` | `loxtep workflows preview-query-trigger --workflow-id <uuid> [--query] [--limit] [--primary-key a,b]` |
+| `run_query_trigger` | `client.build.workflows.run_query_trigger({ workflow_id, query?, primary_key?, sink_data_product_id? })` | `loxtep workflows run-query-trigger --workflow-id <uuid> [--sink-data-product-id]` |
 
-Phase 0 error contract: result always includes `skipped_count` and `errors`.
-When skips/errors exist (or HTTP 207/422 with a parseable body), the SDK sets
-`partial: true` and still returns the result instead of dropping error detail.
-MCP-only sibling: `export_semantic_bundle` (no SDK yet).
+These call `POST /ai/mcp/tools/call` with facade `loxtep_build` (no dedicated REST
+in this release). Requires a saved enrichment workflow with `trigger.query_trigger`.
 
 ## Define: domain shapes (Phase 2)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loxtep/sdk",
-  "version": "0.9.20",
+  "version": "0.9.22",
   "description": "Loxtep SDK for Node.js — the Enterprise Context Layer: data products, workflows, projects, queues, and machine-usable context for AI",
   "author": "Loxtep <engineering@loxtep.io>",
   "homepage": "https://loxtep.io",
@@ -58,7 +58,7 @@
   "keywords": [
     "loxtep",
     "sdk",
-    "data-mesh",
+    "ai-agents",
     "streaming",
     "data-products",
     "event-streaming"