@loxtep/sdk 0.7.6 → 0.7.9

package/CHANGELOG.md

@@ -6,6 +6,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.9] - 2026-07-23
+
+### Fixed
+
+- **Browser login** no longer hangs after printing success: the localhost callback
+  server now destroys keep-alive connections and closes immediately so the CLI
+  process exits as soon as tokens are saved.
+
+## [0.7.8] - 2026-07-23
+
+### Changed
+
+- **README and quick reference** use customer-facing API area names instead of
+  internal MCP facade terminology (`loxtep_session`, "MCP-aligned facades", etc.).
+  SDK paths (`client.build`, …) are unchanged.
+
+## [0.7.7] - 2026-07-23
+
+### Changed
+
+- **CLI help** no longer exposes internal MCP facade names (`loxtep_session`,
+  `client.build`, etc.). Commands are grouped under customer-facing headings
+  (Authentication, Workspace, Build & deploy, Governance, …).
+
 ## [0.7.6] - 2026-07-23
 
 ### Added

package/README.md

@@ -1,27 +1,26 @@
 # Loxtep Node.js SDK
 
-Client for the Loxtep API. Since **v0.7.0**, the public surface mirrors the
-**10 hosted MCP tool facades** (no flat top-level namespaces like
+Client for the Loxtep API. Since **v0.7.0**, `LoxtepClient` groups APIs under
+**namespaced areas** on the client (no flat top-level namespaces like
 `client.workflows` or `client.data_products`).
 
-| MCP facade | SDK namespace | Examples |
+| Area | SDK namespace | Examples |
 | --- | --- | --- |
-| `loxtep_session` | `client.session` | `get_current_user()` |
-| `loxtep_connect` | `client.connect` | `.connectors.*`, `.templates.*` |
-| `loxtep_workspace` | `client.workspace` | `.projects.*`, `.instances.*` |
-| `loxtep_build` | `client.build` | `.workflows.*`, `.triggers.*`, `.data_products.*`, `.targets.*` |
-| `loxtep_define` | `client.define` | `.schemas.*`, `.quality.*`, `.domains.*`, … |
-| `loxtep_meaning` | `client.meaning` | `.thesaurus.*` |
-| `loxtep_review` | `client.review` | `.approvals.*`, `.improvements.*` |
-| `loxtep_query` | `client.query` | `.catalog.*`, `.discovery.*`, `.query()` |
-| `loxtep_observe` | `client.observe` | `.stream_config()`, `.open_reader()` |
-| `loxtep_context` | `client.context` | `.procedures.*`, `.activity.*`, … |
-
-**Stream I/O** uses top-level helpers (not nested under a facade):
+| Authentication | `client.session` | `get_current_user()` |
+| Connect | `client.connect` | `.connectors.*`, `.templates.*` |
+| Workspace | `client.workspace` | `.projects.*`, `.instances.*` |
+| Build & deploy | `client.build` | `.workflows.*`, `.triggers.*`, `.data_products.*`, `.targets.*` |
+| Governance | `client.define` | `.schemas.*`, `.quality.*`, `.domains.*`, … |
+| Semantics | `client.meaning` | `.thesaurus.*` |
+| Review | `client.review` | `.approvals.*`, `.improvements.*` |
+| Analytics | `client.query` | `.catalog.*`, `.discovery.*`, `.query()` |
+| Observe | `client.observe` | `.stream_config()`, `.open_reader()` |
+| Context | `client.context` | `.procedures.*`, `.activity.*`, … |
+
+**Stream I/O** uses top-level helpers on the client:
 `await client.get_writer('data-product-name')` and
 `await client.get_reader('data-product-name')`.
 
-Full mapping table: [`docs/sdk-mcp-mapping.md`](./docs/sdk-mcp-mapping.md).
 **Upgrading from 0.6.x:** replace `client.data_products` →
 `client.build.data_products` (CRUD/stream/replay) or `client.get_writer` /
 `client.get_reader` (recommended write/read path); `client.workflows` →
@@ -163,18 +162,18 @@ See `loxtep init --help`, `loxtep attach --help`, etc. for all flags. The full C
 
 ## API surface
 
-Every method is `snake_case`. Use the **10 MCP-aligned facades** on
-`LoxtepClient` (see table at the top). Nested APIs keep descriptive names
-(`workflows`, `data_products`, `connectors`, …) under their facade.
+Every method is `snake_case`. APIs live on **namespaced areas** of
+`LoxtepClient` (see table at the top). Nested APIs use descriptive names
+(`workflows`, `data_products`, `connectors`, …) under each area.
 
 ### Top-level stream I/O (preferred)
 
 - **`get_writer(name_or_id)`** — write path; resolves queue, bot, stream config
 - **`get_reader(name_or_id)`** — async iterable read path
 - **`LoxtepClient.fromWorkspace()`** — construct from `.loxtep/project.json` +
-  `~/.loxtep/credentials.json` (env overrides: `LOXTEP_API_URL`, `LOXTEP_TOKEN`, …)
+  `./.loxtep/credentials.json` (env overrides: `LOXTEP_API_URL`, `LOXTEP_TOKEN`, …)
 
-### `client.build` (MCP: loxtep_build)
+### Build & deploy (`client.build`)
 
 - **`.workflows`** — `list`, `get`, `create`, `get_graph`, `deploy`; low-level
   `.get_writer(workflow_id, { bot_id, … })` escape hatch
@@ -184,30 +183,30 @@ Every method is `snake_case`. Use the **10 MCP-aligned facades** on
   `client.get_writer` / `get_reader`)
 - **`.targets`** — delivery sink bindings (`list`, `get`, `create`, `update`, `delete`)
 
