@codemation/core-nodes 0.10.2 → 0.13.0

package/src/nodes/subWorkflow.ts

@@ -6,6 +6,7 @@ import type {
   UpstreamRefPlaceholder,
 } from "@codemation/core";
 import { SubWorkflowNode } from "./SubWorkflowNode";
+import type { NodeBaseOptions } from "./nodeOptions.types";
 
 export class SubWorkflow<TInputJson = unknown, TOutputJson = unknown> implements RunnableNodeConfig<
   TInputJson,
@@ -14,13 +15,19 @@ export class SubWorkflow<TInputJson = unknown, TOutputJson = unknown> implements
   readonly kind = "node" as const;
   readonly type: TypeToken<unknown> = SubWorkflowNode;
   readonly icon = "lucide:workflow";
+  readonly id?: string;
+  readonly description?: string;
   constructor(
     public readonly name: string,
     public readonly workflowId: string,
     public upstreamRefs?: Array<{ nodeId: NodeId } | UpstreamRefPlaceholder>,
     public readonly startAt?: NodeId,
-    public readonly id?: string,
-  ) {}
+    idOrOptions?: string | NodeBaseOptions,
+  ) {
+    const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+    this.id = options?.id;
+    this.description = options?.description;
+  }
 
   inspectorSummary(): ReadonlyArray<NodeInspectorSummaryRow> {
     const rows: NodeInspectorSummaryRow[] = [{ label: "Workflow", value: this.workflowId }];

package/src/nodes/switch.ts

@@ -7,6 +7,7 @@ import type {
   TypeToken,
 } from "@codemation/core";
 import { SwitchNode } from "./SwitchNode";
+import type { NodeBaseOptions } from "./nodeOptions.types";
 
 export type SwitchCaseKeyResolver<TInputJson = unknown> = (
   item: Item<TInputJson>,
@@ -21,6 +22,8 @@ export class Switch<TInputJson = unknown> implements RunnableNodeConfig<TInputJs
   readonly execution = { hint: "local" } as const;
   readonly icon = "lucide:git-branch-plus" as const;
   readonly declaredOutputPorts: ReadonlyArray<string>;
+  readonly id?: string;
+  readonly description?: string;
 
   constructor(
     public readonly name: string,
@@ -29,9 +32,12 @@ export class Switch<TInputJson = unknown> implements RunnableNodeConfig<TInputJs
       defaultCase: string;
       resolveCaseKey: SwitchCaseKeyResolver<TInputJson>;
     }>,
-    public readonly id?: string,
+    idOrOptions?: string | NodeBaseOptions,
   ) {
     this.declaredOutputPorts = [...new Set([...cfg.cases, cfg.defaultCase])].sort();
+    const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+    this.id = options?.id;
+    this.description = options?.description;
   }
 
   inspectorSummary(): ReadonlyArray<NodeInspectorSummaryRow> {

package/src/nodes/wait.ts

@@ -1,6 +1,7 @@
 import type { NodeInspectorSummaryRow, RunnableNodeConfig, TypeToken } from "@codemation/core";
 
 import { WaitNode } from "./WaitNode";
+import type { NodeBaseOptions } from "./nodeOptions.types";
 
 export class Wait<TItemJson = unknown> implements RunnableNodeConfig<TItemJson, TItemJson> {
   readonly kind = "node" as const;
@@ -9,12 +10,18 @@ export class Wait<TItemJson = unknown> implements RunnableNodeConfig<TItemJson,
   /** Pass-through empty batches should still advance to downstream nodes. */
   readonly continueWhenEmptyOutput = true as const;
   readonly icon = "lucide:hourglass" as const;
+  readonly id?: string;
+  readonly description?: string;
 
   constructor(
     public readonly name: string,
     public readonly milliseconds: number,
-    public readonly id?: string,
-  ) {}
+    idOrOptions?: string | NodeBaseOptions,
+  ) {
+    const options = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+    this.id = options?.id;
+    this.description = options?.description;
+  }
 
   inspectorSummary(): ReadonlyArray<NodeInspectorSummaryRow> {
     const seconds = this.milliseconds / 1000;

package/src/workflowAuthoring/WorkflowChatModelFactory.types.ts

@@ -1,6 +1,8 @@
 import type { ChatModelConfig } from "@codemation/core";
 import { OpenAIChatModelConfig } from "../chatModels/openAiChatModelConfig";
-import { CodemationChatModelConfig } from "../chatModels/CodemationChatModelConfig";
+import { CodemationChatModelConfig, type ManagedComplexity } from "../chatModels/CodemationChatModelConfig";
+
+const VALID_COMPLEXITY: ReadonlySet<string> = new Set(["low", "medium", "high", "xhigh"]);
 
 export class WorkflowChatModelFactory {
   static create(model: string | ChatModelConfig): ChatModelConfig {
@@ -9,7 +11,11 @@ export class WorkflowChatModelFactory {
     }
     const [provider, resolvedModel] = model.includes(":") ? model.split(":", 2) : ["openai", model];
     if (provider === "codemation-managed") {
-      return new CodemationChatModelConfig("Codemation Managed", resolvedModel ?? "");
+      const complexity = resolvedModel ?? "medium";
+      if (!VALID_COMPLEXITY.has(complexity)) {
+        throw new Error(`Invalid managed complexity "${complexity}". Must be one of: low, medium, high, xhigh.`);
+      }
+      return new CodemationChatModelConfig("Codemation Managed", complexity as ManagedComplexity);
     }
     if (provider !== "openai") {
       throw new Error(`Unsupported workflow().agent() model provider "${provider}".`);

package/src/chatModels/ManagedModelFetcher.ts

@@ -1,23 +0,0 @@
-import type { ManagedModelDto } from "./CodemationChatModelConfig";
-
-/**
- * Fetches the active platform-managed model allowlist from the CP.
- * Reads CONTROL_PLANE_URL from the workspace process env.
- * Returns an empty array if the env var is absent or the fetch fails.
- * Cache the result per session — the allowlist changes infrequently.
- */
-export class ManagedModelFetcher {
-  async fetch(): Promise<ManagedModelDto[]> {
-    // eslint-disable-next-line no-restricted-properties -- CONTROL_PLANE_URL is injected by the provisioner; this class is the justified boundary.
-    const cpUrl = process.env["CONTROL_PLANE_URL"];
-    if (!cpUrl) return [];
-
-    try {
-      const res = await globalThis.fetch(`${cpUrl}/api/llm/managed-models`);
-      if (!res.ok) return [];
-      return (await res.json()) as ManagedModelDto[];
-    } catch {
-      return [];
-    }
-  }
-}