@work-shape/catalyst-cli 0.8.0-rc.23 → 0.8.0-rc.25

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
@@ -7403,6 +7403,7 @@ declare const assetOperations: {
7403
7403
  readonly body: zod.ZodObject<{
7404
7404
  name: zod.ZodNullable<zod.ZodString>;
7405
7405
  expectedAssetId: zod.ZodOptional<zod.ZodString>;
7406
+ workspaceId: zod.ZodOptional<zod.ZodString>;
7406
7407
  }, zod_v4_core.$strip>;
7407
7408
  readonly response: {
7408
7409
  readonly kind: "json";
@@ -9962,6 +9963,7 @@ declare const collaborationWorkspaceOperations: {
9962
9963
  slate: "slate";
9963
9964
  }>>;
9964
9965
  personalUserId: z.ZodNullable<z.ZodString>;
9966
+ defaultAgentName: z.ZodOptional<z.ZodString>;
9965
9967
  createdAt: z.ZodISODateTime;
9966
9968
  updatedAt: z.ZodISODateTime;
9967
9969
  role: z.ZodEnum<{
@@ -10037,6 +10039,7 @@ declare const collaborationWorkspaceOperations: {
10037
10039
  slate: "slate";
10038
10040
  }>>;
10039
10041
  personalUserId: z.ZodNullable<z.ZodString>;
10042
+ defaultAgentName: z.ZodOptional<z.ZodString>;
10040
10043
  createdAt: z.ZodISODateTime;
10041
10044
  updatedAt: z.ZodISODateTime;
10042
10045
  role: z.ZodEnum<{
@@ -10144,6 +10147,7 @@ declare const collaborationWorkspaceOperations: {
10144
10147
  slate: "slate";
10145
10148
  }>>;
10146
10149
  personalUserId: z.ZodNullable<z.ZodString>;
10150
+ defaultAgentName: z.ZodOptional<z.ZodString>;
10147
10151
  createdAt: z.ZodISODateTime;
10148
10152
  updatedAt: z.ZodISODateTime;
10149
10153
  role: z.ZodEnum<{
@@ -10407,6 +10411,7 @@ declare const collaborationWorkspaceOperations: {
10407
10411
  slate: "slate";
10408
10412
  }>>;
10409
10413
  personalUserId: z.ZodNullable<z.ZodString>;
10414
+ defaultAgentName: z.ZodOptional<z.ZodString>;
10410
10415
  createdAt: z.ZodISODateTime;
10411
10416
  updatedAt: z.ZodISODateTime;
10412
10417
  role: z.ZodEnum<{
@@ -10726,6 +10731,7 @@ declare const collaborationWorkspaceOperations: {
10726
10731
  slate: "slate";
10727
10732
  }>>;
10728
10733
  personalUserId: z.ZodNullable<z.ZodString>;
10734
+ defaultAgentName: z.ZodOptional<z.ZodString>;
10729
10735
  createdAt: z.ZodISODateTime;
10730
10736
  updatedAt: z.ZodISODateTime;
10731
10737
  role: z.ZodEnum<{
@@ -13038,6 +13044,7 @@ declare const configAssetOperations: {
13038
13044
  items: zod.ZodArray<zod.ZodObject<{
13039
13045
  id: zod.ZodString;
13040
13046
  name: zod.ZodString;
13047
+ defaultAgentName: zod.ZodOptional<zod.ZodString>;
13041
13048
  createdAt: zod.ZodISODateTime;
13042
13049
  }, zod_v4_core.$strip>>;
13043
13050
  nextCursor: zod.ZodOptional<zod.ZodString>;
@@ -29704,6 +29711,7 @@ declare const platformOperations: {
29704
29711
  }>;
29705
29712
  member: zod.ZodBoolean;
29706
29713
  actions: zod.ZodArray<zod.ZodString>;
29714
+ useActions: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
29707
29715
  }, zod_v4_core.$strip>>;
29708
29716
  visibleSections: zod.ZodArray<zod.ZodEnum<{
29709
29717
  workflows: "workflows";
package/dist/index.js CHANGED
@@ -2769,7 +2769,7 @@ import { z as z67 } from "zod";
2769
2769
  // ../api-contract/package.json
2770
2770
  var package_default = {
2771
2771
  name: "@work-shape/catalyst-api-contract",
2772
- version: "0.8.0-rc.23",
2772
+ version: "0.8.0-rc.25",
2773
2773
  license: "MIT",
2774
2774
  repository: {
2775
2775
  type: "git",
@@ -3904,6 +3904,8 @@ var agentAvailabilitySchema = z24.object({
3904
3904
  var administeredCollaborationWorkspaceSchema = z24.object({
3905
3905
  id: z24.string(),
3906
3906
  name: z24.string(),
3907
+ /** The default agent the workspace names for itself; left out, it follows the instance's. */
3908
+ defaultAgentName: z24.string().optional(),
3907
3909
  createdAt: timestampSchema
3908
3910
  });
3909
3911
  var configAssetSummarySchema = z24.object({
@@ -4895,17 +4897,26 @@ var revertAssetRequestSchema = z29.object({
4895
4897
  workspaceId: workspaceIdSchema
4896
4898
  });
4897
4899
  var setAssetDefaultRequestSchema = z29.object({
4898
- /** The asset that becomes the instance's default of its kind, or `null` for none. */
4900
+ /**
4901
+ * The asset that becomes the instance's default of its kind, or `null` for none. With
4902
+ * `workspaceId`, the agent new chats start with in that Shared Workspace, or `null` to follow
4903
+ * the instance default there again.
4904
+ */
4899
4905
  name: nameText(z29.string().min(1)).nullable(),
4900
4906
  /**
4901
4907
  * The id of the named asset as the caller read it. Given, the call is refused with a
4902
4908
  * conflict where the name is held by another asset by now. Left out, nothing is compared.
4903
4909
  */
4904
- expectedAssetId: z29.string().min(1).optional()
4910
+ expectedAssetId: z29.string().min(1).optional(),
4911
+ /**
4912
+ * A Shared Workspace, to set its own default agent instead of the instance's: an instance
4913
+ * admin or the workspace's owner or admin may. The agent must be available there.
4914
+ */
4915
+ workspaceId: workspaceIdSchema
4905
4916
  });
4906
4917
  var setAssetDefaultResponseSchema = z29.object({
4907
4918
  /** The version of the instance's whole asset set after the change. */
4908
- version: z29.number().int().positive()
4919
+ version: z29.number().int().nonnegative()
4909
4920
  });
4910
4921
  var adoptAssetRepositoryRequestSchema = z29.object({
4911
4922
  /** Only the asset of this name. Left out, every asset of the kind. */
@@ -5887,7 +5898,7 @@ var createConversationRequestSchema = z32.object({
5887
5898
  */
5888
5899
  subject: conversationSubjectSchema.optional(),
5889
5900
  /**
5890
- * "Edit in chat" on an App's page: with an App of the workspace as `subject`, the new
5901
+ * With an App of the workspace as `subject`, the new
5891
5902
  * conversation, of the caller's own, holds the App's current draft with all its files in
5892
5903
  * `apps/<name>`, as the agent's `app.edit` loads it. Needs `app.write` on the App; without it
5893
5904
  * nothing is created.
@@ -7885,6 +7896,11 @@ var collaborationWorkspaceSchema = z38.object({
7885
7896
  emoji: z38.string().nullable(),
7886
7897
  accentColor: workspaceAccentColorSchema.nullable(),
7887
7898
  personalUserId: z38.string().nullable(),
7899
+ /**
7900
+ * The agent new chats start with in this Shared Workspace. Left out, the instance default
7901
+ * is the default here.
7902
+ */
7903
+ defaultAgentName: z38.string().optional(),
7888
7904
  createdAt: timestampSchema,
7889
7905
  updatedAt: timestampSchema
7890
7906
  });
@@ -12383,7 +12399,13 @@ var platformContextWorkspaceSchema = z60.object({
12383
12399
  kind: z60.enum(COLLABORATION_WORKSPACE_KINDS),
12384
12400
  /** The caller is a member: a new agent it makes there starts offered there. */
12385
12401
  member: z60.boolean(),
12386
- actions: z60.array(z60.string())
12402
+ actions: z60.array(z60.string()),
12403
+ /**
12404
+ * The use level a personal key limited to this workspace can carry: the use rights the
12405
+ * caller may hand on there. An issuance choice for the key screen, as `useActions` of the
12406
+ * context. Absent from instances before it was added.
12407
+ */
12408
+ useActions: z60.array(z60.string()).optional()
12387
12409
  });
12388
12410
  var platformContextSchema = z60.object({
12389
12411
  instance: z60.object({
@@ -12427,9 +12449,10 @@ var platformContextSchema = z60.object({
12427
12449
  */
12428
12450
  useActions: z60.array(z60.string()),
12429
12451
  /**
12430
- * The reading, writing and publishing rights a personal key can carry, of the rights the
12431
- * caller holds somewhere, as `useActions`. The key `catalyst setup` asks for starts with
12432
- * these and the use level ticked. These are issuance choices, not this credential's rights.
12452
+ * The reading, writing, deleting and publishing rights a personal key can carry, of the
12453
+ * rights the caller holds somewhere, as `useActions`. The key screen offers these and no
12454
+ * others; a connect code's key starts with them and the use level ticked. These are issuance
12455
+ * choices, not this credential's rights.
12433
12456
  */
12434
12457
  authoringActions: z60.array(z60.string()),
12435
12458
  /**
@@ -19483,12 +19506,16 @@ async function setAvailability(api, kind, name2, body, scope) {
19483
19506
  "It may have been applied: run 'show' before sending it again."
19484
19507
  );
19485
19508
  }
19486
- async function setDefault(api, kind, name2, scope) {
19487
- const asset = name2 === null ? void 0 : await api.read((client) => client.assets.get({ params: { kind, name: name2 }, query: scope }));
19509
+ async function setDefault(api, kind, name2, scope, defaultOf) {
19510
+ const asset = name2 === null || defaultOf !== void 0 ? void 0 : await api.read((client) => client.assets.get({ params: { kind, name: name2 }, query: scope }));
19488
19511
  return api.change(
19489
19512
  (client, idempotencyKey2) => client.assets.set_default({
19490
19513
  params: { kind },
19491
- body: { name: name2, ...asset === void 0 ? {} : { expectedAssetId: asset.id } },
19514
+ body: {
19515
+ name: name2,
19516
+ ...asset === void 0 ? {} : { expectedAssetId: asset.id },
19517
+ ...defaultOf === void 0 ? {} : { workspaceId: defaultOf }
19518
+ },
19492
19519
  idempotencyKey: idempotencyKey2
19493
19520
  }),
19494
19521
  "It may have been applied: run 'list' before sending it again."
@@ -19532,8 +19559,8 @@ var setAvailabilityVerb = {
19532
19559
 
19533
19560
  // src/asset-verbs/set-default.ts
19534
19561
  var setDefaultVerb = {
19535
- usage: "set-default <name> | set-default --none",
19536
- summary: "Set or clear the instance's default asset of the kind (assets.set_default)",
19562
+ usage: "set-default <name> [--workspace <id>] | set-default --none [--workspace <id>]",
19563
+ summary: "Set or clear the instance's default asset of the kind, or with --workspace a Shared Workspace's own default agent (assets.set_default)",
19537
19564
  named: false,
19538
19565
  options: { none: { type: "boolean", default: false } },
19539
19566
  prepare: (values, name2) => {
@@ -19541,18 +19568,23 @@ var setDefaultVerb = {
19541
19568
  throw new UsageError("Name the asset, or pass --none to clear the default.");
19542
19569
  }
19543
19570
  const chosen = values.none ? null : name2;
19571
+ const workspaceId = values.workspace;
19544
19572
  return async (session2) => {
19545
- const outcome = await setDefault(session2.api, session2.kind.kind, chosen, session2.scope).catch(
19546
- (error) => {
19547
- if (!(error instanceof ConfigApiError) || error.code !== "REVISION_CONFLICT") throw error;
19548
- throw new ExplainedRefusal(
19549
- error,
19550
- `Run 'catalyst ${session2.kind.kind} list' and retry the default selection.`
19551
- );
19552
- }
19553
- );
19573
+ const outcome = await setDefault(
19574
+ session2.api,
19575
+ session2.kind.kind,
19576
+ chosen,
19577
+ session2.scope,
19578
+ workspaceId
19579
+ ).catch((error) => {
19580
+ if (!(error instanceof ConfigApiError) || error.code !== "REVISION_CONFLICT") throw error;
19581
+ throw new ExplainedRefusal(
19582
+ error,
19583
+ `Run 'catalyst ${session2.kind.kind} list' and retry the default selection.`
19584
+ );
19585
+ });
19554
19586
  return settle(session2, outcome, () => [
19555
- chosen === null ? `The instance has no default ${session2.kind.kind} now.` : `'${chosen}' is the instance's default ${session2.kind.kind} now.`
19587
+ workspaceId === void 0 ? chosen === null ? `The instance has no default ${session2.kind.kind} now.` : `'${chosen}' is the instance's default ${session2.kind.kind} now.` : chosen === null ? `The workspace '${workspaceId}' follows the instance's default ${session2.kind.kind} now.` : `'${chosen}' is the default ${session2.kind.kind} of the workspace '${workspaceId}' now.`
19556
19588
  ]);
19557
19589
  };
19558
19590
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@work-shape/catalyst-cli",
3
- "version": "0.8.0-rc.23",
3
+ "version": "0.8.0-rc.25",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -40,9 +40,9 @@
40
40
  "@types/node": "^24.13.1",
41
41
  "tsup": "^8.5.1",
42
42
  "typescript": "^6.0.3",
43
- "@work-shape/catalyst-api-client": "0.8.0-rc.23",
44
- "@work-shape/catalyst-api-contract": "0.8.0-rc.23",
45
- "@work-shape/catalyst-asset-schemas": "0.8.0-rc.23"
43
+ "@work-shape/catalyst-api-client": "0.8.0-rc.25",
44
+ "@work-shape/catalyst-api-contract": "0.8.0-rc.25",
45
+ "@work-shape/catalyst-asset-schemas": "0.8.0-rc.25"
46
46
  },
47
47
  "scripts": {
48
48
  "build": "tsup",
@@ -36,6 +36,17 @@ catalyst references --json
36
36
 
37
37
  The kind is the first word: `agent`, `skill`, `guardrail`, `app`, `workflow`, `data-store` or any other kind `catalyst kinds` lists. Add `--workspace <id>` for the assets one workspace owns, and `--json` for the instance's answer as it came.
38
38
 
39
+ ## Where data belongs
40
+
41
+ Decide this before you put data into any asset. A skill folder holds instructions, small fixed reference files and offline calculators: at most 2 MiB a file, 8 MiB and 500 files a skill (`catalyst skill validate` and `put` refuse more). Its scripts run in the instance's sandbox with no network, no secrets and no tools, so never write `curl` or another fetch into a skill script and never put a corpus into a skill folder.
42
+
43
+ - A larger or changing corpus (statutes, manuals, document collections) is a Knowledge Base: filled by upload, by a synced document source such as Dropbox, or by a Workflow that calls the Knowledge Base's `ingest` operation. Cite with dates.
44
+ - Records people or Apps write are a Data Store.
45
+ - An outside system or anything with a credential is a Connection, used by the agent or a Workflow and never by a skill script. An App reaches it only through a named action.
46
+ - A PDF or file an App makes is generated in the browser with a bundled library and downloaded.
47
+
48
+ Where the 8 MiB or the network stops you, change the design, not the folder. `catalyst docs configure/where-data-belongs` has the page.
49
+
39
50
  ## Use a skill of the instance here
40
51
 
41
52
  Only when the person asks to use a skill locally, run `catalyst skill pull <name> .claude/skills/<name>` for Claude Code or `catalyst skill pull <name> .agents/skills/<name>` for Codex. Pulling again refreshes the folder and refuses local edits. Its scripts may assume Catalyst's sandbox, so read them before running them.