@soat/sdk 0.5.6 → 0.5.8

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.
package/dist/index.d.cts CHANGED
@@ -351,1037 +351,1407 @@ type ActorRecord = {
351
351
  type ErrorResponse = {
352
352
  error?: string;
353
353
  };
354
- /**
355
- * A formation template supplied as either a JSON object or a YAML/JSON string. When a string is provided the server parses it with a YAML parser (JSON is valid YAML) before processing.
356
- *
357
- */
358
- type FormationTemplateInput = FormationTemplate | string;
359
- type FormationTemplate = {
354
+ type Agent = {
360
355
  /**
361
- * Declared parameters for this template. Each parameter may have a default value and an optional description. Parameters without a default must be supplied in the `parameters` field of the deploy request.
362
- *
356
+ * Public ID of the agent
363
357
  */
364
- parameters?: {
365
- [key: string]: ParameterDeclaration;
366
- } | null;
358
+ id?: string;
367
359
  /**
368
- * Map of logical resource IDs to resource declarations
360
+ * Public ID of the owning project
369
361
  */
370
- resources: {
371
- [key: string]: ResourceDeclaration;
372
- };
362
+ project_id?: string;
373
363
  /**
374
- * Map of output names to values. Values may use `{ "ref": "logicalId" }` to reference physical IDs of created resources, or `{ "param": "ParamName" }` and `{ "sub": "text ${ParamName}" }` to embed parameter values.
375
- *
364
+ * Public ID of the AI provider
376
365
  */
377
- outputs?: {
378
- [key: string]: unknown;
379
- } | null;
380
- metadata?: {
381
- [key: string]: unknown;
382
- } | null;
383
- };
384
- type ParameterDeclaration = {
366
+ ai_provider_id?: string;
385
367
  /**
386
- * Parameter type (currently only 'string' is supported)
368
+ * Display name
387
369
  */
388
- type?: string;
370
+ name?: string | null;
389
371
  /**
390
- * Default value used when the parameter is not supplied at deploy time
372
+ * System instructions guiding behavior
391
373
  */
392
- default?: string | null;
374
+ instructions?: string | null;
393
375
  /**
394
- * Human-readable description of what this parameter represents
376
+ * Model identifier
395
377
  */
396
- description?: string | null;
378
+ model?: string | null;
397
379
  /**
398
- * When true, the parameter value should be treated as sensitive and not echoed in logs or UI. Analogous to NoEcho in CloudFormation.
399
- *
380
+ * Public IDs of attached agent tools
400
381
  */
401
- no_echo?: boolean | null;
402
- };
403
- type ResourceDeclaration = {
382
+ tool_ids?: Array<string> | null;
404
383
  /**
405
- * Resource type
384
+ * Maximum reasoning steps
406
385
  */
407
- type: 'ai_provider' | 'agent_tool' | 'agent' | 'document' | 'memory' | 'memory_entry' | 'webhook';
386
+ max_steps?: number | null;
408
387
  /**
409
- * Resource properties. Values may use `{ "ref": "logicalId" }` to reference physical IDs of other resources in the template, `{ "param": "ParamName" }` to substitute a parameter value, or `{ "sub": "text ${ParamName}" }` to interpolate parameter values into a string.
410
- *
388
+ * Tool choice strategy
411
389
  */
412
- properties: {
390
+ tool_choice?: {
413
391
  [key: string]: unknown;
414
- };
392
+ } | null;
415
393
  /**
416
- * Explicit dependency list. In addition to implicit `ref` dependencies.
394
+ * Stop conditions
417
395
  */
418
- depends_on?: Array<string> | null;
419
- metadata?: {
396
+ stop_conditions?: Array<{
420
397
  [key: string]: unknown;
421
- } | null;
422
- };
423
- type AgentFormationResource = {
398
+ }> | null;
424
399
  /**
425
- * Public ID of the resource record
400
+ * Subset of toolIds active per step
426
401
  */
427
- id?: string;
402
+ active_tool_ids?: Array<string> | null;
428
403
  /**
429
- * Logical identifier from the template
404
+ * Per-step overrides
430
405
  */
431
- logical_id?: string;
406
+ step_rules?: Array<{
407
+ [key: string]: unknown;
408
+ }> | null;
432
409
  /**
433
- * Resource type (e.g. agent, memory)
410
+ * Allowed/denied SOAT actions
434
411
  */
435
- resource_type?: string;
412
+ boundary_policy?: {
413
+ [key: string]: unknown;
414
+ } | null;
436
415
  /**
437
- * Public ID of the physical SOAT resource
416
+ * Sampling temperature
438
417
  */
439
- physical_resource_id?: string | null;
418
+ temperature?: number | null;
440
419
  /**
441
- * Current resource status
420
+ * Knowledge retrieval config injected before every generation
442
421
  */
443
- status?: 'pending' | 'created' | 'updated' | 'deleted' | 'failed';
422
+ knowledge_config?: {
423
+ memory_ids?: Array<string>;
424
+ memory_tags?: Array<string>;
425
+ document_ids?: Array<string>;
426
+ document_paths?: Array<string>;
427
+ min_score?: number;
428
+ limit?: number;
429
+ /**
430
+ * Public ID of the memory the agent can write to during generation. When set, a write_memory tool is automatically available to the agent.
431
+ */
432
+ write_memory_id?: string | null;
433
+ } | null;
434
+ created_at?: Date;
435
+ updated_at?: Date;
444
436
  };
445
- type AgentFormation = {
446
- /**
447
- * Public ID of the formation
448
- */
449
- id?: string;
437
+ type CreateAgentRequest = {
450
438
  /**
451
- * Project public ID
439
+ * Public ID of the project
452
440
  */
453
441
  project_id?: string;
454
442
  /**
455
- * Human-readable formation name
443
+ * Public ID of the AI provider
456
444
  */
445
+ ai_provider_id: string;
457
446
  name?: string;
458
- template?: FormationTemplate;
459
- /**
460
- * Resolved output values after stack deployment
461
- */
462
- outputs?: {
463
- [key: string]: string;
447
+ instructions?: string;
448
+ model?: string;
449
+ tool_ids?: Array<string>;
450
+ max_steps?: number;
451
+ tool_choice?: {
452
+ [key: string]: unknown;
453
+ };
454
+ stop_conditions?: Array<{
455
+ [key: string]: unknown;
456
+ }>;
457
+ active_tool_ids?: Array<string>;
458
+ step_rules?: Array<{
459
+ [key: string]: unknown;
460
+ }>;
461
+ boundary_policy?: {
462
+ [key: string]: unknown;
463
+ };
464
+ temperature?: number;
465
+ knowledge_config?: {
466
+ memory_ids?: Array<string>;
467
+ memory_tags?: Array<string>;
468
+ document_ids?: Array<string>;
469
+ document_paths?: Array<string>;
470
+ min_score?: number;
471
+ limit?: number;
472
+ /**
473
+ * Public ID of the memory the agent can write to during generation. When set, a write_memory tool is automatically available to the agent.
474
+ */
475
+ write_memory_id?: string | null;
476
+ };
477
+ };
478
+ type UpdateAgentRequest = {
479
+ ai_provider_id?: string;
480
+ name?: string | null;
481
+ instructions?: string | null;
482
+ model?: string | null;
483
+ tool_ids?: Array<string> | null;
484
+ max_steps?: number | null;
485
+ tool_choice?: {
486
+ [key: string]: unknown;
464
487
  } | null;
465
- /**
466
- * Formation status
467
- */
468
- status?: 'creating' | 'active' | 'updating' | 'failed' | 'deleting' | 'deleted' | 'delete_failed';
469
- metadata?: {
488
+ stop_conditions?: Array<{
489
+ [key: string]: unknown;
490
+ }> | null;
491
+ active_tool_ids?: Array<string> | null;
492
+ step_rules?: Array<{
493
+ [key: string]: unknown;
494
+ }> | null;
495
+ boundary_policy?: {
470
496
  [key: string]: unknown;
471
497
  } | null;
472
- /**
473
- * Resources managed by this formation (present on get/create/update)
474
- */
475
- resources?: Array<AgentFormationResource>;
476
- created_at?: Date;
477
- updated_at?: Date;
498
+ temperature?: number | null;
499
+ knowledge_config?: {
500
+ memory_ids?: Array<string>;
501
+ memory_tags?: Array<string>;
502
+ document_ids?: Array<string>;
503
+ document_paths?: Array<string>;
504
+ min_score?: number;
505
+ limit?: number;
506
+ /**
507
+ * Public ID of the memory the agent can write to during generation. When set, a write_memory tool is automatically available to the agent.
508
+ */
509
+ write_memory_id?: string | null;
510
+ } | null;
478
511
  };
479
- type ValidationError = {
512
+ type CreateAgentGenerationRequest = {
513
+ messages: Array<{
514
+ role: 'system' | 'user' | 'assistant';
515
+ content: string;
516
+ }>;
480
517
  /**
481
- * JSON path to the field with the error
518
+ * When true the response is an SSE stream
482
519
  */
483
- path?: string;
520
+ stream?: boolean;
484
521
  /**
485
- * Error description
522
+ * Optional trace ID to group generations
486
523
  */
487
- message?: string;
488
- };
489
- type ValidationResult = {
490
- valid?: boolean;
491
- errors?: Array<ValidationError>;
492
- warnings?: Array<ValidationError>;
493
- };
494
- type PlanChange = {
495
- logical_id?: string;
496
- resource_type?: string;
497
- action?: 'create' | 'update' | 'delete' | 'no-op';
498
- };
499
- type PlanResult = {
500
- changes?: Array<PlanChange>;
501
- };
502
- type FormationEvent = {
503
- timestamp?: Date;
504
- logical_id?: string;
505
- resource_type?: string;
506
- action?: string;
507
- status?: 'succeeded' | 'failed';
508
- physical_resource_id?: string | null;
509
- error?: string | null;
510
- };
511
- type FormationOperation = {
524
+ trace_id?: string;
512
525
  /**
513
- * Public ID of the operation
526
+ * The trace ID of the parent agent generation that triggered this one (for agent-to-agent calls)
514
527
  */
515
- id?: string;
516
- operation_type?: 'validate' | 'plan' | 'create' | 'update' | 'delete';
517
- status?: 'pending' | 'running' | 'succeeded' | 'failed';
518
- events?: Array<FormationEvent> | null;
519
- plan?: PlanResult | null;
520
- error?: {
521
- [key: string]: unknown;
522
- } | null;
523
- created_at?: Date;
524
- updated_at?: Date;
525
- };
526
- type AgentTool = {
528
+ parent_trace_id?: string | null;
527
529
  /**
528
- * Public ID of the agent tool
530
+ * The trace ID of the root generation in the call chain; if omitted, this generation is the root
529
531
  */
530
- id?: string;
532
+ root_trace_id?: string | null;
531
533
  /**
532
- * Public ID of the owning project
534
+ * Maximum nested agent-call depth; 0 short-circuits with a depth-guard response
533
535
  */
534
- project_id?: string;
536
+ max_call_depth?: number;
535
537
  /**
536
- * Tool name
538
+ * Key-value pairs injected as context headers into all tool call requests made during this generation.
537
539
  */
538
- name?: string;
539
- /**
540
- * Tool type
540
+ tool_context?: {
541
+ [key: string]: string;
542
+ } | null;
543
+ };
544
+ type SubmitToolOutputsRequest = {
545
+ tool_outputs: Array<{
546
+ /**
547
+ * ID of the tool call to respond to
548
+ */
549
+ tool_call_id: string;
550
+ /**
551
+ * Result of the tool execution
552
+ */
553
+ output: unknown;
554
+ }>;
555
+ };
556
+ type AgentGenerationResponse = {
557
+ /**
558
+ * Public ID of the generation
541
559
  */
542
- type?: 'http' | 'client' | 'mcp' | 'soat';
560
+ id?: string;
543
561
  /**
544
- * What the tool does (sent to the model)
562
+ * Generation status
545
563
  */
546
- description?: string | null;
564
+ status?: 'completed' | 'requires_action';
547
565
  /**
548
- * JSON Schema for tool input
566
+ * Final text output (when completed)
549
567
  */
550
- parameters?: {
551
- [key: string]: unknown;
552
- } | null;
568
+ text?: string | null;
553
569
  /**
554
- * Execution config for http tools. Supported fields: `url` (required), `method` (default `POST`), and `headers`. The `url` may contain `{paramName}` placeholders (e.g. `/users/{userId}`) that are replaced at call time with the corresponding tool argument value (URL-encoded). Arguments consumed as path parameters are excluded from the query string and request body.
555
- *
570
+ * Pending tool calls (when requires_action)
556
571
  */
557
- execute?: {
558
- [key: string]: unknown;
559
- } | null;
572
+ tool_calls?: Array<{
573
+ tool_call_id?: string;
574
+ tool_name?: string;
575
+ args?: {
576
+ [key: string]: unknown;
577
+ };
578
+ }> | null;
579
+ };
580
+ type ApiKeyRecord = {
560
581
  /**
561
- * MCP server config (url, headers)
582
+ * Public API key ID (key_ prefix)
562
583
  */
563
- mcp?: {
564
- [key: string]: unknown;
565
- } | null;
584
+ id?: string;
585
+ name?: string;
566
586
  /**
567
- * SOAT platform actions to expose
587
+ * First 8 characters of the raw key for identification
568
588
  */
569
- actions?: Array<string> | null;
589
+ key_prefix?: string;
570
590
  /**
571
- * Fixed parameters merged into every soat tool call. Keys matching fields in the action's input schema are removed from the schema shown to the model and injected automatically at execution time.
591
+ * Owner user public ID
572
592
  */
573
- preset_parameters?: {
574
- [key: string]: unknown;
575
- } | null;
593
+ user_id?: string;
594
+ /**
595
+ * Optional project scope
596
+ */
597
+ project_id?: string | null;
598
+ /**
599
+ * Public IDs of policies attached to this key
600
+ */
601
+ policy_ids?: Array<string>;
576
602
  created_at?: Date;
577
603
  updated_at?: Date;
578
604
  };
579
- type CreateAgentToolRequest = {
605
+ type ApiKeyCreated = ApiKeyRecord & {
606
+ /**
607
+ * The raw API key value (only returned once at creation). Use as Bearer token.
608
+ */
609
+ key?: string;
610
+ };
611
+ type Chat = {
580
612
  /**
581
- * Public ID of the project
613
+ * Public ID of the chat
614
+ */
615
+ id?: string;
616
+ /**
617
+ * Public ID of the owning project
582
618
  */
583
619
  project_id?: string;
584
620
  /**
585
- * Tool name
621
+ * Public ID of the AI provider
586
622
  */
587
- name: string;
623
+ ai_provider_id?: string;
588
624
  /**
589
- * Tool type (default http)
625
+ * Optional human-readable name
590
626
  */
591
- type?: 'http' | 'client' | 'mcp' | 'soat';
627
+ name?: string | null;
592
628
  /**
593
- * What the tool does
629
+ * Optional system message sent with every completion
594
630
  */
595
- description?: string;
631
+ system_message?: string | null;
596
632
  /**
597
- * JSON Schema for tool input
633
+ * Optional model override for this chat
598
634
  */
599
- parameters?: {
600
- [key: string]: unknown;
601
- };
635
+ model?: string | null;
636
+ created_at?: Date;
637
+ updated_at?: Date;
638
+ };
639
+ type CreateChatRequest = {
602
640
  /**
603
- * Execution config for http tools. Supported fields: `url` (required), `method` (default `POST`), and `headers`. The `url` may contain `{paramName}` placeholders (e.g. `/users/{userId}`) that are replaced at call time with the corresponding tool argument value (URL-encoded). Arguments consumed as path parameters are excluded from the query string and request body.
641
+ * Public ID of the AI provider
642
+ */
643
+ ai_provider_id: string;
644
+ /**
645
+ * Public ID of the project. Required when the user belongs to multiple projects and no project key is used.
604
646
  *
605
647
  */
606
- execute?: {
607
- [key: string]: unknown;
608
- };
648
+ project_id?: string;
609
649
  /**
610
- * MCP server config (url, headers)
650
+ * Optional human-readable name
611
651
  */
612
- mcp?: {
613
- [key: string]: unknown;
614
- };
652
+ name?: string;
615
653
  /**
616
- * SOAT platform actions
654
+ * Optional system message applied to all completions on this chat
617
655
  */
618
- actions?: Array<string>;
656
+ system_message?: string;
619
657
  /**
620
- * Fixed parameters merged into every soat tool call. Keys matching fields in the action's input schema are removed from the schema shown to the model and injected automatically at execution time.
658
+ * Optional default model override
621
659
  */
622
- preset_parameters?: {
623
- [key: string]: unknown;
624
- };
660
+ model?: string;
625
661
  };
626
- type UpdateAgentToolRequest = {
627
- name?: string;
628
- type?: 'http' | 'client' | 'mcp' | 'soat';
629
- description?: string | null;
630
- parameters?: {
631
- [key: string]: unknown;
632
- } | null;
662
+ type ChatMessageInput = {
663
+ role: 'system' | 'user' | 'assistant';
633
664
  /**
634
- * Execution config for http tools. Supported fields: `url` (required), `method` (default `POST`), and `headers`. The `url` may contain `{paramName}` placeholders (e.g. `/users/{userId}`) that are replaced at call time with the corresponding tool argument value (URL-encoded). Arguments consumed as path parameters are excluded from the query string and request body.
635
- *
665
+ * Text content of the message (mutually exclusive with documentId)
636
666
  */
637
- execute?: {
638
- [key: string]: unknown;
639
- } | null;
640
- mcp?: {
641
- [key: string]: unknown;
642
- } | null;
643
- actions?: Array<string> | null;
667
+ content?: string;
644
668
  /**
645
- * Fixed parameters merged into every soat tool call. Keys matching fields in the action's input schema are removed from the schema shown to the model and injected automatically at execution time.
669
+ * Public ID of a document whose content is used as the message body (mutually exclusive with content). Only valid for user/assistant roles.
670
+ *
646
671
  */
647
- preset_parameters?: {
648
- [key: string]: unknown;
649
- } | null;
672
+ document_id?: string;
650
673
  };
651
- type Agent = {
674
+ type ChatCompletionForChatRequest = {
675
+ messages: Array<ChatMessageInput>;
652
676
  /**
653
- * Public ID of the agent
677
+ * Override the chat's default model for this call
654
678
  */
655
- id?: string;
679
+ model?: string;
656
680
  /**
657
- * Public ID of the owning project
681
+ * When `true` the response is an SSE stream.
658
682
  */
659
- project_id?: string;
683
+ stream?: boolean;
684
+ };
685
+ type ChatMessage = {
660
686
  /**
661
- * Public ID of the AI provider
687
+ * Role of the message author
662
688
  */
663
- ai_provider_id?: string;
689
+ role: 'system' | 'user' | 'assistant';
664
690
  /**
665
- * Display name
691
+ * Text content of the message
666
692
  */
667
- name?: string | null;
693
+ content: string;
694
+ };
695
+ type ChatCompletionRequest = {
668
696
  /**
669
- * System instructions guiding behavior
697
+ * Public ID of the AI provider to use.
670
698
  */
671
- instructions?: string | null;
699
+ ai_provider_id: string;
672
700
  /**
673
- * Model identifier
701
+ * Model identifier. Overrides the provider's `default_model` when specified.
702
+ *
674
703
  */
675
- model?: string | null;
704
+ model?: string;
676
705
  /**
677
- * Public IDs of attached agent tools
706
+ * Ordered list of chat messages
678
707
  */
679
- tool_ids?: Array<string> | null;
708
+ messages: Array<ChatMessage>;
680
709
  /**
681
- * Maximum reasoning steps
710
+ * When `true` the response is an SSE stream of delta chunks. When `false` (default) a single JSON object is returned.
711
+ *
682
712
  */
683
- max_steps?: number | null;
713
+ stream?: boolean;
714
+ };
715
+ type ChatCompletionResponseMessage = {
716
+ role?: string;
717
+ content?: string;
718
+ };
719
+ type ChatCompletionChoice = {
720
+ index?: number;
721
+ message?: ChatCompletionResponseMessage;
722
+ finish_reason?: string;
723
+ };
724
+ type ChatCompletionResponse = {
725
+ object?: string;
726
+ model?: string;
727
+ choices?: Array<ChatCompletionChoice>;
728
+ };
729
+ type ConversationRecord = {
684
730
  /**
685
- * Tool choice strategy
731
+ * Conversation ID
686
732
  */
687
- tool_choice?: {
688
- [key: string]: unknown;
689
- } | null;
733
+ id?: string;
690
734
  /**
691
- * Stop conditions
735
+ * Project ID
692
736
  */
693
- stop_conditions?: Array<{
694
- [key: string]: unknown;
695
- }> | null;
737
+ project_id?: string;
696
738
  /**
697
- * Subset of toolIds active per step
739
+ * Optional human-readable name for the conversation.
698
740
  */
699
- active_tool_ids?: Array<string> | null;
741
+ name?: string | null;
700
742
  /**
701
- * Per-step overrides
743
+ * Conversation status
702
744
  */
703
- step_rules?: Array<{
704
- [key: string]: unknown;
705
- }> | null;
745
+ status?: 'open' | 'closed';
706
746
  /**
707
- * Allowed/denied SOAT actions
747
+ * Creation timestamp
708
748
  */
709
- boundary_policy?: {
710
- [key: string]: unknown;
711
- } | null;
749
+ created_at?: Date;
712
750
  /**
713
- * Sampling temperature
751
+ * Last update timestamp
714
752
  */
715
- temperature?: number | null;
753
+ updated_at?: Date;
716
754
  /**
717
- * Knowledge retrieval config injected before every generation
755
+ * Actor ID associated with this conversation
718
756
  */
719
- knowledge_config?: {
720
- memory_ids?: Array<string>;
721
- memory_tags?: Array<string>;
722
- document_ids?: Array<string>;
723
- document_paths?: Array<string>;
724
- min_score?: number;
725
- limit?: number;
726
- /**
727
- * Public ID of the memory the agent can write to during generation. When set, a write_memory tool is automatically available to the agent.
728
- */
729
- write_memory_id?: string | null;
730
- } | null;
731
- created_at?: Date;
732
- updated_at?: Date;
757
+ actor_id?: string | null;
733
758
  };
734
- type CreateAgentRequest = {
759
+ type ConversationMessageRecord = {
735
760
  /**
736
- * Public ID of the project
761
+ * Document ID
737
762
  */
738
- project_id?: string;
763
+ document_id?: string;
739
764
  /**
740
- * Public ID of the AI provider
765
+ * Role of the message sender
741
766
  */
742
- ai_provider_id: string;
743
- name?: string;
744
- instructions?: string;
745
- model?: string;
746
- tool_ids?: Array<string>;
747
- max_steps?: number;
748
- tool_choice?: {
749
- [key: string]: unknown;
750
- };
751
- stop_conditions?: Array<{
752
- [key: string]: unknown;
753
- }>;
754
- active_tool_ids?: Array<string>;
755
- step_rules?: Array<{
756
- [key: string]: unknown;
757
- }>;
758
- boundary_policy?: {
759
- [key: string]: unknown;
760
- };
761
- temperature?: number;
762
- knowledge_config?: {
763
- memory_ids?: Array<string>;
764
- memory_tags?: Array<string>;
765
- document_ids?: Array<string>;
766
- document_paths?: Array<string>;
767
- min_score?: number;
768
- limit?: number;
769
- /**
770
- * Public ID of the memory the agent can write to during generation. When set, a write_memory tool is automatically available to the agent.
771
- */
772
- write_memory_id?: string | null;
773
- };
774
- };
775
- type UpdateAgentRequest = {
776
- ai_provider_id?: string;
777
- name?: string | null;
778
- instructions?: string | null;
779
- model?: string | null;
780
- tool_ids?: Array<string> | null;
781
- max_steps?: number | null;
782
- tool_choice?: {
783
- [key: string]: unknown;
784
- } | null;
785
- stop_conditions?: Array<{
786
- [key: string]: unknown;
787
- }> | null;
788
- active_tool_ids?: Array<string> | null;
789
- step_rules?: Array<{
790
- [key: string]: unknown;
791
- }> | null;
792
- boundary_policy?: {
767
+ role?: 'user' | 'assistant' | 'system';
768
+ /**
769
+ * Optional actor ID associated with this message
770
+ */
771
+ actor_id?: string | null;
772
+ /**
773
+ * Optional agent ID that generated this message (set for assistant messages produced by generate)
774
+ */
775
+ agent_id?: string | null;
776
+ /**
777
+ * Zero-based position in the conversation
778
+ */
779
+ position?: number;
780
+ /**
781
+ * Optional structured metadata attached to the message
782
+ */
783
+ metadata?: {
793
784
  [key: string]: unknown;
794
785
  } | null;
795
- temperature?: number | null;
796
- knowledge_config?: {
797
- memory_ids?: Array<string>;
798
- memory_tags?: Array<string>;
799
- document_ids?: Array<string>;
800
- document_paths?: Array<string>;
801
- min_score?: number;
802
- limit?: number;
803
- /**
804
- * Public ID of the memory the agent can write to during generation. When set, a write_memory tool is automatically available to the agent.
805
- */
806
- write_memory_id?: string | null;
807
- } | null;
786
+ /**
787
+ * Full text content of the message
788
+ */
789
+ content?: string | null;
808
790
  };
809
- type CreateAgentGenerationRequest = {
810
- messages: Array<{
811
- role: 'system' | 'user' | 'assistant';
812
- content: string;
813
- }>;
791
+ type ConversationActorRecord = {
814
792
  /**
815
- * When true the response is an SSE stream
793
+ * Actor ID
816
794
  */
817
- stream?: boolean;
795
+ id?: string;
818
796
  /**
819
- * Optional trace ID to group generations
797
+ * Project ID
820
798
  */
821
- trace_id?: string;
799
+ project_id?: string;
822
800
  /**
823
- * The trace ID of the parent agent generation that triggered this one (for agent-to-agent calls)
801
+ * Actor name
824
802
  */
825
- parent_trace_id?: string | null;
803
+ name?: string;
826
804
  /**
827
- * The trace ID of the root generation in the call chain; if omitted, this generation is the root
805
+ * Actor type
828
806
  */
829
- root_trace_id?: string | null;
807
+ type?: string;
830
808
  /**
831
- * Maximum nested agent-call depth; 0 short-circuits with a depth-guard response
809
+ * External identifier
832
810
  */
833
- max_call_depth?: number;
811
+ external_id?: string;
834
812
  /**
835
- * Key-value pairs injected as context headers into all tool call requests made during this generation.
813
+ * Creation timestamp
836
814
  */
837
- tool_context?: {
838
- [key: string]: string;
839
- } | null;
840
- };
841
- type SubmitToolOutputsRequest = {
842
- tool_outputs: Array<{
843
- /**
844
- * ID of the tool call to respond to
845
- */
846
- tool_call_id: string;
847
- /**
848
- * Result of the tool execution
849
- */
850
- output: unknown;
851
- }>;
852
- };
853
- type AgentGenerationResponse = {
815
+ created_at?: Date;
854
816
  /**
855
- * Public ID of the generation
817
+ * Last update timestamp
856
818
  */
857
- id?: string;
819
+ updated_at?: Date;
820
+ };
821
+ type GenerateConversationMessageCompleted = {
858
822
  /**
859
- * Generation status
823
+ * Indicates generation finished successfully.
860
824
  */
861
- status?: 'completed' | 'requires_action';
825
+ status: 'completed';
862
826
  /**
863
- * Final text output (when completed)
827
+ * The AI-generated text of the reply. This is the canonical field for the assistant's response text.
828
+ *
864
829
  */
865
- text?: string | null;
830
+ content: string;
831
+ message: ConversationMessageRecord;
866
832
  /**
867
- * Pending tool calls (when requires_action)
833
+ * ID of the underlying generation record.
868
834
  */
869
- tool_calls?: Array<{
870
- tool_call_id?: string;
871
- tool_name?: string;
872
- args?: {
873
- [key: string]: unknown;
874
- };
875
- }> | null;
876
- };
877
- type ApiKeyRecord = {
835
+ generation_id: string;
878
836
  /**
879
- * Public API key ID (key_ prefix)
837
+ * Trace ID for observability.
880
838
  */
881
- id?: string;
882
- name?: string;
839
+ trace_id: string;
883
840
  /**
884
- * First 8 characters of the raw key for identification
841
+ * Model used for generation.
885
842
  */
886
- key_prefix?: string;
843
+ model?: string;
844
+ };
845
+ type GenerateConversationMessageRequiresAction = {
887
846
  /**
888
- * Owner user public ID
847
+ * Indicates the agent requires tool-call outputs before it can produce a reply. No message is persisted yet.
848
+ *
889
849
  */
890
- user_id?: string;
850
+ status: 'requires_action';
891
851
  /**
892
- * Optional project scope
852
+ * ID of the paused generation. Pass to the tool-outputs endpoint.
893
853
  */
894
- project_id?: string | null;
854
+ generation_id: string;
895
855
  /**
896
- * Public IDs of policies attached to this key
856
+ * Trace ID for observability.
897
857
  */
898
- policy_ids?: Array<string>;
899
- created_at?: Date;
900
- updated_at?: Date;
901
- };
902
- type ApiKeyCreated = ApiKeyRecord & {
858
+ trace_id: string;
903
859
  /**
904
- * The raw API key value (only returned once at creation). Use as Bearer token.
860
+ * Tool-call information the client must resolve.
905
861
  */
906
- key?: string;
862
+ required_action: {
863
+ [key: string]: unknown;
864
+ };
907
865
  };
908
- type Chat = {
866
+ type GenerateConversationMessageResponse = ({
867
+ status: 'completed';
868
+ } & GenerateConversationMessageCompleted) | ({
869
+ status: 'requires_action';
870
+ } & GenerateConversationMessageRequiresAction);
871
+ type DocumentRecord = {
909
872
  /**
910
- * Public ID of the chat
873
+ * Document ID
911
874
  */
912
875
  id?: string;
913
876
  /**
914
- * Public ID of the owning project
877
+ * Underlying file ID
878
+ */
879
+ file_id?: string;
880
+ /**
881
+ * Project ID
915
882
  */
916
883
  project_id?: string;
917
884
  /**
918
- * Public ID of the AI provider
885
+ * Logical path of the document within the project (e.g. /reports/q1.txt)
919
886
  */
920
- ai_provider_id?: string;
887
+ path?: string | null;
921
888
  /**
922
- * Optional human-readable name
889
+ * Original filename
923
890
  */
924
- name?: string | null;
891
+ filename?: string;
925
892
  /**
926
- * Optional system message sent with every completion
893
+ * File size in bytes
927
894
  */
928
- system_message?: string | null;
895
+ size?: number;
929
896
  /**
930
- * Optional model override for this chat
897
+ * Text content (only present on getDocument)
931
898
  */
932
- model?: string | null;
899
+ content?: string | null;
933
900
  created_at?: Date;
934
901
  updated_at?: Date;
935
902
  };
936
- type CreateChatRequest = {
903
+ type UploadFileBase64Request = {
937
904
  /**
938
- * Public ID of the AI provider
905
+ * Public ID of the project
939
906
  */
940
- ai_provider_id: string;
907
+ project_id: string;
941
908
  /**
942
- * Public ID of the project. Required when the user belongs to multiple projects and no project key is used.
943
- *
909
+ * Base64-encoded file content
944
910
  */
945
- project_id?: string;
911
+ content: string;
946
912
  /**
947
- * Optional human-readable name
913
+ * Name of the file
948
914
  */
949
- name?: string;
915
+ filename?: string;
950
916
  /**
951
- * Optional system message applied to all completions on this chat
917
+ * Logical path within the project (e.g. /images/logo.png). Defaults to /filename if omitted.
952
918
  */
953
- system_message?: string;
919
+ path?: string;
954
920
  /**
955
- * Optional default model override
921
+ * MIME type of the file
956
922
  */
957
- model?: string;
923
+ content_type?: string;
924
+ /**
925
+ * JSON string with additional metadata
926
+ */
927
+ metadata?: string;
958
928
  };
959
- type ChatMessageInput = {
960
- role: 'system' | 'user' | 'assistant';
929
+ /**
930
+ * Stored file metadata
931
+ */
932
+ type FileRecord = {
961
933
  /**
962
- * Text content of the message (mutually exclusive with documentId)
934
+ * Unique file identifier
963
935
  */
964
- content?: string;
936
+ id?: string;
965
937
  /**
966
- * Public ID of a document whose content is used as the message body (mutually exclusive with content). Only valid for user/assistant roles.
967
- *
938
+ * Logical path of the file within the project (e.g. /images/logo.png)
968
939
  */
969
- document_id?: string;
970
- };
971
- type ChatCompletionForChatRequest = {
972
- messages: Array<ChatMessageInput>;
940
+ path?: string | null;
973
941
  /**
974
- * Override the chat's default model for this call
942
+ * Name of the file
975
943
  */
976
- model?: string;
944
+ filename?: string;
977
945
  /**
978
- * When `true` the response is an SSE stream.
946
+ * MIME type of the file
979
947
  */
980
- stream?: boolean;
981
- };
982
- type ChatMessage = {
948
+ contentType?: string;
983
949
  /**
984
- * Role of the message author
950
+ * File size in bytes
985
951
  */
986
- role: 'system' | 'user' | 'assistant';
952
+ size?: number;
987
953
  /**
988
- * Text content of the message
954
+ * Storage backend type
989
955
  */
990
- content: string;
991
- };
992
- type ChatCompletionRequest = {
956
+ storage_type?: 'local' | 's3' | 'gcs';
993
957
  /**
994
- * Public ID of the AI provider to use.
958
+ * Path where the file is stored
995
959
  */
996
- ai_provider_id: string;
960
+ storage_path?: string;
997
961
  /**
998
- * Model identifier. Overrides the provider's `default_model` when specified.
999
- *
962
+ * JSON string with additional metadata
1000
963
  */
1001
- model?: string;
964
+ metadata?: string;
1002
965
  /**
1003
- * Ordered list of chat messages
966
+ * Creation timestamp
1004
967
  */
1005
- messages: Array<ChatMessage>;
968
+ created_at?: Date;
1006
969
  /**
1007
- * When `true` the response is an SSE stream of delta chunks. When `false` (default) a single JSON object is returned.
1008
- *
970
+ * Last update timestamp
1009
971
  */
1010
- stream?: boolean;
1011
- };
1012
- type ChatCompletionResponseMessage = {
1013
- role?: string;
1014
- content?: string;
1015
- };
1016
- type ChatCompletionChoice = {
1017
- index?: number;
1018
- message?: ChatCompletionResponseMessage;
1019
- finish_reason?: string;
1020
- };
1021
- type ChatCompletionResponse = {
1022
- object?: string;
1023
- model?: string;
1024
- choices?: Array<ChatCompletionChoice>;
972
+ updated_at?: Date;
1025
973
  };
1026
- type ConversationRecord = {
974
+ /**
975
+ * A formation template supplied as either a JSON object or a YAML/JSON string. When a string is provided the server parses it with a YAML parser (JSON is valid YAML) before processing.
976
+ *
977
+ */
978
+ type FormationTemplateInput = FormationTemplate | string;
979
+ type FormationTemplate = {
1027
980
  /**
1028
- * Conversation ID
981
+ * Declared parameters for this template. Each parameter may have a default value and an optional description. Parameters without a default must be supplied in the `parameters` field of the deploy request.
982
+ *
1029
983
  */
1030
- id?: string;
984
+ parameters?: {
985
+ [key: string]: ParameterDeclaration;
986
+ } | null;
1031
987
  /**
1032
- * Project ID
988
+ * Map of logical resource IDs to resource declarations
1033
989
  */
1034
- project_id?: string;
990
+ resources: {
991
+ [key: string]: ResourceDeclaration;
992
+ };
1035
993
  /**
1036
- * Optional human-readable name for the conversation.
994
+ * Map of output names to values. Values may use `{ "ref": "logicalId" }` to reference physical IDs of created resources, or `{ "param": "ParamName" }` and `{ "sub": "text ${ParamName}" }` to embed parameter values.
995
+ *
1037
996
  */
1038
- name?: string | null;
997
+ outputs?: {
998
+ [key: string]: unknown;
999
+ } | null;
1000
+ metadata?: {
1001
+ [key: string]: unknown;
1002
+ } | null;
1003
+ };
1004
+ type ParameterDeclaration = {
1039
1005
  /**
1040
- * Conversation status
1006
+ * Parameter type (currently only 'string' is supported)
1041
1007
  */
1042
- status?: 'open' | 'closed';
1008
+ type?: string;
1043
1009
  /**
1044
- * Creation timestamp
1010
+ * Default value used when the parameter is not supplied at deploy time
1045
1011
  */
1046
- created_at?: Date;
1012
+ default?: string | null;
1047
1013
  /**
1048
- * Last update timestamp
1014
+ * Human-readable description of what this parameter represents
1049
1015
  */
1050
- updated_at?: Date;
1016
+ description?: string | null;
1051
1017
  /**
1052
- * Actor ID associated with this conversation
1018
+ * When true, the parameter value should be treated as sensitive and not echoed in logs or UI. Analogous to NoEcho in CloudFormation.
1019
+ *
1053
1020
  */
1054
- actor_id?: string | null;
1021
+ no_echo?: boolean | null;
1055
1022
  };
1056
- type ConversationMessageRecord = {
1023
+ /**
1024
+ * Creates an AI agent backed by a provider. The agent handles requests, runs tools, and can be attached to actors.
1025
+ */
1026
+ type AgentResourceProperties = {
1057
1027
  /**
1058
- * Document ID
1028
+ * Public ID of the AI provider
1059
1029
  */
1060
- document_id?: string;
1030
+ ai_provider_id: string;
1061
1031
  /**
1062
- * Role of the message sender
1032
+ * Agent display name
1063
1033
  */
1064
- role?: 'user' | 'assistant' | 'system';
1034
+ name?: string | null;
1065
1035
  /**
1066
- * Optional actor ID associated with this message
1036
+ * System instructions for the agent
1067
1037
  */
1068
- actor_id?: string | null;
1038
+ instructions?: string | null;
1069
1039
  /**
1070
- * Optional agent ID that generated this message (set for assistant messages produced by generate)
1040
+ * Model identifier (overrides provider default)
1071
1041
  */
1072
- agent_id?: string | null;
1042
+ model?: string | null;
1073
1043
  /**
1074
- * Zero-based position in the conversation
1044
+ * Agent tool IDs to attach
1075
1045
  */
1076
- position?: number;
1046
+ tool_ids?: Array<string> | null;
1077
1047
  /**
1078
- * Optional structured metadata attached to the message
1048
+ * Maximum number of agentic steps per generation
1079
1049
  */
1080
- metadata?: {
1050
+ max_steps?: number | null;
1051
+ /**
1052
+ * Controls how the model selects tools. Examples: `{ "type": "auto" }`, `{ "type": "none" }`, `{ "type": "required" }`, or `{ "type": "tool", "name": "my_tool" }`.
1053
+ */
1054
+ tool_choice?: {
1081
1055
  [key: string]: unknown;
1082
1056
  } | null;
1083
1057
  /**
1084
- * Full text content of the message
1058
+ * Conditions that stop multi-step generation early. The loop stops when any condition is met.
1085
1059
  */
1086
- content?: string | null;
1087
- };
1088
- type ConversationActorRecord = {
1060
+ stop_conditions?: Array<{
1061
+ /**
1062
+ * Condition type currently `hasToolCall`
1063
+ */
1064
+ type?: string;
1065
+ /**
1066
+ * Tool name to match when type is `hasToolCall`
1067
+ */
1068
+ tool_name?: string | null;
1069
+ }> | null;
1089
1070
  /**
1090
- * Actor ID
1071
+ * Subset of tool_ids that are active
1091
1072
  */
1092
- id?: string;
1073
+ active_tool_ids?: Array<string> | null;
1093
1074
  /**
1094
- * Project ID
1075
+ * Per-step overrides applied during multi-step generation. Steps not covered by a rule use the agent defaults.
1095
1076
  */
1096
- project_id?: string;
1077
+ step_rules?: Array<{
1078
+ /**
1079
+ * 1-indexed step number this rule applies to
1080
+ */
1081
+ step?: number;
1082
+ /**
1083
+ * Tool choice override for this step, e.g. `auto`, `required`, or `{ type: tool, tool_name: search }`
1084
+ */
1085
+ tool_choice?: {
1086
+ [key: string]: unknown;
1087
+ } | null;
1088
+ /**
1089
+ * Tool IDs active on this step
1090
+ */
1091
+ active_tool_ids?: Array<string> | null;
1092
+ }> | null;
1097
1093
  /**
1098
- * Actor name
1094
+ * Restricts which SOAT actions the agent may invoke. Evaluated as the intersection with the caller's own policy.
1099
1095
  */
1100
- name?: string;
1096
+ boundary_policy?: {
1097
+ /**
1098
+ * List of IAM policy statements
1099
+ */
1100
+ statement?: Array<{
1101
+ /**
1102
+ * Effect — `Allow` or `Deny`
1103
+ */
1104
+ effect?: string;
1105
+ /**
1106
+ * IAM action strings, e.g. `memories:*` or `agents:DeleteAgent`
1107
+ */
1108
+ action?: Array<string>;
1109
+ /**
1110
+ * Resource SRN patterns (optional; omit to match all resources)
1111
+ */
1112
+ resource?: Array<string> | null;
1113
+ }>;
1114
+ } | null;
1101
1115
  /**
1102
- * Actor type
1116
+ * Sampling temperature
1103
1117
  */
1104
- type?: string;
1118
+ temperature?: number | null;
1105
1119
  /**
1106
- * External identifier
1120
+ * Knowledge retrieval configuration. When set, relevant documents and memory entries are injected into every generation.
1107
1121
  */
1108
- external_id?: string;
1122
+ knowledge_config?: {
1123
+ /**
1124
+ * Public IDs of memories to retrieve from
1125
+ */
1126
+ memory_ids?: Array<string>;
1127
+ /**
1128
+ * Retrieve from all memories matching these tags
1129
+ */
1130
+ memory_tags?: Array<string>;
1131
+ /**
1132
+ * Public IDs of documents to retrieve from
1133
+ */
1134
+ document_ids?: Array<string>;
1135
+ /**
1136
+ * Retrieve from all documents matching these path prefixes
1137
+ */
1138
+ document_paths?: Array<string>;
1139
+ /**
1140
+ * Minimum similarity score (0–1) for retrieved chunks
1141
+ */
1142
+ min_score?: number;
1143
+ /**
1144
+ * Maximum number of chunks to inject
1145
+ */
1146
+ limit?: number;
1147
+ /**
1148
+ * Public ID of the memory the agent can write to. When set, a `write_memory` tool is automatically available to the agent.
1149
+ */
1150
+ write_memory_id?: string | null;
1151
+ } | null;
1152
+ };
1153
+ /**
1154
+ * Creates a stateful conversation actor that wraps an agent or chat session and optionally links to a memory store.
1155
+ */
1156
+ type ActorResourceProperties = {
1109
1157
  /**
1110
- * Creation timestamp
1158
+ * Actor display name
1111
1159
  */
1112
- created_at?: Date;
1160
+ name: string;
1113
1161
  /**
1114
- * Last update timestamp
1162
+ * External identifier for idempotent actor creation
1115
1163
  */
1116
- updated_at?: Date;
1117
- };
1118
- type GenerateConversationMessageCompleted = {
1164
+ external_id?: string | null;
1119
1165
  /**
1120
- * Indicates generation finished successfully.
1166
+ * Persona-specific instructions
1121
1167
  */
1122
- status: 'completed';
1168
+ instructions?: string | null;
1123
1169
  /**
1124
- * The AI-generated text of the reply. This is the canonical field for the assistant's response text.
1125
- *
1170
+ * Linked agent ID (mutually exclusive with chat_id)
1126
1171
  */
1127
- content: string;
1128
- message: ConversationMessageRecord;
1172
+ agent_id?: string | null;
1129
1173
  /**
1130
- * ID of the underlying generation record.
1174
+ * Linked chat ID (mutually exclusive with agent_id)
1131
1175
  */
1132
- generation_id: string;
1176
+ chat_id?: string | null;
1133
1177
  /**
1134
- * Trace ID for observability.
1178
+ * Linked memory ID
1135
1179
  */
1136
- trace_id: string;
1180
+ memory_id?: string | null;
1137
1181
  /**
1138
- * Model used for generation.
1182
+ * Whether to auto-create memory when actor is created
1139
1183
  */
1140
- model?: string;
1184
+ auto_create_memory?: boolean;
1141
1185
  };
1142
- type GenerateConversationMessageRequiresAction = {
1186
+ /**
1187
+ * Configures an LLM provider connection (API key, model, endpoint) that agents use to generate responses.
1188
+ */
1189
+ type AiProviderResourceProperties = {
1143
1190
  /**
1144
- * Indicates the agent requires tool-call outputs before it can produce a reply. No message is persisted yet.
1145
- *
1191
+ * Provider display name
1146
1192
  */
1147
- status: 'requires_action';
1193
+ name: string;
1148
1194
  /**
1149
- * ID of the paused generation. Pass to the tool-outputs endpoint.
1195
+ * Provider type (e.g. openai, anthropic)
1150
1196
  */
1151
- generation_id: string;
1197
+ provider: string;
1152
1198
  /**
1153
- * Trace ID for observability.
1199
+ * Default model identifier (e.g. gpt-4o, claude-3-7-sonnet)
1154
1200
  */
1155
- trace_id: string;
1201
+ default_model: string;
1156
1202
  /**
1157
- * Tool-call information the client must resolve.
1203
+ * Public ID of the secret containing the API key
1158
1204
  */
1159
- required_action: {
1205
+ secret_id?: string | null;
1206
+ /**
1207
+ * Custom base URL for the provider API (self-hosted or proxy)
1208
+ */
1209
+ base_url?: string | null;
1210
+ /**
1211
+ * Provider-specific extra configuration
1212
+ */
1213
+ config?: {
1160
1214
  [key: string]: unknown;
1161
- };
1215
+ } | null;
1162
1216
  };
1163
- type GenerateConversationMessageResponse = ({
1164
- status: 'completed';
1165
- } & GenerateConversationMessageCompleted) | ({
1166
- status: 'requires_action';
1167
- } & GenerateConversationMessageRequiresAction);
1168
- type DocumentRecord = {
1217
+ /**
1218
+ * Defines a tool (HTTP endpoint, MCP server, or SOAT action) that agents can invoke during a generation.
1219
+ */
1220
+ type ToolResourceProperties = {
1169
1221
  /**
1170
- * Document ID
1222
+ * Tool display name
1171
1223
  */
1172
- id?: string;
1224
+ name: string;
1173
1225
  /**
1174
- * Underlying file ID
1226
+ * Tool type hint (e.g. http, mcp, soat)
1175
1227
  */
1176
- file_id?: string;
1228
+ type?: string | null;
1177
1229
  /**
1178
- * Project ID
1230
+ * Tool description shown to the model
1179
1231
  */
1180
- project_id?: string;
1232
+ description?: string | null;
1181
1233
  /**
1182
- * Logical path of the document within the project (e.g. /reports/q1.txt)
1234
+ * JSON Schema describing the tool's input parameters (free-form, user-defined)
1235
+ */
1236
+ parameters?: {
1237
+ [key: string]: unknown;
1238
+ } | null;
1239
+ /**
1240
+ * HTTP execution configuration. Required for `http` tools.
1241
+ */
1242
+ execute?: {
1243
+ /**
1244
+ * Endpoint URL. Supports `{param}` placeholders resolved from tool arguments.
1245
+ */
1246
+ url?: string;
1247
+ /**
1248
+ * HTTP method (default: `POST`)
1249
+ */
1250
+ method?: string | null;
1251
+ /**
1252
+ * Static headers included in every request
1253
+ */
1254
+ headers?: {
1255
+ [key: string]: unknown;
1256
+ } | null;
1257
+ } | null;
1258
+ /**
1259
+ * MCP server connection configuration. Required for `mcp` tools.
1260
+ */
1261
+ mcp?: {
1262
+ /**
1263
+ * MCP server URL
1264
+ */
1265
+ url?: string;
1266
+ /**
1267
+ * Headers included in every MCP request
1268
+ */
1269
+ headers?: {
1270
+ [key: string]: unknown;
1271
+ } | null;
1272
+ } | null;
1273
+ /**
1274
+ * IAM action strings the tool is permitted to call
1275
+ */
1276
+ actions?: Array<string> | null;
1277
+ /**
1278
+ * Pre-filled parameter values injected at execution time
1279
+ */
1280
+ preset_parameters?: {
1281
+ [key: string]: unknown;
1282
+ } | null;
1283
+ };
1284
+ /**
1285
+ * Stores a text document in a project, optionally indexing it for knowledge retrieval.
1286
+ */
1287
+ type DocumentResourceProperties = {
1288
+ /**
1289
+ * Document text content
1290
+ */
1291
+ content: string;
1292
+ /**
1293
+ * Virtual path for organising the document
1183
1294
  */
1184
1295
  path?: string | null;
1185
1296
  /**
1186
1297
  * Original filename
1187
1298
  */
1188
- filename?: string;
1299
+ filename?: string | null;
1189
1300
  /**
1190
- * File size in bytes
1301
+ * Document title
1191
1302
  */
1192
- size?: number;
1303
+ title?: string | null;
1193
1304
  /**
1194
- * Text content (only present on getDocument)
1305
+ * Arbitrary metadata key-value pairs
1195
1306
  */
1196
- content?: string | null;
1197
- created_at?: Date;
1198
- updated_at?: Date;
1307
+ metadata?: {
1308
+ [key: string]: unknown;
1309
+ } | null;
1310
+ /**
1311
+ * Tag key-value pairs for filtering
1312
+ */
1313
+ tags?: {
1314
+ [key: string]: unknown;
1315
+ } | null;
1199
1316
  };
1200
- type UploadFileBase64Request = {
1317
+ /**
1318
+ * Creates a named memory store that actors can read from and write to across conversations.
1319
+ */
1320
+ type MemoryResourceProperties = {
1201
1321
  /**
1202
- * Public ID of the project
1322
+ * Memory display name
1203
1323
  */
1204
- project_id: string;
1324
+ name: string;
1205
1325
  /**
1206
- * Base64-encoded file content
1326
+ * What this memory stores
1207
1327
  */
1208
- content: string;
1328
+ description?: string | null;
1209
1329
  /**
1210
- * Name of the file
1330
+ * Tag strings for filtering
1211
1331
  */
1212
- filename?: string;
1332
+ tags?: Array<string> | null;
1333
+ };
1334
+ /**
1335
+ * Adds a single text entry to a memory store.
1336
+ */
1337
+ type MemoryEntryResourceProperties = {
1213
1338
  /**
1214
- * Logical path within the project (e.g. /images/logo.png). Defaults to /filename if omitted.
1339
+ * Public ID of the parent memory (or ref expression)
1215
1340
  */
1216
- path?: string;
1341
+ memory_id: string;
1217
1342
  /**
1218
- * MIME type of the file
1343
+ * Text content of the memory entry
1219
1344
  */
1220
- content_type?: string;
1345
+ content: string;
1221
1346
  /**
1222
- * JSON string with additional metadata
1347
+ * Origin label (e.g. manual, document, import)
1223
1348
  */
1224
- metadata?: string;
1349
+ source?: string | null;
1225
1350
  };
1226
1351
  /**
1227
- * Stored file metadata
1352
+ * Registers an HTTPS endpoint to receive SOAT platform event notifications.
1228
1353
  */
1229
- type FileRecord = {
1354
+ type WebhookResourceProperties = {
1230
1355
  /**
1231
- * Unique file identifier
1356
+ * Webhook display name
1232
1357
  */
1233
- id?: string;
1358
+ name: string;
1234
1359
  /**
1235
- * Logical path of the file within the project (e.g. /images/logo.png)
1360
+ * Optional description
1236
1361
  */
1237
- path?: string | null;
1362
+ description?: string | null;
1238
1363
  /**
1239
- * Name of the file
1364
+ * HTTPS endpoint that receives event payloads
1240
1365
  */
1241
- filename?: string;
1366
+ url: string;
1242
1367
  /**
1243
- * MIME type of the file
1368
+ * Event types to subscribe to (e.g. memory.updated)
1244
1369
  */
1245
- contentType?: string;
1370
+ events: Array<string>;
1371
+ };
1372
+ /**
1373
+ * Creates an API key scoped to the formation's project and optionally restricted by a set of policies. The key is owned by the project owner.
1374
+ */
1375
+ type ApiKeyResourceProperties = {
1246
1376
  /**
1247
- * File size in bytes
1377
+ * Human-readable label for the API key
1248
1378
  */
1249
- size?: number;
1379
+ name: string;
1250
1380
  /**
1251
- * Storage backend type
1381
+ * Optional list of policy public IDs that further restrict the key's permissions
1252
1382
  */
1253
- storage_type?: 'local' | 's3' | 'gcs';
1383
+ policy_ids?: Array<string>;
1384
+ };
1385
+ /**
1386
+ * Creates a chat connected to an AI provider within the formation's project.
1387
+ */
1388
+ type ChatResourceProperties = {
1254
1389
  /**
1255
- * Path where the file is stored
1390
+ * Public ID of the AI provider to use for this chat
1256
1391
  */
1257
- storage_path?: string;
1392
+ ai_provider_id: string;
1258
1393
  /**
1259
- * JSON string with additional metadata
1394
+ * Human-readable label for the chat
1260
1395
  */
1261
- metadata?: string;
1396
+ name?: string | null;
1262
1397
  /**
1263
- * Creation timestamp
1398
+ * System message to set the assistant behaviour
1264
1399
  */
1265
- created_at?: Date;
1400
+ system_message?: string | null;
1266
1401
  /**
1267
- * Last update timestamp
1402
+ * Model override; defaults to the AI provider's default model
1268
1403
  */
1269
- updated_at?: Date;
1404
+ model?: string | null;
1270
1405
  };
1271
- type KnowledgeResult = ({
1272
- source_type: 'document';
1273
- } & DocumentKnowledgeResult) | ({
1274
- source_type: 'memory';
1275
- } & MemoryKnowledgeResult);
1276
- type DocumentKnowledgeResult = {
1406
+ /**
1407
+ * Creates a conversation within the formation's project.
1408
+ */
1409
+ type ConversationResourceProperties = {
1277
1410
  /**
1278
- * The type of knowledge source this result comes from
1411
+ * Human-readable label for the conversation
1279
1412
  */
1280
- source_type: 'document';
1413
+ name?: string | null;
1281
1414
  /**
1282
- * Public ID of the document
1415
+ * Initial status of the conversation (open or closed)
1283
1416
  */
1284
- document_id: string;
1417
+ status?: string;
1285
1418
  /**
1286
- * Public ID of the underlying file
1419
+ * Public ID of an actor to associate with this conversation
1287
1420
  */
1288
- file_id?: string;
1421
+ actor_id?: string | null;
1422
+ };
1423
+ /**
1424
+ * Registers a file record within the formation's project.
1425
+ */
1426
+ type FileResourceProperties = {
1289
1427
  /**
1290
- * Public ID of the project the document belongs to
1428
+ * Storage backend type
1291
1429
  */
1292
- project_id?: string;
1430
+ storage_type: 'local' | 's3' | 'gcs';
1431
+ /**
1432
+ * Path where the file is stored in the storage backend
1433
+ */
1434
+ storage_path: string;
1293
1435
  /**
1294
1436
  * Logical path of the file within the project
1295
1437
  */
1296
- path?: string;
1438
+ path?: string | null;
1297
1439
  /**
1298
- * Filename of the underlying file
1440
+ * Name of the file
1299
1441
  */
1300
- filename?: string;
1442
+ filename?: string | null;
1443
+ /**
1444
+ * MIME type of the file
1445
+ */
1446
+ content_type?: string | null;
1301
1447
  /**
1302
1448
  * File size in bytes
1303
1449
  */
1304
- size?: number;
1450
+ size?: number | null;
1305
1451
  /**
1306
- * Document title
1452
+ * JSON string with additional metadata
1307
1453
  */
1308
- title?: string;
1454
+ metadata?: string | null;
1455
+ };
1456
+ /**
1457
+ * Creates an access-control policy within the formation's project.
1458
+ */
1459
+ type PolicyResourceProperties = {
1309
1460
  /**
1310
- * Arbitrary metadata attached to the document
1461
+ * Human-readable label for the policy
1311
1462
  */
1312
- metadata?: {
1313
- [key: string]: unknown;
1314
- };
1463
+ name?: string | null;
1315
1464
  /**
1316
- * Key-value tags
1465
+ * Description of what the policy grants
1317
1466
  */
1318
- tags?: {
1319
- [key: string]: string;
1467
+ description?: string | null;
1468
+ /**
1469
+ * Policy document containing an array of statements
1470
+ */
1471
+ document: {
1472
+ [key: string]: unknown;
1320
1473
  };
1474
+ };
1475
+ /**
1476
+ * Creates an encrypted secret within the formation's project.
1477
+ */
1478
+ type SecretResourceProperties = {
1321
1479
  /**
1322
- * Full text content of the document
1480
+ * Human-readable label for the secret
1323
1481
  */
1324
- content: string | null;
1482
+ name: string;
1325
1483
  /**
1326
- * Semantic similarity score (0–1). Only present when `query` was provided.
1484
+ * The secret value to encrypt and store
1327
1485
  */
1328
- score?: number;
1486
+ value?: string | null;
1487
+ };
1488
+ /**
1489
+ * Creates a session attached to an agent within the formation's project.
1490
+ */
1491
+ type SessionResourceProperties = {
1329
1492
  /**
1330
- * Creation timestamp
1493
+ * Public ID of the agent that owns this session
1331
1494
  */
1332
- created_at: Date;
1495
+ agent_id: string;
1333
1496
  /**
1334
- * Last updated timestamp
1497
+ * Human-readable label for the session
1335
1498
  */
1336
- updated_at: Date;
1337
- };
1338
- type MemoryKnowledgeResult = {
1499
+ name?: string | null;
1339
1500
  /**
1340
- * The type of knowledge source this result comes from
1501
+ * Public ID of an actor to associate with this session
1341
1502
  */
1342
- source_type: 'memory';
1503
+ actor_id?: string | null;
1343
1504
  /**
1344
- * Public ID of the memory entry
1505
+ * Whether to automatically generate a response when messages are sent
1345
1506
  */
1346
- entry_id: string;
1507
+ auto_generate?: boolean;
1347
1508
  /**
1348
- * Public ID of the parent memory
1509
+ * Optional context object passed to tool calls
1349
1510
  */
1350
- memory_id: string;
1511
+ tool_context?: {
1512
+ [key: string]: unknown;
1513
+ } | null;
1514
+ };
1515
+ type ResourceDeclaration = {
1351
1516
  /**
1352
- * Text content of the memory entry
1517
+ * Resource type
1353
1518
  */
1354
- content: string;
1519
+ type: 'ai_provider' | 'tool' | 'agent' | 'actor' | 'api_key' | 'chat' | 'conversation' | 'document' | 'file' | 'memory' | 'memory_entry' | 'policy' | 'secret' | 'session' | 'webhook';
1355
1520
  /**
1356
- * Semantic similarity score (0–1). Only present when `query` was provided.
1521
+ * Resource properties. Values may use `{ "ref": "logicalId" }` to reference physical IDs of other resources in the template, `{ "param": "ParamName" }` to substitute a parameter value, or `{ "sub": "text ${ParamName}" }` to interpolate parameter values into a string.
1522
+ *
1357
1523
  */
1358
- score?: number;
1524
+ properties: AgentResourceProperties | ActorResourceProperties | AiProviderResourceProperties | ToolResourceProperties | ApiKeyResourceProperties | ChatResourceProperties | ConversationResourceProperties | DocumentResourceProperties | FileResourceProperties | MemoryResourceProperties | MemoryEntryResourceProperties | PolicyResourceProperties | SecretResourceProperties | SessionResourceProperties | WebhookResourceProperties;
1359
1525
  /**
1360
- * Creation timestamp
1526
+ * Explicit dependency list. In addition to implicit `ref` dependencies.
1361
1527
  */
1362
- created_at: Date;
1528
+ depends_on?: Array<string> | null;
1363
1529
  /**
1364
- * Last updated timestamp
1530
+ * Controls what happens to the physical resource when it is removed from the stack. `delete` (default) deletes the physical resource. `retain` keeps the physical resource alive and only removes the formation record.
1531
+ *
1365
1532
  */
1366
- updated_at: Date;
1533
+ deletion_policy?: 'delete' | 'retain';
1534
+ metadata?: {
1535
+ [key: string]: unknown;
1536
+ } | null;
1367
1537
  };
1368
- type Memory = {
1369
- id?: string;
1370
- project_id?: string;
1371
- name?: string;
1372
- description?: string | null;
1538
+ type FormationResource = {
1373
1539
  /**
1374
- * List of tags for filtering in knowledge search
1540
+ * Public ID of the resource record
1375
1541
  */
1376
- tags?: Array<string> | null;
1377
- created_at?: Date;
1378
- updated_at?: Date;
1379
- };
1380
- type MemoryEntry = {
1381
1542
  id?: string;
1382
- memory_id?: string;
1383
- content?: string;
1384
- source?: 'manual' | 'agent' | 'extraction';
1543
+ /**
1544
+ * Logical identifier from the template
1545
+ */
1546
+ logical_id?: string;
1547
+ /**
1548
+ * Resource type (e.g. agent, memory)
1549
+ */
1550
+ resource_type?: string;
1551
+ /**
1552
+ * Public ID of the physical SOAT resource
1553
+ */
1554
+ physical_resource_id?: string | null;
1555
+ /**
1556
+ * Current resource status
1557
+ */
1558
+ status?: 'pending' | 'created' | 'updated' | 'deleted' | 'failed';
1559
+ };
1560
+ type Formation = {
1561
+ /**
1562
+ * Public ID of the formation
1563
+ */
1564
+ id?: string;
1565
+ /**
1566
+ * Project public ID
1567
+ */
1568
+ project_id?: string;
1569
+ /**
1570
+ * Human-readable formation name
1571
+ */
1572
+ name?: string;
1573
+ template?: FormationTemplate;
1574
+ /**
1575
+ * Resolved output values after stack deployment
1576
+ */
1577
+ outputs?: {
1578
+ [key: string]: string;
1579
+ } | null;
1580
+ /**
1581
+ * Formation status
1582
+ */
1583
+ status?: 'creating' | 'active' | 'updating' | 'failed' | 'deleting' | 'deleted' | 'delete_failed';
1584
+ metadata?: {
1585
+ [key: string]: unknown;
1586
+ } | null;
1587
+ /**
1588
+ * Resources managed by this formation (present on get/create/update)
1589
+ */
1590
+ resources?: Array<FormationResource>;
1591
+ created_at?: Date;
1592
+ updated_at?: Date;
1593
+ };
1594
+ type ValidationError = {
1595
+ /**
1596
+ * JSON path to the field with the error
1597
+ */
1598
+ path?: string;
1599
+ /**
1600
+ * Error description
1601
+ */
1602
+ message?: string;
1603
+ };
1604
+ type ValidationResult = {
1605
+ valid?: boolean;
1606
+ errors?: Array<ValidationError>;
1607
+ warnings?: Array<ValidationError>;
1608
+ };
1609
+ type PlanChange = {
1610
+ logical_id?: string;
1611
+ resource_type?: string;
1612
+ action?: 'create' | 'update' | 'delete' | 'no-op';
1613
+ };
1614
+ type PlanResult = {
1615
+ changes?: Array<PlanChange>;
1616
+ };
1617
+ type FormationEvent = {
1618
+ timestamp?: Date;
1619
+ logical_id?: string;
1620
+ resource_type?: string;
1621
+ action?: string;
1622
+ status?: 'succeeded' | 'failed';
1623
+ physical_resource_id?: string | null;
1624
+ error?: string | null;
1625
+ };
1626
+ type FormationOperation = {
1627
+ /**
1628
+ * Public ID of the operation
1629
+ */
1630
+ id?: string;
1631
+ operation_type?: 'validate' | 'plan' | 'create' | 'update' | 'delete';
1632
+ status?: 'pending' | 'running' | 'succeeded' | 'failed';
1633
+ events?: Array<FormationEvent> | null;
1634
+ plan?: PlanResult | null;
1635
+ error?: {
1636
+ [key: string]: unknown;
1637
+ } | null;
1638
+ created_at?: Date;
1639
+ updated_at?: Date;
1640
+ };
1641
+ type KnowledgeResult = ({
1642
+ source_type: 'document';
1643
+ } & DocumentKnowledgeResult) | ({
1644
+ source_type: 'memory';
1645
+ } & MemoryKnowledgeResult);
1646
+ type DocumentKnowledgeResult = {
1647
+ /**
1648
+ * The type of knowledge source this result comes from
1649
+ */
1650
+ source_type: 'document';
1651
+ /**
1652
+ * Public ID of the document
1653
+ */
1654
+ document_id: string;
1655
+ /**
1656
+ * Public ID of the underlying file
1657
+ */
1658
+ file_id?: string;
1659
+ /**
1660
+ * Public ID of the project the document belongs to
1661
+ */
1662
+ project_id?: string;
1663
+ /**
1664
+ * Logical path of the file within the project
1665
+ */
1666
+ path?: string;
1667
+ /**
1668
+ * Filename of the underlying file
1669
+ */
1670
+ filename?: string;
1671
+ /**
1672
+ * File size in bytes
1673
+ */
1674
+ size?: number;
1675
+ /**
1676
+ * Document title
1677
+ */
1678
+ title?: string;
1679
+ /**
1680
+ * Arbitrary metadata attached to the document
1681
+ */
1682
+ metadata?: {
1683
+ [key: string]: unknown;
1684
+ };
1685
+ /**
1686
+ * Key-value tags
1687
+ */
1688
+ tags?: {
1689
+ [key: string]: string;
1690
+ };
1691
+ /**
1692
+ * Full text content of the document
1693
+ */
1694
+ content: string | null;
1695
+ /**
1696
+ * Semantic similarity score (0–1). Only present when `query` was provided.
1697
+ */
1698
+ score?: number;
1699
+ /**
1700
+ * Creation timestamp
1701
+ */
1702
+ created_at: Date;
1703
+ /**
1704
+ * Last updated timestamp
1705
+ */
1706
+ updated_at: Date;
1707
+ };
1708
+ type MemoryKnowledgeResult = {
1709
+ /**
1710
+ * The type of knowledge source this result comes from
1711
+ */
1712
+ source_type: 'memory';
1713
+ /**
1714
+ * Public ID of the memory entry
1715
+ */
1716
+ entry_id: string;
1717
+ /**
1718
+ * Public ID of the parent memory
1719
+ */
1720
+ memory_id: string;
1721
+ /**
1722
+ * Text content of the memory entry
1723
+ */
1724
+ content: string;
1725
+ /**
1726
+ * Semantic similarity score (0–1). Only present when `query` was provided.
1727
+ */
1728
+ score?: number;
1729
+ /**
1730
+ * Creation timestamp
1731
+ */
1732
+ created_at: Date;
1733
+ /**
1734
+ * Last updated timestamp
1735
+ */
1736
+ updated_at: Date;
1737
+ };
1738
+ type Memory = {
1739
+ id?: string;
1740
+ project_id?: string;
1741
+ name?: string;
1742
+ description?: string | null;
1743
+ /**
1744
+ * List of tags for filtering in knowledge search
1745
+ */
1746
+ tags?: Array<string> | null;
1747
+ created_at?: Date;
1748
+ updated_at?: Date;
1749
+ };
1750
+ type MemoryEntry = {
1751
+ id?: string;
1752
+ memory_id?: string;
1753
+ content?: string;
1754
+ source?: 'manual' | 'agent' | 'extraction';
1385
1755
  created_at?: Date;
1386
1756
  updated_at?: Date;
1387
1757
  };
@@ -1596,55 +1966,194 @@ type SubmitSessionToolOutputsRequest = {
1596
1966
  output: unknown;
1597
1967
  }>;
1598
1968
  };
1599
- type Trace = {
1969
+ type Tool = {
1600
1970
  /**
1601
- * Public ID of the trace
1971
+ * Public ID of the tool
1602
1972
  */
1603
1973
  id?: string;
1604
1974
  /**
1605
- * Public ID of the project
1975
+ * Public ID of the owning project
1606
1976
  */
1607
1977
  project_id?: string;
1608
1978
  /**
1609
- * Public ID of the agent that produced this trace
1979
+ * Tool name
1610
1980
  */
1611
- agent_id?: string;
1981
+ name?: string;
1612
1982
  /**
1613
- * Public ID of the File containing the full serialized steps JSON. Null if the trace has not been saved yet (save is fire-and-forget).
1614
- *
1983
+ * Tool type
1615
1984
  */
1616
- file_id?: string | null;
1985
+ type?: 'http' | 'client' | 'mcp' | 'soat';
1617
1986
  /**
1618
- * Number of steps recorded in this trace
1987
+ * What the tool does (sent to the model)
1619
1988
  */
1620
- step_count?: number;
1989
+ description?: string | null;
1621
1990
  /**
1622
- * Public ID of the parent trace. Null if this trace is the root (i.e., it was not triggered by a sub-agent call from another trace).
1623
- *
1991
+ * JSON Schema for tool input
1624
1992
  */
1625
- parent_trace_id?: string | null;
1993
+ parameters?: {
1994
+ [key: string]: unknown;
1995
+ } | null;
1626
1996
  /**
1627
- * Public ID of the root trace for the entire execution tree. Null if this trace is itself the root.
1997
+ * Execution config for http tools. Supported fields: `url` (required), `method` (default `POST`), and `headers`. The `url` may contain `{paramName}` placeholders (e.g. `/users/{userId}`) that are replaced at call time with the corresponding tool argument value (URL-encoded). Arguments consumed as path parameters are excluded from the query string and request body.
1628
1998
  *
1629
1999
  */
1630
- root_trace_id?: string | null;
1631
- created_at?: Date;
1632
- };
1633
- /**
1634
- * A trace node in the execution tree, with nested children.
1635
- */
1636
- type TraceTreeNode = {
2000
+ execute?: {
2001
+ [key: string]: unknown;
2002
+ } | null;
1637
2003
  /**
1638
- * Public ID of the trace
2004
+ * MCP server config (url, headers)
1639
2005
  */
1640
- id?: string;
1641
- project_id?: string;
1642
- agent_id?: string;
1643
- file_id?: string | null;
1644
- step_count?: number;
1645
- parent_trace_id?: string | null;
1646
- root_trace_id?: string | null;
1647
- created_at?: Date;
2006
+ mcp?: {
2007
+ [key: string]: unknown;
2008
+ } | null;
2009
+ /**
2010
+ * SOAT platform actions to expose
2011
+ */
2012
+ actions?: Array<string> | null;
2013
+ /**
2014
+ * Fixed parameters merged into every soat tool call. Keys matching fields in the action's input schema are removed from the schema shown to the model and injected automatically at execution time.
2015
+ */
2016
+ preset_parameters?: {
2017
+ [key: string]: unknown;
2018
+ } | null;
2019
+ created_at?: Date;
2020
+ updated_at?: Date;
2021
+ };
2022
+ type CreateToolRequest = {
2023
+ /**
2024
+ * Public ID of the project
2025
+ */
2026
+ project_id?: string;
2027
+ /**
2028
+ * Tool name
2029
+ */
2030
+ name: string;
2031
+ /**
2032
+ * Tool type (default http)
2033
+ */
2034
+ type?: 'http' | 'client' | 'mcp' | 'soat';
2035
+ /**
2036
+ * What the tool does
2037
+ */
2038
+ description?: string;
2039
+ /**
2040
+ * JSON Schema for tool input
2041
+ */
2042
+ parameters?: {
2043
+ [key: string]: unknown;
2044
+ };
2045
+ /**
2046
+ * Execution config for http tools. Supported fields: `url` (required), `method` (default `POST`), and `headers`. The `url` may contain `{paramName}` placeholders (e.g. `/users/{userId}`) that are replaced at call time with the corresponding tool argument value (URL-encoded). Arguments consumed as path parameters are excluded from the query string and request body.
2047
+ *
2048
+ */
2049
+ execute?: {
2050
+ [key: string]: unknown;
2051
+ };
2052
+ /**
2053
+ * MCP server config (url, headers)
2054
+ */
2055
+ mcp?: {
2056
+ [key: string]: unknown;
2057
+ };
2058
+ /**
2059
+ * SOAT platform actions
2060
+ */
2061
+ actions?: Array<string>;
2062
+ /**
2063
+ * Fixed parameters merged into every soat tool call. Keys matching fields in the action's input schema are removed from the schema shown to the model and injected automatically at execution time.
2064
+ */
2065
+ preset_parameters?: {
2066
+ [key: string]: unknown;
2067
+ };
2068
+ };
2069
+ type UpdateToolRequest = {
2070
+ name?: string;
2071
+ type?: 'http' | 'client' | 'mcp' | 'soat';
2072
+ description?: string | null;
2073
+ parameters?: {
2074
+ [key: string]: unknown;
2075
+ } | null;
2076
+ /**
2077
+ * Execution config for http tools. Supported fields: `url` (required), `method` (default `POST`), and `headers`. The `url` may contain `{paramName}` placeholders (e.g. `/users/{userId}`) that are replaced at call time with the corresponding tool argument value (URL-encoded). Arguments consumed as path parameters are excluded from the query string and request body.
2078
+ *
2079
+ */
2080
+ execute?: {
2081
+ [key: string]: unknown;
2082
+ } | null;
2083
+ mcp?: {
2084
+ [key: string]: unknown;
2085
+ } | null;
2086
+ actions?: Array<string> | null;
2087
+ /**
2088
+ * Fixed parameters merged into every soat tool call. Keys matching fields in the action's input schema are removed from the schema shown to the model and injected automatically at execution time.
2089
+ */
2090
+ preset_parameters?: {
2091
+ [key: string]: unknown;
2092
+ } | null;
2093
+ };
2094
+ type CallToolRequest = {
2095
+ /**
2096
+ * For `soat` tools: the action name (must be in the tool's `actions` list). For `mcp` tools: the MCP tool name to invoke. Ignored for `http` tools.
2097
+ *
2098
+ */
2099
+ action?: string;
2100
+ /**
2101
+ * Input parameters for the tool call. These are merged with the tool's `preset_parameters` before execution (caller-supplied values take precedence).
2102
+ *
2103
+ */
2104
+ input?: {
2105
+ [key: string]: unknown;
2106
+ };
2107
+ };
2108
+ type Trace = {
2109
+ /**
2110
+ * Public ID of the trace
2111
+ */
2112
+ id?: string;
2113
+ /**
2114
+ * Public ID of the project
2115
+ */
2116
+ project_id?: string;
2117
+ /**
2118
+ * Public ID of the agent that produced this trace
2119
+ */
2120
+ agent_id?: string;
2121
+ /**
2122
+ * Public ID of the File containing the full serialized steps JSON. Null if the trace has not been saved yet (save is fire-and-forget).
2123
+ *
2124
+ */
2125
+ file_id?: string | null;
2126
+ /**
2127
+ * Number of steps recorded in this trace
2128
+ */
2129
+ step_count?: number;
2130
+ /**
2131
+ * Public ID of the parent trace. Null if this trace is the root (i.e., it was not triggered by a sub-agent call from another trace).
2132
+ *
2133
+ */
2134
+ parent_trace_id?: string | null;
2135
+ /**
2136
+ * Public ID of the root trace for the entire execution tree. Null if this trace is itself the root.
2137
+ *
2138
+ */
2139
+ root_trace_id?: string | null;
2140
+ created_at?: Date;
2141
+ };
2142
+ /**
2143
+ * A trace node in the execution tree, with nested children.
2144
+ */
2145
+ type TraceTreeNode = {
2146
+ /**
2147
+ * Public ID of the trace
2148
+ */
2149
+ id?: string;
2150
+ project_id?: string;
2151
+ agent_id?: string;
2152
+ file_id?: string | null;
2153
+ step_count?: number;
2154
+ parent_trace_id?: string | null;
2155
+ root_trace_id?: string | null;
2156
+ created_at?: Date;
1648
2157
  /**
1649
2158
  * Child traces triggered by sub-agent calls from this trace
1650
2159
  */
@@ -1702,6 +2211,9 @@ type UpdateWebhookRequest = {
1702
2211
  active?: boolean;
1703
2212
  policy_id?: string | null;
1704
2213
  };
2214
+ type WebhookSecretResponse = {
2215
+ secret?: string;
2216
+ };
1705
2217
  type Delivery = {
1706
2218
  id?: string;
1707
2219
  event_type?: string;
@@ -1766,575 +2278,157 @@ type ListActorsErrors = {
1766
2278
  type ListActorsError = ListActorsErrors[keyof ListActorsErrors];
1767
2279
  type ListActorsResponses = {
1768
2280
  /**
1769
- * List of actors
1770
- */
1771
- 200: {
1772
- data?: Array<ActorRecord>;
1773
- total?: number;
1774
- limit?: number;
1775
- offset?: number;
1776
- };
1777
- };
1778
- type ListActorsResponse = ListActorsResponses[keyof ListActorsResponses];
1779
- type CreateActorData = {
1780
- body: {
1781
- /**
1782
- * Project ID. Required for JWT auth; omit when using an project key.
1783
- */
1784
- project_id?: string;
1785
- name: string;
1786
- /**
1787
- * Optional external identifier (e.g. WhatsApp phone number). If provided and an actor with this externalId already exists in the project, the existing actor is returned (idempotent — 200 OK).
1788
- */
1789
- external_id?: string;
1790
- /**
1791
- * Memory ID to link to this actor. Mutually exclusive with auto_create_memory.
1792
- */
1793
- memory_id?: string | null;
1794
- /**
1795
- * When true, automatically creates a new memory container for this actor and links it. Ignored if memory_id is set. With external_id (idempotent), memory is only created on first creation.
1796
- */
1797
- auto_create_memory?: boolean;
1798
- };
1799
- path?: never;
1800
- query?: never;
1801
- url: '/api/v1/actors';
1802
- };
1803
- type CreateActorErrors = {
1804
- /**
1805
- * Invalid request body
1806
- */
1807
- 400: ErrorResponse;
1808
- /**
1809
- * Unauthorized
1810
- */
1811
- 401: ErrorResponse;
1812
- /**
1813
- * Forbidden
1814
- */
1815
- 403: ErrorResponse;
1816
- };
1817
- type CreateActorError = CreateActorErrors[keyof CreateActorErrors];
1818
- type CreateActorResponses = {
1819
- /**
1820
- * Actor already exists — returned when externalId matches an existing actor in this project (idempotent)
1821
- */
1822
- 200: ActorRecord;
1823
- /**
1824
- * Actor created
1825
- */
1826
- 201: ActorRecord;
1827
- };
1828
- type CreateActorResponse = CreateActorResponses[keyof CreateActorResponses];
1829
- type DeleteActorData = {
1830
- body?: never;
1831
- path: {
1832
- /**
1833
- * Actor ID
1834
- */
1835
- actor_id: string;
1836
- };
1837
- query?: never;
1838
- url: '/api/v1/actors/{actor_id}';
1839
- };
1840
- type DeleteActorErrors = {
1841
- /**
1842
- * Unauthorized
1843
- */
1844
- 401: ErrorResponse;
1845
- /**
1846
- * Forbidden
1847
- */
1848
- 403: ErrorResponse;
1849
- /**
1850
- * Actor not found
1851
- */
1852
- 404: ErrorResponse;
1853
- };
1854
- type DeleteActorError = DeleteActorErrors[keyof DeleteActorErrors];
1855
- type DeleteActorResponses = {
1856
- /**
1857
- * Actor deleted
1858
- */
1859
- 204: void;
1860
- };
1861
- type DeleteActorResponse = DeleteActorResponses[keyof DeleteActorResponses];
1862
- type GetActorData = {
1863
- body?: never;
1864
- path: {
1865
- /**
1866
- * Actor ID
1867
- */
1868
- actor_id: string;
1869
- };
1870
- query?: never;
1871
- url: '/api/v1/actors/{actor_id}';
1872
- };
1873
- type GetActorErrors = {
1874
- /**
1875
- * Unauthorized
1876
- */
1877
- 401: ErrorResponse;
1878
- /**
1879
- * Forbidden
1880
- */
1881
- 403: ErrorResponse;
1882
- /**
1883
- * Actor not found
1884
- */
1885
- 404: ErrorResponse;
1886
- };
1887
- type GetActorError = GetActorErrors[keyof GetActorErrors];
1888
- type GetActorResponses = {
1889
- /**
1890
- * Actor found
1891
- */
1892
- 200: ActorRecord;
1893
- };
1894
- type GetActorResponse = GetActorResponses[keyof GetActorResponses];
1895
- type UpdateActorData = {
1896
- body: {
1897
- name?: string;
1898
- /**
1899
- * Persona-specific instructions
1900
- */
1901
- instructions?: string;
1902
- /**
1903
- * Memory ID to link to this actor. Set to null to unlink.
1904
- */
1905
- memory_id?: string | null;
1906
- tags?: {
1907
- [key: string]: string;
1908
- };
1909
- };
1910
- path: {
1911
- /**
1912
- * Actor ID
1913
- */
1914
- actor_id: string;
1915
- };
1916
- query?: never;
1917
- url: '/api/v1/actors/{actor_id}';
1918
- };
1919
- type UpdateActorErrors = {
1920
- /**
1921
- * Unauthorized
1922
- */
1923
- 401: ErrorResponse;
1924
- /**
1925
- * Forbidden
1926
- */
1927
- 403: ErrorResponse;
1928
- /**
1929
- * Actor not found
1930
- */
1931
- 404: ErrorResponse;
1932
- };
1933
- type UpdateActorError = UpdateActorErrors[keyof UpdateActorErrors];
1934
- type UpdateActorResponses = {
1935
- /**
1936
- * Actor updated
1937
- */
1938
- 200: ActorRecord;
1939
- };
1940
- type UpdateActorResponse = UpdateActorResponses[keyof UpdateActorResponses];
1941
- type GetActorTagsData = {
1942
- body?: never;
1943
- path: {
1944
- /**
1945
- * Actor ID
1946
- */
1947
- actor_id: string;
1948
- };
1949
- query?: never;
1950
- url: '/api/v1/actors/{actor_id}/tags';
1951
- };
1952
- type GetActorTagsErrors = {
1953
- /**
1954
- * Unauthorized
1955
- */
1956
- 401: ErrorResponse;
1957
- /**
1958
- * Forbidden
1959
- */
1960
- 403: ErrorResponse;
1961
- /**
1962
- * Actor not found
1963
- */
1964
- 404: ErrorResponse;
1965
- };
1966
- type GetActorTagsError = GetActorTagsErrors[keyof GetActorTagsErrors];
1967
- type GetActorTagsResponses = {
1968
- /**
1969
- * Actor tags
1970
- */
1971
- 200: {
1972
- [key: string]: string;
1973
- };
1974
- };
1975
- type GetActorTagsResponse = GetActorTagsResponses[keyof GetActorTagsResponses];
1976
- type MergeActorTagsData = {
1977
- body: {
1978
- [key: string]: string;
1979
- };
1980
- path: {
1981
- /**
1982
- * Actor ID
1983
- */
1984
- actor_id: string;
1985
- };
1986
- query?: never;
1987
- url: '/api/v1/actors/{actor_id}/tags';
1988
- };
1989
- type MergeActorTagsErrors = {
1990
- /**
1991
- * Unauthorized
1992
- */
1993
- 401: ErrorResponse;
1994
- /**
1995
- * Forbidden
1996
- */
1997
- 403: ErrorResponse;
1998
- /**
1999
- * Actor not found
2000
- */
2001
- 404: ErrorResponse;
2002
- };
2003
- type MergeActorTagsError = MergeActorTagsErrors[keyof MergeActorTagsErrors];
2004
- type MergeActorTagsResponses = {
2005
- /**
2006
- * Tags merged
2007
- */
2008
- 200: {
2009
- [key: string]: string;
2010
- };
2011
- };
2012
- type MergeActorTagsResponse = MergeActorTagsResponses[keyof MergeActorTagsResponses];
2013
- type ReplaceActorTagsData = {
2014
- body: {
2015
- [key: string]: string;
2016
- };
2017
- path: {
2018
- /**
2019
- * Actor ID
2020
- */
2021
- actor_id: string;
2022
- };
2023
- query?: never;
2024
- url: '/api/v1/actors/{actor_id}/tags';
2025
- };
2026
- type ReplaceActorTagsErrors = {
2027
- /**
2028
- * Unauthorized
2029
- */
2030
- 401: ErrorResponse;
2031
- /**
2032
- * Forbidden
2033
- */
2034
- 403: ErrorResponse;
2035
- /**
2036
- * Actor not found
2037
- */
2038
- 404: ErrorResponse;
2039
- };
2040
- type ReplaceActorTagsError = ReplaceActorTagsErrors[keyof ReplaceActorTagsErrors];
2041
- type ReplaceActorTagsResponses = {
2042
- /**
2043
- * Tags replaced
2044
- */
2045
- 200: {
2046
- [key: string]: string;
2047
- };
2048
- };
2049
- type ReplaceActorTagsResponse = ReplaceActorTagsResponses[keyof ReplaceActorTagsResponses];
2050
- type ValidateAgentFormationData = {
2051
- body: {
2052
- template: FormationTemplateInput;
2053
- };
2054
- path?: never;
2055
- query?: never;
2056
- url: '/api/v1/agent-formations/validate';
2057
- };
2058
- type ValidateAgentFormationErrors = {
2059
- /**
2060
- * Unauthorized
2061
- */
2062
- 401: unknown;
2063
- };
2064
- type ValidateAgentFormationResponses = {
2065
- /**
2066
- * Validation result
2067
- */
2068
- 200: ValidationResult;
2069
- };
2070
- type ValidateAgentFormationResponse = ValidateAgentFormationResponses[keyof ValidateAgentFormationResponses];
2071
- type PlanAgentFormationData = {
2072
- body: {
2073
- /**
2074
- * Project ID
2075
- */
2076
- project_id: string;
2077
- /**
2078
- * Existing formation ID to compare against. Omit for new formation planning.
2079
- */
2080
- formation_id?: string;
2081
- template: FormationTemplateInput;
2082
- /**
2083
- * Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`.
2084
- *
2085
- */
2086
- parameters?: {
2087
- [key: string]: string;
2088
- } | null;
2089
- };
2090
- path?: never;
2091
- query?: never;
2092
- url: '/api/v1/agent-formations/plan';
2093
- };
2094
- type PlanAgentFormationErrors = {
2095
- /**
2096
- * Bad Request
2097
- */
2098
- 400: unknown;
2099
- /**
2100
- * Unauthorized
2101
- */
2102
- 401: unknown;
2103
- /**
2104
- * Forbidden
2105
- */
2106
- 403: unknown;
2107
- };
2108
- type PlanAgentFormationResponses = {
2109
- /**
2110
- * Plan result
2111
- */
2112
- 200: PlanResult;
2113
- };
2114
- type PlanAgentFormationResponse = PlanAgentFormationResponses[keyof PlanAgentFormationResponses];
2115
- type ListAgentFormationsData = {
2116
- body?: never;
2117
- path?: never;
2118
- query?: {
2119
- /**
2120
- * Project ID (required if not using project key auth)
2121
- */
2122
- project_id?: string;
2123
- };
2124
- url: '/api/v1/agent-formations';
2125
- };
2126
- type ListAgentFormationsErrors = {
2127
- /**
2128
- * Unauthorized
2129
- */
2130
- 401: unknown;
2131
- /**
2132
- * Forbidden
2133
- */
2134
- 403: unknown;
2135
- };
2136
- type ListAgentFormationsResponses = {
2137
- /**
2138
- * List of formations
2281
+ * List of actors
2139
2282
  */
2140
- 200: Array<AgentFormation>;
2283
+ 200: {
2284
+ data?: Array<ActorRecord>;
2285
+ total?: number;
2286
+ limit?: number;
2287
+ offset?: number;
2288
+ };
2141
2289
  };
2142
- type ListAgentFormationsResponse = ListAgentFormationsResponses[keyof ListAgentFormationsResponses];
2143
- type CreateAgentFormationData = {
2290
+ type ListActorsResponse = ListActorsResponses[keyof ListActorsResponses];
2291
+ type CreateActorData = {
2144
2292
  body: {
2145
2293
  /**
2146
- * Project ID
2294
+ * Project ID. Required for JWT auth; omit when using an project key.
2147
2295
  */
2148
- project_id: string;
2296
+ project_id?: string;
2297
+ name: string;
2149
2298
  /**
2150
- * Human-readable name for the formation stack
2299
+ * Optional external identifier (e.g. WhatsApp phone number). If provided and an actor with this externalId already exists in the project, the existing actor is returned (idempotent — 200 OK).
2151
2300
  */
2152
- name: string;
2153
- template: FormationTemplateInput;
2301
+ external_id?: string;
2154
2302
  /**
2155
- * Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.
2156
- *
2303
+ * Memory ID to link to this actor. Mutually exclusive with auto_create_memory.
2157
2304
  */
2158
- parameters?: {
2159
- [key: string]: string;
2160
- } | null;
2161
- metadata?: {
2162
- [key: string]: unknown;
2163
- } | null;
2305
+ memory_id?: string | null;
2306
+ /**
2307
+ * When true, automatically creates a new memory container for this actor and links it. Ignored if memory_id is set. With external_id (idempotent), memory is only created on first creation.
2308
+ */
2309
+ auto_create_memory?: boolean;
2164
2310
  };
2165
2311
  path?: never;
2166
2312
  query?: never;
2167
- url: '/api/v1/agent-formations';
2313
+ url: '/api/v1/actors';
2168
2314
  };
2169
- type CreateAgentFormationErrors = {
2315
+ type CreateActorErrors = {
2170
2316
  /**
2171
- * Bad Request
2317
+ * Invalid request body
2172
2318
  */
2173
- 400: unknown;
2319
+ 400: ErrorResponse;
2174
2320
  /**
2175
2321
  * Unauthorized
2176
2322
  */
2177
- 401: unknown;
2323
+ 401: ErrorResponse;
2178
2324
  /**
2179
2325
  * Forbidden
2180
2326
  */
2181
- 403: unknown;
2327
+ 403: ErrorResponse;
2328
+ };
2329
+ type CreateActorError = CreateActorErrors[keyof CreateActorErrors];
2330
+ type CreateActorResponses = {
2182
2331
  /**
2183
- * Formation with this name already exists
2332
+ * Actor already exists — returned when externalId matches an existing actor in this project (idempotent)
2184
2333
  */
2185
- 409: unknown;
2186
- };
2187
- type CreateAgentFormationResponses = {
2334
+ 200: ActorRecord;
2188
2335
  /**
2189
- * Formation created
2336
+ * Actor created
2190
2337
  */
2191
- 201: AgentFormation;
2338
+ 201: ActorRecord;
2192
2339
  };
2193
- type CreateAgentFormationResponse = CreateAgentFormationResponses[keyof CreateAgentFormationResponses];
2194
- type DeleteAgentFormationData = {
2340
+ type CreateActorResponse = CreateActorResponses[keyof CreateActorResponses];
2341
+ type DeleteActorData = {
2195
2342
  body?: never;
2196
2343
  path: {
2197
- formation_id: string;
2344
+ /**
2345
+ * Actor ID
2346
+ */
2347
+ actor_id: string;
2198
2348
  };
2199
2349
  query?: never;
2200
- url: '/api/v1/agent-formations/{formation_id}';
2350
+ url: '/api/v1/actors/{actor_id}';
2201
2351
  };
2202
- type DeleteAgentFormationErrors = {
2352
+ type DeleteActorErrors = {
2203
2353
  /**
2204
2354
  * Unauthorized
2205
2355
  */
2206
- 401: unknown;
2356
+ 401: ErrorResponse;
2207
2357
  /**
2208
2358
  * Forbidden
2209
2359
  */
2210
- 403: unknown;
2360
+ 403: ErrorResponse;
2211
2361
  /**
2212
- * Not Found
2362
+ * Actor not found
2213
2363
  */
2214
- 404: unknown;
2364
+ 404: ErrorResponse;
2215
2365
  };
2216
- type DeleteAgentFormationResponses = {
2366
+ type DeleteActorError = DeleteActorErrors[keyof DeleteActorErrors];
2367
+ type DeleteActorResponses = {
2217
2368
  /**
2218
- * Deleted
2369
+ * Actor deleted
2219
2370
  */
2220
2371
  204: void;
2221
2372
  };
2222
- type DeleteAgentFormationResponse = DeleteAgentFormationResponses[keyof DeleteAgentFormationResponses];
2223
- type GetAgentFormationData = {
2373
+ type DeleteActorResponse = DeleteActorResponses[keyof DeleteActorResponses];
2374
+ type GetActorData = {
2224
2375
  body?: never;
2225
2376
  path: {
2226
- formation_id: string;
2377
+ /**
2378
+ * Actor ID
2379
+ */
2380
+ actor_id: string;
2227
2381
  };
2228
2382
  query?: never;
2229
- url: '/api/v1/agent-formations/{formation_id}';
2383
+ url: '/api/v1/actors/{actor_id}';
2230
2384
  };
2231
- type GetAgentFormationErrors = {
2385
+ type GetActorErrors = {
2232
2386
  /**
2233
2387
  * Unauthorized
2234
2388
  */
2235
- 401: unknown;
2389
+ 401: ErrorResponse;
2236
2390
  /**
2237
2391
  * Forbidden
2238
2392
  */
2239
- 403: unknown;
2393
+ 403: ErrorResponse;
2240
2394
  /**
2241
- * Not Found
2395
+ * Actor not found
2242
2396
  */
2243
- 404: unknown;
2397
+ 404: ErrorResponse;
2244
2398
  };
2245
- type GetAgentFormationResponses = {
2399
+ type GetActorError = GetActorErrors[keyof GetActorErrors];
2400
+ type GetActorResponses = {
2246
2401
  /**
2247
- * Formation details
2402
+ * Actor found
2248
2403
  */
2249
- 200: AgentFormation;
2404
+ 200: ActorRecord;
2250
2405
  };
2251
- type GetAgentFormationResponse = GetAgentFormationResponses[keyof GetAgentFormationResponses];
2252
- type UpdateAgentFormationData = {
2253
- body?: {
2254
- template?: FormationTemplateInput;
2406
+ type GetActorResponse = GetActorResponses[keyof GetActorResponses];
2407
+ type UpdateActorData = {
2408
+ body: {
2409
+ name?: string;
2255
2410
  /**
2256
- * Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.
2257
- *
2411
+ * Persona-specific instructions
2258
2412
  */
2259
- parameters?: {
2413
+ instructions?: string;
2414
+ /**
2415
+ * Memory ID to link to this actor. Set to null to unlink.
2416
+ */
2417
+ memory_id?: string | null;
2418
+ tags?: {
2260
2419
  [key: string]: string;
2261
- } | null;
2262
- metadata?: {
2263
- [key: string]: unknown;
2264
- } | null;
2265
- };
2266
- path: {
2267
- formation_id: string;
2420
+ };
2268
2421
  };
2269
- query?: never;
2270
- url: '/api/v1/agent-formations/{formation_id}';
2271
- };
2272
- type UpdateAgentFormationErrors = {
2273
- /**
2274
- * Bad Request
2275
- */
2276
- 400: unknown;
2277
- /**
2278
- * Unauthorized
2279
- */
2280
- 401: unknown;
2281
- /**
2282
- * Forbidden
2283
- */
2284
- 403: unknown;
2285
- /**
2286
- * Not Found
2287
- */
2288
- 404: unknown;
2289
- };
2290
- type UpdateAgentFormationResponses = {
2291
- /**
2292
- * Updated formation
2293
- */
2294
- 200: AgentFormation;
2295
- };
2296
- type UpdateAgentFormationResponse = UpdateAgentFormationResponses[keyof UpdateAgentFormationResponses];
2297
- type ListAgentFormationEventsData = {
2298
- body?: never;
2299
2422
  path: {
2300
- formation_id: string;
2301
- };
2302
- query?: never;
2303
- url: '/api/v1/agent-formations/{formation_id}/events';
2304
- };
2305
- type ListAgentFormationEventsErrors = {
2306
- /**
2307
- * Unauthorized
2308
- */
2309
- 401: unknown;
2310
- /**
2311
- * Forbidden
2312
- */
2313
- 403: unknown;
2314
- /**
2315
- * Not Found
2316
- */
2317
- 404: unknown;
2318
- };
2319
- type ListAgentFormationEventsResponses = {
2320
- /**
2321
- * List of operations
2322
- */
2323
- 200: Array<FormationOperation>;
2324
- };
2325
- type ListAgentFormationEventsResponse = ListAgentFormationEventsResponses[keyof ListAgentFormationEventsResponses];
2326
- type ListAgentToolsData = {
2327
- body?: never;
2328
- path?: never;
2329
- query?: {
2330
2423
  /**
2331
- * Project public ID to filter by
2424
+ * Actor ID
2332
2425
  */
2333
- project_id?: string;
2426
+ actor_id: string;
2334
2427
  };
2335
- url: '/api/v1/agents/tools';
2428
+ query?: never;
2429
+ url: '/api/v1/actors/{actor_id}';
2336
2430
  };
2337
- type ListAgentToolsErrors = {
2431
+ type UpdateActorErrors = {
2338
2432
  /**
2339
2433
  * Unauthorized
2340
2434
  */
@@ -2343,52 +2437,31 @@ type ListAgentToolsErrors = {
2343
2437
  * Forbidden
2344
2438
  */
2345
2439
  403: ErrorResponse;
2346
- };
2347
- type ListAgentToolsError = ListAgentToolsErrors[keyof ListAgentToolsErrors];
2348
- type ListAgentToolsResponses = {
2349
- /**
2350
- * List of agent tools
2351
- */
2352
- 200: Array<AgentTool>;
2353
- };
2354
- type ListAgentToolsResponse = ListAgentToolsResponses[keyof ListAgentToolsResponses];
2355
- type CreateAgentToolData = {
2356
- body: CreateAgentToolRequest;
2357
- path?: never;
2358
- query?: never;
2359
- url: '/api/v1/agents/tools';
2360
- };
2361
- type CreateAgentToolErrors = {
2362
- /**
2363
- * Bad Request
2364
- */
2365
- 400: ErrorResponse;
2366
- /**
2367
- * Unauthorized
2368
- */
2369
- 401: ErrorResponse;
2370
2440
  /**
2371
- * Forbidden
2441
+ * Actor not found
2372
2442
  */
2373
- 403: ErrorResponse;
2443
+ 404: ErrorResponse;
2374
2444
  };
2375
- type CreateAgentToolError = CreateAgentToolErrors[keyof CreateAgentToolErrors];
2376
- type CreateAgentToolResponses = {
2445
+ type UpdateActorError = UpdateActorErrors[keyof UpdateActorErrors];
2446
+ type UpdateActorResponses = {
2377
2447
  /**
2378
- * Agent tool created
2448
+ * Actor updated
2379
2449
  */
2380
- 201: AgentTool;
2450
+ 200: ActorRecord;
2381
2451
  };
2382
- type CreateAgentToolResponse = CreateAgentToolResponses[keyof CreateAgentToolResponses];
2383
- type DeleteAgentToolData = {
2452
+ type UpdateActorResponse = UpdateActorResponses[keyof UpdateActorResponses];
2453
+ type GetActorTagsData = {
2384
2454
  body?: never;
2385
2455
  path: {
2386
- tool_id: string;
2456
+ /**
2457
+ * Actor ID
2458
+ */
2459
+ actor_id: string;
2387
2460
  };
2388
2461
  query?: never;
2389
- url: '/api/v1/agents/tools/{tool_id}';
2462
+ url: '/api/v1/actors/{actor_id}/tags';
2390
2463
  };
2391
- type DeleteAgentToolErrors = {
2464
+ type GetActorTagsErrors = {
2392
2465
  /**
2393
2466
  * Unauthorized
2394
2467
  */
@@ -2398,27 +2471,34 @@ type DeleteAgentToolErrors = {
2398
2471
  */
2399
2472
  403: ErrorResponse;
2400
2473
  /**
2401
- * Not found
2474
+ * Actor not found
2402
2475
  */
2403
2476
  404: ErrorResponse;
2404
2477
  };
2405
- type DeleteAgentToolError = DeleteAgentToolErrors[keyof DeleteAgentToolErrors];
2406
- type DeleteAgentToolResponses = {
2478
+ type GetActorTagsError = GetActorTagsErrors[keyof GetActorTagsErrors];
2479
+ type GetActorTagsResponses = {
2407
2480
  /**
2408
- * Deleted
2481
+ * Actor tags
2409
2482
  */
2410
- 204: void;
2483
+ 200: {
2484
+ [key: string]: string;
2485
+ };
2411
2486
  };
2412
- type DeleteAgentToolResponse = DeleteAgentToolResponses[keyof DeleteAgentToolResponses];
2413
- type GetAgentToolData = {
2414
- body?: never;
2487
+ type GetActorTagsResponse = GetActorTagsResponses[keyof GetActorTagsResponses];
2488
+ type MergeActorTagsData = {
2489
+ body: {
2490
+ [key: string]: string;
2491
+ };
2415
2492
  path: {
2416
- tool_id: string;
2493
+ /**
2494
+ * Actor ID
2495
+ */
2496
+ actor_id: string;
2417
2497
  };
2418
2498
  query?: never;
2419
- url: '/api/v1/agents/tools/{tool_id}';
2499
+ url: '/api/v1/actors/{actor_id}/tags';
2420
2500
  };
2421
- type GetAgentToolErrors = {
2501
+ type MergeActorTagsErrors = {
2422
2502
  /**
2423
2503
  * Unauthorized
2424
2504
  */
@@ -2428,27 +2508,34 @@ type GetAgentToolErrors = {
2428
2508
  */
2429
2509
  403: ErrorResponse;
2430
2510
  /**
2431
- * Not found
2511
+ * Actor not found
2432
2512
  */
2433
2513
  404: ErrorResponse;
2434
2514
  };
2435
- type GetAgentToolError = GetAgentToolErrors[keyof GetAgentToolErrors];
2436
- type GetAgentToolResponses = {
2515
+ type MergeActorTagsError = MergeActorTagsErrors[keyof MergeActorTagsErrors];
2516
+ type MergeActorTagsResponses = {
2437
2517
  /**
2438
- * Agent tool
2518
+ * Tags merged
2439
2519
  */
2440
- 200: AgentTool;
2520
+ 200: {
2521
+ [key: string]: string;
2522
+ };
2441
2523
  };
2442
- type GetAgentToolResponse = GetAgentToolResponses[keyof GetAgentToolResponses];
2443
- type UpdateAgentToolData = {
2444
- body: UpdateAgentToolRequest;
2524
+ type MergeActorTagsResponse = MergeActorTagsResponses[keyof MergeActorTagsResponses];
2525
+ type ReplaceActorTagsData = {
2526
+ body: {
2527
+ [key: string]: string;
2528
+ };
2445
2529
  path: {
2446
- tool_id: string;
2530
+ /**
2531
+ * Actor ID
2532
+ */
2533
+ actor_id: string;
2447
2534
  };
2448
2535
  query?: never;
2449
- url: '/api/v1/agents/tools/{tool_id}';
2536
+ url: '/api/v1/actors/{actor_id}/tags';
2450
2537
  };
2451
- type UpdateAgentToolErrors = {
2538
+ type ReplaceActorTagsErrors = {
2452
2539
  /**
2453
2540
  * Unauthorized
2454
2541
  */
@@ -2458,18 +2545,20 @@ type UpdateAgentToolErrors = {
2458
2545
  */
2459
2546
  403: ErrorResponse;
2460
2547
  /**
2461
- * Not found
2548
+ * Actor not found
2462
2549
  */
2463
2550
  404: ErrorResponse;
2464
2551
  };
2465
- type UpdateAgentToolError = UpdateAgentToolErrors[keyof UpdateAgentToolErrors];
2466
- type UpdateAgentToolResponses = {
2552
+ type ReplaceActorTagsError = ReplaceActorTagsErrors[keyof ReplaceActorTagsErrors];
2553
+ type ReplaceActorTagsResponses = {
2467
2554
  /**
2468
- * Agent tool updated
2555
+ * Tags replaced
2469
2556
  */
2470
- 200: AgentTool;
2557
+ 200: {
2558
+ [key: string]: string;
2559
+ };
2471
2560
  };
2472
- type UpdateAgentToolResponse = UpdateAgentToolResponses[keyof UpdateAgentToolResponses];
2561
+ type ReplaceActorTagsResponse = ReplaceActorTagsResponses[keyof ReplaceActorTagsResponses];
2473
2562
  type ListAgentsData = {
2474
2563
  body?: never;
2475
2564
  path?: never;
@@ -4606,63 +4695,339 @@ type MergeFileTagsErrors = {
4606
4695
  /**
4607
4696
  * Authentication required
4608
4697
  */
4609
- 401: ErrorResponse;
4698
+ 401: ErrorResponse;
4699
+ /**
4700
+ * Insufficient permissions
4701
+ */
4702
+ 403: ErrorResponse;
4703
+ /**
4704
+ * File not found
4705
+ */
4706
+ 404: ErrorResponse;
4707
+ };
4708
+ type MergeFileTagsError = MergeFileTagsErrors[keyof MergeFileTagsErrors];
4709
+ type MergeFileTagsResponses = {
4710
+ /**
4711
+ * Tags merged
4712
+ */
4713
+ 200: {
4714
+ [key: string]: string;
4715
+ };
4716
+ };
4717
+ type MergeFileTagsResponse = MergeFileTagsResponses[keyof MergeFileTagsResponses];
4718
+ type ReplaceFileTagsData = {
4719
+ body: {
4720
+ [key: string]: string;
4721
+ };
4722
+ path: {
4723
+ /**
4724
+ * File ID
4725
+ */
4726
+ file_id: string;
4727
+ };
4728
+ query?: never;
4729
+ url: '/api/v1/files/{file_id}/tags';
4730
+ };
4731
+ type ReplaceFileTagsErrors = {
4732
+ /**
4733
+ * Authentication required
4734
+ */
4735
+ 401: ErrorResponse;
4736
+ /**
4737
+ * Insufficient permissions
4738
+ */
4739
+ 403: ErrorResponse;
4740
+ /**
4741
+ * File not found
4742
+ */
4743
+ 404: ErrorResponse;
4744
+ };
4745
+ type ReplaceFileTagsError = ReplaceFileTagsErrors[keyof ReplaceFileTagsErrors];
4746
+ type ReplaceFileTagsResponses = {
4747
+ /**
4748
+ * Tags replaced
4749
+ */
4750
+ 200: {
4751
+ [key: string]: string;
4752
+ };
4753
+ };
4754
+ type ReplaceFileTagsResponse = ReplaceFileTagsResponses[keyof ReplaceFileTagsResponses];
4755
+ type ValidateFormationData = {
4756
+ body: {
4757
+ template: FormationTemplateInput;
4758
+ };
4759
+ path?: never;
4760
+ query?: never;
4761
+ url: '/api/v1/formations/validate';
4762
+ };
4763
+ type ValidateFormationErrors = {
4764
+ /**
4765
+ * Unauthorized
4766
+ */
4767
+ 401: unknown;
4768
+ };
4769
+ type ValidateFormationResponses = {
4770
+ /**
4771
+ * Validation result
4772
+ */
4773
+ 200: ValidationResult;
4774
+ };
4775
+ type ValidateFormationResponse = ValidateFormationResponses[keyof ValidateFormationResponses];
4776
+ type PlanFormationData = {
4777
+ body: {
4778
+ /**
4779
+ * Project ID
4780
+ */
4781
+ project_id: string;
4782
+ /**
4783
+ * Existing formation ID to compare against. Omit for new formation planning.
4784
+ */
4785
+ formation_id?: string;
4786
+ template: FormationTemplateInput;
4787
+ /**
4788
+ * Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`.
4789
+ *
4790
+ */
4791
+ parameters?: {
4792
+ [key: string]: string;
4793
+ } | null;
4794
+ };
4795
+ path?: never;
4796
+ query?: never;
4797
+ url: '/api/v1/formations/plan';
4798
+ };
4799
+ type PlanFormationErrors = {
4800
+ /**
4801
+ * Bad Request
4802
+ */
4803
+ 400: unknown;
4804
+ /**
4805
+ * Unauthorized
4806
+ */
4807
+ 401: unknown;
4808
+ /**
4809
+ * Forbidden
4810
+ */
4811
+ 403: unknown;
4812
+ };
4813
+ type PlanFormationResponses = {
4814
+ /**
4815
+ * Plan result
4816
+ */
4817
+ 200: PlanResult;
4818
+ };
4819
+ type PlanFormationResponse = PlanFormationResponses[keyof PlanFormationResponses];
4820
+ type ListFormationsData = {
4821
+ body?: never;
4822
+ path?: never;
4823
+ query?: {
4824
+ /**
4825
+ * Project ID (required if not using project key auth)
4826
+ */
4827
+ project_id?: string;
4828
+ };
4829
+ url: '/api/v1/formations';
4830
+ };
4831
+ type ListFormationsErrors = {
4832
+ /**
4833
+ * Unauthorized
4834
+ */
4835
+ 401: unknown;
4836
+ /**
4837
+ * Forbidden
4838
+ */
4839
+ 403: unknown;
4840
+ };
4841
+ type ListFormationsResponses = {
4842
+ /**
4843
+ * List of formations
4844
+ */
4845
+ 200: Array<Formation>;
4846
+ };
4847
+ type ListFormationsResponse = ListFormationsResponses[keyof ListFormationsResponses];
4848
+ type CreateFormationData = {
4849
+ body: {
4850
+ /**
4851
+ * Project ID
4852
+ */
4853
+ project_id: string;
4854
+ /**
4855
+ * Human-readable name for the formation stack
4856
+ */
4857
+ name: string;
4858
+ template: FormationTemplateInput;
4859
+ /**
4860
+ * Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.
4861
+ *
4862
+ */
4863
+ parameters?: {
4864
+ [key: string]: string;
4865
+ } | null;
4866
+ metadata?: {
4867
+ [key: string]: unknown;
4868
+ } | null;
4869
+ };
4870
+ path?: never;
4871
+ query?: never;
4872
+ url: '/api/v1/formations';
4873
+ };
4874
+ type CreateFormationErrors = {
4875
+ /**
4876
+ * Bad Request
4877
+ */
4878
+ 400: unknown;
4879
+ /**
4880
+ * Unauthorized
4881
+ */
4882
+ 401: unknown;
4883
+ /**
4884
+ * Forbidden
4885
+ */
4886
+ 403: unknown;
4887
+ /**
4888
+ * Formation with this name already exists
4889
+ */
4890
+ 409: unknown;
4891
+ };
4892
+ type CreateFormationResponses = {
4893
+ /**
4894
+ * Formation created
4895
+ */
4896
+ 201: Formation;
4897
+ };
4898
+ type CreateFormationResponse = CreateFormationResponses[keyof CreateFormationResponses];
4899
+ type DeleteFormationData = {
4900
+ body?: never;
4901
+ path: {
4902
+ formation_id: string;
4903
+ };
4904
+ query?: never;
4905
+ url: '/api/v1/formations/{formation_id}';
4906
+ };
4907
+ type DeleteFormationErrors = {
4908
+ /**
4909
+ * Unauthorized
4910
+ */
4911
+ 401: unknown;
4912
+ /**
4913
+ * Forbidden
4914
+ */
4915
+ 403: unknown;
4916
+ /**
4917
+ * Not Found
4918
+ */
4919
+ 404: unknown;
4920
+ };
4921
+ type DeleteFormationResponses = {
4922
+ /**
4923
+ * Deleted
4924
+ */
4925
+ 204: void;
4926
+ };
4927
+ type DeleteFormationResponse = DeleteFormationResponses[keyof DeleteFormationResponses];
4928
+ type GetFormationData = {
4929
+ body?: never;
4930
+ path: {
4931
+ formation_id: string;
4932
+ };
4933
+ query?: never;
4934
+ url: '/api/v1/formations/{formation_id}';
4935
+ };
4936
+ type GetFormationErrors = {
4937
+ /**
4938
+ * Unauthorized
4939
+ */
4940
+ 401: unknown;
4941
+ /**
4942
+ * Forbidden
4943
+ */
4944
+ 403: unknown;
4945
+ /**
4946
+ * Not Found
4947
+ */
4948
+ 404: unknown;
4949
+ };
4950
+ type GetFormationResponses = {
4951
+ /**
4952
+ * Formation details
4953
+ */
4954
+ 200: Formation;
4955
+ };
4956
+ type GetFormationResponse = GetFormationResponses[keyof GetFormationResponses];
4957
+ type UpdateFormationData = {
4958
+ body?: {
4959
+ template?: FormationTemplateInput;
4960
+ /**
4961
+ * Runtime parameter values that override or supply template parameter defaults. Keys must match parameter names declared in `template.parameters`. Required parameters (those without a default) must be provided here.
4962
+ *
4963
+ */
4964
+ parameters?: {
4965
+ [key: string]: string;
4966
+ } | null;
4967
+ metadata?: {
4968
+ [key: string]: unknown;
4969
+ } | null;
4970
+ };
4971
+ path: {
4972
+ formation_id: string;
4973
+ };
4974
+ query?: never;
4975
+ url: '/api/v1/formations/{formation_id}';
4976
+ };
4977
+ type UpdateFormationErrors = {
4978
+ /**
4979
+ * Bad Request
4980
+ */
4981
+ 400: unknown;
4982
+ /**
4983
+ * Unauthorized
4984
+ */
4985
+ 401: unknown;
4610
4986
  /**
4611
- * Insufficient permissions
4987
+ * Forbidden
4612
4988
  */
4613
- 403: ErrorResponse;
4989
+ 403: unknown;
4614
4990
  /**
4615
- * File not found
4991
+ * Not Found
4616
4992
  */
4617
- 404: ErrorResponse;
4993
+ 404: unknown;
4618
4994
  };
4619
- type MergeFileTagsError = MergeFileTagsErrors[keyof MergeFileTagsErrors];
4620
- type MergeFileTagsResponses = {
4995
+ type UpdateFormationResponses = {
4621
4996
  /**
4622
- * Tags merged
4997
+ * Updated formation
4623
4998
  */
4624
- 200: {
4625
- [key: string]: string;
4626
- };
4999
+ 200: Formation;
4627
5000
  };
4628
- type MergeFileTagsResponse = MergeFileTagsResponses[keyof MergeFileTagsResponses];
4629
- type ReplaceFileTagsData = {
4630
- body: {
4631
- [key: string]: string;
4632
- };
5001
+ type UpdateFormationResponse = UpdateFormationResponses[keyof UpdateFormationResponses];
5002
+ type ListFormationEventsData = {
5003
+ body?: never;
4633
5004
  path: {
4634
- /**
4635
- * File ID
4636
- */
4637
- file_id: string;
5005
+ formation_id: string;
4638
5006
  };
4639
5007
  query?: never;
4640
- url: '/api/v1/files/{file_id}/tags';
5008
+ url: '/api/v1/formations/{formation_id}/events';
4641
5009
  };
4642
- type ReplaceFileTagsErrors = {
5010
+ type ListFormationEventsErrors = {
4643
5011
  /**
4644
- * Authentication required
5012
+ * Unauthorized
4645
5013
  */
4646
- 401: ErrorResponse;
5014
+ 401: unknown;
4647
5015
  /**
4648
- * Insufficient permissions
5016
+ * Forbidden
4649
5017
  */
4650
- 403: ErrorResponse;
5018
+ 403: unknown;
4651
5019
  /**
4652
- * File not found
5020
+ * Not Found
4653
5021
  */
4654
- 404: ErrorResponse;
5022
+ 404: unknown;
4655
5023
  };
4656
- type ReplaceFileTagsError = ReplaceFileTagsErrors[keyof ReplaceFileTagsErrors];
4657
- type ReplaceFileTagsResponses = {
5024
+ type ListFormationEventsResponses = {
4658
5025
  /**
4659
- * Tags replaced
5026
+ * List of operations
4660
5027
  */
4661
- 200: {
4662
- [key: string]: string;
4663
- };
5028
+ 200: Array<FormationOperation>;
4664
5029
  };
4665
- type ReplaceFileTagsResponse = ReplaceFileTagsResponses[keyof ReplaceFileTagsResponses];
5030
+ type ListFormationEventsResponse = ListFormationEventsResponses[keyof ListFormationEventsResponses];
4666
5031
  type SearchKnowledgeData = {
4667
5032
  body: {
4668
5033
  /**
@@ -5910,34 +6275,244 @@ type GenerateSessionResponseResponses = {
5910
6275
  /**
5911
6276
  * Generation accepted (async mode)
5912
6277
  */
5913
- 202: {
5914
- status?: 'accepted';
5915
- session_id?: string;
5916
- };
6278
+ 202: {
6279
+ status?: 'accepted';
6280
+ session_id?: string;
6281
+ };
6282
+ };
6283
+ type GenerateSessionResponseResponse = GenerateSessionResponseResponses[keyof GenerateSessionResponseResponses];
6284
+ type SubmitSessionToolOutputsData = {
6285
+ body: SubmitSessionToolOutputsRequest;
6286
+ path: {
6287
+ /**
6288
+ * Agent public ID
6289
+ */
6290
+ agent_id: string;
6291
+ /**
6292
+ * Session public ID
6293
+ */
6294
+ session_id: string;
6295
+ };
6296
+ query?: never;
6297
+ url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tool-outputs';
6298
+ };
6299
+ type SubmitSessionToolOutputsErrors = {
6300
+ /**
6301
+ * Authentication required
6302
+ */
6303
+ 401: ErrorResponse;
6304
+ /**
6305
+ * Insufficient permissions
6306
+ */
6307
+ 403: ErrorResponse;
6308
+ /**
6309
+ * Not found
6310
+ */
6311
+ 404: ErrorResponse;
6312
+ };
6313
+ type SubmitSessionToolOutputsError = SubmitSessionToolOutputsErrors[keyof SubmitSessionToolOutputsErrors];
6314
+ type SubmitSessionToolOutputsResponses = {
6315
+ /**
6316
+ * Generation result
6317
+ */
6318
+ 200: SendSessionMessageResponse;
6319
+ };
6320
+ type SubmitSessionToolOutputsResponse = SubmitSessionToolOutputsResponses[keyof SubmitSessionToolOutputsResponses];
6321
+ type GetSessionTagsData = {
6322
+ body?: never;
6323
+ path: {
6324
+ /**
6325
+ * Agent public ID
6326
+ */
6327
+ agent_id: string;
6328
+ /**
6329
+ * Session public ID
6330
+ */
6331
+ session_id: string;
6332
+ };
6333
+ query?: never;
6334
+ url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tags';
6335
+ };
6336
+ type GetSessionTagsErrors = {
6337
+ /**
6338
+ * Authentication required
6339
+ */
6340
+ 401: ErrorResponse;
6341
+ /**
6342
+ * Insufficient permissions
6343
+ */
6344
+ 403: ErrorResponse;
6345
+ /**
6346
+ * Not found
6347
+ */
6348
+ 404: ErrorResponse;
6349
+ };
6350
+ type GetSessionTagsError = GetSessionTagsErrors[keyof GetSessionTagsErrors];
6351
+ type GetSessionTagsResponses = {
6352
+ /**
6353
+ * Session tags
6354
+ */
6355
+ 200: {
6356
+ [key: string]: string;
6357
+ };
6358
+ };
6359
+ type GetSessionTagsResponse = GetSessionTagsResponses[keyof GetSessionTagsResponses];
6360
+ type MergeSessionTagsData = {
6361
+ body: {
6362
+ [key: string]: string;
6363
+ };
6364
+ path: {
6365
+ /**
6366
+ * Agent public ID
6367
+ */
6368
+ agent_id: string;
6369
+ /**
6370
+ * Session public ID
6371
+ */
6372
+ session_id: string;
6373
+ };
6374
+ query?: never;
6375
+ url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tags';
6376
+ };
6377
+ type MergeSessionTagsErrors = {
6378
+ /**
6379
+ * Authentication required
6380
+ */
6381
+ 401: ErrorResponse;
6382
+ /**
6383
+ * Insufficient permissions
6384
+ */
6385
+ 403: ErrorResponse;
6386
+ /**
6387
+ * Not found
6388
+ */
6389
+ 404: ErrorResponse;
6390
+ };
6391
+ type MergeSessionTagsError = MergeSessionTagsErrors[keyof MergeSessionTagsErrors];
6392
+ type MergeSessionTagsResponses = {
6393
+ /**
6394
+ * Updated tags
6395
+ */
6396
+ 200: {
6397
+ [key: string]: string;
6398
+ };
6399
+ };
6400
+ type MergeSessionTagsResponse = MergeSessionTagsResponses[keyof MergeSessionTagsResponses];
6401
+ type ReplaceSessionTagsData = {
6402
+ body: {
6403
+ [key: string]: string;
6404
+ };
6405
+ path: {
6406
+ /**
6407
+ * Agent public ID
6408
+ */
6409
+ agent_id: string;
6410
+ /**
6411
+ * Session public ID
6412
+ */
6413
+ session_id: string;
6414
+ };
6415
+ query?: never;
6416
+ url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tags';
6417
+ };
6418
+ type ReplaceSessionTagsErrors = {
6419
+ /**
6420
+ * Authentication required
6421
+ */
6422
+ 401: ErrorResponse;
6423
+ /**
6424
+ * Insufficient permissions
6425
+ */
6426
+ 403: ErrorResponse;
6427
+ /**
6428
+ * Not found
6429
+ */
6430
+ 404: ErrorResponse;
6431
+ };
6432
+ type ReplaceSessionTagsError = ReplaceSessionTagsErrors[keyof ReplaceSessionTagsErrors];
6433
+ type ReplaceSessionTagsResponses = {
6434
+ /**
6435
+ * Updated tags
6436
+ */
6437
+ 200: {
6438
+ [key: string]: string;
6439
+ };
6440
+ };
6441
+ type ReplaceSessionTagsResponse = ReplaceSessionTagsResponses[keyof ReplaceSessionTagsResponses];
6442
+ type ListToolsData = {
6443
+ body?: never;
6444
+ path?: never;
6445
+ query?: {
6446
+ /**
6447
+ * Project public ID to filter by
6448
+ */
6449
+ project_id?: string;
6450
+ };
6451
+ url: '/api/v1/tools';
6452
+ };
6453
+ type ListToolsErrors = {
6454
+ /**
6455
+ * Unauthorized
6456
+ */
6457
+ 401: ErrorResponse;
6458
+ /**
6459
+ * Forbidden
6460
+ */
6461
+ 403: ErrorResponse;
6462
+ };
6463
+ type ListToolsError = ListToolsErrors[keyof ListToolsErrors];
6464
+ type ListToolsResponses = {
6465
+ /**
6466
+ * List of tools
6467
+ */
6468
+ 200: {
6469
+ data?: Array<Tool>;
6470
+ };
6471
+ };
6472
+ type ListToolsResponse = ListToolsResponses[keyof ListToolsResponses];
6473
+ type CreateToolData = {
6474
+ body: CreateToolRequest;
6475
+ path?: never;
6476
+ query?: never;
6477
+ url: '/api/v1/tools';
6478
+ };
6479
+ type CreateToolErrors = {
6480
+ /**
6481
+ * Bad Request
6482
+ */
6483
+ 400: ErrorResponse;
6484
+ /**
6485
+ * Unauthorized
6486
+ */
6487
+ 401: ErrorResponse;
6488
+ /**
6489
+ * Forbidden
6490
+ */
6491
+ 403: ErrorResponse;
6492
+ };
6493
+ type CreateToolError = CreateToolErrors[keyof CreateToolErrors];
6494
+ type CreateToolResponses = {
6495
+ /**
6496
+ * Tool created
6497
+ */
6498
+ 201: Tool;
5917
6499
  };
5918
- type GenerateSessionResponseResponse = GenerateSessionResponseResponses[keyof GenerateSessionResponseResponses];
5919
- type SubmitSessionToolOutputsData = {
5920
- body: SubmitSessionToolOutputsRequest;
6500
+ type CreateToolResponse = CreateToolResponses[keyof CreateToolResponses];
6501
+ type DeleteToolData = {
6502
+ body?: never;
5921
6503
  path: {
5922
- /**
5923
- * Agent public ID
5924
- */
5925
- agent_id: string;
5926
- /**
5927
- * Session public ID
5928
- */
5929
- session_id: string;
6504
+ tool_id: string;
5930
6505
  };
5931
6506
  query?: never;
5932
- url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tool-outputs';
6507
+ url: '/api/v1/tools/{tool_id}';
5933
6508
  };
5934
- type SubmitSessionToolOutputsErrors = {
6509
+ type DeleteToolErrors = {
5935
6510
  /**
5936
- * Authentication required
6511
+ * Unauthorized
5937
6512
  */
5938
6513
  401: ErrorResponse;
5939
6514
  /**
5940
- * Insufficient permissions
6515
+ * Forbidden
5941
6516
  */
5942
6517
  403: ErrorResponse;
5943
6518
  /**
@@ -5945,36 +6520,29 @@ type SubmitSessionToolOutputsErrors = {
5945
6520
  */
5946
6521
  404: ErrorResponse;
5947
6522
  };
5948
- type SubmitSessionToolOutputsError = SubmitSessionToolOutputsErrors[keyof SubmitSessionToolOutputsErrors];
5949
- type SubmitSessionToolOutputsResponses = {
6523
+ type DeleteToolError = DeleteToolErrors[keyof DeleteToolErrors];
6524
+ type DeleteToolResponses = {
5950
6525
  /**
5951
- * Generation result
6526
+ * Deleted
5952
6527
  */
5953
- 200: SendSessionMessageResponse;
6528
+ 204: void;
5954
6529
  };
5955
- type SubmitSessionToolOutputsResponse = SubmitSessionToolOutputsResponses[keyof SubmitSessionToolOutputsResponses];
5956
- type GetSessionTagsData = {
6530
+ type DeleteToolResponse = DeleteToolResponses[keyof DeleteToolResponses];
6531
+ type GetToolData = {
5957
6532
  body?: never;
5958
6533
  path: {
5959
- /**
5960
- * Agent public ID
5961
- */
5962
- agent_id: string;
5963
- /**
5964
- * Session public ID
5965
- */
5966
- session_id: string;
6534
+ tool_id: string;
5967
6535
  };
5968
6536
  query?: never;
5969
- url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tags';
6537
+ url: '/api/v1/tools/{tool_id}';
5970
6538
  };
5971
- type GetSessionTagsErrors = {
6539
+ type GetToolErrors = {
5972
6540
  /**
5973
- * Authentication required
6541
+ * Unauthorized
5974
6542
  */
5975
6543
  401: ErrorResponse;
5976
6544
  /**
5977
- * Insufficient permissions
6545
+ * Forbidden
5978
6546
  */
5979
6547
  403: ErrorResponse;
5980
6548
  /**
@@ -5982,40 +6550,29 @@ type GetSessionTagsErrors = {
5982
6550
  */
5983
6551
  404: ErrorResponse;
5984
6552
  };
5985
- type GetSessionTagsError = GetSessionTagsErrors[keyof GetSessionTagsErrors];
5986
- type GetSessionTagsResponses = {
6553
+ type GetToolError = GetToolErrors[keyof GetToolErrors];
6554
+ type GetToolResponses = {
5987
6555
  /**
5988
- * Session tags
6556
+ * Tool
5989
6557
  */
5990
- 200: {
5991
- [key: string]: string;
5992
- };
6558
+ 200: Tool;
5993
6559
  };
5994
- type GetSessionTagsResponse = GetSessionTagsResponses[keyof GetSessionTagsResponses];
5995
- type MergeSessionTagsData = {
5996
- body: {
5997
- [key: string]: string;
5998
- };
6560
+ type GetToolResponse = GetToolResponses[keyof GetToolResponses];
6561
+ type UpdateToolData = {
6562
+ body: UpdateToolRequest;
5999
6563
  path: {
6000
- /**
6001
- * Agent public ID
6002
- */
6003
- agent_id: string;
6004
- /**
6005
- * Session public ID
6006
- */
6007
- session_id: string;
6564
+ tool_id: string;
6008
6565
  };
6009
6566
  query?: never;
6010
- url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tags';
6567
+ url: '/api/v1/tools/{tool_id}';
6011
6568
  };
6012
- type MergeSessionTagsErrors = {
6569
+ type UpdateToolErrors = {
6013
6570
  /**
6014
- * Authentication required
6571
+ * Unauthorized
6015
6572
  */
6016
6573
  401: ErrorResponse;
6017
6574
  /**
6018
- * Insufficient permissions
6575
+ * Forbidden
6019
6576
  */
6020
6577
  403: ErrorResponse;
6021
6578
  /**
@@ -6023,57 +6580,54 @@ type MergeSessionTagsErrors = {
6023
6580
  */
6024
6581
  404: ErrorResponse;
6025
6582
  };
6026
- type MergeSessionTagsError = MergeSessionTagsErrors[keyof MergeSessionTagsErrors];
6027
- type MergeSessionTagsResponses = {
6583
+ type UpdateToolError = UpdateToolErrors[keyof UpdateToolErrors];
6584
+ type UpdateToolResponses = {
6028
6585
  /**
6029
- * Updated tags
6586
+ * Tool updated
6030
6587
  */
6031
- 200: {
6032
- [key: string]: string;
6033
- };
6588
+ 200: Tool;
6034
6589
  };
6035
- type MergeSessionTagsResponse = MergeSessionTagsResponses[keyof MergeSessionTagsResponses];
6036
- type ReplaceSessionTagsData = {
6037
- body: {
6038
- [key: string]: string;
6039
- };
6590
+ type UpdateToolResponse = UpdateToolResponses[keyof UpdateToolResponses];
6591
+ type CallToolData = {
6592
+ body?: CallToolRequest;
6040
6593
  path: {
6041
- /**
6042
- * Agent public ID
6043
- */
6044
- agent_id: string;
6045
- /**
6046
- * Session public ID
6047
- */
6048
- session_id: string;
6594
+ tool_id: string;
6049
6595
  };
6050
6596
  query?: never;
6051
- url: '/api/v1/agents/{agent_id}/sessions/{session_id}/tags';
6597
+ url: '/api/v1/tools/{tool_id}/call';
6052
6598
  };
6053
- type ReplaceSessionTagsErrors = {
6599
+ type CallToolErrors = {
6054
6600
  /**
6055
- * Authentication required
6601
+ * Bad Request — invalid input or unknown action
6602
+ */
6603
+ 400: ErrorResponse;
6604
+ /**
6605
+ * Unauthorized
6056
6606
  */
6057
6607
  401: ErrorResponse;
6058
6608
  /**
6059
- * Insufficient permissions
6609
+ * Forbidden
6060
6610
  */
6061
6611
  403: ErrorResponse;
6062
6612
  /**
6063
- * Not found
6613
+ * Tool not found
6064
6614
  */
6065
6615
  404: ErrorResponse;
6616
+ /**
6617
+ * Unprocessable — tool type cannot be invoked server-side
6618
+ */
6619
+ 422: ErrorResponse;
6066
6620
  };
6067
- type ReplaceSessionTagsError = ReplaceSessionTagsErrors[keyof ReplaceSessionTagsErrors];
6068
- type ReplaceSessionTagsResponses = {
6621
+ type CallToolError = CallToolErrors[keyof CallToolErrors];
6622
+ type CallToolResponses = {
6069
6623
  /**
6070
- * Updated tags
6624
+ * The raw output returned by the tool
6071
6625
  */
6072
6626
  200: {
6073
- [key: string]: string;
6627
+ [key: string]: unknown;
6074
6628
  };
6075
6629
  };
6076
- type ReplaceSessionTagsResponse = ReplaceSessionTagsResponses[keyof ReplaceSessionTagsResponses];
6630
+ type CallToolResponse = CallToolResponses[keyof CallToolResponses];
6077
6631
  type ListTracesData = {
6078
6632
  body?: never;
6079
6633
  path?: never;
@@ -6628,6 +7182,36 @@ type GetWebhookDeliveryResponses = {
6628
7182
  200: Delivery;
6629
7183
  };
6630
7184
  type GetWebhookDeliveryResponse = GetWebhookDeliveryResponses[keyof GetWebhookDeliveryResponses];
7185
+ type GetWebhookSecretData = {
7186
+ body?: never;
7187
+ path: {
7188
+ project_id: string;
7189
+ webhook_id: string;
7190
+ };
7191
+ query?: never;
7192
+ url: '/api/v1/projects/{project_id}/webhooks/{webhook_id}/secret';
7193
+ };
7194
+ type GetWebhookSecretErrors = {
7195
+ /**
7196
+ * Unauthorized
7197
+ */
7198
+ 401: unknown;
7199
+ /**
7200
+ * Forbidden
7201
+ */
7202
+ 403: unknown;
7203
+ /**
7204
+ * Webhook not found
7205
+ */
7206
+ 404: unknown;
7207
+ };
7208
+ type GetWebhookSecretResponses = {
7209
+ /**
7210
+ * Webhook secret
7211
+ */
7212
+ 200: WebhookSecretResponse;
7213
+ };
7214
+ type GetWebhookSecretResponse = GetWebhookSecretResponses[keyof GetWebhookSecretResponses];
6631
7215
  type RotateWebhookSecretData = {
6632
7216
  body?: never;
6633
7217
  path: {
@@ -6722,94 +7306,6 @@ declare class Actors {
6722
7306
  */
6723
7307
  static replaceActorTags<ThrowOnError extends boolean = false>(options: Options<ReplaceActorTagsData, ThrowOnError>): RequestResult<ReplaceActorTagsResponses, ReplaceActorTagsErrors, ThrowOnError, "fields">;
6724
7308
  }
6725
- declare class AgentFormations {
6726
- /**
6727
- * Validate a formation template
6728
- *
6729
- * Validates a formation template without creating any resources. Returns a list of errors and warnings. Accepts the template as a JSON object or as a YAML/JSON string.
6730
- *
6731
- */
6732
- static validateAgentFormation<ThrowOnError extends boolean = false>(options: Options<ValidateAgentFormationData, ThrowOnError>): RequestResult<ValidateAgentFormationResponses, ValidateAgentFormationErrors, ThrowOnError, "fields">;
6733
- /**
6734
- * Plan a formation deployment
6735
- *
6736
- * Computes a diff between the desired template and the current stack state without making any changes. Returns the list of planned actions.
6737
- *
6738
- */
6739
- static planAgentFormation<ThrowOnError extends boolean = false>(options: Options<PlanAgentFormationData, ThrowOnError>): RequestResult<PlanAgentFormationResponses, PlanAgentFormationErrors, ThrowOnError, "fields">;
6740
- /**
6741
- * List agent formations
6742
- *
6743
- * Returns all formation stacks for a project
6744
- */
6745
- static listAgentFormations<ThrowOnError extends boolean = false>(options?: Options<ListAgentFormationsData, ThrowOnError>): RequestResult<ListAgentFormationsResponses, ListAgentFormationsErrors, ThrowOnError, "fields">;
6746
- /**
6747
- * Create a new agent formation
6748
- *
6749
- * Validates the template, creates the formation record, then provisions all declared resources in dependency order.
6750
- *
6751
- */
6752
- static createAgentFormation<ThrowOnError extends boolean = false>(options: Options<CreateAgentFormationData, ThrowOnError>): RequestResult<CreateAgentFormationResponses, CreateAgentFormationErrors, ThrowOnError, "fields">;
6753
- /**
6754
- * Delete an agent formation
6755
- *
6756
- * Deletes the formation stack and all its managed resources in reverse dependency order.
6757
- *
6758
- */
6759
- static deleteAgentFormation<ThrowOnError extends boolean = false>(options: Options<DeleteAgentFormationData, ThrowOnError>): RequestResult<DeleteAgentFormationResponses, DeleteAgentFormationErrors, ThrowOnError, "fields">;
6760
- /**
6761
- * Get a specific agent formation
6762
- *
6763
- * Returns the formation stack including its current resources.
6764
- */
6765
- static getAgentFormation<ThrowOnError extends boolean = false>(options: Options<GetAgentFormationData, ThrowOnError>): RequestResult<GetAgentFormationResponses, GetAgentFormationErrors, ThrowOnError, "fields">;
6766
- /**
6767
- * Update an agent formation
6768
- *
6769
- * Applies a new template to the formation. Resources are created, updated, or deleted to reconcile the current state with the desired state.
6770
- *
6771
- */
6772
- static updateAgentFormation<ThrowOnError extends boolean = false>(options: Options<UpdateAgentFormationData, ThrowOnError>): RequestResult<UpdateAgentFormationResponses, UpdateAgentFormationErrors, ThrowOnError, "fields">;
6773
- /**
6774
- * List formation operation events
6775
- *
6776
- * Returns all operations (create, update, delete) with their event logs for the formation, ordered chronologically.
6777
- *
6778
- */
6779
- static listAgentFormationEvents<ThrowOnError extends boolean = false>(options: Options<ListAgentFormationEventsData, ThrowOnError>): RequestResult<ListAgentFormationEventsResponses, ListAgentFormationEventsErrors, ThrowOnError, "fields">;
6780
- }
6781
- declare class AgentTools {
6782
- /**
6783
- * List agent tools
6784
- *
6785
- * Returns all agent tools in the project.
6786
- */
6787
- static listAgentTools<ThrowOnError extends boolean = false>(options?: Options<ListAgentToolsData, ThrowOnError>): RequestResult<ListAgentToolsResponses, ListAgentToolsErrors, ThrowOnError, "fields">;
6788
- /**
6789
- * Create an agent tool
6790
- *
6791
- * Creates a new agent tool in the project.
6792
- */
6793
- static createAgentTool<ThrowOnError extends boolean = false>(options: Options<CreateAgentToolData, ThrowOnError>): RequestResult<CreateAgentToolResponses, CreateAgentToolErrors, ThrowOnError, "fields">;
6794
- /**
6795
- * Delete an agent tool
6796
- *
6797
- * Deletes an agent tool by ID.
6798
- */
6799
- static deleteAgentTool<ThrowOnError extends boolean = false>(options: Options<DeleteAgentToolData, ThrowOnError>): RequestResult<DeleteAgentToolResponses, DeleteAgentToolErrors, ThrowOnError, "fields">;
6800
- /**
6801
- * Get an agent tool
6802
- *
6803
- * Returns a single agent tool by ID.
6804
- */
6805
- static getAgentTool<ThrowOnError extends boolean = false>(options: Options<GetAgentToolData, ThrowOnError>): RequestResult<GetAgentToolResponses, GetAgentToolErrors, ThrowOnError, "fields">;
6806
- /**
6807
- * Update an agent tool
6808
- *
6809
- * Updates an existing agent tool.
6810
- */
6811
- static updateAgentTool<ThrowOnError extends boolean = false>(options: Options<UpdateAgentToolData, ThrowOnError>): RequestResult<UpdateAgentToolResponses, UpdateAgentToolErrors, ThrowOnError, "fields">;
6812
- }
6813
7309
  declare class Agents {
6814
7310
  /**
6815
7311
  * List agents
@@ -7182,6 +7678,62 @@ declare class Files {
7182
7678
  */
7183
7679
  static replaceFileTags<ThrowOnError extends boolean = false>(options: Options<ReplaceFileTagsData, ThrowOnError>): RequestResult<ReplaceFileTagsResponses, ReplaceFileTagsErrors, ThrowOnError, "fields">;
7184
7680
  }
7681
+ declare class Formations {
7682
+ /**
7683
+ * Validate a formation template
7684
+ *
7685
+ * Validates a formation template without creating any resources. Returns a list of errors and warnings. Accepts the template as a JSON object or as a YAML/JSON string.
7686
+ *
7687
+ */
7688
+ static validateFormation<ThrowOnError extends boolean = false>(options: Options<ValidateFormationData, ThrowOnError>): RequestResult<ValidateFormationResponses, ValidateFormationErrors, ThrowOnError, "fields">;
7689
+ /**
7690
+ * Plan a formation deployment
7691
+ *
7692
+ * Computes a diff between the desired template and the current stack state without making any changes. Returns the list of planned actions.
7693
+ *
7694
+ */
7695
+ static planFormation<ThrowOnError extends boolean = false>(options: Options<PlanFormationData, ThrowOnError>): RequestResult<PlanFormationResponses, PlanFormationErrors, ThrowOnError, "fields">;
7696
+ /**
7697
+ * List formations
7698
+ *
7699
+ * Returns all formation stacks for a project
7700
+ */
7701
+ static listFormations<ThrowOnError extends boolean = false>(options?: Options<ListFormationsData, ThrowOnError>): RequestResult<ListFormationsResponses, ListFormationsErrors, ThrowOnError, "fields">;
7702
+ /**
7703
+ * Create a new formation
7704
+ *
7705
+ * Validates the template, creates the formation record, then provisions all declared resources in dependency order.
7706
+ *
7707
+ */
7708
+ static createFormation<ThrowOnError extends boolean = false>(options: Options<CreateFormationData, ThrowOnError>): RequestResult<CreateFormationResponses, CreateFormationErrors, ThrowOnError, "fields">;
7709
+ /**
7710
+ * Delete an formation
7711
+ *
7712
+ * Deletes the formation stack and all its managed resources in reverse dependency order.
7713
+ *
7714
+ */
7715
+ static deleteFormation<ThrowOnError extends boolean = false>(options: Options<DeleteFormationData, ThrowOnError>): RequestResult<DeleteFormationResponses, DeleteFormationErrors, ThrowOnError, "fields">;
7716
+ /**
7717
+ * Get a specific formation
7718
+ *
7719
+ * Returns the formation stack including its current resources.
7720
+ */
7721
+ static getFormation<ThrowOnError extends boolean = false>(options: Options<GetFormationData, ThrowOnError>): RequestResult<GetFormationResponses, GetFormationErrors, ThrowOnError, "fields">;
7722
+ /**
7723
+ * Update an formation
7724
+ *
7725
+ * Applies a new template to the formation. Resources are created, updated, or deleted to reconcile the current state with the desired state.
7726
+ *
7727
+ */
7728
+ static updateFormation<ThrowOnError extends boolean = false>(options: Options<UpdateFormationData, ThrowOnError>): RequestResult<UpdateFormationResponses, UpdateFormationErrors, ThrowOnError, "fields">;
7729
+ /**
7730
+ * List formation operation events
7731
+ *
7732
+ * Returns all operations (create, update, delete) with their event logs for the formation, ordered chronologically.
7733
+ *
7734
+ */
7735
+ static listFormationEvents<ThrowOnError extends boolean = false>(options: Options<ListFormationEventsData, ThrowOnError>): RequestResult<ListFormationEventsResponses, ListFormationEventsErrors, ThrowOnError, "fields">;
7736
+ }
7185
7737
  declare class Knowledge {
7186
7738
  /**
7187
7739
  * Search knowledge
@@ -7417,6 +7969,47 @@ declare class Sessions {
7417
7969
  */
7418
7970
  static replaceSessionTags<ThrowOnError extends boolean = false>(options: Options<ReplaceSessionTagsData, ThrowOnError>): RequestResult<ReplaceSessionTagsResponses, ReplaceSessionTagsErrors, ThrowOnError, "fields">;
7419
7971
  }
7972
+ declare class Tools {
7973
+ /**
7974
+ * List tools
7975
+ *
7976
+ * Returns all tools in the project.
7977
+ */
7978
+ static listTools<ThrowOnError extends boolean = false>(options?: Options<ListToolsData, ThrowOnError>): RequestResult<ListToolsResponses, ListToolsErrors, ThrowOnError, "fields">;
7979
+ /**
7980
+ * Create a tool
7981
+ *
7982
+ * Creates a new tool in the project.
7983
+ */
7984
+ static createTool<ThrowOnError extends boolean = false>(options: Options<CreateToolData, ThrowOnError>): RequestResult<CreateToolResponses, CreateToolErrors, ThrowOnError, "fields">;
7985
+ /**
7986
+ * Delete a tool
7987
+ *
7988
+ * Deletes a tool by ID.
7989
+ */
7990
+ static deleteTool<ThrowOnError extends boolean = false>(options: Options<DeleteToolData, ThrowOnError>): RequestResult<DeleteToolResponses, DeleteToolErrors, ThrowOnError, "fields">;
7991
+ /**
7992
+ * Get a tool
7993
+ *
7994
+ * Returns a single tool by ID.
7995
+ */
7996
+ static getTool<ThrowOnError extends boolean = false>(options: Options<GetToolData, ThrowOnError>): RequestResult<GetToolResponses, GetToolErrors, ThrowOnError, "fields">;
7997
+ /**
7998
+ * Update a tool
7999
+ *
8000
+ * Updates an existing tool.
8001
+ */
8002
+ static updateTool<ThrowOnError extends boolean = false>(options: Options<UpdateToolData, ThrowOnError>): RequestResult<UpdateToolResponses, UpdateToolErrors, ThrowOnError, "fields">;
8003
+ /**
8004
+ * Call a tool
8005
+ *
8006
+ * Directly invokes a tool and returns its output. Supported for `http`, `soat`, and `mcp` tools. `client` tools cannot be invoked server-side and will return 422.
8007
+ * For `soat` and `mcp` tools the `action` field is required and identifies which action (SOAT) or tool name (MCP) to invoke. For `http` tools `action` is ignored.
8008
+ * `preset_parameters` stored on the tool are merged with the caller-supplied `input` before execution; preset keys take lower precedence.
8009
+ *
8010
+ */
8011
+ static callTool<ThrowOnError extends boolean = false>(options: Options<CallToolData, ThrowOnError>): RequestResult<CallToolResponses, CallToolErrors, ThrowOnError, "fields">;
8012
+ }
7420
8013
  declare class Traces {
7421
8014
  /**
7422
8015
  * List traces
@@ -7531,6 +8124,12 @@ declare class Webhooks {
7531
8124
  * Retrieves the details of a specific webhook delivery
7532
8125
  */
7533
8126
  static getWebhookDelivery<ThrowOnError extends boolean = false>(options: Options<GetWebhookDeliveryData, ThrowOnError>): RequestResult<GetWebhookDeliveryResponses, GetWebhookDeliveryErrors, ThrowOnError, "fields">;
8127
+ /**
8128
+ * Get webhook secret
8129
+ *
8130
+ * Retrieves the signing secret for the specified webhook
8131
+ */
8132
+ static getWebhookSecret<ThrowOnError extends boolean = false>(options: Options<GetWebhookSecretData, ThrowOnError>): RequestResult<GetWebhookSecretResponses, GetWebhookSecretErrors, ThrowOnError, "fields">;
7534
8133
  /**
7535
8134
  * Rotate webhook secret
7536
8135
  *
@@ -7581,7 +8180,6 @@ interface SoatClientOptions {
7581
8180
  */
7582
8181
  declare class SoatClient {
7583
8182
  readonly actors: typeof Actors;
7584
- readonly agentTools: typeof AgentTools;
7585
8183
  readonly agents: typeof Agents;
7586
8184
  readonly aiProviders: typeof AiProviders;
7587
8185
  readonly apiKeys: typeof ApiKeys;
@@ -7589,14 +8187,19 @@ declare class SoatClient {
7589
8187
  readonly conversations: typeof Conversations;
7590
8188
  readonly documents: typeof Documents;
7591
8189
  readonly files: typeof Files;
8190
+ readonly formations: typeof Formations;
8191
+ readonly knowledge: typeof Knowledge;
8192
+ readonly memories: typeof Memories;
8193
+ readonly memoryEntries: typeof MemoryEntries;
7592
8194
  readonly policies: typeof Policies;
7593
8195
  readonly projects: typeof Projects;
7594
8196
  readonly secrets: typeof Secrets;
7595
8197
  readonly sessions: typeof Sessions;
8198
+ readonly tools: typeof Tools;
7596
8199
  readonly traces: typeof Traces;
7597
8200
  readonly users: typeof Users;
7598
8201
  readonly webhooks: typeof Webhooks;
7599
8202
  constructor({ baseUrl, token, headers }?: SoatClientOptions);
7600
8203
  }
7601
8204
 
7602
- export { type ActorRecord, Actors, type AddConversationMessageData, type AddConversationMessageError, type AddConversationMessageErrors, type AddConversationMessageResponse, type AddConversationMessageResponses, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageRequest, type AddSessionMessageResponse, type AddSessionMessageResponse2, type AddSessionMessageResponses, type AddSessionMessageSaved, type Agent, type AgentFormation, type AgentFormationResource, AgentFormations, type AgentGenerationResponse, type AgentId, type AgentTool, AgentTools, Agents, AiProviders, type ApiKeyCreated, type ApiKeyRecord, ApiKeys, type AttachUserPoliciesData, type AttachUserPoliciesError, type AttachUserPoliciesErrors, type AttachUserPoliciesResponse, type AttachUserPoliciesResponses, type BootstrapUserData, type BootstrapUserError, type BootstrapUserErrors, type BootstrapUserResponse, type BootstrapUserResponses, type Chat, type ChatCompletionChoice, type ChatCompletionForChatRequest, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseMessage, type ChatMessage, type ChatMessageInput, Chats, type ClientOptions, type ConversationActorRecord, type ConversationMessageRecord, type ConversationRecord, Conversations, type CreateActorData, type CreateActorError, type CreateActorErrors, type CreateActorResponse, type CreateActorResponses, type CreateAgentActorData, type CreateAgentActorError, type CreateAgentActorErrors, type CreateAgentActorResponse, type CreateAgentActorResponses, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentFormationData, type CreateAgentFormationErrors, type CreateAgentFormationResponse, type CreateAgentFormationResponses, type CreateAgentGenerationData, type CreateAgentGenerationError, type CreateAgentGenerationErrors, type CreateAgentGenerationRequest, type CreateAgentGenerationResponse, type CreateAgentGenerationResponses, type CreateAgentRequest, type CreateAgentResponse, type CreateAgentResponses, type CreateAgentSessionData, type CreateAgentSessionError, type CreateAgentSessionErrors, type CreateAgentSessionResponse, type CreateAgentSessionResponses, type CreateAgentToolData, type CreateAgentToolError, type CreateAgentToolErrors, type CreateAgentToolRequest, type CreateAgentToolResponse, type CreateAgentToolResponses, type CreateAiProviderData, type CreateAiProviderErrors, type CreateAiProviderResponse, type CreateAiProviderResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateChatActorData, type CreateChatActorError, type CreateChatActorErrors, type CreateChatActorResponse, type CreateChatActorResponses, type CreateChatCompletionData, type CreateChatCompletionError, type CreateChatCompletionErrors, type CreateChatCompletionForChatData, type CreateChatCompletionForChatError, type CreateChatCompletionForChatErrors, type CreateChatCompletionForChatResponse, type CreateChatCompletionForChatResponses, type CreateChatCompletionResponse, type CreateChatCompletionResponses, type CreateChatData, type CreateChatError, type CreateChatErrors, type CreateChatRequest, type CreateChatResponse, type CreateChatResponses, type CreateConversationData, type CreateConversationError, type CreateConversationErrors, type CreateConversationResponse, type CreateConversationResponses, type CreateDocumentData, type CreateDocumentError, type CreateDocumentErrors, type CreateDocumentResponse, type CreateDocumentResponses, type CreateFileData, type CreateFileError, type CreateFileErrors, type CreateFileResponse, type CreateFileResponses, type CreateMemoryData, type CreateMemoryEntryData, type CreateMemoryEntryErrors, type CreateMemoryEntryResponse, type CreateMemoryEntryResponses, type CreateMemoryErrors, type CreateMemoryResponse, type CreateMemoryResponses, type CreatePolicyData, type CreatePolicyError, type CreatePolicyErrors, type CreatePolicyResponse, type CreatePolicyResponses, type CreateProjectData, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateSecretData, type CreateSecretErrors, type CreateSecretResponse, type CreateSecretResponses, type CreateSessionRequest, type CreateUserData, type CreateUserError, type CreateUserErrors, type CreateUserResponse, type CreateUserResponses, type CreateWebhookData, type CreateWebhookErrors, type CreateWebhookRequest, type CreateWebhookResponse, type CreateWebhookResponses, type DeleteActorData, type DeleteActorError, type DeleteActorErrors, type DeleteActorResponse, type DeleteActorResponses, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentFormationData, type DeleteAgentFormationErrors, type DeleteAgentFormationResponse, type DeleteAgentFormationResponses, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteAgentSessionData, type DeleteAgentSessionError, type DeleteAgentSessionErrors, type DeleteAgentSessionResponse, type DeleteAgentSessionResponses, type DeleteAgentToolData, type DeleteAgentToolError, type DeleteAgentToolErrors, type DeleteAgentToolResponse, type DeleteAgentToolResponses, type DeleteAiProviderData, type DeleteAiProviderErrors, type DeleteAiProviderResponses, type DeleteApiKeyData, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteChatData, type DeleteChatError, type DeleteChatErrors, type DeleteChatResponse, type DeleteChatResponses, type DeleteConversationData, type DeleteConversationError, type DeleteConversationErrors, type DeleteConversationResponse, type DeleteConversationResponses, type DeleteDocumentData, type DeleteDocumentError, type DeleteDocumentErrors, type DeleteDocumentResponse, type DeleteDocumentResponses, type DeleteFileData, type DeleteFileError, type DeleteFileErrors, type DeleteFileResponse, type DeleteFileResponses, type DeleteMemoryData, type DeleteMemoryEntryData, type DeleteMemoryEntryErrors, type DeleteMemoryEntryResponse, type DeleteMemoryEntryResponses, type DeleteMemoryErrors, type DeleteMemoryResponse, type DeleteMemoryResponses, type DeletePolicyData, type DeletePolicyErrors, type DeletePolicyResponse, type DeletePolicyResponses, type DeleteProjectData, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteSecretData, type DeleteSecretErrors, type DeleteSecretResponses, type DeleteUserData, type DeleteUserError, type DeleteUserErrors, type DeleteUserResponse, type DeleteUserResponses, type DeleteWebhookData, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type Delivery, type DeliveryListResponse, type DocumentKnowledgeResult, type DocumentRecord, Documents, type DownloadFileBase64Data, type DownloadFileBase64Error, type DownloadFileBase64Errors, type DownloadFileBase64Response, type DownloadFileBase64Responses, type DownloadFileData, type DownloadFileError, type DownloadFileErrors, type DownloadFileResponse, type DownloadFileResponses, type ErrorResponse, type FileRecord, Files, type FormationEvent, type FormationOperation, type FormationTemplate, type FormationTemplateInput, type GenerateConversationMessageCompleted, type GenerateConversationMessageData, type GenerateConversationMessageError, type GenerateConversationMessageErrors, type GenerateConversationMessageRequiresAction, type GenerateConversationMessageResponse, type GenerateConversationMessageResponse2, type GenerateConversationMessageResponses, type GenerateSessionRequest, type GenerateSessionResponse, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type GetActorData, type GetActorError, type GetActorErrors, type GetActorResponse, type GetActorResponses, type GetActorTagsData, type GetActorTagsError, type GetActorTagsErrors, type GetActorTagsResponse, type GetActorTagsResponses, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentFormationData, type GetAgentFormationErrors, type GetAgentFormationResponse, type GetAgentFormationResponses, type GetAgentResponse, type GetAgentResponses, type GetAgentSessionData, type GetAgentSessionError, type GetAgentSessionErrors, type GetAgentSessionResponse, type GetAgentSessionResponses, type GetAgentToolData, type GetAgentToolError, type GetAgentToolErrors, type GetAgentToolResponse, type GetAgentToolResponses, type GetAiProviderData, type GetAiProviderErrors, type GetAiProviderResponse, type GetAiProviderResponses, type GetApiKeyData, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetChatData, type GetChatError, type GetChatErrors, type GetChatResponse, type GetChatResponses, type GetConversationData, type GetConversationError, type GetConversationErrors, type GetConversationResponse, type GetConversationResponses, type GetConversationTagsData, type GetConversationTagsError, type GetConversationTagsErrors, type GetConversationTagsResponse, type GetConversationTagsResponses, type GetDocumentData, type GetDocumentError, type GetDocumentErrors, type GetDocumentResponse, type GetDocumentResponses, type GetDocumentTagsData, type GetDocumentTagsError, type GetDocumentTagsErrors, type GetDocumentTagsResponse, type GetDocumentTagsResponses, type GetFileData, type GetFileError, type GetFileErrors, type GetFileResponse, type GetFileResponses, type GetFileTagsData, type GetFileTagsError, type GetFileTagsErrors, type GetFileTagsResponse, type GetFileTagsResponses, type GetMemoryData, type GetMemoryEntryData, type GetMemoryEntryErrors, type GetMemoryEntryResponse, type GetMemoryEntryResponses, type GetMemoryErrors, type GetMemoryResponse, type GetMemoryResponses, type GetPolicyData, type GetPolicyErrors, type GetPolicyResponse, type GetPolicyResponses, type GetProjectData, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetSecretData, type GetSecretErrors, type GetSecretResponse, type GetSecretResponses, type GetSessionTagsData, type GetSessionTagsError, type GetSessionTagsErrors, type GetSessionTagsResponse, type GetSessionTagsResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetUserData, type GetUserError, type GetUserErrors, type GetUserPoliciesData, type GetUserPoliciesErrors, type GetUserPoliciesResponse, type GetUserPoliciesResponses, type GetUserResponse, type GetUserResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, Knowledge, type KnowledgeResult, type ListActorsData, type ListActorsError, type ListActorsErrors, type ListActorsResponse, type ListActorsResponses, type ListAgentFormationEventsData, type ListAgentFormationEventsErrors, type ListAgentFormationEventsResponse, type ListAgentFormationEventsResponses, type ListAgentFormationsData, type ListAgentFormationsErrors, type ListAgentFormationsResponse, type ListAgentFormationsResponses, type ListAgentSessionMessagesData, type ListAgentSessionMessagesError, type ListAgentSessionMessagesErrors, type ListAgentSessionMessagesResponse, type ListAgentSessionMessagesResponses, type ListAgentSessionsData, type ListAgentSessionsError, type ListAgentSessionsErrors, type ListAgentSessionsResponse, type ListAgentSessionsResponses, type ListAgentToolsData, type ListAgentToolsError, type ListAgentToolsErrors, type ListAgentToolsResponse, type ListAgentToolsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListAiProvidersData, type ListAiProvidersErrors, type ListAiProvidersResponse, type ListAiProvidersResponses, type ListApiKeysData, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListChatsData, type ListChatsError, type ListChatsErrors, type ListChatsResponse, type ListChatsResponses, type ListConversationActorsData, type ListConversationActorsError, type ListConversationActorsErrors, type ListConversationActorsResponse, type ListConversationActorsResponses, type ListConversationMessagesData, type ListConversationMessagesError, type ListConversationMessagesErrors, type ListConversationMessagesResponse, type ListConversationMessagesResponses, type ListConversationsData, type ListConversationsError, type ListConversationsErrors, type ListConversationsResponse, type ListConversationsResponses, type ListDocumentsData, type ListDocumentsError, type ListDocumentsErrors, type ListDocumentsResponse, type ListDocumentsResponses, type ListFilesData, type ListFilesError, type ListFilesErrors, type ListFilesResponse, type ListFilesResponses, type ListMemoriesData, type ListMemoriesErrors, type ListMemoriesResponse, type ListMemoriesResponses, type ListMemoryEntriesData, type ListMemoryEntriesErrors, type ListMemoryEntriesResponse, type ListMemoryEntriesResponses, type ListPoliciesData, type ListPoliciesErrors, type ListPoliciesResponse, type ListPoliciesResponses, type ListSecretsData, type ListSecretsErrors, type ListSecretsResponse, type ListSecretsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListUsersData, type ListUsersError, type ListUsersErrors, type ListUsersResponse, type ListUsersResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LoginResponse, type LoginUserData, type LoginUserError, type LoginUserErrors, type LoginUserResponse, type LoginUserResponses, Memories, type Memory, MemoryEntries, type MemoryEntry, type MemoryEntryWriteResult, type MemoryKnowledgeResult, type MergeActorTagsData, type MergeActorTagsError, type MergeActorTagsErrors, type MergeActorTagsResponse, type MergeActorTagsResponses, type MergeConversationTagsData, type MergeConversationTagsError, type MergeConversationTagsErrors, type MergeConversationTagsResponse, type MergeConversationTagsResponses, type MergeDocumentTagsData, type MergeDocumentTagsError, type MergeDocumentTagsErrors, type MergeDocumentTagsResponse, type MergeDocumentTagsResponses, type MergeFileTagsData, type MergeFileTagsError, type MergeFileTagsErrors, type MergeFileTagsResponse, type MergeFileTagsResponses, type MergeSessionTagsData, type MergeSessionTagsError, type MergeSessionTagsErrors, type MergeSessionTagsResponse, type MergeSessionTagsResponses, type Options, type ParameterDeclaration, type PlanAgentFormationData, type PlanAgentFormationErrors, type PlanAgentFormationResponse, type PlanAgentFormationResponses, type PlanChange, type PlanResult, Policies, type PolicyDocument, type PolicyRecord, type PolicyStatement, type ProjectRecord, Projects, type RemoveConversationMessageData, type RemoveConversationMessageError, type RemoveConversationMessageErrors, type RemoveConversationMessageResponse, type RemoveConversationMessageResponses, type ReplaceActorTagsData, type ReplaceActorTagsError, type ReplaceActorTagsErrors, type ReplaceActorTagsResponse, type ReplaceActorTagsResponses, type ReplaceConversationTagsData, type ReplaceConversationTagsError, type ReplaceConversationTagsErrors, type ReplaceConversationTagsResponse, type ReplaceConversationTagsResponses, type ReplaceDocumentTagsData, type ReplaceDocumentTagsError, type ReplaceDocumentTagsErrors, type ReplaceDocumentTagsResponse, type ReplaceDocumentTagsResponses, type ReplaceFileTagsData, type ReplaceFileTagsError, type ReplaceFileTagsErrors, type ReplaceFileTagsResponse, type ReplaceFileTagsResponses, type ReplaceSessionTagsData, type ReplaceSessionTagsError, type ReplaceSessionTagsErrors, type ReplaceSessionTagsResponse, type ReplaceSessionTagsResponses, type ResourceDeclaration, type RotateWebhookSecretData, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type SearchKnowledgeData, type SearchKnowledgeError, type SearchKnowledgeErrors, type SearchKnowledgeResponse, type SearchKnowledgeResponses, Secrets, type SendSessionMessageResponse, type SessionId, type SessionMessage, type SessionRecord, Sessions, SoatClient, type SoatClientOptions, type SubmitAgentToolOutputsData, type SubmitAgentToolOutputsError, type SubmitAgentToolOutputsErrors, type SubmitAgentToolOutputsResponse, type SubmitAgentToolOutputsResponses, type SubmitSessionToolOutputsData, type SubmitSessionToolOutputsError, type SubmitSessionToolOutputsErrors, type SubmitSessionToolOutputsRequest, type SubmitSessionToolOutputsResponse, type SubmitSessionToolOutputsResponses, type SubmitToolOutputsRequest, type Trace, type TraceTreeNode, Traces, type UpdateActorData, type UpdateActorError, type UpdateActorErrors, type UpdateActorResponse, type UpdateActorResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentFormationData, type UpdateAgentFormationErrors, type UpdateAgentFormationResponse, type UpdateAgentFormationResponses, type UpdateAgentRequest, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateAgentToolData, type UpdateAgentToolError, type UpdateAgentToolErrors, type UpdateAgentToolRequest, type UpdateAgentToolResponse, type UpdateAgentToolResponses, type UpdateAiProviderData, type UpdateAiProviderErrors, type UpdateAiProviderResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateConversationData, type UpdateConversationError, type UpdateConversationErrors, type UpdateConversationResponse, type UpdateConversationResponses, type UpdateDocumentData, type UpdateDocumentError, type UpdateDocumentErrors, type UpdateDocumentResponse, type UpdateDocumentResponses, type UpdateFileMetadataData, type UpdateFileMetadataError, type UpdateFileMetadataErrors, type UpdateFileMetadataResponse, type UpdateFileMetadataResponses, type UpdateMemoryData, type UpdateMemoryEntryData, type UpdateMemoryEntryErrors, type UpdateMemoryEntryResponse, type UpdateMemoryEntryResponses, type UpdateMemoryErrors, type UpdateMemoryResponse, type UpdateMemoryResponses, type UpdatePolicyData, type UpdatePolicyError, type UpdatePolicyErrors, type UpdatePolicyResponse, type UpdatePolicyResponses, type UpdateSecretData, type UpdateSecretErrors, type UpdateSecretResponses, type UpdateSessionData, type UpdateSessionError, type UpdateSessionErrors, type UpdateSessionRequest, type UpdateSessionResponse, type UpdateSessionResponses, type UpdateWebhookData, type UpdateWebhookErrors, type UpdateWebhookRequest, type UpdateWebhookResponse, type UpdateWebhookResponses, type UploadFileBase64Data, type UploadFileBase64Error, type UploadFileBase64Errors, type UploadFileBase64Request, type UploadFileBase64Response, type UploadFileBase64Responses, type UploadFileData, type UploadFileError, type UploadFileErrors, type UploadFileResponse, type UploadFileResponses, type UserRecord, Users, type ValidateAgentFormationData, type ValidateAgentFormationErrors, type ValidateAgentFormationResponse, type ValidateAgentFormationResponses, type ValidationError, type ValidationResult, type Webhook, type WebhookWithSecret, Webhooks, createClient, createConfig };
8205
+ export { type ActorRecord, type ActorResourceProperties, Actors, type AddConversationMessageData, type AddConversationMessageError, type AddConversationMessageErrors, type AddConversationMessageResponse, type AddConversationMessageResponses, type AddSessionMessageData, type AddSessionMessageError, type AddSessionMessageErrors, type AddSessionMessageRequest, type AddSessionMessageResponse, type AddSessionMessageResponse2, type AddSessionMessageResponses, type AddSessionMessageSaved, type Agent, type AgentGenerationResponse, type AgentId, type AgentResourceProperties, Agents, type AiProviderResourceProperties, AiProviders, type ApiKeyCreated, type ApiKeyRecord, type ApiKeyResourceProperties, ApiKeys, type AttachUserPoliciesData, type AttachUserPoliciesError, type AttachUserPoliciesErrors, type AttachUserPoliciesResponse, type AttachUserPoliciesResponses, type BootstrapUserData, type BootstrapUserError, type BootstrapUserErrors, type BootstrapUserResponse, type BootstrapUserResponses, type CallToolData, type CallToolError, type CallToolErrors, type CallToolRequest, type CallToolResponse, type CallToolResponses, type Chat, type ChatCompletionChoice, type ChatCompletionForChatRequest, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseMessage, type ChatMessage, type ChatMessageInput, type ChatResourceProperties, Chats, type ClientOptions, type ConversationActorRecord, type ConversationMessageRecord, type ConversationRecord, type ConversationResourceProperties, Conversations, type CreateActorData, type CreateActorError, type CreateActorErrors, type CreateActorResponse, type CreateActorResponses, type CreateAgentActorData, type CreateAgentActorError, type CreateAgentActorErrors, type CreateAgentActorResponse, type CreateAgentActorResponses, type CreateAgentData, type CreateAgentError, type CreateAgentErrors, type CreateAgentGenerationData, type CreateAgentGenerationError, type CreateAgentGenerationErrors, type CreateAgentGenerationRequest, type CreateAgentGenerationResponse, type CreateAgentGenerationResponses, type CreateAgentRequest, type CreateAgentResponse, type CreateAgentResponses, type CreateAgentSessionData, type CreateAgentSessionError, type CreateAgentSessionErrors, type CreateAgentSessionResponse, type CreateAgentSessionResponses, type CreateAiProviderData, type CreateAiProviderErrors, type CreateAiProviderResponse, type CreateAiProviderResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateChatActorData, type CreateChatActorError, type CreateChatActorErrors, type CreateChatActorResponse, type CreateChatActorResponses, type CreateChatCompletionData, type CreateChatCompletionError, type CreateChatCompletionErrors, type CreateChatCompletionForChatData, type CreateChatCompletionForChatError, type CreateChatCompletionForChatErrors, type CreateChatCompletionForChatResponse, type CreateChatCompletionForChatResponses, type CreateChatCompletionResponse, type CreateChatCompletionResponses, type CreateChatData, type CreateChatError, type CreateChatErrors, type CreateChatRequest, type CreateChatResponse, type CreateChatResponses, type CreateConversationData, type CreateConversationError, type CreateConversationErrors, type CreateConversationResponse, type CreateConversationResponses, type CreateDocumentData, type CreateDocumentError, type CreateDocumentErrors, type CreateDocumentResponse, type CreateDocumentResponses, type CreateFileData, type CreateFileError, type CreateFileErrors, type CreateFileResponse, type CreateFileResponses, type CreateFormationData, type CreateFormationErrors, type CreateFormationResponse, type CreateFormationResponses, type CreateMemoryData, type CreateMemoryEntryData, type CreateMemoryEntryErrors, type CreateMemoryEntryResponse, type CreateMemoryEntryResponses, type CreateMemoryErrors, type CreateMemoryResponse, type CreateMemoryResponses, type CreatePolicyData, type CreatePolicyError, type CreatePolicyErrors, type CreatePolicyResponse, type CreatePolicyResponses, type CreateProjectData, type CreateProjectErrors, type CreateProjectResponse, type CreateProjectResponses, type CreateSecretData, type CreateSecretErrors, type CreateSecretResponse, type CreateSecretResponses, type CreateSessionRequest, type CreateToolData, type CreateToolError, type CreateToolErrors, type CreateToolRequest, type CreateToolResponse, type CreateToolResponses, type CreateUserData, type CreateUserError, type CreateUserErrors, type CreateUserResponse, type CreateUserResponses, type CreateWebhookData, type CreateWebhookErrors, type CreateWebhookRequest, type CreateWebhookResponse, type CreateWebhookResponses, type DeleteActorData, type DeleteActorError, type DeleteActorErrors, type DeleteActorResponse, type DeleteActorResponses, type DeleteAgentData, type DeleteAgentError, type DeleteAgentErrors, type DeleteAgentResponse, type DeleteAgentResponses, type DeleteAgentSessionData, type DeleteAgentSessionError, type DeleteAgentSessionErrors, type DeleteAgentSessionResponse, type DeleteAgentSessionResponses, type DeleteAiProviderData, type DeleteAiProviderErrors, type DeleteAiProviderResponses, type DeleteApiKeyData, type DeleteApiKeyErrors, type DeleteApiKeyResponse, type DeleteApiKeyResponses, type DeleteChatData, type DeleteChatError, type DeleteChatErrors, type DeleteChatResponse, type DeleteChatResponses, type DeleteConversationData, type DeleteConversationError, type DeleteConversationErrors, type DeleteConversationResponse, type DeleteConversationResponses, type DeleteDocumentData, type DeleteDocumentError, type DeleteDocumentErrors, type DeleteDocumentResponse, type DeleteDocumentResponses, type DeleteFileData, type DeleteFileError, type DeleteFileErrors, type DeleteFileResponse, type DeleteFileResponses, type DeleteFormationData, type DeleteFormationErrors, type DeleteFormationResponse, type DeleteFormationResponses, type DeleteMemoryData, type DeleteMemoryEntryData, type DeleteMemoryEntryErrors, type DeleteMemoryEntryResponse, type DeleteMemoryEntryResponses, type DeleteMemoryErrors, type DeleteMemoryResponse, type DeleteMemoryResponses, type DeletePolicyData, type DeletePolicyErrors, type DeletePolicyResponse, type DeletePolicyResponses, type DeleteProjectData, type DeleteProjectErrors, type DeleteProjectResponse, type DeleteProjectResponses, type DeleteSecretData, type DeleteSecretErrors, type DeleteSecretResponses, type DeleteToolData, type DeleteToolError, type DeleteToolErrors, type DeleteToolResponse, type DeleteToolResponses, type DeleteUserData, type DeleteUserError, type DeleteUserErrors, type DeleteUserResponse, type DeleteUserResponses, type DeleteWebhookData, type DeleteWebhookErrors, type DeleteWebhookResponse, type DeleteWebhookResponses, type Delivery, type DeliveryListResponse, type DocumentKnowledgeResult, type DocumentRecord, type DocumentResourceProperties, Documents, type DownloadFileBase64Data, type DownloadFileBase64Error, type DownloadFileBase64Errors, type DownloadFileBase64Response, type DownloadFileBase64Responses, type DownloadFileData, type DownloadFileError, type DownloadFileErrors, type DownloadFileResponse, type DownloadFileResponses, type ErrorResponse, type FileRecord, type FileResourceProperties, Files, type Formation, type FormationEvent, type FormationOperation, type FormationResource, type FormationTemplate, type FormationTemplateInput, Formations, type GenerateConversationMessageCompleted, type GenerateConversationMessageData, type GenerateConversationMessageError, type GenerateConversationMessageErrors, type GenerateConversationMessageRequiresAction, type GenerateConversationMessageResponse, type GenerateConversationMessageResponse2, type GenerateConversationMessageResponses, type GenerateSessionRequest, type GenerateSessionResponse, type GenerateSessionResponseData, type GenerateSessionResponseError, type GenerateSessionResponseErrors, type GenerateSessionResponseResponse, type GenerateSessionResponseResponses, type GetActorData, type GetActorError, type GetActorErrors, type GetActorResponse, type GetActorResponses, type GetActorTagsData, type GetActorTagsError, type GetActorTagsErrors, type GetActorTagsResponse, type GetActorTagsResponses, type GetAgentData, type GetAgentError, type GetAgentErrors, type GetAgentResponse, type GetAgentResponses, type GetAgentSessionData, type GetAgentSessionError, type GetAgentSessionErrors, type GetAgentSessionResponse, type GetAgentSessionResponses, type GetAiProviderData, type GetAiProviderErrors, type GetAiProviderResponse, type GetAiProviderResponses, type GetApiKeyData, type GetApiKeyErrors, type GetApiKeyResponse, type GetApiKeyResponses, type GetChatData, type GetChatError, type GetChatErrors, type GetChatResponse, type GetChatResponses, type GetConversationData, type GetConversationError, type GetConversationErrors, type GetConversationResponse, type GetConversationResponses, type GetConversationTagsData, type GetConversationTagsError, type GetConversationTagsErrors, type GetConversationTagsResponse, type GetConversationTagsResponses, type GetDocumentData, type GetDocumentError, type GetDocumentErrors, type GetDocumentResponse, type GetDocumentResponses, type GetDocumentTagsData, type GetDocumentTagsError, type GetDocumentTagsErrors, type GetDocumentTagsResponse, type GetDocumentTagsResponses, type GetFileData, type GetFileError, type GetFileErrors, type GetFileResponse, type GetFileResponses, type GetFileTagsData, type GetFileTagsError, type GetFileTagsErrors, type GetFileTagsResponse, type GetFileTagsResponses, type GetFormationData, type GetFormationErrors, type GetFormationResponse, type GetFormationResponses, type GetMemoryData, type GetMemoryEntryData, type GetMemoryEntryErrors, type GetMemoryEntryResponse, type GetMemoryEntryResponses, type GetMemoryErrors, type GetMemoryResponse, type GetMemoryResponses, type GetPolicyData, type GetPolicyErrors, type GetPolicyResponse, type GetPolicyResponses, type GetProjectData, type GetProjectErrors, type GetProjectResponse, type GetProjectResponses, type GetSecretData, type GetSecretErrors, type GetSecretResponse, type GetSecretResponses, type GetSessionTagsData, type GetSessionTagsError, type GetSessionTagsErrors, type GetSessionTagsResponse, type GetSessionTagsResponses, type GetToolData, type GetToolError, type GetToolErrors, type GetToolResponse, type GetToolResponses, type GetTraceData, type GetTraceError, type GetTraceErrors, type GetTraceResponse, type GetTraceResponses, type GetTraceTreeData, type GetTraceTreeError, type GetTraceTreeErrors, type GetTraceTreeResponse, type GetTraceTreeResponses, type GetUserData, type GetUserError, type GetUserErrors, type GetUserPoliciesData, type GetUserPoliciesErrors, type GetUserPoliciesResponse, type GetUserPoliciesResponses, type GetUserResponse, type GetUserResponses, type GetWebhookData, type GetWebhookDeliveryData, type GetWebhookDeliveryErrors, type GetWebhookDeliveryResponse, type GetWebhookDeliveryResponses, type GetWebhookErrors, type GetWebhookResponse, type GetWebhookResponses, type GetWebhookSecretData, type GetWebhookSecretErrors, type GetWebhookSecretResponse, type GetWebhookSecretResponses, Knowledge, type KnowledgeResult, type ListActorsData, type ListActorsError, type ListActorsErrors, type ListActorsResponse, type ListActorsResponses, type ListAgentSessionMessagesData, type ListAgentSessionMessagesError, type ListAgentSessionMessagesErrors, type ListAgentSessionMessagesResponse, type ListAgentSessionMessagesResponses, type ListAgentSessionsData, type ListAgentSessionsError, type ListAgentSessionsErrors, type ListAgentSessionsResponse, type ListAgentSessionsResponses, type ListAgentsData, type ListAgentsError, type ListAgentsErrors, type ListAgentsResponse, type ListAgentsResponses, type ListAiProvidersData, type ListAiProvidersErrors, type ListAiProvidersResponse, type ListAiProvidersResponses, type ListApiKeysData, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListChatsData, type ListChatsError, type ListChatsErrors, type ListChatsResponse, type ListChatsResponses, type ListConversationActorsData, type ListConversationActorsError, type ListConversationActorsErrors, type ListConversationActorsResponse, type ListConversationActorsResponses, type ListConversationMessagesData, type ListConversationMessagesError, type ListConversationMessagesErrors, type ListConversationMessagesResponse, type ListConversationMessagesResponses, type ListConversationsData, type ListConversationsError, type ListConversationsErrors, type ListConversationsResponse, type ListConversationsResponses, type ListDocumentsData, type ListDocumentsError, type ListDocumentsErrors, type ListDocumentsResponse, type ListDocumentsResponses, type ListFilesData, type ListFilesError, type ListFilesErrors, type ListFilesResponse, type ListFilesResponses, type ListFormationEventsData, type ListFormationEventsErrors, type ListFormationEventsResponse, type ListFormationEventsResponses, type ListFormationsData, type ListFormationsErrors, type ListFormationsResponse, type ListFormationsResponses, type ListMemoriesData, type ListMemoriesErrors, type ListMemoriesResponse, type ListMemoriesResponses, type ListMemoryEntriesData, type ListMemoryEntriesErrors, type ListMemoryEntriesResponse, type ListMemoryEntriesResponses, type ListPoliciesData, type ListPoliciesErrors, type ListPoliciesResponse, type ListPoliciesResponses, type ListSecretsData, type ListSecretsErrors, type ListSecretsResponse, type ListSecretsResponses, type ListToolsData, type ListToolsError, type ListToolsErrors, type ListToolsResponse, type ListToolsResponses, type ListTracesData, type ListTracesError, type ListTracesErrors, type ListTracesResponse, type ListTracesResponses, type ListUsersData, type ListUsersError, type ListUsersErrors, type ListUsersResponse, type ListUsersResponses, type ListWebhookDeliveriesData, type ListWebhookDeliveriesErrors, type ListWebhookDeliveriesResponse, type ListWebhookDeliveriesResponses, type ListWebhooksData, type ListWebhooksErrors, type ListWebhooksResponse, type ListWebhooksResponses, type LoginResponse, type LoginUserData, type LoginUserError, type LoginUserErrors, type LoginUserResponse, type LoginUserResponses, Memories, type Memory, MemoryEntries, type MemoryEntry, type MemoryEntryResourceProperties, type MemoryEntryWriteResult, type MemoryKnowledgeResult, type MemoryResourceProperties, type MergeActorTagsData, type MergeActorTagsError, type MergeActorTagsErrors, type MergeActorTagsResponse, type MergeActorTagsResponses, type MergeConversationTagsData, type MergeConversationTagsError, type MergeConversationTagsErrors, type MergeConversationTagsResponse, type MergeConversationTagsResponses, type MergeDocumentTagsData, type MergeDocumentTagsError, type MergeDocumentTagsErrors, type MergeDocumentTagsResponse, type MergeDocumentTagsResponses, type MergeFileTagsData, type MergeFileTagsError, type MergeFileTagsErrors, type MergeFileTagsResponse, type MergeFileTagsResponses, type MergeSessionTagsData, type MergeSessionTagsError, type MergeSessionTagsErrors, type MergeSessionTagsResponse, type MergeSessionTagsResponses, type Options, type ParameterDeclaration, type PlanChange, type PlanFormationData, type PlanFormationErrors, type PlanFormationResponse, type PlanFormationResponses, type PlanResult, Policies, type PolicyDocument, type PolicyRecord, type PolicyResourceProperties, type PolicyStatement, type ProjectRecord, Projects, type RemoveConversationMessageData, type RemoveConversationMessageError, type RemoveConversationMessageErrors, type RemoveConversationMessageResponse, type RemoveConversationMessageResponses, type ReplaceActorTagsData, type ReplaceActorTagsError, type ReplaceActorTagsErrors, type ReplaceActorTagsResponse, type ReplaceActorTagsResponses, type ReplaceConversationTagsData, type ReplaceConversationTagsError, type ReplaceConversationTagsErrors, type ReplaceConversationTagsResponse, type ReplaceConversationTagsResponses, type ReplaceDocumentTagsData, type ReplaceDocumentTagsError, type ReplaceDocumentTagsErrors, type ReplaceDocumentTagsResponse, type ReplaceDocumentTagsResponses, type ReplaceFileTagsData, type ReplaceFileTagsError, type ReplaceFileTagsErrors, type ReplaceFileTagsResponse, type ReplaceFileTagsResponses, type ReplaceSessionTagsData, type ReplaceSessionTagsError, type ReplaceSessionTagsErrors, type ReplaceSessionTagsResponse, type ReplaceSessionTagsResponses, type ResourceDeclaration, type RotateWebhookSecretData, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type SearchKnowledgeData, type SearchKnowledgeError, type SearchKnowledgeErrors, type SearchKnowledgeResponse, type SearchKnowledgeResponses, type SecretResourceProperties, Secrets, type SendSessionMessageResponse, type SessionId, type SessionMessage, type SessionRecord, type SessionResourceProperties, Sessions, SoatClient, type SoatClientOptions, type SubmitAgentToolOutputsData, type SubmitAgentToolOutputsError, type SubmitAgentToolOutputsErrors, type SubmitAgentToolOutputsResponse, type SubmitAgentToolOutputsResponses, type SubmitSessionToolOutputsData, type SubmitSessionToolOutputsError, type SubmitSessionToolOutputsErrors, type SubmitSessionToolOutputsRequest, type SubmitSessionToolOutputsResponse, type SubmitSessionToolOutputsResponses, type SubmitToolOutputsRequest, type Tool, type ToolResourceProperties, Tools, type Trace, type TraceTreeNode, Traces, type UpdateActorData, type UpdateActorError, type UpdateActorErrors, type UpdateActorResponse, type UpdateActorResponses, type UpdateAgentData, type UpdateAgentError, type UpdateAgentErrors, type UpdateAgentRequest, type UpdateAgentResponse, type UpdateAgentResponses, type UpdateAiProviderData, type UpdateAiProviderErrors, type UpdateAiProviderResponses, type UpdateApiKeyData, type UpdateApiKeyError, type UpdateApiKeyErrors, type UpdateApiKeyResponse, type UpdateApiKeyResponses, type UpdateConversationData, type UpdateConversationError, type UpdateConversationErrors, type UpdateConversationResponse, type UpdateConversationResponses, type UpdateDocumentData, type UpdateDocumentError, type UpdateDocumentErrors, type UpdateDocumentResponse, type UpdateDocumentResponses, type UpdateFileMetadataData, type UpdateFileMetadataError, type UpdateFileMetadataErrors, type UpdateFileMetadataResponse, type UpdateFileMetadataResponses, type UpdateFormationData, type UpdateFormationErrors, type UpdateFormationResponse, type UpdateFormationResponses, type UpdateMemoryData, type UpdateMemoryEntryData, type UpdateMemoryEntryErrors, type UpdateMemoryEntryResponse, type UpdateMemoryEntryResponses, type UpdateMemoryErrors, type UpdateMemoryResponse, type UpdateMemoryResponses, type UpdatePolicyData, type UpdatePolicyError, type UpdatePolicyErrors, type UpdatePolicyResponse, type UpdatePolicyResponses, type UpdateSecretData, type UpdateSecretErrors, type UpdateSecretResponses, type UpdateSessionData, type UpdateSessionError, type UpdateSessionErrors, type UpdateSessionRequest, type UpdateSessionResponse, type UpdateSessionResponses, type UpdateToolData, type UpdateToolError, type UpdateToolErrors, type UpdateToolRequest, type UpdateToolResponse, type UpdateToolResponses, type UpdateWebhookData, type UpdateWebhookErrors, type UpdateWebhookRequest, type UpdateWebhookResponse, type UpdateWebhookResponses, type UploadFileBase64Data, type UploadFileBase64Error, type UploadFileBase64Errors, type UploadFileBase64Request, type UploadFileBase64Response, type UploadFileBase64Responses, type UploadFileData, type UploadFileError, type UploadFileErrors, type UploadFileResponse, type UploadFileResponses, type UserRecord, Users, type ValidateFormationData, type ValidateFormationErrors, type ValidateFormationResponse, type ValidateFormationResponses, type ValidationError, type ValidationResult, type Webhook, type WebhookResourceProperties, type WebhookSecretResponse, type WebhookWithSecret, Webhooks, createClient, createConfig };