-### `client.connect` (MCP: loxtep_connect)
+### Connect (`client.connect`)
 
 - **`.connectors`** — org-level connector credentials
 - **`.templates`** — starter templates (`list`, `get`, `apply_template` on projects)
 
-### `client.workspace` (MCP: loxtep_workspace)
+### Workspace (`client.workspace`)
 
 - **`.projects`** — `list`, `get`, `create`, `update`, `delete`, `apply_template`
 - **`.instances`** — `list`, `get`, stream config helpers
 
-### `client.define` (MCP: loxtep_define)
+### Governance (`client.define`)
 
 - **`.schemas`**, **`.quality`**, **`.standards`**, **`.data_contracts`**, **`.domains`**
 
-### `client.query` (MCP: loxtep_query)
+### Analytics (`client.query`)
 
 - **`.catalog`**, **`.discovery`**, **`.query()`**, **`.list_tables()`**, **`.search()`**
 
-### `client.observe` (MCP: loxtep_observe)
+### Observe (`client.observe`)
 
 - **`status()`**, **`stream_config()`**, **`open_reader()`**, **`open_writer()`**,
   **`get_queue_metadata()`**, **`get_reader_checkpoint()`**
 
-### Other facades
+### Authentication, semantics, review, and context
 
 - **`client.session`** — `get_current_user`, `get_current_organization`, `logout`
 - **`client.meaning`** — `.thesaurus.*`
@@ -215,8 +214,6 @@ Every method is `snake_case`. Use the **10 MCP-aligned facades** on
 - **`client.context`** — `.procedures.*`, `.activity.*`, `.process_intelligence.*`
 - **`client.metrics`** — `log`, `get_reporter` (stub until metrics wiring lands)
 
-See [`docs/sdk-mcp-mapping.md`](./docs/sdk-mcp-mapping.md) for the full MCP ↔ SDK table.
-
 ## Data product writer and reader
 
 `await client.get_writer('name')` resolves the data product's queue, bot
