@work-shape/catalyst-cli 0.8.0-rc.24 → 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 +8 -0
- package/dist/index.js +56 -24
- package/package.json +4 -4
- package/skills/catalyst/SKILL.md +11 -0
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.
|
|
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
|
-
/**
|
|
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().
|
|
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
|
-
*
|
|
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
|
|
12431
|
-
* caller holds somewhere, as `useActions`. The key
|
|
12432
|
-
*
|
|
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: {
|
|
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(
|
|
19546
|
-
|
|
19547
|
-
|
|
19548
|
-
|
|
19549
|
-
|
|
19550
|
-
|
|
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.
|
|
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-
|
|
44
|
-
"@work-shape/catalyst-
|
|
45
|
-
"@work-shape/catalyst-
|
|
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",
|
package/skills/catalyst/SKILL.md
CHANGED
|
@@ -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.
|