@meistrari/tela-cli 1.2.1 → 1.3.0

package/dist/index.js

@@ -129552,12 +129552,13 @@ var require_generate = __commonJS({
       const lines = [
         "/* eslint-disable */",
         `// @generated by tela workflow codegen; catalog-metadata-hash: ${snapshot.metadataHash}`,
-        "import type { WorkflowCodeFileInputValue, WorkflowCodeRemoteAgentRef, WorkflowCodeRemoteExecutableRef, WorkflowCodeRemoteModelRef } from '@meistrari/workflow-code/contracts'",
+        "import type { WorkflowCodeFileInputValue, WorkflowCodeRemoteAgentRef, WorkflowCodeRemoteExecutableRef, WorkflowCodeRemoteModelRef, WorkflowCodeRemoteTemplateRef } from '@meistrari/workflow-code/contracts'",
         "",
         "declare module '@meistrari/workflow-code' {",
         "  function remote(): {",
         "    canvas(): WorkflowCodeRemoteCatalogRegistry['canvas']",
         "    workflow(): WorkflowCodeRemoteCatalogRegistry['workflow']",
+        "    template(): WorkflowCodeRemoteCatalogRegistry['template']",
         "    agent(): WorkflowCodeRemoteCatalogRegistry['agent']",
         "    models(): WorkflowCodeRemoteCatalogRegistry['models']",
         "  }",
@@ -129565,6 +129566,7 @@ var require_generate = __commonJS({
         "  interface WorkflowCodeRemoteCatalogRegistry {",
         `    canvas: ${renderResourceRegistry("canvas", normalizeResources(snapshot.catalogs.canvases), diagnostics)}`,
         `    workflow: ${renderResourceRegistry("workflow", normalizeResources(snapshot.catalogs.workflows), diagnostics)}`,
+        `    template: ${renderResourceRegistry("template", normalizeResources(snapshot.catalogs.templates), diagnostics)}`,
         `    agent: ${renderResourceRegistry("agent", normalizeResources(snapshot.catalogs.agents), diagnostics)}`,
         `    models: ${renderModelRegistry(snapshot.catalogs.llmModels)}`,
         "  }",
@@ -129576,7 +129578,7 @@ var require_generate = __commonJS({
     function renderResourceRegistry(kind, resources, diagnostics) {
       const nameTree = buildNameTree(resources.filter(hasUniquePath).map((resource) => ({ path: resource.path, value: renderResourceRef(kind, resource) })));
       const byId = resources.map((resource) => `byId(id: ${quote(resource.id)}): ${renderResourceRef(kind, resource)}`).join("; ");
-      const unknownRef = kind === "agent" ? "WorkflowCodeRemoteAgentRef<string, unknown, unknown>" : `WorkflowCodeRemoteExecutableRef<${quote(kind)}, string, unknown, unknown, {}>`;
+      const unknownRef = kind === "agent" ? "WorkflowCodeRemoteAgentRef<string, unknown, unknown>" : kind === "template" ? "WorkflowCodeRemoteTemplateRef<string, unknown, unknown>" : `WorkflowCodeRemoteExecutableRef<${quote(kind)}, string, unknown, unknown, {}>`;
       const members = [renderTree(nameTree), byId.length > 0 ? `{ ${byId}; byId(id: string): ${unknownRef} }` : `{ byId(id: string): ${unknownRef} }`];
       for (const resource of resources) {
         if (resource.pathStatus === "ambiguous") {
@@ -129587,13 +129589,14 @@ var require_generate = __commonJS({
     }
     function renderResourceRef(kind, resource) {
       const input = renderInputObject(resource.inputs);
-      const output = isAgent(resource) ? renderAgentOutput(resource) : renderOutput(resource.output);
-      if (!isAgent(resource)) {
-        const environments = resource.targets.map((target) => quote(target.name)).sort().join(" | ") || "never";
-        const targets = resource.targets.map((target) => `${quote(target.name)}: { input: ${renderInputObject(target.inputs)}, output: ${renderOutput(target.output)}, hash: ${quote(target.hash)} }`).join("; ");
-        return `WorkflowCodeRemoteExecutableRef<${quote(kind)}, ${quote(resource.id)}, ${input}, ${output}, { ${targets} }> & { environments: ${environments} }`;
-      }
-      return `WorkflowCodeRemoteAgentRef<${quote(resource.id)}, ${input}, ${output}>`;
+      if (isAgent(resource))
+        return `WorkflowCodeRemoteAgentRef<${quote(resource.id)}, ${input}, ${renderAgentOutput(resource)}>`;
+      const output = renderOutput(resource.output);
+      if (!("targets" in resource))
+        return `WorkflowCodeRemoteTemplateRef<${quote(resource.id)}, ${input}, ${output}>`;
+      const environments = resource.targets.map((target) => quote(target.name)).sort().join(" | ") || "never";
+      const targets = resource.targets.map((target) => `${quote(target.name)}: { input: ${renderInputObject(target.inputs)}, output: ${renderOutput(target.output)}, hash: ${quote(target.hash)} }`).join("; ");
+      return `WorkflowCodeRemoteExecutableRef<${quote(kind)}, ${quote(resource.id)}, ${input}, ${output}, { ${targets} }> & { environments: ${environments} }`;
     }
     function renderModelRegistry(models) {
       const named = Object.fromEntries(models.map((model) => [model.id, `WorkflowCodeRemoteModelRef<${quote(model.id)}, "llm">`]));
@@ -146369,7 +146372,12 @@ var require_remote_refs = __commonJS({
       const catalogDiagnostics = validateAgainstSnapshot(input.mode.snapshot, input.binding, lock, input.modelUsage);
       if (catalogDiagnostics.length > 0)
         return { value: void 0, diagnostics: catalogDiagnostics };
-      return { value: lock.id, diagnostics: [] };
+      const outputSchema = templateOutputSchema(input.mode.snapshot, input.binding, lock.id);
+      return {
+        value: lock.id,
+        diagnostics: [],
+        ...outputSchema === void 0 ? {} : { outputSchema }
+      };
     }
     function findLock(locks, binding, environment) {
       return locks.find((lock) => lock.kind === binding.kind && (binding.explicitId === void 0 || lock.id === binding.explicitId) && (binding.path === void 0 || samePath(lock.path, binding.path)) && (environment === void 0 || lock.environmentName === environment));
@@ -146393,10 +146401,18 @@ var require_remote_refs = __commonJS({
         return snapshot.catalogs.canvases.find((resource) => resource.id === id);
       if (binding.kind === "workflow")
         return snapshot.catalogs.workflows.find((resource) => resource.id === id);
+      if (binding.kind === "template")
+        return snapshot.catalogs.templates.find((resource) => resource.id === id);
       if (binding.kind === "agent")
         return snapshot.catalogs.agents.find((resource) => resource.id === id);
       return snapshot.catalogs.llmModels.find((resource) => resource.id === id);
     }
+    function templateOutputSchema(snapshot, binding, id) {
+      if (binding.kind !== "template")
+        return void 0;
+      const output = snapshot.catalogs.templates.find((resource) => resource.id === id)?.output;
+      return isRecord3(output?.schema) ? output.schema : void 0;
+    }
     function remoteDiagnostic(code, binding, message) {
       return {
         code,
@@ -146406,6 +146422,9 @@ var require_remote_refs = __commonJS({
         hint: `Remote ${binding.kind} ${binding.explicitId ?? binding.path?.join(" / ") ?? "<root>"}`
       };
     }
+    function isRecord3(value) {
+      return typeof value === "object" && value !== null && !Array.isArray(value);
+    }
     function rootFallbackContractHash(input) {
       return (0, hash_1.hashJson)(input);
     }
@@ -146517,8 +146536,27 @@ var require_resolve = __commonJS({
           contractHash: (0, remote_refs_1.agentSemanticContractHash)({ revision: agent.revision, inputs: normalizedInputsForContract(agent.inputs), ...outputHash === void 0 ? {} : { outputContractHash: outputHash } })
         };
       }
+      if (ref.kind === "template")
+        return lockTemplateRef(ref, resource);
       return lockExecutableRef(ref, resource, ref.kind);
     }
+    function lockTemplateRef(ref, resource) {
+      const outputHash = (0, remote_refs_1.outputContractHash)(resource.output);
+      return {
+        declarationKey: ref.declarationKey,
+        kind: "template",
+        ...resource.pathStatus === "unavailable" ? {} : { path: resource.path },
+        id: resource.id,
+        versionId: resource.versionId,
+        inputHash: (0, remote_refs_1.selectedInputHash)(resource.inputs),
+        ...outputHash === void 0 ? {} : { outputContractHash: outputHash },
+        contractHash: (0, remote_refs_1.rootFallbackContractHash)({
+          versionId: resource.versionId,
+          inputs: normalizedInputsForContract(resource.inputs),
+          ...outputHash === void 0 ? {} : { outputContractHash: outputHash }
+        })
+      };
+    }
     function lockExecutableRef(ref, resource, kind) {
       const environmentName = ref.environment ?? resource.environment ?? (resource.targets.length === 1 ? resource.targets[0]?.name : void 0);
       const target = environmentName === void 0 ? void 0 : resource.targets.find((item) => item.name === environmentName);
@@ -146624,6 +146662,8 @@ var require_resolve = __commonJS({
     function selectedInputs(resource, ref, diagnostics) {
       if (ref.kind === "agent")
         return resource.inputs;
+      if (ref.kind === "template")
+        return resource.inputs;
       const executable = resource;
       const environmentName = ref.environment ?? executable.environment ?? (executable.targets.length === 1 ? executable.targets[0]?.name : void 0);
       if (environmentName === void 0)
@@ -146639,6 +146679,8 @@ var require_resolve = __commonJS({
         return snapshot.catalogs.canvases;
       if (kind === "workflow")
         return snapshot.catalogs.workflows;
+      if (kind === "template")
+        return snapshot.catalogs.templates;
       if (kind === "agent")
         return snapshot.catalogs.agents;
       return snapshot.catalogs.llmModels;
@@ -154668,6 +154710,7 @@ var require_remote = __commonJS({
       return Object.freeze({
         canvas: () => createRemoteRef("canvas"),
         workflow: () => createRemoteRef("workflow"),
+        template: () => createRemoteRef("template"),
         agent: () => createRemoteRef("agent"),
         models: () => createRemoteRef("model")
       });
@@ -368743,6 +368786,7 @@ var require_output_schema = __commonJS({
     exports2.createPromptOutputJsonSchema = createPromptOutputJsonSchema;
     exports2.selectOutputJsonSchema = selectOutputJsonSchema;
     exports2.isFileCompatibleOutputJsonSchema = isFileCompatibleOutputJsonSchema;
+    exports2.isStringCompatibleOutputJsonSchema = isStringCompatibleOutputJsonSchema;
     exports2.FILE_OUTPUT_JSON_SCHEMA = Object.freeze({
       type: "object",
       properties: Object.freeze({
@@ -368828,17 +368872,17 @@ var require_output_schema = __commonJS({
       if (schema.type !== "object" || !isRecord3(properties))
         return false;
       const stringFields = ["name", "fileUrl", "mimeType", "base64", "vaultReference"];
-      if (!stringFields.every((key) => !(key in properties) || isStringJsonSchema(properties[key])))
+      if (!stringFields.every((key) => !(key in properties) || isStringCompatibleOutputJsonSchema(properties[key])))
         return false;
-      return isStringJsonSchema(properties.name) && ["fileUrl", "vaultReference", "base64"].some((key) => isStringJsonSchema(properties[key]));
+      return isStringCompatibleOutputJsonSchema(properties.name) && ["fileUrl", "vaultReference", "base64"].some((key) => isStringCompatibleOutputJsonSchema(properties[key]));
     }
     function isFileArrayJsonSchema(schema) {
       return isRecord3(schema) && schema.type === "array" && isFileJsonSchema(schema.items);
     }
-    function isStringJsonSchema(schema) {
+    function isStringCompatibleOutputJsonSchema(schema) {
       const variants = jsonSchemaVariants(schema);
       if (variants)
-        return variants.every(isStringJsonSchema);
+        return variants.every(isStringCompatibleOutputJsonSchema);
       if (!isRecord3(schema))
         return false;
       if (schema.type !== void 0 && schema.type !== "string")
@@ -368853,9 +368897,10 @@ var require_output_schema = __commonJS({
       return schema.type === "string" || hasStringConst || hasStringEnum;
     }
     function jsonSchemaVariants(schema) {
-      if (!isRecord3(schema) || !Array.isArray(schema.anyOf) || schema.anyOf.length === 0)
+      if (!isRecord3(schema))
         return void 0;
-      return schema.anyOf.every(isRecord3) ? schema.anyOf : void 0;
+      const variants = Array.isArray(schema.anyOf) ? schema.anyOf : Array.isArray(schema.oneOf) ? schema.oneOf : void 0;
+      return variants !== void 0 && variants.length > 0 && variants.every(isRecord3) ? variants : void 0;
     }
     function isRecord3(value) {
       return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -369331,7 +369376,7 @@ var require_extract3 = __commonJS({
         required: declaration.required
       }));
       const nodeBindings = input.builtNodes.slice(0, input.currentNodeIndex).flatMap((node) => {
-        const schema = input.nodeOutputSchemasByKey.get(node.key ?? node.name);
+        const schema = input.nodeOutputSchemasById.get(input.nodeIdsByKey.get(node.key ?? node.name) ?? "");
         return schema ? [{ name: node.name, schema, required: true }] : [];
       });
       return [...inputBindings, ...nodeBindings];
@@ -370547,6 +370592,7 @@ var require_refs = __commonJS({
       return {
         reference: resolved.reference,
         inputType: "inputType" in resolved ? resolved.inputType : void 0,
+        nodeId: "nodeId" in resolved ? resolved.nodeId : void 0,
         diagnostics: []
       };
     }
@@ -370578,7 +370624,7 @@ var require_refs = __commonJS({
       const visible = findVisibleCandidate(ref.targetKey, context);
       if (visible) {
         const reference = workflow_shared_1.ActionOutputReferenceURI.fromStepId(visible.id);
-        return { reference: formatPromptReference(reference, ref) };
+        return { reference: formatPromptReference(reference, ref), nodeId: visible.id };
       }
       if (candidates.some((candidate) => samePath(candidate.scopePath, context.currentNode.scopePath) && candidate.sequenceIndex >= context.currentNode.sequenceIndex)) {
         return "forward";
@@ -370710,20 +370756,43 @@ var require_modules = __commonJS({
         output: (0, ids_1.defaultOutputPortId)(nodeId)
       };
     }
-    function collectRemoteInputFacts(values, refs, inputs) {
+    function collectRemoteInputFacts(values, refs, context) {
       const refsByInputName = new Map((refs ?? []).map((ref) => [ref.key, ref]));
-      const inputsByKey = new Map(inputs.map((input) => [input.key ?? input.name, input]));
+      const inputsByKey = new Map(context.builtInputs.map((input) => [input.key ?? input.name, input]));
       const types = {};
       for (const [name, value] of Object.entries(values)) {
         const ref = refsByInputName.get(name);
+        const formattedType = ref === void 0 ? void 0 : formattedRemoteInputType(ref.format);
         const input = ref?.targetKind === "input" ? inputsByKey.get(ref.targetKey) : void 0;
-        if (input !== void 0)
+        if (formattedType !== void 0) {
+          types[name] = formattedType;
+        } else if (input !== void 0) {
           types[name] = input.inputType;
-        else if (ref === void 0 && typeof value === "string")
+        } else if (ref?.targetKind === "node") {
+          const resolved = (0, refs_1.resolveWorkflowRef)(ref, context);
+          const selectedSchema = (0, output_schema_1.selectOutputJsonSchema)(resolved.nodeId === void 0 ? void 0 : context.nodeOutputSchemasById.get(resolved.nodeId), ref.path ?? []);
+          const type2 = inferredRemoteInputType(selectedSchema, ref.format);
+          if (type2 !== void 0)
+            types[name] = type2;
+        } else if (ref === void 0 && typeof value === "string") {
           types[name] = value.startsWith("vault://") ? "file" : "text";
+        }
       }
       return { names: Object.keys(values), types };
     }
+    function inferredRemoteInputType(schema, format) {
+      const formattedType = formattedRemoteInputType(format);
+      if (formattedType !== void 0)
+        return formattedType;
+      if ((0, output_schema_1.isFileCompatibleOutputJsonSchema)(schema))
+        return "file";
+      return (0, output_schema_1.isStringCompatibleOutputJsonSchema)(schema) ? "text" : void 0;
+    }
+    function formattedRemoteInputType(format) {
+      if (format === "ai-xml" || format === "string")
+        return "text";
+      return void 0;
+    }
     function hasValidPromptInput(node) {
       const input = "input" in node ? node.input : void 0;
       if (!input || typeof input !== "object")
@@ -370771,7 +370840,7 @@ var require_modules = __commonJS({
       if (!value || typeof value !== "object")
         return false;
       const candidate = value;
-      return typeof candidate.token === "string" && (candidate.targetKind === "input" || candidate.targetKind === "node") && typeof candidate.targetKey === "string" && (candidate.path === void 0 || Array.isArray(candidate.path));
+      return typeof candidate.token === "string" && (candidate.targetKind === "input" || candidate.targetKind === "node") && typeof candidate.targetKey === "string" && (candidate.path === void 0 || Array.isArray(candidate.path) && candidate.path.every((segment) => typeof segment === "string")) && (candidate.format === void 0 || candidate.format === "ai-xml" || candidate.format === "raw" || candidate.format === "string");
     }
     function hasValidMapInput(node) {
       const input = "input" in node ? node.input : void 0;
@@ -370894,7 +370963,8 @@ var require_modules = __commonJS({
           inputNamesByKey: context.inputNamesByKey,
           nodeNamesByKey: context.nodeNamesByKey,
           nodeIndexesByKey: context.nodeIndexesByKey,
-          nodeOutputSchemasByKey: context.nodeOutputSchemasByKey
+          nodeOutputSchemasById: context.nodeOutputSchemasById,
+          nodeIdsByKey: context.nodeIdsByKey
         });
         context.diagnostics.push(...extracted.diagnostics);
         if (extracted.diagnostics.some((item) => item.severity === "error"))
@@ -371155,10 +371225,12 @@ var require_modules = __commonJS({
           return [];
         return [incompatibleDocumentRefDiagnostic(file2.targetKey, targetField)];
       }
-      const targetIndex = context.nodeIndexesByKey.get(file2.targetKey);
-      if (targetIndex === void 0 || targetIndex >= context.nodeIndex)
+      const resolved = (0, refs_1.resolveWorkflowRef)(file2, context);
+      if (resolved.nodeId === void 0)
+        return [];
+      const selectedSchema = (0, output_schema_1.selectOutputJsonSchema)(context.nodeOutputSchemasById.get(resolved.nodeId), file2.path ?? []);
+      if (selectedSchema === void 0 && context.remoteMode.kind === "symbolic" && context.remoteTemplateNodeIds.has(resolved.nodeId))
         return [];
-      const selectedSchema = (0, output_schema_1.selectOutputJsonSchema)(context.nodeOutputSchemasByKey.get(file2.targetKey), file2.path ?? []);
       return (0, output_schema_1.isFileCompatibleOutputJsonSchema)(selectedSchema) ? [] : [incompatibleDocumentRefDiagnostic(file2.targetKey, targetField)];
     }
     function incompatibleDocumentRefDiagnostic(targetKey, targetField) {
@@ -371195,7 +371267,7 @@ var require_modules = __commonJS({
       lower(node, context) {
         const linearPorts = defaultLinearPorts(context.nodeId);
         const nodeKey = node.key ?? node.name;
-        const inputFacts = collectRemoteInputFacts(node.input.variables, node.variableRefs, context.builtInputs);
+        const inputFacts = collectRemoteInputFacts(node.input.variables, node.variableRefs, context);
         context.remoteRefs.push((0, remote_refs_1.collectRemoteCall)(nodeKey, "call", node.ref, node.environment, inputFacts.names, inputFacts.types));
         const resolvedRef = (0, remote_refs_1.resolveRemoteBinding)({ mode: context.remoteMode, binding: node.ref, nodeKey, use: "call", environment: node.environment });
         context.diagnostics.push(...resolvedRef.diagnostics);
@@ -371240,7 +371312,7 @@ var require_modules = __commonJS({
       lower(node, context) {
         const linearPorts = defaultLinearPorts(context.nodeId);
         const nodeKey = node.key ?? node.name;
-        const inputFacts = collectRemoteInputFacts(node.input.inputs, node.inputRefs, context.builtInputs);
+        const inputFacts = collectRemoteInputFacts(node.input.inputs, node.inputRefs, context);
         context.remoteRefs.push((0, remote_refs_1.collectRemoteCall)(nodeKey, "call", node.ref, void 0, inputFacts.names, inputFacts.types));
         const resolvedRef = (0, remote_refs_1.resolveRemoteBinding)({ mode: context.remoteMode, binding: node.ref, nodeKey, use: "call" });
         context.diagnostics.push(...resolvedRef.diagnostics);
@@ -371284,10 +371356,102 @@ var require_modules = __commonJS({
         };
       }
     };
+    var remoteTemplateModule = {
+      kind: "remote-template",
+      actionId: workflow_shared_1.WORKFLOW_ACTION_IDS.template,
+      createFailedInput() {
+        return { templateId: "", variables: {} };
+      },
+      validate(node) {
+        return hasValidRemoteTemplateInput(node) ? [] : [invalidRemoteTemplateInputDiagnostic(node)];
+      },
+      lower(node, context) {
+        if (!hasValidRemoteTemplateInput(node))
+          return void 0;
+        const linearPorts = defaultLinearPorts(context.nodeId);
+        const nodeKey = node.key ?? node.name;
+        const inputFacts = collectRemoteInputFacts(node.input.variables, node.variableRefs, context);
+        context.remoteRefs.push((0, remote_refs_1.collectRemoteCall)(nodeKey, "call", node.ref, void 0, inputFacts.names, inputFacts.types));
+        const resolvedRef = (0, remote_refs_1.resolveRemoteBinding)({ mode: context.remoteMode, binding: node.ref, nodeKey, use: "call" });
+        context.diagnostics.push(...resolvedRef.diagnostics);
+        const resolvedVariables = (0, refs_1.resolveReferenceRecordRefs)({
+          values: node.input.variables,
+          refs: node.variableRefs ?? [],
+          inputIdsByKey: context.inputIdsByKey,
+          inputTypesByKey: context.inputTypesByKey,
+          nodeIdentitiesByKey: context.nodeIdentitiesByKey,
+          nodesByPath: context.nodesByPath,
+          currentNode: context.currentNode
+        });
+        context.diagnostics.push(...resolvedVariables.diagnostics);
+        return {
+          node: {
+            id: context.nodeId,
+            name: node.name,
+            actionId: workflow_shared_1.WORKFLOW_ACTION_IDS.template,
+            ports: [
+              { id: linearPorts.input, dir: "in", type: "default" },
+              { id: linearPorts.output, dir: "out", type: "default" }
+            ],
+            input: {
+              templateId: resolvedRef.value ?? (0, remote_refs_1.symbolicRemoteMarker)(node.ref),
+              variables: resolvedVariables.values,
+              ...node.input.tags === void 0 ? {} : { tags: node.input.tags }
+            }
+          },
+          linearPorts,
+          ...resolvedRef.outputSchema === void 0 ? {} : { outputSchema: resolvedRef.outputSchema }
+        };
+      }
+    };
+    function hasValidRemoteTemplateInput(node) {
+      const candidate = node;
+      if (!isRemoteTemplateBinding(candidate.ref) || !isRecord3(candidate.input) || !isJsonRecord(candidate.input.variables))
+        return false;
+      return (candidate.input.tags === void 0 || Array.isArray(candidate.input.tags) && candidate.input.tags.every((tag2) => typeof tag2 === "string")) && (candidate.variableRefs === void 0 || Array.isArray(candidate.variableRefs) && candidate.variableRefs.every(isReferenceRecordRefUse));
+    }
+    function isRemoteTemplateBinding(value) {
+      return isRecord3(value) && value.kind === "template" && (value.path === void 0 || Array.isArray(value.path) && value.path.every((item) => typeof item === "string")) && (value.explicitId === void 0 || typeof value.explicitId === "string");
+    }
+    function isReferenceRecordRefUse(value) {
+      return isPromptRefUse(value) && typeof value.key === "string";
+    }
+    function isJsonRecord(value) {
+      return isRecord3(value) && isJsonValue(value, /* @__PURE__ */ new Set());
+    }
+    function isJsonValue(value, ancestors) {
+      if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+      if (typeof value === "number")
+        return Number.isFinite(value);
+      if (typeof value !== "object" || ancestors.has(value))
+        return false;
+      if (Array.isArray(value)) {
+        ancestors.add(value);
+        const valid2 = value.every((item) => isJsonValue(item, ancestors));
+        ancestors.delete(value);
+        return valid2;
+      }
+      const prototype2 = Object.getPrototypeOf(value);
+      if (!isRecord3(value) || prototype2 !== null && Object.getPrototypeOf(prototype2) !== null)
+        return false;
+      ancestors.add(value);
+      const valid = Object.values(value).every((item) => isJsonValue(item, ancestors));
+      ancestors.delete(value);
+      return valid;
+    }
+    function invalidRemoteTemplateInputDiagnostic(node) {
+      return {
+        code: "compiler.module.invalid_input",
+        severity: "error",
+        message: `Node ${node.name || "<unnamed>"} has invalid Template input`
+      };
+    }
     exports2.nodeModuleRegistry = /* @__PURE__ */ new Map([
       [llmModule.kind, llmModule],
       [remoteExecutableModule.kind, remoteExecutableModule],
       [remoteAgentModule.kind, remoteAgentModule],
+      [remoteTemplateModule.kind, remoteTemplateModule],
       [codeModule.kind, codeModule],
       [mapModule.kind, mapModule],
       [splitterModule.kind, splitterModule],
@@ -371485,7 +371649,7 @@ var require_transpile = __commonJS({
         return createFailedSplitterNode(workflowKey, declaration);
       if (declaration.node.nodeKind === "crop")
         return createFailedCropNode(workflowKey, declaration);
-      if (declaration.node.nodeKind === "remote-executable" || declaration.node.nodeKind === "remote-agent")
+      if (declaration.node.nodeKind === "remote-executable" || declaration.node.nodeKind === "remote-agent" || declaration.node.nodeKind === "remote-template")
         return createFailedRemoteNode(workflowKey, declaration);
       return createFailedPromptNode(workflowKey, declaration);
     }
@@ -371755,6 +371919,8 @@ var require_transpile = __commonJS({
       const inputNamesByKey = new Map(declarationInputs.map((declaration) => [declaration.key ?? declaration.name, declaration.name]));
       const nodeNamesByKey = new Map(topLevelNodes.map(({ node }) => [node.key ?? node.name, node.name]));
       const nodeOutputSchemasByKey = /* @__PURE__ */ new Map();
+      const nodeOutputSchemasById = /* @__PURE__ */ new Map();
+      const remoteTemplateNodeIds = new Set(flattenedNodes.filter(({ node }) => node.nodeKind === "remote-template").map(({ node, path: path3 }) => (0, ids_1.stableNodeId)(workflowKey, node, path3)));
       const buildBinding = input.declaration[contracts_1.BUILD_BINDING];
       const inputs = declarationInputs.map((declaration, index) => ({
         id: (0, ids_1.stableInputId)(workflowKey, declaration, index),
@@ -371792,6 +371958,8 @@ var require_transpile = __commonJS({
           inputNamesByKey,
           nodeNamesByKey,
           nodeOutputSchemasByKey,
+          nodeOutputSchemasById,
+          remoteTemplateNodeIds,
           builtInputs: declarationInputs,
           builtNodes: declarationNodes,
           source: input.source,
@@ -371802,8 +371970,10 @@ var require_transpile = __commonJS({
           remoteRefs,
           diagnostics
         });
-        if (lowered?.outputSchema !== void 0)
+        if (lowered?.outputSchema !== void 0) {
           nodeOutputSchemasByKey.set(node.key ?? node.name, lowered.outputSchema);
+          nodeOutputSchemasById.set((0, ids_1.stableNodeId)(workflowKey, node, flattened.path), lowered.outputSchema);
+        }
         return lowered ? {
           ...lowered,
           declarationIndex: index,
@@ -373732,6 +373902,7 @@ const __workflowCodeApi = (() => {
     const remote = () => freeze({
         canvas: () => createRemoteRef('canvas'),
         workflow: () => createRemoteRef('workflow'),
+        template: () => createRemoteRef('template'),
         agent: () => createRemoteRef('agent'),
         models: () => createRemoteRef('model'),
     })
@@ -373793,6 +373964,22 @@ const __workflowCodeApi = (() => {
             ...(renderedInputs.refs.length > 0 ? { inputRefs: renderedInputs.refs } : {}),
         })
     }
+    const templateNode = (ref, options) => {
+        assertNonEmptyString(options.name, 'template.name', options.__workflowCodeSource)
+        const renderedVariables = renderReferenceRecord(options.input.variables, options.__workflowCodeSource)
+        return freeze({
+            kind: 'node',
+            nodeKind: 'remote-template',
+            name: options.name,
+            ...(options.key !== undefined ? { key: options.key } : {}),
+            ref: serializeRemoteRef(ref, 'template'),
+            input: freeze({
+                variables: renderedVariables.values,
+                ...(options.input.tags !== undefined ? { tags: freeze([...options.input.tags]) } : {}),
+            }),
+            ...(renderedVariables.refs.length > 0 ? { variableRefs: renderedVariables.refs } : {}),
+        })
+    }
     const buildBindingKey = Symbol.for('@meistrari/workflow-code/build-binding')
     const codeBindingKey = Symbol.for('@meistrari/workflow-code/code-binding')
     const buildWorkflow = (workflow, options) => {
@@ -373936,6 +374123,7 @@ const __workflowCodeApi = (() => {
         llm: (options) => promptNode('llm', options, llmInput),
         map: mapNode,
         splitter: splitterNode,
+        template: templateNode,
         vault: freeze({
             asset: (path, options = {}) => freeze({
                 kind: 'vault-asset',
@@ -374565,8 +374753,8 @@ var require_lockfile = __commonJS({
       if (!validateObject(value, path3, ["declarationKey", "kind", "path", "id", "environmentName", "versionId", "revision", "inputHash", "outputContractHash", "contractHash"], diagnostics))
         return;
       validateRequiredString(value, "declarationKey", `${path3}.declarationKey`, diagnostics);
-      if (value.kind !== "canvas" && value.kind !== "workflow" && value.kind !== "agent" && value.kind !== "model")
-        pushInvalid(diagnostics, `${path3}.kind`, "kind must be canvas, workflow, agent, or model");
+      if (value.kind !== "canvas" && value.kind !== "workflow" && value.kind !== "template" && value.kind !== "agent" && value.kind !== "model")
+        pushInvalid(diagnostics, `${path3}.kind`, "kind must be canvas, workflow, template, agent, or model");
       if (value.path !== void 0)
         validateStringArray(value.path, `${path3}.path`, diagnostics);
       validateRequiredString(value, "id", `${path3}.id`, diagnostics);
@@ -377747,24 +377935,31 @@ var require_sync3 = __commonJS({
         const existing = await (0, state_1.readLockfile)(lockPath.value);
         if (!existing.ok && existing.diagnostics[0]?.code !== "state.lockfile.missing")
           return { ok: false, diagnostics: existing.diagnostics, compiled: item.symbolic };
-        const generated = (0, catalog_1.validateAndLockRemoteRefs)({
+        const initialGenerated = (0, catalog_1.validateAndLockRemoteRefs)({
           contextId: snapshot.context.id,
           workspaceId: snapshot.context.workspaceId,
           snapshot,
           refs: item.symbolic.remoteRefs,
           existing: existing.ok ? existing.value.lockfile.generatedMetadata : void 0
         });
-        if (generated.diagnostics.some((diagnostic) => diagnostic.severity === "error"))
-          return { ok: false, diagnostics: [...generated.diagnostics], compiled: item.symbolic };
+        if (initialGenerated.diagnostics.some((diagnostic) => diagnostic.severity === "error"))
+          return { ok: false, diagnostics: [...initialGenerated.diagnostics], compiled: item.symbolic };
         const compiled = (0, compiler_1.transpileWorkflow)({
           targetName: item.name,
           workflowKey: item.target.workflowKey,
           title: item.target.title,
           declaration: item.source.declaration,
           source: item.source.source,
-          remote: { kind: "resolved", snapshot, locks: generated.locks.refs },
+          remote: { kind: "resolved", snapshot, locks: initialGenerated.locks.refs },
           vaultAssets: item.vaultAssets
         });
+        const generated = (0, catalog_1.validateAndLockRemoteRefs)({
+          contextId: snapshot.context.id,
+          workspaceId: snapshot.context.workspaceId,
+          snapshot,
+          refs: compiled.remoteRefs,
+          existing: existing.ok ? existing.value.lockfile.generatedMetadata : void 0
+        });
         const diagnostics = [...generated.diagnostics, ...compiled.diagnostics];
         if (diagnostics.some((diagnostic) => diagnostic.severity === "error"))
           return { ok: false, diagnostics, compiled };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/tela-cli",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Tela command line tools for local state and agent workflows.",
   "engines": {
     "node": ">=22"