@loxtep/sdk 0.2.1 → 0.3.0

package/dist/client/queue-types.d.ts

@@ -76,9 +76,22 @@ export interface QueueReaderHandle {
     /** Clean up resources and stop reading. After close(), read() yields no more events. */
     close(): void;
 }
-/** Handle returned by queues.open_writer; buffers then flushes via stream `putEvents`. */
+/**
+ * Options for a single writer `write()`. Callers pass the **business object** to `write()`; the SDK
+ * builds the rstreams envelope (source bot = the writer's `bot_id`, `payload` = the business object).
+ * Callers never set the envelope/source themselves.
+ */
+export interface WriteOptions {
+    /**
+     * Source event time for this record. A ms-epoch number, or any `Date.parse`-able string. Sets the
+     * leo envelope's `event_source_timestamp`; if omitted, leo assigns the write time.
+     */
+    event_source_timestamp?: string | number;
+}
+/** Handle returned by queues.open_writer; forwards to the rstreams `load` stream (which buffers/flushes). */
 export interface QueueWriterHandle {
-    write(event: unknown): Promise<void>;
+    /** Write a business object (the SDK builds the envelope; source = writer bot_id). */
+    write(event: unknown, options?: WriteOptions): void | Promise<void>;
     close(): Promise<void>;
 }
 //# sourceMappingURL=queue-types.d.ts.map

package/dist/client/queue-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-types.d.ts","sourceRoot":"","sources":["../../src/client/queue-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queue-types.d.ts","sourceRoot":"","sources":["../../src/client/queue-types.ts"],"names":[],"mappings":"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"}

package/dist/client/queues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../../src/client/queues.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEhB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAQ1B,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACnD;AAKD;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAU;gBAGtB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAU5D;;;;;;OAMG;IACI,IAAI,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAAC,UAAU,CAAC;IAqCzE;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,IAAI,CAAC,EAAE,aAAa,GACnB;IACD,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzF,WAAW,EAAE,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,sBAAsB,CAAC;KAClC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7F,CA2EA"}
+{"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../../src/client/queues.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEhB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAQ1B,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACnD;AAKD;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAU;gBAGtB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAU5D;;;;;;OAMG;IACI,IAAI,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAAC,UAAU,CAAC;IAqCzE;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,EACtB,IAAI,CAAC,EAAE,aAAa,GACnB;IACD,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzF,WAAW,EAAE,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,sBAAsB,CAAC;KAClC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7F,CAsEA"}

package/dist/client/queues.js

@@ -1,7 +1,7 @@
 /**
  * Queues API: observe metadata/checkpoints over REST; read/write live events via the Loxtep stream data plane.
  */
-import { putPayloadsToQueue, readQueueBatch, } from '../rstreams/event-bridge.js';
+import { createQueueWriter, readQueueBatch, } from '../rstreams/event-bridge.js';
 import { StreamingError } from '../errors/streaming.js';
 /** Default batch size for QueueReader read operations. */
 const DEFAULT_BATCH_SIZE = 100;
@@ -119,19 +119,8 @@ export function createQueuesApi(http, deps) {
             if (!rsdk) {
                 throw new Error('queues.open_writer requires a configured Loxtep stream bus on LoxtepClient (pass `streams` and instance env, or explicit bus config).');
             }
-            const buffer = [];
-            return {
-                async write(event) {
-                    buffer.push(event);
-                },
-                async close() {
-                    if (buffer.length === 0)
-                        return;
-                    const events = [...buffer];
-                    buffer.length = 0;
-                    await putPayloadsToQueue(rsdk, bot_id, queue_name, events);
-                },
-            };
+            // The rstreams `load` stream (inside createQueueWriter) owns buffering/batching/backoff.
+            return createQueueWriter(rsdk, bot_id, queue_name, () => new StreamingError('Cannot write to a closed queue writer.', { details: { queue_name } }));
         },
     };
 }

package/dist/client/queues.js.map

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

