volute 0.17.0 → 0.19.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.
- package/README.md +1 -1
- package/dist/archive-ZCFOSTKB.js +15 -0
- package/dist/{channel-SLURLIRV.js → channel-PUQKGSQM.js} +60 -7
- package/dist/{chunk-CE7WMOVW.js → chunk-2TJGRJ4O.js} +236 -103
- package/dist/{chunk-6BDNWYKG.js → chunk-32VR2EOH.js} +2 -2
- package/dist/chunk-4KPUF5JD.js +214 -0
- package/dist/{chunk-QJIIHU32.js → chunk-7NO7EV5Z.js} +2 -2
- package/dist/chunk-AW7P4EVV.js +159 -0
- package/dist/{chunk-2Y77MCFG.js → chunk-DYZGP3EW.js} +2 -2
- package/dist/{chunk-M77QBTEH.js → chunk-EBGCNDMM.js} +24 -14
- package/dist/{chunk-GSPWIM5E.js → chunk-EMQSAY3B.js} +77 -6
- package/dist/{chunk-37X7ECMF.js → chunk-FCDU5BFX.js} +1 -1
- package/dist/chunk-FGV2H4TX.js +803 -0
- package/dist/{chunk-ZCEYUUID.js → chunk-OGXOMR65.js} +2 -1
- package/dist/chunk-OTWLI7F4.js +375 -0
- package/dist/{chunk-3FC42ZBM.js → chunk-RHEGSQFJ.js} +4 -1
- package/dist/{chunk-MVSXRMJJ.js → chunk-SCUDS4US.js} +1 -1
- package/dist/{chunk-MIJIAGGG.js → chunk-UJ6GHNR7.js} +8 -6
- package/dist/{chunk-OYSZNX5I.js → chunk-VDWCHYTS.js} +1 -1
- package/dist/{chunk-77ISBIKI.js → chunk-VE4D3GOP.js} +2 -2
- package/dist/chunk-VQWDC6UK.js +142 -0
- package/dist/{chunk-OJQ47SCA.js → chunk-WC6ZHVRL.js} +1 -1
- package/dist/chunk-YUIHSKR6.js +72 -0
- package/dist/chunk-Z524RFCJ.js +36 -0
- package/dist/cli.js +44 -24
- package/dist/{connector-3ELFMI2R.js → connector-JBVNZ7VK.js} +6 -6
- package/dist/connectors/discord.js +2 -2
- package/dist/connectors/slack.js +2 -2
- package/dist/connectors/telegram.js +2 -2
- package/dist/{create-ZWHCRT5F.js → create-HP4OVVHF.js} +6 -4
- package/dist/{daemon-client-ODKDUYDE.js → daemon-client-ITWUCNFO.js} +2 -2
- package/dist/{daemon-restart-VRQMZLBK.js → daemon-restart-JMZM3QY4.js} +8 -8
- package/dist/daemon.js +1624 -940
- package/dist/db-5ZVC6MQF.js +10 -0
- package/dist/{delete-6G6WEX4F.js → delete-BSU7K3RY.js} +1 -1
- package/dist/delivery-manager-ISTJMZDW.js +16 -0
- package/dist/down-ZY35KMHR.js +14 -0
- package/dist/{env-6IDWGBUH.js → env-A3LMO777.js} +6 -6
- package/dist/export-GCDNQCF3.js +100 -0
- package/dist/{history-5F4WQW7S.js → history-WNK3DFUM.js} +10 -7
- package/dist/{import-EDGRLIGO.js → import-M63VIUJ5.js} +3 -3
- package/dist/log-PPPZDVEF.js +39 -0
- package/dist/{login-ORQDXLBM.js → login-HNH3EUQV.js} +2 -2
- package/dist/{logout-XC5AUO5I.js → logout-I5CB5UZS.js} +2 -2
- package/dist/{logs-GYOR3L2L.js → logs-SF2IMJN4.js} +6 -6
- package/dist/merge-33C237A4.js +46 -0
- package/dist/{mind-OJN6RBZW.js → mind-PQ5NCPSU.js} +14 -10
- package/dist/mind-manager-RVCFROAY.js +18 -0
- package/dist/{package-4GTJGUXI.js → package-MYE2ZJLV.js} +7 -3
- package/dist/{pages-6IV4VQTU.js → pages-AXCOSY3P.js} +2 -2
- package/dist/{publish-Q4RPSJLL.js → publish-YB377JB7.js} +18 -4
- package/dist/pull-XAEWQJ47.js +39 -0
- package/dist/{register-LDE6LRXY.js → register-VSPCMHKX.js} +2 -2
- package/dist/{restart-YFAWFS5T.js → restart-IQKMCK5M.js} +6 -6
- package/dist/{schedule-AGYLDMNS.js → schedule-LMX7GAQZ.js} +6 -6
- package/dist/schema-5BW7DFZI.js +24 -0
- package/dist/{seed-AP4Q7RZ7.js → seed-J43YDKXG.js} +7 -4
- package/dist/{send-4GKDO26C.js → send-KVIZIGCE.js} +8 -8
- package/dist/{service-U7MZ2H7F.js → service-LUR7WDO7.js} +6 -6
- package/dist/{setup-DJKIZKGW.js → setup-OH3PJUJO.js} +7 -7
- package/dist/shared-KO35ZM44.js +39 -0
- package/dist/skill-BCVNI6TV.js +287 -0
- package/{templates/_base/_skills → dist/skills}/orientation/SKILL.md +1 -1
- package/{templates/_base/_skills → dist/skills}/sessions/SKILL.md +2 -2
- package/{templates/_base/_skills → dist/skills}/volute-mind/SKILL.md +35 -1
- package/dist/{sprout-TJ3BHVOG.js → sprout-VBEX63LX.js} +38 -20
- package/dist/{start-3YYRXBKP.js → start-I5JYB65M.js} +6 -6
- package/dist/{status-VSFZYX7S.js → status-4ESFLGH4.js} +5 -5
- package/dist/status-D7E5HHBV.js +35 -0
- package/dist/{status-OKNA6AR3.js → status-JCJAOXTW.js} +2 -2
- package/dist/{stop-AA5K5LYG.js → stop-NBVKEFQQ.js} +6 -6
- package/dist/{up-LT3X5Q26.js → up-WG65SWJU.js} +5 -5
- package/dist/{update-YAGN5ODG.js → update-FJIHDJKM.js} +5 -5
- package/dist/{update-check-APLTH4IN.js → update-check-MWE5AH4U.js} +2 -2
- package/dist/{upgrade-KXZCQSZN.js → upgrade-AIT24B5I.js} +1 -1
- package/dist/{variant-X5QFG6KK.js → variant-63ZWO2W7.js} +4 -4
- package/dist/variants-JAGWGBXG.js +26 -0
- package/dist/web-assets/assets/index-BAbuRsVF.css +1 -0
- package/dist/web-assets/assets/index-CiQhSKi_.js +63 -0
- package/dist/web-assets/index.html +2 -2
- package/drizzle/0007_system_prompts.sql +5 -0
- package/drizzle/0008_volute_channels.sql +24 -0
- package/drizzle/0009_shared_skills.sql +9 -0
- package/drizzle/0010_delivery_queue.sql +12 -0
- package/drizzle/0011_rename_human_to_brain.sql +1 -0
- package/drizzle/meta/0007_snapshot.json +7 -0
- package/drizzle/meta/0008_snapshot.json +7 -0
- package/drizzle/meta/0009_snapshot.json +7 -0
- package/drizzle/meta/0010_snapshot.json +7 -0
- package/drizzle/meta/0011_snapshot.json +7 -0
- package/drizzle/meta/_journal.json +35 -0
- package/package.json +7 -3
- package/templates/_base/.init/.config/hooks/startup-context.sh +1 -1
- package/templates/_base/.init/.config/prompts.json +5 -0
- package/templates/_base/.init/.config/scripts/session-reader.ts +3 -3
- package/templates/_base/home/VOLUTE.md +16 -1
- package/templates/_base/src/lib/auto-commit.ts +51 -14
- package/templates/_base/src/lib/router.ts +168 -29
- package/templates/_base/src/lib/routing.ts +4 -1
- package/templates/_base/src/lib/startup.ts +43 -0
- package/templates/_base/src/lib/types.ts +4 -0
- package/templates/_base/src/lib/volute-server.ts +91 -2
- package/templates/claude/src/agent.ts +4 -3
- package/templates/claude/src/lib/hooks/reply-instructions.ts +3 -1
- package/templates/claude/src/server.ts +2 -2
- package/templates/claude/volute-template.json +1 -2
- package/templates/pi/src/agent.ts +6 -7
- package/templates/pi/src/lib/reply-instructions-extension.ts +3 -1
- package/templates/pi/src/lib/session-context-extension.ts +2 -2
- package/templates/pi/volute-template.json +1 -2
- package/dist/chunk-PO5Q2AYN.js +0 -121
- package/dist/down-A56B5JLK.js +0 -14
- package/dist/mind-manager-ETNCPQJN.js +0 -15
- package/dist/web-assets/assets/index-BcmT7Qxo.js +0 -63
- package/dist/web-assets/assets/index-DG01TyLb.css +0 -1
- /package/{templates/_base/_skills → dist/skills}/memory/SKILL.md +0 -0
|
@@ -9,17 +9,19 @@ async function run(args) {
|
|
|
9
9
|
const { positional, flags } = parseArgs(args, {
|
|
10
10
|
template: { type: "string" },
|
|
11
11
|
model: { type: "string" },
|
|
12
|
-
description: { type: "string" }
|
|
12
|
+
description: { type: "string" },
|
|
13
|
+
skills: { type: "string" }
|
|
13
14
|
});
|
|
14
15
|
const name = positional[0];
|
|
15
16
|
if (!name) {
|
|
16
17
|
console.error(
|
|
17
|
-
"Usage: volute seed <name> [--template <name>] [--model <model>] [--description <text>]"
|
|
18
|
+
"Usage: volute seed <name> [--template <name>] [--model <model>] [--description <text>] [--skills <list|none>]"
|
|
18
19
|
);
|
|
19
20
|
process.exit(1);
|
|
20
21
|
}
|
|
21
22
|
const template = flags.template ?? "claude";
|
|
22
|
-
const
|
|
23
|
+
const skills = flags.skills === "none" ? [] : flags.skills ? flags.skills.split(",") : void 0;
|
|
24
|
+
const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
|
|
23
25
|
const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
|
|
24
26
|
const client = getClient();
|
|
25
27
|
const createRes = await daemonFetch(urlOf(client.api.minds.$url()), {
|
|
@@ -30,7 +32,8 @@ async function run(args) {
|
|
|
30
32
|
template,
|
|
31
33
|
stage: "seed",
|
|
32
34
|
description: flags.description,
|
|
33
|
-
model: flags.model
|
|
35
|
+
model: flags.model,
|
|
36
|
+
skills
|
|
34
37
|
})
|
|
35
38
|
});
|
|
36
39
|
const createData = await createRes.json();
|
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
import {
|
|
3
|
+
getClient,
|
|
4
|
+
urlOf
|
|
5
|
+
} from "./chunk-4RQBJWQX.js";
|
|
2
6
|
import {
|
|
3
7
|
resolveMindName
|
|
4
8
|
} from "./chunk-NAOW2CLO.js";
|
|
5
9
|
import {
|
|
6
10
|
getChannelDriver
|
|
7
|
-
} from "./chunk-
|
|
11
|
+
} from "./chunk-UJ6GHNR7.js";
|
|
8
12
|
import {
|
|
9
13
|
parseArgs
|
|
10
14
|
} from "./chunk-D424ZQGI.js";
|
|
11
|
-
import "./chunk-
|
|
15
|
+
import "./chunk-RHEGSQFJ.js";
|
|
12
16
|
import {
|
|
13
17
|
daemonFetch
|
|
14
|
-
} from "./chunk-
|
|
18
|
+
} from "./chunk-WC6ZHVRL.js";
|
|
15
19
|
import {
|
|
16
20
|
findMind
|
|
17
|
-
} from "./chunk-
|
|
18
|
-
import {
|
|
19
|
-
getClient,
|
|
20
|
-
urlOf
|
|
21
|
-
} from "./chunk-4RQBJWQX.js";
|
|
21
|
+
} from "./chunk-EBGCNDMM.js";
|
|
22
22
|
import "./chunk-K3NQKI34.js";
|
|
23
23
|
|
|
24
24
|
// src/commands/send.ts
|
|
@@ -4,15 +4,15 @@ import {
|
|
|
4
4
|
LAUNCHD_PLIST_PATH,
|
|
5
5
|
SYSTEM_SERVICE_PATH,
|
|
6
6
|
USER_SYSTEMD_UNIT
|
|
7
|
-
} from "./chunk-
|
|
8
|
-
import {
|
|
9
|
-
resolveVoluteBin
|
|
10
|
-
} from "./chunk-2Y77MCFG.js";
|
|
11
|
-
import "./chunk-ZCEYUUID.js";
|
|
7
|
+
} from "./chunk-32VR2EOH.js";
|
|
12
8
|
import {
|
|
13
9
|
parseArgs
|
|
14
10
|
} from "./chunk-D424ZQGI.js";
|
|
15
|
-
import
|
|
11
|
+
import {
|
|
12
|
+
resolveVoluteBin
|
|
13
|
+
} from "./chunk-DYZGP3EW.js";
|
|
14
|
+
import "./chunk-OGXOMR65.js";
|
|
15
|
+
import "./chunk-EBGCNDMM.js";
|
|
16
16
|
import "./chunk-K3NQKI34.js";
|
|
17
17
|
|
|
18
18
|
// src/commands/service.ts
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
SYSTEM_SERVICE_PATH
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-32VR2EOH.js";
|
|
5
|
+
import {
|
|
6
|
+
parseArgs
|
|
7
|
+
} from "./chunk-D424ZQGI.js";
|
|
5
8
|
import {
|
|
6
9
|
resolveVoluteBin
|
|
7
|
-
} from "./chunk-
|
|
10
|
+
} from "./chunk-DYZGP3EW.js";
|
|
8
11
|
import {
|
|
9
12
|
ensureVoluteGroup
|
|
10
|
-
} from "./chunk-
|
|
11
|
-
import
|
|
12
|
-
parseArgs
|
|
13
|
-
} from "./chunk-D424ZQGI.js";
|
|
14
|
-
import "./chunk-M77QBTEH.js";
|
|
13
|
+
} from "./chunk-OGXOMR65.js";
|
|
14
|
+
import "./chunk-EBGCNDMM.js";
|
|
15
15
|
import "./chunk-K3NQKI34.js";
|
|
16
16
|
|
|
17
17
|
// src/commands/setup.ts
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import "./chunk-K3NQKI34.js";
|
|
3
|
+
|
|
4
|
+
// src/commands/shared.ts
|
|
5
|
+
async function run(args) {
|
|
6
|
+
const subcommand = args[0];
|
|
7
|
+
switch (subcommand) {
|
|
8
|
+
case "merge":
|
|
9
|
+
await import("./merge-33C237A4.js").then((m) => m.run(args.slice(1)));
|
|
10
|
+
break;
|
|
11
|
+
case "pull":
|
|
12
|
+
await import("./pull-XAEWQJ47.js").then((m) => m.run(args.slice(1)));
|
|
13
|
+
break;
|
|
14
|
+
case "log":
|
|
15
|
+
await import("./log-PPPZDVEF.js").then((m) => m.run(args.slice(1)));
|
|
16
|
+
break;
|
|
17
|
+
case "status":
|
|
18
|
+
await import("./status-D7E5HHBV.js").then((m) => m.run(args.slice(1)));
|
|
19
|
+
break;
|
|
20
|
+
case "--help":
|
|
21
|
+
case "-h":
|
|
22
|
+
case void 0:
|
|
23
|
+
printUsage();
|
|
24
|
+
break;
|
|
25
|
+
default:
|
|
26
|
+
printUsage();
|
|
27
|
+
process.exit(1);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
function printUsage() {
|
|
31
|
+
console.log(`Usage:
|
|
32
|
+
volute shared merge "<message>" [--mind <name>] Merge shared changes to main
|
|
33
|
+
volute shared pull [--mind <name>] Pull latest shared changes
|
|
34
|
+
volute shared log [--limit N] [--mind <name>] Show shared repo history
|
|
35
|
+
volute shared status [--mind <name>] Show pending changes diff`);
|
|
36
|
+
}
|
|
37
|
+
export {
|
|
38
|
+
run
|
|
39
|
+
};
|
|
@@ -0,0 +1,287 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import {
|
|
3
|
+
getClient,
|
|
4
|
+
urlOf
|
|
5
|
+
} from "./chunk-4RQBJWQX.js";
|
|
6
|
+
import {
|
|
7
|
+
resolveMindName
|
|
8
|
+
} from "./chunk-NAOW2CLO.js";
|
|
9
|
+
import {
|
|
10
|
+
parseArgs
|
|
11
|
+
} from "./chunk-D424ZQGI.js";
|
|
12
|
+
import {
|
|
13
|
+
daemonFetch
|
|
14
|
+
} from "./chunk-WC6ZHVRL.js";
|
|
15
|
+
import "./chunk-EBGCNDMM.js";
|
|
16
|
+
import "./chunk-K3NQKI34.js";
|
|
17
|
+
|
|
18
|
+
// src/commands/skill.ts
|
|
19
|
+
async function run(args) {
|
|
20
|
+
const subcommand = args[0];
|
|
21
|
+
switch (subcommand) {
|
|
22
|
+
case "list":
|
|
23
|
+
await listSkills(args.slice(1));
|
|
24
|
+
break;
|
|
25
|
+
case "info":
|
|
26
|
+
await infoSkill(args.slice(1));
|
|
27
|
+
break;
|
|
28
|
+
case "install":
|
|
29
|
+
await installSkill(args.slice(1));
|
|
30
|
+
break;
|
|
31
|
+
case "update":
|
|
32
|
+
await updateSkill(args.slice(1));
|
|
33
|
+
break;
|
|
34
|
+
case "publish":
|
|
35
|
+
await publishSkill(args.slice(1));
|
|
36
|
+
break;
|
|
37
|
+
case "remove":
|
|
38
|
+
await removeSkill(args.slice(1));
|
|
39
|
+
break;
|
|
40
|
+
case "uninstall":
|
|
41
|
+
await uninstallSkill(args.slice(1));
|
|
42
|
+
break;
|
|
43
|
+
case "--help":
|
|
44
|
+
case "-h":
|
|
45
|
+
case void 0:
|
|
46
|
+
printUsage();
|
|
47
|
+
break;
|
|
48
|
+
default:
|
|
49
|
+
console.error(`Unknown subcommand: ${subcommand}`);
|
|
50
|
+
printUsage();
|
|
51
|
+
process.exit(1);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
function printUsage() {
|
|
55
|
+
console.log(`Usage:
|
|
56
|
+
volute skill list List shared skills available to install
|
|
57
|
+
volute skill list --mind <name> List installed skills for a mind
|
|
58
|
+
volute skill info <name> Show details of a shared skill
|
|
59
|
+
volute skill install <name> --mind Install a shared skill into a mind
|
|
60
|
+
volute skill update <name> --mind Update an installed skill (3-way merge)
|
|
61
|
+
volute skill update --all --mind Update all installed skills
|
|
62
|
+
volute skill publish <name> --mind Publish a mind's skill to the shared repository
|
|
63
|
+
volute skill remove <name> Remove a shared skill
|
|
64
|
+
volute skill uninstall <name> --mind Uninstall a skill from a mind`);
|
|
65
|
+
}
|
|
66
|
+
async function listSkills(args) {
|
|
67
|
+
const { flags } = parseArgs(args, { mind: { type: "string" } });
|
|
68
|
+
if (flags.mind || process.env.VOLUTE_MIND) {
|
|
69
|
+
const mindName = resolveMindName(flags);
|
|
70
|
+
const client = getClient();
|
|
71
|
+
const url = urlOf(client.api.minds[":name"].skills.$url({ param: { name: mindName } }));
|
|
72
|
+
const res = await daemonFetch(url);
|
|
73
|
+
if (!res.ok) {
|
|
74
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
75
|
+
console.error(`Error: ${body.error}`);
|
|
76
|
+
process.exit(1);
|
|
77
|
+
}
|
|
78
|
+
const skills = await res.json();
|
|
79
|
+
if (skills.length === 0) {
|
|
80
|
+
console.log("No skills installed.");
|
|
81
|
+
return;
|
|
82
|
+
}
|
|
83
|
+
console.log(`Skills for ${mindName}:
|
|
84
|
+
`);
|
|
85
|
+
for (const s of skills) {
|
|
86
|
+
const update = s.updateAvailable ? " (update available)" : "";
|
|
87
|
+
const source = s.upstream ? ` [shared:${s.upstream.source} v${s.upstream.version}]` : "";
|
|
88
|
+
console.log(` ${s.id} \u2014 ${s.name}${source}${update}`);
|
|
89
|
+
}
|
|
90
|
+
} else {
|
|
91
|
+
const client = getClient();
|
|
92
|
+
const url = urlOf(client.api.skills.$url());
|
|
93
|
+
const res = await daemonFetch(url);
|
|
94
|
+
if (!res.ok) {
|
|
95
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
96
|
+
console.error(`Error: ${body.error}`);
|
|
97
|
+
process.exit(1);
|
|
98
|
+
}
|
|
99
|
+
const skills = await res.json();
|
|
100
|
+
if (skills.length === 0) {
|
|
101
|
+
console.log("No shared skills available.");
|
|
102
|
+
return;
|
|
103
|
+
}
|
|
104
|
+
console.log("Shared skills:\n");
|
|
105
|
+
for (const s of skills) {
|
|
106
|
+
console.log(` ${s.id} \u2014 ${s.name} (v${s.version}, by ${s.author})`);
|
|
107
|
+
if (s.description) console.log(` ${s.description}`);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
async function infoSkill(args) {
|
|
112
|
+
const { positional } = parseArgs(args, {});
|
|
113
|
+
const id = positional[0];
|
|
114
|
+
if (!id) {
|
|
115
|
+
console.error("Usage: volute skill info <name>");
|
|
116
|
+
process.exit(1);
|
|
117
|
+
}
|
|
118
|
+
const client = getClient();
|
|
119
|
+
const url = urlOf(client.api.skills[":id"].$url({ param: { id } }));
|
|
120
|
+
const res = await daemonFetch(url);
|
|
121
|
+
if (!res.ok) {
|
|
122
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
123
|
+
console.error(`Error: ${body.error}`);
|
|
124
|
+
process.exit(1);
|
|
125
|
+
}
|
|
126
|
+
const skill = await res.json();
|
|
127
|
+
console.log(`${skill.name} (${skill.id})`);
|
|
128
|
+
console.log(` Version: ${skill.version}`);
|
|
129
|
+
console.log(` Author: ${skill.author}`);
|
|
130
|
+
if (skill.description) console.log(` Description: ${skill.description}`);
|
|
131
|
+
console.log(` Files: ${skill.files.join(", ")}`);
|
|
132
|
+
}
|
|
133
|
+
async function installSkill(args) {
|
|
134
|
+
const { positional, flags } = parseArgs(args, { mind: { type: "string" } });
|
|
135
|
+
const mindName = resolveMindName(flags);
|
|
136
|
+
const skillId = positional[0];
|
|
137
|
+
if (!skillId) {
|
|
138
|
+
console.error("Usage: volute skill install <name> [--mind <name>]");
|
|
139
|
+
process.exit(1);
|
|
140
|
+
}
|
|
141
|
+
const client = getClient();
|
|
142
|
+
const url = urlOf(client.api.minds[":name"].skills.install.$url({ param: { name: mindName } }));
|
|
143
|
+
const res = await daemonFetch(url, {
|
|
144
|
+
method: "POST",
|
|
145
|
+
headers: { "Content-Type": "application/json" },
|
|
146
|
+
body: JSON.stringify({ skillId })
|
|
147
|
+
});
|
|
148
|
+
if (!res.ok) {
|
|
149
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
150
|
+
console.error(`Error: ${body.error}`);
|
|
151
|
+
process.exit(1);
|
|
152
|
+
}
|
|
153
|
+
console.log(`Installed skill "${skillId}" into ${mindName}.`);
|
|
154
|
+
}
|
|
155
|
+
async function updateSkill(args) {
|
|
156
|
+
const { positional, flags } = parseArgs(args, {
|
|
157
|
+
mind: { type: "string" },
|
|
158
|
+
all: { type: "boolean" }
|
|
159
|
+
});
|
|
160
|
+
const mindName = resolveMindName(flags);
|
|
161
|
+
if (flags.all) {
|
|
162
|
+
const client = getClient();
|
|
163
|
+
const listUrl = urlOf(client.api.minds[":name"].skills.$url({ param: { name: mindName } }));
|
|
164
|
+
const listRes = await daemonFetch(listUrl);
|
|
165
|
+
if (!listRes.ok) {
|
|
166
|
+
const body = await listRes.json().catch(() => ({ error: "Unknown error" }));
|
|
167
|
+
console.error(`Error: ${body.error}`);
|
|
168
|
+
process.exit(1);
|
|
169
|
+
}
|
|
170
|
+
const skills = await listRes.json();
|
|
171
|
+
const updatable = skills.filter((s) => s.updateAvailable && s.upstream);
|
|
172
|
+
if (updatable.length === 0) {
|
|
173
|
+
console.log("All skills are up to date.");
|
|
174
|
+
return;
|
|
175
|
+
}
|
|
176
|
+
let failures = 0;
|
|
177
|
+
for (const s of updatable) {
|
|
178
|
+
const ok2 = await doUpdate(mindName, s.id);
|
|
179
|
+
if (!ok2) failures++;
|
|
180
|
+
}
|
|
181
|
+
if (failures > 0) process.exit(1);
|
|
182
|
+
return;
|
|
183
|
+
}
|
|
184
|
+
const skillId = positional[0];
|
|
185
|
+
if (!skillId) {
|
|
186
|
+
console.error("Usage: volute skill update <name> [--mind <name>] [--all]");
|
|
187
|
+
process.exit(1);
|
|
188
|
+
}
|
|
189
|
+
const ok = await doUpdate(mindName, skillId);
|
|
190
|
+
if (!ok) process.exit(1);
|
|
191
|
+
}
|
|
192
|
+
async function doUpdate(mindName, skillId) {
|
|
193
|
+
const client = getClient();
|
|
194
|
+
const url = urlOf(client.api.minds[":name"].skills.update.$url({ param: { name: mindName } }));
|
|
195
|
+
const res = await daemonFetch(url, {
|
|
196
|
+
method: "POST",
|
|
197
|
+
headers: { "Content-Type": "application/json" },
|
|
198
|
+
body: JSON.stringify({ skillId })
|
|
199
|
+
});
|
|
200
|
+
if (!res.ok) {
|
|
201
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
202
|
+
console.error(`Error updating ${skillId}: ${body.error}`);
|
|
203
|
+
return false;
|
|
204
|
+
}
|
|
205
|
+
const result = await res.json();
|
|
206
|
+
switch (result.status) {
|
|
207
|
+
case "up-to-date":
|
|
208
|
+
console.log(`${skillId}: already up to date.`);
|
|
209
|
+
break;
|
|
210
|
+
case "updated":
|
|
211
|
+
console.log(`${skillId}: updated successfully.`);
|
|
212
|
+
break;
|
|
213
|
+
case "conflict":
|
|
214
|
+
console.log(`${skillId}: updated with conflicts in:`);
|
|
215
|
+
for (const f of result.conflictFiles ?? []) {
|
|
216
|
+
console.log(` ${f}`);
|
|
217
|
+
}
|
|
218
|
+
console.log("Resolve conflicts and commit manually.");
|
|
219
|
+
break;
|
|
220
|
+
}
|
|
221
|
+
return true;
|
|
222
|
+
}
|
|
223
|
+
async function publishSkill(args) {
|
|
224
|
+
const { positional, flags } = parseArgs(args, { mind: { type: "string" } });
|
|
225
|
+
const mindName = resolveMindName(flags);
|
|
226
|
+
const skillId = positional[0];
|
|
227
|
+
if (!skillId) {
|
|
228
|
+
console.error("Usage: volute skill publish <name> [--mind <name>]");
|
|
229
|
+
process.exit(1);
|
|
230
|
+
}
|
|
231
|
+
const client = getClient();
|
|
232
|
+
const url = urlOf(client.api.minds[":name"].skills.publish.$url({ param: { name: mindName } }));
|
|
233
|
+
const res = await daemonFetch(url, {
|
|
234
|
+
method: "POST",
|
|
235
|
+
headers: { "Content-Type": "application/json" },
|
|
236
|
+
body: JSON.stringify({ skillId })
|
|
237
|
+
});
|
|
238
|
+
if (!res.ok) {
|
|
239
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
240
|
+
console.error(`Error: ${body.error}`);
|
|
241
|
+
process.exit(1);
|
|
242
|
+
}
|
|
243
|
+
const skill = await res.json();
|
|
244
|
+
console.log(`Published skill "${skillId}" (v${skill.version}).`);
|
|
245
|
+
}
|
|
246
|
+
async function removeSkill(args) {
|
|
247
|
+
const { positional } = parseArgs(args, {});
|
|
248
|
+
const id = positional[0];
|
|
249
|
+
if (!id) {
|
|
250
|
+
console.error("Usage: volute skill remove <name>");
|
|
251
|
+
process.exit(1);
|
|
252
|
+
}
|
|
253
|
+
const client = getClient();
|
|
254
|
+
const url = urlOf(client.api.skills[":id"].$url({ param: { id } }));
|
|
255
|
+
const res = await daemonFetch(url, { method: "DELETE" });
|
|
256
|
+
if (!res.ok) {
|
|
257
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
258
|
+
console.error(`Error: ${body.error}`);
|
|
259
|
+
process.exit(1);
|
|
260
|
+
}
|
|
261
|
+
console.log(`Removed shared skill "${id}".`);
|
|
262
|
+
}
|
|
263
|
+
async function uninstallSkill(args) {
|
|
264
|
+
const { positional, flags } = parseArgs(args, { mind: { type: "string" } });
|
|
265
|
+
const mindName = resolveMindName(flags);
|
|
266
|
+
const skillId = positional[0];
|
|
267
|
+
if (!skillId) {
|
|
268
|
+
console.error("Usage: volute skill uninstall <name> [--mind <name>]");
|
|
269
|
+
process.exit(1);
|
|
270
|
+
}
|
|
271
|
+
const client = getClient();
|
|
272
|
+
const url = urlOf(
|
|
273
|
+
client.api.minds[":name"].skills[":skill"].$url({
|
|
274
|
+
param: { name: mindName, skill: skillId }
|
|
275
|
+
})
|
|
276
|
+
);
|
|
277
|
+
const res = await daemonFetch(url, { method: "DELETE" });
|
|
278
|
+
if (!res.ok) {
|
|
279
|
+
const body = await res.json().catch(() => ({ error: "Unknown error" }));
|
|
280
|
+
console.error(`Error: ${body.error}`);
|
|
281
|
+
process.exit(1);
|
|
282
|
+
}
|
|
283
|
+
console.log(`Uninstalled skill "${skillId}" from ${mindName}.`);
|
|
284
|
+
}
|
|
285
|
+
export {
|
|
286
|
+
run
|
|
287
|
+
};
|
|
@@ -47,7 +47,7 @@ After sprouting, you'll have full mind capabilities (connectors, schedules, vari
|
|
|
47
47
|
|
|
48
48
|
| Command | Purpose |
|
|
49
49
|
|---------|---------|
|
|
50
|
-
| `volute send @<name> "msg"` | Send a message to
|
|
50
|
+
| `volute send @<name> "msg"` | Send a message to another user |
|
|
51
51
|
| `volute sprout` | Complete orientation and become a full mind |
|
|
52
52
|
|
|
53
53
|
## Files
|
|
@@ -16,8 +16,8 @@ When a message arrives, you automatically receive a brief summary of new activit
|
|
|
16
16
|
To see which sessions are active:
|
|
17
17
|
|
|
18
18
|
```sh
|
|
19
|
-
ls ../.
|
|
20
|
-
ls ../.
|
|
19
|
+
ls ../.mind/sessions/ # claude template
|
|
20
|
+
ls ../.mind/pi-sessions/ # pi template
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
## Reading a Session Log
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: Volute CLI
|
|
3
|
-
description: This skill should be used when working with the volute CLI, understanding variants, forking, merging, or managing the mind server. Also covers routing config, batch settings, channel gating, and
|
|
3
|
+
description: This skill should be used when working with the volute CLI, understanding variants, forking, merging, or managing the mind server. Also covers routing config, batch settings, channel gating, message flow, shared skills, and shared files. Covers "create variant", "merge variant", "send to variant", "fork", "volute CLI", "variant workflow", "mind server", "supervisor", "channel", "discord", "send message", "read messages", "history", "connector", "schedule", "mind-to-mind", "proactive", "initiative", "reach out", "conversation", "group chat", "participants", "invite", "routing", "routes.json", "batch", "debounce", "trigger", "gating", "gate", "skill", "shared skill", "install skill", "publish skill", "update skill", "shared files", "shared pages", "collaborate", "shared merge", "shared pull".
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Self-Management
|
|
@@ -32,6 +32,10 @@ You manage yourself through the `volute` CLI. Your mind name is auto-detected vi
|
|
|
32
32
|
| `volute schedule add --cron "..." --message "..."` | Schedule a recurring message to yourself |
|
|
33
33
|
| `volute schedule list` | List your schedules |
|
|
34
34
|
| `volute schedule remove --id <id>` | Remove a schedule |
|
|
35
|
+
| `volute shared status` | See your pending changes vs main |
|
|
36
|
+
| `volute shared merge "<message>"` | Share your changes with all minds |
|
|
37
|
+
| `volute shared pull` | Get latest shared changes from other minds |
|
|
38
|
+
| `volute shared log [--limit N]` | View recent shared history |
|
|
35
39
|
|
|
36
40
|
## Schedules
|
|
37
41
|
|
|
@@ -100,6 +104,36 @@ After a merge, you receive orientation context about what changed. Update your m
|
|
|
100
104
|
|
|
101
105
|
Create skills by writing `.claude/skills/<name>/SKILL.md` files in your `home/` directory. These are automatically available in your sessions.
|
|
102
106
|
|
|
107
|
+
## Shared Skills
|
|
108
|
+
|
|
109
|
+
Your system has a shared skill repository that all minds can browse and install from.
|
|
110
|
+
|
|
111
|
+
| Command | Purpose |
|
|
112
|
+
|---------|---------|
|
|
113
|
+
| `volute skill list` | List shared skills available to install |
|
|
114
|
+
| `volute skill list --mind` | List your installed skills with update status |
|
|
115
|
+
| `volute skill install <name>` | Install a shared skill |
|
|
116
|
+
| `volute skill update <name>` | Update an installed skill (3-way merge preserves your changes) |
|
|
117
|
+
| `volute skill update --all` | Update all installed skills |
|
|
118
|
+
| `volute skill publish <name>` | Publish one of your skills to the shared repository |
|
|
119
|
+
| `volute skill uninstall <name>` | Remove an installed skill |
|
|
120
|
+
|
|
121
|
+
When you install a skill, it's copied to your skills directory. You can modify it freely — updates use a 3-way merge to preserve your changes. If there are merge conflicts, resolve them like any git conflict.
|
|
122
|
+
|
|
123
|
+
## Shared Files
|
|
124
|
+
|
|
125
|
+
Your `shared/` directory is a collaborative space backed by git. Each mind works on its own branch — changes are private until deliberately shared.
|
|
126
|
+
|
|
127
|
+
**Workflow:**
|
|
128
|
+
1. Edit files in `shared/` normally — auto-commit saves changes to your branch
|
|
129
|
+
2. `volute shared status` — see what you've changed compared to main
|
|
130
|
+
3. `volute shared merge "description"` — squash-merge your changes to main
|
|
131
|
+
4. `volute shared pull` — rebase your branch onto latest main to get others' changes
|
|
132
|
+
|
|
133
|
+
**Conflicts:** If your merge fails due to conflicts, pull the latest (`volute shared pull`), reconcile the conflicting files, and merge again. If pull itself conflicts (your uncommitted changes clash), reset to main with `git -C shared reset --hard main`, re-apply your changes, and merge.
|
|
134
|
+
|
|
135
|
+
**Shared pages:** The `shared/pages/` directory is the system-level website. Any mind can contribute. Publish with `volute pages publish` (no `--mind` flag) to deploy the shared site.
|
|
136
|
+
|
|
103
137
|
## MCP Configuration
|
|
104
138
|
|
|
105
139
|
Edit `home/.mcp.json` to configure MCP servers for your SDK session. This gives you access to additional tools and services.
|
|
@@ -1,16 +1,23 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
STANDARD_SKILLS,
|
|
4
|
+
getSharedSkill,
|
|
5
|
+
installSkill,
|
|
6
|
+
uninstallSkill
|
|
7
|
+
} from "./chunk-OTWLI7F4.js";
|
|
8
|
+
import "./chunk-YUIHSKR6.js";
|
|
9
|
+
import "./chunk-Z524RFCJ.js";
|
|
10
|
+
import "./chunk-VQWDC6UK.js";
|
|
11
|
+
import "./chunk-DYZGP3EW.js";
|
|
12
|
+
import "./chunk-OGXOMR65.js";
|
|
6
13
|
import {
|
|
7
14
|
findMind,
|
|
8
15
|
mindDir
|
|
9
|
-
} from "./chunk-
|
|
16
|
+
} from "./chunk-EBGCNDMM.js";
|
|
10
17
|
import "./chunk-K3NQKI34.js";
|
|
11
18
|
|
|
12
19
|
// src/commands/sprout.ts
|
|
13
|
-
import {
|
|
20
|
+
import { existsSync, readFileSync } from "fs";
|
|
14
21
|
import { resolve } from "path";
|
|
15
22
|
var ORIENTATION_MARKER = "You don't have a soul yet";
|
|
16
23
|
async function run(_args) {
|
|
@@ -46,25 +53,36 @@ async function run(_args) {
|
|
|
46
53
|
console.error("Write your MEMORY.md before sprouting.");
|
|
47
54
|
process.exit(1);
|
|
48
55
|
}
|
|
49
|
-
const
|
|
50
|
-
const
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
56
|
+
const failedSkills = [];
|
|
57
|
+
for (const skillId of STANDARD_SKILLS) {
|
|
58
|
+
const shared = await getSharedSkill(skillId);
|
|
59
|
+
if (!shared) {
|
|
60
|
+
console.error(`Shared skill not found: ${skillId} \u2014 run 'volute up' to sync built-in skills`);
|
|
61
|
+
failedSkills.push(skillId);
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
const skillDir = resolve(dir, "home", ".claude", "skills", skillId);
|
|
65
|
+
if (!existsSync(skillDir)) {
|
|
66
|
+
try {
|
|
67
|
+
await installSkill(mindName, dir, skillId);
|
|
68
|
+
} catch (err) {
|
|
69
|
+
console.error(`Failed to install skill ${skillId}: ${err.message}`);
|
|
70
|
+
failedSkills.push(skillId);
|
|
58
71
|
}
|
|
59
72
|
}
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
73
|
+
}
|
|
74
|
+
const orientationDir = resolve(dir, "home", ".claude", "skills", "orientation");
|
|
75
|
+
if (existsSync(orientationDir)) {
|
|
76
|
+
try {
|
|
77
|
+
await uninstallSkill(mindName, dir, "orientation");
|
|
78
|
+
} catch (err) {
|
|
79
|
+
console.error(`Failed to uninstall orientation skill: ${err.message}`);
|
|
63
80
|
}
|
|
64
|
-
} finally {
|
|
65
|
-
rmSync(composedDir, { recursive: true, force: true });
|
|
66
81
|
}
|
|
67
|
-
|
|
82
|
+
if (failedSkills.length > 0) {
|
|
83
|
+
console.error(`Warning: failed to install skills: ${failedSkills.join(", ")}`);
|
|
84
|
+
}
|
|
85
|
+
const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
|
|
68
86
|
const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
|
|
69
87
|
const client = getClient();
|
|
70
88
|
const sproutRes = await daemonFetch(
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import {
|
|
3
|
-
daemonFetch
|
|
4
|
-
} from "./chunk-OJQ47SCA.js";
|
|
5
|
-
import {
|
|
6
|
-
resolveMind
|
|
7
|
-
} from "./chunk-M77QBTEH.js";
|
|
8
2
|
import {
|
|
9
3
|
getClient,
|
|
10
4
|
urlOf
|
|
11
5
|
} from "./chunk-4RQBJWQX.js";
|
|
6
|
+
import {
|
|
7
|
+
daemonFetch
|
|
8
|
+
} from "./chunk-WC6ZHVRL.js";
|
|
9
|
+
import {
|
|
10
|
+
resolveMind
|
|
11
|
+
} from "./chunk-EBGCNDMM.js";
|
|
12
12
|
import "./chunk-K3NQKI34.js";
|
|
13
13
|
|
|
14
14
|
// src/commands/start.ts
|
|
@@ -4,13 +4,13 @@ import {
|
|
|
4
4
|
getServiceMode,
|
|
5
5
|
modeLabel,
|
|
6
6
|
readDaemonConfig
|
|
7
|
-
} from "./chunk-
|
|
8
|
-
import "./chunk-
|
|
9
|
-
import "./chunk-
|
|
7
|
+
} from "./chunk-32VR2EOH.js";
|
|
8
|
+
import "./chunk-DYZGP3EW.js";
|
|
9
|
+
import "./chunk-OGXOMR65.js";
|
|
10
10
|
import {
|
|
11
11
|
checkForUpdate
|
|
12
|
-
} from "./chunk-
|
|
13
|
-
import "./chunk-
|
|
12
|
+
} from "./chunk-SCUDS4US.js";
|
|
13
|
+
import "./chunk-EBGCNDMM.js";
|
|
14
14
|
import "./chunk-K3NQKI34.js";
|
|
15
15
|
|
|
16
16
|
// src/commands/status.ts
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import {
|
|
3
|
+
resolveMindName
|
|
4
|
+
} from "./chunk-NAOW2CLO.js";
|
|
5
|
+
import {
|
|
6
|
+
parseArgs
|
|
7
|
+
} from "./chunk-D424ZQGI.js";
|
|
8
|
+
import {
|
|
9
|
+
daemonFetch
|
|
10
|
+
} from "./chunk-WC6ZHVRL.js";
|
|
11
|
+
import "./chunk-EBGCNDMM.js";
|
|
12
|
+
import "./chunk-K3NQKI34.js";
|
|
13
|
+
|
|
14
|
+
// src/commands/shared/status.ts
|
|
15
|
+
async function run(args) {
|
|
16
|
+
const { flags } = parseArgs(args, {
|
|
17
|
+
mind: { type: "string" }
|
|
18
|
+
});
|
|
19
|
+
const mindName = resolveMindName(flags);
|
|
20
|
+
const res = await daemonFetch(`/api/minds/${encodeURIComponent(mindName)}/shared/status`);
|
|
21
|
+
if (!res.ok) {
|
|
22
|
+
const body = await res.json().catch(() => ({}));
|
|
23
|
+
console.error(body.error ?? `Server responded with ${res.status}`);
|
|
24
|
+
process.exit(1);
|
|
25
|
+
}
|
|
26
|
+
const output = await res.text();
|
|
27
|
+
if (output.trim()) {
|
|
28
|
+
console.log(output.trimEnd());
|
|
29
|
+
} else {
|
|
30
|
+
console.log("No pending changes.");
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
export {
|
|
34
|
+
run
|
|
35
|
+
};
|