larkin 0.4.29 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +5 -9
  3. package/artifacts/release/THIRD_PARTY_NOTICES.txt +751 -4425
  4. package/dist/app/agent-cli.mjs +14 -2
  5. package/dist/app/agent-config.mjs +26 -86
  6. package/dist/app/binary-entry.mjs +0 -20
  7. package/dist/app/cli.mjs +6 -22
  8. package/dist/app/internal-command.cjs +0 -2
  9. package/dist/app/internal-command.mjs +0 -2
  10. package/dist/app/runtime-model-directory.mjs +2 -16
  11. package/dist/app/runtime-process.mjs +0 -1
  12. package/dist/app/setup.mjs +52 -57
  13. package/dist/dashboard/dashboard-config-controller.mjs +43 -109
  14. package/dist/dashboard/dashboard-view-model.mjs +4 -7
  15. package/dist/dashboard/web/assets/dashboard.css +1 -1
  16. package/dist/dashboard/web/assets/dashboard.js +15 -15
  17. package/dist/feishu/host-shell.cjs +1 -2
  18. package/dist/feishu/host-shell.mjs +1 -2
  19. package/dist/platform/config.cjs +168 -133
  20. package/dist/platform/config.mjs +168 -133
  21. package/dist/runtime/pi-artifact-provenance.mjs +3 -3
  22. package/dist/runtime/pi-bash-timeout-extension.mjs +4 -5
  23. package/dist/runtime/pi-compaction-recovery.cjs +45 -15
  24. package/dist/runtime/pi-compaction-recovery.mjs +43 -14
  25. package/dist/runtime/pi-extension-api.mjs +1 -0
  26. package/dist/runtime/pi-model-catalog.cjs +7 -8
  27. package/dist/runtime/pi-model-catalog.mjs +7 -8
  28. package/dist/runtime/pi-subagent-injection.mjs +17 -4
  29. package/dist/runtime/runtime-adapters.mjs +26 -43
  30. package/dist/runtime/runtime-host.cjs +21 -43
  31. package/dist/runtime/runtime-host.mjs +22 -44
  32. package/dist/runtime/runtime-model-catalog.cjs +1 -1
  33. package/dist/runtime/runtime-model-catalog.mjs +1 -1
  34. package/dist/runtime/runtime-readiness.cjs +62 -98
  35. package/dist/runtime/runtime-readiness.mjs +60 -97
  36. package/dist/runtime/user-runtime.cjs +7 -24
  37. package/dist/runtime/user-runtime.mjs +7 -23
  38. package/dist/setup/bot-register.mjs +15 -123
  39. package/dist/setup/setup-agent-choice.mjs +48 -74
  40. package/dist/setup/setup-bind.mjs +51 -151
  41. package/dist/setup/setup-binding.mjs +6 -9
  42. package/package.json +3 -2
  43. package/dist/app/pi-auth-cli.mjs +0 -277
  44. package/dist/platform/process-boundary-trace.cjs +0 -108
  45. package/dist/runtime/builtin-pi-assets.cjs +0 -117
  46. package/dist/runtime/builtin-pi-assets.mjs +0 -105
  47. package/dist/runtime/pi-artifact-provenance.cjs +0 -147
  48. package/dist/runtime/pi-distribution-label.cjs +0 -6
  49. package/dist/runtime/pi-distribution-label.mjs +0 -3
  50. package/dist/runtime/pi-inline-extensions.mjs +0 -78
  51. package/dist/runtime/pi-official-auth.cjs +0 -594
  52. package/dist/runtime/pi-official-auth.mjs +0 -544
  53. package/dist/runtime/pi-profile-migration.cjs +0 -764
  54. package/dist/runtime/pi-profile-migration.mjs +0 -719
  55. package/dist/runtime/pi-provider-config.cjs +0 -354
  56. package/dist/runtime/pi-provider-config.mjs +0 -334
  57. package/dist/runtime/pi-provider-login.mjs +0 -240