package/dist/codegen/emit.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stage 3: Emit — render typed TypeScript source from NormalizedContext.
+ *
+ * This pure function transforms a `NormalizedContext` into a string of TypeScript
+ * source code containing typed `as const` constants and a `workspace` namespace
+ * that aggregates all resource collections.
+ *
+ * Requirements: R2.1, R2.2, R2.3, R2.4, R2.5
+ *
+ * @module codegen/emit
+ */
+import type { NormalizedContext } from './types.js';
+/**
+ * Renders a `NormalizedContext` into a complete TypeScript source string.
+ *
+ * The output includes:
+ * - A header comment with an auto-generated notice and context hash (R12.4)
+ * - Per-resource-type `as const` exports with required fields (R2.1–R2.4)
+ * - A `workspace` namespace aggregating all collections (R2.5)
+ * - Empty objects for empty collections in the workspace namespace (R2.5)
+ *
+ * This is a pure function: same input always produces the same output (R2.6).
+ */
+export declare function emitArtifact(norm: NormalizedContext): string;
+//# sourceMappingURL=emit.d.ts.map

package/dist/codegen/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/codegen/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AA+FxE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CA0F5D"}

package/dist/codegen/emit.js

@@ -0,0 +1,158 @@
+/**
+ * Stage 3: Emit — render typed TypeScript source from NormalizedContext.
+ *
+ * This pure function transforms a `NormalizedContext` into a string of TypeScript
+ * source code containing typed `as const` constants and a `workspace` namespace
+ * that aggregates all resource collections.
+ *
+ * Requirements: R2.1, R2.2, R2.3, R2.4, R2.5
+ *
+ * @module codegen/emit
+ */
+/**
+ * Computes a deterministic SHA-256-like hash of the normalized context for cache
+ * invalidation (R12.4). Uses a simple djb2-based hash over the JSON-serialized
+ * context to produce a stable hex string.
+ */
+function computeContextHash(norm) {
+    const serialized = JSON.stringify(norm);
+    let hash = 5381;
+    for (let i = 0; i < serialized.length; i++) {
+        hash = ((hash << 5) + hash + serialized.charCodeAt(i)) | 0;
+    }
+    // Convert to unsigned 32-bit hex
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/**
+ * Serializes a JavaScript value to a TypeScript literal string.
+ * Handles strings, numbers, booleans, null, arrays, and plain objects.
+ */
+function toLiteral(value, indent) {
+    const pad = '  '.repeat(indent);
+    const innerPad = '  '.repeat(indent + 1);
+    if (value === null) {
+        return 'null';
+    }
+    if (typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return '[]';
+        }
+        const items = value.map((item) => `${innerPad}${toLiteral(item, indent + 1)}`);
+        return `[\n${items.join(',\n')}\n${pad}]`;
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value);
+        if (entries.length === 0) {
+            return '{}';
+        }
+        const props = entries.map(([key, val]) => `${innerPad}${safeKey(key)}: ${toLiteral(val, indent + 1)}`);
+        return `{\n${props.join(',\n')}\n${pad}}`;
+    }
+    return 'undefined';
+}
+/**
+ * Returns a safe object key — quoted if not a valid identifier, bare otherwise.
+ */
+function safeKey(key) {
+    if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)) {
+        return key;
+    }
+    return JSON.stringify(key);
+}
+/**
+ * Emits a single resource entry as a TypeScript object literal line.
+ */
+function emitResourceEntry(key, fields) {
+    const props = Object.entries(fields)
+        .map(([k, v]) => `${safeKey(k)}: ${toLiteral(v, 2)}`)
+        .join(', ');
+    return `  ${safeKey(key)}: { ${props} }`;
+}
+/**
+ * Emits a resource collection as a typed `as const` export.
+ * Returns an empty object `{}` when the collection has no entries.
+ */
+function emitCollection(name, resources, fieldExtractor) {
+    if (resources.length === 0) {
+        return `export const ${name} = {} as const;`;
+    }
+    const entries = resources.map((r) => {
+        const fields = fieldExtractor(r.data);
+        return emitResourceEntry(r.key, fields);
+    });
+    return `export const ${name} = {\n${entries.join(',\n')},\n} as const;`;
+}
+/**
+ * Renders a `NormalizedContext` into a complete TypeScript source string.
+ *
+ * The output includes:
+ * - A header comment with an auto-generated notice and context hash (R12.4)
+ * - Per-resource-type `as const` exports with required fields (R2.1–R2.4)
+ * - A `workspace` namespace aggregating all collections (R2.5)
+ * - Empty objects for empty collections in the workspace namespace (R2.5)
+ *
+ * This is a pure function: same input always produces the same output (R2.6).
+ */
+export function emitArtifact(norm) {
+    const hash = computeContextHash(norm);
+    const header = [
+        `// .loxtep/generated/index.ts  (AUTO-GENERATED — do not edit)`,
+        `// Context hash: ${hash}`,
+        '',
+    ].join('\n');
+    const dataProductsBlock = emitCollection('dataProducts', norm.dataProducts, (dp) => ({
+        name: dp.name,
+        id: dp.id,
+        domain: dp.domain,
+        schema: dp.schema,
+    }));
+    const connectorsBlock = emitCollection('connectors', norm.connectors, (c) => ({
+        name: c.name,
+        type: c.type,
+        id: c.id,
+        connection_id: c.connection_id,
+    }));
+    const domainsBlock = emitCollection('domains', norm.domains, (d) => ({
+        name: d.name,
+        id: d.id,
+        data_product_ids: d.data_product_ids,
+    }));
+    const queuesBlock = emitCollection('queues', norm.queues, (q) => ({
+        name: q.name,
+        id: q.id,
+    }));
+    const flowsBlock = emitCollection('flows', norm.flows, (f) => ({
+        name: f.name,
+        id: f.id,
+    }));
+    const workflowsBlock = emitCollection('workflows', norm.workflows, (w) => ({
+        name: w.name,
+        id: w.id,
+    }));
+    const workspaceExport = 'export const workspace = { dataProducts, connectors, domains, queues, flows, workflows } as const;';
+    const parts = [
+        header,
+        dataProductsBlock,
+        '',
+        connectorsBlock,
+        '',
+        domainsBlock,
+        '',
+        queuesBlock,
+        '',
+        flowsBlock,
+        '',
+        workflowsBlock,
+        '',
+        workspaceExport,
+        '',
+    ];
+    return parts.join('\n');
+}
+//# sourceMappingURL=emit.js.map

