@hexabot-ai/agentic 3.2.4-beta.0 → 3.3.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -188,6 +188,13 @@ const validateAndResolveBindings = (workflow, options) => {
188
188
  continue;
189
189
  }
190
190
  parsedSettingsByDefName.set(defName, parsedPayload.data);
191
+ const actionSchema = defDefinition.action
192
+ ? actions?.[defDefinition.action]?.settingSchema
193
+ : undefined;
194
+ const actionParsed = actionSchema?.safeParse?.(defDefinition.settings);
195
+ if (actionParsed && !actionParsed.success) {
196
+ issues.push(...toBindingSettingsIssues(actionParsed.error.issues, defName));
197
+ }
191
198
  }
192
199
  for (const [defName, defDefinition] of Object.entries(defs)) {
193
200
  const defBindings = defDefinition.bindings;
@@ -185,6 +185,13 @@ export const validateAndResolveBindings = (workflow, options) => {
185
185
  continue;
186
186
  }
187
187
  parsedSettingsByDefName.set(defName, parsedPayload.data);
188
+ const actionSchema = defDefinition.action
189
+ ? actions?.[defDefinition.action]?.settingSchema
190
+ : undefined;
191
+ const actionParsed = actionSchema?.safeParse?.(defDefinition.settings);
192
+ if (actionParsed && !actionParsed.success) {
193
+ issues.push(...toBindingSettingsIssues(actionParsed.error.issues, defName));
194
+ }
188
195
  }
189
196
  for (const [defName, defDefinition] of Object.entries(defs)) {
190
197
  const defBindings = defDefinition.bindings;
@@ -4,6 +4,7 @@ export type BindingKindSchema = z.ZodTypeAny;
4
4
  export type BindingActionPolicy = 'forbidden' | 'optional' | 'required';
5
5
  export type BindingValidationActionMetadata = {
6
6
  supportedBindings?: readonly string[];
7
+ settingSchema?: z.ZodTypeAny;
7
8
  };
8
9
  export type BindingKindDescriptor<TSchema extends z.ZodTypeAny = BindingKindSchema, TMultiple extends boolean = boolean> = {
9
10
  schema: TSchema;
@@ -1 +1 @@
1
- {"version":3,"file":"base-binding.d.ts","sourceRoot":"","sources":["../../../src/bindings/base-binding.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"base-binding.d.ts","sourceRoot":"","sources":["../../../src/bindings/base-binding.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hexabot-ai/agentic",
3
- "version": "3.2.4-beta.0",
3
+ "version": "3.3.0-beta.0",
4
4
  "description": "Schemas and utilities for the Hexabot agentic workflow DSL.",
5
5
  "main": "dist/cjs/index.js",
6
6
  "module": "dist/esm/index.js",
@@ -632,6 +632,65 @@ describe('validateWorkflow', () => {
632
632
  expect(result.success).toBe(true);
633
633
  });
634
634
 
635
+ it('validates settings of non-task (bound) defs against their action schema', () => {
636
+ const buildWorkflow = (settings: Record<string, unknown>) => ({
637
+ defs: {
638
+ retrieve_rag_content: {
639
+ kind: 'tools',
640
+ action: 'retrieve_rag_content',
641
+ settings,
642
+ },
643
+ },
644
+ flow: [],
645
+ outputs: {},
646
+ });
647
+ const options = {
648
+ bindingKinds,
649
+ actions: {
650
+ retrieve_rag_content: {
651
+ settingSchema: z.strictObject({
652
+ include_inactive: z.boolean().optional(),
653
+ }),
654
+ },
655
+ },
656
+ };
657
+
658
+ expect(
659
+ validateWorkflow(buildWorkflow({ include_inactivdse: false }), options)
660
+ .success,
661
+ ).toBe(false);
662
+ expect(
663
+ validateWorkflow(buildWorkflow({ include_inactive: false }), options)
664
+ .success,
665
+ ).toBe(true);
666
+ });
667
+
668
+ it('ignores serialized action schemas during binding validation', () => {
669
+ expect(() =>
670
+ validateWorkflow(
671
+ {
672
+ defs: {
673
+ retrieve_rag_content: {
674
+ kind: 'tools',
675
+ action: 'retrieve_rag_content',
676
+ settings: {},
677
+ },
678
+ },
679
+ flow: [],
680
+ outputs: {},
681
+ },
682
+ {
683
+ bindingKinds,
684
+ actions: {
685
+ retrieve_rag_content: {
686
+ settingSchema: {} as unknown as z.ZodTypeAny,
687
+ },
688
+ },
689
+ },
690
+ ),
691
+ ).not.toThrow();
692
+ });
693
+
635
694
  it('reports missing actions with code, actionName and path', () => {
636
695
  const workflow = {
637
696
  defs: mergeTaskDefs({
@@ -16,6 +16,7 @@ export type BindingActionPolicy = 'forbidden' | 'optional' | 'required';
16
16
 
17
17
  export type BindingValidationActionMetadata = {
18
18
  supportedBindings?: readonly string[];
19
+ settingSchema?: z.ZodTypeAny;
19
20
  };
20
21
 
21
22
  export type BindingKindDescriptor<
@@ -341,6 +342,17 @@ export const validateAndResolveBindings = (
341
342
  }
342
343
 
343
344
  parsedSettingsByDefName.set(defName, parsedPayload.data);
345
+
346
+ const actionSchema = defDefinition.action
347
+ ? actions?.[defDefinition.action]?.settingSchema
348
+ : undefined;
349
+ const actionParsed = actionSchema?.safeParse?.(defDefinition.settings);
350
+
351
+ if (actionParsed && !actionParsed.success) {
352
+ issues.push(
353
+ ...toBindingSettingsIssues(actionParsed.error.issues, defName),
354
+ );
355
+ }
344
356
  }
345
357
 
346
358
  for (const [defName, defDefinition] of Object.entries(defs)) {