@oxy.so/contracts 5.1.0 → 5.3.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 (48) hide show
  1. package/dist/cjs/accountGraph.js +8 -5
  2. package/dist/cjs/accountName.js +20 -0
  3. package/dist/cjs/accountSubject.js +4 -2
  4. package/dist/cjs/agency.js +42 -1
  5. package/dist/cjs/client/accountGraph.js +2 -0
  6. package/dist/cjs/client/accountName.js +56 -0
  7. package/dist/cjs/client/index.js +12 -4
  8. package/dist/cjs/client/organizations.js +5 -4
  9. package/dist/cjs/index.js +31 -15
  10. package/dist/cjs/organizations.js +3 -7
  11. package/dist/cjs/profileColors.generated.js +265 -0
  12. package/dist/cjs/userResponse.js +4 -19
  13. package/dist/esm/accountGraph.js +9 -6
  14. package/dist/esm/accountName.js +12 -0
  15. package/dist/esm/accountSubject.js +4 -2
  16. package/dist/esm/agency.js +39 -0
  17. package/dist/esm/client/accountGraph.js +2 -0
  18. package/dist/esm/client/accountName.js +51 -0
  19. package/dist/esm/client/index.js +1 -0
  20. package/dist/esm/client/organizations.js +5 -4
  21. package/dist/esm/index.js +4 -2
  22. package/dist/esm/organizations.js +4 -8
  23. package/dist/esm/profileColors.generated.js +262 -0
  24. package/dist/esm/userResponse.js +0 -15
  25. package/dist/types/accountAccess.d.ts +5 -5
  26. package/dist/types/accountGraph.d.ts +12 -12
  27. package/dist/types/accountName.d.ts +5 -0
  28. package/dist/types/accountSubject.d.ts +3 -2
  29. package/dist/types/agency.d.ts +86 -28
  30. package/dist/types/client/accountGraph.d.ts +12 -6
  31. package/dist/types/client/accountName.d.ts +48 -0
  32. package/dist/types/client/deviceDirectory.d.ts +3 -3
  33. package/dist/types/client/index.d.ts +1 -0
  34. package/dist/types/client/organizations.d.ts +8 -7
  35. package/dist/types/client/safety.d.ts +2 -2
  36. package/dist/types/deviceDirectory.d.ts +33 -33
  37. package/dist/types/externalIdentity.d.ts +14 -14
  38. package/dist/types/index.d.ts +6 -3
  39. package/dist/types/inference/economics.d.ts +2 -2
  40. package/dist/types/inference/providerConnection.d.ts +4 -4
  41. package/dist/types/notifications.d.ts +4 -4
  42. package/dist/types/oauth.d.ts +3 -0
  43. package/dist/types/organizations.d.ts +41 -40
  44. package/dist/types/profileColors.generated.d.ts +195 -0
  45. package/dist/types/safety.d.ts +22 -22
  46. package/dist/types/stickers.d.ts +9 -9
  47. package/dist/types/userResponse.d.ts +42 -44
  48. package/package.json +7 -4
@@ -319,7 +319,7 @@ export declare const delegationGrantSchema: z.ZodObject<{
319
319
  version: string;
320
320
  digest: string;
321
321
  } | null;
