@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.
package/dist/express.d.ts CHANGED
@@ -93,66 +93,6 @@ export type PackageSchemaProjection = Readonly<{
93
93
  document: JsonSchemaDocument;
94
94
  fidelity: ProjectionFidelity;
95
95
  }>;
96
- /** Closed public principal vocabulary accepted by a gateway operation. */
97
- export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
98
- /** Explicit delegated-subject requirement reviewed with an operation. */
99
- export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
100
- /** Fully materialized authorization policy for one exposed operation. */
101
- export type PortableOperationAuthorization = Readonly<{
102
- delegatedSubject: PortableOperationDelegatedSubjectPolicy;
103
- organization: "required";
104
- principalKinds: readonly PortableOperationPrincipalKind[];
105
- scopes: readonly string[];
106
- }>;
107
- /** Observable side-effect class reviewed before an operation becomes a tool. */
108
- export type PortableOperationEffect = "external_side_effect" | "read" | "write";
109
- /** The replay guarantee supplied by the operation implementation. */
110
- export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
111
- /** Explicit, bounded retry permission for callers of the operation. */
112
- export type PortableOperationRetryPolicy = Readonly<{
113
- mode: "never";
114
- }> | Readonly<{
115
- maxAttempts: number;
116
- mode: "idempotent_only";
117
- }>;
118
- /** Execution lifecycle and maximum wall-clock duration. */
119
- export type PortableOperationExecutionPolicy = Readonly<{
120
- mode: "synchronous";
121
- timeoutMs: number;
122
- }>;
123
- /** Per-invocation transport bounds. */
124
- export type PortableOperationLimits = Readonly<{
125
- maxRequestBytes: number;
126
- maxResponseBytes: number;
127
- }>;
128
- /**
129
- * Complete JSON-only operation contract reviewed by a host. Executable
130
- * handlers remain in a server runtime sidecar and never enter this descriptor.
131
- */
132
- export type PortableOperationDeclaration = Readonly<{
133
- authorization: PortableOperationAuthorization;
134
- description: string;
135
- effects: PortableOperationEffect;
136
- execution: PortableOperationExecutionPolicy;
137
- id: string;
138
- idempotency: PortableOperationIdempotency;
139
- input: PackageSchemaProjection;
140
- limits: PortableOperationLimits;
141
- output: PackageSchemaProjection;
142
- retry: PortableOperationRetryPolicy;
143
- title: string;
144
- version: string;
145
- }>;
146
- /** One catalog and identity namespace for an ordered operation list. */
147
- export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
148
- description?: string;
149
- displayOrder?: number;
150
- icon?: string;
151
- id: string;
152
- operations: readonly Operation[];
153
- tags?: readonly string[];
154
- title: string;
155
- }>;
156
96
  export type DatasetProviderResult<Value> = Readonly<{
157
97
  status: "success";
158
98
  value: Value;
@@ -361,6 +301,66 @@ export type DatasetProviderError = Readonly<{
361
301
  retryAfterMs?: number;
362
302
  diagnostics: readonly SafeDiagnostic[];
363
303
  }>;
304
+ /** Closed public principal vocabulary accepted by a gateway operation. */
305
+ export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
306
+ /** Explicit delegated-subject requirement reviewed with an operation. */
307
+ export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
308
+ /** Fully materialized authorization policy for one exposed operation. */
309
+ export type PortableOperationAuthorization = Readonly<{
310
+ delegatedSubject: PortableOperationDelegatedSubjectPolicy;
311
+ organization: "required";
312
+ principalKinds: readonly PortableOperationPrincipalKind[];
313
+ scopes: readonly string[];
314
+ }>;
315
+ /** Observable side-effect class reviewed before an operation becomes a tool. */
316
+ export type PortableOperationEffect = "external_side_effect" | "read" | "write";
317
+ /** The replay guarantee supplied by the operation implementation. */
318
+ export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
319
+ /** Explicit, bounded retry permission for callers of the operation. */
320
+ export type PortableOperationRetryPolicy = Readonly<{
321
+ mode: "never";
322
+ }> | Readonly<{
323
+ maxAttempts: number;
324
+ mode: "idempotent_only";
325
+ }>;
326
+ /** Execution lifecycle and maximum wall-clock duration. */
327
+ export type PortableOperationExecutionPolicy = Readonly<{
328
+ mode: "synchronous";
329
+ timeoutMs: number;
330
+ }>;
331
+ /** Per-invocation transport bounds. */
332
+ export type PortableOperationLimits = Readonly<{
333
+ maxRequestBytes: number;
334
+ maxResponseBytes: number;
335
+ }>;
336
+ /**
337
+ * Complete JSON-only operation contract reviewed by a host. Executable
338
+ * handlers remain in a server runtime sidecar and never enter this descriptor.
339
+ */
340
+ export type PortableOperationDeclaration = Readonly<{
341
+ authorization: PortableOperationAuthorization;
342
+ description: string;
343
+ effects: PortableOperationEffect;
344
+ execution: PortableOperationExecutionPolicy;
345
+ id: string;
346
+ idempotency: PortableOperationIdempotency;
347
+ input: PackageSchemaProjection;
348
+ limits: PortableOperationLimits;
349
+ output: PackageSchemaProjection;
350
+ retry: PortableOperationRetryPolicy;
351
+ title: string;
352
+ version: string;
353
+ }>;
354
+ /** One catalog and identity namespace for an ordered operation list. */
355
+ export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
356
+ description?: string;
357
+ displayOrder?: number;
358
+ icon?: string;
359
+ id: string;
360
+ operations: readonly Operation[];
361
+ tags?: readonly string[];
362
+ title: string;
363
+ }>;
364
364
  export type ResourceJsonValue = null | boolean | number | string | readonly ResourceJsonValue[] | Readonly<{
365
365
  [key: string]: ResourceJsonValue;
366
366
  }>;
