@oxy.so/contracts 4.17.0 → 4.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/cjs/accountAccess.js +72 -0
  2. package/dist/cjs/agency.js +112 -1
  3. package/dist/cjs/applicationRoles.js +211 -0
  4. package/dist/cjs/client/check.js +9 -0
  5. package/dist/cjs/client/index.js +22 -1
  6. package/dist/cjs/client/safety.js +183 -2
  7. package/dist/cjs/client/signIn.js +2 -0
  8. package/dist/cjs/index.js +13 -3
  9. package/dist/cjs/safety.js +430 -1
  10. package/dist/cjs/serviceToken.js +14 -0
  11. package/dist/esm/accountAccess.js +69 -0
  12. package/dist/esm/agency.js +111 -0
  13. package/dist/esm/applicationRoles.js +207 -0
  14. package/dist/esm/client/check.js +8 -0
  15. package/dist/esm/client/index.js +1 -1
  16. package/dist/esm/client/safety.js +183 -2
  17. package/dist/esm/client/signIn.js +2 -0
  18. package/dist/esm/index.js +4 -1
  19. package/dist/esm/safety.js +423 -0
  20. package/dist/esm/serviceToken.js +11 -0
  21. package/dist/types/accountAccess.d.ts +128 -0
  22. package/dist/types/accountEmail.d.ts +2 -2
  23. package/dist/types/agency.d.ts +327 -2
  24. package/dist/types/agentKeys.d.ts +6 -6
  25. package/dist/types/applicationRoles.d.ts +438 -0
  26. package/dist/types/client/agentKeys.d.ts +2 -2
  27. package/dist/types/client/check.d.ts +3 -0
  28. package/dist/types/client/deviceSession.d.ts +1 -1
  29. package/dist/types/client/index.d.ts +1 -1
  30. package/dist/types/client/safety.d.ts +204 -4
  31. package/dist/types/client/signIn.d.ts +1 -1
  32. package/dist/types/deviceSession.d.ts +4 -4
  33. package/dist/types/email/messages.d.ts +2 -2
  34. package/dist/types/externalIdentity.d.ts +4 -4
  35. package/dist/types/index.d.ts +5 -2
  36. package/dist/types/inference/accountBilling.d.ts +2 -2
  37. package/dist/types/inference/catalogue.d.ts +22 -22
  38. package/dist/types/inference/providerConnection.d.ts +4 -4
  39. package/dist/types/inference/realtime.d.ts +74 -74
  40. package/dist/types/inference/request.d.ts +60 -60
  41. package/dist/types/inference/usage.d.ts +4 -4
  42. package/dist/types/products/access.d.ts +4 -4
  43. package/dist/types/safety.d.ts +2374 -2
  44. package/dist/types/serviceToken.d.ts +11 -0
  45. package/dist/types/signIn.d.ts +5 -5
  46. package/dist/types/userResponse.d.ts +2 -2
  47. package/package.json +5 -20
  48. package/dist/cjs/.tsbuildinfo +0 -1
  49. package/dist/esm/.tsbuildinfo +0 -1
  50. package/dist/types/.tsbuildinfo +0 -1
