@loxtep/sdk 0.11.1 → 0.13.0

package/dist/lib/sdk-ingest-bundle.js

@@ -2,10 +2,10 @@
  * Build local-first SDK ingest workflow package files
  * (connector + workflow + connection + source data product).
  */
-import { randomUUID } from 'node:crypto';
-import { EntityType, validateEntity } from './entity-json-schemas/index.js';
+import { randomUUID } from "node:crypto";
+import { EntityType, validateEntity } from "./entity-json-schemas/index.js";
 /** Placeholder starter template id for SDK-provisioned ingestion flows. */
-export const SDK_INGEST_TEMPLATE_ID = '00000000-0000-4000-8000-0000000000a1';
+export const SDK_INGEST_TEMPLATE_ID = "00000000-0000-4000-8000-0000000000a1";
 /**
  * Map an API connector (or stub) into a schema-valid local connector entity.
  * Entity schema uses catalog-style fields (name, category, auth_type) that differ
@@ -13,9 +13,9 @@ export const SDK_INGEST_TEMPLATE_ID = '00000000-0000-4000-8000-0000000000a1';
  */
 export function toLocalConnectorEntity(connector, now = new Date().toISOString()) {
     const meta = connector.metadata ?? {};
-    const name = (typeof meta.name === 'string' && meta.name.trim()) ||
+    const name = (typeof meta.name === "string" && meta.name.trim()) ||
         `${connector.connector_type} connector`;
-    const description = (typeof meta.description === 'string' && meta.description.trim()) ||
+    const description = (typeof meta.description === "string" && meta.description.trim()) ||
         `Local stub for ${connector.connector_type} connector`;
     return {
         connector_id: connector.connector_id,
@@ -23,11 +23,11 @@ export function toLocalConnectorEntity(connector, now = new Date().toISOString()
         connector_type: connector.connector_type,
         name,
         description,
-        category: 'custom',
+        category: "custom",
         // Entity schema enum has no "jwt"; use custom and keep API auth in metadata.
-        auth_type: 'custom',
-        version: '1.0.0',
-        metadata: { ...meta, sdk_auth_type: 'jwt' },
+        auth_type: "custom",
+        version: "1.0.0",
+        metadata: { ...meta, sdk_auth_type: "jwt" },
         created_at: connector.created_at ?? now,
         updated_at: connector.updated_at ?? now,
     };
@@ -41,7 +41,7 @@ export function buildSdkIngestLocalPackage(params) {
     const connectionId = params.connection_id ?? randomUUID();
     const dataProductId = params.data_product_id ?? randomUUID();
     const now = new Date().toISOString();
-    const workflowName = params.workflow_name ?? 'SDK App Events Ingest';
+    const workflowName = params.workflow_name ?? "SDK App Events Ingest";
     const files = {};
     if (params.include_connector_file !== false && params.connector) {
         files[`connectors/${params.connector_id}.json`] = toLocalConnectorEntity(params.connector, now);
@@ -52,11 +52,11 @@ export function buildSdkIngestLocalPackage(params) {
         project_id: params.project_id,
         name: workflowName,
         template_id: SDK_INGEST_TEMPLATE_ID,
-        workflow_type: 'ingestion',
+        workflow_type: "ingestion",
         domain_id: params.domain_id,
-        status: 'active',
+        status: "active",
         configuration: {},
-        metadata: { ingestion_method: 'sdk' },
+        metadata: { ingestion_method: "sdk" },
         created_at: now,
         updated_at: now,
     };
@@ -66,14 +66,17 @@ export function buildSdkIngestLocalPackage(params) {
         project_id: params.project_id,
         workflow_id: workflowId,
         connector_id: params.connector_id,
-        key: 'sdk-input',
-        name: 'SDK Input',
-        type: 'sdk',
-        status: 'active',
+        key: "sdk-input",
+        name: "SDK Input",
+        type: "sdk",
+        status: "active",
         configuration: {
-            sdk_type: 'nodejs',
+            sdk_type: "nodejs",
             event_type: params.data_product_name,
         },
+        runtime_settings: {
+            event_writer: { transport_mode: params.transport_mode ?? "default" },
+        },
         created_at: now,
         updated_at: now,
     };
@@ -82,18 +85,18 @@ export function buildSdkIngestLocalPackage(params) {
         organization_id: params.organization_id,
         workflow_id: workflowId,
         upstream_entity_id: connectionId,
-        upstream_entity_type: 'connections',
+        upstream_entity_type: "connections",
         domain_id: params.domain_id,
         name: params.data_product_name,
-        status: 'draft',
+        status: "draft",
         governance: {
-            classification: 'internal',
+            classification: "internal",
             pii_fields: [],
             compliance_requirements: [],
             tags: [],
         },
         metadata: {
-            kind: 'source',
+            kind: "source",
             project_id: params.project_id,
         },
         created_at: now,
@@ -105,7 +108,8 @@ export function buildSdkIngestLocalPackage(params) {
     if (params.user_id) {
         dataProduct.owner = { user_id: params.user_id };
     }
-    files[`workflows/${workflowId}/data-products/${dataProductId}.json`] = dataProduct;
+    files[`workflows/${workflowId}/data-products/${dataProductId}.json`] =
+        dataProduct;
     return {
         workflow_id: workflowId,
         connection_id: connectionId,
@@ -119,10 +123,13 @@ export function buildSdkIngestLocalPackage(params) {
  * Flat bundle map for `save_workflow_bundle` / `bundle save` (workflow-relative keys).
  */
 export function buildSdkIngestBundle(params) {
-    const local = buildSdkIngestLocalPackage({ ...params, include_connector_file: false });
+    const local = buildSdkIngestLocalPackage({
+        ...params,
+        include_connector_file: false,
+    });
     const wf = local.workflow_id;
     const files = {
-        'workflow.json': local.files[`workflows/${wf}/workflow.json`],
+        "workflow.json": local.files[`workflows/${wf}/workflow.json`],
         [`connections/${local.connection_id}.json`]: local.files[`workflows/${wf}/connections/${local.connection_id}.json`],
         [`data-products/${local.data_product_id}.json`]: local.files[`workflows/${wf}/data-products/${local.data_product_id}.json`],
     };
@@ -139,16 +146,18 @@ export function validateSdkIngestPackageFiles(files) {
     const errors = [];
     for (const [path, entity] of Object.entries(files)) {
         let entityType = null;
-        if (path.startsWith('connectors/') && path.endsWith('.json')) {
+        if (path.startsWith("connectors/") && path.endsWith(".json")) {
             entityType = EntityType.CONNECTOR;
         }
-        else if (path.endsWith('/workflow.json') || path === 'workflow.json') {
+        else if (path.endsWith("/workflow.json") || path === "workflow.json") {
             entityType = EntityType.WORKFLOW;
         }
-        else if (path.includes('/connections/') || path.startsWith('connections/')) {
+        else if (path.includes("/connections/") ||
+            path.startsWith("connections/")) {
             entityType = EntityType.CONNECTION;
         }
-        else if (path.includes('/data-products/') || path.startsWith('data-products/')) {
+        else if (path.includes("/data-products/") ||
+            path.startsWith("data-products/")) {
             entityType = EntityType.DATA_PRODUCT;
         }
         if (!entityType)

package/dist/lib/sdk-ingest-bundle.js.map

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

package/dist/rstreams/event-bridge.d.ts

@@ -1,9 +1,9 @@
 /**
  * Map stream read wrappers to the SDK queue event shape; write payloads via putEvent / putEvents.
  */
-import type { RStreamsSdk } from 'leo-sdk';
-import type { QueueEvent, WriteOptions } from '../client/queue-types.js';
-import type { FlowWriter } from '../client/flow-types.js';
+import type { RStreamsSdk } from "leo-sdk";
+import type { QueueEvent, WriteOptions } from "../client/queue-types.js";
+import { type EventWriterTransportMode, type FlowWriter } from "../client/flow-types.js";
 /**
  * Build the rstreams envelope for a business object. The source bot is set by the writer
  * (`rsdk.load(botId, …)`), so we deliberately emit NO top-level `id` — in rstreams that is the
@@ -20,7 +20,7 @@ export declare function toLeoEnvelope(businessObject: unknown, options?: WriteOp
  * Stream `error` events (e.g. Kinesis ResourceNotFoundException) are captured and cause
  * `close()` / subsequent `write()` to reject/throw instead of becoming an unhandled rejection.
  */
-export declare function createQueueWriter(rsdk: RStreamsSdk, botId: string, queueName: string, closedError: () => Error): FlowWriter;
+export declare function createQueueWriter(rsdk: RStreamsSdk, botId: string, queueName: string, closedError: () => Error, transportMode?: EventWriterTransportMode): FlowWriter;
 /**
  * Read up to `limit` events from `inQueue` acting as bot `id`, then return (mapped events, last start for next page).
  * Uses one offloadEvents invocation per batch (stream checkpoints advance between calls).

package/dist/rstreams/event-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bridge.d.ts","sourceRoot":"","sources":["../../src/rstreams/event-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAwB1D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQtG;AAeD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,KAAK,GACvB,UAAU,CA+DZ;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE5F,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}
+{"version":3,"file":"event-bridge.d.ts","sourceRoot":"","sources":["../../src/rstreams/event-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAwBjC;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAeD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,KAAK,EACxB,aAAa,GAAE,wBAAoC,GAClD,UAAU,CA4EZ;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,oBAAoB,CAAC,CA2B/B"}

package/dist/rstreams/event-bridge.js

@@ -1,16 +1,17 @@
 /**
  * Map stream read wrappers to the SDK queue event shape; write payloads via putEvent / putEvents.
  */
+import { parseEventWriterTransportMode, } from "../client/flow-types.js";
 function readEventToQueueEvent(wrapper) {
     const w = wrapper;
-    const event_id = (typeof w.id === 'string' && w.id) ||
-        (typeof w.eid === 'string' && w.eid) ||
-        (typeof w.event_id === 'string' &&
+    const event_id = (typeof w.id === "string" && w.id) ||
+        (typeof w.eid === "string" && w.eid) ||
+        (typeof w.event_id === "string" &&
             w.event_id) ||
-        '';
+        "";
     return {
         event_id,
-        event_type: typeof w.event === 'string' ? w.event : undefined,
+        event_type: typeof w.event === "string" ? w.event : undefined,
         payload: (w.payload ?? w),
         correlation_id: w.correlation_id,
     };
@@ -25,7 +26,7 @@ export function toLeoEnvelope(businessObject, options) {
     const env = { payload: businessObject };
     const ts = options?.event_source_timestamp;
     if (ts != null) {
-        const ms = typeof ts === 'number' ? ts : Date.parse(String(ts));
+        const ms = typeof ts === "number" ? ts : Date.parse(String(ts));
         if (!Number.isNaN(ms))
             env.event_source_timestamp = ms;
     }
@@ -43,15 +44,21 @@ function asError(err) {
  * Stream `error` events (e.g. Kinesis ResourceNotFoundException) are captured and cause
  * `close()` / subsequent `write()` to reject/throw instead of becoming an unhandled rejection.
  */
-export function createQueueWriter(rsdk, botId, queueName, closedError) {
-    const stream = rsdk.load(botId, queueName);
+export function createQueueWriter(rsdk, botId, queueName, closedError, transportMode = "default") {
+    const resolvedTransportMode = parseEventWriterTransportMode(transportMode);
+    const transportOptions = resolvedTransportMode === "fast"
+        ? { useS3: false }
+        : resolvedTransportMode === "volume"
+            ? { useS3: false, firehose: true }
+            : { useS3: true };
+    const stream = rsdk.load(botId, queueName, transportOptions);
     let closed = false;
     let streamError = null;
     const onStreamError = (err) => {
         streamError = asError(err);
     };
-    if (typeof stream.on === 'function') {
-        stream.on('error', onStreamError);
+    if (typeof stream.on === "function") {
+        stream.on("error", onStreamError);
     }
     return {
         write(event, options) {
@@ -88,10 +95,10 @@ export function createQueueWriter(rsdk, botId, queueName, closedError) {
                         settled = true;
                         resolve();
                     };
-                    if (typeof stream.once === 'function') {
-                        stream.once('error', fail);
+                    if (typeof stream.once === "function") {
+                        stream.once("error", fail);
                     }
-                    stream.end(err => {
+                    stream.end((err) => {
                         if (err) {
                             fail(err);
                             return;
@@ -102,8 +109,8 @@ export function createQueueWriter(rsdk, botId, queueName, closedError) {
                 });
             }
             finally {
-                if (typeof stream.removeListener === 'function') {
-                    stream.removeListener('error', onStreamError);
+                if (typeof stream.removeListener === "function") {
+                    stream.removeListener("error", onStreamError);
                 }
             }
         },
@@ -120,7 +127,7 @@ export async function readQueueBatch(rsdk, id, inQueue, limit, start) {
         start: start ?? undefined,
         transform(_payload, wrapper, callback) {
             collected.push(readEventToQueueEvent(wrapper));
-            if (typeof callback === 'function')
+            if (typeof callback === "function")
                 callback();
         },
     });

package/dist/rstreams/event-bridge.js.map

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

package/docs/event-writer-transport-modes.md

@@ -0,0 +1,47 @@
+# Event writer transport modes
+
+Node and Python event writers use `default` unless you explicitly select a
+different mode.
+
+| Mode      | Best for                         | Tradeoff                                    |
+| --------- | -------------------------------- | ------------------------------------------- |
+| `default` | Most application and pipeline IO | Durable, balanced, and recommended          |
+| `fast`    | Lowest publish latency           | Direct publishing may cost more             |
+| `volume`  | Sustained high throughput        | Throughput batching introduces delivery lag |
+
+## Node
+
+```ts
+const writer = await client.get_writer("orders", {
+  transport_mode: "default",
+});
+```
+
+The top-level data-product writer, low-level workflow writer, and queue writer
+all accept the same values.
+
+## Python
+
+```python
+writer = client.get_writer("orders", transport_mode="default")
+```
+
+Sync and async data-product and low-level workflow writers accept the same
+values.
+
+## CLI and MCP
+
+```bash
+loxtep ingest create --name orders --transport-mode default
+loxtep transform create --from orders --transport-mode fast
+loxtep delivery create --from orders --connector-id <id> --transport-mode volume
+```
+
+The CLI writes the setting to
+`runtime_settings.event_writer.transport_mode` in the generated entity JSON.
+MCP uses the same field in `save_workflow_bundle`; retrieve the current contract
+with `get_entity_schemas`.
+
+Durable writes still publish a small queue notification after storing the event
+batch. A notification transport timeout can therefore affect `default` mode;
+the mode alone does not establish the cause of a transport error.

package/docs/getting-started.md

@@ -23,6 +23,25 @@ write events with `get_writer`.
 > or the **Web UI** at [app.loxtep.io](https://app.loxtep.io).
 > Overview: [Loxtep Quickstart](https://app.loxtep.io/docs/quickstart/quickstart).
 
+## Start with your coding agent
+
+With Node.js 22.20 or newer, run:
+
+```bash
+npx --package @loxtep/sdk loxtep start
+```
+
+The starter detects Claude Code, Codex, OpenCode, or Cursor Agent, installs the
+integration, and launches the agent with the canonical setup prompt. If several
+clients are installed, choose one with `--client claude|codex|opencode|cursor`.
+Use `--no-launch` to configure and print the prompt for a manual restart.
+Normal Loxtep signup and hosted OAuth are required. This path does not require
+SDK login, a project attachment, or copied credentials. Existing client settings
+are preserved; conflicting Loxtep entries must be reviewed instead of overwritten.
+The agent then discovers authorized context or offers a synthetic policy example
+in an empty org, and verifies an answer with scoped retrieval and citations.
+
+
 ## Table of Contents
 
 - [Prerequisites](#prerequisites)

package/docs/sdk-first-ingest.md

@@ -64,15 +64,17 @@ The SDK reads your workspace (`.loxtep/project.json` + credentials). No manual
 URL or token wiring.
 
 ```typescript
-import { LoxtepClient } from '@loxtep/sdk';
+import { LoxtepClient } from "@loxtep/sdk";
 
 const client = await LoxtepClient.fromWorkspace();
 
-const writer = await client.get_writer('app-events');
+const writer = await client.get_writer("app-events", {
+  transport_mode: "default", // durable/recommended; fast may cost more; volume has lag
+});
 
 writer.write({
-  user_id: 'u_1',
-  action: 'signup',
+  user_id: "u_1",
+  action: "signup",
 });
 
 await writer.close();
@@ -87,7 +89,7 @@ Use the same name you passed to `ingest provision`.
 
 ```typescript
 const client = await LoxtepClient.fromWorkspace();
-const reader = await client.get_reader('app-events');
+const reader = await client.get_reader("app-events");
 
 for await (const event of reader) {
   console.log(event);
@@ -115,12 +117,12 @@ Then `get_writer('app-events')` in your app.
 
 ## If something goes wrong
 
-| What you see | What to do |
-| ------------ | ---------- |
-| Data product not found | Run `data-products list`. Check the name matches `get_writer('…')` exactly. |
-| Not ready to accept writes | Run `ingest provision`, then `deploy` (or `ingest provision --deploy`). Make sure you ran `attach` first. |
-| Multiple products with the same name | Pass the data product id to `get_writer`, or ensure `attach` points at the right instance. |
-| No domain available | Create a domain in the Loxtep UI, or pass `--domain-id` to `ingest provision`. |
+| What you see                         | What to do                                                                                                |
+| ------------------------------------ | --------------------------------------------------------------------------------------------------------- |
+| Data product not found               | Run `data-products list`. Check the name matches `get_writer('…')` exactly.                               |
+| Not ready to accept writes           | Run `ingest provision`, then `deploy` (or `ingest provision --deploy`). Make sure you ran `attach` first. |
+| Multiple products with the same name | Pass the data product id to `get_writer`, or ensure `attach` points at the right instance.                |
+| No domain available                  | Create a domain in the Loxtep UI, or pass `--domain-id` to `ingest provision`.                            |
 
 ---
 
@@ -136,6 +138,6 @@ or another client, describe what you want in plain language, for example:
 The assistant provisions the same end state as `ingest provision`. After that,
 Phase 4 above is unchanged: `get_writer('app-events')` and `write()`.
 
-**Loxtep Studio (web app)** — *Beta.* You can also design and publish a data
+**Loxtep Studio (web app)** — _Beta._ You can also design and publish a data
 product in the Loxtep UI. Once it exists on your instance, the SDK code in
 Phase 4 is the same.

package/docs/sdk-mcp-mapping.md

@@ -4,12 +4,17 @@ This is a **guide for agents**, not an exhaustive OpenAPI listing. MCP stays on
 **HTTP**; the SDK adds **typed REST** and the **stream data plane** for live
 I/O.
 
-The SDK exposes **10 namespaces** that mirror hosted MCP tools, plus HTTP
+Hosted MCP exposes **11 tools**: ten job facades plus the MCP Apps-only
+`loxtep_package_review` review card. The SDK exposes **10 namespaces** that
+mirror the job facades, plus HTTP
 namespaces `client.governance` (policies and access requests) and
 `client.entities` (projection inference). Old flat namespaces
 (`data_products`, `workflows`, `connectors`, …) are **removed** — no
-deprecation aliases. `emit_semantic_gap_candidate` stays MCP-only: it enqueues
-inside the AI lambda and has no HTTP route.
+deprecation aliases. The package-review card is not an SDK namespace.
+
+Current MCP-only operations also include delivery grant list/get/save/update,
+organization ontology inference start/get/cancel/list/review, and
+`emit_semantic_gap_candidate`; do not invent SDK methods for them.
 
 | MCP facade | SDK namespace | Nested APIs / notes |
 | --- | --- | --- |

package/package.json

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

package/schemas/entity-json-schemas/SCHEMA_SYNC.md

@@ -4,7 +4,7 @@ These JSON Schema draft-07 files are byte-identical copies of the Loxtep platfor
 single entity-schema source, used by `loxtep lint` and `validateEntity()`.
 
 **Source:** `LoxtepInc/loxtep` `platform-backend/_core/src/workspace/entity-json-schemas/`
-**Pinned commit:** `4d8f526e7dcc27751d298d87fd32798739274af1` (git blob ids per file in `SOURCE.json`)
+**Pinned commit:** `3046abfeb8e41a2d846a82c4f98c875cc0b98713` (git blob ids per file in `SOURCE.json`)
 
 **Sync** (from `nodejs/`, with a loxtep checkout at the commit to pin):
 

package/schemas/entity-json-schemas/SOURCE.json

@@ -1,22 +1,23 @@
 {
   "repository": "LoxtepInc/loxtep",
   "path": "platform-backend/_core/src/workspace/entity-json-schemas",
-  "commit": "4d8f526e7dcc27751d298d87fd32798739274af1",
+  "commit": "3046abfeb8e41a2d846a82c4f98c875cc0b98713",
   "files": {
     "agent.json": "894158338a8bd3b08b7a042006be0d669aa0fe56",
     "approval.json": "37cad8aff6e250be2bc8ccb966d97018d48f0663",
-    "connection.json": "22efeaf02a3142cf89296074b992f0e81f4d3c2b",
+    "connection.json": "00c6fedc5a574d02a27655d8f584c8b6a0a91bd5",
     "connector.json": "712b7f7abb0c06aecd29a76b667950a0eda070d7",
     "container.json": "3b5b3a51d4f27645e3db2e8e2992aeee984de5ee",
     "contract.json": "04fec0f7f4c26890e8163d88770a5613316b245d",
-    "data-product.json": "ebf208b50d0330958daf73bfdd81c1444cc037f0",
+    "data-product.json": "e9303aa4e69ba3b0a604bedfef3273a6c6a8323e",
     "domain.json": "42e83648bdebec54fabdb1ba9f7d7a1369f3ba05",
     "export.json": "44ef4bb5c21860a66cd57d86e06a66ff7813c225",
+    "grant.json": "9ccf2bf26d8aed76723534161a039d47a2dbd7bb",
     "odps-product.json": "53b8eb5eb070d0d1e60a91fe908e038ee3e5d599",
     "projection.json": "5457e3f233f936d3fba38bc8513fb99a54961607",
     "quality-rule.json": "d0c298616b2e20a02256cde2f63acf38f7bb6f3f",
     "schema.json": "38940cc4e8b59a70cf44699459af0b8a09f0fc52",
-    "transformation.json": "af95be38f90adafc0c7b9179d454c0593d9b49bd",
+    "transformation.json": "75e773049944417892c31f17da15fe393446e6ff",
     "validation.json": "056452196c622c7bac0bdd496db623ee2e22f083",
     "workflow-graph.json": "9715eea18965bea97fc5546edb4b37629c77315b",
     "workflow.json": "afe25e55833ac957bdcd62d32e6c9df83779c54b"

package/schemas/entity-json-schemas/connection.json

@@ -317,6 +317,41 @@
       },
       "additionalProperties": true
     },
+    "runtime_settings": {
+      "type": ["object", "null"],
+      "description": "Native runtime tuning. Event writes use the default durable mode unless explicitly changed.",
+      "properties": {
+        "event_writer": {
+          "type": ["object", "null"],
+          "description": "Event writer behavior for normal outputs, errors, quarantine records, and acknowledgements produced by this connection.",
+          "properties": {
+            "transport_mode": {
+              "type": "string",
+              "enum": ["default", "fast", "volume"],
+              "default": "default",
+              "description": "Event write transport: default is durable and balanced (recommended); fast has the lowest latency but may cost more; volume is optimized for high throughput and introduces delivery lag."
+            },
+            "chunk_bytes": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Durable-mode file target size in bytes. Advanced tuning; leave unset for the platform default."
+            },
+            "flush_ms": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Durable-mode flush interval in milliseconds. Advanced tuning; leave unset for the platform default."
+            },
+            "sections_per_file": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Durable-mode sections per file. Advanced tuning; leave unset for the platform default."
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": true
+    },
     "delivery_config": {
       "type": ["object", "null"],
       "description": "Outbound write policy for delivery-tail connections (mirror of ingestion_config for the source side). Auth/transport stay on configuration and the org connector; table, write_mode, upsert primary_key, batch sizes, and conflict rules live here. Distinct from data-product projection delivery_config (entities MS).",

package/schemas/entity-json-schemas/data-product.json

@@ -175,6 +175,22 @@
         { "type": "string", "minLength": 1 }
       ]
     },
+    "published_access_methods": {
+      "type": "array",
+      "description": "Design-time permitted consumption methods (D3). Baseline event_stream (data product trigger) is always effective even when omitted; sync coalesces it into data_products.delivery.",
+      "items": {
+        "type": "string",
+        "enum": [
+          "event_stream",
+          "sql",
+          "api_endpoint",
+          "webhook",
+          "export",
+          "bi_connect"
+        ]
+      },
+      "uniqueItems": true
+    },
     "odps_document": {
       "description": "Canonical ODPS v4.1 document (`{ product: ... }`). Preferred for platform catalog, governance, and ecosystem interoperability. Validated in the dataproducts API; Loxtep-specific fields under product.custom.loxtep.",
       "allOf": [