@loxtep/sdk 0.5.0 → 0.7.0

package/dist/client/flows.js

@@ -0,0 +1,218 @@
+/**
+ * Flows API (backend: workflows). list, get (with nodes), create, get_writer.
+ * Flow writes for live events use the Loxtep stream data plane — not HTTP POST to /workflows/.../events.
+ */
+import { DefinitionValidationError } from '../errors/validation.js';
+import { StreamingError } from '../errors/streaming.js';
+import { createQueueWriter } from '../rstreams/event-bridge.js';
+import { resolveIngestionQueueName } from './flow-queue-resolve.js';
+const WORKFLOWS_API_BASE = '/workflows/workflows';
+function buildQueryString(params) {
+    const search = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === null)
+            continue;
+        search.set(k, String(v));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : '';
+}
+function validateEventAgainstDefinition(event, definition) {
+    const errors = [];
+    const required = definition.required;
+    if (Array.isArray(required) &&
+        required.length > 0 &&
+        event !== null &&
+        typeof event === 'object') {
+        const obj = event;
+        for (const key of required) {
+            if (!(key in obj) || obj[key] === undefined) {
+                errors.push({ path: key, message: `Missing required field: ${key}` });
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Determine whether an error is transient and should be retried.
+ * Transient: network errors, timeouts, throttling (429), 5xx responses.
+ * Non-transient: 4xx (except 429), auth failures — fail immediately.
+ */
+export function isTransientError(err) {
+    if (err === null || err === undefined)
+        return false;
+    // Check for status code on the error object (HTTP response errors)
+    const statusCode = typeof err.status_code === 'number'
+        ? err.status_code
+        : typeof err.statusCode === 'number'
+            ? err.statusCode
+            : typeof err.status === 'number'
+                ? err.status
+                : undefined;
+    if (statusCode !== undefined) {
+        // 429 (throttling) is transient
+        if (statusCode === 429)
+            return true;
+        // 5xx responses are transient
+        if (statusCode >= 500 && statusCode < 600)
+            return true;
+        // Other 4xx are non-transient (auth failures, validation errors, etc.)
+        if (statusCode >= 400 && statusCode < 500)
+            return false;
+    }
+    // Check error code strings
+    const code = typeof err.code === 'string'
+        ? err.code
+        : undefined;
+    if (code) {
+        const transientCodes = new Set([
+            'ECONNRESET',
+            'ECONNREFUSED',
+            'ENOTFOUND',
+            'ETIMEDOUT',
+            'EPIPE',
+            'EAI_AGAIN',
+            'RATE_LIMIT_EXCEEDED',
+            'RATE_LIMIT_ERROR',
+            'SERVICE_UNAVAILABLE',
+            'GATEWAY_TIMEOUT',
+            'INTERNAL_SERVER_ERROR',
+        ]);
+        if (transientCodes.has(code))
+            return true;
+        // Auth-related codes are non-transient
+        const nonTransientCodes = new Set([
+            'AUTHENTICATION_ERROR',
+            'AUTHORIZATION_ERROR',
+            'VALIDATION_ERROR',
+            'NOT_FOUND',
+        ]);
+        if (nonTransientCodes.has(code))
+            return false;
+    }
+    // Check error message for network-related keywords
+    const message = typeof err.message === 'string'
+        ? err.message.toLowerCase()
+        : '';
+    if (message.includes('timeout') ||
+        message.includes('econnreset') ||
+        message.includes('econnrefused') ||
+        message.includes('network') ||
+        message.includes('socket hang up')) {
+        return true;
+    }
+    // Default: treat unknown errors as transient to allow retry
+    return true;
+}
+/**
+ * Sleep for the given number of milliseconds. Extracted for testability.
+ */
+export function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Create the flows API surface (list, get with nodes, create, get_writer).
+ */
+export function createFlowsApi(http, deps) {
+    return {
+        async list(filters) {
+            const params = {
+                project_id: filters.project_id,
+                page: filters.page ?? 1,
+                page_size: filters.page_size ?? 100,
+            };
+            if (filters.status)
+                params.status = filters.status;
+            if (filters.search)
+                params.search = filters.search;
+            const qs = buildQueryString(params);
+            const res = await http.get(`${WORKFLOWS_API_BASE}${qs}`);
+            return res.data;
+        },
+        async get(id) {
+            const flowRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(id)}`);
+            const flow = flowRes.data;
+            let nodes = [];
+            try {
+                const nodesRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(id)}/nodes`);
+                const payload = nodesRes.data ?? nodesRes;
+                nodes = payload.items ?? [];
+            }
+            catch {
+                // Nodes endpoint may not exist or may 404; flow still has node_count
+            }
+            return { ...flow, nodes };
+        },
+        async create(input) {
+            const res = await http.post(WORKFLOWS_API_BASE, input);
+            return res.data;
+        },
+        async get_writer(flow_id, options) {
+            // Resolve the stream runtime, source bot, and destination queue up front; the rstreams `load`
+            // stream (created inside createQueueWriter) owns buffering, batching, backoff, and checkpointing.
+            const rsdk = deps?.rsdk ?? (await deps?.get_rsdk?.());
+            if (!rsdk) {
+                throw new StreamingError('Stream bus configuration missing. Set LEO_* environment variables or add `streams` to ~/.loxtep/config.json. ' +
+                    'Pass `streams` in LoxtepClientOptions, or ensure your instance stream environment is configured.', {
+                    details: {
+                        flow_id,
+                        hint: 'Run `loxtep init` to configure stream bus, or set LEO_* env vars from your instance.',
+                    },
+                });
+            }
+            const botId = options?.bot_id;
+            if (!botId) {
+                throw new StreamingError('flows.get_writer requires bot_id in options (stream writer identity on the bus).', { details: { flow_id } });
+            }
+            let queueName = options?.output_queue_name;
+            if (!queueName && options?.environment_prefix && options?.project_id) {
+                const flowRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(flow_id)}`);
+                const flowData = flowRes && typeof flowRes === 'object' && 'data' in flowRes
+                    ? flowRes.data
+                    : flowRes;
+                let nodes = [];
+                try {
+                    const nodesRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(flow_id)}/nodes`);
+                    const payload = nodesRes.data ?? nodesRes;
+                    nodes = payload.items ?? [];
+                }
+                catch {
+                    /* ignore */
+                }
+                const flowWithNodes = { ...flowData, nodes };
+                queueName = resolveIngestionQueueName(flowWithNodes, options.environment_prefix);
+            }
+            if (!queueName) {
+                throw new StreamingError('flows.get_writer requires output_queue_name, or environment_prefix + project_id so the SDK can resolve the ingestion queue from the flow.', { details: { flow_id } });
+            }
+            const writer = createQueueWriter(rsdk, botId, queueName, () => new StreamingError('Cannot write to a closed FlowWriter. Create a new writer via flows.get_writer().', { details: { flow_id } }));
+            // Optional per-event definition validation wraps the passthrough writer.
+            const validate = options?.validate_definition === true && !!options?.definition;
+            if (!validate)
+                return writer;
+            const onError = options?.on_validation_error ?? 'reject';
+            return {
+                write(event, writeOptions) {
+                    if (options?.definition) {
+                        const errors = validateEventAgainstDefinition(event, options.definition);
+                        if (errors.length > 0) {
+                            if (onError === 'reject') {
+                                throw new DefinitionValidationError('Event failed definition validation', options.definition_version ?? '', errors);
+                            }
+                            if (onError === 'warn') {
+                                console.warn('[FlowWriter] Definition validation failed:', errors);
+                            }
+                            if (onError === 'skip')
+                                return;
+                        }
+                    }
+                    writer.write(event, writeOptions);
+                },
+                close: () => writer.close(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=flows.js.map

package/dist/client/flows.js.map

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

package/dist/client/index.d.ts

@@ -3,6 +3,7 @@ export type { LoxtepClientOptions, AuthOptions, MetricsOptions } from './types.j
 export type { LoxtepStreamRuntime, ConfigurationResources } from '../rstreams/leo-runtime.js';
 export type { MetricsSurface, FromWorkspaceOptions } from './loxtep-client.js';
 export type { RateLimitInfo } from '../http/client.js';
+export type { ApprovalRequest, ApprovalStatus, ApprovalsListResponse, ApprovalsListFilters, ApprovalDecisionResult, } from './approvals-types.js';
 export type { DataProduct, DataProductKind, DataProductCreateInput, DataProductsListFilters, DataProductGetOptions, DataProductsListResponse, DataProductsSearchResponse, DataProductStreamOptions, DataProductReplayOptions, StreamEvent, DataProductQueryResult, DataProductListTablesResult, DataProductTableInfo, PaginationMeta, SearchResultItem, GlossaryTermValue, DataProductLexicon, UsageMapNode, UsageMapEdge, UsageMapResponse, } from './data-products-types.js';
 export type { QueueMetadata, QueueCheckpoint, QueueReader, QueueWriter, ReaderCheckpoint, QueueReaderOpenOptions, QueueReaderHandle, QueueWriterHandle, QueueEvent, } from './queue-types.js';
 export type { Trigger, TriggerCreateInput, TriggerUpdateInput, TriggersListFilters, TriggerTestResult, } from './trigger-types.js';
@@ -27,6 +28,16 @@ export type { Improvement, ImprovementStatus, ImprovementsListFilters, Improveme
 export type { ImprovementsApi } from './improvements.js';
 export type { ActivityEntry, ActivityEntryKind, ActivityListFilters, ActivityListResponse, ActivityOutcome, ActivitySource, } from './activity-types.js';
 export type { ActivityApi } from './activity.js';
+export type { ConnectFacade } from './connect.js';
+export type { WorkspaceFacade } from './workspace.js';
+export type { BuildFacade } from './build.js';
+export type { DefineFacade } from './define.js';
+export type { MeaningFacade } from './meaning.js';
+export type { ReviewFacade } from './review.js';
+export type { QueryFacade } from './query.js';
+export type { ObserveFacade } from './observe-facade.js';
+export type { ContextFacade } from './context.js';
+export type { CurrentUser, CurrentOrganization } from './session.js';
 export type { ProjectVersionMetadata, VersionDiff } from './versions-types.js';
 export type { DataProductWriterOptions, DataProductReaderOptions } from './data-products.js';
 export { DataProductResolver, AmbiguityError } from './data-product-resolver.js';

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

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

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA6ClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA+GrE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoDlD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAyHrE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/client/loxtep-client.d.ts

@@ -1,29 +1,20 @@
 import type { AwsCredentialIdentity } from '@smithy/types';
 import type { LoxtepClientOptions } from './types.js';
 import { type RateLimitInfo } from '../http/client.js';
-import { createDataProductsApi } from './data-products.js';
-import { createQueuesApi } from './queues.js';
-import { createTriggersApi } from './triggers.js';
-import { createQualityApi } from './quality.js';
-import { createCatalogApi } from './catalog.js';
-import { createSchemasApi } from './schemas.js';
-import { createDiscoveryApi } from './discovery.js';
-import { type WorkflowsApi } from './workflows.js';
-import { createProjectsApi } from './projects.js';
-import { createTemplatesApi } from './templates.js';
-import { createObserveApi } from './observe.js';
-import { createThesaurusApi } from './thesaurus.js';
-import { createProcessIntelligenceApi } from './process-intelligence.js';
-import { type TargetsApi } from './targets.js';
-import { createConnectorsApi } from './connectors.js';
-import { createInstancesApi } from './instances.js';
-import { createProceduresApi } from './procedures.js';
-import { createDomainsApi } from './domains.js';
-import { createStandardsApi } from './standards.js';
-import { createPromisesApi } from './promises.js';
-import { type ImprovementsApi } from './improvements.js';
-import { type ActivityApi } from './activity.js';
+import type { DataProductWriterOptions, DataProductReaderOptions } from './data-products.js';
+import { createSessionApi } from './session.js';
+import { createConnectFacade } from './connect.js';
+import { createWorkspaceFacade } from './workspace.js';
+import { createBuildFacade } from './build.js';
+import { createDefineFacade } from './define.js';
+import { createMeaningFacade } from './meaning.js';
+import { createReviewFacade } from './review.js';
+import { createQueryFacade } from './query.js';
+import { createObserveFacade } from './observe-facade.js';
+import { createContextFacade } from './context.js';
 import type { RStreamsSdk } from '../rstreams/leo-runtime.js';
+import type { FlowWriter } from './flow-types.js';
+import type { StreamEvent } from './data-products-types.js';
 /** Metrics surface: log and get_reporter (optional Loxtep metrics integration). */
 export interface MetricsSurface {
     log: (metric: {
@@ -58,11 +49,9 @@ export interface FromWorkspaceOptions {
     debug?: (message: string) => void;
 }
 /**
- * Main SDK client. Public surface uses customer-facing terminology grouped by
- * the ingest → define → deliver journey: triggers, connectors, workflows,
- * data_products (writer/reader), schemas, quality, catalog, discovery, domains,
- * standards, data_contracts, thesaurus, procedures, targets. Plus advanced
- * surfaces: projects, templates, instances, observe, queues, metrics.
+ * Main SDK client. Ten namespaces mirror hosted MCP tool facades:
+ * session, connect, workspace, build, define, meaning, review, query, observe, context.
+ * Top-level `get_writer` / `get_reader` resolve data products for stream I/O.
  */
 export declare class LoxtepClient {
     readonly api_url: string;
@@ -72,67 +61,37 @@ export declare class LoxtepClient {
     readonly instance_id?: string;
     private readonly _http;
     private readonly _resolver;
+    private readonly _dataProductsApi;
+    private readonly _workflowsApi;
     private _rsdk?;
     private _rsdkResolutionAttempted;
-    /** Data products (backend: data products). get, list, search. */
-    readonly data_products: ReturnType<typeof createDataProductsApi>;
-    /** Workflows (backend: workflows); project-scoped DAG of nodes. list, get (with nodes), create, get_graph, deploy. */
-    readonly workflows: WorkflowsApi;
-    /** Observe: status (bots / observability). */
-    readonly observe: ReturnType<typeof createObserveApi>;
-    /** Projects: list, get, create, update, delete (workflows MS). */
-    readonly projects: ReturnType<typeof createProjectsApi>;
-    /** Templates: list, get (catalog). Apply via projects.apply_template(project_id, body). */
-    readonly templates: ReturnType<typeof createTemplatesApi>;
-    /** Domains. */
-    readonly domains: ReturnType<typeof createDomainsApi>;
-    /** Standards (backend: data standards). */
-    readonly standards: ReturnType<typeof createStandardsApi>;
-    /** Data contracts (backend: datacontracts). */
-    readonly data_contracts: ReturnType<typeof createPromisesApi>;
-    /** Triggers (ingest source bindings; backend: connections): get, list, create, update, delete, test. */
-    readonly triggers: ReturnType<typeof createTriggersApi>;
-    /** Queues: get_queue_metadata, get_reader_checkpoint, open_reader, open_writer. */
-    readonly queues: ReturnType<typeof createQueuesApi>;
-    /** Quality metrics: list, get, create. */
-    readonly quality: ReturnType<typeof createQualityApi>;
-    /** Catalog (search): search. */
-    readonly catalog: ReturnType<typeof createCatalogApi>;
-    /** Discovery (MCP tools): search with include_evidence/include_lineage, get_evidence, get_lineage_impact, get_governance_flags, run. */
-    readonly discovery: ReturnType<typeof createDiscoveryApi>;
-    /** Schemas (data product schema): get, list, tag_pii_fields. */
-    readonly schemas: ReturnType<typeof createSchemasApi>;
-    /** Thesaurus (canonical correlation keys + aliases): list_terms, resolve_canonical_key, append_synonym. */
-    readonly thesaurus: ReturnType<typeof createThesaurusApi>;
-    /**
-     * @internal
-     * Process Intelligence: decisionTraces.list (optional anchor params). LOX-1478.
-     * Experimental — excluded from the documented surface.
-     */
-    readonly process_intelligence: ReturnType<typeof createProcessIntelligenceApi>;
-    /** Targets (delivery sink bindings): list, get, create, update, delete. How data products deliver data externally. */
-    readonly targets: TargetsApi;
-    /** Connectors (organization-level): list, get, create, update, delete, test, get_oauth_url. */
-    readonly connectors: ReturnType<typeof createConnectorsApi>;
-    /** Instances (organization-level): list, get. */
-    readonly instances: ReturnType<typeof createInstancesApi>;
-    /** Procedures (process graph): list. */
-    readonly procedures: ReturnType<typeof createProceduresApi>;
-    /**
-     * @internal
-     * Improvements (AI Eval self-improvement): list, apply, reject (R8.3–R8.6).
-     * Experimental — excluded from the documented surface.
-     */
-    readonly improvements: ImprovementsApi;
-    /**
-     * @internal
-     * Activity & observability: list activity/audit entries (R7.4, R18.5).
-     * Experimental — excluded from the documented surface.
-     */
-    readonly activity: ActivityApi;
+    /** Session & org context (MCP: loxtep_session). */
+    readonly session: ReturnType<typeof createSessionApi>;
+    /** Connectors + templates (MCP: loxtep_connect). */
+    readonly connect: ReturnType<typeof createConnectFacade>;
+    /** Projects, instances, versions (MCP: loxtep_workspace). */
+    readonly workspace: ReturnType<typeof createWorkspaceFacade>;
+    /** Workflows, triggers, data products, targets, deploy (MCP: loxtep_build). */
+    readonly build: ReturnType<typeof createBuildFacade>;
+    /** Schemas, quality, standards, contracts, domains (MCP: loxtep_define). */
+    readonly define: ReturnType<typeof createDefineFacade>;
+    /** Thesaurus / ontology vocabulary (MCP: loxtep_meaning). */
+    readonly meaning: ReturnType<typeof createMeaningFacade>;
+    /** Approvals + improvements (MCP: loxtep_review). */
+    readonly review: ReturnType<typeof createReviewFacade>;
+    /** Catalog, discovery, analytics query (MCP: loxtep_query). */
+    readonly query: ReturnType<typeof createQueryFacade>;
+    /** Observe status + queue I/O (MCP: loxtep_observe). */
+    readonly observe: ReturnType<typeof createObserveFacade>;
+    /** Process intelligence, procedures, activity (MCP: loxtep_context). */
+    readonly context: ReturnType<typeof createContextFacade>;
     /** Metrics: log, get_reporter (stub until metrics wiring is added). */
     readonly metrics: MetricsSurface;
     constructor(options: LoxtepClientOptions);
+    /** Resolve a data product writer by name or id (delegates to data-products stream logic). */
+    get_writer(name_or_id: string, options?: DataProductWriterOptions): Promise<FlowWriter>;
+    /** Resolve a data product reader by name or id (delegates to data-products stream logic). */
+    get_reader(name_or_id: string, options?: DataProductReaderOptions): Promise<AsyncIterable<StreamEvent>>;
     /** Update SigV4 credentials used by the HTTP layer (e.g. CLI after refresh returns STS). */
     set_aws_credentials(credentials: AwsCredentialIdentity | null): void;
     /**

package/dist/client/loxtep-client.d.ts.map

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