@@ -296,10 +296,10 @@ export declare const delegationGrantSchema: z.ZodObject<{
296
296
  createdAt: z.ZodString;
297
297
  updatedAt: z.ZodString;
298
298
  }, "strict", z.ZodTypeAny, {
299
- expiresAt: string | null;
300
299
  createdAt: string;
301
300
  updatedAt: string;
302
301
  id: string;
302
+ expiresAt: string | null;
303
303
  actor: {
304
304
  type: "alia";
305
305
  ownerAccountId: string;
@@ -334,10 +334,10 @@ export declare const delegationGrantSchema: z.ZodObject<{
334
334
  canRedelegate: boolean;
335
335
  revokedAt: string | null;
336
336
  }, {
337
- expiresAt: string | null;
338
337
  createdAt: string;
339
338
  updatedAt: string;
340
339
  id: string;
340
+ expiresAt: string | null;
341
341
  actor: {
342
342
  type: "alia";
343
343
  ownerAccountId: string;
@@ -372,6 +372,167 @@ export declare const delegationGrantSchema: z.ZodObject<{
372
372
  canRedelegate?: boolean | undefined;
373
373
  revokedAt?: string | null | undefined;
374
374
  }>;
375
+ /**
376
+ * The two levels an owner publishes for whoever uses their agent (ADR 0042):
377
+ * "Ver" and "Ver y actuar". A ceiling never says `draft` or `execute_on_request`:
378
+ * an agent is either allowed to act on its own or not at all, and nothing ever
379
+ * asks the person for approval.
380
+ */
381
+ export declare const AGENT_REQUESTER_CEILING_AUTONOMY: readonly ["read_only", "autonomous"];
382
+ /** What an agent may do in one app for whoever uses it; written by an operator of the bot. */
383
+ export declare const agentRequesterCeilingWriteSchema: z.ZodObject<{
384
+ capabilityPackages: z.ZodArray<z.ZodEnum<["read", "create", "publish", "communicate", "administer", "finance", "security", "delegate"]>, "many">;
385
+ capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
386
+ toolOverrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
387
+ tool: z.ZodString;
388
+ decision: z.ZodEnum<["allow", "deny"]>;
389
+ }, "strict", z.ZodTypeAny, {
390
+ decision: "allow" | "deny";
391
+ tool: string;
392
+ }, {
393
+ decision: "allow" | "deny";
394
+ tool: string;
395
+ }>, "many">>;
396
+ limits: z.ZodDefault<z.ZodArray<z.ZodObject<{
397
+ tool: z.ZodString;
398
+ key: z.ZodString;
399
+ value: z.ZodUnion<[z.ZodNumber, z.ZodBoolean]>;
400
+ }, "strict", z.ZodTypeAny, {
401
+ value: number | boolean;
402
+ tool: string;
403
+ key: string;
404
+ }, {
405
+ value: number | boolean;
406
+ tool: string;
407
+ key: string;
408
+ }>, "many">>;
409
+ maximumAutonomy: z.ZodEnum<["read_only", "autonomous"]>;
410
+ }, "strict", z.ZodTypeAny, {
411
+ capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
412
+ capabilities: string[];
413
+ toolOverrides: {
414
+ decision: "allow" | "deny";
415
+ tool: string;
416
+ }[];
417
+ limits: {
418
+ value: number | boolean;
419
+ tool: string;
420
+ key: string;
421
+ }[];
422
+ maximumAutonomy: "read_only" | "autonomous";
423
+ }, {
424
+ capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
425
+ maximumAutonomy: "read_only" | "autonomous";
426
+ capabilities?: string[] | undefined;
427
+ toolOverrides?: {
428
+ decision: "allow" | "deny";
429
+ tool: string;
430
+ }[] | undefined;
431
+ limits?: {
432
+ value: number | boolean;
433
+ tool: string;
434
+ key: string;
435
+ }[] | undefined;
436
+ }>;
437
+ export declare const agentRequesterCeilingSchema: z.ZodObject<{
438
+ capabilityPackages: z.ZodArray<z.ZodEnum<["read", "create", "publish", "communicate", "administer", "finance", "security", "delegate"]>, "many">;
439
+ capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
440
+ toolOverrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
441
+ tool: z.ZodString;
442
+ decision: z.ZodEnum<["allow", "deny"]>;
443
+ }, "strict", z.ZodTypeAny, {
444
+ decision: "allow" | "deny";
445
+ tool: string;
446
+ }, {
447
+ decision: "allow" | "deny";
448
+ tool: string;
449
+ }>, "many">>;
450
+ limits: z.ZodDefault<z.ZodArray<z.ZodObject<{
451
+ tool: z.ZodString;
452
+ key: z.ZodString;
453
+ value: z.ZodUnion<[z.ZodNumber, z.ZodBoolean]>;
454
+ }, "strict", z.ZodTypeAny, {
455
+ value: number | boolean;
456
+ tool: string;
457
+ key: string;
458
+ }, {
459
+ value: number | boolean;
460
+ tool: string;
461
+ key: string;
462
+ }>, "many">>;
463
+ maximumAutonomy: z.ZodEnum<["read_only", "autonomous"]>;
464
+ } & {
465
+ id: z.ZodString;
466
+ agentAccountId: z.ZodString;
467
+ appId: z.ZodString;
468
+ catalog: z.ZodObject<{
469
+ registrationId: z.ZodString;
470
+ version: z.ZodString;
471
+ digest: z.ZodString;
472
+ }, "strict", z.ZodTypeAny, {
473
+ registrationId: string;
474
+ version: string;
475
+ digest: string;
476
+ }, {
477
+ registrationId: string;
478
+ version: string;
479
+ digest: string;
480
+ }>;
481
+ version: z.ZodNumber;
482
+ revokedAt: z.ZodNullable<z.ZodString>;
483
+ createdAt: z.ZodString;
484
+ updatedAt: z.ZodString;
485
+ }, "strict", z.ZodTypeAny, {
486
+ createdAt: string;
487
+ updatedAt: string;
488
+ id: string;
489
+ version: number;
490
+ appId: string;
491
+ catalog: {
492
+ registrationId: string;
493
+ version: string;
494
+ digest: string;
495
+ };
496
+ capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
497
+ capabilities: string[];
498
+ toolOverrides: {
499
+ decision: "allow" | "deny";
500
+ tool: string;
501
+ }[];
502
+ limits: {
503
+ value: number | boolean;
504
+ tool: string;
505
+ key: string;
506
+ }[];
507
+ maximumAutonomy: "read_only" | "autonomous";
508
+ revokedAt: string | null;
509
+ agentAccountId: string;
510
+ }, {
511
+ createdAt: string;
512
+ updatedAt: string;
513
+ id: string;
514
+ version: number;
515
+ appId: string;
516
+ catalog: {
517
+ registrationId: string;
518
+ version: string;
519
+ digest: string;
520
+ };
521
+ capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
522
+ maximumAutonomy: "read_only" | "autonomous";
523
+ revokedAt: string | null;
524
+ agentAccountId: string;
525
+ capabilities?: string[] | undefined;
526
+ toolOverrides?: {
527
+ decision: "allow" | "deny";
528
+ tool: string;
529
+ }[] | undefined;
530
+ limits?: {
531
+ value: number | boolean;
532
+ tool: string;
533
+ key: string;
534
+ }[] | undefined;
535
+ }>;
375
536
  export declare const automationTriggerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
376
537
  type: z.ZodLiteral<"manual">;
377
538
  }, "strict", z.ZodTypeAny, {
@@ -924,6 +1085,8 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
924
1085
  digest: string;
925
1086
  }>>;
926
1087
  grantId: z.ZodOptional<z.ZodString>;
1088
+ /** The owner's published ceiling that bounds an agent acting for a non-owner (ADR 0042). */
1089
+ ceilingId: z.ZodOptional<z.ZodString>;
927
1090
  requesterAccountId: z.ZodString;
928
1091
  ownerAccountId: z.ZodString;
929
1092
  actor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -1040,6 +1203,7 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
1040
1203
  digest: string;
1041
1204
  } | undefined;