@@ -60,66 +60,6 @@ export type PackageSchemaProjection = Readonly<{
60
60
  document: JsonSchemaDocument;
61
61
  fidelity: ProjectionFidelity;
62
62
  }>;
63
- /** Closed public principal vocabulary accepted by a gateway operation. */
64
- export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
65
- /** Explicit delegated-subject requirement reviewed with an operation. */
66
- export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
67
- /** Fully materialized authorization policy for one exposed operation. */
68
- export type PortableOperationAuthorization = Readonly<{
69
- delegatedSubject: PortableOperationDelegatedSubjectPolicy;
70
- organization: "required";
71
- principalKinds: readonly PortableOperationPrincipalKind[];
72
- scopes: readonly string[];
73
- }>;
74
- /** Observable side-effect class reviewed before an operation becomes a tool. */
75
- export type PortableOperationEffect = "external_side_effect" | "read" | "write";
76
- /** The replay guarantee supplied by the operation implementation. */
77
- export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
78
- /** Explicit, bounded retry permission for callers of the operation. */
79
- export type PortableOperationRetryPolicy = Readonly<{
80
- mode: "never";
81
- }> | Readonly<{
82
- maxAttempts: number;
83
- mode: "idempotent_only";
84
- }>;
85
- /** Execution lifecycle and maximum wall-clock duration. */
86
- export type PortableOperationExecutionPolicy = Readonly<{
87
- mode: "synchronous";
88
- timeoutMs: number;
89
- }>;
90
- /** Per-invocation transport bounds. */
91
- export type PortableOperationLimits = Readonly<{
92
- maxRequestBytes: number;
93
- maxResponseBytes: number;
94
- }>;
95
- /**
96
- * Complete JSON-only operation contract reviewed by a host. Executable
97
- * handlers remain in a server runtime sidecar and never enter this descriptor.
98
- */
99
- export type PortableOperationDeclaration = Readonly<{
100
- authorization: PortableOperationAuthorization;
101
- description: string;
102
- effects: PortableOperationEffect;
103
- execution: PortableOperationExecutionPolicy;
104
- id: string;
105
- idempotency: PortableOperationIdempotency;
106
- input: PackageSchemaProjection;
107
- limits: PortableOperationLimits;
108
- output: PackageSchemaProjection;
109
- retry: PortableOperationRetryPolicy;
110
- title: string;
111
- version: string;
112
- }>;
113
- /** One catalog and identity namespace for an ordered operation list. */
114
- export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
115
- description?: string;
116
- displayOrder?: number;
117
- icon?: string;
118
- id: string;
119
- operations: readonly Operation[];
120
- tags?: readonly string[];
121
- title: string;
122
- }>;
123
63
  export type DatasetProviderResult<Value> = Readonly<{
124
64
  status: "success";
125
65
  value: Value;
@@ -328,6 +268,66 @@ export type DatasetProviderError = Readonly<{
328
268
  retryAfterMs?: number;
329
269
  diagnostics: readonly SafeDiagnostic[];
330
270
  }>;
271
+ /** Closed public principal vocabulary accepted by a gateway operation. */
272
+ export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
273
+ /** Explicit delegated-subject requirement reviewed with an operation. */
274
+ export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
275
+ /** Fully materialized authorization policy for one exposed operation. */
276
+ export type PortableOperationAuthorization = Readonly<{
277
+ delegatedSubject: PortableOperationDelegatedSubjectPolicy;
278
+ organization: "required";
279
+ principalKinds: readonly PortableOperationPrincipalKind[];
280
+ scopes: readonly string[];
281
+ }>;
282
+ /** Observable side-effect class reviewed before an operation becomes a tool. */
283
+ export type PortableOperationEffect = "external_side_effect" | "read" | "write";
284
+ /** The replay guarantee supplied by the operation implementation. */
285
+ export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
286
+ /** Explicit, bounded retry permission for callers of the operation. */
287
+ export type PortableOperationRetryPolicy = Readonly<{
288
+ mode: "never";
289
+ }> | Readonly<{
290
+ maxAttempts: number;
291
+ mode: "idempotent_only";
292
+ }>;
293
+ /** Execution lifecycle and maximum wall-clock duration. */
294
+ export type PortableOperationExecutionPolicy = Readonly<{
295
+ mode: "synchronous";
296
+ timeoutMs: number;
297
+ }>;
298
+ /** Per-invocation transport bounds. */
299
+ export type PortableOperationLimits = Readonly<{
300
+ maxRequestBytes: number;
301
+ maxResponseBytes: number;
302
+ }>;
303
+ /**
304
+ * Complete JSON-only operation contract reviewed by a host. Executable
305
+ * handlers remain in a server runtime sidecar and never enter this descriptor.
306
+ */
307
+ export type PortableOperationDeclaration = Readonly<{
308
+ authorization: PortableOperationAuthorization;
309
+ description: string;
310
+ effects: PortableOperationEffect;
311
+ execution: PortableOperationExecutionPolicy;
312
+ id: string;
313
+ idempotency: PortableOperationIdempotency;
314
+ input: PackageSchemaProjection;
315
+ limits: PortableOperationLimits;
316
+ output: PackageSchemaProjection;
317
+ retry: PortableOperationRetryPolicy;
318
+ title: string;
319
+ version: string;
320
+ }>;
321
+ /** One catalog and identity namespace for an ordered operation list. */
322
+ export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
323
+ description?: string;
324
+ displayOrder?: number;
325
+ icon?: string;
326
+ id: string;
327
+ operations: readonly Operation[];
328
+ tags?: readonly string[];
329
+ title: string;
330
+ }>;
331
331
  export type ResourceJsonValue = null | boolean | number | string | readonly ResourceJsonValue[] | Readonly<{
332
332
  [key: string]: ResourceJsonValue;
333
333
  }>;