@@ -1,147 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.PI_RUNTIME_ARTIFACT_NAMES = exports.PI_RUNTIME_ARTIFACT_MANIFEST = void 0;
7
- exports.recordPiRuntimeArtifactProvenance = recordPiRuntimeArtifactProvenance;
8
- exports.attestedPiRuntimeArtifactNames = attestedPiRuntimeArtifactNames;
9
- const node_crypto_1 = __importDefault(require("node:crypto"));
10
- const node_fs_1 = __importDefault(require("node:fs"));
11
- const node_path_1 = __importDefault(require("node:path"));
12
- const secure_metadata_js_1 = require("../platform/secure-metadata.cjs");
13
- exports.PI_RUNTIME_ARTIFACT_MANIFEST = ".larkin-pi-owned-artifacts.json";
14
- exports.PI_RUNTIME_ARTIFACT_NAMES = [".larkin-official-pi-package", "models-store.json", "npm"];
15
- const MAX_FILE_BYTES = 256 * 1024 * 1024;
16
- const MAX_ENTRIES = 4096;
17
- function digest(value) {
18
- return node_crypto_1.default.createHash("sha256").update(value).digest("hex");
19
- }
20
- function assertSafeEntry(file, label) {
21
- const stat = node_fs_1.default.lstatSync(file);
22
- if (stat.isSymbolicLink())
23
- throw new Error(`${label} must not be a symlink`);
24
- if (typeof process.getuid === "function" && stat.uid !== process.getuid())
25
- throw new Error(`${label} owner is unsafe`);
26
- return stat;
27
- }
28
- function identity(file, label) {
29
- const stat = assertSafeEntry(file, label);
30
- const mode = stat.mode & 0o777;
31
- if (stat.isFile()) {
32
- if (stat.size > MAX_FILE_BYTES)
33
- throw new Error(`${label} is too large`);
34
- const bytes = node_fs_1.default.readFileSync(file);
35
- return { kind: "file", mode, device: String(stat.dev), inode: String(stat.ino), bytes: bytes.length, digest: digest(bytes) };
36
- }
37
- if (!stat.isDirectory())
38
- throw new Error(`${label} has an unsupported type`);
39
- const entries = node_fs_1.default.readdirSync(file).sort();
40
- if (entries.length > MAX_ENTRIES)
41
- throw new Error(`${label} has too many entries`);
42
- const children = entries.map((name) => {
43
- if (name === "." || name === ".." || name.includes("/"))
44
- throw new Error(`${label} contains an unsafe entry`);
45
- const child = identity(node_path_1.default.join(file, name), `${label} child`);
46
- return [name, child.kind, child.mode, child.device, child.inode, child.bytes, child.digest];
47
- });
48
- return {
49
- kind: "directory", mode, device: String(stat.dev), inode: String(stat.ino),
50
- bytes: children.reduce((sum, child) => sum + Number(child[5]), 0), digest: digest(JSON.stringify(children)),
51
- };
52
- }
53
- function sameIdentity(actual, expected) {
54
- return actual.kind === expected.kind && actual.mode === expected.mode
55
- && actual.device === expected.device && actual.inode === expected.inode
56
- && actual.bytes === expected.bytes && actual.digest === expected.digest;
57
- }
58
- function readManifest(file) {
59
- try {
60
- const stat = assertSafeEntry(file, "Pi artifact provenance manifest");
61
- if (!stat.isFile() || !(0, secure_metadata_js_1.exactMode)(stat, 0o600) || stat.size > 1024 * 1024)
62
- throw new Error("Pi artifact provenance manifest is unsafe");
63
- const value = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
64
- if (value?.version !== 1 || value.owner !== "larkin-builtin-pi" || !value.directory || !value.artifacts)
65
- throw new Error("Pi artifact provenance manifest is invalid");
66
- return value;
67
- }
68
- catch (error) {
69
- if (error.code === "ENOENT")
70
- return null;
71
- throw error;
72
- }
73
- }
74
- function writeManifest(file, value) {
75
- const temp = `${file}.tmp-${process.pid}`;
76
- const fd = node_fs_1.default.openSync(temp, "wx", 0o600);
77
- try {
78
- node_fs_1.default.writeFileSync(fd, `${JSON.stringify(value, null, 2)}\n`);
79
- node_fs_1.default.fsyncSync(fd);
80
- }
81
- finally {
82
- node_fs_1.default.closeSync(fd);
83
- }
84
- node_fs_1.default.renameSync(temp, file);
85
- }
86
- /** Record only allowed entries that were absent at the runtime spawn boundary. */
87
- function recordPiRuntimeArtifactProvenance(targetDir, beforeEntries, boundaryAt = Date.now()) {
88
- const target = assertSafeEntry(targetDir, "Pi provider target");
89
- if (!target.isDirectory() || !(0, secure_metadata_js_1.exactMode)(target, 0o700))
90
- throw new Error("Pi provider target is unsafe");
91
- const manifestFile = node_path_1.default.join(targetDir, exports.PI_RUNTIME_ARTIFACT_MANIFEST);
92
- const existing = readManifest(manifestFile);
93
- const manifest = existing ?? {
94
- version: 1, owner: "larkin-builtin-pi", directory: { device: String(target.dev), inode: String(target.ino) },
95
- recordedAt: new Date(boundaryAt).toISOString(), artifacts: {},
96
- };
97
- if (manifest.directory.device !== String(target.dev) || manifest.directory.inode !== String(target.ino))
98
- throw new Error("Pi artifact provenance target identity changed");
99
- let changed = false;
100
- for (const [name, expected] of Object.entries(manifest.artifacts)) {
101
- if (!exports.PI_RUNTIME_ARTIFACT_NAMES.includes(name) || name.includes("/") || !expected)
102
- throw new Error("Pi artifact provenance entry is invalid");
103
- const actual = identity(node_path_1.default.join(targetDir, name), `Pi artifact ${name}`);
104
- const sameOwner = actual.kind === expected.kind && actual.mode === expected.mode
105
- && actual.device === expected.device && actual.inode === expected.inode;
106
- if (!sameOwner)
107
- throw new Error(`Pi artifact ${name} provenance identity changed`);
108
- if (!sameIdentity(actual, expected)) {
109
- manifest.artifacts[name] = actual;
110
- changed = true;
111
- }
112
- }
113
- for (const name of exports.PI_RUNTIME_ARTIFACT_NAMES) {
114
- if (beforeEntries.has(name) || manifest.artifacts[name])
115
- continue;
116
- const file = node_path_1.default.join(targetDir, name);
117
- if (!node_fs_1.default.existsSync(file))
118
- continue;
119
- const actual = identity(file, `Pi artifact ${name}`);
120
- const stat = node_fs_1.default.lstatSync(file);
121
- if (stat.birthtimeMs + 1 < boundaryAt && stat.mtimeMs + 1 < boundaryAt)
122
- throw new Error(`Pi artifact ${name} predates runtime provenance boundary`);
123
- manifest.artifacts[name] = actual;
124
- changed = true;
125
- }
126
- if (changed)
127
- writeManifest(manifestFile, manifest);
128
- }
129
- /** Return the names that are both explicitly attested and unchanged. */
130
- function attestedPiRuntimeArtifactNames(targetDir) {
131
- const target = assertSafeEntry(targetDir, "Pi provider target");
132
- if (!target.isDirectory())
133
- throw new Error("Pi provider target is unsafe");
134
- const manifest = readManifest(node_path_1.default.join(targetDir, exports.PI_RUNTIME_ARTIFACT_MANIFEST));
135
- if (!manifest || manifest.directory.device !== String(target.dev) || manifest.directory.inode !== String(target.ino))
136
- return new Set();
137
- const names = new Set();
138
- for (const [name, expected] of Object.entries(manifest.artifacts)) {
139
- if (!exports.PI_RUNTIME_ARTIFACT_NAMES.includes(name) || !expected)
140
- continue;
141
- const actual = identity(node_path_1.default.join(targetDir, name), `Pi artifact ${name}`);
142
- if (!sameIdentity(actual, expected))
143
- throw new Error(`Pi artifact ${name} provenance changed`);
144
- names.add(name);
145
- }
146
- return names;
147
- }
@@ -1,6 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.piDistributionLabel = piDistributionLabel;
4
- function piDistributionLabel(distribution) {
5
- return distribution === "builtin" ? "内置 Pi" : "用户安装的 Pi";
6
- }
@@ -1,3 +0,0 @@
1
- export function piDistributionLabel(distribution) {
2
- return distribution === "builtin" ? "内置 Pi" : "用户安装的 Pi";
3
- }
@@ -1,78 +0,0 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
- import { pathToFileURL } from "node:url";
4
- import bashTimeoutExtension from "./pi-bash-timeout-extension.mjs";
5
- import { bundledPiSubagentExtensionPath, materializeEmbeddedPiSubagentBundle } from "./pi-subagent-injection.mjs";
6
- import piSubagentRecordWatchdog from "./pi-subagent-record-watchdog.mjs";
7
- /**
8
- * Load the prebuilt, patched subagent bundle shipped in dist/ rather than the
9
- * package-manager copy. Standalone binaries additionally load the patched
10
- * package through Bun's compiled module graph, while normal package installs
11
- * continue to use the prebuilt patched bundle.
12
- */
13
- async function loadBundledPiSubagentExtension() {
14
- // Compiled standalone already has the patched package in Bun's module graph.
15
- // The materialized sibling bundle externalizes @earendil-works/pi-coding-agent
16
- // and cannot be imported from LARKIN_CONFIG_DIR.
17
- const compiled = globalThis.__LARKIN_COMPILED_PI_SUBAGENTS__;
18
- if (compiled) {
19
- if (typeof compiled !== "function" && typeof compiled.factory !== "function") {
20
- throw new Error("Larkin compiled pi-subagents factory is missing; refusing to start builtin Pi");
21
- }
22
- return compiled;
23
- }
24
- const bundle = bundledPiSubagentExtensionPath(process.env.LARKIN_CONFIG_DIR);
25
- if (!bundle)
26
- throw new Error("Larkin bounded pi-subagents bundle is unavailable; refusing to start builtin Pi");
27
- const loaded = await import(pathToFileURL(bundle).href);
28
- if (!loaded.default)
29
- throw new Error("Larkin bounded pi-subagents bundle is invalid; refusing to start builtin Pi");
30
- return loaded.default;
31
- }
32
- function asFn(mod, name) {
33
- if (typeof mod === "function")
34
- return mod;
35
- const fallback = mod?.default;
36
- if (typeof fallback === "function")
37
- return fallback;
38
- throw new Error(`${name} extension factory is missing`);
39
- }
40
- function wrapFactory(name, factory) {
41
- return async (pi) => {
42
- try {
43
- await factory(pi);
44
- }
45
- catch (error) {
46
- throw error instanceof Error ? error : new Error(`${name}: ${String(error)}`);
47
- }
48
- };
49
- }
50
- /** Builtin Pi extensions are loaded as code, never through Pi's path/data-URL loader. */
51
- const bundledSubagentsExtension = async (pi) => {
52
- const extension = await loadBundledPiSubagentExtension();
53
- if (typeof extension === "function")
54
- await extension(pi);
55
- else
56
- await extension.factory(pi);
57
- };
58
- // Watchdog must register session_shutdown before the bundled subagent extension
59
- // so the final sweep can still read AgentManager.getRecord and bridge consumed
60
- // terminals before manager teardown.
61
- export const BUILTIN_PI_EXTENSION_FACTORIES = Object.freeze([
62
- wrapFactory("larkin-pi-subagent-watchdog", asFn(piSubagentRecordWatchdog, "larkin-pi-subagent-watchdog")),
63
- wrapFactory("larkin-pi-subagents", bundledSubagentsExtension),
64
- wrapFactory("larkin-pi-bash-timeout", asFn(bashTimeoutExtension, "larkin-pi-bash-timeout")),
65
- ]);
66
- /** Invoke Pi RPC with Larkin's builtin-only extension factories. */
67
- export async function invokeBuiltinPiRpc(piMain, rest) {
68
- if (globalThis.__LARKIN_EMBEDDED_PI_SUBAGENTS_BUNDLE__ && process.env.LARKIN_CONFIG_DIR) {
69
- const materialized = materializeEmbeddedPiSubagentBundle(process.env.LARKIN_CONFIG_DIR);
70
- if (!materialized)
71
- throw new Error("standalone pi-subagents bundle failed to materialize");
72
- const supervised = path.join(path.dirname(materialized), "pi-supervised-command.bundle.js");
73
- process.env.LARKIN_PI_SUPERVISED_BUNDLE = fs.realpathSync(supervised);
74
- }
75
- await piMain(["--mode", "rpc", ...rest], {
76
- extensionFactories: [...BUILTIN_PI_EXTENSION_FACTORIES],
77
- });
78
- }