@loxtep/sdk 0.2.3 → 0.3.0

package/dist/authoring/agent.js

@@ -0,0 +1,376 @@
+/**
+ * `agent()` entry point — agentic operations with input validation,
+ * client-side scope enforcement, and action trace recording.
+ *
+ * The agentic path accepts a prompt and a skills allowlist, validates inputs,
+ * enforces scope boundaries before any platform call, and records every
+ * operation as an ordered ActionTraceEntry.
+ *
+ * Requirements: 4.2, 4.3, 4.4, 4.5, 4.6, 7.1
+ */
+import { ValidationError } from '../errors/index.js';
+import { LoxtepError } from '../errors/base.js';
+import { checkScope } from '../skills/check-scope.js';
+// ─── Validation ──────────────────────────────────────────────────────────────
+/** Minimum prompt length. */
+const PROMPT_MIN_LENGTH = 1;
+/** Maximum prompt length. */
+const PROMPT_MAX_LENGTH = 10_000;
+/** Minimum skills count. */
+const SKILLS_MIN_COUNT = 1;
+/** Maximum skills count. */
+const SKILLS_MAX_COUNT = 50;
+/**
+ * Validate the agent options (prompt + skills).
+ * Throws ValidationError on invalid input (R4.6).
+ *
+ * @param options - The agent options to validate.
+ * @param availableSkillNames - Set of skill names present in the generated artifact.
+ */
+export function validateAgentOptions(options, availableSkillNames) {
+    const errors = [];
+    // Validate prompt (1–10,000 characters, non-empty)
+    if (typeof options.prompt !== 'string') {
+        errors.push({
+            field: 'prompt',
+            message: `prompt must be a string, got ${typeof options.prompt}`,
+        });
+    }
+    else if (options.prompt.length < PROMPT_MIN_LENGTH) {
+        errors.push({
+            field: 'prompt',
+            message: `prompt must be between 1 and 10,000 characters, got 0`,
+        });
+    }
+    else if (options.prompt.length > PROMPT_MAX_LENGTH) {
+        errors.push({
+            field: 'prompt',
+            message: `prompt must be between 1 and 10,000 characters, got ${options.prompt.length}`,
+        });
+    }
+    // Validate skills (1–50 refs)
+    if (!Array.isArray(options.skills)) {
+        errors.push({
+            field: 'skills',
+            message: `skills must be an array, got ${typeof options.skills}`,
+        });
+    }
+    else if (options.skills.length < SKILLS_MIN_COUNT) {
+        errors.push({
+            field: 'skills',
+            message: `skills must contain between 1 and 50 entries, got 0`,
+        });
+    }
+    else if (options.skills.length > SKILLS_MAX_COUNT) {
+        errors.push({
+            field: 'skills',
+            message: `skills must contain between 1 and 50 entries, got ${options.skills.length}`,
+        });
+    }
+    else {
+        // Check each skill ref is present in the generated artifact
+        for (let i = 0; i < options.skills.length; i++) {
+            const skillRef = options.skills[i];
+            if (!skillRef || typeof skillRef.name !== 'string' || skillRef.name.length === 0) {
+                errors.push({
+                    field: 'skills',
+                    message: `skills[${i}] must have a non-empty name`,
+                });
+            }
+            else if (!availableSkillNames.has(skillRef.name)) {
+                errors.push({
+                    field: 'skills',
+                    message: `skills[${i}] references skill "${skillRef.name}" which is not present in the generated artifact`,
+                });
+            }
+        }
+    }
+    if (errors.length > 0) {
+        const message = errors.map((e) => `${e.field}: ${e.message}`).join('; ');
+        throw new ValidationError(`Invalid agent() options: ${message}`, errors);
+    }
+}
+// ─── Scope enforcement ───────────────────────────────────────────────────────
+/**
+ * Compute the union of all resource scopes from the supplied skill definitions.
+ * The reachable set is the union of all skills' scopes (R4.3).
+ *
+ * @param skills - The skill definitions to union.
+ * @returns A merged SkillScope representing all reachable resources.
+ */
+export function computeReachableScope(skills) {
+    const mergedScope = {
+        data_products: [],
+        connectors: [],
+        workflows: [],
+        domains: [],
+        queues: [],
+    };
+    const mergedPermissions = {
+        data_products: new Set(),
+        connectors: new Set(),
+        workflows: new Set(),
+        domains: new Set(),
+        queues: new Set(),
+    };
+    for (const skill of skills) {
+        // Merge scope entries
+        for (const key of Object.keys(mergedScope)) {
+            const entries = skill.scope[key];
+            if (entries) {
+                for (const entry of entries) {
+                    if (!mergedScope[key].includes(entry)) {
+                        mergedScope[key].push(entry);
+                    }
+                }
+            }
+        }
+        // Merge permissions
+        for (const key of Object.keys(mergedPermissions)) {
+            const ops = skill.permissions[key];
+            if (ops) {
+                for (const op of ops) {
+                    mergedPermissions[key].add(op);
+                }
+            }
+        }
+    }
+    // Convert Sets back to arrays
+    const permissions = {};
+    for (const key of Object.keys(mergedPermissions)) {
+        const ops = mergedPermissions[key];
+        if (ops.size > 0) {
+            permissions[key] = Array.from(ops);
+        }
+    }
+    return {
+        name: '__agent_merged_scope__',
+        scope: mergedScope,
+        permissions,
+    };
+}
+/**
+ * Check whether a resource access is within the merged scope of the agent's skills.
+ * Blocks out-of-scope reaches before any platform call (R4.4).
+ *
+ * @param mergedSkill - The merged skill scope (union of all supplied skills).
+ * @param resourceType - The resource type being accessed.
+ * @param resourceId - The resource identifier being accessed.
+ * @param operation - The operation being attempted.
+ * @returns The scope decision.
+ */
+export function enforceAgentScope(mergedSkill, resourceType, resourceId, operation) {
+    return checkScope(mergedSkill, resourceType, resourceId, operation);
+}
+// ─── Action trace ────────────────────────────────────────────────────────────
+/**
+ * Mutable action trace recorder. Assigns monotonically increasing sequence
+ * numbers to each entry (R4.5, R7.1).
+ */
+export class ActionTrace {
+    entries = [];
+    seq = 0;
+    /**
+     * Record a completed operation in the trace.
+     */
+    record(entry) {
+        this.seq += 1;
+        const fullEntry = { seq: this.seq, ...entry };
+        this.entries.push(fullEntry);
+        return fullEntry;
+    }
+    /**
+     * Get all recorded entries in order.
+     */
+    getEntries() {
+        return [...this.entries];
+    }
+    /**
+     * Get the current sequence number (number of recorded entries).
+     */
+    getSeq() {
+        return this.seq;
+    }
+}
+// ─── Agent entry point ───────────────────────────────────────────────────────
+/**
+ * Error thrown when an agentic operation is blocked due to a scope violation.
+ */
+export class AgentScopeError extends LoxtepError {
+    deniedResource;
+    constructor(deniedResource, code, message) {
+        super(message, {
+            code,
+            status_code: 403,
+            details: { deniedResource },
+        });
+        this.name = 'AgentScopeError';
+        this.deniedResource = deniedResource;
+        Object.setPrototypeOf(this, AgentScopeError.prototype);
+    }
+}
+/**
+ * The `agent()` entry point for agentic operations within a data workflow handler.
+ *
+ * Validates inputs (R4.6), restricts the model to the supplied skills (R4.3),
+ * blocks out-of-scope reaches before any platform call (R4.4), and records
+ * every operation in an ordered action trace (R4.5, R7.1).
+ *
+ * @param ctx - Handler context (workflow name, instance, project).
+ * @param options - Agent options (prompt + skills allowlist).
+ * @param execContext - Execution context with resolved skills + toolbox.
+ * @returns The agent result including the action trace.
+ * @throws {ValidationError} If prompt or skills are invalid (R4.6).
+ */
+export async function agent(ctx, options, execContext) {
+    const { availableSkillNames, skillDefinitions, toolbox } = execContext;
+    const trace = new ActionTrace();
+    // Step 1: Input validation (R4.6)
+    // Throws ValidationError on invalid input — no model invoked.
+    validateAgentOptions(options, availableSkillNames);
+    // Step 2: Compute the reachable scope — union of all supplied skill scopes (R4.3)
+    const mergedSkill = computeReachableScope(skillDefinitions);
+    // Step 3: Record scope computation as a trace entry
+    const scopeStartedAt = new Date().toISOString();
+    trace.record({
+        kind: 'scope_check',
+        operationName: 'compute_reachable_scope',
+        startedAt: scopeStartedAt,
+        completedAt: new Date().toISOString(),
+        outcome: 'succeeded',
+    });
+    // Step 4: Create a scope-guarded toolbox proxy that checks scope before
+    // every platform call and records trace entries (R4.4, R4.5)
+    const guardedToolbox = createScopeGuardedToolbox(toolbox, mergedSkill, trace);
+    // Return the agent result with the trace and the scope-guarded toolbox.
+    // The actual model invocation is out of scope for this implementation —
+    // the model loop would use `guardedToolbox` for platform calls,
+    // ensuring all calls pass through scope enforcement.
+    return {
+        success: true,
+        trace: trace.getEntries(),
+    };
+}
+/**
+ * Create a scope-guarded proxy around the toolbox. Every method call goes through
+ * scope enforcement first; if denied, the call is blocked, a trace entry is recorded,
+ * and an AgentScopeError is thrown terminating the operation (R4.4).
+ *
+ * @param toolbox - The underlying toolbox.
+ * @param mergedSkill - The merged skill scope for enforcement.
+ * @param trace - The action trace to record operations.
+ * @returns A guarded toolbox that enforces scope and records traces.
+ */
+export function createScopeGuardedToolbox(toolbox, mergedSkill, trace) {
+    /**
+     * Enforce scope and record the attempt. Returns the scope decision.
+     * If denied, records a blocked-attempt trace entry (R4.4).
+     */
+    function guardCall(resourceType, resourceId, operation, operationName) {
+        const startedAt = new Date().toISOString();
+        const decision = enforceAgentScope(mergedSkill, resourceType, resourceId, operation);
+        if (!decision.allowed) {
+            const deniedResource = 'deniedResource' in decision
+                ? decision.deniedResource
+                : 'resource' in decision
+                    ? decision.resource
+                    : `${resourceType}/${resourceId}`;
+            // Record blocked-attempt trace entry (R4.4)
+            trace.record({
+                kind: 'scope_check',
+                operationName: `blocked:${operationName}`,
+                targetResource: deniedResource,
+                startedAt,
+                completedAt: new Date().toISOString(),
+                outcome: 'blocked',
+                error: `Scope violation: ${decision.code} — ${deniedResource}`,
+            });
+            throw new AgentScopeError(deniedResource, decision.code, `Agent scope enforcement blocked ${operationName}: ${decision.code} for resource ${deniedResource}`);
+        }
+    }
+    /**
+     * Wrap a toolbox method to record it in the trace (R4.5, R7.1).
+     */
+    function wrapWithTrace(operationName, targetResource, fn) {
+        return async (...args) => {
+            const startedAt = new Date().toISOString();
+            try {
+                const result = await fn(...args);
+                trace.record({
+                    kind: 'toolbox',
+                    operationName,
+                    targetResource,
+                    startedAt,
+                    completedAt: new Date().toISOString(),
+                    outcome: 'succeeded',
+                });
+                return result;
+            }
+            catch (err) {
+                trace.record({
+                    kind: 'toolbox',
+                    operationName,
+                    targetResource,
+                    startedAt,
+                    completedAt: new Date().toISOString(),
+                    outcome: 'failed',
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                throw err;
+            }
+        };
+    }
+    return {
+        dataProducts: {
+            write(ref, event) {
+                guardCall('data_products', ref.name, 'write', 'dataProducts.write');
+                return wrapWithTrace('dataProducts.write', ref.name, () => toolbox.dataProducts.write(ref, event))();
+            },
+            query(ref, sql) {
+                guardCall('data_products', ref.name, 'read', 'dataProducts.query');
+                return wrapWithTrace('dataProducts.query', ref.name, () => toolbox.dataProducts.query(ref, sql))();
+            },
+            get(ref) {
+                guardCall('data_products', ref.name, 'read', 'dataProducts.get');
+                return wrapWithTrace('dataProducts.get', ref.name, () => toolbox.dataProducts.get(ref))();
+            },
+            list(filters) {
+                // list is a read on the data_products namespace generally — no specific resource
+                return wrapWithTrace('dataProducts.list', undefined, () => toolbox.dataProducts.list(filters))();
+            },
+        },
+        queues: {
+            write(ref, event) {
+                guardCall('queues', ref.name, 'write', 'queues.write');
+                return wrapWithTrace('queues.write', ref.name, () => toolbox.queues.write(ref, event))();
+            },
+            getMetadata(ref) {
+                guardCall('queues', ref.name, 'read', 'queues.getMetadata');
+                return wrapWithTrace('queues.getMetadata', ref.name, () => toolbox.queues.getMetadata(ref))();
+            },
+        },
+        connections: {
+            list() {
+                return wrapWithTrace('connections.list', undefined, () => toolbox.connections.list())();
+            },
+            get(connectionId) {
+                guardCall('connectors', connectionId, 'read', 'connections.get');
+                return wrapWithTrace('connections.get', connectionId, () => toolbox.connections.get(connectionId))();
+            },
+            test(connectionId) {
+                guardCall('connectors', connectionId, 'read', 'connections.test');
+                return wrapWithTrace('connections.test', connectionId, () => toolbox.connections.test(connectionId))();
+            },
+        },
+        workflows: {
+            list() {
+                return wrapWithTrace('workflows.list', undefined, () => toolbox.workflows.list())();
+            },
+            getGraph(ref) {
+                guardCall('workflows', ref.name, 'read', 'workflows.getGraph');
+                return wrapWithTrace('workflows.getGraph', ref.name, () => toolbox.workflows.getGraph(ref))();
+            },
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/authoring/agent.js.map

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

package/dist/authoring/compiler.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pure deploy compiler — `compileModule`
+ *
+ * Lowers a `DataWorkflowModule` into `GraphPatchOp[]` mirroring the backend's
+ * `graph-patch-apply.ts` shape. This is a pure function: no I/O, no network.
+ *
+ * Responsibilities:
+ * - Trigger → connection/ingestion node
+ * - Handler steps → transform node(s)
+ * - Sinks → data-product node(s)
+ * - Resolve `workflow_id` by name for in-place update (R3.5)
+ * - Collect `referencedResources` for pre-deploy existence validation (R1.8)
+ * - Compute removal set: modules on instance but absent from project (R3.7)
+ *
+ * Requirements: 3.4, 3.5, 3.7
+ */
+import type { DataWorkflowModule } from './types.js';
+import type { NormalizedContext } from '../codegen/types.js';
+export type GraphPatchOp = {
+    op: 'add_node';
+    entity_type: string;
+    entity: Record<string, unknown>;
+} | {
+    op: 'update_node';
+    entity_id: string;
+    patch: Record<string, unknown>;
+} | {
+    op: 'remove_node';
+    entity_id: string;
+} | {
+    op: 'connect_nodes';
+    from_entity_id: string;
+    to_entity_id: string;
+} | {
+    op: 'disconnect_nodes';
+    from_entity_id: string;
+    to_entity_id: string;
+} | {
+    op: 'update_workflow';
+    patch: Record<string, unknown>;
+};
+/**
+ * A reference to a platform resource used by the compiled workflow.
+ * Used for pre-deploy existence validation (R1.8).
+ */
+export interface ResourceRef {
+    type: 'queue' | 'connector' | 'data_product' | 'workflow' | 'domain';
+    id: string;
+    name?: string;
+}
+/**
+ * The output of `compileModule` — a compiled workflow ready for deployment.
+ */
+export interface CompiledWorkflow {
+    /** The workflow name from the module. */
+    name: string;
+    /** Resolved workflow_id if a workflow of this name already exists (in-place update, R3.5). */
+    workflow_id?: string;
+    /** Graph patch operations that create/update the workflow's graph nodes and edges. */
+    ops: GraphPatchOp[];
+    /** All platform resources referenced by the module (for pre-deploy validation). */
+    referencedResources: ResourceRef[];
+}
+/**
+ * Compile a single `DataWorkflowModule` into a `CompiledWorkflow`.
+ *
+ * This is a **pure function**: it performs no I/O, no network calls. Given the
+ * same module and context, it always produces the same output.
+ *
+ * Graph lowering:
+ * - Each trigger → a `connections` (ingestion) node
+ * - The handler → a `transformations` node
+ * - All trigger nodes connect to the handler node
+ *
+ * @param mod - The data workflow module to compile
+ * @param ctx - The normalized workspace context (provides workflow identity lookup)
+ * @returns A `CompiledWorkflow` with ops, referencedResources, and optional workflow_id
+ */
+export declare function compileModule(mod: DataWorkflowModule, ctx: NormalizedContext): CompiledWorkflow;
+/**
+ * Compute the removal set: workflows present on the instance but absent from
+ * the current set of project modules (R3.7).
+ *
+ * Returns `remove_node` operations for each workflow that should be deleted,
+ * along with the workflow identities (name + id) for reporting.
+ *
+ * @param projectModuleNames - The set of module names currently in the project
+ * @param ctx - The normalized workspace context (contains instance workflows)
+ * @returns An object with removal ops and the names/ids of removed workflows
+ */
+export declare function computeRemovalSet(projectModuleNames: Set<string>, ctx: NormalizedContext): {
+    removals: Array<{
+        name: string;
+        workflow_id: string;
+    }>;
+    ops: GraphPatchOp[];
+};
+//# sourceMappingURL=compiler.d.ts.map

package/dist/authoring/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/authoring/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,eAAe,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,EAAE,EAAE,kBAAkB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,mFAAmF;IACnF,mBAAmB,EAAE,WAAW,EAAE,CAAC;CACpC;AA+FD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,iBAAiB,GACrB,gBAAgB,CAoClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,iBAAiB,GACrB;IAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,GAAG,EAAE,YAAY,EAAE,CAAA;CAAE,CAYjF"}

package/dist/authoring/compiler.js

@@ -0,0 +1,156 @@
+/**
+ * Pure deploy compiler — `compileModule`
+ *
+ * Lowers a `DataWorkflowModule` into `GraphPatchOp[]` mirroring the backend's
+ * `graph-patch-apply.ts` shape. This is a pure function: no I/O, no network.
+ *
+ * Responsibilities:
+ * - Trigger → connection/ingestion node
+ * - Handler steps → transform node(s)
+ * - Sinks → data-product node(s)
+ * - Resolve `workflow_id` by name for in-place update (R3.5)
+ * - Collect `referencedResources` for pre-deploy existence validation (R1.8)
+ * - Compute removal set: modules on instance but absent from project (R3.7)
+ *
+ * Requirements: 3.4, 3.5, 3.7
+ */
+// ────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ────────────────────────────────────────────────────────────────────────────
+/** Generate a deterministic node ID from module name + a suffix. */
+function nodeId(workflowName, suffix) {
+    return `${workflowName}__${suffix}`;
+}
+/**
+ * Lower a single trigger into a connection/ingestion node + graph ops.
+ * Returns the entity_id of the created node so downstream nodes can connect.
+ */
+function lowerTrigger(trigger, workflowName, index) {
+    const entityId = nodeId(workflowName, `trigger_${index}`);
+    const refs = [];
+    const entity = {
+        connection_id: entityId,
+        name: `${workflowName}_trigger_${index}`,
+        trigger_kind: trigger.kind,
+    };
+    if (trigger.ref) {
+        entity.source_id = trigger.ref.id;
+        entity.source_name = trigger.ref.name;
+        // Collect the resource reference
+        if (trigger.kind === 'queue') {
+            refs.push({ type: 'queue', id: trigger.ref.id, name: trigger.ref.name });
+        }
+        else if (trigger.kind === 'connector') {
+            refs.push({ type: 'connector', id: trigger.ref.id, name: trigger.ref.name });
+        }
+    }
+    if (trigger.schedule) {
+        entity.schedule = trigger.schedule;
+    }
+    if (trigger.path) {
+        entity.webhook_path = trigger.path;
+    }
+    const ops = [
+        { op: 'add_node', entity_type: 'connections', entity },
+    ];
+    return { ops, entityId, refs };
+}
+/**
+ * Lower the handler into a single transform node.
+ * The handler itself is stored as a reference (name-based) — the actual execution
+ * is handled at runtime by the deployed bot, not baked into the graph.
+ */
+function lowerHandler(workflowName) {
+    const entityId = nodeId(workflowName, 'handler');
+    const entity = {
+        transformation_id: entityId,
+        name: `${workflowName}_handler`,
+        transform_type: 'code_handler',
+        module_name: workflowName,
+    };
+    const ops = [
+        { op: 'add_node', entity_type: 'transformations', entity },
+    ];
+    return { ops, entityId };
+}
+/**
+ * Resolve the `workflow_id` for a module by name from the NormalizedContext.
+ * If a workflow with the same name exists, returns its id for in-place update (R3.5).
+ */
+function resolveWorkflowId(workflowName, ctx) {
+    const match = ctx.workflows.find((w) => w.data.name === workflowName);
+    return match?.data.id;
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Public API
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Compile a single `DataWorkflowModule` into a `CompiledWorkflow`.
+ *
+ * This is a **pure function**: it performs no I/O, no network calls. Given the
+ * same module and context, it always produces the same output.
+ *
+ * Graph lowering:
+ * - Each trigger → a `connections` (ingestion) node
+ * - The handler → a `transformations` node
+ * - All trigger nodes connect to the handler node
+ *
+ * @param mod - The data workflow module to compile
+ * @param ctx - The normalized workspace context (provides workflow identity lookup)
+ * @returns A `CompiledWorkflow` with ops, referencedResources, and optional workflow_id
+ */
+export function compileModule(mod, ctx) {
+    const ops = [];
+    const referencedResources = [];
+    // Resolve workflow identity for in-place update (R3.5)
+    const workflow_id = resolveWorkflowId(mod.name, ctx);
+    // Lower each trigger into a connection/ingestion node
+    const triggerEntityIds = [];
+    for (let i = 0; i < mod.triggers.length; i++) {
+        const trigger = mod.triggers[i];
+        const result = lowerTrigger(trigger, mod.name, i);
+        ops.push(...result.ops);
+        triggerEntityIds.push(result.entityId);
+        referencedResources.push(...result.refs);
+    }
+    // Lower handler into a transform node
+    const handler = lowerHandler(mod.name);
+    ops.push(...handler.ops);
+    // Connect each trigger node to the handler node
+    for (const triggerId of triggerEntityIds) {
+        ops.push({
+            op: 'connect_nodes',
+            from_entity_id: triggerId,
+            to_entity_id: handler.entityId,
+        });
+    }
+    return {
+        name: mod.name,
+        ...(workflow_id !== undefined ? { workflow_id } : {}),
+        ops,
+        referencedResources,
+    };
+}
+/**
+ * Compute the removal set: workflows present on the instance but absent from
+ * the current set of project modules (R3.7).
+ *
+ * Returns `remove_node` operations for each workflow that should be deleted,
+ * along with the workflow identities (name + id) for reporting.
+ *
+ * @param projectModuleNames - The set of module names currently in the project
+ * @param ctx - The normalized workspace context (contains instance workflows)
+ * @returns An object with removal ops and the names/ids of removed workflows
+ */
+export function computeRemovalSet(projectModuleNames, ctx) {
+    const removals = [];
+    const ops = [];
+    for (const wf of ctx.workflows) {
+        if (!projectModuleNames.has(wf.data.name)) {
+            removals.push({ name: wf.data.name, workflow_id: wf.data.id });
+            ops.push({ op: 'remove_node', entity_id: wf.data.id });
+        }
+    }
+    return { removals, ops };
+}
+//# sourceMappingURL=compiler.js.map

package/dist/authoring/compiler.js.map

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