@collective-intelligence/external-apps-server-sdk 0.1.5 → 0.1.7

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.
@@ -588,81 +588,6 @@ export type FormMetadata<Field extends string> = Readonly<{
588
588
  updateSections?: readonly FormSection<Field>[];
589
589
  visibility?: Partial<Record<Field, FieldVisibilityRule<Field>>>;
590
590
  }>;
591
- /** Closed public principal vocabulary accepted by a gateway operation. */
592
- export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
593
- /** Explicit delegated-subject requirement reviewed with an operation. */
594
- export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
595
- /** Fully materialized authorization policy for one exposed operation. */
596
- export type PortableOperationAuthorization = Readonly<{
597
- delegatedSubject: PortableOperationDelegatedSubjectPolicy;
598
- organization: "required";
599
- principalKinds: readonly PortableOperationPrincipalKind[];
600
- scopes: readonly string[];
601
- }>;
602
- /** Observable side-effect class reviewed before an operation becomes a tool. */
603
- export type PortableOperationEffect = "external_side_effect" | "read" | "write";
604
- /** The replay guarantee supplied by the operation implementation. */
605
- export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
606
- /** Explicit, bounded retry permission for callers of the operation. */
607
- export type PortableOperationRetryPolicy = Readonly<{
608
- mode: "never";
609
- }> | Readonly<{
610
- maxAttempts: number;
611
- mode: "idempotent_only";
612
- }>;
613
- /** Execution lifecycle and maximum wall-clock duration. */
614
- export type PortableOperationExecutionPolicy = Readonly<{
615
- mode: "synchronous";
616
- timeoutMs: number;
617
- }>;
618
- /** Per-invocation transport bounds. */
619
- export type PortableOperationLimits = Readonly<{
620
- maxRequestBytes: number;
621
- maxResponseBytes: number;
622
- }>;
623
- /**
624
- * Complete JSON-only operation contract reviewed by a host. Executable
625
- * handlers remain in a server runtime sidecar and never enter this descriptor.
626
- */
627
- export type PortableOperationDeclaration = Readonly<{
628
- authorization: PortableOperationAuthorization;
629
- description: string;
630
- effects: PortableOperationEffect;
631
- execution: PortableOperationExecutionPolicy;
632
- id: string;
633
- idempotency: PortableOperationIdempotency;
634
- input: PackageSchemaProjection;
635
- limits: PortableOperationLimits;
636
- output: PackageSchemaProjection;
637
- retry: PortableOperationRetryPolicy;
638
- title: string;
639
- version: string;
640
- }>;
641
- /** One catalog and identity namespace for an ordered operation list. */
642
- export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
643
- description?: string;
644
- displayOrder?: number;
645
- icon?: string;
646
- id: string;
647
- operations: readonly Operation[];
648
- tags?: readonly string[];
649
- title: string;
650
- }>;
651
- declare const ConsumerProfileIds: readonly [
652
- "runtime_json",
653
- "ai_function_input",
654
- "interactive_form",
655
- "workflow_value",
656
- "studio_props",
657
- "knowledge_record"
658
- ];
659
- export type ConsumerProfileId = (typeof ConsumerProfileIds)[number];
660
- export type ConsumerProfileDiagnostic = Readonly<{
661
- code: "fidelity_not_supported" | "invalid_default" | "invalid_root" | "recursive_reference" | "remote_reference" | "unknown_vocabulary" | "unsupported_keyword";
662
- location: string;
663
- profile: ConsumerProfileId;
664
- reason: string;
665
- }>;
666
591
  export type DatasetProviderResult<Value> = Readonly<{
667
592
  status: "success";
668
593
  value: Value;
@@ -871,6 +796,81 @@ export type DatasetProviderError = Readonly<{
871
796
  retryAfterMs?: number;
872
797
  diagnostics: readonly SafeDiagnostic[];
873
798
  }>;
799
+ /** Closed public principal vocabulary accepted by a gateway operation. */
800
+ export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
801
+ /** Explicit delegated-subject requirement reviewed with an operation. */
802
+ export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
803
+ /** Fully materialized authorization policy for one exposed operation. */
804
+ export type PortableOperationAuthorization = Readonly<{
805
+ delegatedSubject: PortableOperationDelegatedSubjectPolicy;
806
+ organization: "required";
807
+ principalKinds: readonly PortableOperationPrincipalKind[];
808
+ scopes: readonly string[];
809
+ }>;
810
+ /** Observable side-effect class reviewed before an operation becomes a tool. */
811
+ export type PortableOperationEffect = "external_side_effect" | "read" | "write";
812
+ /** The replay guarantee supplied by the operation implementation. */
813
+ export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
814
+ /** Explicit, bounded retry permission for callers of the operation. */
815
+ export type PortableOperationRetryPolicy = Readonly<{
816
+ mode: "never";
817
+ }> | Readonly<{
818
+ maxAttempts: number;
819
+ mode: "idempotent_only";
820
+ }>;
821
+ /** Execution lifecycle and maximum wall-clock duration. */
822
+ export type PortableOperationExecutionPolicy = Readonly<{
823
+ mode: "synchronous";
824
+ timeoutMs: number;
825
+ }>;
826
+ /** Per-invocation transport bounds. */
827
+ export type PortableOperationLimits = Readonly<{
828
+ maxRequestBytes: number;
829
+ maxResponseBytes: number;
830
+ }>;
831
+ /**
832
+ * Complete JSON-only operation contract reviewed by a host. Executable
833
+ * handlers remain in a server runtime sidecar and never enter this descriptor.
834
+ */
835
+ export type PortableOperationDeclaration = Readonly<{
836
+ authorization: PortableOperationAuthorization;
837
+ description: string;
838
+ effects: PortableOperationEffect;
839
+ execution: PortableOperationExecutionPolicy;
840
+ id: string;
841
+ idempotency: PortableOperationIdempotency;
842
+ input: PackageSchemaProjection;
843
+ limits: PortableOperationLimits;
844
+ output: PackageSchemaProjection;
845
+ retry: PortableOperationRetryPolicy;
846
+ title: string;
847
+ version: string;
848
+ }>;
849
+ /** One catalog and identity namespace for an ordered operation list. */
850
+ export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
851
+ description?: string;
852
+ displayOrder?: number;
853
+ icon?: string;
854
+ id: string;
855
+ operations: readonly Operation[];
856
+ tags?: readonly string[];
857
+ title: string;
858
+ }>;
859
+ declare const ConsumerProfileIds: readonly [
860
+ "runtime_json",
861
+ "ai_function_input",
862
+ "interactive_form",
863
+ "workflow_value",
864
+ "studio_props",
865
+ "knowledge_record"
866
+ ];
867
+ export type ConsumerProfileId = (typeof ConsumerProfileIds)[number];
868
+ export type ConsumerProfileDiagnostic = Readonly<{
869
+ code: "fidelity_not_supported" | "invalid_default" | "invalid_root" | "recursive_reference" | "remote_reference" | "unknown_vocabulary" | "unsupported_keyword";
870
+ location: string;
871
+ profile: ConsumerProfileId;
872
+ reason: string;
873
+ }>;
874
874
  /**
875
875
  * Runtime dispatch validates the declared input schema before invoking a
876
876
  * handler. The bivariant call signature lets domains retain heterogeneous,