322
- capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
322
+ capabilityPackages: ("finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
323
323
  capabilities: string[];
324
324
  toolOverrides: {
325
325
  decision: "allow" | "deny";
@@ -357,7 +357,7 @@ export declare const delegationGrantSchema: z.ZodObject<{
357
357
  version: string;
358
358
  digest: string;
359
359
  } | null;
360
- capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
360
+ capabilityPackages: ("finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
361
361
  capabilities: string[];
362
362
  maximumAutonomy: "read_only" | "draft" | "execute_on_request" | "autonomous";
363
363
  toolOverrides?: {
@@ -408,7 +408,7 @@ export declare const agentRequesterCeilingWriteSchema: z.ZodObject<{
408
408
  }>, "many">>;
409
409
  maximumAutonomy: z.ZodEnum<["read_only", "autonomous"]>;
410
410
  }, "strict", z.ZodTypeAny, {
411
- capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
411
+ capabilityPackages: ("finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
412
412
  capabilities: string[];
413
413
  toolOverrides: {
414
414
  decision: "allow" | "deny";
@@ -421,7 +421,7 @@ export declare const agentRequesterCeilingWriteSchema: z.ZodObject<{
421
421
  }[];
422
422
  maximumAutonomy: "read_only" | "autonomous";
423
423
  }, {
424
- capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
424
+ capabilityPackages: ("finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
425
425
  maximumAutonomy: "read_only" | "autonomous";
426
426
  capabilities?: string[] | undefined;
427
427
  toolOverrides?: {
@@ -493,7 +493,7 @@ export declare const agentRequesterCeilingSchema: z.ZodObject<{
493
493
  version: string;
494
494
  digest: string;
495
495
  };
496
- capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
496
+ capabilityPackages: ("finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
497
497
  capabilities: string[];
498
498
  toolOverrides: {
499
499
  decision: "allow" | "deny";
@@ -518,7 +518,7 @@ export declare const agentRequesterCeilingSchema: z.ZodObject<{
518
518
  version: string;
519
519
  digest: string;
520
520
  };
521
- capabilityPackages: ("create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
521
+ capabilityPackages: ("finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate")[];
522
522
  maximumAutonomy: "read_only" | "autonomous";
523
523
  revokedAt: string | null;
524
524
  agentAccountId: string;
@@ -2282,6 +2282,19 @@ export declare const auditEventSchema: z.ZodObject<{
2282
2282
  capabilityTicketId?: string | undefined;
2283
2283
  };
2284
2284
  }>;
2285
+ /**
2286
+ * The executing actor types a catalogue tool may name in `actors` — exactly the
2287
+ * discriminator of {@link executionActorRefSchema}.
2288
+ */
2289
+ export declare const CATALOG_TOOL_ACTOR_TYPES: readonly ["alia", "agent", "requester"];
2290
+ export declare const catalogToolActorTypeSchema: z.ZodEnum<["alia", "agent", "requester"]>;
2291
+ /**
2292
+ * Who may execute a tool that declares no `actors`: the standing actors
2293
+ * (native Alia and agents, {@link actorRefSchema}). A present requester
2294
+ * (ADR 0025) is opt-in — a tool reaches that lane only by naming `requester`,
2295
+ * which is what every catalogue meant before the field existed.
2296
+ */
2297
+ export declare const CATALOG_TOOL_DEFAULT_ACTORS: readonly ["alia", "agent"];
2285
2298
  export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2286
2299
  name: z.ZodString;
2287
2300
  version: z.ZodString;
@@ -2295,6 +2308,12 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2295
2308
  idempotency: z.ZodEnum<["none", "supported", "required"]>;
2296
2309
  rollback: z.ZodEnum<["none", "manual", "supported"]>;
2297
2310
  exposure: z.ZodArray<z.ZodEnum<["internal", "mcp"]>, "many">;
2311
+ /**
2312
+ * Executing actor types Oxy will issue a capability ticket for. Absent
2313
+ * means {@link CATALOG_TOOL_DEFAULT_ACTORS}. A coordinator must not offer
2314
+ * the tool to any other actor: Oxy refuses the authorization.
2315
+ */
2316
+ actors: z.ZodOptional<z.ZodArray<z.ZodEnum<["alia", "agent", "requester"]>, "many">>;
2298
2317
  limitKeys: z.ZodDefault<z.ZodArray<z.ZodObject<{
2299
2318
  key: z.ZodString;
2300
2319
  kind: z.ZodEnum<["maximum_number", "exact_boolean"]>;
@@ -2322,7 +2341,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2322
2341
  version: string;
2323
2342
  rollback: "none" | "manual" | "supported";
2324
2343
  inputSchema: Record<string, unknown>;
2325
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2344
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2326
2345
  requiredCapabilities: string[];
2327
2346
  resourceTypes: string[];
2328
2347
  idempotency: "none" | "supported" | "required";
@@ -2336,6 +2355,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2336
2355
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2337
2356
  };
2338
2357
  outputSchema?: Record<string, unknown> | undefined;
2358
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2339
2359
  }, {
2340
2360
  effect: "security" | "read" | "write" | "external" | "financial";
2341
2361
  name: string;
@@ -2343,7 +2363,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2343
2363
  version: string;
2344
2364
  rollback: "none" | "manual" | "supported";
2345
2365
  inputSchema: Record<string, unknown>;
2346
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2366
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2347
2367
  requiredCapabilities: string[];
2348
2368
  resourceTypes: string[];
2349
2369
  idempotency: "none" | "supported" | "required";
@@ -2353,6 +2373,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2353
2373
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2354
2374
  };
2355
2375
  outputSchema?: Record<string, unknown> | undefined;
2376
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2356
2377
  limitKeys?: {
2357
2378
  kind: "maximum_number" | "exact_boolean";
2358
2379
  key: string;
@@ -2364,7 +2385,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2364
2385
  version: string;
2365
2386
  rollback: "none" | "manual" | "supported";
2366
2387
  inputSchema: Record<string, unknown>;
2367
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2388
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2368
2389
  requiredCapabilities: string[];
2369
2390
  resourceTypes: string[];
2370
2391
  idempotency: "none" | "supported" | "required";
@@ -2378,6 +2399,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2378
2399
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2379
2400
  };
2380
2401
  outputSchema?: Record<string, unknown> | undefined;
2402
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2381
2403
  }, {
2382
2404
  effect: "security" | "read" | "write" | "external" | "financial";
2383
2405
  name: string;
@@ -2385,7 +2407,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2385
2407
  version: string;
2386
2408
  rollback: "none" | "manual" | "supported";
2387
2409
  inputSchema: Record<string, unknown>;
2388
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2410
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2389
2411
  requiredCapabilities: string[];
2390
2412
  resourceTypes: string[];
2391
2413
  idempotency: "none" | "supported" | "required";
@@ -2395,6 +2417,7 @@ export declare const catalogToolSchema: z.ZodEffects<z.ZodObject<{
2395
2417
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2396
2418
  };
2397
2419
  outputSchema?: Record<string, unknown> | undefined;
2420
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2398
2421
  limitKeys?: {
2399
2422
  kind: "maximum_number" | "exact_boolean";
2400
2423
  key: string;
@@ -2493,6 +2516,12 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2493
2516
  idempotency: z.ZodEnum<["none", "supported", "required"]>;
2494
2517
  rollback: z.ZodEnum<["none", "manual", "supported"]>;
2495
2518
  exposure: z.ZodArray<z.ZodEnum<["internal", "mcp"]>, "many">;
2519
+ /**
2520
+ * Executing actor types Oxy will issue a capability ticket for. Absent
2521
+ * means {@link CATALOG_TOOL_DEFAULT_ACTORS}. A coordinator must not offer
2522
+ * the tool to any other actor: Oxy refuses the authorization.
2523
+ */
2524
+ actors: z.ZodOptional<z.ZodArray<z.ZodEnum<["alia", "agent", "requester"]>, "many">>;
2496
2525
  limitKeys: z.ZodDefault<z.ZodArray<z.ZodObject<{
2497
2526
  key: z.ZodString;
2498
2527
  kind: z.ZodEnum<["maximum_number", "exact_boolean"]>;
@@ -2520,7 +2549,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2520
2549
  version: string;
2521
2550
  rollback: "none" | "manual" | "supported";
2522
2551
  inputSchema: Record<string, unknown>;
2523
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2552
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2524
2553
  requiredCapabilities: string[];
2525
2554
  resourceTypes: string[];
2526
2555
  idempotency: "none" | "supported" | "required";
@@ -2534,6 +2563,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2534
2563
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2535
2564
  };
2536
2565
  outputSchema?: Record<string, unknown> | undefined;
2566
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2537
2567
  }, {
2538
2568
  effect: "security" | "read" | "write" | "external" | "financial";
2539
2569
  name: string;
@@ -2541,7 +2571,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2541
2571
  version: string;
2542
2572
  rollback: "none" | "manual" | "supported";
2543
2573
  inputSchema: Record<string, unknown>;
2544
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2574
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2545
2575
  requiredCapabilities: string[];
2546
2576
  resourceTypes: string[];
2547
2577
  idempotency: "none" | "supported" | "required";
@@ -2551,6 +2581,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2551
2581
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2552
2582
  };
2553
2583
  outputSchema?: Record<string, unknown> | undefined;
2584
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2554
2585
  limitKeys?: {
2555
2586
  kind: "maximum_number" | "exact_boolean";
2556
2587
  key: string;
@@ -2562,7 +2593,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2562
2593
  version: string;
2563
2594
  rollback: "none" | "manual" | "supported";
2564
2595
  inputSchema: Record<string, unknown>;
2565
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2596
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2566
2597
  requiredCapabilities: string[];
2567
2598
  resourceTypes: string[];
2568
2599
  idempotency: "none" | "supported" | "required";
@@ -2576,6 +2607,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2576
2607
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2577
2608
  };
2578
2609
  outputSchema?: Record<string, unknown> | undefined;
2610
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2579
2611
  }, {
2580
2612
  effect: "security" | "read" | "write" | "external" | "financial";
2581
2613
  name: string;
@@ -2583,7 +2615,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2583
2615
  version: string;
2584
2616
  rollback: "none" | "manual" | "supported";
2585
2617
  inputSchema: Record<string, unknown>;
2586
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2618
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2587
2619
  requiredCapabilities: string[];
2588
2620
  resourceTypes: string[];
2589
2621
  idempotency: "none" | "supported" | "required";
@@ -2593,6 +2625,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2593
2625
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2594
2626
  };
2595
2627
  outputSchema?: Record<string, unknown> | undefined;
2628
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2596
2629
  limitKeys?: {
2597
2630
  kind: "maximum_number" | "exact_boolean";
2598
2631
  key: string;
@@ -2631,7 +2664,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2631
2664
  version: string;
2632
2665
  rollback: "none" | "manual" | "supported";
2633
2666
  inputSchema: Record<string, unknown>;
2634
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2667
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2635
2668
  requiredCapabilities: string[];
2636
2669
  resourceTypes: string[];
2637
2670
  idempotency: "none" | "supported" | "required";
@@ -2645,6 +2678,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2645
2678
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2646
2679
  };
2647
2680
  outputSchema?: Record<string, unknown> | undefined;
2681
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2648
2682
  }[];
2649
2683
  events: {
2650
2684
  type: string;
@@ -2677,7 +2711,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2677
2711
  version: string;
2678
2712
  rollback: "none" | "manual" | "supported";
2679
2713
  inputSchema: Record<string, unknown>;
2680
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2714
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2681
2715
  requiredCapabilities: string[];
2682
2716
  resourceTypes: string[];
2683
2717
  idempotency: "none" | "supported" | "required";
@@ -2687,6 +2721,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2687
2721
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2688
2722
  };
2689
2723
  outputSchema?: Record<string, unknown> | undefined;
2724
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2690
2725
  limitKeys?: {
2691
2726
  kind: "maximum_number" | "exact_boolean";
2692
2727
  key: string;
@@ -2723,7 +2758,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2723
2758
  version: string;
2724
2759
  rollback: "none" | "manual" | "supported";
2725
2760
  inputSchema: Record<string, unknown>;
2726
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2761
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2727
2762
  requiredCapabilities: string[];
2728
2763
  resourceTypes: string[];
2729
2764
  idempotency: "none" | "supported" | "required";
@@ -2737,6 +2772,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2737
2772
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2738
2773
  };
2739
2774
  outputSchema?: Record<string, unknown> | undefined;
2775
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2740
2776
  }[];
2741
2777
  events: {
2742
2778
  type: string;
@@ -2769,7 +2805,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2769
2805
  version: string;
2770
2806
  rollback: "none" | "manual" | "supported";
2771
2807
  inputSchema: Record<string, unknown>;
2772
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2808
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2773
2809
  requiredCapabilities: string[];
2774
2810
  resourceTypes: string[];
2775
2811
  idempotency: "none" | "supported" | "required";
@@ -2779,6 +2815,7 @@ export declare const appCapabilityCatalogSchema: z.ZodEffects<z.ZodObject<{
2779
2815
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2780
2816
  };
2781
2817
  outputSchema?: Record<string, unknown> | undefined;
2818
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2782
2819
  limitKeys?: {
2783
2820
  kind: "maximum_number" | "exact_boolean";
2784
2821
  key: string;
@@ -2854,6 +2891,12 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2854
2891
  idempotency: z.ZodEnum<["none", "supported", "required"]>;
2855
2892
  rollback: z.ZodEnum<["none", "manual", "supported"]>;
2856
2893
  exposure: z.ZodArray<z.ZodEnum<["internal", "mcp"]>, "many">;
2894
+ /**
2895
+ * Executing actor types Oxy will issue a capability ticket for. Absent
2896
+ * means {@link CATALOG_TOOL_DEFAULT_ACTORS}. A coordinator must not offer
2897
+ * the tool to any other actor: Oxy refuses the authorization.
2898
+ */
2899
+ actors: z.ZodOptional<z.ZodArray<z.ZodEnum<["alia", "agent", "requester"]>, "many">>;
2857
2900
  limitKeys: z.ZodDefault<z.ZodArray<z.ZodObject<{
2858
2901
  key: z.ZodString;
2859
2902
  kind: z.ZodEnum<["maximum_number", "exact_boolean"]>;
@@ -2881,7 +2924,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2881
2924
  version: string;
2882
2925
  rollback: "none" | "manual" | "supported";
2883
2926
  inputSchema: Record<string, unknown>;
2884
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2927
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2885
2928
  requiredCapabilities: string[];
2886
2929
  resourceTypes: string[];
2887
2930
  idempotency: "none" | "supported" | "required";
@@ -2895,6 +2938,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2895
2938
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2896
2939
  };
2897
2940
  outputSchema?: Record<string, unknown> | undefined;
2941
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2898
2942
  }, {
2899
2943
  effect: "security" | "read" | "write" | "external" | "financial";
2900
2944
  name: string;
@@ -2902,7 +2946,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2902
2946
  version: string;
2903
2947
  rollback: "none" | "manual" | "supported";
2904
2948
  inputSchema: Record<string, unknown>;
2905
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2949
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2906
2950
  requiredCapabilities: string[];
2907
2951
  resourceTypes: string[];
2908
2952
  idempotency: "none" | "supported" | "required";
@@ -2912,6 +2956,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2912
2956
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2913
2957
  };
2914
2958
  outputSchema?: Record<string, unknown> | undefined;
2959
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2915
2960
  limitKeys?: {
2916
2961
  kind: "maximum_number" | "exact_boolean";
2917
2962
  key: string;
@@ -2923,7 +2968,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2923
2968
  version: string;
2924
2969
  rollback: "none" | "manual" | "supported";
2925
2970
  inputSchema: Record<string, unknown>;
2926
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2971
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2927
2972
  requiredCapabilities: string[];
2928
2973
  resourceTypes: string[];
2929
2974
  idempotency: "none" | "supported" | "required";
@@ -2937,6 +2982,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2937
2982
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2938
2983
  };
2939
2984
  outputSchema?: Record<string, unknown> | undefined;
2985
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2940
2986
  }, {
2941
2987
  effect: "security" | "read" | "write" | "external" | "financial";
2942
2988
  name: string;
@@ -2944,7 +2990,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2944
2990
  version: string;
2945
2991
  rollback: "none" | "manual" | "supported";
2946
2992
  inputSchema: Record<string, unknown>;
2947
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
2993
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2948
2994
  requiredCapabilities: string[];
2949
2995
  resourceTypes: string[];
2950
2996
  idempotency: "none" | "supported" | "required";
@@ -2954,6 +3000,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2954
3000
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
2955
3001
  };
2956
3002
  outputSchema?: Record<string, unknown> | undefined;
3003
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
2957
3004
  limitKeys?: {
2958
3005
  kind: "maximum_number" | "exact_boolean";
2959
3006
  key: string;
@@ -2992,7 +3039,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
2992
3039
  version: string;
2993
3040
  rollback: "none" | "manual" | "supported";
2994
3041
  inputSchema: Record<string, unknown>;
2995
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
3042
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
2996
3043
  requiredCapabilities: string[];
2997
3044
  resourceTypes: string[];
2998
3045
  idempotency: "none" | "supported" | "required";
@@ -3006,6 +3053,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3006
3053
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
3007
3054
  };
3008
3055
  outputSchema?: Record<string, unknown> | undefined;
3056
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
3009
3057
  }[];
3010
3058
  events: {
3011
3059
  type: string;
@@ -3038,7 +3086,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3038
3086
  version: string;
3039
3087
  rollback: "none" | "manual" | "supported";
3040
3088
  inputSchema: Record<string, unknown>;
3041
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
3089
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
3042
3090
  requiredCapabilities: string[];
3043
3091
  resourceTypes: string[];
3044
3092
  idempotency: "none" | "supported" | "required";
@@ -3048,6 +3096,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3048
3096
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
3049
3097
  };
3050
3098
  outputSchema?: Record<string, unknown> | undefined;
3099
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
3051
3100
  limitKeys?: {
3052
3101
  kind: "maximum_number" | "exact_boolean";
3053
3102
  key: string;
@@ -3084,7 +3133,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3084
3133
  version: string;
3085
3134
  rollback: "none" | "manual" | "supported";
3086
3135
  inputSchema: Record<string, unknown>;
3087
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
3136
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
3088
3137
  requiredCapabilities: string[];
3089
3138
  resourceTypes: string[];
3090
3139
  idempotency: "none" | "supported" | "required";
@@ -3098,6 +3147,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3098
3147
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
3099
3148
  };
3100
3149
  outputSchema?: Record<string, unknown> | undefined;
3150
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
3101
3151
  }[];
3102
3152
  events: {
3103
3153
  type: string;
@@ -3130,7 +3180,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3130
3180
  version: string;
3131
3181
  rollback: "none" | "manual" | "supported";
3132
3182
  inputSchema: Record<string, unknown>;
3133
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
3183
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
3134
3184
  requiredCapabilities: string[];
3135
3185
  resourceTypes: string[];
3136
3186
  idempotency: "none" | "supported" | "required";
@@ -3140,6 +3190,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3140
3190
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
3141
3191
  };
3142
3192
  outputSchema?: Record<string, unknown> | undefined;
3193
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
3143
3194
  limitKeys?: {
3144
3195
  kind: "maximum_number" | "exact_boolean";
3145
3196
  key: string;
@@ -3182,7 +3233,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3182
3233
  version: string;
3183
3234
  rollback: "none" | "manual" | "supported";
3184
3235
  inputSchema: Record<string, unknown>;
3185
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
3236
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
3186
3237
  requiredCapabilities: string[];
3187
3238
  resourceTypes: string[];
3188
3239
  idempotency: "none" | "supported" | "required";
@@ -3196,6 +3247,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3196
3247
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
3197
3248
  };
3198
3249
  outputSchema?: Record<string, unknown> | undefined;
3250
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
3199
3251
  }[];
3200
3252
  events: {
3201
3253
  type: string;
@@ -3233,7 +3285,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3233
3285
  version: string;
3234
3286
  rollback: "none" | "manual" | "supported";
3235
3287
  inputSchema: Record<string, unknown>;
3236
- capabilityPackage: "create" | "finance" | "security" | "read" | "publish" | "communicate" | "administer" | "delegate";
3288
+ capabilityPackage: "finance" | "security" | "create" | "read" | "publish" | "communicate" | "administer" | "delegate";
3237
3289
  requiredCapabilities: string[];
3238
3290
  resourceTypes: string[];
3239
3291
  idempotency: "none" | "supported" | "required";
@@ -3243,6 +3295,7 @@ export declare const catalogRegistrationSchema: z.ZodObject<{
3243
3295
  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
3244
3296
  };
3245
3297
  outputSchema?: Record<string, unknown> | undefined;
3298
+ actors?: ("alia" | "agent" | "requester")[] | undefined;
3246
3299
  limitKeys?: {
3247
3300
  kind: "maximum_number" | "exact_boolean";
3248
3301
  key: string;
@@ -3340,6 +3393,11 @@ export type PolicyDecision = z.infer<typeof policyDecisionSchema>;
3340
3393
  export type AuditEvent = z.infer<typeof auditEventSchema>;
3341
3394
  export type CatalogTool = z.infer<typeof catalogToolSchema>;
3342
3395
  export type CatalogEvent = z.infer<typeof catalogEventSchema>;
3396
+ export type CatalogToolActorType = z.infer<typeof catalogToolActorTypeSchema>;
3397
+ /** The actor types that may execute `tool`: the one reading of an absent `actors`. */
3398
+ export declare function catalogToolActors(tool: Pick<CatalogTool, 'actors'>): readonly CatalogToolActorType[];
3399
+ /** Whether Oxy will authorize `actorType` to execute `tool`. */
3400
+ export declare function catalogToolAllowsActor(tool: Pick<CatalogTool, 'actors'>, actorType: CatalogToolActorType): boolean;
3343
3401
  export type AppCapabilityCatalog = z.infer<typeof appCapabilityCatalogSchema>;
3344
3402
  export type CatalogFeature = z.infer<typeof catalogFeatureSchema>;
3345
3403
  export type CatalogInternalTransport = (typeof CATALOG_INTERNAL_TRANSPORTS)[number];
@@ -19,7 +19,7 @@
19
19
  * #1520): it owns resources, holds roles, plans and a balance, receives funds
20
20
  * and pays for itself under the same rules as a person, and is its own actor.
21
21
  */
22
- export type AccountKind = 'personal' | 'organization' | 'project' | 'bot' | 'channel';
22
+ export type AccountKind = 'personal' | 'organization' | 'project' | 'bot' | 'channel' | 'community';
23
23
  /**
24
24
  * The union is spelled out above and the array proves coverage BOTH ways
25
25
  * (`satisfies` here, the `Gap` alias below) — the same shape this package's
@@ -32,14 +32,20 @@ export type AccountKind = 'personal' | 'organization' | 'project' | 'bot' | 'cha
32
32
  * and an indexed-access type is materially more expensive to check there than a
33
33
  * literal union.
34
34
  */
35
- export declare const ACCOUNT_KINDS: readonly ["personal", "organization", "project", "bot", "channel"];
35
+ export declare const ACCOUNT_KINDS: readonly ["personal", "organization", "project", "bot", "channel", "community"];
36
36
  /** `never` while `ACCOUNT_KINDS` covers the union. */
37
37
  export type AccountKindGap = Exclude<AccountKind, (typeof ACCOUNT_KINDS)[number]>;
38
38
  /**
39
- * Kinds that may be CREATED as children of another account. Exactly
40
- * `ACCOUNT_KINDS` minus `personal`, which is always a tree root.
39
+ * Kinds that may be CREATED as children of another account: `ACCOUNT_KINDS`
40
+ * minus `personal`, which is always a tree root, and minus `community`.
41
+ *
42
+ * A `community` is a forum its members post INTO and that re-broadcasts what
43
+ * they post (an ActivityPub `Group`: a Lemmy or Mbin community). Oxy records
44
+ * remote communities; it does not host one, because nothing here forwards a
45
+ * member's post to the community's followers yet. Creating one would make an
46
+ * account that promises that and cannot keep it.
41
47
  */
42
- export type ChildAccountKind = Exclude<AccountKind, 'personal'>;
48
+ export type ChildAccountKind = Exclude<AccountKind, 'personal' | 'community'>;
43
49
  export declare const CHILD_ACCOUNT_KINDS: readonly ["organization", "project", "bot", "channel"];
44
50
  /** `never` while `CHILD_ACCOUNT_KINDS` covers the child union. */
45
51
  export type ChildAccountKindGap = Exclude<ChildAccountKind, (typeof CHILD_ACCOUNT_KINDS)[number]>;
@@ -191,7 +197,7 @@ export declare const MAX_ACCOUNT_CATEGORIES = 4;
191
197
  * !== 'personal'` test silently admits every kind invented after it was
192
198
  * written, whereas this list forces whoever adds one to decide.
193
199
  */
194
- export declare const ACCOUNT_CATEGORY_KINDS: readonly ["organization", "project", "bot", "channel"];
200
+ export declare const ACCOUNT_CATEGORY_KINDS: readonly ["organization", "project", "bot", "channel", "community"];
195
201
  export type AccountCategoryKind = (typeof ACCOUNT_CATEGORY_KINDS)[number];
196
202
  /**
197
203
  * Whether an account of this kind may carry categories.
@@ -0,0 +1,48 @@
1
+ /**
2
+ * The account-name policy, without Zod. Schema: `../accountName.ts`.
3
+ *
4
+ * Part of `@oxy.so/contracts/client`: never import `zod` here (see `./check.ts`).
5
+ *
6
+ * An account's name follows ONE of two policies, chosen by its `kind` and by
7
+ * nothing else — not by which route wrote it, nor by whether it is native or
8
+ * federated:
9
+ *
10
+ * - `person`: a human name. Letters of the allowlisted scripts, combining
11
+ * marks, spaces, the apostrophe and letter-flanked name separators; no
12
+ * digits. The character classes are generated data and live in
13
+ * `@oxy.so/core` (`isValidDisplayName`), which applies this table through
14
+ * `isValidAccountName`.
15
+ * - `title`: what an organization, project, bot, channel or community is called. Plain
16
+ * text — digits and punctuation are part of real titles ("Studio 54",
17
+ * "Blink-182") — without markup or control characters. Defined here, once.
18
+ */
19
+ import type { AccountKind } from './accountGraph';
20
+ import { type Check } from './check';
21
+ export type AccountNamePolicy = 'person' | 'title';
22
+ /**
23
+ * The policy for each kind. A `Record` over the whole union, so adding a kind
24
+ * fails this file's typecheck until someone decides how it is named.
25
+ */
26
+ export declare const ACCOUNT_NAME_POLICY_BY_KIND: {
27
+ readonly personal: "person";
28
+ readonly organization: "title";
29
+ readonly project: "title";
30
+ readonly bot: "title";
31
+ readonly channel: "title";
32
+ readonly community: "title";
33
+ };
34
+ /** A missing kind is `personal`, the `users.kind` column default. */
35
+ export declare function accountNamePolicyForKind(kind: AccountKind | null | undefined): AccountNamePolicy;
36
+ /** Longest title, in UTF-16 code units after trimming. */
37
+ export declare const ACCOUNT_TITLE_MAX_LENGTH = 300;
38
+ /**
39
+ * Source of the characters a title may not contain: `<`, `>`, the C0 controls
40
+ * and DEL. A class of literal code points — no property escapes — so it
41
+ * compiles on Hermes. The probe below rejects with it; the API compiles it with
42
+ * `g` to strip untrusted titles, so the gate and the strip cannot disagree.
43
+ */
44
+ export declare const ACCOUNT_TITLE_DISALLOWED_SOURCE = "[<>\\u0000-\\u001F\\u007F]";
45
+ /** Whether `value` holds no character the title policy disallows. */
46
+ export declare function isPlainTextTitle(value: string): boolean;
47
+ /** The twin of `accountTitleSchema`. */
48
+ export declare const accountTitleCheck: Check<string>;
@@ -21,7 +21,7 @@ export declare const deviceDirectoryCheck: import("./check").Check<{
21
21
  userId: string;
22
22
  contexts: {
23
23
  active: boolean;
24
- kind: "organization" | "personal" | "project" | "bot" | "channel";
24
+ kind: "personal" | "organization" | "project" | "bot" | "channel" | "community";
25
25
  accountId: string;
26
26
  id: string;
27
27
  lastUsedAt: number | null;
@@ -61,7 +61,7 @@ export declare const deviceActivateResponseCheck: import("./check").Check<{
61
61
  userId: string;
62
62
  contexts: {
63
63
  active: boolean;
64
- kind: "organization" | "personal" | "project" | "bot" | "channel";
64
+ kind: "personal" | "organization" | "project" | "bot" | "channel" | "community";
65
65
  accountId: string;
66
66
  id: string;
67
67
  lastUsedAt: number | null;
@@ -114,7 +114,7 @@ export declare const deviceDirectorySyncCheck: import("./check").Check<{
114
114
  userId: string;
115
115
  contexts: {
116
116
  active: boolean;
117
- kind: "organization" | "personal" | "project" | "bot" | "channel";
117
+ kind: "personal" | "organization" | "project" | "bot" | "channel" | "community";
118
118
  accountId: string;
119
119
  id: string;
120
120
  lastUsedAt: number | null;
@@ -16,6 +16,7 @@
16
16
  */
17
17
  export { type Check, type CheckIssue, type CheckPath, type CheckResult, ContractCheckError, checkContract, formatCheckPath, parseContract, } from './check';
18
18
  export { ACCOUNT_CATEGORY_IDS, ACCOUNT_CATEGORY_KINDS, ACCOUNT_KINDS, CHILD_ACCOUNT_KINDS, MAX_ACCOUNT_CATEGORIES, RETIRED_ACCOUNT_CATEGORY_IDS, SELECTABLE_ACCOUNT_CATEGORY_IDS, isAccountKind, isDelegatedActAsEligibleKind, isOperatorSwitchTargetKind, isSelectableAccountCategoryId, kindAcceptsAccountCategories, newlyAddedRetiredCategories, } from './accountGraph';
19
+ export { ACCOUNT_NAME_POLICY_BY_KIND, ACCOUNT_TITLE_DISALLOWED_SOURCE, ACCOUNT_TITLE_MAX_LENGTH, accountNamePolicyForKind, accountTitleCheck, isPlainTextTitle, } from './accountName';
19
20
  export { EMAIL_CODE_LENGTH, EMAIL_CODE_MAX_ATTEMPTS, EMAIL_CODE_TTL_MS, EMAIL_TICKET_TTL_MS, EMAIL_VERIFICATION_ERROR_CODES, EMAIL_VERIFICATION_PURPOSES, emailAddressCheck, emailTicketCheck, emailVerificationConfirmResponseCheck, emailVerificationStartResponseCheck, } from './accountEmail';
20
21
  export { ACCOUNT_AUTH_METHODS, AGENT_PROOF_ACTIONS, AGENT_PROOF_AUDIENCE, AGENT_PROOF_TTL_MS, agentChallengeRequestCheck, agentKeyListResponseCheck, agentKeyOperationChallengeCheck, agentKeyOperationCheck, agentKeyOperationResultCheck, agentProofClaimsCheck, agentVerifyRequestCheck, executeAgentKeyOperationCheck, } from './agentKeys';
21
22
  export { isLoopbackOrigin } from '../capabilityBindings';