@codemation/core-nodes 0.0.19 → 0.0.21

package/dist/index.d.cts

@@ -320,8 +320,9 @@ interface Edge {
 }
 type NodeConnectionName = string;
 /**
- * Named connection from an executable parent node to child nodes that exist in {@link WorkflowDefinition.nodes}
- * but are not traversed by the main execution graph.
+ * Named connection from a parent node to child nodes that exist in {@link WorkflowDefinition.nodes}
+ * but are not traversed by the main execution graph. Parents are commonly executable nodes, but may
+ * also be connection-owned nodes for recursive agent attachments.
  */
 interface WorkflowNodeConnection {
   readonly parentNodeId: NodeId;
@@ -922,6 +923,19 @@ type ExecutedToolCall = Readonly<{
 declare class AIAgentExecutionHelpersFactory {
   createConnectionCredentialExecutionContextFactory(credentialSessions: CredentialSessionService): ConnectionCredentialExecutionContextFactory;
   createDynamicStructuredTool(entry: ResolvedTool, toolCredentialContext: NodeExecutionContext<any>, item: Item, itemIndex: number, items: Items): DynamicStructuredTool;
+  /**
+   * Produces a plain JSON Schema object for OpenAI tool parameters and LangChain tool invocation:
+   * - **Zod** → `toJSONSchema(..., { target: "draft-07" })` so shapes match what `@cfworker/json-schema`
+   *   expects (`required` must be an array; draft 2020-12 output can break validation).
+   * - Otherwise LangChain `toJsonSchema` (Standard Schema + JSON passthrough); if the result is still Zod
+   *   (duplicate `zod` copies), fall back to Zod `toJSONSchema` with draft-07.
+   * - Strip root `$schema` for OpenAI; normalize invalid `required` keywords for cfworker; ensure `properties`.
+   */
+  private normalizeToolInputSchemaForOpenAiDynamicStructuredTool;
+  /**
+   * `@cfworker/json-schema` iterates `schema.required` with `for...of`; it must be a string array or absent.
+   */
+  private sanitizeJsonSchemaRequiredKeywordsForCfworker;
 }
 //#endregion
 //#region src/nodes/NodeBackedToolRuntime.d.ts
@@ -974,6 +988,12 @@ declare class AIAgentNode implements Node<AIAgent<any, any>> {
   private resultToJsonValue;
   private createPromptMessages;
   private resolveToolRuntime;
+  /**
+   * Consumer apps can resolve two copies of `@codemation/core`, breaking `instanceof NodeBackedToolConfig` and
+   * sending node-backed tools down the plugin-tool branch with `inputSchema: undefined` (LangChain then crashes in
+   * json-schema validation). {@link NodeBackedToolConfig#toolKind} is stable across copies.
+   */
+  private isNodeBackedToolConfig;
   private resolveGuardrails;
 }
 //#endregion
@@ -1414,6 +1434,9 @@ declare class AIAgentConnectionWorkflowExpander {
   private readonly connectionCredentialNodeConfigFactory;
   constructor(connectionCredentialNodeConfigFactory: ConnectionCredentialNodeConfigFactory);
   expand(workflow: WorkflowDefinition): WorkflowDefinition;
+  private createConnectionsByParentAndName;
+  private collectExistingChildIds;
+  private connectionKey;
   private assertNoIdCollision;
 }
 //#endregion

package/dist/index.d.ts

@@ -320,8 +320,9 @@ interface Edge {
 }
 type NodeConnectionName = string;
 /**
- * Named connection from an executable parent node to child nodes that exist in {@link WorkflowDefinition.nodes}
- * but are not traversed by the main execution graph.
+ * Named connection from a parent node to child nodes that exist in {@link WorkflowDefinition.nodes}
+ * but are not traversed by the main execution graph. Parents are commonly executable nodes, but may
+ * also be connection-owned nodes for recursive agent attachments.
  */
 interface WorkflowNodeConnection {
   readonly parentNodeId: NodeId;
@@ -922,6 +923,19 @@ type ExecutedToolCall = Readonly<{
 declare class AIAgentExecutionHelpersFactory {
   createConnectionCredentialExecutionContextFactory(credentialSessions: CredentialSessionService): ConnectionCredentialExecutionContextFactory;
   createDynamicStructuredTool(entry: ResolvedTool, toolCredentialContext: NodeExecutionContext<any>, item: Item, itemIndex: number, items: Items): DynamicStructuredTool;
+  /**
+   * Produces a plain JSON Schema object for OpenAI tool parameters and LangChain tool invocation:
+   * - **Zod** → `toJSONSchema(..., { target: "draft-07" })` so shapes match what `@cfworker/json-schema`
+   *   expects (`required` must be an array; draft 2020-12 output can break validation).
+   * - Otherwise LangChain `toJsonSchema` (Standard Schema + JSON passthrough); if the result is still Zod
+   *   (duplicate `zod` copies), fall back to Zod `toJSONSchema` with draft-07.
+   * - Strip root `$schema` for OpenAI; normalize invalid `required` keywords for cfworker; ensure `properties`.
+   */
+  private normalizeToolInputSchemaForOpenAiDynamicStructuredTool;
+  /**
+   * `@cfworker/json-schema` iterates `schema.required` with `for...of`; it must be a string array or absent.
+   */
+  private sanitizeJsonSchemaRequiredKeywordsForCfworker;
 }
 //#endregion
 //#region src/nodes/NodeBackedToolRuntime.d.ts
@@ -974,6 +988,12 @@ declare class AIAgentNode implements Node<AIAgent<any, any>> {
   private resultToJsonValue;
   private createPromptMessages;
   private resolveToolRuntime;
+  /**
+   * Consumer apps can resolve two copies of `@codemation/core`, breaking `instanceof NodeBackedToolConfig` and
+   * sending node-backed tools down the plugin-tool branch with `inputSchema: undefined` (LangChain then crashes in
+   * json-schema validation). {@link NodeBackedToolConfig#toolKind} is stable across copies.
+   */
+  private isNodeBackedToolConfig;
   private resolveGuardrails;
 }
 //#endregion
@@ -1414,6 +1434,9 @@ declare class AIAgentConnectionWorkflowExpander {
   private readonly connectionCredentialNodeConfigFactory;
   constructor(connectionCredentialNodeConfigFactory: ConnectionCredentialNodeConfigFactory);
   expand(workflow: WorkflowDefinition): WorkflowDefinition;
+  private createConnectionsByParentAndName;
+  private collectExistingChildIds;
+  private connectionKey;
   private assertNoIdCollision;
 }
 //#endregion