@work-shape/catalyst-cli 0.8.0-rc.31 → 0.8.0-rc.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -158,7 +158,7 @@ type OperationScope = Exclude<FirstPartyAuthScope, "*">;
158
158
  * Every right of the platform, one file per domain under `contract-values/`. The order is kept:
159
159
  * `GRANTABLE_ACTIONS` filters it, and the rights dialog lists rights in it.
160
160
  */
161
- declare const ACTIONS: readonly ["agent.read", "agent.write", "agent.publish", "agent.approve", "agent.delete", "agent.use", "skill.read", "skill.write", "skill.publish", "skill.delete", "skill.approve", "connection.read", "connection.use", "connection.write", "connection.delete", "connection.approve", "app.read", "app.write", "app.publish", "app.approve", "app.delete", "app.use", "workflow.read", "workflow.write", "workflow.publish", "workflow.approve", "workflow.delete", "workflow.use", "workflow.read_run_data", "data_store.read", "data_store.write", "data_store.publish", "data_store.delete", "data_store.insert", "data_store.execute", "data_store.records", "knowledge_base.read", "knowledge_base.write", "knowledge_base.ingest", "knowledge_base.publish", "knowledge_base.delete", "knowledge_base.use", "mail_sender.use", "guardrail.read", "guardrail.write", "guardrail.publish", "guardrail.delete", "operations.approve", "feedback.review", "users.manage", "users.delete", "usage.view", "limits.manage", "policy.manage", "usage.view_users", "audit.view", "system.view", "jobs.retry", "api_access.manage", "service_principals.manage", "agent_models.manage", "roles.edit_built_in", "assets.release", "builder", "publisher", "project.read", "project.write", "project.delete"];
161
+ declare const ACTIONS: readonly ["agent.read", "agent.write", "agent.publish", "agent.approve", "agent.delete", "agent.use", "skill.read", "skill.write", "skill.publish", "skill.delete", "skill.approve", "connection.read", "connection.use", "connection.write", "connection.delete", "connection.approve", "connection.add_own", "app.read", "app.write", "app.publish", "app.approve", "app.delete", "app.use", "workflow.read", "workflow.write", "workflow.publish", "workflow.approve", "workflow.delete", "workflow.use", "workflow.read_run_data", "data_store.read", "data_store.write", "data_store.publish", "data_store.delete", "data_store.insert", "data_store.execute", "data_store.records", "knowledge_base.read", "knowledge_base.write", "knowledge_base.ingest", "knowledge_base.publish", "knowledge_base.delete", "knowledge_base.use", "mail_sender.use", "guardrail.read", "guardrail.write", "guardrail.publish", "guardrail.delete", "operations.approve", "feedback.review", "users.manage", "users.delete", "usage.view", "limits.manage", "policy.manage", "usage.view_users", "audit.view", "system.view", "jobs.retry", "api_access.manage", "service_principals.manage", "agent_models.manage", "roles.edit_built_in", "assets.release", "builder", "publisher", "project.read", "project.write", "project.delete"];
162
162
  type PlatformAction = (typeof ACTIONS)[number];
163
163
  type OperationEffect = (typeof OPERATION_EFFECTS)[number];
164
164
  declare const OPERATION_EFFECTS: readonly ["reading", "changing"];
@@ -3623,6 +3623,7 @@ declare const agentOperations: {
3623
3623
  mode: zod.ZodEnum<{
3624
3624
  all: "all";
3625
3625
  selected: "selected";
3626
+ all_except: "all_except";
3626
3627
  }>;
3627
3628
  personalWorkspaces: zod.ZodBoolean;
3628
3629
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -4182,6 +4183,12 @@ declare const agentOperations: {
4182
4183
  }, zod_v4_core.$strip>>;
4183
4184
  creationTarget: zod.ZodOptional<zod.ZodLiteral<"instance">>;
4184
4185
  projectId: zod.ZodOptional<zod.ZodString>;
4186
+ people: zod.ZodArray<zod.ZodObject<{
4187
+ userId: zod.ZodString;
4188
+ displayLabel: zod.ZodString;
4189
+ addedAt: zod.ZodISODateTime;
4190
+ }, zod_v4_core.$strip>>;
4191
+ createdByDisplayLabel: zod.ZodOptional<zod.ZodString>;
4185
4192
  }, zod_v4_core.$strip>;
4186
4193
  preview: zod.ZodLiteral<true>;
4187
4194
  }, zod_v4_core.$strip>;
@@ -6644,6 +6651,7 @@ declare const approvalRequestOperations: {
6644
6651
  agentName: zod.ZodString;
6645
6652
  }, zod_v4_core.$strip>>;
6646
6653
  addresseeUserId: zod.ZodOptional<zod.ZodString>;