package/dist/codegen/emit.js.map

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

package/dist/codegen/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Codegen module — typed Workspace Context generation pipeline.
+ *
+ * The pipeline has four stages:
+ * 1. load (I/O) — fetch resources from the control plane
+ * 2. normalize (pure) — deterministic key derivation + canonical ordering
+ * 3. emit (pure) — render typed TypeScript source
+ * 4. write (I/O) — atomic file write
+ *
+ * @module codegen
+ */
+export type { JsonSchema, WorkspaceContext, NormalizedContext, NormalizedResource, GenerateCounts, } from './types.js';
+export { loadWorkspaceContext } from './load-workspace-context.js';
+export { deriveKey, normalizeContext } from './normalize.js';
+export { emitArtifact } from './emit.js';
+export { writeArtifact, computeCounts } from './write-artifact.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/codegen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/codegen/index.js

@@ -0,0 +1,16 @@
+/**
+ * Codegen module — typed Workspace Context generation pipeline.
+ *
+ * The pipeline has four stages:
+ * 1. load (I/O) — fetch resources from the control plane
+ * 2. normalize (pure) — deterministic key derivation + canonical ordering
+ * 3. emit (pure) — render typed TypeScript source
+ * 4. write (I/O) — atomic file write
+ *
+ * @module codegen
+ */
+export { loadWorkspaceContext } from './load-workspace-context.js';
+export { deriveKey, normalizeContext } from './normalize.js';
+export { emitArtifact } from './emit.js';
+export { writeArtifact, computeCounts } from './write-artifact.js';
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/codegen/load-workspace-context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Stage 1 (I/O): Load the raw WorkspaceContext from the control plane.
+ *
+ * Queries the Loxtep API via LoxtepClient namespaces scoped to the project_id:
+ * - data_products (org-level, all available to the project)
+ * - connectors (org-level)
+ * - domains (org-level, with associated data product ids)
+ * - queues (instance-level, from observe)
+ * - flows (project-scoped)
+ * - workflows (project-scoped)
+ *
+ * @module codegen/load-workspace-context
+ */
+import type { LoxtepClient } from '../client/loxtep-client.js';
+import type { WorkspaceContext } from './types.js';
+/**
+ * Fetch all workspace resources from the control plane and assemble them into
+ * a WorkspaceContext. The client must be configured with a valid project_id.
+ *
+ * All list calls use large page sizes to fetch the complete resource set.
+ * Pagination is handled by fetching the maximum page size; projects with
+ * extremely large resource counts may need future iteration.
+ *
+ * @param client - An authenticated LoxtepClient instance
+ * @param projectId - The project to scope the context to
+ * @returns The assembled WorkspaceContext with all resource collections
+ * @throws If any control-plane query fails (caller should handle R2.8)
+ */
+export declare function loadWorkspaceContext(client: LoxtepClient, projectId: string): Promise<WorkspaceContext>;
+//# sourceMappingURL=load-workspace-context.d.ts.map