1042
1205
  grantId?: string | undefined;
1206
+ ceilingId?: string | undefined;
1043
1207
  }, {
1044
1208
  actor: {
1045
1209
  type: "alia";
@@ -1094,6 +1258,7 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
1094
1258
  key: string;
1095
1259
  }[] | undefined;
1096
1260
  grantId?: string | undefined;
1261
+ ceilingId?: string | undefined;
1097
1262
  }>, {
1098
1263
  actor: {
1099
1264
  type: "alia";
@@ -1148,6 +1313,7 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
1148
1313
  digest: string;
1149
1314
  } | undefined;
1150
1315
  grantId?: string | undefined;
1316
+ ceilingId?: string | undefined;
1151
1317
  }, {
1152
1318
  actor: {
1153
1319
  type: "alia";
@@ -1202,6 +1368,7 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
1202
1368
  key: string;
1203
1369
  }[] | undefined;
1204
1370
  grantId?: string | undefined;
1371
+ ceilingId?: string | undefined;
1205
1372
  }>;
1206
1373
  /** Structural projections only: an authenticated transport must produce these. */
1207
1374
  export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -1287,6 +1454,8 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1287
1454
  digest: string;
1288
1455
  }>>;
1289
1456
  grantId: z.ZodOptional<z.ZodString>;