6654
+ requesterDecides: zod.ZodOptional<zod.ZodLiteral<true>>;
6647
6655
  status: zod.ZodEnum<{
6648
6656
  rejected: "rejected";
6649
6657
  approved: "approved";
@@ -6709,6 +6717,7 @@ declare const approvalRequestOperations: {
6709
6717
  }>>;
6710
6718
  scope: zod.ZodOptional<zod.ZodEnum<{
6711
6719
  decided: "decided";
6720
+ others_own: "others_own";
6712
6721
  }>>;
6713
6722
  limit: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
6714
6723
  cursor: zod.ZodOptional<zod.ZodString>;
@@ -6733,6 +6742,7 @@ declare const approvalRequestOperations: {
6733
6742
  agentName: zod.ZodString;
6734
6743
  }, zod_v4_core.$strip>>;
6735
6744
  addresseeUserId: zod.ZodOptional<zod.ZodString>;
6745
+ requesterDecides: zod.ZodOptional<zod.ZodLiteral<true>>;
6736
6746
  status: zod.ZodEnum<{
6737
6747
  rejected: "rejected";
6738
6748
  approved: "approved";
@@ -6815,6 +6825,7 @@ declare const approvalRequestOperations: {
6815
6825
  agentName: zod.ZodString;
6816
6826
  }, zod_v4_core.$strip>>;
6817
6827
  addresseeUserId: zod.ZodOptional<zod.ZodString>;
6828
+ requesterDecides: zod.ZodOptional<zod.ZodLiteral<true>>;
6818
6829
  status: zod.ZodEnum<{
6819
6830
  rejected: "rejected";
6820
6831
  approved: "approved";
@@ -6879,6 +6890,7 @@ declare const approvalRequestOperations: {
6879
6890
  count: zod.ZodNumber;
6880
6891
  canReview: zod.ZodBoolean;
6881
6892
  decided: zod.ZodNumber;
6893
+ othersOwn: zod.ZodNumber;
6882
6894
  mine: zod.ZodObject<{
6883
6895
  pending: zod.ZodNumber;
6884
6896
  total: zod.ZodNumber;
@@ -6928,6 +6940,7 @@ declare const approvalRequestOperations: {
6928
6940
  agentName: zod.ZodString;
6929
6941
  }, zod_v4_core.$strip>>;
6930
6942
  addresseeUserId: zod.ZodOptional<zod.ZodString>;
6943
+ requesterDecides: zod.ZodOptional<zod.ZodLiteral<true>>;
6931
6944
  status: zod.ZodEnum<{
6932
6945
  rejected: "rejected";
6933
6946
  approved: "approved";
@@ -6997,6 +7010,7 @@ declare const approvalRequestOperations: {
6997
7010
  agentName: zod.ZodString;
6998
7011
  }, zod_v4_core.$strip>>;
6999
7012
  addresseeUserId: zod.ZodOptional<zod.ZodString>;
7013
+ requesterDecides: zod.ZodOptional<zod.ZodLiteral<true>>;
7000
7014
  status: zod.ZodEnum<{
7001
7015
  rejected: "rejected";
7002
7016
  approved: "approved";
@@ -7065,6 +7079,7 @@ declare const approvalRequestOperations: {
7065
7079
  agentName: zod.ZodString;
7066
7080
  }, zod_v4_core.$strip>>;
7067
7081
  addresseeUserId: zod.ZodOptional<zod.ZodString>;
7082
+ requesterDecides: zod.ZodOptional<zod.ZodLiteral<true>>;
7068
7083
  status: zod.ZodEnum<{
7069
7084
  rejected: "rejected";
7070
7085
  approved: "approved";
@@ -7123,6 +7138,7 @@ declare const assetOperations: {
7123
7138
  prefix: zod.ZodOptional<zod.ZodString>;
7124
7139
  text: zod.ZodOptional<zod.ZodString>;
7125
7140
  workspaceId: zod.ZodOptional<zod.ZodString>;
7141
+ owners: zod.ZodOptional<zod.ZodString>;
7126
7142
  locale: zod.ZodOptional<zod.ZodString>;
7127
7143
  }, zod_v4_core.$strip>;
7128
7144
  readonly response: {
@@ -7775,6 +7791,7 @@ declare const assetOperations: {
7775
7791
  mode: zod.ZodEnum<{
7776
7792
  all: "all";
7777
7793
  selected: "selected";
7794
+ all_except: "all_except";
7778
7795
  }>;
7779
7796
  personalWorkspaces: zod.ZodBoolean;
7780
7797
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -7790,6 +7807,7 @@ declare const assetOperations: {
7790
7807
  mode: zod.ZodEnum<{
7791
7808
  all: "all";
7792
7809
  selected: "selected";
7810
+ all_except: "all_except";
7793
7811
  }>;
7794
7812
  personalWorkspaces: zod.ZodBoolean;
7795
7813
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -7880,6 +7898,7 @@ declare const assetOperations: {
7880
7898
  availabilityMode: zod.ZodOptional<zod.ZodEnum<{
7881
7899
  all: "all";
7882
7900
  selected: "selected";
7901
+ all_except: "all_except";
7883
7902
  }>>;
7884
7903
  availabilityPersonalWorkspaces: zod.ZodOptional<zod.ZodEnum<{
7885
7904
  true: "true";
@@ -8060,6 +8079,7 @@ declare const assetOperations: {
8060
8079
  mode: zod.ZodEnum<{
8061
8080
  all: "all";
8062
8081
  selected: "selected";
8082
+ all_except: "all_except";
8063
8083
  }>;
8064
8084
  personalWorkspaces: zod.ZodBoolean;
8065
8085
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -8069,6 +8089,7 @@ declare const assetOperations: {
8069
8089
  mode: zod.ZodEnum<{
8070
8090
  all: "all";
8071
8091
  selected: "selected";
8092
+ all_except: "all_except";
8072
8093
  }>;
8073
8094
  personalWorkspaces: zod.ZodBoolean;
8074
8095
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -8208,6 +8229,7 @@ declare const assetOperations: {
8208
8229
  mode: zod.ZodEnum<{
8209
8230
  all: "all";
8210
8231
  selected: "selected";
8232
+ all_except: "all_except";
8211
8233
  }>;
8212
8234
  personalWorkspaces: zod.ZodBoolean;
8213
8235
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -8390,6 +8412,7 @@ declare const assetOperations: {
8390
8412
  mode: zod.ZodEnum<{
8391
8413
  all: "all";
8392
8414
  selected: "selected";
8415
+ all_except: "all_except";
8393
8416
  }>;
8394
8417
  personalWorkspaces: zod.ZodBoolean;
8395
8418
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -9115,6 +9138,7 @@ declare const assetOperations: {
9115
9138
  mode: zod.ZodEnum<{
9116
9139
  all: "all";
9117
9140
  selected: "selected";
9141
+ all_except: "all_except";
9118
9142
  }>;
9119
9143
  personalWorkspaces: zod.ZodOptional<zod.ZodBoolean>;
9120
9144
  collaborationWorkspaceIds: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
@@ -9123,6 +9147,7 @@ declare const assetOperations: {
9123
9147
  mode: zod.ZodEnum<{
9124
9148
  all: "all";
9125
9149
  selected: "selected";
9150
+ all_except: "all_except";
9126
9151
  }>;
9127
9152
  personalWorkspaces: zod.ZodBoolean;
9128
9153
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -9135,6 +9160,7 @@ declare const assetOperations: {
9135
9160
  mode: zod.ZodEnum<{
9136
9161
  all: "all";
9137
9162
  selected: "selected";
9163
+ all_except: "all_except";
9138
9164
  }>;
9139
9165
  personalWorkspaces: zod.ZodBoolean;
9140
9166
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -12997,6 +13023,7 @@ declare const configAssetOperations: {
12997
13023
  mode: zod.ZodEnum<{
12998
13024
  all: "all";
12999
13025
  selected: "selected";
13026
+ all_except: "all_except";
13000
13027
  }>;
13001
13028
  personalWorkspaces: zod.ZodBoolean;
13002
13029
  collaborationWorkspaceIds: zod.ZodArray<zod.ZodString>;
@@ -13629,6 +13656,7 @@ declare const connectionOperations: {
13629
13656
  network_denied: "network_denied";
13630
13657
  unavailable: "unavailable";
13631
13658
  oauth_required: "oauth_required";
13659
+ token_required: "token_required";
13632
13660
  }>;
13633
13661
  testedAt: z.ZodISODateTime;
13634
13662
  }, z.core.$strip>;
@@ -14470,7 +14498,32 @@ declare const connectionOperations: {
14470
14498
  optional: z.ZodBoolean;
14471
14499
  setting: z.ZodOptional<z.ZodString>;
14472
14500
  secret: z.ZodBoolean;
14501
+ value: z.ZodOptional<z.ZodEnum<{
14502
+ number: "number";
14503
+ text: "text";
14504
+ list: "list";
14505
+ }>>;
14506
+ default: z.ZodOptional<z.ZodString>;
14507
+ advanced: z.ZodOptional<z.ZodLiteral<true>>;
14508
+ }, z.core.$strip>>;
14509
+ sharedAccountNote: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
14510
+ en: z.ZodOptional<z.ZodString>;
14511
+ de: z.ZodOptional<z.ZodString>;
14512
+ }, z.core.$strict>]>>;
14513
+ operations: z.ZodArray<z.ZodObject<{
14514
+ name: z.ZodString;
14515
+ description: z.ZodString;
14516
+ effect: z.ZodEnum<{
14517
+ reading: "reading";
14518
+ changing: "changing";
14519
+ }>;
14473
14520
  }, z.core.$strip>>;
14521
+ exposures: z.ZodArray<z.ZodEnum<{
14522
+ agent: "agent";
14523
+ bridge: "bridge";
14524
+ workflow: "workflow";
14525
+ outside: "outside";
14526
+ }>>;
14474
14527
  }, z.core.$strip>>;
14475
14528
  entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
14476
14529
  id: z.ZodString;
@@ -16937,6 +16990,12 @@ declare const conversationOperations: {
16937
16990
  }, z.core.$strip>>;
16938
16991
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
16939
16992
  projectId: z.ZodOptional<z.ZodString>;
16993
+ people: z.ZodArray<z.ZodObject<{
16994
+ userId: z.ZodString;
16995
+ displayLabel: z.ZodString;
16996
+ addedAt: z.ZodISODateTime;
16997
+ }, z.core.$strip>>;
16998
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
16940
16999
  latestMessageAt: z.ZodOptional<z.ZodISODateTime>;
16941
17000
  activeRun: z.ZodOptional<z.ZodObject<{
16942
17001
  id: z.ZodString;
@@ -17019,6 +17078,12 @@ declare const conversationOperations: {
17019
17078
  }, z.core.$strip>>;
17020
17079
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
17021
17080
  projectId: z.ZodOptional<z.ZodString>;
17081
+ people: z.ZodArray<z.ZodObject<{
17082
+ userId: z.ZodString;
17083
+ displayLabel: z.ZodString;
17084
+ addedAt: z.ZodISODateTime;
17085
+ }, z.core.$strip>>;
17086
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
17022
17087
  }, z.core.$strip>;
17023
17088
  };
17024
17089
  readonly errors: readonly ["NOT_FOUND", "FORBIDDEN", "CONFLICT", "VALIDATION_FAILED"];
@@ -17061,6 +17126,12 @@ declare const conversationOperations: {
17061
17126
  }, z.core.$strip>>;
17062
17127
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
17063
17128
  projectId: z.ZodOptional<z.ZodString>;
17129
+ people: z.ZodArray<z.ZodObject<{
17130
+ userId: z.ZodString;
17131
+ displayLabel: z.ZodString;
17132
+ addedAt: z.ZodISODateTime;
17133
+ }, z.core.$strip>>;
17134
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
17064
17135
  }, z.core.$strip>;
17065
17136
  };
17066
17137
  readonly errors: readonly ["NOT_FOUND"];
@@ -17105,6 +17176,12 @@ declare const conversationOperations: {
17105
17176
  }, z.core.$strip>>;
17106
17177
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
17107
17178
  projectId: z.ZodOptional<z.ZodString>;
17179
+ people: z.ZodArray<z.ZodObject<{
17180
+ userId: z.ZodString;
17181
+ displayLabel: z.ZodString;
17182
+ addedAt: z.ZodISODateTime;
17183
+ }, z.core.$strip>>;
17184
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
17108
17185
  }, z.core.$strip>;
17109
17186
  };
17110
17187
  readonly errors: readonly ["NOT_FOUND", "CONFLICT"];
@@ -17447,11 +17524,114 @@ declare const conversationOperations: {
17447
17524
  }, z.core.$strip>>;
17448
17525
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
17449
17526
  projectId: z.ZodOptional<z.ZodString>;
17527
+ people: z.ZodArray<z.ZodObject<{
17528
+ userId: z.ZodString;
17529
+ displayLabel: z.ZodString;
17530
+ addedAt: z.ZodISODateTime;
17531
+ }, z.core.$strip>>;
17532
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
17450
17533
  }, z.core.$strip>;
17451
17534
  };
17452
17535
  readonly errors: readonly ["NOT_FOUND", "CONFLICT"];
17453
17536
  readonly rateClass: "write";
17454
17537
  }>;
17538
+ readonly "conversations.add_person": Operation<{
17539
+ readonly id: "conversations.add_person";
17540
+ readonly method: "POST";
17541
+ readonly path: "/api/v1/conversations/:conversationId/people";
17542
+ readonly summary: "Name a member of the chat's workspace to read and write in the creator's private chat";
17543
+ readonly tag: "Conversations";
17544
+ readonly auth: "user";
17545
+ readonly scope: "conversation:write";
17546
+ readonly requires: readonly [];
17547
+ readonly effect: "changing";
17548
+ readonly body: z.ZodObject<{
17549
+ userId: z.ZodString;
17550
+ }, z.core.$strict>;
17551
+ readonly response: {
17552
+ readonly kind: "json";
17553
+ readonly schema: z.ZodObject<{
17554
+ id: z.ZodString;
17555
+ clientInstanceId: z.ZodString;
17556
+ collaborationWorkspaceId: z.ZodString;
17557
+ createdByUserId: z.ZodString;
17558
+ createdByExternalUserId: z.ZodString;
17559
+ visibility: z.ZodEnum<{
17560
+ workspace: "workspace";
17561
+ private: "private";
17562
+ }>;
17563
+ title: z.ZodString;
17564
+ status: z.ZodString;
17565
+ createdAt: z.ZodISODateTime;
17566
+ updatedAt: z.ZodISODateTime;
17567
+ retainedUntil: z.ZodISODateTime;
17568
+ deletedAt: z.ZodOptional<z.ZodISODateTime>;
17569
+ subject: z.ZodOptional<z.ZodObject<{
17570
+ kind: z.ZodString;
17571
+ name: z.ZodString;
17572
+ }, z.core.$strip>>;
17573
+ creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
17574
+ projectId: z.ZodOptional<z.ZodString>;
17575
+ people: z.ZodArray<z.ZodObject<{
17576
+ userId: z.ZodString;
17577
+ displayLabel: z.ZodString;
17578
+ addedAt: z.ZodISODateTime;
17579
+ }, z.core.$strip>>;
17580
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
17581
+ }, z.core.$strip>;
17582
+ };
17583
+ readonly errors: readonly ["NOT_FOUND", "FORBIDDEN", "CONFLICT", "VALIDATION_FAILED"];
17584
+ readonly rateClass: "write";
17585
+ }>;
17586
+ readonly "conversations.remove_person": Operation<{
17587
+ readonly id: "conversations.remove_person";
17588
+ readonly method: "DELETE";
17589
+ readonly path: "/api/v1/conversations/:conversationId/people/:userId";
17590
+ readonly summary: "Take a named person off a private chat: its creator removes anyone, a named person leaves";
17591
+ readonly tag: "Conversations";
17592
+ readonly auth: "user";
17593
+ readonly scope: "conversation:write";
17594
+ readonly requires: readonly [];
17595
+ readonly effect: "changing";
17596
+ readonly response: {
17597
+ readonly kind: "json";
17598
+ readonly schema: z.ZodObject<{
17599
+ conversationId: z.ZodString;
17600
+ userId: z.ZodString;
17601
+ removed: z.ZodBoolean;
17602
+ }, z.core.$strip>;
17603
+ };
17604
+ readonly errors: readonly ["NOT_FOUND", "FORBIDDEN", "CONFLICT"];
17605
+ readonly rateClass: "write";
17606
+ }>;
17607
+ readonly "conversations.share_candidates": Operation<{
17608
+ readonly id: "conversations.share_candidates";
17609
+ readonly method: "GET";
17610
+ readonly path: "/api/v1/conversations/:conversationId/share-candidates";
17611
+ readonly summary: "The members of the chat's workspace its creator may name, preselected or searched";
17612
+ readonly tag: "Conversations";
17613
+ readonly auth: "user";
17614
+ readonly scope: "conversation:read";
17615
+ readonly requires: readonly [];
17616
+ readonly effect: "reading";
17617
+ readonly query: z.ZodObject<{
17618
+ query: z.ZodOptional<z.ZodString>;
17619
+ limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
17620
+ }, z.core.$strip>;
17621
+ readonly response: {
17622
+ readonly kind: "json";
17623
+ readonly schema: z.ZodObject<{
17624
+ candidates: z.ZodArray<z.ZodObject<{
17625
+ userId: z.ZodString;
17626
+ displayLabel: z.ZodString;
17627
+ email: z.ZodOptional<z.ZodString>;
17628
+ hasAccess: z.ZodBoolean;
17629
+ }, z.core.$strip>>;
17630
+ }, z.core.$strip>;
17631
+ };
17632
+ readonly errors: readonly ["NOT_FOUND", "FORBIDDEN"];
17633
+ readonly rateClass: "read";
17634
+ }>;
17455
17635
  readonly "conversations.thread.get": Operation<{
17456
17636
  readonly id: "conversations.thread.get";
17457
17637
  readonly method: "GET";
@@ -17527,6 +17707,12 @@ declare const conversationOperations: {
17527
17707
  }, z.core.$strip>>;
17528
17708
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
17529
17709
  projectId: z.ZodOptional<z.ZodString>;
17710
+ people: z.ZodArray<z.ZodObject<{
17711
+ userId: z.ZodString;
17712
+ displayLabel: z.ZodString;
17713
+ addedAt: z.ZodISODateTime;
17714
+ }, z.core.$strip>>;
17715
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
17530
17716
  }, z.core.$strip>;
17531
17717
  messages: z.ZodArray<z.ZodObject<{
17532
17718
  id: z.ZodString;
@@ -17644,6 +17830,8 @@ declare const conversationOperations: {
17644
17830
  page: z.ZodOptional<z.ZodNumber>;
17645
17831
  sheet: z.ZodOptional<z.ZodString>;
17646
17832
  originLink: z.ZodOptional<z.ZodString>;
17833
+ statedAt: z.ZodOptional<z.ZodString>;
17834
+ retrievedAt: z.ZodOptional<z.ZodString>;
17647
17835
  }, z.core.$strip>>>;
17648
17836
  citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
17649
17837
  sourceId: z.ZodString;
@@ -18257,6 +18445,8 @@ declare const conversationOperations: {
18257
18445
  runAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
18258
18446
  inputMessageId: z.ZodString;
18259
18447
  agentName: z.ZodString;
18448
+ ownerUserId: z.ZodOptional<z.ZodString>;
18449
+ ownerDisplayLabel: z.ZodOptional<z.ZodString>;
18260
18450
  }, z.core.$strip>>>;
18261
18451
  modelSelection: z.ZodOptional<z.ZodObject<{
18262
18452
  modelBindingId: z.ZodOptional<z.ZodString>;
@@ -18418,6 +18608,8 @@ declare const conversationOperations: {
18418
18608
  page: z.ZodOptional<z.ZodNumber>;
18419
18609
  sheet: z.ZodOptional<z.ZodString>;
18420
18610
  originLink: z.ZodOptional<z.ZodString>;
18611
+ statedAt: z.ZodOptional<z.ZodString>;
18612
+ retrievedAt: z.ZodOptional<z.ZodString>;
18421
18613
  }, z.core.$strip>>>;
18422
18614
  citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
18423
18615
  sourceId: z.ZodString;
@@ -18930,6 +19122,12 @@ declare const conversationOperations: {
18930
19122
  }, z.core.$strip>>;
18931
19123
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
18932
19124
  projectId: z.ZodOptional<z.ZodString>;
19125
+ people: z.ZodArray<z.ZodObject<{
19126
+ userId: z.ZodString;
19127
+ displayLabel: z.ZodString;
19128
+ addedAt: z.ZodISODateTime;
19129
+ }, z.core.$strip>>;
19130
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
18933
19131
  }, z.core.$strip>;
18934
19132
  userMessage: z.ZodObject<{
18935
19133
  id: z.ZodString;
@@ -19047,6 +19245,8 @@ declare const conversationOperations: {
19047
19245
  page: z.ZodOptional<z.ZodNumber>;
19048
19246
  sheet: z.ZodOptional<z.ZodString>;
19049
19247
  originLink: z.ZodOptional<z.ZodString>;
19248
+ statedAt: z.ZodOptional<z.ZodString>;
19249
+ retrievedAt: z.ZodOptional<z.ZodString>;
19050
19250
  }, z.core.$strip>>>;
19051
19251
  citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
19052
19252
  sourceId: z.ZodString;
@@ -19213,6 +19413,12 @@ declare const conversationOperations: {
19213
19413
  }, z.core.$strip>>;
19214
19414
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
19215
19415
  projectId: z.ZodOptional<z.ZodString>;
19416
+ people: z.ZodArray<z.ZodObject<{
19417
+ userId: z.ZodString;
19418
+ displayLabel: z.ZodString;
19419
+ addedAt: z.ZodISODateTime;
19420
+ }, z.core.$strip>>;
19421
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
19216
19422
  }, z.core.$strip>;
19217
19423
  messages: z.ZodArray<z.ZodObject<{
19218
19424
  id: z.ZodString;
@@ -19330,6 +19536,8 @@ declare const conversationOperations: {
19330
19536
  page: z.ZodOptional<z.ZodNumber>;
19331
19537
  sheet: z.ZodOptional<z.ZodString>;
19332
19538
  originLink: z.ZodOptional<z.ZodString>;
19539
+ statedAt: z.ZodOptional<z.ZodString>;
19540
+ retrievedAt: z.ZodOptional<z.ZodString>;
19333
19541
  }, z.core.$strip>>>;
19334
19542
  citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
19335
19543
  sourceId: z.ZodString;
@@ -19943,6 +20151,8 @@ declare const conversationOperations: {
19943
20151
  runAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
19944
20152
  inputMessageId: z.ZodString;
19945
20153
  agentName: z.ZodString;
20154
+ ownerUserId: z.ZodOptional<z.ZodString>;
20155
+ ownerDisplayLabel: z.ZodOptional<z.ZodString>;
19946
20156
  }, z.core.$strip>>>;
19947
20157
  modelSelection: z.ZodOptional<z.ZodObject<{
19948
20158
  modelBindingId: z.ZodOptional<z.ZodString>;
@@ -20163,6 +20373,12 @@ declare const conversationOperations: {
20163
20373
  }, z.core.$strip>>;
20164
20374
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
20165
20375
  projectId: z.ZodOptional<z.ZodString>;
20376
+ people: z.ZodArray<z.ZodObject<{
20377
+ userId: z.ZodString;
20378
+ displayLabel: z.ZodString;
20379
+ addedAt: z.ZodISODateTime;
20380
+ }, z.core.$strip>>;
20381
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
20166
20382
  }, z.core.$strip>;
20167
20383
  userMessage: z.ZodObject<{
20168
20384
  id: z.ZodString;
@@ -20280,6 +20496,8 @@ declare const conversationOperations: {
20280
20496
  page: z.ZodOptional<z.ZodNumber>;
20281
20497
  sheet: z.ZodOptional<z.ZodString>;
20282
20498
  originLink: z.ZodOptional<z.ZodString>;
20499
+ statedAt: z.ZodOptional<z.ZodString>;
20500
+ retrievedAt: z.ZodOptional<z.ZodString>;
20283
20501
  }, z.core.$strip>>>;
20284
20502
  citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
20285
20503
  sourceId: z.ZodString;
@@ -20446,6 +20664,12 @@ declare const conversationOperations: {
20446
20664
  }, z.core.$strip>>;
20447
20665
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
20448
20666
  projectId: z.ZodOptional<z.ZodString>;
20667
+ people: z.ZodArray<z.ZodObject<{
20668
+ userId: z.ZodString;
20669
+ displayLabel: z.ZodString;
20670
+ addedAt: z.ZodISODateTime;
20671
+ }, z.core.$strip>>;
20672
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
20449
20673
  }, z.core.$strip>;
20450
20674
  messages: z.ZodArray<z.ZodObject<{
20451
20675
  id: z.ZodString;
@@ -20563,6 +20787,8 @@ declare const conversationOperations: {
20563
20787
  page: z.ZodOptional<z.ZodNumber>;
20564
20788
  sheet: z.ZodOptional<z.ZodString>;
20565
20789
  originLink: z.ZodOptional<z.ZodString>;
20790
+ statedAt: z.ZodOptional<z.ZodString>;
20791
+ retrievedAt: z.ZodOptional<z.ZodString>;
20566
20792
  }, z.core.$strip>>>;
20567
20793
  citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
20568
20794
  sourceId: z.ZodString;
@@ -21176,6 +21402,8 @@ declare const conversationOperations: {
21176
21402
  runAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
21177
21403
  inputMessageId: z.ZodString;
21178
21404
  agentName: z.ZodString;
21405
+ ownerUserId: z.ZodOptional<z.ZodString>;
21406
+ ownerDisplayLabel: z.ZodOptional<z.ZodString>;
21179
21407
  }, z.core.$strip>>>;
21180
21408
  modelSelection: z.ZodOptional<z.ZodObject<{
21181
21409
  modelBindingId: z.ZodOptional<z.ZodString>;
@@ -21649,6 +21877,12 @@ declare const conversationOperations: {
21649
21877
  }, z.core.$strip>>;
21650
21878
  creationTarget: z.ZodOptional<z.ZodLiteral<"instance">>;
21651
21879
  projectId: z.ZodOptional<z.ZodString>;
21880
+ people: z.ZodArray<z.ZodObject<{
21881
+ userId: z.ZodString;
21882
+ displayLabel: z.ZodString;
21883
+ addedAt: z.ZodISODateTime;
21884
+ }, z.core.$strip>>;
21885
+ createdByDisplayLabel: z.ZodOptional<z.ZodString>;
21652
21886
  }, z.core.$strip>;
21653
21887
  };
21654
21888
  readonly errors: readonly ["NOT_FOUND", "CONFLICT"];
@@ -26370,6 +26604,13 @@ declare const knowledgeOperations: {
26370
26604
  addedBytes: z.ZodOptional<z.ZodNumber>;
26371
26605
  limitBytes: z.ZodOptional<z.ZodNumber>;
26372
26606
  }, z.core.$strict>>;
26607
+ schedule: z.ZodOptional<z.ZodObject<{
26608
+ changes: z.ZodUnion<readonly [z.ZodLiteral<"off">, z.ZodNumber]>;
26609
+ full: z.ZodString;
26610
+ defaultChanges: z.ZodNumber;
26611
+ defaultFull: z.ZodString;
26612
+ minChanges: z.ZodOptional<z.ZodNumber>;
26613
+ }, z.core.$strict>>;
26373
26614
  lastChangeAt: z.ZodOptional<z.ZodString>;
26374
26615
  oldestOpenChangeAt: z.ZodOptional<z.ZodString>;
26375
26616
  }, z.core.$strict>, z.ZodObject<{
@@ -26388,6 +26629,13 @@ declare const knowledgeOperations: {
26388
26629
  itemsPerMinute: z.ZodOptional<z.ZodNumber>;
26389
26630
  estimatedEndAt: z.ZodOptional<z.ZodString>;
26390
26631
  }, z.core.$strict>>;
26632
+ schedule: z.ZodOptional<z.ZodObject<{
26633
+ changes: z.ZodUnion<readonly [z.ZodLiteral<"off">, z.ZodNumber]>;
26634
+ full: z.ZodString;
26635
+ defaultChanges: z.ZodNumber;
26636
+ defaultFull: z.ZodString;
26637
+ minChanges: z.ZodOptional<z.ZodNumber>;
26638
+ }, z.core.$strict>>;
26391
26639
  failures: z.ZodArray<z.ZodObject<{
26392
26640
  code: z.ZodUnion<readonly [z.ZodEnum<{
26393
26641
  knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
@@ -28100,6 +28348,8 @@ declare const knowledgeOperations: {
28100
28348
  text: z.ZodString;
28101
28349
  score: z.ZodNumber;
28102
28350
  originLink: z.ZodOptional<z.ZodString>;
28351
+ statedAt: z.ZodOptional<z.ZodString>;
28352
+ retrievedAt: z.ZodOptional<z.ZodString>;
28103
28353
  }, z.core.$strip>>;
28104
28354
  signals: z.ZodArray<z.ZodEnum<{
28105
28355
  semantic: "semantic";
@@ -31270,6 +31520,12 @@ declare const projectOperations: {
31270
31520
  }, zod_v4_core.$strip>>;
31271
31521
  creationTarget: zod.ZodOptional<zod.ZodLiteral<"instance">>;
31272
31522
  projectId: zod.ZodOptional<zod.ZodString>;
31523
+ people: zod.ZodArray<zod.ZodObject<{
31524
+ userId: zod.ZodString;
31525
+ displayLabel: zod.ZodString;
31526
+ addedAt: zod.ZodISODateTime;
31527
+ }, zod_v4_core.$strip>>;
31528
+ createdByDisplayLabel: zod.ZodOptional<zod.ZodString>;
31273
31529
  }, zod_v4_core.$strip>;
31274
31530
  };
31275
31531
  readonly errors: readonly ["NOT_FOUND", "CONFLICT", "VALIDATION_FAILED"];
@@ -38432,6 +38688,7 @@ declare const assetSchema: z.ZodObject<{
38432
38688
  mode: z.ZodEnum<{
38433
38689
  all: "all";
38434
38690
  selected: "selected";
38691
+ all_except: "all_except";
38435
38692
  }>;
38436
38693
  personalWorkspaces: z.ZodBoolean;
38437
38694
  collaborationWorkspaceIds: z.ZodArray<z.ZodString>;
@@ -38441,6 +38698,7 @@ declare const assetSchema: z.ZodObject<{
38441
38698
  mode: z.ZodEnum<{
38442
38699
  all: "all";
38443
38700
  selected: "selected";
38701
+ all_except: "all_except";
38444
38702
  }>;
38445
38703
  personalWorkspaces: z.ZodBoolean;
38446
38704
  collaborationWorkspaceIds: z.ZodArray<z.ZodString>;
@@ -38822,6 +39080,89 @@ declare function redactSecret(message: string, secret: string): string;
38822
39080
 
38823
39081
  /** CLI and server ship one contract per release; build metadata does not change it. */
38824
39082
  declare function cliCompatibilityError(cliVersion: string, serverVersion: string): Error | undefined;
39083
+ /**
39084
+ * The release a server names, without its build metadata, where it is a valid SemVer version;
39085
+ * otherwise nothing. Only such a version is ever handed to npm.
39086
+ */
39087
+ declare function releaseVersionOf(serverVersion: string): string | undefined;
39088
+ declare class CliVersionError extends Error {
39089
+ readonly cliVersion: string;
39090
+ readonly serverVersion: string;
39091
+ constructor(cliVersion: string, serverVersion: string,
39092
+ /** What to run instead of the global install, for a CLI installed in a project. */
39093
+ instead?: string);
39094
+ }
39095
+
39096
+ /** The variables this package reads by a fixed name. */
39097
+ interface ConfigCliEnv {
39098
+ /** A key provisioned for automation. It wins over a key `catalyst login` saved. */
39099
+ readonly CATALYST_API_KEY?: string | undefined;
39100
+ /** The folder of the saved keys, in place of `$XDG_CONFIG_HOME/catalyst`. */
39101
+ readonly CATALYST_CONFIG_HOME?: string | undefined;
39102
+ readonly XDG_CONFIG_HOME?: string | undefined;
39103
+ /** The person's home folder, where `catalyst setup` writes the skill of their tool. */
39104
+ readonly HOME?: string | undefined;
39105
+ /** Claude Code's own folder in place of `~/.claude`, where `catalyst setup` writes its skill. */
39106
+ readonly CLAUDE_CONFIG_DIR?: string | undefined;
39107
+ /** Set to anything but `0` or `false`, the CLI never installs another version of itself. */
39108
+ readonly CATALYST_NO_AUTO_UPDATE?: string | undefined;
39109
+ /** Set by the CLI on the command it runs again after updating itself: the old version. */
39110
+ readonly CATALYST_CLI_UPDATED_FROM?: string | undefined;
39111
+ /** Set by CI services; there the CLI never updates itself. */
39112
+ readonly CI?: string | undefined;
39113
+ }
39114
+
39115
+ interface Ran {
39116
+ status: number | null;
39117
+ stdout: string;
39118
+ stderr: string;
39119
+ }
39120
+ /** What the self-update touches of the computer. Tests pass one that touches nothing. */
39121
+ interface SelfUpdateHost {
39122
+ /** The arguments of the command, run again after the update. */
39123
+ argv: readonly string[];
39124
+ env: ConfigCliEnv;
39125
+ /** Whether a person is at the terminal: standard input and standard error are both one. */
39126
+ interactive: boolean;
39127
+ platform: NodeJS.Platform;
39128
+ execPath: string;
39129
+ /** The folder of the package this process runs from. */
39130
+ packageRoot: string;
39131
+ exists: (path: string) => boolean;
39132
+ readText: (path: string) => string | undefined;
39133
+ realpath: (path: string) => string;
39134
+ /** Whether the entry at the path is a symbolic link, as `npm link` leaves one. */
39135
+ isLink: (path: string) => boolean;
39136
+ /**
39137
+ * Runs a program without a shell and captures its output; with `againFrom`, the command run
39138
+ * again, on the terminal, told the version it was updated from.
39139
+ */
39140
+ run: (file: string, args: readonly string[], options: {
39141
+ againFrom?: string;
39142
+ }) => Ran;
39143
+ stderr: (text: string) => void;
39144
+ exit: (code: number) => never;
39145
+ }
39146
+ /**
39147
+ * How to run npm without a shell: the npm that ships with this Node, run by this Node, which
39148
+ * also covers Windows, where `npm.cmd` cannot be started without one. Elsewhere `npm` on PATH.
39149
+ */
39150
+ declare function npmCommand(host: SelfUpdateHost): {
39151
+ file: string;
39152
+ args: string[];
39153
+ } | undefined;
39154
+ /**
39155
+ * On a CLI that does not match its instance: installs the instance's version of the CLI where
39156
+ * this one is installed globally and runs the same command again, once, with one line saying
39157
+ * so. Answers the error to report where it did not: today's, or for a project's CLI the
39158
+ * project's install command.
39159
+ */
39160
+ declare function updateToServerVersion(mismatch: CliVersionError, host: SelfUpdateHost): CliVersionError;
39161
+ /**
39162
+ * Turns the self-update on for this process, the `catalyst` command run with `argv`, and
39163
+ * answers how to turn it off. Tests pass the host.
39164
+ */
39165
+ declare function enableSelfUpdate(argv: readonly string[], host?: SelfUpdateHost): () => void;
38825
39166
 
38826
39167
  type SkillFolderFile = {
38827
39168
  path: string;
@@ -38853,19 +39194,6 @@ declare function canonicalizeSkillConfig(input: unknown): SkillConfig;
38853
39194
  declare function serializeSkillMarkdown(input: unknown, provenance?: AssetProvenance): string;
38854
39195
  declare function serializeSkillPackageForDisplay(input: unknown): string;
38855
39196
 
38856
- /** The variables this package reads by a fixed name. */
38857
- interface ConfigCliEnv {
38858
- /** A key provisioned for automation. It wins over a key `catalyst login` saved. */
38859
- readonly CATALYST_API_KEY?: string | undefined;
38860
- /** The folder of the saved keys, in place of `$XDG_CONFIG_HOME/catalyst`. */
38861
- readonly CATALYST_CONFIG_HOME?: string | undefined;
38862
- readonly XDG_CONFIG_HOME?: string | undefined;
38863
- /** The person's home folder, where `catalyst setup` writes the skill of their tool. */
38864
- readonly HOME?: string | undefined;
38865
- /** Claude Code's own folder in place of `~/.claude`, where `catalyst setup` writes its skill. */
38866
- readonly CLAUDE_CONFIG_DIR?: string | undefined;
38867
- }
38868
-
38869
39197
  declare const MANIFEST_FILENAME = "catalyst.yaml";
38870
39198
  declare const STATE_FILENAME = ".catalyst-state.json";
38871
39199
  interface ManifestInstance {
@@ -39062,9 +39390,15 @@ declare function createSkillFileDiff(name: string, oldFiles: SkillFolderFile[],
39062
39390
 
39063
39391
  /** The skill file this CLI writes: the shipped skill with a mark of who wrote it. */
39064
39392
  declare function renderCatalystSkill(): Promise<string>;
39393
+ /**
39394
+ * After the CLI updated itself: rewrites every Catalyst skill `catalyst setup` wrote and nobody
39395
+ * changed since with this version's skill, and answers their paths. A skill a person changed,
39396
+ * and anything that is no file, stays as it is.
39397
+ */
39398
+ declare function refreshWrittenSkills(env: ConfigCliEnv): Promise<string[]>;
39065
39399
 
39066
39400
  declare function commandNames(): string[];
39067
39401
 
39068
39402
  declare function runCli(argv: string[], runtime?: CliRuntimeOptions): Promise<number>;
39069
39403
 
39070
- export { ApiKeyExchangeError, type AssetBaseline, type AssetProvenance, CANONICAL_FORM_VERSION, type CatalystManifest, type CatalystState, type CliRuntimeOptions, type ConfigApi, ConfigApiError, type ConfigApiOptions, type ConfigCommandName, type ConfigCommandOptions, type DeletedAssetBaseline, type DiffFile, type InstanceBaseline, MANIFEST_FILENAME, type ManifestInstance, type PublishReview, type ResolvedInstance, STATE_FILENAME, type SyncBatch, type SyncOutcome, type SyncOutput, type WorkingCopyBundle, type WorkingCopyIssue, WorkingCopyValidationError, agentAssetPath, assertSafeApiKeyExchangeUrl, bindManifestWorkspace, canonicalBundleFiles, canonicalizeAgentConfig, canonicalizeSkillConfig, cliCompatibilityError, commandNames, createConfigApi, createSkillFileDiff, createUnifiedDiff, diffConfig, guardrailAssetPath, instanceFetch, listConfig, matchManifestFiles, matchesManifestPath, parseAgentYaml, parseManifest, parseSkillFile, publishReview, pullConfig, pushConfig, readManifest, readManifestIfPresent, readSkillResources, readStateFile, readWorkingCopy, redactSecret, removeStaleManifestAssets, renderCatalystSkill, resolveInstance, resolveSkillResourceTarget, runCli, runConfigCommand, serializeAgentYaml, serializeSkillMarkdown, serializeSkillPackageForDisplay, showConfig, skillAssetPath, toConfigApiError, updateManifestDefaultAgent, validateConfig, walkFiles, writeStateFile };
39404
+ export { ApiKeyExchangeError, type AssetBaseline, type AssetProvenance, CANONICAL_FORM_VERSION, type CatalystManifest, type CatalystState, type CliRuntimeOptions, CliVersionError, type ConfigApi, ConfigApiError, type ConfigApiOptions, type ConfigCommandName, type ConfigCommandOptions, type DeletedAssetBaseline, type DiffFile, type InstanceBaseline, MANIFEST_FILENAME, type ManifestInstance, type PublishReview, type ResolvedInstance, STATE_FILENAME, type SelfUpdateHost, type SyncBatch, type SyncOutcome, type SyncOutput, type WorkingCopyBundle, type WorkingCopyIssue, WorkingCopyValidationError, agentAssetPath, assertSafeApiKeyExchangeUrl, bindManifestWorkspace, canonicalBundleFiles, canonicalizeAgentConfig, canonicalizeSkillConfig, cliCompatibilityError, commandNames, createConfigApi, createSkillFileDiff, createUnifiedDiff, diffConfig, enableSelfUpdate, guardrailAssetPath, instanceFetch, listConfig, matchManifestFiles, matchesManifestPath, npmCommand, parseAgentYaml, parseManifest, parseSkillFile, publishReview, pullConfig, pushConfig, readManifest, readManifestIfPresent, readSkillResources, readStateFile, readWorkingCopy, redactSecret, refreshWrittenSkills, releaseVersionOf, removeStaleManifestAssets, renderCatalystSkill, resolveInstance, resolveSkillResourceTarget, runCli, runConfigCommand, serializeAgentYaml, serializeSkillMarkdown, serializeSkillPackageForDisplay, showConfig, skillAssetPath, toConfigApiError, updateManifestDefaultAgent, updateToServerVersion, validateConfig, walkFiles, writeStateFile };