@@ -304,8 +301,7 @@ await client.build.targets.delete('dp_abc123', webhook.consumption_id);
 - **[Code-first CLI](./docs/code-first-cli.md)** – `loxtep init`, attach, generate, test, deploy.
 - **[Quick reference](./docs/quick-reference.md)** – Single-page cheat sheet.
 - **[Event replay cookbook](./docs/event-replay-cookbook.md)** – Replay events from a data product or queue.
-- **[MCP + SDK pairing](./docs/sdk-pairing.md)** – One auth story, when MCP vs SDK.
-- **[MCP → SDK mapping](./docs/sdk-mcp-mapping.md)** – Agent-oriented table.
+- **[SDK + agent pairing](./docs/sdk-pairing.md)** – When to use the SDK vs IDE agent integrations.
 - **Typed errors** – `import { … } from '@loxtep/sdk/errors'`.
 - **API reference** – `pnpm run docs` (Typedoc).
 

package/dist/auth/browser-login.d.ts

@@ -12,6 +12,8 @@
  * 4. App redirects to our localhost callback with access_token + refresh_token
  * 5. Return tokens to caller, shut down server
  */
+import { type Server } from 'node:http';
+import type { Socket } from 'node:net';
 export interface BrowserLoginOptions {
     /** Loxtep app URL (e.g. https://app.loxtep.io or https://appdev.loxtep.io). */
     app_url: string;
@@ -21,6 +23,8 @@ export interface BrowserLoginOptions {
     timeout_ms?: number;
     /** If true, don't auto-open the browser — just print the URL. */
     no_open?: boolean;
+    /** For tests: invoked once the callback server is listening (with bound port). */
+    on_listening?: (port: number) => void;
 }
 export interface BrowserLoginResult {
     access_token: string;
@@ -33,6 +37,8 @@ export interface BrowserLoginResult {
         expiration: string;
     };
 }
+/** Force-close keep-alive sockets so the CLI process can exit immediately. */
+export declare function shutdownCallbackServer(server: Server, sockets: Set<Socket>): void;
 /**
  * Run the browser-based OAuth login flow.
  * Returns tokens on success, throws on timeout or failure.

package/dist/auth/browser-login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-login.d.ts","sourceRoot":"","sources":["../../src/auth/browser-login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAYD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwFtF"}
+{"version":3,"file":"browser-login.d.ts","sourceRoot":"","sources":["../../src/auth/browser-login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AACjG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKvC,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAID,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CASjF;AAmBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyGtF"}

package/dist/auth/browser-login.js

@@ -16,31 +16,65 @@ import { createServer } from 'node:http';
 import { URL } from 'node:url';
 import { exec } from 'node:child_process';
 import { platform } from 'node:os';
+const CLOSE_HEADERS = { Connection: 'close' };
+/** Force-close keep-alive sockets so the CLI process can exit immediately. */
+export function shutdownCallbackServer(server, sockets) {
+    for (const socket of sockets) {
+        socket.destroy();
+    }
+    sockets.clear();
+    const maybeCloseAll = server;
+    maybeCloseAll.closeAllConnections?.();
+    server.close();
+}
 /**
  * Open a URL in the user's default browser.
  */
 function openBrowser(url) {
     const os = platform();
     const cmd = os === 'darwin' ? 'open' : os === 'win32' ? 'start' : 'xdg-open';
-    exec(`${cmd} "${url}"`);
+    const child = exec(`${cmd} "${url}"`);
+    child.unref?.();
+}
+function finishResponse(res, body, status = 200) {
+    res.writeHead(status, { 'Content-Type': 'text/html', ...CLOSE_HEADERS });
+    res.end(body);
+    res.socket?.destroy();
 }
 /**
  * Run the browser-based OAuth login flow.
  * Returns tokens on success, throws on timeout or failure.
  */
 export function browserLogin(options) {
-    const { app_url, timeout_ms = 300_000, no_open = false } = options;
+    const { app_url, timeout_ms = 300_000, no_open = false, on_listening } = options;
     return new Promise((resolve, reject) => {
         let settled = false;
         let timeoutId;
+        const sockets = new Set();
+        const settleSuccess = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            shutdownCallbackServer(server, sockets);
+            resolve(result);
+        };
+        const settleFailure = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            shutdownCallbackServer(server, sockets);
+            reject(err);
+        };
         const server = createServer((req, res) => {
             const reqUrl = new URL(req.url ?? '/', `http://localhost`);
             if (reqUrl.pathname === '/callback') {
-                // Tokens come as query params from the Loxtep app redirect
                 const access_token = reqUrl.searchParams.get('access_token');
                 const refresh_token = reqUrl.searchParams.get('refresh_token') ?? undefined;
                 const expires_at = reqUrl.searchParams.get('expires_at') ?? undefined;
-                // AWS credentials (optional, URL-encoded JSON)
                 let aws_credentials;
                 const awsCredsParam = reqUrl.searchParams.get('aws_credentials');
                 if (awsCredsParam) {
@@ -52,30 +86,31 @@ export function browserLogin(options) {
                     }
                 }
                 if (!access_token) {
-                    res.writeHead(400, { 'Content-Type': 'text/html' });
-                    res.end('<html><body><h2>Login failed</h2><p>No access token received. Close this window and try again.</p></body></html>');
+                    finishResponse(res, '<html><body><h2>Login failed</h2><p>No access token received. Close this window and try again.</p></body></html>', 400);
                     return;
                 }
-                res.writeHead(200, { 'Content-Type': 'text/html' });
-                res.end('<html><body><h2>Login successful!</h2><p>You can close this window and return to your terminal.</p></body></html>');
-                settled = true;
-                if (timeoutId)
-                    clearTimeout(timeoutId);
-                server.close();
-                resolve({ access_token, refresh_token, expires_at, aws_credentials });
+                finishResponse(res, '<html><body><h2>Login successful!</h2><p>You can close this window and return to your terminal.</p></body></html>');
+                settleSuccess({ access_token, refresh_token, expires_at, aws_credentials });
                 return;
             }
-            // Health check / catch-all
-            res.writeHead(200, { 'Content-Type': 'text/plain' });
+            res.writeHead(200, { 'Content-Type': 'text/plain', ...CLOSE_HEADERS });
             res.end('Loxtep SDK login callback server');
+            res.socket?.destroy();
+        });
+        server.on('connection', socket => {
+            sockets.add(socket);
+            socket.on('close', () => {
+                sockets.delete(socket);
+            });
         });
         server.listen(0, '127.0.0.1', () => {
             const addr = server.address();
             if (!addr || typeof addr === 'string') {
-                reject(new Error('Failed to start callback server'));
+                settleFailure(new Error('Failed to start callback server'));
                 return;
             }
             const port = addr.port;
+            on_listening?.(port);
             const callbackUrl = `http://localhost:${port}/callback`;
             const loginUrl = `${app_url.replace(/\/$/, '')}/auth/mcp?callback_url=${encodeURIComponent(callbackUrl)}`;
             if (no_open) {
@@ -89,19 +124,12 @@ export function browserLogin(options) {
             console.log('Waiting for login to complete...');
         });
         server.on('error', err => {
-            if (!settled) {
-                settled = true;
-                reject(new Error(`Callback server error: ${err.message}`));
-            }
+            settleFailure(new Error(`Callback server error: ${err.message}`));
         });
-        // Timeout
         timeoutId = setTimeout(() => {
-            if (!settled) {
-                settled = true;
-                server.close();
-                reject(new Error(`Login timed out after ${timeout_ms / 1000} seconds. Try again.`));
-            }
+            settleFailure(new Error(`Login timed out after ${timeout_ms / 1000} seconds. Try again.`));
         }, timeout_ms);
+        timeoutId.unref?.();
     });
 }
 //# sourceMappingURL=browser-login.js.map

package/dist/auth/browser-login.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-login.js","sourceRoot":"","sources":["../../src/auth/browser-login.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browser-login.js","sourceRoot":"","sources":["../../src/auth/browser-login.ts"],"names":[],"mappings":"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"}

package/dist/cli/help.d.ts

@@ -1,5 +1,5 @@
 /**
- * Top-level CLI help, grouped by MCP-aligned SDK facades (v0.7+).
+ * Top-level CLI help — customer-facing command groups (no internal MCP facade names).
  */
 export declare const CLI_HELP: string;
 export declare function printCliHelp(): void;

package/dist/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,QAAQ,QA4EV,CAAC;AAEZ,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,QAAQ,QA0EV,CAAC;AAEZ,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/cli/help.js

@@ -1,5 +1,5 @@
 /**
- * Top-level CLI help, grouped by MCP-aligned SDK facades (v0.7+).
+ * Top-level CLI help — customer-facing command groups (no internal MCP facade names).
  */
 export const CLI_HELP = `
 Loxtep — the Enterprise Context Layer.
@@ -8,15 +8,13 @@ Turns organizational knowledge, expertise, and norms into machine-usable context
 Usage: loxtep <command> [subcommand] [options]
        loxtep --version | loxtep -V
 
-Commands mirror the 10 SDK / MCP facades (see docs/sdk-mcp-mapping.md).
-
-Session (client.session · loxtep_session)
+Authentication
   login              Log in (browser by default; --console for email/password/TOTP)
                      Saves to ./.loxtep/credentials.json by default (--global for ~/.loxtep)
   logout             Remove stored credentials (--local / --global to force scope)
   whoami             Print current user and organization
 
-Workspace (client.workspace · loxtep_workspace)
+Workspace
   init [--template <slug>] [--create-repo | --from-repo <url>]
                      Scaffold .loxtep/project.json + domains/, connectors/, workflows/, data-products/
   attach [--instance <id>]
@@ -25,7 +23,7 @@ Workspace (client.workspace · loxtep_workspace)
   instances list | get <id> | create … | deployment-urls | register … | registration
                      Provision and register runtime instances
 
-Build (client.build · loxtep_build)
+Build & deploy
   test <module> --event <file>
                      Run a workflow module locally (action trace)
   deploy             Compile workflow modules and deploy to the attached instance
@@ -36,32 +34,32 @@ Build (client.build · loxtep_build)
   data-products list | get <id> | create … | readiness <id> | promote <id> --target …
                      Data product CRUD and medallion promotion
 
-Define (client.define · loxtep_define)
+Governance
   domains list | get <id>
-  standards list | get <id>              Governance standards (policies)
+  standards list | get <id>              Standards (policies)
   data-contracts list | get <id> | create …
 
-Review (client.review · loxtep_review)
+Review
   improvements list [--status …] [--workflow <name>]
   improvements apply <id> | reject <id>  Adopt or reject AI-eval workflow improvements
 
-Query (client.query · loxtep_query)
+Analytics
   data-products query <id> "SQL" | --file <path>
   data-products tables <id>              List tables for analytics SQL
 
-Observe (client.observe · loxtep_observe)
-  observe status                         Platform / instance observe snapshot
+Observe
+  observe status                         Platform / instance health snapshot
   queue info <data-product-id> | --queue <name>
   queue checkpoint <id> --bot <bot-id>   Reader checkpoint for a bot
   metrics rate-limits | log --id <id> --value <n>
 
-Context (client.context · loxtep_context)
+Activity
   activity list [--source …] [--actor …] [--resource-type …] [--from …] [--to …]
 
-CLI utilities (bootstrap — not an MCP facade)
+Configuration
   config list | paths | set <key> <value>
   config export --from-connector <id> | --from-data-product <id> [--format sh|json|env]
-  bus login                              Bus vs JWT explainer (placeholder)
+  bus login                              Stream bus vs JWT explainer (placeholder)
 
 Examples:
   pnpm exec loxtep login

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EvB,CAAC,OAAO,EAAE,CAAC;AAEZ,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0EvB,CAAC,OAAO,EAAE,CAAC;AAEZ,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC"}

package/dist/cli/index.d.ts

@@ -5,7 +5,7 @@
  * context for AI across heterogeneous systems.
  *
  * Usage: loxtep <command> [options]
- * Help is grouped by MCP-aligned SDK facades — see ./help.ts
+ * Help is grouped by customer-facing command areas — see ./help.ts
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -5,7 +5,7 @@
  * context for AI across heterogeneous systems.
  *
  * Usage: loxtep <command> [options]
- * Help is grouped by MCP-aligned SDK facades — see ./help.ts
+ * Help is grouped by customer-facing command areas — see ./help.ts
  */
 import { runLogin } from './commands/login.js';
 import { runLogout } from './commands/logout.js';

package/dist/cli/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,MAAM,CAUtC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/cli/version.js

@@ -1,18 +1,13 @@
 /**
  * CLI/SDK version from package.json (same semver as `@loxtep/sdk` on npm).
  */
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import pkg from '../../package.json' with { type: 'json' };
 let cachedVersion;
 /** Resolve `@loxtep/sdk` semver from the installed package.json. */
 export function getSdkVersion() {
     if (cachedVersion) {
         return cachedVersion;
     }
-    const here = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join(here, '../../package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
     cachedVersion = pkg.version ?? '0.0.0';
     return cachedVersion;
 }

package/dist/cli/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,aAAiC,CAAC;AAEtC,oEAAoE;AACpE,MAAM,UAAU,aAAa;IAC3B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAC;IAC/E,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,eAAe,aAAa,EAAE,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3D,IAAI,aAAiC,CAAC;AAEtC,oEAAoE;AACpE,MAAM,UAAU,aAAa;IAC3B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,eAAe,aAAa,EAAE,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/docs/getting-started.md

@@ -324,6 +324,5 @@ Now that you've written and read your first event, explore these resources:
 | [Code-first CLI guide](./code-first-cli.md) | `loxtep init`, attach, generate, test, deploy |
 | [Quick Reference Card](./quick-reference.md) | Single-page cheat sheet for common SDK operations |
 | [Event Replay Cookbook](./event-replay-cookbook.md) | Patterns for replaying and reprocessing historical events |
-| [MCP → SDK Mapping](./sdk-mcp-mapping.md) | How MCP tools map to SDK methods |
 
 See the [SDK README](../README.md) for the full API surface.

package/docs/quick-reference.md

@@ -1,7 +1,7 @@
 # SDK Quick Reference Card
 
-Concise cheat sheet for common Loxtep SDK operations (Node.js **v0.7+** MCP
-facades). For full walkthroughs, see the [Getting Started Guide](./getting-started.md)
+Concise cheat sheet for common Loxtep SDK operations (Node.js **v0.7+**).
+For full walkthroughs, see the [Getting Started Guide](./getting-started.md)
 (programmatic) or [Code-first CLI guide](./code-first-cli.md) (`loxtep init`).
 
 ---
@@ -175,8 +175,6 @@ const hits = await client.query.catalog.search({ query: 'orders' });
 | **Catalog search** | `client.query.catalog.search({ query })` |
 | **Invalidate cache** | `client.build.data_products.invalidate_cache('name')` |
 
-See [MCP → SDK mapping](./sdk-mcp-mapping.md) for all 10 facades.
-
 ---
 
 ## CLI Shortcuts
@@ -220,4 +218,4 @@ in application code.
 |----------|-------------|
 | [Getting Started Guide](./getting-started.md) | Zero-to-first-event walkthrough |
 | [Event Replay Cookbook](./event-replay-cookbook.md) | Replay patterns (`build.data_products`, `observe`) |
-| [MCP → SDK Mapping](./sdk-mcp-mapping.md) | How MCP tools map to SDK methods |
+| [Code-first CLI guide](./code-first-cli.md) | `loxtep init` through deploy |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loxtep/sdk",
-  "version": "0.7.6",
+  "version": "0.7.9",
   "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",