1457
+ /** The owner's published ceiling that bounds an agent acting for a non-owner (ADR 0042). */
1458
+ ceilingId: z.ZodOptional<z.ZodString>;
1290
1459
  requesterAccountId: z.ZodString;
1291
1460
  ownerAccountId: z.ZodString;
1292
1461
  actor: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -1403,6 +1572,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1403
1572
  digest: string;
1404
1573
  } | undefined;
1405
1574
  grantId?: string | undefined;
1575
+ ceilingId?: string | undefined;
1406
1576
  }, {
1407
1577
  actor: {
1408
1578
  type: "alia";
@@ -1457,6 +1627,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1457
1627
  key: string;
1458
1628
  }[] | undefined;
1459
1629
  grantId?: string | undefined;
1630
+ ceilingId?: string | undefined;
1460
1631
  }>, {
1461
1632
  actor: {
1462
1633
  type: "alia";
@@ -1511,6 +1682,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1511
1682
  digest: string;
1512
1683
  } | undefined;
1513
1684
  grantId?: string | undefined;
1685
+ ceilingId?: string | undefined;
1514
1686
  }, {
1515
1687
  actor: {
1516
1688
  type: "alia";
@@ -1565,6 +1737,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1565
1737
  key: string;
1566
1738
  }[] | undefined;
1567
1739
  grantId?: string | undefined;
1740
+ ceilingId?: string | undefined;
1568
1741
  }>, {
1569
1742
  actor: {
1570
1743
  type: "alia";
@@ -1619,6 +1792,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1619
1792
  digest: string;
1620
1793
  } | undefined;
1621
1794
  grantId?: string | undefined;
1795
+ ceilingId?: string | undefined;
1622
1796
  }, {
1623
1797
  actor: {
1624
1798
  type: "alia";
@@ -1673,6 +1847,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1673
1847
  key: string;
1674
1848
  }[] | undefined;
1675
1849
  grantId?: string | undefined;
1850
+ ceilingId?: string | undefined;
1676
1851
  }>;
1677
1852
  }, "strict", z.ZodTypeAny, {
1678
1853
  kind: "capability";
@@ -1730,6 +1905,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1730
1905
  digest: string;
1731
1906
  } | undefined;
1732
1907
  grantId?: string | undefined;
1908
+ ceilingId?: string | undefined;
1733
1909
  };
1734
1910
  }, {
1735
1911
  kind: "capability";
@@ -1787,6 +1963,7 @@ export declare const invocationPrincipalSchema: z.ZodDiscriminatedUnion<"kind",
1787
1963
  key: string;
1788
1964
  }[] | undefined;
1789
1965
  grantId?: string | undefined;
1966
+ ceilingId?: string | undefined;
1790
1967
  };
1791
1968
  }>]>;
1792
1969
  export type InvocationPrincipal = z.infer<typeof invocationPrincipalSchema>;
@@ -1795,15 +1972,18 @@ export declare const policyDecisionSchema: z.ZodObject<{
1795
1972
  reason: z.ZodString;
1796
1973
  effectiveAutonomy: z.ZodOptional<z.ZodEnum<["read_only", "draft", "execute_on_request", "autonomous"]>>;
1797
1974
  grantId: z.ZodOptional<z.ZodString>;
1975
+ ceilingId: z.ZodOptional<z.ZodString>;
1798
1976
  }, "strict", z.ZodTypeAny, {
1799
1977
  allowed: boolean;
1800
1978
  reason: string;
1801
1979
  grantId?: string | undefined;
1980
+ ceilingId?: string | undefined;
1802
1981
  effectiveAutonomy?: "read_only" | "draft" | "execute_on_request" | "autonomous" | undefined;
1803
1982
  }, {
1804
1983
  allowed: boolean;
1805
1984
  reason: string;
1806
1985
  grantId?: string | undefined;
1986
+ ceilingId?: string | undefined;
1807
1987
  effectiveAutonomy?: "read_only" | "draft" | "execute_on_request" | "autonomous" | undefined;
1808
1988
  }>;