package/dist/gateway.d.ts CHANGED
@@ -101,66 +101,6 @@ export type PackageSchemaProjection = Readonly<{
101
101
  document: JsonSchemaDocument;
102
102
  fidelity: ProjectionFidelity;
103
103
  }>;
104
- /** Closed public principal vocabulary accepted by a gateway operation. */
105
- export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
106
- /** Explicit delegated-subject requirement reviewed with an operation. */
107
- export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
108
- /** Fully materialized authorization policy for one exposed operation. */
109
- export type PortableOperationAuthorization = Readonly<{
110
- delegatedSubject: PortableOperationDelegatedSubjectPolicy;
111
- organization: "required";
112
- principalKinds: readonly PortableOperationPrincipalKind[];
113
- scopes: readonly string[];
114
- }>;
115
- /** Observable side-effect class reviewed before an operation becomes a tool. */
116
- export type PortableOperationEffect = "external_side_effect" | "read" | "write";
117
- /** The replay guarantee supplied by the operation implementation. */
118
- export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
119
- /** Explicit, bounded retry permission for callers of the operation. */
120
- export type PortableOperationRetryPolicy = Readonly<{
121
- mode: "never";
122
- }> | Readonly<{
123
- maxAttempts: number;
124
- mode: "idempotent_only";
125
- }>;
126
- /** Execution lifecycle and maximum wall-clock duration. */
127
- export type PortableOperationExecutionPolicy = Readonly<{
128
- mode: "synchronous";
129
- timeoutMs: number;
130
- }>;
131
- /** Per-invocation transport bounds. */
132
- export type PortableOperationLimits = Readonly<{
133
- maxRequestBytes: number;
134
- maxResponseBytes: number;
135
- }>;
136
- /**
137
- * Complete JSON-only operation contract reviewed by a host. Executable
138
- * handlers remain in a server runtime sidecar and never enter this descriptor.
139
- */
140
- export type PortableOperationDeclaration = Readonly<{
141
- authorization: PortableOperationAuthorization;
142
- description: string;
143
- effects: PortableOperationEffect;
144
- execution: PortableOperationExecutionPolicy;
145
- id: string;
146
- idempotency: PortableOperationIdempotency;
147
- input: PackageSchemaProjection;
148
- limits: PortableOperationLimits;
149
- output: PackageSchemaProjection;
150
- retry: PortableOperationRetryPolicy;
151
- title: string;
152
- version: string;
153
- }>;
154
- /** One catalog and identity namespace for an ordered operation list. */
155
- export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
156
- description?: string;
157
- displayOrder?: number;
158
- icon?: string;
159
- id: string;
160
- operations: readonly Operation[];
161
- tags?: readonly string[];
162
- title: string;
163
- }>;
164
104
  export type DatasetProviderResult<Value> = Readonly<{
165
105
  status: "success";
166
106
  value: Value;
@@ -369,6 +309,66 @@ export type DatasetProviderError = Readonly<{
369
309
  retryAfterMs?: number;
370
310
  diagnostics: readonly SafeDiagnostic[];
371
311
  }>;
312
+ /** Closed public principal vocabulary accepted by a gateway operation. */
313
+ export type PortableOperationPrincipalKind = "detached_user" | "service_principal";
314
+ /** Explicit delegated-subject requirement reviewed with an operation. */
315
+ export type PortableOperationDelegatedSubjectPolicy = "allowed" | "forbidden" | "required";
316
+ /** Fully materialized authorization policy for one exposed operation. */
317
+ export type PortableOperationAuthorization = Readonly<{
318
+ delegatedSubject: PortableOperationDelegatedSubjectPolicy;
319
+ organization: "required";
320
+ principalKinds: readonly PortableOperationPrincipalKind[];
321
+ scopes: readonly string[];
322
+ }>;
323
+ /** Observable side-effect class reviewed before an operation becomes a tool. */
324
+ export type PortableOperationEffect = "external_side_effect" | "read" | "write";
325
+ /** The replay guarantee supplied by the operation implementation. */
326
+ export type PortableOperationIdempotency = "idempotent" | "requires_key" | "safe";
327
+ /** Explicit, bounded retry permission for callers of the operation. */
328
+ export type PortableOperationRetryPolicy = Readonly<{
329
+ mode: "never";
330
+ }> | Readonly<{
331
+ maxAttempts: number;
332
+ mode: "idempotent_only";
333
+ }>;
334
+ /** Execution lifecycle and maximum wall-clock duration. */
335
+ export type PortableOperationExecutionPolicy = Readonly<{
336
+ mode: "synchronous";
337
+ timeoutMs: number;
338
+ }>;
339
+ /** Per-invocation transport bounds. */
340
+ export type PortableOperationLimits = Readonly<{
341
+ maxRequestBytes: number;
342
+ maxResponseBytes: number;
343
+ }>;
344
+ /**
345
+ * Complete JSON-only operation contract reviewed by a host. Executable
346
+ * handlers remain in a server runtime sidecar and never enter this descriptor.
347
+ */
348
+ export type PortableOperationDeclaration = Readonly<{
349
+ authorization: PortableOperationAuthorization;
350
+ description: string;
351
+ effects: PortableOperationEffect;
352
+ execution: PortableOperationExecutionPolicy;
353
+ id: string;
354
+ idempotency: PortableOperationIdempotency;
355
+ input: PackageSchemaProjection;
356
+ limits: PortableOperationLimits;
357
+ output: PackageSchemaProjection;
358
+ retry: PortableOperationRetryPolicy;
359
+ title: string;
360
+ version: string;
361
+ }>;
362
+ /** One catalog and identity namespace for an ordered operation list. */
363
+ export type OperationDomainDeclaration<Operation extends PortableOperationDeclaration = PortableOperationDeclaration> = Readonly<{
364
+ description?: string;
365
+ displayOrder?: number;
366
+ icon?: string;
367
+ id: string;
368
+ operations: readonly Operation[];
369
+ tags?: readonly string[];
370
+ title: string;
371
+ }>;
372
372
  export type ResourceJsonValue = null | boolean | number | string | readonly ResourceJsonValue[] | Readonly<{
373
373
  [key: string]: ResourceJsonValue;
374
374
  }>;