package/dist/codegen/load-workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-workspace-context.d.ts","sourceRoot":"","sources":["../../src/codegen/load-workspace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAmF3B"}

package/dist/codegen/load-workspace-context.js

@@ -0,0 +1,127 @@
+/**
+ * Stage 1 (I/O): Load the raw WorkspaceContext from the control plane.
+ *
+ * Queries the Loxtep API via LoxtepClient namespaces scoped to the project_id:
+ * - data_products (org-level, all available to the project)
+ * - connectors (org-level)
+ * - domains (org-level, with associated data product ids)
+ * - queues (instance-level, from observe)
+ * - flows (project-scoped)
+ * - workflows (project-scoped)
+ *
+ * @module codegen/load-workspace-context
+ */
+/**
+ * Fetch all workspace resources from the control plane and assemble them into
+ * a WorkspaceContext. The client must be configured with a valid project_id.
+ *
+ * All list calls use large page sizes to fetch the complete resource set.
+ * Pagination is handled by fetching the maximum page size; projects with
+ * extremely large resource counts may need future iteration.
+ *
+ * @param client - An authenticated LoxtepClient instance
+ * @param projectId - The project to scope the context to
+ * @returns The assembled WorkspaceContext with all resource collections
+ * @throws If any control-plane query fails (caller should handle R2.8)
+ */
+export async function loadWorkspaceContext(client, projectId) {
+    // Fetch all resource types concurrently for performance.
+    // Project-scoped resources (flows, workflows) use projectId directly.
+    // Org-scoped resources (data products, connectors, domains) fetch all available.
+    const [dataProductsResult, connectorsResult, domainsResult, flowsResult, workflowsResult,] = await Promise.all([
+        client.data_products.list({ page: 1, page_size: 1000 }),
+        client.connectors.list({ page: 1, page_size: 1000 }),
+        client.domains.list({ page: 1, page_size: 1000 }),
+        client.flows.list({ project_id: projectId, page: 1, page_size: 1000 }),
+        client.workflows.listWorkflows({ project_id: projectId, page: 1, page_size: 1000 }),
+    ]);
+    // Fetch queues from the observe endpoint (instance-level).
+    // The observe.status() returns bot/queue info for the configured instance.
+    let queuesRaw = [];
+    try {
+        const observeData = await client.observe.status();
+        queuesRaw = extractQueuesFromObserve(observeData);
+    }
+    catch {
+        // If observe is not available (e.g. no instance configured), queues will be empty.
+        // This is acceptable — queues are instance-level and may not be reachable during
+        // initial setup.
+        queuesRaw = [];
+    }
+    // Map data products to workspace context shape
+    const dataProducts = (dataProductsResult?.items ?? []).map(dp => ({
+        name: dp.name,
+        id: dp.data_product_id,
+        domain: dp.domain_id ?? null,
+        schema: dp.schema ?? null,
+    }));
+    // Map connectors to workspace context shape
+    const connectors = (connectorsResult?.items ?? []).map(c => ({
+        type: c.connector_type,
+        id: c.connector_id,
+        connection_id: null, // Connectors at org-level don't have a project connection_id
+        name: c.metadata?.name ?? c.connector_type,
+    }));
+    // Map domains to workspace context shape
+    const domainsItems = domainsResult?.items ?? [];
+    const domains = domainsItems.map(d => ({
+        name: d.name,
+        id: d.domain_id,
+        data_product_ids: dataProducts
+            .filter(dp => dp.domain === d.domain_id)
+            .map(dp => dp.id),
+    }));
+    // Map flows to workspace context shape
+    const flowItems = flowsResult?.items ?? [];
+    const flows = flowItems.map(f => ({
+        name: f.name,
+        id: f.workflow_id,
+    }));
+    // Map workflows to workspace context shape
+    const workflowItems = workflowsResult?.items ?? [];
+    const workflows = workflowItems.map(w => ({
+        name: w.name,
+        id: w.workflow_id,
+    }));
+    return {
+        dataProducts,
+        connectors,
+        domains,
+        queues: queuesRaw,
+        flows,
+        workflows,
+    };
+}
+/**
+ * Extract queue names and ids from the observe status response.
+ * The observe endpoint returns various shapes; we extract queue-like entries
+ * that have a name/queue_name and an identifier.
+ */
+function extractQueuesFromObserve(observeData) {
+    if (!observeData || typeof observeData !== 'object')
+        return [];
+    const data = observeData;
+    // Try to extract queues from common observe response shapes
+    const queuesArray = data.queues ??
+        data.data?.queues ??
+        [];
+    if (!Array.isArray(queuesArray))
+        return [];
+    const result = [];
+    for (const q of queuesArray) {
+        if (!q || typeof q !== 'object')
+            continue;
+        const entry = q;
+        const name = entry.queue_name ??
+            entry.name ??
+            '';
+        const id = entry.queue_id ??
+            entry.id ??
+            '';
+        if (name) {
+            result.push({ name, id: id || name });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=load-workspace-context.js.map

package/dist/codegen/load-workspace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-workspace-context.js","sourceRoot":"","sources":["../../src/codegen/load-workspace-context.ts"],"names":[],"mappings":"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"}

package/dist/codegen/normalize.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Stage 2: Normalize — deterministic key derivation + canonical ordering.
+ *
+ * This pure function transforms a raw `WorkspaceContext` into a `NormalizedContext`
+ * with stable, deterministic keys and canonical id-sorted ordering, ensuring
+ * byte-identical output for unchanged contexts (R2.6).
+ *
+ * @module codegen/normalize
+ */
+import type { WorkspaceContext, NormalizedContext } from './types.js';
+/**
+ * Derives a deterministic, valid TypeScript identifier key from a resource name.
+ *
+ * Rules:
+ * 1. Lowercase the name
+ * 2. Replace any run of non-alphanumeric characters with a single `_`
+ * 3. Trim leading/trailing `_`
+ * 4. If result is empty or starts with a digit, prefix with `_`
+ *
+ * Collision resolution is handled separately in `normalizeCollection`.
+ */
+export declare function deriveKey(name: string): string;
+/**
+ * Normalizes the entire workspace context.
+ *
+ * Transforms raw `WorkspaceContext` into `NormalizedContext` by:
+ * - Sorting each resource collection by id (ascending) for canonical ordering
+ * - Deriving deterministic keys from resource names
+ * - Resolving key collisions with `_2`, `_3`, … suffixes in id-sorted order
+ *
+ * This is a pure function: given the same input, it always produces the same output,
+ * guaranteeing byte-identical artifacts for unchanged contexts (R2.6).
+ */
+export declare function normalizeContext(ctx: WorkspaceContext): NormalizedContext;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/codegen/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/codegen/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,CASzE"}

package/dist/codegen/normalize.js

@@ -0,0 +1,77 @@
+/**
+ * Stage 2: Normalize — deterministic key derivation + canonical ordering.
+ *
+ * This pure function transforms a raw `WorkspaceContext` into a `NormalizedContext`
+ * with stable, deterministic keys and canonical id-sorted ordering, ensuring
+ * byte-identical output for unchanged contexts (R2.6).
+ *
+ * @module codegen/normalize
+ */
+/**
+ * Derives a deterministic, valid TypeScript identifier key from a resource name.
+ *
+ * Rules:
+ * 1. Lowercase the name
+ * 2. Replace any run of non-alphanumeric characters with a single `_`
+ * 3. Trim leading/trailing `_`
+ * 4. If result is empty or starts with a digit, prefix with `_`
+ *
+ * Collision resolution is handled separately in `normalizeCollection`.
+ */
+export function deriveKey(name) {
+    // Step 1: lowercase
+    let key = name.toLowerCase();
+    // Step 2: replace any run of non-alphanumeric characters with a single `_`
+    key = key.replace(/[^a-z0-9]+/g, '_');
+    // Step 3: trim leading/trailing `_`
+    key = key.replace(/^_+|_+$/g, '');
+    // Step 4: if empty or starts with a digit, prefix with `_`
+    if (key === '' || /^[0-9]/.test(key)) {
+        key = '_' + key;
+    }
+    return key;
+}
+/**
+ * Normalizes a single resource collection:
+ * - Sorts resources by `id` in ascending lexicographic order (canonical ordering)
+ * - Derives a key from each resource's `name`
+ * - Resolves collisions by appending `_2`, `_3`, etc. in id-sorted order
+ *   (the first resource in id order keeps the base key, subsequent collisions get suffixes)
+ */
+function normalizeCollection(resources) {
+    // Sort by id ascending for canonical ordering
+    const sorted = [...resources].sort((a, b) => a.id.localeCompare(b.id));
+    // Group by derived base key to detect collisions
+    const keyGroups = new Map();
+    return sorted.map((resource) => {
+        const baseKey = deriveKey(resource.name);
+        // Track how many times we've seen this base key
+        const count = keyGroups.get(baseKey) ?? 0;
+        keyGroups.set(baseKey, count + 1);
+        // First occurrence keeps the base key; subsequent get _2, _3, etc.
+        const key = count === 0 ? baseKey : `${baseKey}_${count + 1}`;
+        return { key, data: resource };
+    });
+}
+/**
+ * Normalizes the entire workspace context.
+ *
+ * Transforms raw `WorkspaceContext` into `NormalizedContext` by:
+ * - Sorting each resource collection by id (ascending) for canonical ordering
+ * - Deriving deterministic keys from resource names
+ * - Resolving key collisions with `_2`, `_3`, … suffixes in id-sorted order
+ *
+ * This is a pure function: given the same input, it always produces the same output,
+ * guaranteeing byte-identical artifacts for unchanged contexts (R2.6).
+ */
+export function normalizeContext(ctx) {
+    return {
+        dataProducts: normalizeCollection(ctx.dataProducts),
+        connectors: normalizeCollection(ctx.connectors),
+        domains: normalizeCollection(ctx.domains),
+        queues: normalizeCollection(ctx.queues),
+        flows: normalizeCollection(ctx.flows),
+        workflows: normalizeCollection(ctx.workflows),
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/codegen/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/codegen/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,oBAAoB;IACpB,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAEtC,oCAAoC;IACpC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElC,2DAA2D;IAC3D,IAAI,GAAG,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAC1B,SAAc;IAEd,8CAA8C;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvE,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEzC,gDAAgD;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAElC,mEAAmE;QACnE,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAE9D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,OAAO;QACL,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;QACnD,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC;QAC/C,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;QACrC,SAAS,EAAE,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;KAC9C,CAAC;AACJ,CAAC"}