1809
1989
  export declare const auditResultSchema: z.ZodObject<{
@@ -1883,15 +2063,18 @@ export declare const auditEventSchema: z.ZodObject<{
1883
2063
  reason: z.ZodString;
1884
2064
  effectiveAutonomy: z.ZodOptional<z.ZodEnum<["read_only", "draft", "execute_on_request", "autonomous"]>>;
1885
2065
  grantId: z.ZodOptional<z.ZodString>;
2066
+ ceilingId: z.ZodOptional<z.ZodString>;
1886
2067
  }, "strict", z.ZodTypeAny, {
1887
2068
  allowed: boolean;
1888
2069
  reason: string;
1889
2070
  grantId?: string | undefined;
2071
+ ceilingId?: string | undefined;
1890
2072
  effectiveAutonomy?: "read_only" | "draft" | "execute_on_request" | "autonomous" | undefined;
1891
2073
  }, {
1892
2074
  allowed: boolean;
1893
2075
  reason: string;
1894
2076
  grantId?: string | undefined;
2077
+ ceilingId?: string | undefined;
1895
2078
  effectiveAutonomy?: "read_only" | "draft" | "execute_on_request" | "autonomous" | undefined;
1896
2079
  }>;
1897
2080
  result: z.ZodObject<{
@@ -1968,6 +2151,7 @@ export declare const auditEventSchema: z.ZodObject<{
1968
2151
  allowed: boolean;
1969
2152
  reason: string;
1970
2153
  grantId?: string | undefined;
2154
+ ceilingId?: string | undefined;
1971
2155
  effectiveAutonomy?: "read_only" | "draft" | "execute_on_request" | "autonomous" | undefined;
1972
2156
  };
1973
2157
  result: {
@@ -2018,6 +2202,7 @@ export declare const auditEventSchema: z.ZodObject<{
2018
2202
  allowed: boolean;
2019
2203
  reason: string;
2020
2204
  grantId?: string | undefined;
2205
+ ceilingId?: string | undefined;
2021
2206
  effectiveAutonomy?: "read_only" | "draft" | "execute_on_request" | "autonomous" | undefined;
2022
2207
  };
2023
2208
  result: {
@@ -2174,6 +2359,29 @@ export declare const catalogEventSchema: z.ZodObject<{
2174
2359
  resourceTypes: string[];
2175
2360
  dataSchema: Record<string, unknown>;
2176
2361
  }>;
2362
+ /**
2363
+ * A feature an agent may gate on (Alia ADR 0020 §6): the app answers whether the
2364
+ * person may use it (`checkTool`) and, when using it costs something, spends it
2365
+ * (`consumeTool`). Both are internal tools of the same catalogue.
2366
+ */
2367
+ export declare const catalogFeatureSchema: z.ZodObject<{
2368
+ key: z.ZodString;
2369
+ description: z.ZodString;
2370
+ checkTool: z.ZodString;
2371
+ consumeTool: z.ZodOptional<z.ZodString>;
2372
+ }, "strict", z.ZodTypeAny, {
2373
+ description: string;
2374
+ key: string;
2375
+ checkTool: string;
2376
+ consumeTool?: string | undefined;
2377
+ }, {
2378
+ description: string;
2379
+ key: string;
2380
+ checkTool: string;
2381
+ consumeTool?: string | undefined;
2382
+ }>;
2383
+ /** How a coordinator reaches the catalogue's internal tools. */
2384
+ export declare const CATALOG_INTERNAL_TRANSPORTS: readonly ["http", "mcp"];
2177
2385
  export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2178
2386
  schemaVersion: z.ZodLiteral<"1">;
2179
2387
  appId: z.ZodString;
@@ -2191,6 +2399,27 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2191
2399
  }, {
2192
2400
  resource: string;
2193
2401
  }>>;
2402
+ /**
2403
+ * `mcp`: internal tools are served at `<internalBaseUrl>/_oxy/mcp`. Absent or
2404
+ * `http`: each tool's `invocation` path on `internalBaseUrl`.
2405
+ */
2406
+ internalTransport: z.ZodOptional<z.ZodEnum<["http", "mcp"]>>;
2407
+ features: z.ZodOptional<z.ZodArray<z.ZodObject<{
2408
+ key: z.ZodString;
2409
+ description: z.ZodString;
2410
+ checkTool: z.ZodString;
2411
+ consumeTool: z.ZodOptional<z.ZodString>;
2412
+ }, "strict", z.ZodTypeAny, {
2413
+ description: string;
2414
+ key: string;
2415
+ checkTool: string;
2416
+ consumeTool?: string | undefined;
2417
+ }, {
2418
+ description: string;
2419
+ key: string;
2420
+ checkTool: string;
2421
+ consumeTool?: string | undefined;
2422
+ }>, "many">>;
2194
2423
  tools: z.ZodArray<z.ZodEffects<z.ZodObject<{
2195
2424
  name: z.ZodString;
2196
2425
  version: z.ZodString;
@@ -2367,6 +2596,13 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2367
2596
  externalMcp?: {
2368
2597
  resource: string;
2369
2598
  } | undefined;
2599
+ internalTransport?: "mcp" | "http" | undefined;
2600
+ features?: {
2601
+ description: string;
2602
+ key: string;
2603
+ checkTool: string;
2604
+ consumeTool?: string | undefined;
2605
+ }[] | undefined;
2370
2606
  }, {
2371
2607
  schemaVersion: "1";
2372
2608
  version: string;
@@ -2406,6 +2642,13 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2406
2642
  externalMcp?: {
2407
2643
  resource: string;
2408
2644
  } | undefined;
2645
+ internalTransport?: "mcp" | "http" | undefined;
2646
+ features?: {
2647
+ description: string;
2648
+ key: string;
2649
+ checkTool: string;
2650
+ consumeTool?: string | undefined;
2651
+ }[] | undefined;
2409
2652
  }>, {
2410
2653
  schemaVersion: "1";
2411
2654
  version: string;
@@ -2445,6 +2688,13 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2445
2688
  externalMcp?: {
2446
2689
  resource: string;
2447
2690
  } | undefined;
2691
+ internalTransport?: "mcp" | "http" | undefined;
2692
+ features?: {
2693
+ description: string;
2694
+ key: string;
2695
+ checkTool: string;
2696
+ consumeTool?: string | undefined;
2697
+ }[] | undefined;
2448
2698
  }, {
2449
2699
  schemaVersion: "1";
2450
2700
  version: string;
@@ -2484,6 +2734,13 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2484
2734
  externalMcp?: {
2485
2735
  resource: string;
2486
2736
  } | undefined;
2737
+ internalTransport?: "mcp" | "http" | undefined;
2738
+ features?: {
2739
+ description: string;
2740
+ key: string;
2741
+ checkTool: string;
2742
+ consumeTool?: string | undefined;
2743
+ }[] | undefined;
2487
2744
  }>;
2488
2745
  export declare const catalogRegistrationSchema: z.ZodObject<{
2489
2746
  catalog: z.ZodEffects<z.ZodObject<{
@@ -2503,6 +2760,27 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2503
2760
  }, {
2504
2761
  resource: string;
2505
2762
  }>>;
2763
+ /**
2764
+ * `mcp`: internal tools are served at `<internalBaseUrl>/_oxy/mcp`. Absent or
2765
+ * `http`: each tool's `invocation` path on `internalBaseUrl`.
2766
+ */
2767
+ internalTransport: z.ZodOptional<z.ZodEnum<["http", "mcp"]>>;
2768
+ features: z.ZodOptional<z.ZodArray<z.ZodObject<{
2769
+ key: z.ZodString;
2770
+ description: z.ZodString;
2771
+ checkTool: z.ZodString;
2772
+ consumeTool: z.ZodOptional<z.ZodString>;
2773
+ }, "strict", z.ZodTypeAny, {
2774
+ description: string;
2775
+ key: string;
2776
+ checkTool: string;
2777
+ consumeTool?: string | undefined;
2778
+ }, {
2779
+ description: string;
2780
+ key: string;
2781
+ checkTool: string;
2782
+ consumeTool?: string | undefined;
2783
+ }>, "many">>;
2506
2784
  tools: z.ZodArray<z.ZodEffects<z.ZodObject<{
2507
2785
  name: z.ZodString;
2508
2786
  version: z.ZodString;
@@ -2679,6 +2957,13 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2679
2957
  externalMcp?: {
2680
2958
  resource: string;
2681
2959
  } | undefined;
2960
+ internalTransport?: "mcp" | "http" | undefined;
2961
+ features?: {
2962
+ description: string;
2963
+ key: string;
2964
+ checkTool: string;
2965
+ consumeTool?: string | undefined;
2966
+ }[] | undefined;
2682
2967
  }, {
2683
2968
  schemaVersion: "1";
2684
2969
  version: string;
@@ -2718,6 +3003,13 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2718
3003
  externalMcp?: {
2719
3004
  resource: string;
2720
3005
  } | undefined;
3006
+ internalTransport?: "mcp" | "http" | undefined;
3007
+ features?: {
3008
+ description: string;
3009
+ key: string;
3010
+ checkTool: string;
3011
+ consumeTool?: string | undefined;
3012
+ }[] | undefined;
2721
3013
  }>, {
2722
3014
  schemaVersion: "1";
2723
3015
  version: string;
@@ -2757,6 +3049,13 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2757
3049
  externalMcp?: {
2758
3050
  resource: string;
2759
3051
  } | undefined;
3052
+ internalTransport?: "mcp" | "http" | undefined;
3053
+ features?: {
3054
+ description: string;
3055
+ key: string;
3056
+ checkTool: string;
3057
+ consumeTool?: string | undefined;
3058
+ }[] | undefined;
2760
3059
  }, {
2761
3060
  schemaVersion: "1";
2762
3061
  version: string;
@@ -2796,6 +3095,13 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2796
3095
  externalMcp?: {
2797
3096
  resource: string;
2798
3097
  } | undefined;
3098
+ internalTransport?: "mcp" | "http" | undefined;
3099
+ features?: {
3100
+ description: string;
3101
+ key: string;
3102
+ checkTool: string;
3103
+ consumeTool?: string | undefined;
3104
+ }[] | undefined;
2799
3105
  }>;
2800
3106
  digest: z.ZodString;
2801
3107
  signature: z.ZodString;
@@ -2841,6 +3147,13 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2841
3147
  externalMcp?: {
2842
3148
  resource: string;
2843
3149
  } | undefined;
3150
+ internalTransport?: "mcp" | "http" | undefined;
3151
+ features?: {
3152
+ description: string;
3153
+ key: string;
3154
+ checkTool: string;
3155
+ consumeTool?: string | undefined;
3156
+ }[] | undefined;
2844
3157
  };
2845
3158
  signature: string;
2846
3159
  deployedAt: string;
@@ -2885,6 +3198,13 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2885
3198
  externalMcp?: {
2886
3199
  resource: string;
2887
3200
  } | undefined;
3201
+ internalTransport?: "mcp" | "http" | undefined;
3202
+ features?: {
3203
+ description: string;
3204
+ key: string;
3205
+ checkTool: string;
3206
+ consumeTool?: string | undefined;
3207
+ }[] | undefined;
2888
3208
  };
2889
3209
  signature: string;
2890
3210
  deployedAt: string;
@@ -2961,5 +3281,10 @@ export type AuditEvent = z.infer<typeof auditEventSchema>;
2961
3281
  export type CatalogTool = z.infer<typeof catalogToolSchema>;
2962
3282
  export type CatalogEvent = z.infer<typeof catalogEventSchema>;
2963
3283
  export type AppCapabilityCatalog = z.infer<typeof appCapabilityCatalogSchema>;
3284
+ export type CatalogFeature = z.infer<typeof catalogFeatureSchema>;
3285
+ export type CatalogInternalTransport = (typeof CATALOG_INTERNAL_TRANSPORTS)[number];
3286
+ export type AgentRequesterCeilingWrite = z.infer<typeof agentRequesterCeilingWriteSchema>;
3287
+ export type AgentRequesterCeiling = z.infer<typeof agentRequesterCeilingSchema>;
3288
+ export type AgentRequesterCeilingAutonomy = (typeof AGENT_REQUESTER_CEILING_AUTONOMY)[number];
2964
3289
  export type CatalogRegistration = z.infer<typeof catalogRegistrationSchema>;
2965
3290
  export type NormalizedAppEvent = z.infer<typeof normalizedAppEventSchema>;
@@ -14,8 +14,8 @@ export declare const agentProofClaimsSchema: z.ZodObject<{
14
14
  challenge: z.ZodString;
15
15
  expiresAt: z.ZodNumber;
16
16
  }, "strict", z.ZodTypeAny, {
17
- expiresAt: number;
18
17
  accountId: string;
18
+ expiresAt: number;
19
19
  version: 1;
20
20
  audience: "oxy-api/agent";
21
21
  action: "agent_signin" | "agent_enroll" | "agent_rotate" | "agent_recover" | "agent_governance";
@@ -25,8 +25,8 @@ export declare const agentProofClaimsSchema: z.ZodObject<{
25
25
  publicKey: string;
26
26
  payloadDigest: string;
27
27
  }, {
28
- expiresAt: number;
29
28
  accountId: string;
29
+ expiresAt: number;
30
30
  version: 1;
31
31
  audience: "oxy-api/agent";
32
32
  action: "agent_signin" | "agent_enroll" | "agent_rotate" | "agent_recover" | "agent_governance";
@@ -407,8 +407,8 @@ export declare const agentKeyOperationChallengeSchema: z.ZodObject<{
407
407
  challenge: z.ZodString;
408
408
  expiresAt: z.ZodNumber;
409
409
  }, "strict", z.ZodTypeAny, {
410
- expiresAt: number;
411
410
  accountId: string;
411
+ expiresAt: number;
412
412
  version: 1;
413
413
  audience: "oxy-api/agent";
414
414
  action: "agent_signin" | "agent_enroll" | "agent_rotate" | "agent_recover" | "agent_governance";
@@ -418,8 +418,8 @@ export declare const agentKeyOperationChallengeSchema: z.ZodObject<{
418
418
  publicKey: string;
419
419
  payloadDigest: string;
420
420
  }, {
421
- expiresAt: number;
422
421
  accountId: string;
422
+ expiresAt: number;
423
423
  version: 1;
424
424
  audience: "oxy-api/agent";
425
425
  action: "agent_signin" | "agent_enroll" | "agent_rotate" | "agent_recover" | "agent_governance";
@@ -432,8 +432,8 @@ export declare const agentKeyOperationChallengeSchema: z.ZodObject<{
432
432
  governorPublicKey: z.ZodNullable<z.ZodString>;
433
433
  }, "strict", z.ZodTypeAny, {
434
434
  claims: {
435
- expiresAt: number;
436
435
  accountId: string;
436
+ expiresAt: number;
437
437
  version: 1;
438
438
  audience: "oxy-api/agent";
439
439
  action: "agent_signin" | "agent_enroll" | "agent_rotate" | "agent_recover" | "agent_governance";
@@ -446,8 +446,8 @@ export declare const agentKeyOperationChallengeSchema: z.ZodObject<{
446
446
  governorPublicKey: string | null;
447
447
  }, {
448
448
  claims: {
449
- expiresAt: number;
450
449
  accountId: string;
450
+ expiresAt: number;
451
451
  version: 1;
452
452
  audience: "oxy-api/agent";
453
453
  action: "agent_signin" | "agent_enroll" | "agent_rotate" | "agent_recover" | "agent_governance";