@anhlp/alp-cli 0.0.1-beta.4 → 0.0.1-beta.6
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/THIRD-PARTY-NOTICES.txt +26 -1
- package/dist/acp/main.js +1 -1
- package/dist/acp.js +267 -92
- package/dist/alp-web/THIRD-PARTY-NOTICES.txt +666 -0
- package/dist/alp-web/alp-boundary.json +1 -0
- package/dist/alp-web/assets/TerminalPanel-CqTsgY-W.js +22 -0
- package/dist/alp-web/assets/highlighter-BnicKQ_d.js +18 -0
- package/dist/alp-web/assets/index-BMbDUCHW.css +1 -0
- package/dist/alp-web/assets/index-B_RFaj2C.js +59 -0
- package/dist/alp-web/index.html +2 -2
- package/dist/alp-web.js +666 -187
- package/dist/alpd.js +10768 -2592
- package/dist/backup.js +1 -1
- package/dist/build-manifest.json +22 -2
- package/dist/cli.js +32 -3
- package/dist/daemon.d.ts +1 -1
- package/dist/daemon.js +5 -0
- package/dist/interfaces.d.ts +13 -1
- package/dist/interfaces.js +96 -11
- package/dist/paths.d.ts +1 -0
- package/dist/paths.js +2 -1
- package/dist/roles.d.ts +15 -0
- package/dist/roles.js +18 -0
- package/dist/self-update.d.ts +152 -0
- package/dist/self-update.js +390 -0
- package/dist/sessions.d.ts +4 -0
- package/dist/sessions.js +22 -1
- package/dist/tasks.js +22 -8
- package/dist/terminal-native/README.md +201 -0
- package/dist/terminal-native/prebuilt/darwin-arm64/manifest.json +11 -0
- package/dist/terminal-native/prebuilt/darwin-arm64/terminal-owner +0 -0
- package/dist/terminal-native/prebuilt/darwin-x64/manifest.json +11 -0
- package/dist/terminal-native/prebuilt/darwin-x64/terminal-owner +0 -0
- package/dist/terminal-native/prebuilt/linux-arm64-glibc/manifest.json +10 -0
- package/dist/terminal-native/prebuilt/linux-arm64-glibc/terminal-owner +0 -0
- package/dist/terminal-native/prebuilt/linux-arm64-musl/manifest.json +10 -0
- package/dist/terminal-native/prebuilt/linux-arm64-musl/terminal-owner +0 -0
- package/dist/terminal-native/prebuilt/linux-x64-glibc/manifest.json +10 -0
- package/dist/terminal-native/prebuilt/linux-x64-glibc/terminal-owner +0 -0
- package/dist/terminal-native/prebuilt/linux-x64-musl/manifest.json +10 -0
- package/dist/terminal-native/prebuilt/linux-x64-musl/terminal-owner +0 -0
- package/dist/terminal-native/terminal-owner.c +389 -0
- package/dist/terminal.d.ts +5 -0
- package/dist/terminal.js +4 -3
- package/dist/usage.d.ts +1 -1
- package/dist/usage.js +14 -5
- package/dist/web-service.d.ts +22 -4
- package/dist/web-service.js +33 -9
- package/package.json +6 -5
- package/src/cli.js +38 -4
- package/src/daemon.js +3 -0
- package/src/interfaces.js +102 -12
- package/src/paths.js +3 -1
- package/src/roles.js +28 -0
- package/src/self-update.js +406 -0
- package/src/sessions.js +23 -2
- package/src/tasks.js +22 -8
- package/src/terminal.js +4 -3
- package/src/usage.js +14 -5
- package/src/web-service.js +58 -14
- package/dist/alp-web/assets/TerminalPanel-PrU2l3u5.js +0 -16
- package/dist/alp-web/assets/index-BJdBTDFX.css +0 -1
- package/dist/alp-web/assets/index-DpfiPv5s.js +0 -52
- package/src/web/grant.js +0 -204
- package/src/web/main.js +0 -285
- package/src/web/serve.js +0 -144
package/dist/alp-web.js
CHANGED
|
@@ -2271,7 +2271,7 @@ var require_websocket = __commonJS({
|
|
|
2271
2271
|
var http2 = __require("http");
|
|
2272
2272
|
var net2 = __require("net");
|
|
2273
2273
|
var tls = __require("tls");
|
|
2274
|
-
var { randomBytes: randomBytes6, createHash:
|
|
2274
|
+
var { randomBytes: randomBytes6, createHash: createHash7 } = __require("crypto");
|
|
2275
2275
|
var { Duplex, Readable } = __require("stream");
|
|
2276
2276
|
var { URL: URL2 } = __require("url");
|
|
2277
2277
|
var PerMessageDeflate2 = require_permessage_deflate();
|
|
@@ -2952,7 +2952,7 @@ var require_websocket = __commonJS({
|
|
|
2952
2952
|
abortHandshake(websocket, socket, "Invalid Upgrade header");
|
|
2953
2953
|
return;
|
|
2954
2954
|
}
|
|
2955
|
-
const digest2 =
|
|
2955
|
+
const digest2 = createHash7("sha1").update(key2 + GUID).digest("base64");
|
|
2956
2956
|
if (res.headers["sec-websocket-accept"] !== digest2) {
|
|
2957
2957
|
abortHandshake(websocket, socket, "Invalid Sec-WebSocket-Accept header");
|
|
2958
2958
|
return;
|
|
@@ -3321,7 +3321,7 @@ var require_websocket_server = __commonJS({
|
|
|
3321
3321
|
var EventEmitter = __require("events");
|
|
3322
3322
|
var http2 = __require("http");
|
|
3323
3323
|
var { Duplex } = __require("stream");
|
|
3324
|
-
var { createHash:
|
|
3324
|
+
var { createHash: createHash7 } = __require("crypto");
|
|
3325
3325
|
var extension2 = require_extension();
|
|
3326
3326
|
var PerMessageDeflate2 = require_permessage_deflate();
|
|
3327
3327
|
var subprotocol2 = require_subprotocol();
|
|
@@ -3587,8 +3587,8 @@ var require_websocket_server = __commonJS({
|
|
|
3587
3587
|
req
|
|
3588
3588
|
};
|
|
3589
3589
|
if (this.options.verifyClient.length === 2) {
|
|
3590
|
-
this.options.verifyClient(info, (
|
|
3591
|
-
if (!
|
|
3590
|
+
this.options.verifyClient(info, (verified2, code, message, headers) => {
|
|
3591
|
+
if (!verified2) {
|
|
3592
3592
|
return abortHandshake(socket, code || 401, message, headers);
|
|
3593
3593
|
}
|
|
3594
3594
|
this.completeUpgrade(
|
|
@@ -3628,7 +3628,7 @@ var require_websocket_server = __commonJS({
|
|
|
3628
3628
|
);
|
|
3629
3629
|
}
|
|
3630
3630
|
if (this._state > RUNNING) return abortHandshake(socket, 503);
|
|
3631
|
-
const digest2 =
|
|
3631
|
+
const digest2 = createHash7("sha1").update(key2 + GUID).digest("base64");
|
|
3632
3632
|
const headers = [
|
|
3633
3633
|
"HTTP/1.1 101 Switching Protocols",
|
|
3634
3634
|
"Upgrade: websocket",
|
|
@@ -3717,19 +3717,21 @@ var require_websocket_server = __commonJS({
|
|
|
3717
3717
|
|
|
3718
3718
|
// packages/cli/src/web/main.js
|
|
3719
3719
|
import { randomBytes as randomBytes5 } from "node:crypto";
|
|
3720
|
-
import { mkdirSync, openSync, writeSync } from "node:fs";
|
|
3721
|
-
import { chmod as chmod2, link as link2, mkdir as mkdir6, readFile as readFile5, rename as rename4, unlink as unlink6, writeFile as
|
|
3722
|
-
import
|
|
3720
|
+
import { mkdirSync as mkdirSync2, openSync, watch, writeSync } from "node:fs";
|
|
3721
|
+
import { chmod as chmod2, link as link2, mkdir as mkdir6, readFile as readFile5, rename as rename4, unlink as unlink6, writeFile as writeFile6 } from "node:fs/promises";
|
|
3722
|
+
import path10 from "node:path";
|
|
3723
3723
|
import { fileURLToPath } from "node:url";
|
|
3724
3724
|
import { parseArgs } from "node:util";
|
|
3725
3725
|
|
|
3726
3726
|
// packages/client/src/index.js
|
|
3727
|
-
import {
|
|
3728
|
-
import {
|
|
3727
|
+
import { setTimeout as delay } from "node:timers/promises";
|
|
3728
|
+
import { execFileSync, spawn } from "node:child_process";
|
|
3729
|
+
import { createHash as createHash2, randomUUID } from "node:crypto";
|
|
3730
|
+
import { readFileSync as readFileSync2 } from "node:fs";
|
|
3729
3731
|
import { open, readFile, writeFile, realpath, stat, lstat, mkdir, readlink, unlink, readdir, rename, rmdir, link } from "node:fs/promises";
|
|
3730
3732
|
import net from "node:net";
|
|
3731
|
-
import
|
|
3732
|
-
import
|
|
3733
|
+
import os2 from "node:os";
|
|
3734
|
+
import path2 from "node:path";
|
|
3733
3735
|
|
|
3734
3736
|
// packages/core/src/log.js
|
|
3735
3737
|
var LEVELS = Object.freeze({ debug: 10, info: 20, warn: 30, error: 40 });
|
|
@@ -3846,6 +3848,179 @@ function createLogger({ component, level, context = {}, write = stderrSink, now
|
|
|
3846
3848
|
}
|
|
3847
3849
|
var TAIL_BYTES = 256 * 1024;
|
|
3848
3850
|
|
|
3851
|
+
// packages/core/src/packaged.js
|
|
3852
|
+
import { createHash } from "node:crypto";
|
|
3853
|
+
import { chmodSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
|
|
3854
|
+
import os from "node:os";
|
|
3855
|
+
import path from "node:path";
|
|
3856
|
+
var KEY = Symbol.for("alp.packaged");
|
|
3857
|
+
var ROLE_ARGS = Object.freeze({
|
|
3858
|
+
daemon: Object.freeze(["daemon", "run"]),
|
|
3859
|
+
web: Object.freeze(["web", "serve"]),
|
|
3860
|
+
"bridge-acp": Object.freeze(["bridge", "acp"]),
|
|
3861
|
+
"bridge-antigravity": Object.freeze(["bridge", "antigravity"])
|
|
3862
|
+
});
|
|
3863
|
+
function packagedInfo() {
|
|
3864
|
+
return (
|
|
3865
|
+
/** @type {any} */
|
|
3866
|
+
globalThis[KEY]
|
|
3867
|
+
);
|
|
3868
|
+
}
|
|
3869
|
+
function isPackaged() {
|
|
3870
|
+
return packagedInfo() !== void 0;
|
|
3871
|
+
}
|
|
3872
|
+
var EXECUTABLE_MARKER = "alp-standalone-executable:v1:2b6f0c1e";
|
|
3873
|
+
var isExecutableName = (file) => /^alp(\.exe)?$/i.test(file.split(/[\\/]/).pop() ?? "");
|
|
3874
|
+
var isSelf = (file) => isPackaged() && typeof file === "string" && samePath(file, process.execPath);
|
|
3875
|
+
var canonical = (file) => {
|
|
3876
|
+
let resolved = path.resolve(file);
|
|
3877
|
+
try {
|
|
3878
|
+
resolved = realpathSync.native(resolved);
|
|
3879
|
+
} catch {
|
|
3880
|
+
}
|
|
3881
|
+
return process.platform === "darwin" || process.platform === "win32" ? resolved.toLowerCase() : resolved;
|
|
3882
|
+
};
|
|
3883
|
+
var samePath = (a, b) => canonical(a) === canonical(b);
|
|
3884
|
+
var isScript = (file) => /\.[cm]?js$/i.test(file);
|
|
3885
|
+
function roleArgs(role) {
|
|
3886
|
+
const args = ROLE_ARGS[role];
|
|
3887
|
+
if (!args) throw new TypeError(`Unknown ALP role: ${role}`);
|
|
3888
|
+
return [...args];
|
|
3889
|
+
}
|
|
3890
|
+
function entryCommand(entry, role, args = [], execPath = process.execPath, { scriptOnly = false } = {}) {
|
|
3891
|
+
if (scriptOnly || isScript(entry) || !(isExecutableName(entry) || isSelf(entry))) {
|
|
3892
|
+
if (isPackaged() && execPath === process.execPath) return { command: "node", args: [entry, ...args] };
|
|
3893
|
+
return { command: execPath, args: [entry, ...args] };
|
|
3894
|
+
}
|
|
3895
|
+
return { command: entry, args: [...roleArgs(role), ...args] };
|
|
3896
|
+
}
|
|
3897
|
+
function scriptCommand(script, args = []) {
|
|
3898
|
+
if (isPackaged()) return { command: process.execPath, args: [script, ...args], env: { BUN_BE_BUN: "1" } };
|
|
3899
|
+
return { command: process.execPath, args: [script, ...args] };
|
|
3900
|
+
}
|
|
3901
|
+
function executablePath() {
|
|
3902
|
+
return isPackaged() ? process.execPath : void 0;
|
|
3903
|
+
}
|
|
3904
|
+
function selfEntry(script) {
|
|
3905
|
+
return isPackaged() ? process.execPath : script;
|
|
3906
|
+
}
|
|
3907
|
+
var sha256 = (bytes2) => createHash("sha256").update(bytes2).digest("hex");
|
|
3908
|
+
var MARKER = ".alp-assets.json";
|
|
3909
|
+
function assetCacheDir(version, env = process.env) {
|
|
3910
|
+
if (!/^[0-9A-Za-z][0-9A-Za-z.+-]*$/.test(version)) throw new TypeError(`Invalid ALP version for the asset cache: ${JSON.stringify(version)}`);
|
|
3911
|
+
const home = env.ALP_HOME ? path.resolve(env.ALP_HOME) : path.join(os.homedir(), ".alp");
|
|
3912
|
+
return path.join(home, "cache", version);
|
|
3913
|
+
}
|
|
3914
|
+
var manifestDigest = (assets) => sha256(Buffer.from(JSON.stringify(Object.keys(assets).sort().map((name2) => [name2, assets[name2].sha256, assets[name2].size]))));
|
|
3915
|
+
function assertAssetName(name2) {
|
|
3916
|
+
if (!name2 || path.isAbsolute(name2) || name2.split(/[\\/]/).some((part) => part === ".." || part === "" || part === ".") || name2 === MARKER) throw new Error(`Invalid packaged asset name: ${JSON.stringify(name2)}`);
|
|
3917
|
+
}
|
|
3918
|
+
function assertPrivate(directory) {
|
|
3919
|
+
const info = lstatSync(directory);
|
|
3920
|
+
if (!info.isDirectory() || info.isSymbolicLink()) throw new Error(`ALP asset cache is not a directory: ${directory}`);
|
|
3921
|
+
if (process.platform !== "win32" && (info.uid !== process.getuid?.() || (info.mode & 63) !== 0)) throw new Error(`ALP asset cache must be private to the current user (0700): ${directory}`);
|
|
3922
|
+
}
|
|
3923
|
+
function assertParent(directory) {
|
|
3924
|
+
const info = lstatSync(directory);
|
|
3925
|
+
if (!info.isDirectory() || info.isSymbolicLink()) throw new Error(`ALP asset cache parent is not a directory: ${directory}`);
|
|
3926
|
+
if (process.platform !== "win32" && (info.uid !== process.getuid?.() || (info.mode & 18) !== 0)) throw new Error(`ALP asset cache parent must belong to the current user and not be group- or world-writable: ${directory}`);
|
|
3927
|
+
}
|
|
3928
|
+
function extracted(directory, digest2, assets) {
|
|
3929
|
+
try {
|
|
3930
|
+
if (JSON.parse(readFileSync(path.join(directory, MARKER), "utf8")).digest !== digest2) return false;
|
|
3931
|
+
return Object.entries(assets).every(([name2, asset]) => {
|
|
3932
|
+
const file = path.join(directory, name2);
|
|
3933
|
+
const info = lstatSync(file);
|
|
3934
|
+
return info.isFile() && info.size === asset.size && sha256(readFileSync(file)) === asset.sha256;
|
|
3935
|
+
});
|
|
3936
|
+
} catch {
|
|
3937
|
+
return false;
|
|
3938
|
+
}
|
|
3939
|
+
}
|
|
3940
|
+
var STAGING = /^(.+)\.tmp-(\d+)-(\d+)$/;
|
|
3941
|
+
var STALE_MS = 60 * 60 * 1e3;
|
|
3942
|
+
var SWEEP_MIN_MS = 10 * 60 * 1e3;
|
|
3943
|
+
function sweepStaging(parent) {
|
|
3944
|
+
let names2;
|
|
3945
|
+
try {
|
|
3946
|
+
names2 = readdirSync(parent);
|
|
3947
|
+
} catch {
|
|
3948
|
+
return;
|
|
3949
|
+
}
|
|
3950
|
+
for (const name2 of names2) {
|
|
3951
|
+
const match = STAGING.exec(name2);
|
|
3952
|
+
if (!match) continue;
|
|
3953
|
+
const pid = Number(match[2]);
|
|
3954
|
+
if (pid === process.pid) continue;
|
|
3955
|
+
const age = Date.now() - Number(match[3]);
|
|
3956
|
+
if (age < SWEEP_MIN_MS) continue;
|
|
3957
|
+
let alive = false;
|
|
3958
|
+
try {
|
|
3959
|
+
process.kill(pid, 0);
|
|
3960
|
+
alive = true;
|
|
3961
|
+
} catch (error) {
|
|
3962
|
+
alive = /** @type {any} */
|
|
3963
|
+
error?.code === "EPERM";
|
|
3964
|
+
}
|
|
3965
|
+
if (alive && age < STALE_MS) continue;
|
|
3966
|
+
try {
|
|
3967
|
+
rmSync(path.join(parent, name2), { recursive: true, force: true });
|
|
3968
|
+
} catch {
|
|
3969
|
+
}
|
|
3970
|
+
}
|
|
3971
|
+
}
|
|
3972
|
+
function assetDir({ env = process.env, info = packagedInfo() } = {}) {
|
|
3973
|
+
if (!info) return void 0;
|
|
3974
|
+
const assets = info.assets ?? {};
|
|
3975
|
+
const directory = assetCacheDir(info.version, env);
|
|
3976
|
+
const digest2 = manifestDigest(assets);
|
|
3977
|
+
const key2 = `${directory}\0${digest2}`;
|
|
3978
|
+
if (verified.has(key2) && existsSync(path.join(directory, MARKER))) return directory;
|
|
3979
|
+
const result = extract(directory, digest2, assets, info.version);
|
|
3980
|
+
verified.add(key2);
|
|
3981
|
+
return result;
|
|
3982
|
+
}
|
|
3983
|
+
var verified = /* @__PURE__ */ new Set();
|
|
3984
|
+
function extract(directory, digest2, assets, version) {
|
|
3985
|
+
const parent = path.dirname(directory);
|
|
3986
|
+
mkdirSync(parent, { recursive: true, mode: 448 });
|
|
3987
|
+
assertParent(parent);
|
|
3988
|
+
sweepStaging(parent);
|
|
3989
|
+
if (existsSync(directory)) {
|
|
3990
|
+
assertPrivate(directory);
|
|
3991
|
+
if (extracted(directory, digest2, assets)) return directory;
|
|
3992
|
+
}
|
|
3993
|
+
const staging = `${directory}.tmp-${process.pid}-${Date.now()}`;
|
|
3994
|
+
mkdirSync(staging, { mode: 448 });
|
|
3995
|
+
try {
|
|
3996
|
+
for (const [name2, asset] of Object.entries(assets)) {
|
|
3997
|
+
assertAssetName(name2);
|
|
3998
|
+
const bytes2 = readFileSync(asset.path);
|
|
3999
|
+
if (bytes2.length !== asset.size || sha256(bytes2) !== asset.sha256) throw new Error(`Packaged asset ${name2} does not match its manifest`);
|
|
4000
|
+
const target = path.join(staging, name2);
|
|
4001
|
+
mkdirSync(path.dirname(target), { recursive: true, mode: 448 });
|
|
4002
|
+
writeFileSync(target, bytes2, { mode: 384 });
|
|
4003
|
+
if (/(^|\/)terminal-owner(\.exe)?$/.test(name2)) chmodSync(target, 448);
|
|
4004
|
+
}
|
|
4005
|
+
writeFileSync(path.join(staging, MARKER), JSON.stringify({ version, digest: digest2 }), { mode: 384 });
|
|
4006
|
+
if (existsSync(directory)) {
|
|
4007
|
+
assertPrivate(directory);
|
|
4008
|
+
if (extracted(directory, digest2, assets)) {
|
|
4009
|
+
rmSync(staging, { recursive: true, force: true });
|
|
4010
|
+
return directory;
|
|
4011
|
+
}
|
|
4012
|
+
rmSync(directory, { recursive: true, force: true });
|
|
4013
|
+
}
|
|
4014
|
+
renameSync(staging, directory);
|
|
4015
|
+
if (!extracted(directory, digest2, assets)) throw new Error(`ALP asset cache ${directory} is incomplete after extraction`);
|
|
4016
|
+
} catch (error) {
|
|
4017
|
+
rmSync(staging, { recursive: true, force: true });
|
|
4018
|
+
if (existsSync(directory) && extracted(directory, digest2, assets)) return directory;
|
|
4019
|
+
throw error;
|
|
4020
|
+
}
|
|
4021
|
+
return directory;
|
|
4022
|
+
}
|
|
4023
|
+
|
|
3849
4024
|
// packages/protocol/src/wire.js
|
|
3850
4025
|
var PROTOCOL_VERSION = 1;
|
|
3851
4026
|
var MAX_FRAME = 16 * 1024 * 1024;
|
|
@@ -3858,11 +4033,11 @@ var AlpRpcError = class extends Error {
|
|
|
3858
4033
|
};
|
|
3859
4034
|
var ERROR = Object.freeze({ failed: 1e3, notFound: 1001, forbidden: 1003, conflict: 1004, unavailable: 1005, protocol: 1006 });
|
|
3860
4035
|
var RPC_ERROR = Object.freeze({ parseError: -32700, invalidRequest: -32600, methodNotFound: -32601, invalidParams: -32602 });
|
|
3861
|
-
var CAPABILITY = Object.freeze({ sessionInterruptTurn: "session.interrupt.turn", attachAfter: "attach.after", sessionHistory: "session.history", workspaceRegistry: "workspace.registry", workspaceWorktree: "workspace.worktree", workspaceGit: "workspace.git", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", libraryProjectWrite: "library.project.write", settingsLanguage: "settings.language", sessionListPage: "session.list.page", questionWatch: "question.watch", questionWatchTurns: "question.watch.turns", sessionAttention: "session.attention", workspaceFiles: "workspace.files", workspaceFilesRead: "workspace.files.read", promptImages: "prompt.images", schedule: "schedule", attachments: "attachments", sessionFork: "session.fork", sessionRewind: "session.rewind", sessionReload: "session.reload", sessionResumeCommand: "session.resumeCommand", sessionConfigureLive: "session.configure.live", terminal: "terminal" });
|
|
4036
|
+
var CAPABILITY = Object.freeze({ sessionInterruptTurn: "session.interrupt.turn", catalogLive: "catalog.live", attachAfter: "attach.after", sessionHistory: "session.history", workspaceRegistry: "workspace.registry", workspaceWorktree: "workspace.worktree", workspaceGit: "workspace.git", workspaceGitFacts: "workspace.git.facts", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", libraryProjectWrite: "library.project.write", settingsLanguage: "settings.language", sessionListPage: "session.list.page", questionWatch: "question.watch", questionWatchTurns: "question.watch.turns", sessionAttention: "session.attention", workspaceFiles: "workspace.files", workspaceFilesRead: "workspace.files.read", workspaceFilesBrowse: "workspace.files.browse", hostDirectories: "host.directories", promptImages: "prompt.images", schedule: "schedule", attachments: "attachments", sessionFork: "session.fork", sessionRewind: "session.rewind", sessionReload: "session.reload", sessionResumeCommand: "session.resumeCommand", sessionConfigureLive: "session.configure.live", terminal: "terminal", terminalCapture: "terminal.capture", terminalWatch: "terminal.watch" });
|
|
3862
4037
|
var PROMPT_IMAGES = Object.freeze({ mimeTypes: Object.freeze(["image/png", "image/jpeg", "image/gif", "image/webp"]), maxCount: 8, maxBytes: 5 * 1024 * 1024, maxTotalBytes: 11 * 1024 * 1024 });
|
|
3863
4038
|
var base64Bytes = (data) => Math.floor(data.length * 3 / 4) - (data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0);
|
|
3864
|
-
var RPC_METHODS = Object.freeze(["assignment.recall", "attachment.abort", "attachment.begin", "attachment.chunk", "attachment.commit", "attachment.delete", "attachment.get", "board.list", "catalog.get", "daemon.hello", "daemon.pause", "daemon.pauses", "daemon.resume", "daemon.shutdown", "daemon.status", "daemon.usage", "extension.register", "extension.unregister", "library.delete", "library.duplicate", "library.get", "library.list", "library.models", "library.rename", "library.save", "library.skills.set", "project.list", "project.register", "project.remove", "question.answer", "question.list", "question.watch", "registry.owner", "registry.worktree", "schedule.cancel", "schedule.create", "schedule.get", "schedule.list", "session.archive", "session.attach", "session.attention.clear", "session.close", "session.configure", "session.configure.preview", "session.create", "session.fork", "session.get", "session.history", "session.interrupt", "session.list", "session.log", "session.message", "session.preview", "session.prompt", "session.release", "session.reload", "session.rename", "session.resumeCommand", "session.rewind", "session.status", "settings.language.get", "settings.language.set", "task.create", "task.gate.resolve", "task.list", "task.update", "team.list", "terminal.attach", "terminal.close", "terminal.create", "terminal.input", "terminal.list", "terminal.resize", "terminal.revoke", "workspace.files.list", "workspace.files.read", "workspace.files.search", "workspace.get", "workspace.git.diff", "workspace.git.status", "workspace.list", "workspace.update", "workspace.worktree.create", "workspace.worktree.options", "workspace.worktree.remove"]);
|
|
3865
|
-
var WORKSPACE_FILES = Object.freeze({ maxReadBytes: 1024 * 1024, maxListEntries: 1e3, maxPathLength: 4096 });
|
|
4039
|
+
var RPC_METHODS = Object.freeze(["assignment.recall", "attachment.abort", "attachment.begin", "attachment.chunk", "attachment.commit", "attachment.delete", "attachment.get", "board.list", "catalog.get", "catalog.refresh", "daemon.hello", "daemon.pause", "daemon.pauses", "daemon.resume", "daemon.shutdown", "daemon.status", "daemon.usage", "extension.register", "extension.unregister", "host.directories.search", "library.delete", "library.duplicate", "library.get", "library.list", "library.models", "library.rename", "library.save", "library.skills.set", "project.list", "project.register", "project.remove", "question.answer", "question.list", "question.watch", "registry.owner", "registry.worktree", "schedule.cancel", "schedule.create", "schedule.get", "schedule.list", "session.archive", "session.attach", "session.attention.clear", "session.close", "session.compact", "session.configure", "session.configure.preview", "session.create", "session.fork", "session.get", "session.history", "session.interrupt", "session.list", "session.log", "session.message", "session.preview", "session.prompt", "session.release", "session.reload", "session.rename", "session.resumeCommand", "session.rewind", "session.status", "settings.language.get", "settings.language.set", "task.create", "task.gate.resolve", "task.list", "task.update", "team.list", "terminal.attach", "terminal.close", "terminal.capture", "terminal.create", "terminal.input", "terminal.list", "terminal.watch", "terminal.unwatch", "terminal.resize", "terminal.revoke", "workspace.files.find", "workspace.files.list", "workspace.files.preview", "workspace.files.read", "workspace.files.search", "workspace.get", "workspace.git.diff", "workspace.git.facts", "workspace.git.status", "workspace.list", "workspace.update", "workspace.worktree.create", "workspace.worktree.options", "workspace.worktree.remove"]);
|
|
4040
|
+
var WORKSPACE_FILES = Object.freeze({ maxReadBytes: 1024 * 1024, maxListEntries: 1e3, maxPathLength: 4096, maxPreviewBytes: 50 * 1024 * 1024, maxPreviewChunkBytes: 8 * 1024 * 1024, maxFindEntries: 1e3 });
|
|
3866
4041
|
var WORKSPACE_GIT = Object.freeze({ maxFileBytes: 1024 * 1024, maxTotalBytes: 2 * 1024 * 1024, maxUntracked: 200, maxStatusFiles: 1e3, maxRefLength: 255 });
|
|
3867
4042
|
var ATTACHMENTS = Object.freeze({
|
|
3868
4043
|
maxObjectBytes: 20 * 1024 * 1024,
|
|
@@ -4183,9 +4358,9 @@ var AlpRpcClient = class {
|
|
|
4183
4358
|
if (this.#closeError) return Promise.reject(new AlpClientError(CLOSED, { reason: this.#closeError.reason === "closed" ? "closed" : "disconnected", cause: this.#closeError }));
|
|
4184
4359
|
if (signal?.aborted) return Promise.reject(abortError(signal));
|
|
4185
4360
|
if (this.#pending.size >= this.#maxPending) return Promise.reject(new AlpClientError(`Too many ALP requests waiting for an answer (${this.#maxPending})`, { reason: "overloaded" }));
|
|
4186
|
-
let
|
|
4361
|
+
let delay2;
|
|
4187
4362
|
try {
|
|
4188
|
-
|
|
4363
|
+
delay2 = timerDelay(timeoutMs);
|
|
4189
4364
|
} catch (error) {
|
|
4190
4365
|
return Promise.reject(error);
|
|
4191
4366
|
}
|
|
@@ -4213,12 +4388,12 @@ var AlpRpcClient = class {
|
|
|
4213
4388
|
signal?.removeEventListener("abort", onAbort);
|
|
4214
4389
|
};
|
|
4215
4390
|
this.#pending.set(id, { resolve: resolve2, reject, cleanup });
|
|
4216
|
-
if (
|
|
4391
|
+
if (delay2 !== void 0) {
|
|
4217
4392
|
timer = setTimeout(() => {
|
|
4218
4393
|
if (!this.#pending.delete(id)) return;
|
|
4219
4394
|
cleanup();
|
|
4220
4395
|
reject(new AlpClientError(`ALP request ${method} timed out after ${timeoutMs} ms`, { reason: "timeout" }));
|
|
4221
|
-
},
|
|
4396
|
+
}, delay2);
|
|
4222
4397
|
}
|
|
4223
4398
|
signal?.addEventListener("abort", onAbort, { once: true });
|
|
4224
4399
|
try {
|
|
@@ -4393,8 +4568,9 @@ var AlpRpcClient = class {
|
|
|
4393
4568
|
};
|
|
4394
4569
|
|
|
4395
4570
|
// packages/client/src/rpc/handshake.js
|
|
4396
|
-
|
|
4397
|
-
|
|
4571
|
+
var AGENT_CAPABILITY = "principal.agent";
|
|
4572
|
+
function hello(client, info = { name: "alp", version: "0" }, options, { agent = false } = {}) {
|
|
4573
|
+
return client.request("daemon.hello", { protocolVersion: PROTOCOL_VERSION, client: info, ...agent ? { capabilities: [AGENT_CAPABILITY] } : {} }, options);
|
|
4398
4574
|
}
|
|
4399
4575
|
|
|
4400
4576
|
// packages/client/src/rpc/reconnect.js
|
|
@@ -4622,27 +4798,27 @@ var CLOSE_CODE = Object.freeze({ unsupportedData: 4003, tooLarge: 4009 });
|
|
|
4622
4798
|
|
|
4623
4799
|
// packages/client/src/index.js
|
|
4624
4800
|
function alpHome(env = process.env) {
|
|
4625
|
-
return
|
|
4801
|
+
return path2.resolve(env.ALP_HOME || path2.join(os2.homedir(), ".alp"));
|
|
4626
4802
|
}
|
|
4627
4803
|
function daemonPaths(home) {
|
|
4628
|
-
const preferred =
|
|
4629
|
-
const socket = process.platform === "win32" ? `\\\\.\\pipe\\alpd-${
|
|
4630
|
-
return { home, lock:
|
|
4804
|
+
const preferred = path2.join(home, "alpd.sock");
|
|
4805
|
+
const socket = process.platform === "win32" ? `\\\\.\\pipe\\alpd-${createHash2("sha256").update(home).digest("hex").slice(0, 24)}` : Buffer.byteLength(preferred) < 100 ? preferred : path2.join(os2.tmpdir(), `alpd-${process.getuid?.() ?? "user"}-${createHash2("sha256").update(home).digest("hex").slice(0, 12)}`, "rpc.sock");
|
|
4806
|
+
return { home, lock: path2.join(home, "alpd.lock"), socket, log: path2.join(home, "logs", "alpd.log"), install: path2.join(home, "alpd.json") };
|
|
4631
4807
|
}
|
|
4632
4808
|
async function assertSafeAncestors(directory) {
|
|
4633
4809
|
if (process.platform === "win32") return;
|
|
4634
|
-
const absolute =
|
|
4635
|
-
let current =
|
|
4810
|
+
const absolute = path2.isAbsolute(directory) ? directory : `${process.cwd()}/${directory}`;
|
|
4811
|
+
let current = path2.parse(absolute).root;
|
|
4636
4812
|
const pending = absolute.slice(current.length).split("/");
|
|
4637
4813
|
let links = 0;
|
|
4638
4814
|
while (pending.length) {
|
|
4639
4815
|
const part = pending.shift();
|
|
4640
4816
|
if (!part || part === ".") continue;
|
|
4641
4817
|
if (part === "..") {
|
|
4642
|
-
current =
|
|
4818
|
+
current = path2.dirname(current);
|
|
4643
4819
|
continue;
|
|
4644
4820
|
}
|
|
4645
|
-
const candidate =
|
|
4821
|
+
const candidate = path2.join(current, part);
|
|
4646
4822
|
const info = await lstat(candidate).catch((error) => {
|
|
4647
4823
|
if (error.code !== "ENOENT") throw error;
|
|
4648
4824
|
});
|
|
@@ -4655,8 +4831,8 @@ async function assertSafeAncestors(directory) {
|
|
|
4655
4831
|
if (info.isSymbolicLink()) {
|
|
4656
4832
|
if (++links > 40) throw new Error("IPC ancestor symlink loop");
|
|
4657
4833
|
const target = await readlink(candidate);
|
|
4658
|
-
if (
|
|
4659
|
-
pending.unshift(...target.slice(
|
|
4834
|
+
if (path2.isAbsolute(target)) current = path2.parse(target).root;
|
|
4835
|
+
pending.unshift(...target.slice(path2.isAbsolute(target) ? path2.parse(target).root.length : 0).split("/"));
|
|
4660
4836
|
continue;
|
|
4661
4837
|
}
|
|
4662
4838
|
if (!info.isDirectory() || info.mode & 18 && !(info.mode & 512)) {
|
|
@@ -4676,7 +4852,7 @@ async function assertPrivateDirectory(directory, { create = false } = {}) {
|
|
|
4676
4852
|
}
|
|
4677
4853
|
async function assertPrivateSocket(socketPath) {
|
|
4678
4854
|
if (process.platform === "win32") return;
|
|
4679
|
-
await assertPrivateDirectory(
|
|
4855
|
+
await assertPrivateDirectory(path2.dirname(socketPath));
|
|
4680
4856
|
const info = await lstat(socketPath);
|
|
4681
4857
|
if (!info.isSocket() || info.uid !== process.getuid?.() || (info.mode & 63) !== 0) {
|
|
4682
4858
|
throw new Error("IPC socket must be owned by the current user with private permissions (0600)");
|
|
@@ -4684,24 +4860,66 @@ async function assertPrivateSocket(socketPath) {
|
|
|
4684
4860
|
return info;
|
|
4685
4861
|
}
|
|
4686
4862
|
var isFile = (file) => stat(file).then((info) => info.isFile(), () => false);
|
|
4687
|
-
|
|
4863
|
+
async function isAlpExecutable(file) {
|
|
4864
|
+
if (isScript(file) || !isExecutableName(file) || !await isFile(file)) return false;
|
|
4865
|
+
const handle = await open(file, "r").catch(() => void 0);
|
|
4866
|
+
if (!handle) return false;
|
|
4867
|
+
try {
|
|
4868
|
+
const { buffer, bytesRead } = await handle.read(Buffer.alloc(4), 0, 4, 0);
|
|
4869
|
+
if (bytesRead < 4) return false;
|
|
4870
|
+
const magic = buffer.readUInt32BE(0);
|
|
4871
|
+
const native = buffer.toString("latin1") === "\x7FELF" || buffer.subarray(0, 2).toString("latin1") === "MZ" || [4277009102, 4277009103, 3472551422, 3489328638, 3405691582].includes(magic);
|
|
4872
|
+
if (!native) return false;
|
|
4873
|
+
const marker = Buffer.from(EXECUTABLE_MARKER, "latin1");
|
|
4874
|
+
const chunk = Buffer.alloc(1 << 20);
|
|
4875
|
+
let tail2 = Buffer.alloc(0);
|
|
4876
|
+
for (let position = 0; ; ) {
|
|
4877
|
+
const { bytesRead: read } = await handle.read(chunk, 0, chunk.length, position);
|
|
4878
|
+
if (!read) return false;
|
|
4879
|
+
const window = Buffer.concat([tail2, chunk.subarray(0, read)]);
|
|
4880
|
+
if (window.includes(marker)) return true;
|
|
4881
|
+
tail2 = window.subarray(Math.max(0, window.length - marker.length + 1));
|
|
4882
|
+
position += read;
|
|
4883
|
+
}
|
|
4884
|
+
} finally {
|
|
4885
|
+
await handle.close();
|
|
4886
|
+
}
|
|
4887
|
+
}
|
|
4888
|
+
var BIN_DIRECTORIES = [path2.join(os2.homedir(), ".alp", "bin"), path2.join(os2.homedir(), ".npm-global", "bin"), path2.join(os2.homedir(), ".local", "bin"), "/opt/homebrew/bin", "/usr/local/bin"];
|
|
4688
4889
|
var CLI_PACKAGES = ["@anhlp/alp", "@anhlp/alp-cli"];
|
|
4890
|
+
async function npmWrapperExecutable(launcher, platform = process.platform, arch = process.arch) {
|
|
4891
|
+
if (path2.basename(launcher) !== "alp.js") return void 0;
|
|
4892
|
+
const root = path2.resolve(path2.dirname(launcher), "..");
|
|
4893
|
+
const name2 = await readFile(path2.join(root, "package.json"), "utf8").then((text) => JSON.parse(text)?.name).catch(() => void 0);
|
|
4894
|
+
if (name2 !== "@anhlp/alp") return void 0;
|
|
4895
|
+
const id = `alp-${platform}-${arch}`;
|
|
4896
|
+
const file = path2.join("bin", platform === "win32" ? "alp.exe" : "alp");
|
|
4897
|
+
for (const candidate of [path2.join(root, "node_modules", "@anhlp", id, file), path2.join(root, "..", id, file)]) {
|
|
4898
|
+
if (await isAlpExecutable(candidate)) return candidate;
|
|
4899
|
+
}
|
|
4900
|
+
return void 0;
|
|
4901
|
+
}
|
|
4689
4902
|
async function findDaemonEntry({ home = alpHome(), env = process.env, candidates = (
|
|
4690
4903
|
/** @type {Array<string | undefined>} */
|
|
4691
4904
|
[]
|
|
4692
4905
|
) } = {}) {
|
|
4693
4906
|
for (const candidate of candidates) if (candidate && await isFile(candidate)) return candidate;
|
|
4907
|
+
const own2 = executablePath();
|
|
4908
|
+
if (own2) return own2;
|
|
4694
4909
|
try {
|
|
4695
4910
|
const { entry } = JSON.parse(await readFile(daemonPaths(home).install, "utf8"));
|
|
4696
4911
|
if (typeof entry === "string" && await isFile(entry)) return entry;
|
|
4697
4912
|
} catch {
|
|
4698
4913
|
}
|
|
4699
|
-
for (const directory of [...(env.PATH ?? "").split(
|
|
4700
|
-
const cli = await realpath(
|
|
4701
|
-
if (
|
|
4702
|
-
const
|
|
4703
|
-
|
|
4704
|
-
|
|
4914
|
+
for (const directory of [...(env.PATH ?? "").split(path2.delimiter).filter(Boolean), ...BIN_DIRECTORIES]) {
|
|
4915
|
+
const cli = await realpath(path2.join(directory, process.platform === "win32" ? "alp.exe" : "alp")).catch(() => void 0);
|
|
4916
|
+
if (cli && await isAlpExecutable(cli)) return cli;
|
|
4917
|
+
const npmExecutable = cli && await npmWrapperExecutable(cli);
|
|
4918
|
+
if (npmExecutable) return npmExecutable;
|
|
4919
|
+
if (!cli || path2.basename(cli) !== "cli.js") continue;
|
|
4920
|
+
const root = path2.resolve(path2.dirname(cli), "..");
|
|
4921
|
+
const name2 = await readFile(path2.join(root, "package.json"), "utf8").then((text) => JSON.parse(text)?.name).catch(() => void 0);
|
|
4922
|
+
const entry = path2.join(root, "dist", "alpd.js");
|
|
4705
4923
|
if (CLI_PACKAGES.includes(name2) && await isFile(entry)) return entry;
|
|
4706
4924
|
}
|
|
4707
4925
|
return void 0;
|
|
@@ -4710,8 +4928,44 @@ function assertIntegrationName(name2) {
|
|
|
4710
4928
|
if (typeof name2 !== "string" || !/^[a-z0-9][a-z0-9-]*$/.test(name2)) throw new TypeError(`Invalid integration name: ${JSON.stringify(name2)}`);
|
|
4711
4929
|
return name2;
|
|
4712
4930
|
}
|
|
4931
|
+
var cachedBootId = null;
|
|
4932
|
+
function bootId() {
|
|
4933
|
+
if (cachedBootId !== null) return cachedBootId;
|
|
4934
|
+
try {
|
|
4935
|
+
if (process.platform === "linux") {
|
|
4936
|
+
const id = readFileSync2("/proc/sys/kernel/random/boot_id", "utf8").trim();
|
|
4937
|
+
if (id.length > 0) {
|
|
4938
|
+
cachedBootId = id;
|
|
4939
|
+
return cachedBootId;
|
|
4940
|
+
}
|
|
4941
|
+
} else if (process.platform === "darwin") {
|
|
4942
|
+
const id = execFileSync("sysctl", ["-n", "kern.bootsessionuuid"], {
|
|
4943
|
+
encoding: "utf8",
|
|
4944
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
4945
|
+
timeout: 2e3
|
|
4946
|
+
}).trim();
|
|
4947
|
+
if (id.length > 0) {
|
|
4948
|
+
cachedBootId = id;
|
|
4949
|
+
return cachedBootId;
|
|
4950
|
+
}
|
|
4951
|
+
}
|
|
4952
|
+
} catch {
|
|
4953
|
+
}
|
|
4954
|
+
cachedBootId = void 0;
|
|
4955
|
+
return cachedBootId;
|
|
4956
|
+
}
|
|
4713
4957
|
function bootTime() {
|
|
4714
|
-
return Math.round((Date.now() -
|
|
4958
|
+
return Math.round((Date.now() - os2.uptime() * 1e3) / 1e3);
|
|
4959
|
+
}
|
|
4960
|
+
function isSameBoot(lock, { bootId: curBootId = bootId(), bootTime: curBootTime = bootTime() } = {}) {
|
|
4961
|
+
if (!lock) return false;
|
|
4962
|
+
if (typeof lock.bootId === "string" && lock.bootId.length > 0 && typeof curBootId === "string" && curBootId.length > 0) {
|
|
4963
|
+
return lock.bootId === curBootId;
|
|
4964
|
+
}
|
|
4965
|
+
if (typeof lock.bootTime === "number" && Number.isFinite(lock.bootTime) && Number.isFinite(curBootTime)) {
|
|
4966
|
+
return Math.abs(lock.bootTime - curBootTime) <= 30;
|
|
4967
|
+
}
|
|
4968
|
+
return false;
|
|
4715
4969
|
}
|
|
4716
4970
|
async function readLock(home) {
|
|
4717
4971
|
try {
|
|
@@ -4722,7 +4976,7 @@ async function readLock(home) {
|
|
|
4722
4976
|
}
|
|
4723
4977
|
}
|
|
4724
4978
|
function lockAlive(lock) {
|
|
4725
|
-
if (!lock || !Number.isSafeInteger(lock.pid) ||
|
|
4979
|
+
if (!lock || !Number.isSafeInteger(lock.pid) || !isSameBoot(lock)) return false;
|
|
4726
4980
|
try {
|
|
4727
4981
|
process.kill(lock.pid, 0);
|
|
4728
4982
|
return true;
|
|
@@ -4733,6 +4987,12 @@ function lockAlive(lock) {
|
|
|
4733
4987
|
var AlpClient = class extends AlpRpcClient {
|
|
4734
4988
|
/** Host features captured by connect's handshake. @type {readonly string[]} */
|
|
4735
4989
|
capabilities = [];
|
|
4990
|
+
/** Limits captured by connect's handshake. @type {import('@anhlp/alp-protocol').AttachmentLimits | undefined} */
|
|
4991
|
+
attachmentLimits;
|
|
4992
|
+
/** @type {{ readonly maxCount: number; readonly maxBytes: number; readonly maxTotalBytes: number } | undefined} */
|
|
4993
|
+
promptImageLimits;
|
|
4994
|
+
/** @type {import('@anhlp/alp-protocol').TerminalLimits | undefined} */
|
|
4995
|
+
terminalLimits;
|
|
4736
4996
|
/**
|
|
4737
4997
|
* @param {import('node:net').Socket} socket a connected or connecting socket; the client owns it
|
|
4738
4998
|
* @param {import('./rpc/client.js').AlpRpcClientOptions & import('./ipc.js').SocketTransportOptions} [options]
|
|
@@ -4761,8 +5021,17 @@ async function connectSocket(socketPath, options) {
|
|
|
4761
5021
|
async function connect(socketPath, client = { name: "alp", version: "0" }, options = {}) {
|
|
4762
5022
|
const connection = new AlpClient(await openSocket(socketPath), options);
|
|
4763
5023
|
try {
|
|
4764
|
-
const greeting = await hello(connection, client);
|
|
5024
|
+
const greeting = await hello(connection, client, void 0, { agent: typeof process.env.ALP_AGENT_SESSION === "string" && process.env.ALP_AGENT_SESSION !== "" });
|
|
4765
5025
|
connection.capabilities = Object.freeze(Array.isArray(greeting.capabilities) ? greeting.capabilities.filter((value) => typeof value === "string") : []);
|
|
5026
|
+
if (greeting.attachmentLimits && typeof greeting.attachmentLimits === "object") {
|
|
5027
|
+
connection.attachmentLimits = Object.freeze({ ...greeting.attachmentLimits });
|
|
5028
|
+
}
|
|
5029
|
+
if (greeting.promptImageLimits && typeof greeting.promptImageLimits === "object") {
|
|
5030
|
+
connection.promptImageLimits = Object.freeze({ ...greeting.promptImageLimits });
|
|
5031
|
+
}
|
|
5032
|
+
if (greeting.terminalLimits && typeof greeting.terminalLimits === "object") {
|
|
5033
|
+
connection.terminalLimits = Object.freeze({ ...greeting.terminalLimits });
|
|
5034
|
+
}
|
|
4766
5035
|
} catch (error) {
|
|
4767
5036
|
connection.close();
|
|
4768
5037
|
throw error;
|
|
@@ -4788,7 +5057,7 @@ async function tail(file, lines = 30) {
|
|
|
4788
5057
|
}
|
|
4789
5058
|
}
|
|
4790
5059
|
async function lifecycleOwners(home) {
|
|
4791
|
-
const directory =
|
|
5060
|
+
const directory = path2.join(home, "state", "alpd.starting");
|
|
4792
5061
|
const names2 = await readdir(directory).catch((error) => {
|
|
4793
5062
|
if (error.code === "ENOENT") return [];
|
|
4794
5063
|
throw error;
|
|
@@ -4802,26 +5071,37 @@ async function lifecycleOwners(home) {
|
|
|
4802
5071
|
async function readDaemonLifecycle(home) {
|
|
4803
5072
|
return (await lifecycleOwners(home)).find((owner) => lockAlive(owner));
|
|
4804
5073
|
}
|
|
4805
|
-
async function withDaemonLifecycle(home, action, run2, { joinStart = false
|
|
5074
|
+
async function withDaemonLifecycle(home, action, run2, { joinStart = false, signal = (
|
|
5075
|
+
/** @type {AbortSignal | undefined} */
|
|
5076
|
+
void 0
|
|
5077
|
+
) } = {}) {
|
|
5078
|
+
signal?.throwIfAborted();
|
|
4806
5079
|
try {
|
|
4807
5080
|
await assertPrivateDirectory(home, { create: true });
|
|
4808
5081
|
} catch (cause) {
|
|
4809
5082
|
throw Object.assign(new Error(`ALP_HOME_UNUSABLE, alpd failed to start while preparing its home: ${cause.message}`, { cause }), { code: "ALP_HOME_UNUSABLE" });
|
|
4810
5083
|
}
|
|
4811
|
-
const state =
|
|
5084
|
+
const state = path2.join(home, "state");
|
|
4812
5085
|
await assertPrivateDirectory(state, { create: true });
|
|
4813
|
-
const directory =
|
|
5086
|
+
const directory = path2.join(state, "alpd.starting");
|
|
5087
|
+
const currentBootId = bootId();
|
|
4814
5088
|
const token = `owner-${process.pid}-${bootTime()}-${action}-${randomUUID()}`;
|
|
4815
|
-
const candidate =
|
|
5089
|
+
const candidate = path2.join(state, `alpd.starting-${token}`);
|
|
4816
5090
|
await mkdir(candidate, { mode: 448 });
|
|
4817
|
-
await writeFile(
|
|
5091
|
+
await writeFile(path2.join(candidate, token), JSON.stringify({
|
|
5092
|
+
pid: process.pid,
|
|
5093
|
+
bootTime: bootTime(),
|
|
5094
|
+
...currentBootId ? { bootId: currentBootId } : {},
|
|
5095
|
+
startedUptime: Math.floor(os2.uptime()),
|
|
5096
|
+
action
|
|
5097
|
+
}), { mode: 384 });
|
|
4818
5098
|
try {
|
|
4819
5099
|
let joined = false;
|
|
4820
5100
|
if (joinStart) {
|
|
4821
5101
|
const owner = await readDaemonLifecycle(home);
|
|
4822
5102
|
if (owner?.action === "start") {
|
|
4823
5103
|
try {
|
|
4824
|
-
await link(
|
|
5104
|
+
await link(path2.join(directory, owner.token), path2.join(directory, token));
|
|
4825
5105
|
joined = true;
|
|
4826
5106
|
} catch (error) {
|
|
4827
5107
|
if (error.code !== "ENOENT") throw error;
|
|
@@ -4829,32 +5109,34 @@ async function withDaemonLifecycle(home, action, run2, { joinStart = false } = {
|
|
|
4829
5109
|
}
|
|
4830
5110
|
}
|
|
4831
5111
|
while (!joined) {
|
|
5112
|
+
signal?.throwIfAborted();
|
|
4832
5113
|
try {
|
|
4833
5114
|
await rename(candidate, directory);
|
|
4834
5115
|
break;
|
|
4835
5116
|
} catch (error) {
|
|
4836
5117
|
if (!["EEXIST", "ENOTEMPTY", "EPERM", "EACCES"].includes(error.code)) throw error;
|
|
4837
5118
|
for (const owner of await lifecycleOwners(home)) {
|
|
4838
|
-
if (!lockAlive(owner)) await unlink(
|
|
5119
|
+
if (!lockAlive(owner)) await unlink(path2.join(directory, owner.token)).catch((error2) => {
|
|
4839
5120
|
if (error2.code !== "ENOENT") throw error2;
|
|
4840
5121
|
});
|
|
4841
5122
|
}
|
|
4842
5123
|
await rmdir(directory).catch((error2) => {
|
|
4843
5124
|
if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error2.code)) throw error2;
|
|
4844
5125
|
});
|
|
4845
|
-
await
|
|
5126
|
+
await delay(25, void 0, { signal });
|
|
4846
5127
|
}
|
|
4847
5128
|
}
|
|
4848
5129
|
try {
|
|
5130
|
+
signal?.throwIfAborted();
|
|
4849
5131
|
return await run2();
|
|
4850
5132
|
} finally {
|
|
4851
|
-
await unlink(
|
|
5133
|
+
await unlink(path2.join(directory, token));
|
|
4852
5134
|
await rmdir(directory).catch((error) => {
|
|
4853
5135
|
if (!["ENOENT", "ENOTEMPTY", "EEXIST"].includes(error.code)) throw error;
|
|
4854
5136
|
});
|
|
4855
5137
|
}
|
|
4856
5138
|
} finally {
|
|
4857
|
-
await unlink(
|
|
5139
|
+
await unlink(path2.join(candidate, token)).catch((error) => {
|
|
4858
5140
|
if (error.code !== "ENOENT") throw error;
|
|
4859
5141
|
});
|
|
4860
5142
|
await rmdir(candidate).catch((error) => {
|
|
@@ -4865,8 +5147,12 @@ async function withDaemonLifecycle(home, action, run2, { joinStart = false } = {
|
|
|
4865
5147
|
async function ensureDaemon({ home = alpHome(), entry = (
|
|
4866
5148
|
/** @type {string | undefined} */
|
|
4867
5149
|
void 0
|
|
4868
|
-
), env = process.env, execPath = process.execPath, timeoutMs = 15e3, lifecycleLocked = false
|
|
4869
|
-
|
|
5150
|
+
), env = process.env, execPath = process.execPath, timeoutMs = 15e3, lifecycleLocked = false, signal = (
|
|
5151
|
+
/** @type {AbortSignal | undefined} */
|
|
5152
|
+
void 0
|
|
5153
|
+
) } = {}) {
|
|
5154
|
+
signal?.throwIfAborted();
|
|
5155
|
+
if (!lifecycleLocked) return withDaemonLifecycle(home, "start", () => ensureDaemon({ home, entry, env, execPath, timeoutMs, lifecycleLocked: true, signal }), { signal });
|
|
4870
5156
|
const ready = async () => {
|
|
4871
5157
|
const lock = await readLock(home);
|
|
4872
5158
|
return lockAlive(lock) && lock.ready ? lock.socket : void 0;
|
|
@@ -4878,8 +5164,10 @@ async function ensureDaemon({ home = alpHome(), entry = (
|
|
|
4878
5164
|
if (!lockAlive(held)) {
|
|
4879
5165
|
entry ??= await findDaemonEntry({ home, env });
|
|
4880
5166
|
if (!entry) throw new Error("ALP daemon is not running and alpd.js was not found. Install the ALP CLI and run `alp daemon start`, or set ALP_DAEMON_ENTRY to alpd.js");
|
|
5167
|
+
signal?.throwIfAborted();
|
|
4881
5168
|
await new Promise((resolve2, reject) => {
|
|
4882
|
-
const
|
|
5169
|
+
const launch = entryCommand(entry, "daemon", ["--detach", `--startup-timeout=${timeoutMs}`], execPath);
|
|
5170
|
+
const launcher = spawn(launch.command, launch.args, {
|
|
4883
5171
|
env: { ...env, ALP_HOME: home, ELECTRON_RUN_AS_NODE: "1" },
|
|
4884
5172
|
stdio: ["ignore", "ignore", "pipe"],
|
|
4885
5173
|
windowsHide: true
|
|
@@ -4894,6 +5182,7 @@ async function ensureDaemon({ home = alpHome(), entry = (
|
|
|
4894
5182
|
}
|
|
4895
5183
|
const deadline = Date.now() + timeoutMs;
|
|
4896
5184
|
while (Date.now() < deadline) {
|
|
5185
|
+
signal?.throwIfAborted();
|
|
4897
5186
|
const socket = await ready();
|
|
4898
5187
|
if (socket) return socket;
|
|
4899
5188
|
await new Promise((resolve2) => setTimeout(resolve2, 100));
|
|
@@ -4905,16 +5194,33 @@ ${log}` : ""}`);
|
|
|
4905
5194
|
|
|
4906
5195
|
// packages/client/src/integration-lock.js
|
|
4907
5196
|
import { randomUUID as randomUUID2 } from "node:crypto";
|
|
4908
|
-
import { mkdir as mkdir2, open as open2,
|
|
4909
|
-
import
|
|
5197
|
+
import { mkdir as mkdir2, open as open2, rmdir as rmdir2, unlink as unlink2 } from "node:fs/promises";
|
|
5198
|
+
import os3 from "node:os";
|
|
5199
|
+
import path3 from "node:path";
|
|
5200
|
+
|
|
5201
|
+
// packages/core/src/atomic.js
|
|
5202
|
+
import { rename as rename2, rm, writeFile as writeFile2 } from "node:fs/promises";
|
|
5203
|
+
async function moveFile(from, to) {
|
|
5204
|
+
for (let attempt = 0; ; attempt++) {
|
|
5205
|
+
try {
|
|
5206
|
+
return await rename2(from, to);
|
|
5207
|
+
} catch (error) {
|
|
5208
|
+
if (process.platform !== "win32" || attempt >= 20 || !["EPERM", "EACCES", "EBUSY"].includes(error?.code)) throw error;
|
|
5209
|
+
await new Promise((resolve2) => setTimeout(resolve2, 10 + attempt * 10));
|
|
5210
|
+
}
|
|
5211
|
+
}
|
|
5212
|
+
}
|
|
5213
|
+
|
|
5214
|
+
// packages/client/src/integration-lock.js
|
|
4910
5215
|
function createIntegrationLock(home, name2) {
|
|
4911
|
-
const file =
|
|
5216
|
+
const file = path3.join(home, "integrations", `${assertIntegrationName(name2)}.lock`);
|
|
4912
5217
|
const guard = `${file}.reclaim`;
|
|
4913
5218
|
let phase = "new";
|
|
4914
5219
|
let owned;
|
|
5220
|
+
let readyQueue = Promise.resolve();
|
|
4915
5221
|
const recovery = (reason) => new Error(`${reason}. Stop ALL integration processes using this ALP_HOME before manual lock-only recovery of ${file} and ${guard}; see docs/modular-monorepo.md`);
|
|
4916
5222
|
async function guarded(run2) {
|
|
4917
|
-
await mkdir2(
|
|
5223
|
+
await mkdir2(path3.dirname(file), { recursive: true, mode: 448 });
|
|
4918
5224
|
const deadline = Date.now() + 2e4;
|
|
4919
5225
|
for (; ; ) {
|
|
4920
5226
|
try {
|
|
@@ -4929,7 +5235,7 @@ function createIntegrationLock(home, name2) {
|
|
|
4929
5235
|
await new Promise((resolve2) => setTimeout(resolve2, 25));
|
|
4930
5236
|
}
|
|
4931
5237
|
}
|
|
4932
|
-
const token =
|
|
5238
|
+
const token = path3.join(guard, `owner-${process.pid}-${randomUUID2()}`);
|
|
4933
5239
|
try {
|
|
4934
5240
|
const handle = await open2(token, "wx", 384);
|
|
4935
5241
|
await handle.close();
|
|
@@ -4980,7 +5286,7 @@ function createIntegrationLock(home, name2) {
|
|
|
4980
5286
|
}
|
|
4981
5287
|
}
|
|
4982
5288
|
function complete(value) {
|
|
4983
|
-
return value && Number.isSafeInteger(value.pid) && value.pid > 0 && typeof value.bootTime === "number" && Number.isFinite(value.bootTime) && value.bootTime > 0 && typeof value.startedAt === "string" && Number.isFinite(Date.parse(value.startedAt)) && typeof value.ready === "boolean" && (value.lockVersion === void 0 && value.owner === void 0 || value.lockVersion === 1 && typeof value.owner === "string" && /^[a-f0-9-]{36}$/.test(value.owner));
|
|
5289
|
+
return value && Number.isSafeInteger(value.pid) && value.pid > 0 && typeof value.bootTime === "number" && Number.isFinite(value.bootTime) && value.bootTime > 0 && (value.bootId === void 0 || typeof value.bootId === "string" && value.bootId.length > 0) && (value.startedUptime === void 0 || typeof value.startedUptime === "number" && Number.isFinite(value.startedUptime)) && typeof value.startedAt === "string" && Number.isFinite(Date.parse(value.startedAt)) && typeof value.ready === "boolean" && (value.lockVersion === void 0 && value.owner === void 0 || value.lockVersion === 1 && typeof value.owner === "string" && /^[a-f0-9-]{36}$/.test(value.owner));
|
|
4984
5290
|
}
|
|
4985
5291
|
function dead(value) {
|
|
4986
5292
|
try {
|
|
@@ -4991,7 +5297,7 @@ function createIntegrationLock(home, name2) {
|
|
|
4991
5297
|
/** @type {any} */
|
|
4992
5298
|
error?.code !== "ESRCH"
|
|
4993
5299
|
) return false;
|
|
4994
|
-
if (
|
|
5300
|
+
if (!isSameBoot(value)) throw recovery("Integration owner boot context is uncertain");
|
|
4995
5301
|
return true;
|
|
4996
5302
|
}
|
|
4997
5303
|
}
|
|
@@ -5013,7 +5319,17 @@ function createIntegrationLock(home, name2) {
|
|
|
5013
5319
|
}
|
|
5014
5320
|
await unlink2(file);
|
|
5015
5321
|
}
|
|
5016
|
-
const
|
|
5322
|
+
const currentBootId = bootId();
|
|
5323
|
+
const value = {
|
|
5324
|
+
pid: process.pid,
|
|
5325
|
+
bootTime: bootTime(),
|
|
5326
|
+
...currentBootId ? { bootId: currentBootId } : {},
|
|
5327
|
+
startedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
|
5328
|
+
startedUptime: Math.floor(os3.uptime()),
|
|
5329
|
+
ready: false,
|
|
5330
|
+
lockVersion: 1,
|
|
5331
|
+
owner: randomUUID2()
|
|
5332
|
+
};
|
|
5017
5333
|
const handle = await open2(file, "wx", 384);
|
|
5018
5334
|
let info;
|
|
5019
5335
|
try {
|
|
@@ -5034,34 +5350,41 @@ function createIntegrationLock(home, name2) {
|
|
|
5034
5350
|
},
|
|
5035
5351
|
async setReady(ready) {
|
|
5036
5352
|
if (phase !== "owned") return false;
|
|
5037
|
-
|
|
5353
|
+
const execute = async () => {
|
|
5038
5354
|
if (phase !== "owned") return false;
|
|
5039
|
-
|
|
5040
|
-
|
|
5041
|
-
|
|
5042
|
-
|
|
5043
|
-
|
|
5044
|
-
|
|
5045
|
-
|
|
5046
|
-
|
|
5047
|
-
|
|
5048
|
-
|
|
5049
|
-
|
|
5355
|
+
return guarded(async () => {
|
|
5356
|
+
if (phase !== "owned") return false;
|
|
5357
|
+
const current = await snapshot();
|
|
5358
|
+
if (!current || !matches(current)) {
|
|
5359
|
+
phase = "retired";
|
|
5360
|
+
owned = void 0;
|
|
5361
|
+
return false;
|
|
5362
|
+
}
|
|
5363
|
+
const value = { ...current.value, ready };
|
|
5364
|
+
const tmp = `${file}.${randomUUID2()}.tmp`;
|
|
5365
|
+
const handle = await open2(tmp, "wx", 384);
|
|
5366
|
+
let info;
|
|
5050
5367
|
try {
|
|
5051
|
-
|
|
5052
|
-
|
|
5368
|
+
try {
|
|
5369
|
+
await handle.writeFile(JSON.stringify(value));
|
|
5370
|
+
info = await handle.stat();
|
|
5371
|
+
} finally {
|
|
5372
|
+
await handle.close();
|
|
5373
|
+
}
|
|
5374
|
+
await moveFile(tmp, file);
|
|
5375
|
+
owned = { owner: value.owner, dev: info.dev, ino: info.ino };
|
|
5376
|
+
return true;
|
|
5053
5377
|
} finally {
|
|
5054
|
-
await
|
|
5378
|
+
await unlink2(tmp).catch((error) => {
|
|
5379
|
+
if (error?.code !== "ENOENT") throw error;
|
|
5380
|
+
});
|
|
5055
5381
|
}
|
|
5056
|
-
|
|
5057
|
-
|
|
5058
|
-
|
|
5059
|
-
|
|
5060
|
-
await unlink2(tmp).catch((error) => {
|
|
5061
|
-
if (error?.code !== "ENOENT") throw error;
|
|
5062
|
-
});
|
|
5063
|
-
}
|
|
5382
|
+
});
|
|
5383
|
+
};
|
|
5384
|
+
const chained = readyQueue.then(execute, execute);
|
|
5385
|
+
readyQueue = chained.catch(() => {
|
|
5064
5386
|
});
|
|
5387
|
+
return chained;
|
|
5065
5388
|
},
|
|
5066
5389
|
async release() {
|
|
5067
5390
|
if (phase !== "owned") return false;
|
|
@@ -5080,14 +5403,14 @@ function createIntegrationLock(home, name2) {
|
|
|
5080
5403
|
}
|
|
5081
5404
|
|
|
5082
5405
|
// packages/client/src/supervise.js
|
|
5083
|
-
import { mkdir as mkdir4, unlink as unlink4, writeFile as
|
|
5084
|
-
import
|
|
5406
|
+
import { mkdir as mkdir4, unlink as unlink4, writeFile as writeFile4, stat as stat2 } from "node:fs/promises";
|
|
5407
|
+
import path5 from "node:path";
|
|
5085
5408
|
|
|
5086
5409
|
// packages/client/src/service.js
|
|
5087
|
-
import { createHash as
|
|
5088
|
-
import { mkdir as mkdir3, readFile as readFile2, unlink as unlink3, writeFile as
|
|
5089
|
-
import
|
|
5090
|
-
import
|
|
5410
|
+
import { createHash as createHash3 } from "node:crypto";
|
|
5411
|
+
import { mkdir as mkdir3, readFile as readFile2, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
|
|
5412
|
+
import os4 from "node:os";
|
|
5413
|
+
import path4 from "node:path";
|
|
5091
5414
|
|
|
5092
5415
|
// packages/client/src/command.js
|
|
5093
5416
|
import { spawn as spawn2 } from "node:child_process";
|
|
@@ -5095,8 +5418,9 @@ function runCommand(command, args, { cwd, env = process.env, timeoutMs = 15e3 }
|
|
|
5095
5418
|
return new Promise((resolve2) => {
|
|
5096
5419
|
let child;
|
|
5097
5420
|
const script = process.platform === "win32" && /\.[cm]?js$/i.test(command);
|
|
5421
|
+
const run2 = script ? scriptCommand(command, args) : { command, args };
|
|
5098
5422
|
try {
|
|
5099
|
-
child = spawn2(
|
|
5423
|
+
child = spawn2(run2.command, run2.args, { cwd, env: run2.env ? { ...env, ...run2.env } : env, stdio: ["ignore", "pipe", "pipe"] });
|
|
5100
5424
|
} catch (error) {
|
|
5101
5425
|
resolve2({ code: -1, stdout: "", stderr: error.message });
|
|
5102
5426
|
return;
|
|
@@ -5122,14 +5446,14 @@ function runCommand(command, args, { cwd, env = process.env, timeoutMs = 15e3 }
|
|
|
5122
5446
|
|
|
5123
5447
|
// packages/client/src/service.js
|
|
5124
5448
|
function serviceFor({ home, env = process.env, platform = process.platform, uid = process.getuid?.() ?? 0 }) {
|
|
5125
|
-
const custom =
|
|
5126
|
-
const suffix = custom ?
|
|
5449
|
+
const custom = path4.resolve(home) !== path4.join(os4.homedir(), ".alp");
|
|
5450
|
+
const suffix = custom ? createHash3("sha256").update(path4.resolve(home)).digest("hex").slice(0, 8) : "";
|
|
5127
5451
|
if (platform === "darwin") {
|
|
5128
5452
|
const label = `com.alp.alpd${suffix ? `.${suffix}` : ""}`;
|
|
5129
|
-
const directory = env.ALP_SERVICE_DIR ||
|
|
5453
|
+
const directory = env.ALP_SERVICE_DIR || path4.join(os4.homedir(), "Library", "LaunchAgents");
|
|
5130
5454
|
const launchctl = env.ALP_LAUNCHCTL || "launchctl";
|
|
5131
5455
|
const target = `gui/${uid}/${label}`;
|
|
5132
|
-
const file =
|
|
5456
|
+
const file = path4.join(directory, `${label}.plist`);
|
|
5133
5457
|
return {
|
|
5134
5458
|
kind: "launchd",
|
|
5135
5459
|
name: label,
|
|
@@ -5141,12 +5465,12 @@ function serviceFor({ home, env = process.env, platform = process.platform, uid
|
|
|
5141
5465
|
}
|
|
5142
5466
|
if (platform === "linux") {
|
|
5143
5467
|
const name2 = `alpd${suffix ? `-${suffix}` : ""}`;
|
|
5144
|
-
const directory = env.ALP_SERVICE_DIR ||
|
|
5468
|
+
const directory = env.ALP_SERVICE_DIR || path4.join(env.XDG_CONFIG_HOME || path4.join(os4.homedir(), ".config"), "systemd", "user");
|
|
5145
5469
|
const systemctl = env.ALP_SYSTEMCTL || "systemctl";
|
|
5146
5470
|
return {
|
|
5147
5471
|
kind: "systemd",
|
|
5148
5472
|
name: name2,
|
|
5149
|
-
file:
|
|
5473
|
+
file: path4.join(directory, `${name2}.service`),
|
|
5150
5474
|
install: [[systemctl, ["--user", "daemon-reload"]], [systemctl, ["--user", "enable", "--now", `${name2}.service`]]],
|
|
5151
5475
|
start: [[systemctl, ["--user", "start", `${name2}.service`]]],
|
|
5152
5476
|
uninstall: [[systemctl, ["--user", "disable", "--now", `${name2}.service`], { ignore: true }]],
|
|
@@ -5177,7 +5501,7 @@ async function startService(service, run2 = runCommand) {
|
|
|
5177
5501
|
}
|
|
5178
5502
|
|
|
5179
5503
|
// packages/client/src/supervise.js
|
|
5180
|
-
var holdFile = (home) =>
|
|
5504
|
+
var holdFile = (home) => path5.join(home, "state", "alpd.held");
|
|
5181
5505
|
async function releaseHold(home) {
|
|
5182
5506
|
await unlink4(holdFile(home)).catch(() => {
|
|
5183
5507
|
});
|
|
@@ -5185,29 +5509,33 @@ async function releaseHold(home) {
|
|
|
5185
5509
|
async function daemonHeld(home) {
|
|
5186
5510
|
return stat2(holdFile(home)).then(() => true, () => false);
|
|
5187
5511
|
}
|
|
5188
|
-
async function whenReady(home, timeoutMs) {
|
|
5512
|
+
async function whenReady(home, timeoutMs, signal) {
|
|
5189
5513
|
const deadline = Date.now() + timeoutMs;
|
|
5190
5514
|
while (Date.now() < deadline) {
|
|
5515
|
+
signal?.throwIfAborted();
|
|
5191
5516
|
const lock = await readLock(home);
|
|
5192
5517
|
if (lockAlive(lock) && lock.ready) return lock.socket;
|
|
5193
5518
|
await new Promise((resolve2) => setTimeout(resolve2, 100));
|
|
5194
5519
|
}
|
|
5195
|
-
throw new Error(`alpd did not become ready within ${timeoutMs / 1e3} s; see ${
|
|
5520
|
+
throw new Error(`alpd did not become ready within ${timeoutMs / 1e3} s; see ${path5.join(home, "logs")}`);
|
|
5196
5521
|
}
|
|
5197
|
-
async function startDaemon({ home, entry, env = process.env, timeoutMs = 15e3, automatic = false }) {
|
|
5522
|
+
async function startDaemon({ home, entry, env = process.env, timeoutMs = 15e3, automatic = false, signal }) {
|
|
5198
5523
|
return withDaemonLifecycle(home, "start", async () => {
|
|
5524
|
+
signal?.throwIfAborted();
|
|
5199
5525
|
if (automatic) {
|
|
5200
5526
|
if (await daemonHeld(home)) return;
|
|
5201
5527
|
} else await releaseHold(home);
|
|
5202
5528
|
const lock = await readLock(home);
|
|
5203
|
-
|
|
5529
|
+
signal?.throwIfAborted();
|
|
5530
|
+
if (lockAlive(lock)) return lock.ready ? lock.socket : whenReady(home, timeoutMs, signal);
|
|
5204
5531
|
const service = serviceFor({ home, env });
|
|
5205
5532
|
if (service && await installedProgram(service)) {
|
|
5533
|
+
signal?.throwIfAborted();
|
|
5206
5534
|
await startService(service);
|
|
5207
|
-
return whenReady(home, timeoutMs);
|
|
5535
|
+
return whenReady(home, timeoutMs, signal);
|
|
5208
5536
|
}
|
|
5209
|
-
return ensureDaemon({ home, entry, env, timeoutMs, lifecycleLocked: true });
|
|
5210
|
-
});
|
|
5537
|
+
return ensureDaemon({ home, entry, env, timeoutMs, lifecycleLocked: true, signal });
|
|
5538
|
+
}, { signal });
|
|
5211
5539
|
}
|
|
5212
5540
|
function superviseDaemon({ home, entry, env = process.env, intervalMs = 5e3, misses = 2, log = () => {
|
|
5213
5541
|
}, by }) {
|
|
@@ -5363,7 +5691,7 @@ var nonempty = (value) => typeof value === "string" && value.trim().length > 0;
|
|
|
5363
5691
|
function requireValue(condition, code, source, message) {
|
|
5364
5692
|
if (!condition) throw new AlpError(code, `${source}: ${message}`);
|
|
5365
5693
|
}
|
|
5366
|
-
var USER_SETTINGS = ["$schema", "language", "permissions", "limits", "recovery", "web"];
|
|
5694
|
+
var USER_SETTINGS = ["$schema", "language", "permissions", "limits", "recovery", "web", "curate"];
|
|
5367
5695
|
var RETIRED_SETTINGS = { project: {}, user: {} };
|
|
5368
5696
|
function distance(a, b) {
|
|
5369
5697
|
const row = Array.from({ length: b.length + 1 }, (_, index) => index);
|
|
@@ -5393,11 +5721,18 @@ function settingsKeys(settings, known, retired = {}) {
|
|
|
5393
5721
|
return { unknown, retired: old };
|
|
5394
5722
|
}
|
|
5395
5723
|
var unknownMessage = (unknown, known) => `unknown setting '${unknown.key}'${unknown.suggestion ? `; did you mean '${unknown.suggestion}'?` : `; known settings are ${known.filter((key2) => !key2.startsWith("$")).join(", ")}`}`;
|
|
5724
|
+
function checkCurate(settings, check2) {
|
|
5725
|
+
if (settings.curate === void 0) return;
|
|
5726
|
+
check2(object2(settings.curate), "curate must be an object");
|
|
5727
|
+
check2(Object.keys(settings.curate).every((key2) => key2 === "monthly"), "unsupported curate field; use monthly");
|
|
5728
|
+
if (settings.curate.monthly !== void 0) check2(typeof settings.curate.monthly === "boolean", "curate.monthly must be true or false");
|
|
5729
|
+
}
|
|
5396
5730
|
function validateUserSettings(settings, source) {
|
|
5397
5731
|
const check2 = (ok, message) => requireValue(ok, "INVALID_SETTINGS", source, message);
|
|
5398
5732
|
check2(object2(settings), "expected an object");
|
|
5399
5733
|
const { unknown } = settingsKeys(settings, USER_SETTINGS, RETIRED_SETTINGS.user);
|
|
5400
5734
|
check2(!unknown.length, unknown.length ? unknownMessage(unknown[0], USER_SETTINGS) : "");
|
|
5735
|
+
checkCurate(settings, check2);
|
|
5401
5736
|
for (const key2 of ["limits", "recovery"]) {
|
|
5402
5737
|
if (settings[key2] === void 0) continue;
|
|
5403
5738
|
check2(object2(settings[key2]), `${key2} must be an object`);
|
|
@@ -5445,11 +5780,11 @@ var import_websocket_server = __toESM(require_websocket_server(), 1);
|
|
|
5445
5780
|
|
|
5446
5781
|
// apps/gateway/src/connection.js
|
|
5447
5782
|
import { realpath as registryRealpath, stat as registryStat } from "node:fs/promises";
|
|
5448
|
-
import { createCipheriv, createDecipheriv, randomBytes, createHash as
|
|
5783
|
+
import { createCipheriv, createDecipheriv, randomBytes, createHash as createHash4 } from "node:crypto";
|
|
5449
5784
|
import { homedir } from "node:os";
|
|
5450
5785
|
|
|
5451
5786
|
// packages/protocol/src/contract-v1.js
|
|
5452
|
-
var METHODS_V1 = { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://alp.dev/schemas/methods-v1.json", "protocolVersion": 1, "errors": { "parseError": -32700, "invalidRequest": -32600, "methodNotFound": -32601, "invalidParams": -32602, "failed": 1e3, "notFound": 1001, "forbidden": 1003, "conflict": 1004, "unavailable": 1005, "protocol": 1006 }, "capabilities": { "attach.after": "session.attach accepts `after` and answers `cursor`/`reset`; envelopes kept in a tree timeline carry `cursor`.", "prompt.receipts": "session.prompt is answered at most once per (sessionId, clientMessageId) from a durable receipt; repeats answer the first outcome or outcome_unknown.", "extension.methods": "extension.register/unregister, and the daemon sends extension.invoke requests to the owning connection.", "team": "team.list: the teams a project can use, from the daemon host's built-ins, library and project.", "task": "task.list, task.create, task.update and task.gate.resolve on a project's .alp/tasks, written by the daemon under the task lock.", "library": "library.list/get/save/delete/duplicate/rename, library.skills.set and library.models on the daemon user's library and a project's .alp overrides; secrets are redacted on read.", "settings.language": "settings.language.get/set: the language the daemon user reads, in the daemon's ALP_HOME/settings.json.", "session.list.page": "session.list accepts `limit`, `cursor` and `query` and answers `nextCursor` while more sessions follow; without them it answers every session as before.", "question.watch": "question.watch: the connection is told of `question` and `question.resolved` in every tree (of a projectRoot when given), attached or not.", "question.watch.turns": "question.watch accepts `turns`: the connection is also told of `turn.ended` of every root in the trees it watches.", "session.attention": "question.watch accepts `attention`: its answer holds each watched root's finished or error attention, kept by alpd for every client, and the connection is told when one is set or cleared (an `attention` event); session.attention.clear acknowledges one.", "workspace.files": "workspace.files.search: files under a directory whose relative path matches a query; read-only, names only, links never followed.", "workspace.files.read": "workspace.files.list and workspace.files.read: the entries of a directory and the content of a UTF-8 text file (at most 1 MiB) under a directory; read-only, links never followed, .git, .env* and key or credential files refused, .gitignore'd paths hidden unless asked.", "prompt.images": 'session.prompt takes inline image parts { type: "image", mimeType, data } (base64, no paths or URLs) within the image limits; a session snapshot says whether its runtime takes them in promptImages.', "library.project.write": "library save/delete/duplicate/rename accept policy project-data: only project-only pure-data agents and skills, no executable configuration, sidecars or library/built-in collisions.", "schedule": "schedule.create/list/get/cancel: one-shot continuations of a root session. alpd opens the turn by itself when the time comes; a job that comes due late says how late it is, and a job that cannot run says why.", "session.history": "Durable bounded backward envelope pages, persisted generation and numeric attach watermark.", "workspace.registry": "Daemon-owned project/workspace registry, durable pins, revision CAS and requestId replay.", "workspace.worktree": "Host-approved managed user worktrees; opt-in workspace.manage and named destination mappings.", "workspace.git": "workspace.git.status and workspace.git.diff: a registered workspace's read-only Git status and structured diff hunks by workspaceId; enumerated comparisons only, bounded (1 MiB per file, 2 MiB per page, 200 untracked files) with an opaque snapshot and next cursor; blocked secret paths withheld on both sides of a rename; no Git mutation.", "attachments": 'attachment.begin/chunk/commit/abort/get/delete: daemon-owned immutable non-image attachments by opaque id, uploaded in bounded chunks, and session.prompt content parts `{ type: "attachment", attachmentId }`; daemon.hello carries `attachmentLimits`. Listed only with a home and a store, on macOS and Linux.', "session.fork": "session.fork: a new root whose conversation is a root's up to a completed turn (or a branch a rewind set aside), by native fork of Codex and Claude sessions; files are never copied or changed. Listed with a store and a runtime that forks native conversations, on macOS and Linux (not Windows).", "session.rewind": "session.rewind: a root's conversation from before a turn on, under the same session id; the later turns stay a recoverable branch, files are never changed, history generation advances (`history.reset` event). Same condition as session.fork.", "session.reload": "session.reload: restarts a live root's native process on its own conversation and configuration at the idle barrier (no turn, child, question, mail or parked work), keeping its session id, history and receipts; through the lifecycle journal. Listed with a store and a runtime that restarts a root on its own conversation, on macOS and Linux (not Windows).", "session.resumeCommand": "session.resumeCommand: the ALP CLI command (`alp attach <sessionId>`) that follows a session in a terminal, as argv and POSIX and Windows (cmd.exe) command lines built by alpd; for the clipboard only, never run, never a native runtime's command, credential, env or path.", "session.configure.live": "session.configure takes model, thinking and team (with requestId and ifGeneration) besides mode, and session.configure.preview answers the configuration a change would run with: a live root's model, effort or team changes at the idle barrier (no turn, child, question, mail or parked work) through a controlled restart of its native process on the same conversation; the effective configuration is written only after the runtime took it, through the lifecycle journal (\xA712.9). Never another runtime and never more permissions. Listed with a store and a runtime that restarts a root with a new configuration, on macOS and Linux (not Windows).", "terminal": "terminal.create/list/attach/input/resize/close/revoke and terminal.event notifications: a real PTY shell on the daemon host as the daemon's account (a cwd is not a sandbox), served only when the host owner opted in (<ALP_HOME>/terminal.json allowRemoteTerminal) on macOS and Linux.", "session.interrupt.turn": "session.interrupt accepts turnId and atomically cancels only that active turn, including its subtree. Conditional requests answer interrupted:true when canceled, false when the named turn is no longer active; false changes nothing. Without this capability clients must not send turnId or infer targeted cancellation from a legacy interrupt." }, "methods": { "assignment.recall": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "projectRoot", "required": false, "alternatives": ["assignmentId", "taskId"] }, "idempotent": false, "risks": ["model call"] }, "params": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "taskId": { "type": "string" }, "projectRoot": { "type": "string" }, "question": { "type": "string" } }, "required": ["question"], "additionalProperties": true }, "result": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "taskId": { "type": "string" }, "finishedAt": { "type": "string" }, "answer": { "type": "string" } }, "required": ["assignmentId", "agent", "finishedAt", "answer"], "additionalProperties": true } }, "board.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "pins": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["pins"], "additionalProperties": true } }, "catalog.get": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object" } }, "modes": { "type": "array", "items": { "type": "object" } }, "thinkingOptions": {}, "defaultModel": { "type": "string" } }, "required": ["models", "modes", "defaultModel"], "additionalProperties": true } }, "daemon.hello": { "x-alp": { "effect": "query", "scope": { "kind": "connection" }, "idempotent": true }, "params": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "client": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": ["name", "version"], "additionalProperties": true }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": ["protocolVersion"], "additionalProperties": true }, "result": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "daemonVersion": { "type": "string" }, "pid": { "type": "integer" }, "hostname": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "promptImageLimits": { "type": "object", "description": "Optional effective inline image limits for this connection, when prompt.images is advertised. Missing on older peers. Byte limits count decoded bytes.", "properties": { "maxCount": { "type": "integer", "minimum": 0 }, "maxBytes": { "type": "integer", "minimum": 0 }, "maxTotalBytes": { "type": "integer", "minimum": 0 } }, "required": ["maxCount", "maxBytes", "maxTotalBytes"], "additionalProperties": false }, "attachmentLimits": { "type": "object", "description": "Effective attachment limits for this connection, when `attachments` is advertised. Byte limits count decoded bytes; times are milliseconds. An operator or a gateway may lower them, never raise them.", "properties": { "maxObjectBytes": { "type": "integer", "minimum": 0 }, "maxPerPrompt": { "type": "integer", "minimum": 0 }, "maxPromptBytes": { "type": "integer", "minimum": 0 }, "maxChunkBytes": { "type": "integer", "minimum": 0 }, "maxActiveUploads": { "type": "integer", "minimum": 0 }, "maxPrincipalBytes": { "type": "integer", "minimum": 0 }, "maxDaemonBytes": { "type": "integer", "minimum": 0 }, "uploadTimeoutMs": { "type": "integer", "minimum": 0 }, "unreferencedRetentionMs": { "type": "integer", "minimum": 0 }, "releasedGraceMs": { "type": "integer", "minimum": 0 } }, "required": ["maxObjectBytes", "maxPerPrompt", "maxPromptBytes", "maxChunkBytes", "maxActiveUploads", "maxPrincipalBytes", "maxDaemonBytes", "uploadTimeoutMs", "unreferencedRetentionMs", "releasedGraceMs"], "additionalProperties": false }, "terminalLimits": { "type": "object", "description": "Effective terminal limits for this connection, when `terminal` is advertised. Byte limits count UTF-8 bytes; times are milliseconds. An operator or a gateway may lower them, never raise them.", "properties": { "maxPerPrincipal": { "type": "integer", "minimum": 0 }, "maxPerDaemon": { "type": "integer", "minimum": 0 }, "maxInputBytes": { "type": "integer", "minimum": 0 }, "maxOutputFrameBytes": { "type": "integer", "minimum": 0 }, "replayBytes": { "type": "integer", "minimum": 0 }, "idleMs": { "type": "integer", "minimum": 0 }, "maxLifetimeMs": { "type": "integer", "minimum": 0 }, "reconnectMs": { "type": "integer", "minimum": 0 } }, "required": ["maxPerPrincipal", "maxPerDaemon", "maxInputBytes", "maxOutputFrameBytes", "replayBytes", "idleMs", "maxLifetimeMs", "reconnectMs"], "additionalProperties": false } }, "required": ["protocolVersion"], "additionalProperties": true } }, "daemon.pause": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] }, "now": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.pauses": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.resume": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.shutdown": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "daemon.status": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "pid": { "type": "integer" }, "startedAt": { "type": "string" }, "version": { "type": "string" }, "protocolVersion": { "type": "integer" }, "sessions": { "type": "integer" }, "questions": { "type": "integer" }, "previousExit": { "type": "object", "properties": { "kind": { "enum": ["clean", "crash"] }, "at": { "type": "string" } }, "required": ["kind"], "additionalProperties": true }, "persistence": { "type": "object" }, "health": { "$ref": "#/$defs/health" } }, "required": ["pid", "startedAt", "version", "protocolVersion", "sessions", "questions", "health"], "additionalProperties": true } }, "daemon.usage": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true, "risks": ["refresh asks every provider (spawns on the daemon host)"] }, "params": { "type": "object", "properties": { "refresh": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "object" } } }, "required": ["providers"], "additionalProperties": true } }, "extension.register": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "registered": { "type": "string" } }, "required": ["registered"], "additionalProperties": true } }, "extension.unregister": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "unregistered": { "type": "string" } }, "required": ["unregistered"], "additionalProperties": true } }, "library.delete": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "revision": { "type": "string" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "name", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "removed": { "const": true }, "now": { "enum": ["builtin", "library"] } }, "required": ["removed"], "additionalProperties": true } }, "library.duplicate": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope", "reads": ["builtin", "library"] }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.get": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true, "redacts": ["mcp /server/env/*", "mcp /server/headers/*", "providers /provider/env/*"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "scope": { "$ref": "#/$defs/libraryScope" } }, "required": ["kind", "name"], "additionalProperties": true }, "result": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "usedBy": { "type": "array", "items": { "type": "string" } }, "librarySkills": { "type": "array", "items": { "type": "string" } }, "secrets": { "type": "array", "items": { "type": "string" } } }, "required": ["kind", "name", "source", "content", "revision", "usedBy"], "additionalProperties": true } }, "library.list": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["kind"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "entries": { "type": "array", "items": { "$ref": "#/$defs/libraryEntryRow" } } }, "required": ["projectRoot", "entries"], "additionalProperties": true } }, "library.models": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "efforts": { "type": "array", "items": { "type": "string" } }, "effort": { "type": "string" } }, "required": ["id", "label", "efforts"], "additionalProperties": true } } }, "required": ["models"], "additionalProperties": true } }, "library.rename": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.save": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": "with revision (a repeat fails revision_conflict)", "risks": ["exec-config when kind is mcp, hooks or providers, or agents naming mcp/hooks/provider", "writes every known project's .alp/settings.json when kind is teams and sync is known-projects"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "sync": { "enum": ["none", "known-projects"] }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "name", "scope", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" }, "syncedProjects": { "type": "integer", "minimum": 0 }, "syncErrors": { "type": "array", "items": { "type": "string" } } }, "required": ["revision"], "additionalProperties": true } }, "library.skills.set": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "host" }, "writes": ["ALP_HOME/role-skills.json"], "idempotent": true }, "params": { "type": "object", "properties": { "agent": { "$ref": "#/$defs/entryName" }, "skills": { "type": "array", "items": { "$ref": "#/$defs/entryName" }, "maxItems": 100 } }, "required": ["agent", "skills"], "additionalProperties": true }, "result": { "type": "object", "properties": { "skills": { "type": "array", "items": { "type": "string" } } }, "required": ["skills"], "additionalProperties": true } }, "question.answer": { "x-alp": { "effect": "mutation", "scope": { "kind": "question", "param": "questionId", "prefix": true }, "idempotent": false }, "params": { "type": "object", "properties": { "questionId": { "type": "string" }, "text": { "type": "string" }, "dismiss": { "type": "boolean" }, "reason": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "questionId": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true } }, "question.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } } }, "required": ["questions"], "additionalProperties": true } }, "question.watch": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true, "capability": "question.watch" }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "turns": { "type": "boolean" }, "attention": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } }, "attention": { "type": "array", "items": { "type": "object", "properties": { "sessionId": { "type": "string" }, "attention": { "$ref": "#/$defs/attention" } }, "required": ["sessionId", "attention"], "additionalProperties": true } } }, "required": ["questions"], "additionalProperties": true } }, "session.attention.clear": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true, "capability": "session.attention" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "at": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "cleared": { "type": "boolean" } }, "required": ["cleared"], "additionalProperties": true } }, "schedule.create": { "x-alp": { "effect": "mutation", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["ALP_HOME/schedules"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "dueAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 8e3, "pattern": "\\S" } }, "required": ["projectRoot", "sessionId", "dueAt", "prompt"], "additionalProperties": true }, "result": { "type": "object", "properties": { "job": { "$ref": "#/$defs/scheduleJob" } }, "required": ["job"], "additionalProperties": true } }, "schedule.list": { "x-alp": { "effect": "query", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "status": { "enum": ["pending", "delivered", "failed", "cancelled"] } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "jobs": { "type": "array", "items": { "$ref": "#/$defs/scheduleJob" } } }, "required": ["jobs"], "additionalProperties": true } }, "schedule.get": { "x-alp": { "effect": "query", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "id": { "$ref": "#/$defs/scheduleId" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["id", "projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "job": { "$ref": "#/$defs/scheduleJob" } }, "required": ["job"], "additionalProperties": true } }, "schedule.cancel": { "x-alp": { "effect": "mutation", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["ALP_HOME/schedules"], "idempotent": true }, "params": { "type": "object", "properties": { "id": { "$ref": "#/$defs/scheduleId" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["id", "projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "job": { "$ref": "#/$defs/scheduleJob" } }, "required": ["job"], "additionalProperties": true } }, "session.archive": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "archived": { "type": "boolean" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.attach": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "replay": { "type": "boolean" }, "after": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "generation": { "type": "string", "maxLength": 128 } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "cursor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reset": { "const": true } }, "required": ["session", "cursor"], "additionalProperties": true } }, "session.close": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.configure": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": "mode alone: yes; with model, thinking or team: with requestId", "risks": ["with model, thinking or team: restarts the root's native process on its own conversation; never another runtime, never more permissions"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "mode": { "type": "string" }, "model": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Native model, or runtime-prefixed (codex:/claude:); the session's own runtime only (capability session.configure.live)." }, "thinking": { "type": "string", "minLength": 1, "maxLength": 200, "description": "An effort the model takes (capability session.configure.live)." }, "team": { "type": "string", "minLength": 1, "maxLength": 200, "description": "A team id the daemon host defines (capability session.configure.live); no path or configuration." }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, "required": ["sessionId"], "anyOf": [{ "not": { "anyOf": [{ "required": ["model"] }, { "required": ["thinking"] }, { "required": ["team"] }] } }, { "required": ["requestId", "ifGeneration"] }], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" }, "configured": { "$ref": "#/$defs/configureOutcome" }, "duplicate": { "const": true } }, "required": ["session"], "additionalProperties": true } }, "session.configure.preview": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.configure.live", "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "mode": { "type": "string" }, "model": { "type": "string", "minLength": 1, "maxLength": 200 }, "thinking": { "type": "string", "minLength": 1, "maxLength": 200 }, "team": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/configurePreview" } }, "required": ["preview"], "additionalProperties": true } }, "session.create": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": false, "risks": ["exec: spec.env and stdio spec.mcpServers run on the daemon host", "spec.workdir/writeRoot/copy*/restore/keepThread are internal"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,128}$" }, "spec": { "anyOf": [{ "$ref": "#/$defs/spec" }, { "type": "object", "properties": { "agent": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "persist": { "type": "boolean" }, "workflow": { "type": "string" } }, "required": [], "additionalProperties": false }] }, "history": { "enum": ["skip", "replay"] }, "delegation": { "type": "boolean" }, "resume": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": ["spec"], "additionalProperties": true, "anyOf": [{ "required": ["workspaceId"] }, { "properties": { "spec": { "$ref": "#/$defs/spec" } } }] }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" }, "attached": { "type": "boolean" }, "resumed": { "const": true }, "durable": { "type": "boolean" } }, "required": ["session", "attached"], "additionalProperties": true } }, "session.get": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.interrupt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "turnId": { "type": "string", "minLength": 1 } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "interrupted": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "session.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "rootsOnly": { "type": "boolean" }, "includeClosed": { "type": "boolean" }, "includeArchived": { "type": "boolean" }, "limit": { "type": "integer", "minimum": 1, "maximum": 1e3 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 }, "query": { "type": "string", "maxLength": 200 }, "projectRoots": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 1024 } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/$defs/sessionSummary" } }, "nextCursor": { "type": "string", "minLength": 1 } }, "required": ["sessions"], "additionalProperties": true } }, "session.log": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "rootId": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object" } } }, "required": ["rootId", "entries"], "additionalProperties": true } }, "session.message": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "text": { "type": "string" } }, "required": ["sessionId", "text"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.preview": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": true }, "params": { "type": "object", "properties": { "spec": { "$ref": "#/$defs/spec" } }, "required": ["spec"], "additionalProperties": true }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/preview" } }, "required": ["preview"], "additionalProperties": true } }, "session.prompt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": "with prompt.receipts" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "clientMessageId": { "type": "string" }, "delivery": { "enum": ["auto", "steer"] }, "content": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "type": { "const": "text" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "$ref": "#/$defs/promptImage" }, { "type": "object", "properties": { "type": { "const": "attachment" }, "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" } }, "required": ["type", "attachmentId"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["text", "image", "attachment"] } } }, "required": ["type"], "additionalProperties": true }] } }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["sessionId", "clientMessageId", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "outcome": { "enum": ["accepted", "failed"] }, "error": { "$ref": "#/$defs/alpError" }, "duplicate": { "type": "boolean" }, "durable": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "session.release": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "closed": { "type": "boolean" } }, "required": ["closed"], "additionalProperties": true } }, "session.rename": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" } }, "required": ["sessionId", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.status": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "status": { "$ref": "#/$defs/treeStatus" } }, "required": ["status"], "additionalProperties": true } }, "settings.language.get": { "x-alp": { "effect": "query", "capability": "settings.language", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "settings.language.set": { "x-alp": { "effect": "mutation", "capability": "settings.language", "scope": { "kind": "host" }, "writes": ["ALP_HOME/settings.json"], "idempotent": true }, "params": { "type": "object", "properties": { "language": { "anyOf": [{ "type": "string", "minLength": 1, "maxLength": 40, "pattern": "\\S" }, { "type": "null" }] } }, "required": ["language"], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "task.create": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": "per requestId within one alpd process (10 minutes)" }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" }, "priority": { "type": "integer", "minimum": 0, "maximum": 4 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["projectRoot", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "duplicate": { "const": true } }, "required": ["id"], "additionalProperties": true } }, "task.gate.resolve": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "gate": { "type": "string", "minLength": 1, "maxLength": 128 }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "gate"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "task.list": { "x-alp": { "effect": "query", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "tasks": { "type": "array", "items": { "$ref": "#/$defs/taskRow" } }, "unreadable": { "type": "array", "items": { "type": "object", "properties": { "file": { "type": "string" }, "error": { "type": "string" } }, "required": ["file", "error"], "additionalProperties": true } }, "revision": { "type": "string" } }, "required": ["projectRoot", "tasks", "unreadable", "revision"], "additionalProperties": true } }, "task.update": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "action": { "enum": ["close", "reopen"] }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "action"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 }, "landed": { "type": "string" } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "team.list": { "x-alp": { "effect": "query", "capability": "team", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "teams": { "type": "array", "items": { "$ref": "#/$defs/teamRow" } } }, "required": ["projectRoot", "teams"], "additionalProperties": true } }, "workspace.files.search": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files", "risks": ["lists file names of the directory (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "query": { "type": "string", "maxLength": 200 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "files": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 } }, "required": ["path"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["files"], "additionalProperties": true } }, "workspace.files.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["lists names, kinds, sizes and times of a directory's entries (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "entries": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "kind": { "enum": ["file", "directory"] }, "size": { "type": "integer", "minimum": 0 }, "modifiedAt": { "type": "string" } }, "required": ["name", "path", "kind"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["entries"], "additionalProperties": true } }, "workspace.files.read": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["returns the content of a text file under the directory"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot", "path"], "additionalProperties": true }, "result": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "content": { "type": "string" }, "size": { "type": "integer", "minimum": 0, "maximum": 1048576 }, "modifiedAt": { "type": "string" } }, "required": ["path", "content", "size"], "additionalProperties": true } }, "session.history": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true, "capability": "session.history" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "before": { "type": "string", "maxLength": 4096 }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "maxBytes": { "type": "integer", "minimum": 2048, "maximum": 524288 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "generation": { "type": "string" }, "items": { "type": "array", "maxItems": 500, "items": { "oneOf": [{ "$ref": "#/$defs/envelope" }, { "type": "object", "properties": { "cursor": { "type": "integer", "minimum": 0 }, "oversized": { "type": "object", "properties": { "bytes": { "type": "integer", "minimum": 1 } }, "required": ["bytes"] } }, "required": ["cursor", "oversized"], "additionalProperties": false }] } }, "olderCursor": { "type": "string" }, "hasOlder": { "type": "boolean" }, "tipCursor": { "type": "integer", "minimum": 0 } }, "required": ["generation", "items", "hasOlder", "tipCursor"], "additionalProperties": true } }, "project.list": { "params": { "type": "object", "properties": { "cursor": { "type": "string", "pattern": "^[0-9]+$" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "projectRoots": { "type": "array", "items": { "type": "string" } }, "includeRemoved": { "type": "boolean" } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "projects": { "type": "array", "items": { "$ref": "#/$defs/registryProject" } }, "revision": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "nextCursor": { "type": ["string", "null"] } }, "required": ["projects", "revision", "total", "nextCursor"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "workspace.list": { "params": { "type": "object", "properties": { "cursor": { "type": "string", "pattern": "^[0-9]+$" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "projectRoots": { "type": "array", "items": { "type": "string" } }, "includeArchived": { "type": "boolean" } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspaces": { "type": "array", "items": { "$ref": "#/$defs/registryWorkspace" } }, "revision": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "nextCursor": { "type": ["string", "null"] } }, "required": ["workspaces", "revision", "total", "nextCursor"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "workspace.get": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" } }, "required": ["workspaceId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "project.register": { "params": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "directory": { "type": "string" }, "authorizedRoots": { "type": "array", "items": { "type": "string" } } }, "required": ["directory", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "project": { "$ref": "#/$defs/registryProject" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["project", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "project.remove": { "params": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "projectId": { "type": "string" }, "authorizedRoots": { "type": "array", "items": { "type": "string" } } }, "required": ["projectId", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "project": { "$ref": "#/$defs/registryProject" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["project", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "workspace.update": { "params": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "workspaceId": { "type": "string" }, "title": { "type": ["string", "null"] }, "pinned": { "type": "boolean" }, "archived": { "type": "boolean" }, "authorizedRoots": { "type": "array", "items": { "type": "string" } } }, "required": ["workspaceId", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "registry.owner": { "params": { "type": "object", "properties": { "operation": { "enum": ["project.add", "project.rename", "project.remove", "workspace.create", "workspace.update", "placement.prepare", "placement.assign", "label.assign", "label.update", "label.delete", "placement.remove"] }, "args": { "type": "object" }, "requestId": { "type": "string" }, "ifRevision": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "registry": { "type": "object" } }, "required": ["registry"] }, "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "capability": "workspace.registry", "idempotent": false } }, "workspace.worktree.create": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "mappingId": { "type": "string", "maxLength": 64 }, "principalEpoch": { "type": "string" } }, "required": ["workspaceId", "requestId", "ifRevision", "mappingId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 }, "filesRemoved": { "type": "boolean" }, "branchRetained": { "type": "boolean" } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.worktree", "idempotent": true } }, "workspace.worktree.remove": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "principalEpoch": { "type": "string" } }, "required": ["workspaceId", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 }, "filesRemoved": { "type": "boolean" }, "branchRetained": { "type": "boolean" } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.worktree", "idempotent": true } }, "workspace.worktree.options": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "principalEpoch": { "type": "string" } }, "required": ["workspaceId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "mappingIds": { "type": "array", "items": { "type": "string" } } }, "required": ["mappingIds"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.worktree", "idempotent": true } }, "registry.worktree": { "params": { "type": "object", "properties": { "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "principalEpoch": { "type": "string" } }, "additionalProperties": false }, "result": { "type": "object", "additionalProperties": true }, "x-alp": { "effect": "query", "scope": { "kind": "host" }, "capability": "workspace.worktree" } }, "workspace.git.status": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.git", "idempotent": true, "risks": ["lists the changed file paths, branch and remote of a workspace checkout"] }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1 } }, "required": ["workspaceId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "state": { "enum": ["repository", "not_repository", "unsupported"] }, "reason": { "type": "string" }, "branch": { "type": ["string", "null"] }, "detached": { "type": "boolean" }, "head": { "type": ["string", "null"] }, "upstream": { "type": ["object", "null"], "properties": { "ref": { "type": "string" }, "ahead": { "type": "integer", "minimum": 0 }, "behind": { "type": "integer", "minimum": 0 } }, "required": ["ref", "ahead", "behind"], "additionalProperties": false }, "baseRef": { "type": ["string", "null"] }, "aheadBehind": { "type": ["object", "null"], "properties": { "ahead": { "type": "integer", "minimum": 0 }, "behind": { "type": "integer", "minimum": 0 } }, "required": ["ahead", "behind"], "additionalProperties": false }, "hasRemote": { "type": "boolean" }, "remoteUrl": { "type": ["string", "null"] }, "dirty": { "type": "boolean" }, "files": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "oldPath": { "type": "string", "minLength": 1, "maxLength": 4096 }, "change": { "enum": ["modified", "added", "deleted", "renamed", "copied", "typechange", "untracked", "conflicted"] }, "staged": { "type": "boolean" }, "unstaged": { "type": "boolean" } }, "required": ["path", "change", "staged", "unstaged"], "additionalProperties": false } }, "hiddenCount": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" }, "snapshot": { "type": "string", "maxLength": 1024 } }, "required": ["state", "branch", "detached", "head", "upstream", "baseRef", "aheadBehind", "hasRemote", "remoteUrl", "dirty", "files", "hiddenCount", "truncated", "snapshot"], "additionalProperties": false } }, "workspace.git.diff": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.git", "idempotent": true, "risks": ["returns changed file content of a workspace checkout as diff hunks, including deleted and historical lines"] }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1 }, "compare": { "type": "object", "properties": { "mode": { "enum": ["uncommitted", "staged", "unstaged", "base"] }, "baseRef": { "type": "string", "minLength": 1, "maxLength": 255 }, "ignoreWhitespace": { "type": "boolean" } }, "required": ["mode"], "additionalProperties": false }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "required": ["workspaceId", "compare"], "additionalProperties": false }, "result": { "type": "object", "properties": { "compare": { "type": "object", "properties": { "mode": { "enum": ["uncommitted", "staged", "unstaged", "base"] }, "baseRef": { "type": "string" }, "ignoreWhitespace": { "type": "boolean" } }, "required": ["mode", "ignoreWhitespace"], "additionalProperties": false }, "snapshot": { "type": "string", "maxLength": 1024 }, "files": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "oldPath": { "type": "string", "minLength": 1, "maxLength": 4096 }, "change": { "enum": ["modified", "added", "deleted", "renamed", "copied", "typechange", "untracked", "conflicted"] }, "kind": { "enum": ["text", "binary", "too_large", "withheld", "symlink", "submodule"] }, "additions": { "type": "integer", "minimum": 0 }, "deletions": { "type": "integer", "minimum": 0 }, "hunks": { "type": "array", "items": { "type": "object", "properties": { "oldStart": { "type": "integer", "minimum": 0 }, "oldCount": { "type": "integer", "minimum": 0 }, "newStart": { "type": "integer", "minimum": 0 }, "newCount": { "type": "integer", "minimum": 0 }, "context": { "type": "string" }, "lines": { "type": "array", "items": { "type": "object", "properties": { "type": { "enum": ["add", "remove", "context"] }, "content": { "type": "string" }, "noNewline": { "const": true } }, "required": ["type", "content"], "additionalProperties": false } } }, "required": ["oldStart", "oldCount", "newStart", "newCount", "lines"], "additionalProperties": false } } }, "required": ["path", "change", "kind", "additions", "deletions", "hunks"], "additionalProperties": false } }, "hiddenCount": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" }, "nextCursor": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "required": ["compare", "snapshot", "files", "hiddenCount", "truncated"], "additionalProperties": false } }, "attachment.begin": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "attachments", "idempotent": "with requestId", "risks": ["reserves stored bytes of the daemon host for a file the client uploads"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,128}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "size": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mimeType": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}$" }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["sessionId", "name", "size", "mimeType", "requestId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "state": { "enum": ["uploading", "committed"] }, "received": { "type": "integer", "minimum": 0 }, "size": { "type": "integer", "minimum": 0 }, "maxChunkBytes": { "type": "integer", "minimum": 1 }, "expiresAt": { "type": "string" }, "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" } }, "required": ["uploadId", "state", "received", "size", "maxChunkBytes"], "additionalProperties": false } }, "attachment.chunk": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": "same offset and bytes", "risks": ["writes uploaded bytes to the daemon host"] }, "params": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "data": { "type": "string", "minLength": 4, "maxLength": 349528, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["uploadId", "offset", "data"], "additionalProperties": false }, "result": { "type": "object", "properties": { "received": { "type": "integer", "minimum": 0 }, "size": { "type": "integer", "minimum": 0 } }, "required": ["received", "size"], "additionalProperties": false } }, "attachment.commit": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": true }, "params": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["uploadId", "sha256"], "additionalProperties": false }, "result": { "type": "object", "properties": { "attachment": { "$ref": "#/$defs/attachment" } }, "required": ["attachment"], "additionalProperties": false } }, "attachment.abort": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": false }, "params": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["uploadId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "aborted": { "const": true } }, "required": ["aborted"], "additionalProperties": false } }, "attachment.get": { "x-alp": { "effect": "query", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": true }, "params": { "type": "object", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["attachmentId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "attachment": { "$ref": "#/$defs/attachment" } }, "required": ["attachment"], "additionalProperties": false } }, "attachment.delete": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": false }, "params": { "type": "object", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["attachmentId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "deleted": { "const": true } }, "required": ["deleted"], "additionalProperties": false } }, "session.fork": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.fork", "idempotent": "with requestId", "risks": ["creates a new root session in the source workspace or a granted destination workspace; files are never copied, restored or changed"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "boundary": { "oneOf": [{ "type": "object", "properties": { "throughTurnId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["throughTurnId"], "additionalProperties": false }, { "type": "object", "properties": { "beforeTurnId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["beforeTurnId"], "additionalProperties": false }] }, "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "newSessionId": { "type": "string", "pattern": "^[\\w.:-]{1,128}$" }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["sessionId", "requestId", "ifGeneration"], "additionalProperties": false }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "forkedFrom": { "$ref": "#/$defs/forkProvenance" }, "duplicate": { "const": true } }, "required": ["session", "forkedFrom"], "additionalProperties": true } }, "session.rewind": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.rewind", "idempotent": "with requestId", "risks": ["replaces the conversation the runtime continues from; the later turns stay recoverable and no file is changed"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "beforeTurnId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["sessionId", "requestId", "ifGeneration", "beforeTurnId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "generation": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "branch": { "$ref": "#/$defs/conversationBranch" }, "duplicate": { "const": true } }, "required": ["session", "generation", "branch"], "additionalProperties": true } }, "session.reload": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.reload", "idempotent": "with requestId", "risks": ["restarts the root's native process; its conversation, configuration, history and receipts are kept"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, "required": ["sessionId", "requestId", "ifGeneration"], "additionalProperties": false }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "duplicate": { "const": true } }, "required": ["session"], "additionalProperties": true } }, "session.resumeCommand": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.resumeCommand", "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "argv": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" } }, "posix": { "type": "string", "minLength": 1, "maxLength": 2048 }, "windows": { "type": "string", "minLength": 1, "maxLength": 2048 }, "display": { "type": "string", "minLength": 1, "maxLength": 2048 }, "platform": { "enum": ["posix", "windows"] } }, "required": ["argv", "posix", "windows", "display", "platform"], "additionalProperties": false } }, "terminal.create": { "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "terminal", "idempotent": false, "risks": ["starts a shell on the daemon host as the daemon's account: host-level execution, not confined to the workspace"] }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["workspaceId", "cols", "rows", "requestId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminal": { "$ref": "#/$defs/terminal" } }, "required": ["terminal"], "additionalProperties": false } }, "terminal.list": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "terminal", "idempotent": true }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminals": { "type": "array", "items": { "$ref": "#/$defs/terminal" } } }, "required": ["terminals"], "additionalProperties": false } }, "terminal.attach": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": true, "risks": ["streams the terminal's output, which may show anything the shell printed"] }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "after": { "type": "integer", "minimum": 0 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminal": { "$ref": "#/$defs/terminal" }, "nextSeq": { "type": "integer", "minimum": 1 }, "gap": { "type": "object", "properties": { "fromSeq": { "type": "integer", "minimum": 1 }, "toSeq": { "type": "integer", "minimum": 1 } }, "required": ["fromSeq", "toSeq"], "additionalProperties": false } }, "required": ["terminal", "nextSeq"], "additionalProperties": false } }, "terminal.input": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": false, "risks": ["types into a host shell: runs any command as the daemon's account"] }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "data": { "type": "string", "minLength": 1, "maxLength": 65536 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId", "data"], "additionalProperties": false }, "result": { "type": "object", "properties": { "bytes": { "type": "integer", "minimum": 1 } }, "required": ["bytes"], "additionalProperties": false } }, "terminal.resize": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": true }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId", "cols", "rows"], "additionalProperties": false }, "result": { "type": "object", "properties": { "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 } }, "required": ["cols", "rows"], "additionalProperties": false } }, "terminal.close": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": false }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "closed": { "const": true } }, "required": ["closed"], "additionalProperties": false } }, "terminal.revoke": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "capability": "terminal", "idempotent": true, "risks": ["kills every terminal of a principal; for a trusted gateway, never exposed"] }, "params": { "type": "object", "properties": { "principalId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["principalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "closed": { "type": "integer", "minimum": 0 } }, "required": ["closed"], "additionalProperties": false } } }, "$defs": { "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} }, "required": ["code", "message"], "additionalProperties": true }, "session": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "promptImages": { "type": "boolean" }, "promptAttachments": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["file.path", "document.native", "text.extract"] } }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy"], "additionalProperties": true }, "usage": { "type": "object", "properties": { "contextWindowUsedTokens": { "type": "integer", "minimum": 0 }, "contextWindowMaxTokens": { "type": "integer", "minimum": 1 }, "inputTokens": { "type": "integer", "minimum": 0 }, "cachedInputTokens": { "type": "integer", "minimum": 0 }, "outputTokens": { "type": "integer", "minimum": 0 }, "totalCostUsd": { "type": "number", "minimum": 0 } }, "additionalProperties": true }, "assignment": { "type": "object", "properties": { "id": { "type": "string" }, "agent": { "type": "string" }, "mode": { "type": "string" }, "status": { "type": "string" }, "startedAt": { "type": "string" }, "worktree": { "type": "object", "properties": { "branch": { "type": "string" }, "path": { "type": "string" } }, "required": ["branch", "path"], "additionalProperties": true } }, "required": ["id", "agent", "mode", "status", "startedAt"], "additionalProperties": true }, "mail": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "enum": ["question", "answer", "note", "steer", "result", "stalled", "board", "checkin"] }, "from": { "type": "string" }, "assignment": { "type": "string" }, "body": { "type": "string" }, "replyTo": { "type": "string" }, "result": { "type": "object" }, "redelivered": { "type": "boolean" } }, "required": ["id", "kind", "from", "assignment"], "additionalProperties": true }, "pin": { "type": "object", "properties": { "id": { "type": "string" }, "project": { "type": "string" }, "kind": { "enum": ["claim", "decision", "finding"] }, "body": { "type": "string" }, "paths": { "type": "array", "items": { "type": "string" } }, "agent": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "at": { "type": "string" }, "released": { "type": "string" }, "task": { "type": "string" } }, "required": ["id", "project", "kind", "body", "agent", "sessionId", "rootId", "at"], "additionalProperties": true }, "question": { "type": "object", "properties": { "id": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "agent": { "type": "string" }, "body": { "type": "string" }, "options": { "type": "array", "items": { "type": "string" } }, "askedAt": { "type": "string" } }, "required": ["id", "sessionId", "rootId", "agent", "body", "askedAt"], "additionalProperties": true }, "attention": { "type": "object", "properties": { "reason": { "enum": ["finished", "error"] }, "at": { "type": "string" }, "turnId": { "type": "string" }, "message": { "type": "string" } }, "required": ["reason", "at"], "additionalProperties": true }, "spec": { "type": "object", "properties": { "cwd": { "type": "string" }, "agent": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "persist": { "type": "boolean" }, "restore": { "type": "object" } }, "required": ["cwd"], "additionalProperties": true }, "item": { "anyOf": [{ "$ref": "#/$defs/knownItem" }, { "$ref": "#/$defs/unknownItem" }] }, "event": { "anyOf": [{ "$ref": "#/$defs/knownEvent" }, { "$ref": "#/$defs/unknownEvent" }] }, "envelope": { "type": "object", "properties": { "sessionId": { "type": "string" }, "epoch": { "type": "string" }, "seq": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ts": { "type": "string" }, "event": { "$ref": "#/$defs/event" }, "cursor": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": ["sessionId", "epoch", "seq", "ts", "event"], "additionalProperties": true }, "request": { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }] }, "method": { "type": "string" }, "params": { "type": "object" } }, "required": ["jsonrpc", "method", "id"], "additionalProperties": true }, "response": { "oneOf": [{ "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "result": {} }, "required": ["jsonrpc", "id", "result"], "additionalProperties": true }, { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "error": { "$ref": "#/$defs/error" } }, "required": ["jsonrpc", "id", "error"], "additionalProperties": true }] }, "notification": { "oneOf": [{ "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "event" }, "params": { "$ref": "#/$defs/envelope" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }, { "type": "object", "description": "A terminal's output, exit or detach (capability terminal, \xA712.10).", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "terminal.event" }, "params": { "$ref": "#/$defs/terminalEvent" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }] }, "knownEvent": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "session.opened" }, "session": { "$ref": "#/$defs/session" }, "cwd": { "type": "string" }, "effective": { "type": "object", "properties": { "model": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["model", "thinking"], "additionalProperties": true } }, "required": ["type", "session", "cwd", "effective"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.ready" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.updated" }, "session": { "$ref": "#/$defs/session" } }, "required": ["type", "session"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.closed" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.failed" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.accepted" }, "clientMessageId": { "type": "string" }, "result": { "enum": ["turn", "steer"] }, "turnId": { "type": "string" } }, "required": ["type", "clientMessageId", "result", "turnId"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.failed" }, "clientMessageId": { "type": "string" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "clientMessageId", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.started" }, "turnId": { "type": "string" }, "origin": { "enum": ["user", "wake", "assignment", "runtime"] } }, "required": ["type", "turnId", "origin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.ended" }, "turnId": { "type": "string" }, "state": { "enum": ["completed", "failed", "canceled"] }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "turnId", "state"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "item" }, "item": { "$ref": "#/$defs/item" } }, "required": ["type", "item"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "usage" }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["type", "usage"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "mail" }, "mail": { "$ref": "#/$defs/mail" } }, "required": ["type", "mail"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "assignment" }, "assignment": { "$ref": "#/$defs/assignment" } }, "required": ["type", "assignment"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question" }, "question": { "$ref": "#/$defs/question" } }, "required": ["type", "question"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question.resolved" }, "questionId": { "type": "string" }, "outcome": { "enum": ["answered", "dismissed", "timeout", "canceled"] }, "answer": { "type": "string" } }, "required": ["type", "questionId", "outcome"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "pin" }, "pin": { "$ref": "#/$defs/pin" } }, "required": ["type", "pin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unpin" }, "pinId": { "type": "string" }, "reason": { "enum": ["unpinned", "session_ended"] } }, "required": ["type", "pinId", "reason"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "attention" }, "attention": { "$ref": "#/$defs/attention" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "history.reset" }, "generation": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "reason": { "const": "rewind" }, "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" } }, "required": ["type", "generation", "reason", "branchId"], "additionalProperties": true }] }, "unknownEvent": { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["session.opened", "session.ready", "session.updated", "session.closed", "session.failed", "prompt.accepted", "prompt.failed", "turn.started", "turn.ended", "item", "usage", "mail", "assignment", "question", "question.resolved", "pin", "unpin", "attention", "history.reset"] } } }, "required": ["type"], "additionalProperties": true }, "knownItem": { "oneOf": [{ "type": "object", "properties": { "kind": { "const": "user_message" }, "id": { "type": "string" }, "text": { "type": "string" }, "clientMessageId": { "type": "string" }, "images": { "type": "integer", "minimum": 1 }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "name": { "type": "string" }, "mimeType": { "type": "string" }, "size": { "type": "integer", "minimum": 0 } }, "required": ["attachmentId", "name", "mimeType", "size"], "additionalProperties": false } }, "origin": { "enum": ["user", "wake", "assignment", "runtime"] } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "assistant_message" }, "id": { "type": "string" }, "text": { "type": "string" } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "notice" }, "id": { "type": "string" }, "level": { "enum": ["info", "warning", "error"] }, "text": { "type": "string" } }, "required": ["kind", "id", "level", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "compaction" }, "id": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "trigger": { "type": "string" }, "preTokens": { "type": "integer" }, "postTokens": { "type": "integer" } }, "required": ["kind", "id", "status"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "todo" }, "id": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "status": { "enum": ["pending", "in_progress", "completed"] } }, "required": ["id", "text", "status"], "additionalProperties": true } } }, "required": ["kind", "id", "items"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "tool_call" }, "id": { "type": "string" }, "callId": { "type": "string" }, "name": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "error": { "type": "string" }, "detail": { "$ref": "#/$defs/toolCallDetail" } }, "required": ["kind", "id", "callId", "name", "status", "detail"], "additionalProperties": true }] }, "unknownItem": { "type": "object", "properties": { "kind": { "type": "string", "not": { "enum": ["user_message", "assistant_message", "notice", "compaction", "todo", "tool_call"] } }, "id": { "type": "string" } }, "required": ["kind", "id"], "additionalProperties": true }, "toolCallDetail": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "shell" }, "command": { "type": "string" }, "cwd": { "type": "string" }, "output": { "type": "string" }, "exitCode": { "type": ["integer", "null"] } }, "required": ["type", "command", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "read" }, "filePath": { "type": "string" }, "content": { "type": "string" }, "offset": { "type": "integer" }, "limit": { "type": "integer" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "edit" }, "filePath": { "type": "string" }, "oldString": { "type": "string" }, "newString": { "type": "string" }, "unifiedDiff": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "write" }, "filePath": { "type": "string" }, "content": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "search" }, "query": { "type": "string" }, "toolName": { "enum": ["search", "grep", "glob", "web_search"] }, "content": { "type": "string" }, "filePaths": { "type": "array", "items": { "type": "string" } }, "webResults": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "url": { "type": "string" } }, "required": ["title", "url"], "additionalProperties": true } }, "numFiles": { "type": "integer" }, "numMatches": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": ["type", "query"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "fetch" }, "url": { "type": "string" }, "prompt": { "type": "string" }, "result": { "type": "string" }, "code": { "type": "integer" } }, "required": ["type", "url"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "sub_agent" }, "subAgentType": { "type": "string" }, "description": { "type": "string" }, "log": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plan" }, "text": { "type": "string" } }, "required": ["type", "text"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plain_text" }, "label": { "type": "string" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unknown" }, "input": {}, "output": {} }, "required": ["type", "input", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["shell", "read", "edit", "write", "search", "fetch", "sub_agent", "plan", "plain_text", "unknown"] } } }, "required": ["type"], "additionalProperties": true }] }, "alpError": { "type": "object", "properties": { "message": { "type": "string" }, "code": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "sessionSummary": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "status": { "enum": ["initializing", "idle", "running", "error", "closed"] }, "title": { "type": "string" }, "archived": { "type": "boolean" }, "attention": { "$ref": "#/$defs/attention" }, "lastError": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "conversation": { "type": "object", "properties": { "fork": { "type": "boolean" }, "rewind": { "type": "boolean" }, "reload": { "type": "boolean", "description": "Whether session.reload can restart this root's native process (\xA712.8); the root must also be open and idle." }, "reason": { "enum": ["runtime_unsupported", "not_persistent", "not_root"] }, "configure": { "type": "boolean", "description": "Whether session.configure can change this root's model, effort or team (\xA712.9); the root must also be open and idle." } }, "required": ["fork", "rewind"], "additionalProperties": true }, "forkedFrom": { "$ref": "#/$defs/forkProvenance" }, "branches": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/conversationBranch" } }, "promptAttachments": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["file.path", "document.native", "text.extract"] } } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "status"], "additionalProperties": true }, "pause": { "type": "object", "properties": { "since": { "type": "string" }, "by": { "type": "string" }, "reason": { "type": "string" }, "resetsAt": { "type": "string" }, "checkedAt": { "type": "string" } }, "required": ["since", "by", "reason"], "additionalProperties": true }, "pauseState": { "type": "object", "properties": { "all": { "$ref": "#/$defs/pause" }, "runtimes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/pause" } }, "parked": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "type": "string" }, "rootId": { "type": "string" }, "reason": { "type": "string" }, "since": { "type": "string" } }, "required": ["assignmentId", "agent", "runtime", "rootId", "reason", "since"], "additionalProperties": true } } }, "required": ["runtimes", "parked"], "additionalProperties": true }, "preview": { "type": "object", "properties": { "teams": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "label"], "additionalProperties": true } }, "team": { "type": "string" }, "teamLabel": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["teams", "team", "agent", "runtime", "model", "mode", "thinking"], "additionalProperties": true }, "treeStatus": { "type": "object", "properties": { "rootId": { "type": "string" }, "sessions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "state": { "enum": ["running", "waiting", "waiting_parent", "waiting_user", "idle"] }, "idleMs": { "type": "number" }, "workdir": { "type": "string" }, "unreadMail": { "type": "integer", "minimum": 0 } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "state", "idleMs", "workdir", "unreadMail"], "additionalProperties": true } }, "assignments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "requester": { "type": "string" }, "isolation": { "enum": ["shared", "worktree"] }, "idleMs": { "type": "number" } }, "required": ["id", "requester", "isolation", "idleMs"], "additionalProperties": true } }, "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } }, "worktrees": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "requester": { "type": "string" }, "agent": { "type": "string" }, "branch": { "type": "string" }, "files": { "type": "array", "items": { "type": "string" } }, "stat": { "type": "string" } }, "required": ["assignmentId", "requester", "agent", "branch", "files", "stat"], "additionalProperties": true } }, "leases": { "type": "array", "items": { "type": "object", "properties": { "checkout": { "type": "string" }, "assignmentId": { "type": "string" }, "agent": { "type": "string" } }, "required": ["checkout", "assignmentId", "agent"], "additionalProperties": true } }, "claims": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["rootId", "sessions", "assignments", "questions", "worktrees", "leases", "claims"], "additionalProperties": true }, "health": { "type": "object", "properties": { "live": { "type": "boolean" }, "ready": { "type": "boolean" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "ok": { "type": "boolean" }, "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["id", "ok"], "additionalProperties": true } } }, "required": ["live", "ready", "checks"], "additionalProperties": true }, "projectRoot": { "type": "string", "minLength": 1, "maxLength": 4096, "description": "An absolute, normalized path on the daemon host to a directory holding .alp/. Compared as is: the daemon never walks up to a parent." }, "taskId": { "type": "string", "pattern": "^t-[0-9a-f]{4,12}(?:\\.\\d+)*$" }, "taskRow": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "title": { "type": "string" }, "type": { "type": "string" }, "priority": { "type": "integer" }, "status": { "enum": ["open", "in_progress", "review", "closed"] }, "rev": { "type": "integer", "minimum": 0 }, "parent": { "type": "string" }, "assignee": { "type": "string" }, "ready": { "type": "boolean" }, "blockedBy": { "type": "array", "items": { "type": "string" } }, "waits": { "type": "array", "items": { "type": "string" } }, "approvals": { "type": "array", "items": { "type": "object", "properties": { "gate": { "type": "string" }, "note": { "type": "string" } }, "required": ["gate", "note"], "additionalProperties": true } }, "handoff": { "type": "object", "properties": { "outcome": { "type": "string" }, "summary": { "type": "string" }, "agent": { "type": "string" } }, "required": ["outcome", "summary"], "additionalProperties": true }, "closed": { "type": "object", "properties": { "reason": { "type": "string" }, "summary": { "type": "string" }, "at": { "type": "string" } }, "required": ["reason", "at"], "additionalProperties": true }, "description": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "paths": { "type": "array", "items": { "type": "string" } }, "progress": { "type": "object", "properties": { "done": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": ["done", "total"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": ["id", "title", "type", "priority", "status", "rev", "ready", "updatedAt"], "additionalProperties": true }, "libraryKind": { "enum": ["agents", "skills", "mcp", "hooks", "teams", "providers"] }, "libraryScope": { "enum": ["library", "project"] }, "librarySource": { "enum": ["builtin", "library", "project"] }, "entryName": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.-]+$", "not": { "enum": [".", ".."] } }, "libraryRevision": { "type": ["string", "null"] }, "libraryEntryRow": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "description": { "type": "string" }, "usedBy": { "type": "array", "items": { "type": "string" } } }, "required": ["name", "source"], "additionalProperties": true }, "secretMarker": { "type": "object", "properties": { "$secret": { "const": "keep" } }, "required": ["$secret"], "additionalProperties": false, "description": "Stands for a stored secret value: read results carry it in place of the value; a save that sends it back keeps the stored value." }, "languageSetting": { "type": "object", "properties": { "language": { "type": ["string", "null"] }, "applies": { "type": "string" }, "default": { "type": "string" } }, "required": ["language", "applies", "default"], "additionalProperties": true }, "teamRow": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "error": { "type": "string" } }, "required": ["id", "source"], "additionalProperties": true }, "promptImage": { "type": "object", "properties": { "type": { "const": "image" }, "mimeType": { "enum": ["image/png", "image/jpeg", "image/gif", "image/webp"] }, "data": { "type": "string", "minLength": 4, "maxLength": 6990508, "pattern": "^[A-Za-z0-9+/]+={0,2}$" }, "name": { "type": "string", "maxLength": 255 } }, "required": ["type", "mimeType", "data"], "additionalProperties": false }, "scheduleId": { "type": "string", "pattern": "^sch_[0-9a-f]{16}$" }, "scheduleError": { "type": "object", "properties": { "message": { "type": "string" }, "code": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "scheduleJob": { "type": "object", "properties": { "id": { "$ref": "#/$defs/scheduleId" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "sessionId": { "type": "string" }, "prompt": { "type": "string" }, "dueAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$" }, "status": { "enum": ["pending", "delivered", "failed", "cancelled"] }, "attempts": { "type": "integer", "minimum": 0 }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "deliveredAt": { "type": "string" }, "failedAt": { "type": "string" }, "cancelledAt": { "type": "string" }, "attemptedAt": { "type": "string" }, "lateByMs": { "type": "integer", "minimum": 0 }, "lastError": { "$ref": "#/$defs/scheduleError" } }, "required": ["id", "projectRoot", "sessionId", "prompt", "dueAt", "status", "attempts", "createdAt", "updatedAt"], "additionalProperties": true }, "registryProject": { "type": "object", "properties": { "id": { "type": "string" }, "root": { "type": "string" }, "customName": { "type": ["string", "null"] }, "addedAt": { "type": "string" }, "removedAt": { "type": ["string", "null"] }, "revision": { "type": "integer", "minimum": 0 }, "canonical": { "type": "string" } }, "required": ["id", "root", "addedAt"], "additionalProperties": false }, "registryWorkspace": { "type": "object", "properties": { "id": { "type": "string" }, "projectId": { "type": "string" }, "directory": { "type": "string" }, "title": { "type": ["string", "null"] }, "pinnedAt": { "type": ["string", "null"] }, "archivedAt": { "type": ["string", "null"] }, "labels": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string" }, "revision": { "type": "integer", "minimum": 0 }, "canonical": { "type": "string" }, "idempotencyKey": { "type": "string" }, "branch": { "type": ["string", "null"] }, "managedWorktree": { "type": "boolean" } }, "required": ["id", "projectId", "directory", "labels", "createdAt"], "additionalProperties": false }, "attachment": { "type": "object", "description": "A committed attachment as clients see it: ids, display metadata and its digest, never a host path or URL.", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "mimeType": { "type": "string", "minLength": 3, "maxLength": 255 }, "detectedMimeType": { "type": "string", "minLength": 3, "maxLength": 255 }, "size": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "createdAt": { "type": "string" }, "committedAt": { "type": "string" }, "referenced": { "type": "boolean" } }, "required": ["attachmentId", "sessionId", "name", "mimeType", "detectedMimeType", "size", "sha256", "createdAt", "committedAt", "referenced"], "additionalProperties": false }, "forkProvenance": { "type": "object", "description": "Where a fork came from (\xA712.7): the source root, and the turn its conversation was cut at.", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "turnId": { "type": "string", "minLength": 1, "maxLength": 200 }, "boundary": { "enum": ["through", "before", "whole"] }, "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" }, "at": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": ["sessionId", "boundary", "at"], "additionalProperties": true }, "conversationBranch": { "type": "object", "description": "Later turns a rewind set aside (\xA712.7): kept, never deleted, recoverable as a new session with session.fork { branchId }.", "properties": { "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" }, "beforeTurnId": { "type": "string", "minLength": 1, "maxLength": 200 }, "turns": { "type": "integer", "minimum": 0 }, "at": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": ["branchId", "beforeTurnId", "turns", "at"], "additionalProperties": true }, "effectiveConfig": { "type": "object", "description": "The configuration a root runs with, or would after a change, as alpd resolved it (\xA712.9).", "properties": { "team": { "type": "string" }, "teamLabel": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "thinking": { "type": "string" }, "mode": { "type": "string" }, "permissionProfile": { "type": "string", "description": "The permission profile capping the agent's mode, when one does." }, "supervisor": { "type": "boolean" }, "maxPeers": { "type": "integer" }, "delegates": { "type": "array", "items": { "type": "string" }, "description": "Agents the root may delegate to." }, "tools": { "type": "array", "items": { "type": "string" }, "description": "ALP tools the root's agent is given." }, "mcpServers": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "kind": { "enum": ["stdio", "http"] } }, "required": ["name", "kind"], "additionalProperties": true } }, "hooks": { "type": "integer", "minimum": 0, "description": "How many hook commands the agent runs." }, "instructionsSha": { "type": "string" } }, "required": ["team", "agent", "runtime", "model", "thinking", "mode", "supervisor", "delegates", "tools", "mcpServers", "hooks"], "additionalProperties": true }, "configurePreview": { "type": "object", "properties": { "current": { "$ref": "#/$defs/effectiveConfig" }, "proposed": { "$ref": "#/$defs/effectiveConfig" }, "changes": { "type": "array", "items": { "enum": ["model", "thinking", "team", "mode"] } }, "restart": { "type": "boolean", "description": "Whether applying it restarts the root's native process (on its own conversation)." }, "allowed": { "type": "boolean", "description": "Whether session.configure would take it now; a busy tree may still refuse it later." }, "reason": { "enum": ["session_busy", "session_closed", "not_root", "runtime_unsupported", "runtime_mismatch", "agent_mismatch", "permission_escalation", "team_not_found", "invalid_params", "not_persistent"] }, "message": { "type": "string" }, "teams": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "label"], "additionalProperties": true } } }, "required": ["current", "proposed", "changes", "restart", "allowed", "teams"], "additionalProperties": true }, "configureOutcome": { "type": "object", "properties": { "status": { "enum": ["applied", "unchanged"] }, "requested": { "type": "object", "properties": { "model": { "type": "string" }, "thinking": { "type": "string" }, "team": { "type": "string" }, "mode": { "type": "string" } }, "additionalProperties": false }, "effective": { "$ref": "#/$defs/effectiveConfig" }, "restarted": { "type": "boolean" } }, "required": ["status", "requested", "effective", "restarted"], "additionalProperties": true }, "terminal": { "type": "object", "description": "A terminal as clients see it: ids, size and state, never a process id, shell path or host path.", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "title": { "type": "string", "maxLength": 64 }, "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "state": { "enum": ["running", "exited"] }, "attached": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "lastActivityAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "exitCode": { "type": ["integer", "null"] }, "signal": { "type": ["integer", "null"] }, "endReason": { "enum": ["exited", "closed", "idle", "lifetime", "detached", "revoked", "disabled", "shutdown"] } }, "required": ["terminalId", "workspaceId", "title", "cols", "rows", "state", "attached", "createdAt", "lastActivityAt", "expiresAt"], "additionalProperties": false }, "terminalEvent": { "description": "params of a terminal.event notification (\xA712.10): sent only to the connection attached to the terminal.", "oneOf": [{ "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "type": { "const": "output" }, "seq": { "type": "integer", "minimum": 1 }, "data": { "type": "string", "minLength": 1, "maxLength": 65536 } }, "required": ["terminalId", "type", "seq", "data"], "additionalProperties": false }, { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "type": { "const": "exit" }, "seq": { "type": "integer", "minimum": 1 }, "exitCode": { "type": ["integer", "null"] }, "signal": { "type": ["integer", "null"] }, "reason": { "enum": ["exited", "closed", "idle", "lifetime", "detached", "revoked", "disabled", "shutdown"] } }, "required": ["terminalId", "type", "seq", "exitCode", "signal", "reason"], "additionalProperties": false }, { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "type": { "const": "detached" }, "reason": { "enum": ["replaced", "slow_consumer"] } }, "required": ["terminalId", "type", "reason"], "additionalProperties": false }] } } };
|
|
5787
|
+
var METHODS_V1 = { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://alp.dev/schemas/methods-v1.json", "protocolVersion": 1, "errors": { "parseError": -32700, "invalidRequest": -32600, "methodNotFound": -32601, "invalidParams": -32602, "failed": 1e3, "notFound": 1001, "forbidden": 1003, "conflict": 1004, "unavailable": 1005, "protocol": 1006 }, "capabilities": { "attach.after": "session.attach accepts `after` and answers `cursor`/`reset`; envelopes kept in a tree timeline carry `cursor`.", "prompt.receipts": "session.prompt is answered at most once per (sessionId, clientMessageId) from a durable receipt; repeats answer the first outcome or outcome_unknown.", "extension.methods": "extension.register/unregister, and the daemon sends extension.invoke requests to the owning connection.", "team": "team.list: the teams a project can use, from the daemon host's built-ins, library and project.", "task": "task.list, task.create, task.update and task.gate.resolve on a project's .alp/tasks, written by the daemon under the task lock.", "library": "library.list/get/save/delete/duplicate/rename, library.skills.set and library.models on the daemon user's library and a project's .alp overrides; secrets are redacted on read.", "settings.language": "settings.language.get/set: the language the daemon user reads, in the daemon's ALP_HOME/settings.json.", "session.list.page": "session.list accepts `limit`, `cursor` and `query` and answers `nextCursor` while more sessions follow; without them it answers every session as before.", "question.watch": "question.watch: the connection is told of `question` and `question.resolved` in every tree (of a projectRoot when given), attached or not.", "question.watch.turns": "question.watch accepts `turns`: the connection is also told of `turn.ended` of every root in the trees it watches.", "session.attention": "question.watch accepts `attention`: its answer holds each watched root's finished or error attention, kept by alpd for every client, and the connection is told when one is set or cleared (an `attention` event); session.attention.clear acknowledges one.", "workspace.files": "workspace.files.search: files under a directory whose relative path matches a query; read-only, names only, links never followed.", "workspace.files.read": "workspace.files.list and workspace.files.read: the entries of a directory and the content of a UTF-8 text file (at most 1 MiB) under a directory; read-only, links never followed, .git, .env* and key or credential files refused, .gitignore'd paths hidden unless asked.", "workspace.files.browse": "workspace.files.find (every file and directory name under a directory, in pages of a snapshot, by its letters in order or by suffix), workspace.files.preview (a text, image or binary file of at most 50 MiB, its bytes in chunks of at most 8 MiB) and workspace.files.list's cursor and internalLinks (pages past 1000 entries; links whose real path is inside the directory, never outside); read-only, the block list and .gitignore as workspace.files.read. For the daemon host's own clients: the gateway exposes none of it.", "host.directories": "host.directories.search: directories of the daemon host whose path completes a typed path (absolute or under ~) or whose name matches a word under the home directory; names only, links never listed, bounded. For the daemon host's own clients: never remote.", "prompt.images": 'session.prompt takes inline image parts { type: "image", mimeType, data } (base64, no paths or URLs) within the image limits; a session snapshot says whether its runtime takes them in promptImages.', "library.project.write": "library save/delete/duplicate/rename accept policy project-data: only project-only pure-data agents and skills, no executable configuration, sidecars or library/built-in collisions.", "schedule": "schedule.create/list/get/cancel: one-shot continuations of a root session. alpd opens the turn by itself when the time comes; a job that comes due late says how late it is, and a job that cannot run says why.", "session.history": "Durable bounded backward envelope pages, persisted generation and numeric attach watermark.", "workspace.registry": "Daemon-owned project/workspace registry, durable pins, revision CAS and requestId replay.", "workspace.worktree": "Host-approved managed user worktrees; opt-in workspace.manage and named destination mappings.", "workspace.git": "workspace.git.status and workspace.git.diff: a registered workspace's read-only Git status and structured diff hunks by workspaceId; enumerated comparisons only, bounded (1 MiB per file, 2 MiB per page, 200 untracked files) with an opaque snapshot and next cursor; blocked secret paths withheld on both sides of a rename; no Git mutation.", "workspace.git.facts": "workspace.git.facts: the read-only Git checkout facts (repository root, branch, HEAD, remote, dirty) of an absolute host directory that need not be a registry workspace: a repository's top level (ok), a folder nested in one (not_repository_root, facts of the enclosing repository), no repository at or above it (unknown) or one alpd will not read (unsupported); owner only, never forwarded by a gateway; no Git mutation.", "attachments": 'attachment.begin/chunk/commit/abort/get/delete: daemon-owned immutable non-image attachments by opaque id, uploaded in bounded chunks, and session.prompt content parts `{ type: "attachment", attachmentId }`; daemon.hello carries `attachmentLimits`. Listed only with a home and a store, on macOS and Linux.', "session.fork": "session.fork: a new root whose conversation is a root's up to a completed turn (or a branch a rewind set aside), by native fork of Codex and Claude sessions; files are never copied or changed. Listed with a store and a runtime that forks native conversations, on macOS and Linux (not Windows).", "session.rewind": "session.rewind: a root's conversation from before a turn on, under the same session id; the later turns stay a recoverable branch, files are never changed, history generation advances (`history.reset` event). Same condition as session.fork.", "session.reload": "session.reload: restarts a live root's native process on its own conversation and configuration at the idle barrier (no turn, child, question, mail or parked work), keeping its session id, history and receipts; through the lifecycle journal. Listed with a store and a runtime that restarts a root on its own conversation, on macOS and Linux (not Windows).", "session.resumeCommand": "session.resumeCommand: the ALP CLI command (`alp attach <sessionId>`) that follows a session in a terminal, as argv and POSIX and Windows (cmd.exe) command lines built by alpd; for the clipboard only, never run, never a native runtime's command, credential, env or path.", "session.configure.live": "session.configure takes model, thinking and team (with requestId and ifGeneration) besides mode, and session.configure.preview answers the configuration a change would run with: a live root's model, effort or team changes at the idle barrier (no turn, child, question, mail or parked work) through a controlled restart of its native process on the same conversation; the effective configuration is written only after the runtime took it, through the lifecycle journal (\xA712.9). Never another runtime and never more permissions. Listed with a store and a runtime that restarts a root with a new configuration, on macOS and Linux (not Windows).", "terminal": "terminal.create/list/attach/input/resize/close/revoke and terminal.event notifications: a real PTY shell on the daemon host as the daemon's account (a cwd is not a sandbox), served only when the host owner opted in (<ALP_HOME>/terminal.json allowRemoteTerminal) on macOS (full protection), Linux and Windows (best-effort).", "session.interrupt.turn": "session.interrupt accepts turnId and atomically cancels only that active turn, including its subtree. Conditional requests answer interrupted:true when canceled, false when the named turn is no longer active; false changes nothing. Without this capability clients must not send turnId or infer targeted cancellation from a legacy interrupt.", "terminal.capture": "terminal.capture: bounded daemon-owned rendered text, inclusive zero-based/negative line ranges; same terminal principal/host opt-in. Exceeding resource/result limits is an explicit refusal.", "terminal.watch": "terminal.watch/unwatch and terminal.changed: atomic scoped snapshot/subscription. Opaque per-subscription cursor, latest snapshot replaces invalidation history on reconnect/reset; older hosts use explicit polling fallback.", "catalog.live": "catalog.get answers the live model catalog (provider lists merged over ALP's static rows) with fetchedAt and per-provider status; catalog.refresh asks the providers again; alpd sends catalog.updated to every helloed connection when the catalog changes." }, "methods": { "assignment.recall": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "projectRoot", "required": false, "alternatives": ["assignmentId", "taskId"] }, "idempotent": false, "risks": ["model call"] }, "params": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "taskId": { "type": "string" }, "projectRoot": { "type": "string" }, "question": { "type": "string" } }, "required": ["question"], "additionalProperties": true }, "result": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "taskId": { "type": "string" }, "finishedAt": { "type": "string" }, "answer": { "type": "string" } }, "required": ["assignmentId", "agent", "finishedAt", "answer"], "additionalProperties": true } }, "board.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "pins": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["pins"], "additionalProperties": true } }, "catalog.get": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object" } }, "modes": { "type": "array", "items": { "type": "object" } }, "thinkingOptions": {}, "defaultModel": { "type": "string" }, "fetchedAt": { "type": "string" }, "providers": { "type": "object" } }, "required": ["models", "modes", "defaultModel"], "additionalProperties": true } }, "catalog.refresh": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object" } }, "modes": { "type": "array", "items": { "type": "object" } }, "thinkingOptions": {}, "defaultModel": { "type": "string" }, "fetchedAt": { "type": "string" }, "providers": { "type": "object" } }, "required": ["models", "modes", "defaultModel"], "additionalProperties": true } }, "daemon.hello": { "x-alp": { "effect": "query", "scope": { "kind": "connection" }, "idempotent": true }, "params": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "client": { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" } }, "required": ["name", "version"], "additionalProperties": true }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": ["protocolVersion"], "additionalProperties": true }, "result": { "type": "object", "properties": { "protocolVersion": { "const": 1 }, "daemonVersion": { "type": "string" }, "pid": { "type": "integer" }, "hostname": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "promptImageLimits": { "type": "object", "description": "Optional effective inline image limits for this connection, when prompt.images is advertised. Missing on older peers. Byte limits count decoded bytes.", "properties": { "maxCount": { "type": "integer", "minimum": 0 }, "maxBytes": { "type": "integer", "minimum": 0 }, "maxTotalBytes": { "type": "integer", "minimum": 0 } }, "required": ["maxCount", "maxBytes", "maxTotalBytes"], "additionalProperties": false }, "attachmentLimits": { "type": "object", "description": "Effective attachment limits for this connection, when `attachments` is advertised. Byte limits count decoded bytes; times are milliseconds. An operator or a gateway may lower them, never raise them.", "properties": { "maxObjectBytes": { "type": "integer", "minimum": 0 }, "maxPerPrompt": { "type": "integer", "minimum": 0 }, "maxPromptBytes": { "type": "integer", "minimum": 0 }, "maxChunkBytes": { "type": "integer", "minimum": 0 }, "maxActiveUploads": { "type": "integer", "minimum": 0 }, "maxPrincipalBytes": { "type": "integer", "minimum": 0 }, "maxDaemonBytes": { "type": "integer", "minimum": 0 }, "uploadTimeoutMs": { "type": "integer", "minimum": 0 }, "unreferencedRetentionMs": { "type": "integer", "minimum": 0 }, "releasedGraceMs": { "type": "integer", "minimum": 0 } }, "required": ["maxObjectBytes", "maxPerPrompt", "maxPromptBytes", "maxChunkBytes", "maxActiveUploads", "maxPrincipalBytes", "maxDaemonBytes", "uploadTimeoutMs", "unreferencedRetentionMs", "releasedGraceMs"], "additionalProperties": false }, "terminalLimits": { "type": "object", "description": "Effective terminal limits for this connection, when `terminal` is advertised. Byte limits count UTF-8 bytes; times are milliseconds. An operator or a gateway may lower them, never raise them.", "properties": { "maxPerPrincipal": { "type": "integer", "minimum": 0 }, "maxPerDaemon": { "type": "integer", "minimum": 0 }, "maxInputBytes": { "type": "integer", "minimum": 0 }, "maxOutputFrameBytes": { "type": "integer", "minimum": 0 }, "replayBytes": { "type": "integer", "minimum": 0 }, "idleMs": { "type": "integer", "minimum": 0 }, "maxLifetimeMs": { "type": "integer", "minimum": 0 }, "reconnectMs": { "type": "integer", "minimum": 0 } }, "required": ["maxPerPrincipal", "maxPerDaemon", "maxInputBytes", "maxOutputFrameBytes", "replayBytes", "idleMs", "maxLifetimeMs", "reconnectMs"], "additionalProperties": false } }, "required": ["protocolVersion"], "additionalProperties": true } }, "daemon.pause": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] }, "now": { "type": "boolean" }, "reason": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.pauses": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.resume": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": { "runtime": { "enum": ["codex", "claude", "acp", "antigravity"] } }, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/pauseState" } }, "daemon.shutdown": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "idempotent": true, "risks": ["admin"] }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "daemon.status": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "pid": { "type": "integer" }, "startedAt": { "type": "string" }, "version": { "type": "string" }, "protocolVersion": { "type": "integer" }, "sessions": { "type": "integer" }, "questions": { "type": "integer" }, "previousExit": { "type": "object", "properties": { "kind": { "enum": ["clean", "crash"] }, "at": { "type": "string" } }, "required": ["kind"], "additionalProperties": true }, "persistence": { "type": "object" }, "health": { "$ref": "#/$defs/health" } }, "required": ["pid", "startedAt", "version", "protocolVersion", "sessions", "questions", "health"], "additionalProperties": true } }, "daemon.usage": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true, "risks": ["refresh asks every provider (spawns on the daemon host)"] }, "params": { "type": "object", "properties": { "refresh": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "providers": { "type": "array", "items": { "type": "object" } } }, "required": ["providers"], "additionalProperties": true } }, "extension.register": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "registered": { "type": "string" } }, "required": ["registered"], "additionalProperties": true } }, "extension.unregister": { "x-alp": { "effect": "mutation", "scope": { "kind": "connection" }, "idempotent": false, "risks": ["admin"] }, "params": { "type": "object", "properties": { "method": { "type": "string" } }, "required": ["method"], "additionalProperties": true }, "result": { "type": "object", "properties": { "unregistered": { "type": "string" } }, "required": ["unregistered"], "additionalProperties": true } }, "library.delete": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "revision": { "type": "string" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "name", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "removed": { "const": true }, "now": { "enum": ["builtin", "library"] } }, "required": ["removed"], "additionalProperties": true } }, "library.duplicate": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope", "reads": ["builtin", "library"] }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.get": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true, "redacts": ["mcp /server/env/*", "mcp /server/headers/*", "providers /provider/env/*"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "scope": { "$ref": "#/$defs/libraryScope" } }, "required": ["kind", "name"], "additionalProperties": true }, "result": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "usedBy": { "type": "array", "items": { "type": "string" } }, "librarySkills": { "type": "array", "items": { "type": "string" } }, "secrets": { "type": "array", "items": { "type": "string" } } }, "required": ["kind", "name", "source", "content", "revision", "usedBy"], "additionalProperties": true } }, "library.list": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["kind"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "entries": { "type": "array", "items": { "$ref": "#/$defs/libraryEntryRow" } } }, "required": ["projectRoot", "entries"], "additionalProperties": true } }, "library.models": { "x-alp": { "effect": "query", "capability": "library", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "models": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "efforts": { "type": "array", "items": { "type": "string" } }, "effort": { "type": "string" } }, "required": ["id", "label", "efforts"], "additionalProperties": true } } }, "required": ["models"], "additionalProperties": true } }, "library.rename": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": false, "risks": ["exec-config when kind is mcp, hooks or providers"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "from": { "$ref": "#/$defs/entryName" }, "to": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "from", "to", "scope"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" } }, "required": ["revision"], "additionalProperties": true } }, "library.save": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "library-or-project", "param": "projectRoot", "selector": "scope" }, "idempotent": "with revision (a repeat fails revision_conflict)", "risks": ["exec-config when kind is mcp, hooks or providers, or agents naming mcp/hooks/provider", "writes every known project's .alp/settings.json when kind is teams and sync is known-projects"] }, "params": { "type": "object", "properties": { "kind": { "$ref": "#/$defs/libraryKind" }, "name": { "$ref": "#/$defs/entryName" }, "scope": { "$ref": "#/$defs/libraryScope" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "content": { "type": "object" }, "revision": { "$ref": "#/$defs/libraryRevision" }, "sync": { "enum": ["none", "known-projects"] }, "policy": { "enum": ["project-data"], "description": "Opt-in strict project-only non-executable mutation policy; requires library.project.write capability." } }, "required": ["kind", "name", "scope", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "revision": { "$ref": "#/$defs/libraryRevision" }, "syncedProjects": { "type": "integer", "minimum": 0 }, "syncErrors": { "type": "array", "items": { "type": "string" } } }, "required": ["revision"], "additionalProperties": true } }, "library.skills.set": { "x-alp": { "effect": "mutation", "capability": "library", "scope": { "kind": "host" }, "writes": ["ALP_HOME/role-skills.json"], "idempotent": true }, "params": { "type": "object", "properties": { "agent": { "$ref": "#/$defs/entryName" }, "skills": { "type": "array", "items": { "$ref": "#/$defs/entryName" }, "maxItems": 100 } }, "required": ["agent", "skills"], "additionalProperties": true }, "result": { "type": "object", "properties": { "skills": { "type": "array", "items": { "type": "string" } } }, "required": ["skills"], "additionalProperties": true } }, "question.answer": { "x-alp": { "effect": "mutation", "scope": { "kind": "question", "param": "questionId", "prefix": true }, "idempotent": false }, "params": { "type": "object", "properties": { "questionId": { "type": "string" }, "text": { "type": "string" }, "dismiss": { "type": "boolean" }, "reason": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "questionId": { "type": "string" } }, "required": ["questionId"], "additionalProperties": true } }, "question.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } } }, "required": ["questions"], "additionalProperties": true } }, "question.watch": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true, "capability": "question.watch" }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "turns": { "type": "boolean" }, "attention": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } }, "attention": { "type": "array", "items": { "type": "object", "properties": { "sessionId": { "type": "string" }, "attention": { "$ref": "#/$defs/attention" } }, "required": ["sessionId", "attention"], "additionalProperties": true } } }, "required": ["questions"], "additionalProperties": true } }, "session.attention.clear": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true, "capability": "session.attention" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "at": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "cleared": { "type": "boolean" } }, "required": ["cleared"], "additionalProperties": true } }, "schedule.create": { "x-alp": { "effect": "mutation", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["ALP_HOME/schedules"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "dueAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 8e3, "pattern": "\\S" } }, "required": ["projectRoot", "sessionId", "dueAt", "prompt"], "additionalProperties": true }, "result": { "type": "object", "properties": { "job": { "$ref": "#/$defs/scheduleJob" } }, "required": ["job"], "additionalProperties": true } }, "schedule.list": { "x-alp": { "effect": "query", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "status": { "enum": ["pending", "delivered", "failed", "cancelled"] } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "jobs": { "type": "array", "items": { "$ref": "#/$defs/scheduleJob" } } }, "required": ["jobs"], "additionalProperties": true } }, "schedule.get": { "x-alp": { "effect": "query", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "id": { "$ref": "#/$defs/scheduleId" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["id", "projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "job": { "$ref": "#/$defs/scheduleJob" } }, "required": ["job"], "additionalProperties": true } }, "schedule.cancel": { "x-alp": { "effect": "mutation", "capability": "schedule", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["ALP_HOME/schedules"], "idempotent": true }, "params": { "type": "object", "properties": { "id": { "$ref": "#/$defs/scheduleId" }, "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["id", "projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "job": { "$ref": "#/$defs/scheduleJob" } }, "required": ["job"], "additionalProperties": true } }, "session.archive": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "archived": { "type": "boolean" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.attach": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "replay": { "type": "boolean" }, "after": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "generation": { "type": "string", "maxLength": 128 } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "cursor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reset": { "const": true } }, "required": ["session", "cursor"], "additionalProperties": true } }, "session.close": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.compact": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "risks": ["main writes a checkpoint in a turn of its own, then its context is compacted natively or replaced by a fresh conversation seeded with the checkpoint"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "status": { "enum": ["started", "deferred", "running"] } }, "required": ["status"], "additionalProperties": false } }, "session.configure": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": "mode alone: yes; with model, thinking or team: with requestId", "risks": ["with model, thinking or team: restarts the root's native process on its own conversation; never another runtime, never more permissions"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "mode": { "type": "string" }, "model": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Native model, or runtime-prefixed (codex:/claude:); the session's own runtime only (capability session.configure.live)." }, "thinking": { "type": "string", "minLength": 1, "maxLength": 200, "description": "An effort the model takes (capability session.configure.live)." }, "team": { "type": "string", "minLength": 1, "maxLength": 200, "description": "A team id the daemon host defines (capability session.configure.live); no path or configuration." }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, "required": ["sessionId"], "anyOf": [{ "not": { "anyOf": [{ "required": ["model"] }, { "required": ["thinking"] }, { "required": ["team"] }] } }, { "required": ["requestId", "ifGeneration"] }], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" }, "configured": { "$ref": "#/$defs/configureOutcome" }, "duplicate": { "const": true } }, "required": ["session"], "additionalProperties": true } }, "session.configure.preview": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.configure.live", "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "mode": { "type": "string" }, "model": { "type": "string", "minLength": 1, "maxLength": 200 }, "thinking": { "type": "string", "minLength": 1, "maxLength": 200 }, "team": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/configurePreview" } }, "required": ["preview"], "additionalProperties": true } }, "session.create": { "x-alp": { "effect": "mutation", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": false, "risks": ["exec: spec.env and stdio spec.mcpServers run on the daemon host", "spec.workdir/writeRoot/copy*/restore/keepThread are internal"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,128}$" }, "spec": { "anyOf": [{ "$ref": "#/$defs/spec" }, { "type": "object", "properties": { "agent": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "persist": { "type": "boolean" }, "workflow": { "type": "string" } }, "required": [], "additionalProperties": false }] }, "history": { "enum": ["skip", "replay"] }, "delegation": { "type": "boolean" }, "resume": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": ["spec"], "additionalProperties": true, "anyOf": [{ "required": ["workspaceId"] }, { "properties": { "spec": { "$ref": "#/$defs/spec" } } }] }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/session" }, "attached": { "type": "boolean" }, "resumed": { "const": true }, "durable": { "type": "boolean" } }, "required": ["session", "attached"], "additionalProperties": true } }, "session.get": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.interrupt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "turnId": { "type": "string", "minLength": 1 } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "interrupted": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "session.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": false }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "rootsOnly": { "type": "boolean" }, "includeClosed": { "type": "boolean" }, "includeArchived": { "type": "boolean" }, "limit": { "type": "integer", "minimum": 1, "maximum": 1e3 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 }, "query": { "type": "string", "maxLength": 200 }, "projectRoots": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 1024 } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/$defs/sessionSummary" } }, "nextCursor": { "type": "string", "minLength": 1 } }, "required": ["sessions"], "additionalProperties": true } }, "session.log": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "rootId": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object" } } }, "required": ["rootId", "entries"], "additionalProperties": true } }, "session.message": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": false }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "text": { "type": "string" } }, "required": ["sessionId", "text"], "additionalProperties": true }, "result": { "type": "object", "properties": {}, "required": [], "additionalProperties": true } }, "session.preview": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "spec.cwd" }, "idempotent": true }, "params": { "type": "object", "properties": { "spec": { "$ref": "#/$defs/spec" } }, "required": ["spec"], "additionalProperties": true }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/preview" } }, "required": ["preview"], "additionalProperties": true } }, "session.prompt": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": "with prompt.receipts" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "clientMessageId": { "type": "string" }, "delivery": { "enum": ["auto", "steer"] }, "content": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "type": { "const": "text" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "$ref": "#/$defs/promptImage" }, { "type": "object", "properties": { "type": { "const": "attachment" }, "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" } }, "required": ["type", "attachmentId"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["text", "image", "attachment"] } } }, "required": ["type"], "additionalProperties": true }] } }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["sessionId", "clientMessageId", "content"], "additionalProperties": true }, "result": { "type": "object", "properties": { "outcome": { "enum": ["accepted", "failed"] }, "error": { "$ref": "#/$defs/alpError" }, "duplicate": { "type": "boolean" }, "durable": { "type": "boolean" } }, "required": [], "additionalProperties": true } }, "session.release": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "closed": { "type": "boolean" } }, "required": ["closed"], "additionalProperties": true } }, "session.rename": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" } }, "required": ["sessionId", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" } }, "required": ["session"], "additionalProperties": true } }, "session.status": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" } }, "required": ["sessionId"], "additionalProperties": true }, "result": { "type": "object", "properties": { "status": { "$ref": "#/$defs/treeStatus" } }, "required": ["status"], "additionalProperties": true } }, "settings.language.get": { "x-alp": { "effect": "query", "capability": "settings.language", "scope": { "kind": "host" }, "idempotent": true }, "params": { "type": "object", "properties": {}, "required": [], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "settings.language.set": { "x-alp": { "effect": "mutation", "capability": "settings.language", "scope": { "kind": "host" }, "writes": ["ALP_HOME/settings.json"], "idempotent": true }, "params": { "type": "object", "properties": { "language": { "anyOf": [{ "type": "string", "minLength": 1, "maxLength": 40, "pattern": "\\S" }, { "type": "null" }] } }, "required": ["language"], "additionalProperties": true }, "result": { "$ref": "#/$defs/languageSetting" } }, "task.create": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": "per requestId within one alpd process (10 minutes)" }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "title": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" }, "priority": { "type": "integer", "minimum": 0, "maximum": 4 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["projectRoot", "title"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "duplicate": { "const": true } }, "required": ["id"], "additionalProperties": true } }, "task.gate.resolve": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "gate": { "type": "string", "minLength": 1, "maxLength": 128 }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 }, "choice": { "type": "string", "minLength": 1, "maxLength": 200 }, "reject": { "type": "boolean" }, "channel": { "type": "string", "enum": ["paseo", "web"] } }, "required": ["projectRoot", "id", "gate"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "task.list": { "x-alp": { "effect": "query", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "tasks": { "type": "array", "items": { "$ref": "#/$defs/taskRow" } }, "unreadable": { "type": "array", "items": { "type": "object", "properties": { "file": { "type": "string" }, "error": { "type": "string" } }, "required": ["file", "error"], "additionalProperties": true } }, "revision": { "type": "string" } }, "required": ["projectRoot", "tasks", "unreadable", "revision"], "additionalProperties": true } }, "task.update": { "x-alp": { "effect": "mutation", "capability": "task", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "writes": ["<projectRoot>/.alp/tasks"], "idempotent": false }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" }, "id": { "$ref": "#/$defs/taskId" }, "action": { "enum": ["close", "reopen"] }, "note": { "type": "string", "maxLength": 2e3 }, "ifRev": { "type": "integer", "minimum": 0 } }, "required": ["projectRoot", "id", "action"], "additionalProperties": true }, "result": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "status": { "type": "string" }, "rev": { "type": "integer", "minimum": 0 }, "landed": { "type": "string" } }, "required": ["id", "status", "rev"], "additionalProperties": true } }, "team.list": { "x-alp": { "effect": "query", "capability": "team", "scope": { "kind": "project", "param": "projectRoot", "required": false, "reads": ["builtin", "library"] }, "idempotent": true }, "params": { "type": "object", "properties": { "projectRoot": { "$ref": "#/$defs/projectRoot" } }, "required": [], "additionalProperties": true }, "result": { "type": "object", "properties": { "projectRoot": { "type": ["string", "null"] }, "teams": { "type": "array", "items": { "$ref": "#/$defs/teamRow" } } }, "required": ["projectRoot", "teams"], "additionalProperties": true } }, "workspace.files.search": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files", "risks": ["lists file names of the directory (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "query": { "type": "string", "maxLength": 200 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "files": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 } }, "required": ["path"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["files"], "additionalProperties": true } }, "workspace.files.list": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["lists names, kinds, sizes and times of a directory's entries (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 }, "internalLinks": { "type": "boolean" } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "entries": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "kind": { "enum": ["file", "directory"] }, "size": { "type": "integer", "minimum": 0 }, "modifiedAt": { "type": "string" }, "target": { "type": "string", "minLength": 1 } }, "required": ["name", "path", "kind"], "additionalProperties": true } }, "truncated": { "type": "boolean" }, "nextCursor": { "type": "string", "minLength": 1, "maxLength": 1024 }, "target": { "type": "string", "minLength": 1 } }, "required": ["entries"], "additionalProperties": true } }, "workspace.files.read": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.read", "risks": ["returns the content of a text file under the directory"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" } }, "required": ["projectRoot", "path"], "additionalProperties": true }, "result": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "content": { "type": "string" }, "size": { "type": "integer", "minimum": 0, "maximum": 1048576 }, "modifiedAt": { "type": "string" } }, "required": ["path", "content", "size"], "additionalProperties": true } }, "workspace.files.find": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.browse", "risks": ["lists every file and directory name of the directory (not contents)"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "query": { "type": "string", "maxLength": 200 }, "kinds": { "type": "array", "items": { "enum": ["file", "directory"] }, "minItems": 1, "maxItems": 2, "uniqueItems": true }, "matchMode": { "enum": ["subsequence", "suffix"] }, "limit": { "type": "integer", "minimum": 1, "maximum": 1e3 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": ["projectRoot"], "additionalProperties": true }, "result": { "type": "object", "properties": { "entries": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "kind": { "enum": ["file", "directory"] } }, "required": ["path", "kind"], "additionalProperties": true } }, "nextCursor": { "type": "string", "minLength": 1, "maxLength": 256 }, "truncated": { "type": "boolean" } }, "required": ["entries"], "additionalProperties": true } }, "workspace.files.preview": { "x-alp": { "effect": "query", "scope": { "kind": "project", "param": "projectRoot", "required": true }, "idempotent": true, "capability": "workspace.files.browse", "risks": ["returns the bytes of a file under the directory, text, image or binary, up to 50 MiB in chunks"] }, "params": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "includeIgnored": { "type": "boolean" }, "internalLinks": { "type": "boolean" }, "maxBytes": { "type": "integer", "minimum": 1, "maximum": 52428800 }, "offset": { "type": "integer", "minimum": 0, "maximum": 52428800 }, "revision": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": ["projectRoot", "path"], "additionalProperties": true }, "result": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "target": { "type": "string", "minLength": 1 }, "kind": { "enum": ["text", "image", "binary"] }, "mimeType": { "type": "string", "minLength": 1, "maxLength": 255 }, "size": { "type": "integer", "minimum": 0, "maximum": 52428800 }, "modifiedAt": { "type": "string" }, "revision": { "type": "string", "minLength": 1, "maxLength": 64 }, "encoding": { "enum": ["base64", "none"] }, "content": { "type": "string", "maxLength": 11184812 }, "offset": { "type": "integer", "minimum": 0 }, "nextOffset": { "type": "integer", "minimum": 1 } }, "required": ["path", "kind", "mimeType", "size", "modifiedAt", "revision", "encoding"], "additionalProperties": true } }, "host.directories.search": { "x-alp": { "effect": "query", "scope": { "kind": "host" }, "idempotent": true, "capability": "host.directories", "risks": ["lists names of directories on the daemon host outside any workspace"] }, "params": { "type": "object", "properties": { "query": { "type": "string", "maxLength": 4096 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": ["query"], "additionalProperties": true }, "result": { "type": "object", "properties": { "entries": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 } }, "required": ["path"], "additionalProperties": true } }, "truncated": { "type": "boolean" } }, "required": ["entries"], "additionalProperties": true } }, "session.history": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "idempotent": true, "capability": "session.history" }, "params": { "type": "object", "properties": { "sessionId": { "type": "string" }, "before": { "type": "string", "maxLength": 4096 }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "maxBytes": { "type": "integer", "minimum": 2048, "maximum": 524288 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "generation": { "type": "string" }, "items": { "type": "array", "maxItems": 500, "items": { "oneOf": [{ "$ref": "#/$defs/envelope" }, { "type": "object", "properties": { "cursor": { "type": "integer", "minimum": 0 }, "oversized": { "type": "object", "properties": { "bytes": { "type": "integer", "minimum": 1 } }, "required": ["bytes"] } }, "required": ["cursor", "oversized"], "additionalProperties": false }] } }, "olderCursor": { "type": "string" }, "hasOlder": { "type": "boolean" }, "tipCursor": { "type": "integer", "minimum": 0 } }, "required": ["generation", "items", "hasOlder", "tipCursor"], "additionalProperties": true } }, "project.list": { "params": { "type": "object", "properties": { "cursor": { "type": "string", "pattern": "^[0-9]+$" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "projectRoots": { "type": "array", "items": { "type": "string" } }, "includeRemoved": { "type": "boolean" } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "projects": { "type": "array", "items": { "$ref": "#/$defs/registryProject" } }, "revision": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "nextCursor": { "type": ["string", "null"] } }, "required": ["projects", "revision", "total", "nextCursor"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "workspace.list": { "params": { "type": "object", "properties": { "cursor": { "type": "string", "pattern": "^[0-9]+$" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500 }, "projectRoots": { "type": "array", "items": { "type": "string" } }, "includeArchived": { "type": "boolean" } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspaces": { "type": "array", "items": { "$ref": "#/$defs/registryWorkspace" } }, "revision": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "nextCursor": { "type": ["string", "null"] } }, "required": ["workspaces", "revision", "total", "nextCursor"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "workspace.get": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" } }, "required": ["workspaceId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "project.register": { "params": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "directory": { "type": "string" }, "authorizedRoots": { "type": "array", "items": { "type": "string" } } }, "required": ["directory", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "project": { "$ref": "#/$defs/registryProject" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["project", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "project.remove": { "params": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "projectId": { "type": "string" }, "authorizedRoots": { "type": "array", "items": { "type": "string" } } }, "required": ["projectId", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "project": { "$ref": "#/$defs/registryProject" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["project", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "workspace.update": { "params": { "type": "object", "properties": { "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "workspaceId": { "type": "string" }, "title": { "type": ["string", "null"] }, "pinned": { "type": "boolean" }, "archived": { "type": "boolean" }, "authorizedRoots": { "type": "array", "items": { "type": "string" } } }, "required": ["workspaceId", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.registry", "idempotent": true } }, "registry.owner": { "params": { "type": "object", "properties": { "operation": { "enum": ["project.add", "project.rename", "project.remove", "workspace.create", "workspace.update", "placement.prepare", "placement.assign", "label.assign", "label.update", "label.delete", "placement.remove"] }, "args": { "type": "object" }, "requestId": { "type": "string" }, "ifRevision": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "registry": { "type": "object" } }, "required": ["registry"] }, "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "capability": "workspace.registry", "idempotent": false } }, "workspace.worktree.create": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "mappingId": { "type": "string", "maxLength": 64 }, "principalEpoch": { "type": "string" } }, "required": ["workspaceId", "requestId", "ifRevision", "mappingId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 }, "filesRemoved": { "type": "boolean" }, "branchRetained": { "type": "boolean" } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.worktree", "idempotent": true } }, "workspace.worktree.remove": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "ifRevision": { "type": "integer", "minimum": 0 }, "principalEpoch": { "type": "string" } }, "required": ["workspaceId", "requestId", "ifRevision"], "additionalProperties": false }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/registryWorkspace" }, "revision": { "type": "integer", "minimum": 0 }, "filesRemoved": { "type": "boolean" }, "branchRetained": { "type": "boolean" } }, "required": ["workspace", "revision"], "additionalProperties": false }, "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "workspace.worktree", "idempotent": true } }, "workspace.worktree.options": { "params": { "type": "object", "properties": { "workspaceId": { "type": "string" }, "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "principalEpoch": { "type": "string" } }, "required": ["workspaceId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "mappingIds": { "type": "array", "items": { "type": "string" } } }, "required": ["mappingIds"], "additionalProperties": false }, "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.worktree", "idempotent": true } }, "registry.worktree": { "params": { "type": "object", "properties": { "principalId": { "type": "string" }, "mappingIds": { "type": "array", "items": { "type": "string" } }, "authorizedRoots": { "type": "array", "items": { "type": "string" } }, "principalEpoch": { "type": "string" } }, "additionalProperties": false }, "result": { "type": "object", "additionalProperties": true }, "x-alp": { "effect": "query", "scope": { "kind": "host" }, "capability": "workspace.worktree" } }, "workspace.git.status": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.git", "idempotent": true, "risks": ["lists the changed file paths, branch and remote of a workspace checkout"] }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1 } }, "required": ["workspaceId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "state": { "enum": ["repository", "not_repository", "unsupported"] }, "reason": { "type": "string" }, "branch": { "type": ["string", "null"] }, "detached": { "type": "boolean" }, "head": { "type": ["string", "null"] }, "upstream": { "type": ["object", "null"], "properties": { "ref": { "type": "string" }, "ahead": { "type": "integer", "minimum": 0 }, "behind": { "type": "integer", "minimum": 0 } }, "required": ["ref", "ahead", "behind"], "additionalProperties": false }, "baseRef": { "type": ["string", "null"] }, "aheadBehind": { "type": ["object", "null"], "properties": { "ahead": { "type": "integer", "minimum": 0 }, "behind": { "type": "integer", "minimum": 0 } }, "required": ["ahead", "behind"], "additionalProperties": false }, "hasRemote": { "type": "boolean" }, "remoteUrl": { "type": ["string", "null"] }, "dirty": { "type": "boolean" }, "files": { "type": "array", "maxItems": 1e3, "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "oldPath": { "type": "string", "minLength": 1, "maxLength": 4096 }, "change": { "enum": ["modified", "added", "deleted", "renamed", "copied", "typechange", "untracked", "conflicted"] }, "staged": { "type": "boolean" }, "unstaged": { "type": "boolean" } }, "required": ["path", "change", "staged", "unstaged"], "additionalProperties": false } }, "hiddenCount": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" }, "snapshot": { "type": "string", "maxLength": 1024 } }, "required": ["state", "branch", "detached", "head", "upstream", "baseRef", "aheadBehind", "hasRemote", "remoteUrl", "dirty", "files", "hiddenCount", "truncated", "snapshot"], "additionalProperties": false } }, "workspace.git.facts": { "x-alp": { "effect": "query", "scope": { "kind": "host", "param": "directory" }, "capability": "workspace.git.facts", "idempotent": true, "risks": ["names the host path, branch and remote of a directory's enclosing Git checkout (owner only, never remote)"] }, "params": { "type": "object", "properties": { "directory": { "type": "string", "minLength": 1, "maxLength": 4096 } }, "required": ["directory"], "additionalProperties": false }, "result": { "oneOf": [{ "type": "object", "properties": { "kind": { "const": "ok" }, "repoRoot": { "type": "string", "minLength": 1 }, "branch": { "type": ["string", "null"] }, "detached": { "type": "boolean" }, "head": { "type": ["string", "null"] }, "hasRemote": { "type": "boolean" }, "remoteUrl": { "type": ["string", "null"] }, "dirty": { "type": "boolean" } }, "required": ["kind", "repoRoot", "branch", "detached", "head", "hasRemote", "remoteUrl", "dirty"], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "not_repository_root" }, "repoRoot": { "type": "string", "minLength": 1 }, "branch": { "type": ["string", "null"] }, "detached": { "type": "boolean" }, "head": { "type": ["string", "null"] }, "hasRemote": { "type": "boolean" }, "remoteUrl": { "type": ["string", "null"] }, "dirty": { "type": "boolean" } }, "required": ["kind", "repoRoot", "branch", "detached", "head", "hasRemote", "remoteUrl", "dirty"], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "unknown" } }, "required": ["kind"], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "unsupported" }, "reason": { "enum": ["worktree_elsewhere", "inside_git_dir"] } }, "required": ["kind", "reason"], "additionalProperties": false }] } }, "workspace.git.diff": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "workspace.git", "idempotent": true, "risks": ["returns changed file content of a workspace checkout as diff hunks, including deleted and historical lines"] }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1 }, "compare": { "type": "object", "properties": { "mode": { "enum": ["uncommitted", "staged", "unstaged", "base"] }, "baseRef": { "type": "string", "minLength": 1, "maxLength": 255 }, "ignoreWhitespace": { "type": "boolean" } }, "required": ["mode"], "additionalProperties": false }, "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "required": ["workspaceId", "compare"], "additionalProperties": false }, "result": { "type": "object", "properties": { "compare": { "type": "object", "properties": { "mode": { "enum": ["uncommitted", "staged", "unstaged", "base"] }, "baseRef": { "type": "string" }, "ignoreWhitespace": { "type": "boolean" } }, "required": ["mode", "ignoreWhitespace"], "additionalProperties": false }, "snapshot": { "type": "string", "maxLength": 1024 }, "files": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 4096 }, "oldPath": { "type": "string", "minLength": 1, "maxLength": 4096 }, "change": { "enum": ["modified", "added", "deleted", "renamed", "copied", "typechange", "untracked", "conflicted"] }, "kind": { "enum": ["text", "binary", "too_large", "withheld", "symlink", "submodule"] }, "additions": { "type": "integer", "minimum": 0 }, "deletions": { "type": "integer", "minimum": 0 }, "hunks": { "type": "array", "items": { "type": "object", "properties": { "oldStart": { "type": "integer", "minimum": 0 }, "oldCount": { "type": "integer", "minimum": 0 }, "newStart": { "type": "integer", "minimum": 0 }, "newCount": { "type": "integer", "minimum": 0 }, "context": { "type": "string" }, "lines": { "type": "array", "items": { "type": "object", "properties": { "type": { "enum": ["add", "remove", "context"] }, "content": { "type": "string" }, "noNewline": { "const": true } }, "required": ["type", "content"], "additionalProperties": false } } }, "required": ["oldStart", "oldCount", "newStart", "newCount", "lines"], "additionalProperties": false } } }, "required": ["path", "change", "kind", "additions", "deletions", "hunks"], "additionalProperties": false } }, "hiddenCount": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" }, "nextCursor": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "required": ["compare", "snapshot", "files", "hiddenCount", "truncated"], "additionalProperties": false } }, "attachment.begin": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "attachments", "idempotent": "with requestId", "risks": ["reserves stored bytes of the daemon host for a file the client uploads"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,128}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "size": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "mimeType": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}$" }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "requestId": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["sessionId", "name", "size", "mimeType", "requestId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "state": { "enum": ["uploading", "committed"] }, "received": { "type": "integer", "minimum": 0 }, "size": { "type": "integer", "minimum": 0 }, "maxChunkBytes": { "type": "integer", "minimum": 1 }, "expiresAt": { "type": "string" }, "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" } }, "required": ["uploadId", "state", "received", "size", "maxChunkBytes"], "additionalProperties": false } }, "attachment.chunk": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": "same offset and bytes", "risks": ["writes uploaded bytes to the daemon host"] }, "params": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "data": { "type": "string", "minLength": 4, "maxLength": 349528, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["uploadId", "offset", "data"], "additionalProperties": false }, "result": { "type": "object", "properties": { "received": { "type": "integer", "minimum": 0 }, "size": { "type": "integer", "minimum": 0 } }, "required": ["received", "size"], "additionalProperties": false } }, "attachment.commit": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": true }, "params": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["uploadId", "sha256"], "additionalProperties": false }, "result": { "type": "object", "properties": { "attachment": { "$ref": "#/$defs/attachment" } }, "required": ["attachment"], "additionalProperties": false } }, "attachment.abort": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": false }, "params": { "type": "object", "properties": { "uploadId": { "type": "string", "pattern": "^upl_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["uploadId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "aborted": { "const": true } }, "required": ["aborted"], "additionalProperties": false } }, "attachment.get": { "x-alp": { "effect": "query", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": true }, "params": { "type": "object", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["attachmentId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "attachment": { "$ref": "#/$defs/attachment" } }, "required": ["attachment"], "additionalProperties": false } }, "attachment.delete": { "x-alp": { "effect": "mutation", "scope": { "kind": "session" }, "capability": "attachments", "idempotent": false }, "params": { "type": "object", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["attachmentId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "deleted": { "const": true } }, "required": ["deleted"], "additionalProperties": false } }, "session.fork": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.fork", "idempotent": "with requestId", "risks": ["creates a new root session in the source workspace or a granted destination workspace; files are never copied, restored or changed"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "boundary": { "oneOf": [{ "type": "object", "properties": { "throughTurnId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["throughTurnId"], "additionalProperties": false }, { "type": "object", "properties": { "beforeTurnId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["beforeTurnId"], "additionalProperties": false }] }, "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "newSessionId": { "type": "string", "pattern": "^[\\w.:-]{1,128}$" }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the bound project must be one of them." } }, "required": ["sessionId", "requestId", "ifGeneration"], "additionalProperties": false }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "forkedFrom": { "$ref": "#/$defs/forkProvenance" }, "duplicate": { "const": true } }, "required": ["session", "forkedFrom"], "additionalProperties": true } }, "session.rewind": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.rewind", "idempotent": "with requestId", "risks": ["replaces the conversation the runtime continues from; the later turns stay recoverable and no file is changed"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "beforeTurnId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["sessionId", "requestId", "ifGeneration", "beforeTurnId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "generation": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "branch": { "$ref": "#/$defs/conversationBranch" }, "duplicate": { "const": true } }, "required": ["session", "generation", "branch"], "additionalProperties": true } }, "session.reload": { "x-alp": { "effect": "mutation", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.reload", "idempotent": "with requestId", "risks": ["restarts the root's native process; its conversation, configuration, history and receipts are kept"] }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "ifGeneration": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, "required": ["sessionId", "requestId", "ifGeneration"], "additionalProperties": false }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/sessionSummary" }, "duplicate": { "const": true } }, "required": ["session"], "additionalProperties": true } }, "session.resumeCommand": { "x-alp": { "effect": "query", "scope": { "kind": "session", "param": "sessionId" }, "capability": "session.resumeCommand", "idempotent": true }, "params": { "type": "object", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": ["sessionId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "argv": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" } }, "posix": { "type": "string", "minLength": 1, "maxLength": 2048 }, "windows": { "type": "string", "minLength": 1, "maxLength": 2048 }, "display": { "type": "string", "minLength": 1, "maxLength": 2048 }, "platform": { "enum": ["posix", "windows"] } }, "required": ["argv", "posix", "windows", "display", "platform"], "additionalProperties": false } }, "terminal.create": { "x-alp": { "effect": "mutation", "scope": { "kind": "project" }, "capability": "terminal", "idempotent": false, "risks": ["starts a shell on the daemon host as the daemon's account: host-level execution, not confined to the workspace"] }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "requestId": { "type": "string", "minLength": 1, "maxLength": 128 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." }, "protectionAcknowledgment": { "const": "linux-root-only-v1", "description": "Deprecated and ignored: accepted for compatibility with older clients. Reduced-protection terminals open without it; clients disclose the terminal's protection field instead." } }, "required": ["workspaceId", "cols", "rows", "requestId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminal": { "$ref": "#/$defs/terminal" } }, "required": ["terminal"], "additionalProperties": false } }, "terminal.list": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "terminal", "idempotent": true }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminals": { "type": "array", "items": { "$ref": "#/$defs/terminal" } } }, "required": ["terminals"], "additionalProperties": false } }, "terminal.attach": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": true, "risks": ["streams the terminal's output, which may show anything the shell printed"] }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "after": { "type": "integer", "minimum": 0 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." }, "protectionAcknowledgment": { "const": "linux-root-only-v1", "description": "Deprecated and ignored: accepted for compatibility with older clients. Reduced-protection terminals open without it; clients disclose the terminal's protection field instead." } }, "required": ["terminalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminal": { "$ref": "#/$defs/terminal" }, "nextSeq": { "type": "integer", "minimum": 1 }, "gap": { "type": "object", "properties": { "fromSeq": { "type": "integer", "minimum": 1 }, "toSeq": { "type": "integer", "minimum": 1 } }, "required": ["fromSeq", "toSeq"], "additionalProperties": false } }, "required": ["terminal", "nextSeq"], "additionalProperties": false } }, "terminal.input": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": false, "risks": ["types into a host shell: runs any command as the daemon's account"] }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "data": { "type": "string", "minLength": 1, "maxLength": 65536 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId", "data"], "additionalProperties": false }, "result": { "type": "object", "properties": { "bytes": { "type": "integer", "minimum": 1 } }, "required": ["bytes"], "additionalProperties": false } }, "terminal.resize": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": true }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId", "cols", "rows"], "additionalProperties": false }, "result": { "type": "object", "properties": { "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 } }, "required": ["cols", "rows"], "additionalProperties": false } }, "terminal.close": { "x-alp": { "effect": "mutation", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal", "idempotent": false }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." } }, "required": ["terminalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "closed": { "const": true } }, "required": ["closed"], "additionalProperties": false } }, "terminal.revoke": { "x-alp": { "effect": "mutation", "scope": { "kind": "host" }, "capability": "terminal", "idempotent": true, "risks": ["kills every terminal of a principal; for a trusted gateway, never exposed"] }, "params": { "type": "object", "properties": { "principalId": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": ["principalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "closed": { "type": "integer", "minimum": 0 } }, "required": ["closed"], "additionalProperties": false } }, "terminal.capture": { "x-alp": { "effect": "query", "scope": { "kind": "terminal", "param": "terminalId" }, "capability": "terminal.capture", "idempotent": true, "risks": ["Reads terminal screen text, which may contain secrets the shell printed"] }, "params": { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." }, "start": { "type": "integer" }, "end": { "type": "integer" }, "stripAnsi": { "type": "boolean" } }, "required": ["terminalId"], "additionalProperties": false }, "result": { "type": "object", "properties": { "lines": { "type": "array", "maxItems": 1200, "items": { "type": "string" } }, "totalLines": { "type": "integer", "minimum": 0 } }, "required": ["lines", "totalLines"], "additionalProperties": false } }, "terminal.watch": { "x-alp": { "effect": "query", "scope": { "kind": "project" }, "capability": "terminal.watch", "idempotent": true, "description": "Connection-local read subscription management, like question.watch/session.attach; no host or terminal mutation." }, "params": { "type": "object", "properties": { "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Set by a trusted gateway on its own connection: the remote principal the request acts for. Absent: the local owner." }, "principalEpoch": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The grant epoch of principalId (a gateway credential scope). Absent: the local owner." }, "authorizedRoots": { "type": "array", "maxItems": 1024, "items": { "type": "string", "minLength": 1, "maxLength": 4096 }, "description": "Set by a trusted gateway: the canonical workspaces the principal may use now; the terminal's workspace must be one of them." }, "after": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, "required": [], "additionalProperties": false }, "result": { "type": "object", "properties": { "terminals": { "type": "array", "items": { "$ref": "#/$defs/terminal" } }, "watchId": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "cursor": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "reset": { "type": "boolean" } }, "required": ["terminals", "watchId", "cursor", "reset"], "additionalProperties": false } }, "terminal.unwatch": { "x-alp": { "effect": "query", "scope": { "kind": "connection" }, "capability": "terminal.watch", "idempotent": true, "description": "Connection-local read subscription management, like question.watch/session.attach; no host or terminal mutation." }, "params": { "type": "object", "properties": {}, "additionalProperties": false }, "result": { "type": "object", "properties": { "closed": { "const": true } }, "required": ["closed"], "additionalProperties": false } } }, "$defs": { "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": {} }, "required": ["code", "message"], "additionalProperties": true }, "session": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "promptImages": { "type": "boolean" }, "promptAttachments": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["file.path", "document.native", "text.extract"] } }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy"], "additionalProperties": true }, "usage": { "type": "object", "properties": { "contextWindowUsedTokens": { "type": "integer", "minimum": 0 }, "contextWindowMaxTokens": { "type": "integer", "minimum": 1 }, "inputTokens": { "type": "integer", "minimum": 0 }, "cachedInputTokens": { "type": "integer", "minimum": 0 }, "outputTokens": { "type": "integer", "minimum": 0 }, "totalCostUsd": { "type": "number", "minimum": 0 } }, "additionalProperties": true }, "assignment": { "type": "object", "properties": { "id": { "type": "string" }, "agent": { "type": "string" }, "mode": { "type": "string" }, "status": { "type": "string" }, "startedAt": { "type": "string" }, "worktree": { "type": "object", "properties": { "branch": { "type": "string" }, "path": { "type": "string" } }, "required": ["branch", "path"], "additionalProperties": true } }, "required": ["id", "agent", "mode", "status", "startedAt"], "additionalProperties": true }, "mail": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "enum": ["question", "answer", "note", "steer", "result", "stalled", "board", "checkin"] }, "from": { "type": "string" }, "assignment": { "type": "string" }, "body": { "type": "string" }, "replyTo": { "type": "string" }, "result": { "type": "object" }, "redelivered": { "type": "boolean" } }, "required": ["id", "kind", "from", "assignment"], "additionalProperties": true }, "pin": { "type": "object", "properties": { "id": { "type": "string" }, "project": { "type": "string" }, "kind": { "enum": ["claim", "decision", "finding"] }, "body": { "type": "string" }, "paths": { "type": "array", "items": { "type": "string" } }, "agent": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "at": { "type": "string" }, "released": { "type": "string" }, "task": { "type": "string" } }, "required": ["id", "project", "kind", "body", "agent", "sessionId", "rootId", "at"], "additionalProperties": true }, "question": { "type": "object", "properties": { "id": { "type": "string" }, "sessionId": { "type": "string" }, "rootId": { "type": "string" }, "agent": { "type": "string" }, "body": { "type": "string" }, "options": { "type": "array", "items": { "type": "string" } }, "askedAt": { "type": "string" }, "gate": { "type": "object", "properties": { "projectRoot": { "type": "string" }, "taskId": { "type": "string" }, "gateId": { "type": "string" } }, "required": ["projectRoot", "taskId", "gateId"], "additionalProperties": true } }, "required": ["id", "sessionId", "rootId", "agent", "body", "askedAt"], "additionalProperties": true }, "attention": { "type": "object", "properties": { "reason": { "enum": ["finished", "error"] }, "at": { "type": "string" }, "turnId": { "type": "string" }, "message": { "type": "string" } }, "required": ["reason", "at"], "additionalProperties": true }, "spec": { "type": "object", "properties": { "cwd": { "type": "string" }, "agent": { "type": "string" }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "persist": { "type": "boolean" }, "restore": { "type": "object" } }, "required": ["cwd"], "additionalProperties": true }, "item": { "anyOf": [{ "$ref": "#/$defs/knownItem" }, { "$ref": "#/$defs/unknownItem" }] }, "event": { "anyOf": [{ "$ref": "#/$defs/knownEvent" }, { "$ref": "#/$defs/unknownEvent" }] }, "envelope": { "type": "object", "properties": { "sessionId": { "type": "string" }, "epoch": { "type": "string" }, "seq": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ts": { "type": "string" }, "event": { "$ref": "#/$defs/event" }, "cursor": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": ["sessionId", "epoch", "seq", "ts", "event"], "additionalProperties": true }, "request": { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }] }, "method": { "type": "string" }, "params": { "type": "object" } }, "required": ["jsonrpc", "method", "id"], "additionalProperties": true }, "response": { "oneOf": [{ "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "result": {} }, "required": ["jsonrpc", "id", "result"], "additionalProperties": true }, { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "id": { "anyOf": [{ "type": "string", "maxLength": 128 }, { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" }] }, "error": { "$ref": "#/$defs/error" } }, "required": ["jsonrpc", "id", "error"], "additionalProperties": true }] }, "notification": { "oneOf": [{ "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "event" }, "params": { "$ref": "#/$defs/envelope" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }, { "type": "object", "description": "A terminal's output, exit or detach (capability terminal, \xA712.10).", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "terminal.event" }, "params": { "$ref": "#/$defs/terminalEvent" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }, { "type": "object", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "terminal.changed" }, "params": { "$ref": "#/$defs/terminalChanged" } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }, { "type": "object", "description": "The live model catalog changed (capability catalog.live): re-read catalog.get.", "properties": { "jsonrpc": { "const": "2.0" }, "method": { "const": "catalog.updated" }, "params": { "type": "object", "properties": { "fetchedAt": { "type": "string" } }, "additionalProperties": true } }, "required": ["jsonrpc", "method", "params"], "additionalProperties": true }] }, "knownEvent": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "session.opened" }, "session": { "$ref": "#/$defs/session" }, "cwd": { "type": "string" }, "effective": { "type": "object", "properties": { "model": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["model", "thinking"], "additionalProperties": true } }, "required": ["type", "session", "cwd", "effective"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.ready" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.updated" }, "session": { "$ref": "#/$defs/session" } }, "required": ["type", "session"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.closed" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "session.failed" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.accepted" }, "clientMessageId": { "type": "string" }, "result": { "enum": ["turn", "steer"] }, "turnId": { "type": "string" } }, "required": ["type", "clientMessageId", "result", "turnId"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "prompt.failed" }, "clientMessageId": { "type": "string" }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "clientMessageId", "error"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.started" }, "turnId": { "type": "string" }, "origin": { "enum": ["user", "wake", "assignment", "runtime"] } }, "required": ["type", "turnId", "origin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "turn.ended" }, "turnId": { "type": "string" }, "state": { "enum": ["completed", "failed", "canceled"] }, "error": { "$ref": "#/$defs/alpError" } }, "required": ["type", "turnId", "state"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "item" }, "item": { "$ref": "#/$defs/item" } }, "required": ["type", "item"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "usage" }, "usage": { "$ref": "#/$defs/usage" } }, "required": ["type", "usage"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "mail" }, "mail": { "$ref": "#/$defs/mail" } }, "required": ["type", "mail"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "assignment" }, "assignment": { "$ref": "#/$defs/assignment" } }, "required": ["type", "assignment"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question" }, "question": { "$ref": "#/$defs/question" } }, "required": ["type", "question"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "question.resolved" }, "questionId": { "type": "string" }, "outcome": { "enum": ["answered", "dismissed", "timeout", "canceled"] }, "answer": { "type": "string" } }, "required": ["type", "questionId", "outcome"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "pin" }, "pin": { "$ref": "#/$defs/pin" } }, "required": ["type", "pin"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unpin" }, "pinId": { "type": "string" }, "reason": { "enum": ["unpinned", "session_ended"] } }, "required": ["type", "pinId", "reason"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "attention" }, "attention": { "$ref": "#/$defs/attention" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "history.reset" }, "generation": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "reason": { "const": "rewind" }, "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" } }, "required": ["type", "generation", "reason", "branchId"], "additionalProperties": true }] }, "unknownEvent": { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["session.opened", "session.ready", "session.updated", "session.closed", "session.failed", "prompt.accepted", "prompt.failed", "turn.started", "turn.ended", "item", "usage", "mail", "assignment", "question", "question.resolved", "pin", "unpin", "attention", "history.reset"] } } }, "required": ["type"], "additionalProperties": true }, "knownItem": { "oneOf": [{ "type": "object", "properties": { "kind": { "const": "user_message" }, "id": { "type": "string" }, "text": { "type": "string" }, "clientMessageId": { "type": "string" }, "images": { "type": "integer", "minimum": 1 }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "name": { "type": "string" }, "mimeType": { "type": "string" }, "size": { "type": "integer", "minimum": 0 } }, "required": ["attachmentId", "name", "mimeType", "size"], "additionalProperties": false } }, "origin": { "enum": ["user", "wake", "assignment", "runtime"] } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "assistant_message" }, "id": { "type": "string" }, "text": { "type": "string" } }, "required": ["kind", "id", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "notice" }, "id": { "type": "string" }, "level": { "enum": ["info", "warning", "error"] }, "text": { "type": "string" } }, "required": ["kind", "id", "level", "text"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "compaction" }, "id": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "trigger": { "type": "string" }, "preTokens": { "type": "integer" }, "postTokens": { "type": "integer" } }, "required": ["kind", "id", "status"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "todo" }, "id": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "status": { "enum": ["pending", "in_progress", "completed"] } }, "required": ["id", "text", "status"], "additionalProperties": true } } }, "required": ["kind", "id", "items"], "additionalProperties": true }, { "type": "object", "properties": { "kind": { "const": "tool_call" }, "id": { "type": "string" }, "callId": { "type": "string" }, "name": { "type": "string" }, "status": { "enum": ["running", "completed", "failed"] }, "error": { "type": "string" }, "detail": { "$ref": "#/$defs/toolCallDetail" } }, "required": ["kind", "id", "callId", "name", "status", "detail"], "additionalProperties": true }] }, "unknownItem": { "type": "object", "properties": { "kind": { "type": "string", "not": { "enum": ["user_message", "assistant_message", "notice", "compaction", "todo", "tool_call"] } }, "id": { "type": "string" } }, "required": ["kind", "id"], "additionalProperties": true }, "toolCallDetail": { "oneOf": [{ "type": "object", "properties": { "type": { "const": "shell" }, "command": { "type": "string" }, "cwd": { "type": "string" }, "output": { "type": "string" }, "exitCode": { "type": ["integer", "null"] } }, "required": ["type", "command", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "read" }, "filePath": { "type": "string" }, "content": { "type": "string" }, "offset": { "type": "integer" }, "limit": { "type": "integer" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "edit" }, "filePath": { "type": "string" }, "oldString": { "type": "string" }, "newString": { "type": "string" }, "unifiedDiff": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "write" }, "filePath": { "type": "string" }, "content": { "type": "string" } }, "required": ["type", "filePath"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "search" }, "query": { "type": "string" }, "toolName": { "enum": ["search", "grep", "glob", "web_search"] }, "content": { "type": "string" }, "filePaths": { "type": "array", "items": { "type": "string" } }, "webResults": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "url": { "type": "string" } }, "required": ["title", "url"], "additionalProperties": true } }, "numFiles": { "type": "integer" }, "numMatches": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": ["type", "query"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "fetch" }, "url": { "type": "string" }, "prompt": { "type": "string" }, "result": { "type": "string" }, "code": { "type": "integer" } }, "required": ["type", "url"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "sub_agent" }, "subAgentType": { "type": "string" }, "description": { "type": "string" }, "log": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plan" }, "text": { "type": "string" } }, "required": ["type", "text"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "plain_text" }, "label": { "type": "string" }, "text": { "type": "string" } }, "required": ["type"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "const": "unknown" }, "input": {}, "output": {} }, "required": ["type", "input", "output"], "additionalProperties": true }, { "type": "object", "properties": { "type": { "type": "string", "not": { "enum": ["shell", "read", "edit", "write", "search", "fetch", "sub_agent", "plan", "plain_text", "unknown"] } } }, "required": ["type"], "additionalProperties": true }] }, "alpError": { "type": "object", "properties": { "message": { "type": "string" }, "code": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "sessionSummary": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "status": { "enum": ["initializing", "idle", "running", "error", "closed"] }, "title": { "type": "string" }, "archived": { "type": "boolean" }, "attention": { "$ref": "#/$defs/attention" }, "lastError": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "conversation": { "type": "object", "properties": { "fork": { "type": "boolean" }, "rewind": { "type": "boolean" }, "reload": { "type": "boolean", "description": "Whether session.reload can restart this root's native process (\xA712.8); the root must also be open and idle." }, "reason": { "enum": ["runtime_unsupported", "not_persistent", "not_root"] }, "configure": { "type": "boolean", "description": "Whether session.configure can change this root's model, effort or team (\xA712.9); the root must also be open and idle." } }, "required": ["fork", "rewind"], "additionalProperties": true }, "forkedFrom": { "$ref": "#/$defs/forkProvenance" }, "branches": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/conversationBranch" } }, "promptAttachments": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["file.path", "document.native", "text.extract"] } } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "status"], "additionalProperties": true }, "pause": { "type": "object", "properties": { "since": { "type": "string" }, "by": { "type": "string" }, "reason": { "type": "string" }, "resetsAt": { "type": "string" }, "checkedAt": { "type": "string" } }, "required": ["since", "by", "reason"], "additionalProperties": true }, "pauseState": { "type": "object", "properties": { "all": { "$ref": "#/$defs/pause" }, "runtimes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/pause" } }, "parked": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "type": "string" }, "rootId": { "type": "string" }, "reason": { "type": "string" }, "since": { "type": "string" } }, "required": ["assignmentId", "agent", "runtime", "rootId", "reason", "since"], "additionalProperties": true } } }, "required": ["runtimes", "parked"], "additionalProperties": true }, "preview": { "type": "object", "properties": { "teams": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "label"], "additionalProperties": true } }, "team": { "type": "string" }, "teamLabel": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" } }, "required": ["teams", "team", "agent", "runtime", "model", "mode", "thinking"], "additionalProperties": true }, "treeStatus": { "type": "object", "properties": { "rootId": { "type": "string" }, "sessions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "projectRoot": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "mode": { "type": "string" }, "thinking": { "type": "string" }, "workflow": { "type": "object", "properties": { "mode": { "type": "string" }, "maxPeers": { "type": "integer" }, "supervisor": { "type": "boolean" } }, "required": ["mode", "maxPeers", "supervisor"], "additionalProperties": true }, "threadId": { "type": "string" }, "persistent": { "type": "boolean" }, "busy": { "type": "boolean" }, "parentId": { "type": "string" }, "toolCallId": { "type": "string" }, "activeTurnId": { "type": "string" }, "parked": { "type": "string" }, "instructionsSha": { "type": "string" }, "teamLabel": { "type": "string" }, "state": { "enum": ["running", "waiting", "waiting_parent", "waiting_user", "idle"] }, "idleMs": { "type": "number" }, "workdir": { "type": "string" }, "unreadMail": { "type": "integer", "minimum": 0 } }, "required": ["id", "projectRoot", "agent", "runtime", "model", "mode", "thinking", "workflow", "threadId", "persistent", "busy", "state", "idleMs", "workdir", "unreadMail"], "additionalProperties": true } }, "assignments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "requester": { "type": "string" }, "isolation": { "enum": ["shared", "worktree"] }, "idleMs": { "type": "number" } }, "required": ["id", "requester", "isolation", "idleMs"], "additionalProperties": true } }, "questions": { "type": "array", "items": { "$ref": "#/$defs/question" } }, "worktrees": { "type": "array", "items": { "type": "object", "properties": { "assignmentId": { "type": "string" }, "requester": { "type": "string" }, "agent": { "type": "string" }, "branch": { "type": "string" }, "files": { "type": "array", "items": { "type": "string" } }, "stat": { "type": "string" } }, "required": ["assignmentId", "requester", "agent", "branch", "files", "stat"], "additionalProperties": true } }, "leases": { "type": "array", "items": { "type": "object", "properties": { "checkout": { "type": "string" }, "assignmentId": { "type": "string" }, "agent": { "type": "string" } }, "required": ["checkout", "assignmentId", "agent"], "additionalProperties": true } }, "claims": { "type": "array", "items": { "$ref": "#/$defs/pin" } } }, "required": ["rootId", "sessions", "assignments", "questions", "worktrees", "leases", "claims"], "additionalProperties": true }, "health": { "type": "object", "properties": { "live": { "type": "boolean" }, "ready": { "type": "boolean" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "ok": { "type": "boolean" }, "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["id", "ok"], "additionalProperties": true } } }, "required": ["live", "ready", "checks"], "additionalProperties": true }, "projectRoot": { "type": "string", "minLength": 1, "maxLength": 4096, "description": "An absolute, normalized path on the daemon host to a directory holding .alp/. Compared as is: the daemon never walks up to a parent." }, "taskId": { "type": "string", "pattern": "^t-[0-9a-f]{4,12}(?:\\.\\d+)*$" }, "taskRow": { "type": "object", "properties": { "id": { "$ref": "#/$defs/taskId" }, "title": { "type": "string" }, "type": { "type": "string" }, "priority": { "type": "integer" }, "status": { "enum": ["open", "in_progress", "review", "closed"] }, "rev": { "type": "integer", "minimum": 0 }, "parent": { "type": "string" }, "assignee": { "type": "string" }, "ready": { "type": "boolean" }, "blockedBy": { "type": "array", "items": { "type": "string" } }, "waits": { "type": "array", "items": { "type": "string" } }, "approvals": { "type": "array", "items": { "type": "object", "properties": { "gate": { "type": "string" }, "note": { "type": "string" } }, "required": ["gate", "note"], "additionalProperties": true } }, "handoff": { "type": "object", "properties": { "outcome": { "type": "string" }, "summary": { "type": "string" }, "agent": { "type": "string" } }, "required": ["outcome", "summary"], "additionalProperties": true }, "closed": { "type": "object", "properties": { "reason": { "type": "string" }, "summary": { "type": "string" }, "at": { "type": "string" } }, "required": ["reason", "at"], "additionalProperties": true }, "description": { "type": "string" }, "labels": { "type": "array", "items": { "type": "string" } }, "paths": { "type": "array", "items": { "type": "string" } }, "progress": { "type": "object", "properties": { "done": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": ["done", "total"], "additionalProperties": true }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": ["id", "title", "type", "priority", "status", "rev", "ready", "updatedAt"], "additionalProperties": true }, "libraryKind": { "enum": ["agents", "skills", "mcp", "hooks", "teams", "providers"] }, "libraryScope": { "enum": ["library", "project"] }, "librarySource": { "enum": ["builtin", "library", "project"] }, "entryName": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.-]+$", "not": { "enum": [".", ".."] } }, "libraryRevision": { "type": ["string", "null"] }, "libraryEntryRow": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "description": { "type": "string" }, "usedBy": { "type": "array", "items": { "type": "string" } } }, "required": ["name", "source"], "additionalProperties": true }, "secretMarker": { "type": "object", "properties": { "$secret": { "const": "keep" } }, "required": ["$secret"], "additionalProperties": false, "description": "Stands for a stored secret value: read results carry it in place of the value; a save that sends it back keeps the stored value." }, "languageSetting": { "type": "object", "properties": { "language": { "type": ["string", "null"] }, "applies": { "type": "string" }, "default": { "type": "string" } }, "required": ["language", "applies", "default"], "additionalProperties": true }, "teamRow": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "source": { "$ref": "#/$defs/librarySource" }, "overrides": { "$ref": "#/$defs/librarySource" }, "error": { "type": "string" } }, "required": ["id", "source"], "additionalProperties": true }, "promptImage": { "type": "object", "properties": { "type": { "const": "image" }, "mimeType": { "enum": ["image/png", "image/jpeg", "image/gif", "image/webp"] }, "data": { "type": "string", "minLength": 4, "maxLength": 6990508, "pattern": "^[A-Za-z0-9+/]+={0,2}$" }, "name": { "type": "string", "maxLength": 255 } }, "required": ["type", "mimeType", "data"], "additionalProperties": false }, "scheduleId": { "type": "string", "pattern": "^sch_[0-9a-f]{16}$" }, "scheduleError": { "type": "object", "properties": { "message": { "type": "string" }, "code": { "type": "string" } }, "required": ["message"], "additionalProperties": true }, "scheduleJob": { "type": "object", "properties": { "id": { "$ref": "#/$defs/scheduleId" }, "projectRoot": { "$ref": "#/$defs/projectRoot" }, "sessionId": { "type": "string" }, "prompt": { "type": "string" }, "dueAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$" }, "status": { "enum": ["pending", "delivered", "failed", "cancelled"] }, "attempts": { "type": "integer", "minimum": 0 }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "deliveredAt": { "type": "string" }, "failedAt": { "type": "string" }, "cancelledAt": { "type": "string" }, "attemptedAt": { "type": "string" }, "lateByMs": { "type": "integer", "minimum": 0 }, "lastError": { "$ref": "#/$defs/scheduleError" } }, "required": ["id", "projectRoot", "sessionId", "prompt", "dueAt", "status", "attempts", "createdAt", "updatedAt"], "additionalProperties": true }, "registryProject": { "type": "object", "properties": { "id": { "type": "string" }, "root": { "type": "string" }, "customName": { "type": ["string", "null"] }, "addedAt": { "type": "string" }, "removedAt": { "type": ["string", "null"] }, "revision": { "type": "integer", "minimum": 0 }, "canonical": { "type": "string" } }, "required": ["id", "root", "addedAt"], "additionalProperties": false }, "registryWorkspace": { "type": "object", "properties": { "id": { "type": "string" }, "projectId": { "type": "string" }, "directory": { "type": "string" }, "title": { "type": ["string", "null"] }, "pinnedAt": { "type": ["string", "null"] }, "archivedAt": { "type": ["string", "null"] }, "labels": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string" }, "revision": { "type": "integer", "minimum": 0 }, "canonical": { "type": "string" }, "idempotencyKey": { "type": "string" }, "branch": { "type": ["string", "null"] }, "managedWorktree": { "type": "boolean" } }, "required": ["id", "projectId", "directory", "labels", "createdAt"], "additionalProperties": false }, "attachment": { "type": "object", "description": "A committed attachment as clients see it: ids, display metadata and its digest, never a host path or URL.", "properties": { "attachmentId": { "type": "string", "pattern": "^att_[0-9a-f]{32}$" }, "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "mimeType": { "type": "string", "minLength": 3, "maxLength": 255 }, "detectedMimeType": { "type": "string", "minLength": 3, "maxLength": 255 }, "size": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "createdAt": { "type": "string" }, "committedAt": { "type": "string" }, "referenced": { "type": "boolean" } }, "required": ["attachmentId", "sessionId", "name", "mimeType", "detectedMimeType", "size", "sha256", "createdAt", "committedAt", "referenced"], "additionalProperties": false }, "forkProvenance": { "type": "object", "description": "Where a fork came from (\xA712.7): the source root, and the turn its conversation was cut at.", "properties": { "sessionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "turnId": { "type": "string", "minLength": 1, "maxLength": 200 }, "boundary": { "enum": ["through", "before", "whole"] }, "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" }, "at": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": ["sessionId", "boundary", "at"], "additionalProperties": true }, "conversationBranch": { "type": "object", "description": "Later turns a rewind set aside (\xA712.7): kept, never deleted, recoverable as a new session with session.fork { branchId }.", "properties": { "branchId": { "type": "string", "pattern": "^br_[0-9a-f]{16}$" }, "beforeTurnId": { "type": "string", "minLength": 1, "maxLength": 200 }, "turns": { "type": "integer", "minimum": 0 }, "at": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": ["branchId", "beforeTurnId", "turns", "at"], "additionalProperties": true }, "effectiveConfig": { "type": "object", "description": "The configuration a root runs with, or would after a change, as alpd resolved it (\xA712.9).", "properties": { "team": { "type": "string" }, "teamLabel": { "type": "string" }, "agent": { "type": "string" }, "runtime": { "enum": ["claude", "codex", "acp", "antigravity"] }, "model": { "type": "string" }, "thinking": { "type": "string" }, "mode": { "type": "string" }, "permissionProfile": { "type": "string", "description": "The permission profile capping the agent's mode, when one does." }, "supervisor": { "type": "boolean" }, "maxPeers": { "type": "integer" }, "delegates": { "type": "array", "items": { "type": "string" }, "description": "Agents the root may delegate to." }, "tools": { "type": "array", "items": { "type": "string" }, "description": "ALP tools the root's agent is given." }, "mcpServers": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "kind": { "enum": ["stdio", "http"] } }, "required": ["name", "kind"], "additionalProperties": true } }, "hooks": { "type": "integer", "minimum": 0, "description": "How many hook commands the agent runs." }, "instructionsSha": { "type": "string" } }, "required": ["team", "agent", "runtime", "model", "thinking", "mode", "supervisor", "delegates", "tools", "mcpServers", "hooks"], "additionalProperties": true }, "configurePreview": { "type": "object", "properties": { "current": { "$ref": "#/$defs/effectiveConfig" }, "proposed": { "$ref": "#/$defs/effectiveConfig" }, "changes": { "type": "array", "items": { "enum": ["model", "thinking", "team", "mode"] } }, "restart": { "type": "boolean", "description": "Whether applying it restarts the root's native process (on its own conversation)." }, "allowed": { "type": "boolean", "description": "Whether session.configure would take it now; a busy tree may still refuse it later." }, "reason": { "enum": ["session_busy", "session_closed", "not_root", "runtime_unsupported", "runtime_mismatch", "agent_mismatch", "permission_escalation", "team_not_found", "invalid_params", "not_persistent"] }, "message": { "type": "string" }, "teams": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["id", "label"], "additionalProperties": true } } }, "required": ["current", "proposed", "changes", "restart", "allowed", "teams"], "additionalProperties": true }, "configureOutcome": { "type": "object", "properties": { "status": { "enum": ["applied", "unchanged"] }, "requested": { "type": "object", "properties": { "model": { "type": "string" }, "thinking": { "type": "string" }, "team": { "type": "string" }, "mode": { "type": "string" } }, "additionalProperties": false }, "effective": { "$ref": "#/$defs/effectiveConfig" }, "restarted": { "type": "boolean" } }, "required": ["status", "requested", "effective", "restarted"], "additionalProperties": true }, "terminal": { "type": "object", "description": "A terminal as clients see it: ids, size and state, never a process id, shell path or host path.", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "workspaceId": { "type": "string", "minLength": 1, "maxLength": 200 }, "title": { "type": "string", "maxLength": 64 }, "cols": { "type": "integer", "minimum": 2, "maximum": 500 }, "rows": { "type": "integer", "minimum": 1, "maximum": 200 }, "state": { "enum": ["running", "exited"] }, "attached": { "type": "boolean" }, "createdAt": { "type": "string", "format": "date-time" }, "lastActivityAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "exitCode": { "type": ["integer", "null"] }, "signal": { "type": ["integer", "null"] }, "endReason": { "enum": ["exited", "closed", "idle", "lifetime", "detached", "revoked", "disabled", "shutdown"] }, "protection": { "enum": ["root-only", "none"], "description": "Absent: full native process protection (macOS, supported Linux). root-only: best-effort Linux; closing ends the shell, but processes it started may keep running. none: Windows platform PTY (ConPTY); cleanup is best-effort and not guaranteed. Clients show a non-blocking notice." } }, "required": ["terminalId", "workspaceId", "title", "cols", "rows", "state", "attached", "createdAt", "lastActivityAt", "expiresAt"], "additionalProperties": false }, "terminalEvent": { "description": "params of a terminal.event notification (\xA712.10): sent only to the connection attached to the terminal.", "oneOf": [{ "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "type": { "const": "output" }, "seq": { "type": "integer", "minimum": 1 }, "data": { "type": "string", "minLength": 1, "maxLength": 65536 } }, "required": ["terminalId", "type", "seq", "data"], "additionalProperties": false }, { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "type": { "const": "exit" }, "seq": { "type": "integer", "minimum": 1 }, "exitCode": { "type": ["integer", "null"] }, "signal": { "type": ["integer", "null"] }, "reason": { "enum": ["exited", "closed", "idle", "lifetime", "detached", "revoked", "disabled", "shutdown"] } }, "required": ["terminalId", "type", "seq", "exitCode", "signal", "reason"], "additionalProperties": false }, { "type": "object", "properties": { "terminalId": { "type": "string", "pattern": "^term_[0-9a-f]{32}$" }, "type": { "const": "detached" }, "reason": { "enum": ["replaced", "slow_consumer"] } }, "required": ["terminalId", "type", "reason"], "additionalProperties": false }] }, "terminalChanged": { "type": "object", "properties": { "watchId": { "type": "string", "pattern": "^[0-9a-f]{32}$" }, "cursor": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, "required": ["watchId", "cursor"], "additionalProperties": false } } };
|
|
5453
5788
|
|
|
5454
5789
|
// packages/protocol/src/validate.js
|
|
5455
5790
|
var MAX_ISSUES = 8;
|
|
@@ -5617,7 +5952,7 @@ var TERMINAL_EXEC_WARNING = `Warning: this credential holds terminal.exec. Whoev
|
|
|
5617
5952
|
daemon host as the account that runs alpd (its files, programs and network), in any granted workspace;
|
|
5618
5953
|
a workspace is NOT a sandbox. Terminals open only while the host owner allows them (alp terminal allow).`;
|
|
5619
5954
|
var DEFAULT_PERMISSIONS = Object.freeze(["session.read", "session.write", "project.read", "project.write"]);
|
|
5620
|
-
var FORWARDED_CAPABILITIES = Object.freeze([CAPABILITY.sessionInterruptTurn, CAPABILITY.workspaceRegistry, CAPABILITY.workspaceWorktree, CAPABILITY.sessionHistory, CAPABILITY.attachAfter, CAPABILITY.promptReceipts, CAPABILITY.task, CAPABILITY.team, CAPABILITY.library, CAPABILITY.libraryProjectWrite, CAPABILITY.settingsLanguage, CAPABILITY.sessionListPage, CAPABILITY.questionWatch, CAPABILITY.questionWatchTurns, CAPABILITY.sessionAttention, CAPABILITY.workspaceFiles, CAPABILITY.workspaceFilesRead, CAPABILITY.promptImages, CAPABILITY.workspaceGit, CAPABILITY.attachments, CAPABILITY.sessionFork, CAPABILITY.sessionRewind, CAPABILITY.sessionReload, CAPABILITY.sessionResumeCommand, CAPABILITY.sessionConfigureLive, CAPABILITY.terminal]);
|
|
5955
|
+
var FORWARDED_CAPABILITIES = Object.freeze([CAPABILITY.sessionInterruptTurn, CAPABILITY.workspaceRegistry, CAPABILITY.workspaceWorktree, CAPABILITY.sessionHistory, CAPABILITY.attachAfter, CAPABILITY.promptReceipts, CAPABILITY.task, CAPABILITY.team, CAPABILITY.library, CAPABILITY.libraryProjectWrite, CAPABILITY.settingsLanguage, CAPABILITY.sessionListPage, CAPABILITY.questionWatch, CAPABILITY.questionWatchTurns, CAPABILITY.sessionAttention, CAPABILITY.workspaceFiles, CAPABILITY.workspaceFilesRead, CAPABILITY.promptImages, CAPABILITY.workspaceGit, CAPABILITY.attachments, CAPABILITY.sessionFork, CAPABILITY.sessionRewind, CAPABILITY.sessionReload, CAPABILITY.sessionResumeCommand, CAPABILITY.sessionConfigureLive, CAPABILITY.terminal, CAPABILITY.terminalCapture, CAPABILITY.terminalWatch]);
|
|
5621
5956
|
var GATEWAY_ERROR = Object.freeze({ forbidden: ERROR.forbidden, unavailable: ERROR.unavailable });
|
|
5622
5957
|
var GATEWAY_REASON = Object.freeze({
|
|
5623
5958
|
notExposed: "not_exposed",
|
|
@@ -5709,6 +6044,10 @@ function projectTerminal(raw) {
|
|
|
5709
6044
|
if (!TERMINAL_END.has(raw.endReason)) return void 0;
|
|
5710
6045
|
terminal.endReason = raw.endReason;
|
|
5711
6046
|
}
|
|
6047
|
+
if (raw.protection !== void 0) {
|
|
6048
|
+
if (raw.protection !== "root-only" && raw.protection !== "none") return void 0;
|
|
6049
|
+
terminal.protection = raw.protection;
|
|
6050
|
+
}
|
|
5712
6051
|
return (
|
|
5713
6052
|
/** @type {import('@anhlp/alp-protocol').TerminalInfo} */
|
|
5714
6053
|
/** @type {unknown} */
|
|
@@ -5732,6 +6071,8 @@ function projectTerminalEvent(raw, maxOutputFrameBytes) {
|
|
|
5732
6071
|
return void 0;
|
|
5733
6072
|
}
|
|
5734
6073
|
var TERMINAL_REFUSALS = Object.freeze({
|
|
6074
|
+
terminal_capture_unavailable: "Terminal capture exceeded its resource limit or its screen was released",
|
|
6075
|
+
terminal_capture_too_large: "Terminal capture is too large; select a smaller line range",
|
|
5735
6076
|
not_found: "No such terminal",
|
|
5736
6077
|
terminal_disabled: "The daemon host has not allowed remote terminals (its owner runs alp terminal allow)",
|
|
5737
6078
|
terminal_unsupported: "Terminals are not available on the daemon host",
|
|
@@ -6068,7 +6409,8 @@ function isModelId(value) {
|
|
|
6068
6409
|
}
|
|
6069
6410
|
var EXPOSURE = Object.freeze({
|
|
6070
6411
|
"daemon.hello": { status: "gateway", scope: "connection", reason: "Answered by the gateway after its own hello to alpd: capabilities are alpd's intersected with FORWARDED_CAPABILITIES; alpd's hostname when hostLabel accepts it; no pid.", tests: ["handshake"] },
|
|
6071
|
-
"catalog.get": { status: "exposed", permission: "session.read", scope: "none: the
|
|
6412
|
+
"catalog.get": { status: "exposed", permission: "session.read", scope: "none: the model and mode catalogue (live provider lists merged over static rows, t-e5ee)", params: [], tests: ["permission"] },
|
|
6413
|
+
"catalog.refresh": { status: "denied", scope: "host: runs each provider CLI on the daemon host to list its models", reason: "Starts provider processes on the host; remote clients read the catalog alpd refreshes on start, every 6 h and from turns (catalog.get), and the gateway forwards no catalog.updated." },
|
|
6072
6414
|
"session.list": { status: "exposed", permission: "session.read", scope: "result: sessions whose tree lies in a granted workspace; projectRoot must name one; with limit, alpd pages are read until the filtered page is full", params: ["projectRoot", "rootsOnly", "includeClosed", "includeArchived", "limit", "cursor", "query"], tests: ["permission", "workspace-param", "result-filter", "paging"] },
|
|
6073
6415
|
"session.get": { status: "exposed", permission: "session.read", scope: "session: its tree's root and itself in a granted workspace", params: ["sessionId"], tests: ["permission", "session-scope"] },
|
|
6074
6416
|
"session.status": { status: "exposed", permission: "session.read", scope: "session; the answer must be the checked root's tree with every session in a granted workspace. Rows carry host paths of that tree (workdir, lease checkouts)", params: ["sessionId"], tests: ["permission", "session-scope", "tree-scope"] },
|
|
@@ -6096,9 +6438,12 @@ var EXPOSURE = Object.freeze({
|
|
|
6096
6438
|
"session.prompt": { status: "exposed", permission: "session.write", scope: "session; text, inline images within GATEWAY_PROMPT_IMAGES, and attachments by attachmentId alone (attachments.write as well; alpd resolves them for this principal, grant epoch, an authorized project and this session, and refuses them 1005 attachment_unsupported where the runtime cannot read them); drives: the modes of the session and every ancestor, looked up afresh, within the grant's modes", capability: CAPABILITY.promptReceipts, params: ["sessionId", "clientMessageId", "delivery", "content"], tests: ["permission", "session-scope", "content", "mode", "binding"] },
|
|
6097
6439
|
// Terminals (§5.18, docs/protocol/alp-json-rpc-v1.md §12.10): a real shell as the daemon's account,
|
|
6098
6440
|
// only with the opt-in terminal.exec and the host owner's own switch; a workspace is not a sandbox.
|
|
6099
|
-
"terminal.create": { status: "exposed", permission: "terminal.exec", scope: "workspace: workspaceId a registry workspace whose directory a grant names exactly, looked up afresh; alpd binds the terminal to this credential, its grant epoch and the grant's canonical workspaces (authorizedRoots), and picks the shell, its environment and directory itself (no shell, command, args, env, cwd or pid is a param); answer projected by projectTerminal", capability: CAPABILITY.terminal, params: ["workspaceId", "cols", "rows", "requestId"], tests: ["permission", "registry-scope", "binding"] },
|
|
6441
|
+
"terminal.create": { status: "exposed", permission: "terminal.exec", scope: "workspace: workspaceId a registry workspace whose directory a grant names exactly, looked up afresh; alpd binds the terminal to this credential, its grant epoch and the grant's canonical workspaces (authorizedRoots), and picks the shell, its environment and directory itself (no shell, command, args, env, cwd or pid is a param); answer projected by projectTerminal", capability: CAPABILITY.terminal, params: ["workspaceId", "cols", "rows", "requestId", "protectionAcknowledgment"], tests: ["permission", "registry-scope", "binding"] },
|
|
6100
6442
|
"terminal.list": { status: "exposed", permission: "terminal.exec", scope: "principal: only this credential's own terminals of its grant epoch and canonical workspaces (alpd filters); a workspaceId given is checked as for terminal.create", capability: CAPABILITY.terminal, params: ["workspaceId"], tests: ["permission", "binding"] },
|
|
6101
|
-
"terminal.
|
|
6443
|
+
"terminal.watch": { status: "exposed", permission: "terminal.exec", scope: "principal: atomic snapshot and cursor subscription, same credential epoch/authorized roots; optional registry workspace checked", capability: CAPABILITY.terminalWatch, params: ["workspaceId", "after"], tests: ["permission", "binding", "cursor"] },
|
|
6444
|
+
"terminal.unwatch": { status: "exposed", permission: "terminal.exec", scope: "connection: stops only this connection subscription", capability: CAPABILITY.terminalWatch, params: [], tests: ["permission"] },
|
|
6445
|
+
"terminal.capture": { status: "exposed", permission: "terminal.exec", scope: "terminal: same principal, epoch and authorized roots; bounded rendered text only, explicit frame refusal", capability: CAPABILITY.terminalCapture, params: ["terminalId", "start", "end", "stripAnsi"], tests: ["permission", "binding", "frame"] },
|
|
6446
|
+
"terminal.attach": { status: "exposed", permission: "terminal.exec", scope: "terminal: alpd checks the binding (credential, grant epoch, authorized workspace); terminal.event notifications of attached terminals only, re-checked and projected (projectTerminalEvent)", capability: CAPABILITY.terminal, params: ["terminalId", "after", "protectionAcknowledgment"], tests: ["permission", "binding"] },
|
|
6102
6447
|
"terminal.input": { status: "exposed", permission: "terminal.exec", scope: "terminal: as terminal.attach, from the connection that attached it; never logged", capability: CAPABILITY.terminal, params: ["terminalId", "data"], tests: ["permission", "binding"] },
|
|
6103
6448
|
"terminal.resize": { status: "exposed", permission: "terminal.exec", scope: "terminal: as terminal.input", capability: CAPABILITY.terminal, params: ["terminalId", "cols", "rows"], tests: ["permission", "binding"] },
|
|
6104
6449
|
"terminal.close": { status: "exposed", permission: "terminal.exec", scope: "terminal: as terminal.attach", capability: CAPABILITY.terminal, params: ["terminalId"], tests: ["permission", "binding"] },
|
|
@@ -6125,12 +6470,16 @@ var EXPOSURE = Object.freeze({
|
|
|
6125
6470
|
"workspace.files.search": { status: "exposed", permission: "project.read", scope: "workspace: projectRoot names a granted workspace and is sent as its canonical path; alpd lists file names under it only (no link followed, no contents); answered paths must be relative without . or .. segments, others dropped", capability: CAPABILITY.workspaceFiles, params: ["projectRoot", "query", "limit"], tests: ["permission", "workspace-param", "result-filter"] },
|
|
6126
6471
|
"workspace.files.list": { status: "exposed", permission: "files.read", scope: "workspace: projectRoot names a granted workspace and is sent as its canonical path; path relative, no . or .. segment, never a blocked one (blockedFilePath, refused by the gateway before alpd); alpd lists regular files and directories under it, no link followed; answered entries must be direct children of path, plainly relative and not blocked, others dropped; alpd errors rewritten to fixed text", capability: CAPABILITY.workspaceFilesRead, params: ["projectRoot", "path", "includeIgnored"], tests: ["permission", "workspace-param", "result-filter", "path-filter"] },
|
|
6127
6472
|
"workspace.files.read": { status: "exposed", permission: "files.read", scope: "workspace: as workspace.files.list; alpd reads one UTF-8 text file of at most WORKSPACE_FILES.maxReadBytes, no link or hard link; the answer must name the requested path and fit the limit, else refused; alpd errors rewritten to fixed text", capability: CAPABILITY.workspaceFilesRead, params: ["projectRoot", "path", "includeIgnored"], tests: ["permission", "workspace-param", "result-filter", "path-filter"] },
|
|
6473
|
+
"workspace.files.find": { status: "denied", scope: "workspace: projectRoot; every file and directory name under it, in pages of a snapshot alpd keeps for the connection that asked", reason: "For the daemon host's own clients (the Paseo bridge, t-bb87): no grant covers a whole-tree listing or its snapshots yet; remote clients search names with workspace.files.search (project.read)." },
|
|
6474
|
+
"workspace.files.preview": { status: "denied", scope: "workspace: projectRoot and path; the bytes of any text, image or binary file up to 50 MiB, in chunks", reason: "For the daemon host's own clients (the Paseo bridge, t-bb87): files.read covers UTF-8 text of at most 1 MiB only; remote clients read files with workspace.files.read." },
|
|
6475
|
+
"host.directories.search": { status: "prohibited", scope: "host", reason: "Names of the daemon host's directories outside any workspace (home, typed absolute paths): the host owner's own, never remote." },
|
|
6128
6476
|
"workspace.git.status": { status: "exposed", permission: "project.read", scope: "workspace: workspaceId names a registry workspace whose directory a grant names exactly (#registryWorkspace, managed worktrees included); read only, never a Git mutation; answer projected by projectGitStatus: listed fields only, rows whose path or old path is not plainly relative or is blocked dropped and counted hidden, a local remote URL answered null; alpd errors rewritten to fixed text", capability: CAPABILITY.workspaceGit, params: ["workspaceId"], tests: ["permission", "registry-scope", "result-filter"] },
|
|
6129
6477
|
"workspace.git.diff": { status: "exposed", permission: "project.read", alsoRequires: ["files.read"], scope: "workspace: as workspace.git.status; hunks are file content, so files.read too (never a default); compare re-projected to mode, baseRef, ignoreWhitespace; path relative and not blocked, refused by the gateway before alpd; answer projected by projectGitDiff: files of other paths, non-relative or blocked ones dropped (counted hidden), each file's patch and the page within WORKSPACE_GIT or the answer refused, pages split to fit the client's frame (sealed gateway cursors); alpd errors rewritten to fixed text", capability: CAPABILITY.workspaceGit, params: ["workspaceId", "compare", "path", "cursor"], tests: ["permission", "registry-scope", "result-filter", "path-filter"] },
|
|
6478
|
+
"workspace.git.facts": { status: "prohibited", scope: "host", reason: "Owner-only checkout facts of any host directory, named by host path rather than a granted workspace; the answer names host paths. Its capability is not forwarded either." },
|
|
6130
6479
|
"task.list": { status: "exposed", permission: "project.read", scope: "workspace: projectRoot", capability: CAPABILITY.task, params: ["projectRoot"], tests: ["permission", "workspace-param"] },
|
|
6131
6480
|
"task.create": { status: "exposed", permission: "project.write", scope: "workspace: projectRoot; requestId dedupes within one alpd process for 10 minutes only, so read task.list before retrying after 1000 or a restart", capability: CAPABILITY.task, params: ["projectRoot", "title", "priority", "requestId"], tests: ["permission", "workspace-param"] },
|
|
6132
6481
|
"task.update": { status: "exposed", permission: "project.write", scope: "workspace: projectRoot", capability: CAPABILITY.task, params: ["projectRoot", "id", "action", "note", "ifRev"], tests: ["permission", "workspace-param"] },
|
|
6133
|
-
"task.gate.resolve": { status: "exposed", permission: "project.write", scope: "workspace: projectRoot", capability: CAPABILITY.task, params: ["projectRoot", "id", "gate", "note", "ifRev"], tests: ["permission", "workspace-param"] },
|
|
6482
|
+
"task.gate.resolve": { status: "exposed", permission: "project.write", scope: "workspace: projectRoot", capability: CAPABILITY.task, params: ["projectRoot", "id", "gate", "note", "ifRev", "choice", "reject", "channel"], tests: ["permission", "workspace-param"] },
|
|
6134
6483
|
"library.list": { status: "exposed", permission: "project.read", scope: "workspace: projectRoot (required by the gateway); rows (names, descriptions, sources, users) also come from the library and built-in layers; LIBRARY_ROW_FIELDS only, never content", capability: CAPABILITY.library, params: ["kind", "projectRoot"], tests: ["permission", "workspace-param", "row-fields"] },
|
|
6135
6484
|
"library.models": { status: "exposed", permission: "session.read", scope: "none: model ids and labels, as catalog.get; MODEL_ROW_FIELDS only", capability: CAPABILITY.library, params: [], tests: ["permission", "row-fields"] },
|
|
6136
6485
|
"settings.language.get": { status: "exposed", permission: "session.read", scope: "none: the language the user reads", capability: CAPABILITY.settingsLanguage, params: [], tests: ["permission"] },
|
|
@@ -6147,6 +6496,7 @@ var EXPOSURE = Object.freeze({
|
|
|
6147
6496
|
"daemon.pause": { status: "denied", scope: "host", reason: "host.admin" },
|
|
6148
6497
|
"daemon.resume": { status: "denied", scope: "host", reason: "host.admin" },
|
|
6149
6498
|
"daemon.pauses": { status: "denied", scope: "host", reason: "host.admin" },
|
|
6499
|
+
"session.compact": { status: "prohibited", scope: "session", reason: "Compacting main is a local CLI operation (alp compact) for now; remote clients may get it later." },
|
|
6150
6500
|
"daemon.shutdown": { status: "prohibited", scope: "host", reason: "Stops alpd." },
|
|
6151
6501
|
"extension.register": { status: "prohibited", scope: "host", reason: "Would let a remote client serve methods every local client calls." },
|
|
6152
6502
|
"extension.unregister": { status: "prohibited", scope: "host", reason: "Extension methods are never remote." },
|
|
@@ -6263,7 +6613,7 @@ function gitDiffFile(raw) {
|
|
|
6263
6613
|
}
|
|
6264
6614
|
return { path: source.path, ...source.oldPath !== void 0 ? { oldPath: source.oldPath } : {}, change: source.change, kind: source.kind, additions: source.additions, deletions: source.deletions, hunks };
|
|
6265
6615
|
}
|
|
6266
|
-
function projectGitDiff(raw, { path:
|
|
6616
|
+
function projectGitDiff(raw, { path: path11 } = {}) {
|
|
6267
6617
|
if (!plain(raw)) return { refused: "shape" };
|
|
6268
6618
|
const source = (
|
|
6269
6619
|
/** @type {Record<string, any>} */
|
|
@@ -6285,7 +6635,7 @@ function projectGitDiff(raw, { path: path10 } = {}) {
|
|
|
6285
6635
|
hidden++;
|
|
6286
6636
|
continue;
|
|
6287
6637
|
}
|
|
6288
|
-
if (
|
|
6638
|
+
if (path11 !== void 0 && file.path !== path11 && file.oldPath !== path11) {
|
|
6289
6639
|
foreign++;
|
|
6290
6640
|
continue;
|
|
6291
6641
|
}
|
|
@@ -6314,9 +6664,9 @@ function projectGitDiff(raw, { path: path10 } = {}) {
|
|
|
6314
6664
|
}
|
|
6315
6665
|
|
|
6316
6666
|
// packages/core/src/resolver.js
|
|
6317
|
-
import
|
|
6667
|
+
import path6 from "node:path";
|
|
6318
6668
|
var KINDS = {
|
|
6319
|
-
skills: (name2) =>
|
|
6669
|
+
skills: (name2) => path6.join(name2, "SKILL.md"),
|
|
6320
6670
|
mcp: (name2) => `${name2}.json`,
|
|
6321
6671
|
hooks: (name2) => `${name2}.json`,
|
|
6322
6672
|
// ACP providers (ALPD §46) live only in the library.
|
|
@@ -6511,7 +6861,7 @@ var CONVERSATION_REFUSALS = Object.freeze({
|
|
|
6511
6861
|
request_conflict: "A session with this newSessionId already exists",
|
|
6512
6862
|
invalid_params: "The daemon host refused these parameters for this session"
|
|
6513
6863
|
});
|
|
6514
|
-
var ATTACHMENT_ERROR_DATA = Object.freeze(["received", "size", "max", "limit", "maxPerPrompt", "maxPromptBytes"]);
|
|
6864
|
+
var ATTACHMENT_ERROR_DATA = Object.freeze(["received", "size", "max", "limit", "maxPerPrompt", "maxPromptBytes", "attachmentId"]);
|
|
6515
6865
|
var GIT_PAGE_PREFIX = "alp-gateway-page:";
|
|
6516
6866
|
var MAX_GIT_PAGES = 64;
|
|
6517
6867
|
var requestedFile = (file) => relativeFile(file) && !String(file).includes("\\");
|
|
@@ -6588,6 +6938,9 @@ var ClientConnection = class {
|
|
|
6588
6938
|
#queue = [];
|
|
6589
6939
|
#queuedBytes = 0;
|
|
6590
6940
|
#helloed = false;
|
|
6941
|
+
/** The client said in daemon.hello that an ALP agent started it: the re-hello that says so on its alpd connection (t-e706). */
|
|
6942
|
+
/** @type {Promise<unknown> | undefined} */
|
|
6943
|
+
#agent;
|
|
6591
6944
|
/** A hello waiting for alpd: requests pipelined behind it wait too, as alpd answers hello at once. */
|
|
6592
6945
|
/** @type {Promise<unknown> | undefined} */
|
|
6593
6946
|
#helloing;
|
|
@@ -6612,6 +6965,7 @@ var ClientConnection = class {
|
|
|
6612
6965
|
#terminalLimits = gatewayTerminalLimits(void 0);
|
|
6613
6966
|
/** alpd's terminal output events do not fit this gateway's frames: terminal.* is refused. */
|
|
6614
6967
|
#terminalFramesTooSmall = false;
|
|
6968
|
+
#terminalWatching = false;
|
|
6615
6969
|
/** Terminals this connection attached: only their terminal.event notifications leave (§5.18). @type {Set<string>} */
|
|
6616
6970
|
#terminals = /* @__PURE__ */ new Set();
|
|
6617
6971
|
/**
|
|
@@ -6664,17 +7018,20 @@ var ClientConnection = class {
|
|
|
6664
7018
|
this.#capabilities = FORWARDED_CAPABILITIES.filter((capability) => listed.includes(capability));
|
|
6665
7019
|
this.#attachmentLimits = gatewayAttachmentLimits(hello2.attachmentLimits, this.#limits.maxFrame);
|
|
6666
7020
|
this.#terminalLimits = gatewayTerminalLimits(hello2.terminalLimits, this.#limits.maxFrame);
|
|
6667
|
-
const
|
|
7021
|
+
const advertisedFrames = (
|
|
6668
7022
|
/** @type {any} */
|
|
6669
7023
|
hello2.terminalLimits?.maxOutputFrameBytes
|
|
6670
7024
|
);
|
|
6671
|
-
|
|
6672
|
-
|
|
7025
|
+
const daemonFrames = !listed.includes("terminal") && advertisedFrames === void 0 ? TERMINAL.maxOutputFrameBytes : advertisedFrames;
|
|
7026
|
+
this.#terminalFramesTooSmall = !(Number.isSafeInteger(daemonFrames) && daemonFrames <= this.#terminalLimits.maxOutputFrameBytes);
|
|
7027
|
+
if (this.#terminalFramesTooSmall) {
|
|
7028
|
+
this.#capabilities = this.#capabilities.filter((capability) => capability !== "terminal" && capability !== "terminal.capture");
|
|
6673
7029
|
this.#terminalFramesTooSmall = true;
|
|
6674
7030
|
this.#log.warn("alpd's terminal output does not fit this gateway's frame limit; terminals are not forwarded", { code: "ALP_GATEWAY_TERMINAL_FRAME" });
|
|
6675
7031
|
}
|
|
6676
7032
|
client.onNotification((method, params) => {
|
|
6677
7033
|
if (method === "terminal.event") this.#terminalEvent(params);
|
|
7034
|
+
else if (method === "terminal.changed") this.#terminalChanged(params);
|
|
6678
7035
|
});
|
|
6679
7036
|
client.onEvent((envelope) => {
|
|
6680
7037
|
if (!this.#capabilities.includes("workspace.worktree") || !this.#grant.permissions.has("workspace.manage")) {
|
|
@@ -6964,11 +7321,11 @@ var ClientConnection = class {
|
|
|
6964
7321
|
async #handle(method, params) {
|
|
6965
7322
|
if (method === "daemon.hello") {
|
|
6966
7323
|
const greeting = this.#hello(params);
|
|
6967
|
-
this.#helloing = greeting.catch(() => {
|
|
6968
|
-
});
|
|
7324
|
+
this.#helloing = Promise.all([this.#helloing, greeting.catch(() => {
|
|
7325
|
+
})]);
|
|
6969
7326
|
return greeting;
|
|
6970
7327
|
}
|
|
6971
|
-
if (
|
|
7328
|
+
if (this.#helloing) await this.#helloing;
|
|
6972
7329
|
if (!this.#helloed) throw new GatewayError(ERROR.protocol, "daemon.hello is required first", { reason: "hello_required" });
|
|
6973
7330
|
await this.#refreshWorktrees();
|
|
6974
7331
|
const exposure = exposureOf(method);
|
|
@@ -6993,6 +7350,15 @@ var ClientConnection = class {
|
|
|
6993
7350
|
await this.#ready.catch(() => {
|
|
6994
7351
|
throw new GatewayError(GATEWAY_ERROR.unavailable, "alpd is unavailable", { reason: GATEWAY_REASON.daemonDisconnected });
|
|
6995
7352
|
});
|
|
7353
|
+
if (Array.isArray(params.capabilities) && params.capabilities.includes(AGENT_CAPABILITY)) this.#agent ??= this.#call("daemon.hello", { protocolVersion: PROTOCOL_VERSION, client: { name: "alp-gateway", version: "0" }, capabilities: [AGENT_CAPABILITY] });
|
|
7354
|
+
if (this.#agent) {
|
|
7355
|
+
try {
|
|
7356
|
+
await this.#agent;
|
|
7357
|
+
} catch {
|
|
7358
|
+
this.close(CLOSE_CODE2.internal, "Could not mark the agent connection to alpd; reconnect");
|
|
7359
|
+
throw new GatewayError(GATEWAY_ERROR.unavailable, "alpd is unavailable", { reason: GATEWAY_REASON.daemonDisconnected });
|
|
7360
|
+
}
|
|
7361
|
+
}
|
|
6996
7362
|
this.#helloed = true;
|
|
6997
7363
|
return {
|
|
6998
7364
|
protocolVersion: PROTOCOL_VERSION,
|
|
@@ -7352,7 +7718,9 @@ var ClientConnection = class {
|
|
|
7352
7718
|
const data = reason ? { reason } : {};
|
|
7353
7719
|
for (const key2 of ATTACHMENT_ERROR_DATA) {
|
|
7354
7720
|
const value = error.data?.[key2];
|
|
7355
|
-
if (Number.isSafeInteger(value) && value >= 0 || key2 === "limit" && typeof value === "string" && /^[a-z_]{1,32}$/.test(value)
|
|
7721
|
+
if (Number.isSafeInteger(value) && value >= 0 || key2 === "limit" && typeof value === "string" && /^[a-z_]{1,32}$/.test(value) || key2 === "attachmentId" && typeof value === "string" && /^att_[0-9a-f]{32}$/.test(value)) {
|
|
7722
|
+
data[key2] = value;
|
|
7723
|
+
}
|
|
7356
7724
|
}
|
|
7357
7725
|
return new GatewayError(error.code, reason ? ATTACHMENT_REFUSALS[reason] : "The attachment request failed on the daemon host", Object.keys(data).length ? data : void 0);
|
|
7358
7726
|
}
|
|
@@ -7364,6 +7732,14 @@ var ClientConnection = class {
|
|
|
7364
7732
|
*/
|
|
7365
7733
|
#terminalEvent(raw) {
|
|
7366
7734
|
if (this.#closed) return;
|
|
7735
|
+
const candidate = (
|
|
7736
|
+
/** @type {any} */
|
|
7737
|
+
raw
|
|
7738
|
+
);
|
|
7739
|
+
if (candidate?.type === "output" && typeof candidate.data === "string" && this.#terminals.has(candidate.terminalId) && this.#grant.permissions.has("terminal.exec") && Buffer.byteLength(candidate.data) > this.#terminalLimits.maxOutputFrameBytes) {
|
|
7740
|
+
this.close(CLOSE_CODE2.internal, "Terminal output exceeds the negotiated frame limit; reconnect");
|
|
7741
|
+
return;
|
|
7742
|
+
}
|
|
7367
7743
|
const event = projectTerminalEvent(raw, this.#terminalLimits.maxOutputFrameBytes);
|
|
7368
7744
|
if (!event || !this.#terminals.has(event.terminalId) || !this.#grant.permissions.has("terminal.exec")) {
|
|
7369
7745
|
this.#log.warn("dropped a terminal event this connection may not get", { code: "ALP_GATEWAY_EVENT_OUT_OF_SCOPE" });
|
|
@@ -7372,6 +7748,13 @@ var ClientConnection = class {
|
|
|
7372
7748
|
if (event.type === "detached") this.#terminals.delete(event.terminalId);
|
|
7373
7749
|
this.#push(JSON.stringify({ jsonrpc: "2.0", method: "terminal.event", params: event }));
|
|
7374
7750
|
}
|
|
7751
|
+
/** Only this connection's authorized watch gets opaque invalidations; never host terminal data.
|
|
7752
|
+
* @param {any} raw */
|
|
7753
|
+
#terminalChanged(raw) {
|
|
7754
|
+
if (this.#closed || !this.#terminalWatching || !this.#grant.permissions.has("terminal.exec")) return;
|
|
7755
|
+
if (!/^[0-9a-f]{32}$/.test(raw?.watchId) || !/^[0-9a-f]{32}$/.test(raw?.cursor)) return;
|
|
7756
|
+
this.#push(JSON.stringify({ jsonrpc: "2.0", method: "terminal.changed", params: { watchId: raw.watchId, cursor: raw.cursor } }));
|
|
7757
|
+
}
|
|
7375
7758
|
/** alpd's refusal of a terminal call: a fixed text per known reason, its code and reason, `limit` only. @param {unknown} caught */
|
|
7376
7759
|
#terminalError(caught) {
|
|
7377
7760
|
const error = (
|
|
@@ -7536,8 +7919,8 @@ var ClientConnection = class {
|
|
|
7536
7919
|
* @param {unknown} directory */
|
|
7537
7920
|
async #registryDirectory(directory) {
|
|
7538
7921
|
const grant = this.#workspace(directory);
|
|
7539
|
-
const
|
|
7540
|
-
if (!
|
|
7922
|
+
const canonical2 = await registryRealpath(grant.path).catch(() => void 0);
|
|
7923
|
+
if (!canonical2 || canonical2 !== grant.canonical || !(await registryStat(canonical2)).isDirectory()) throw forbidden("Granted directory changed; ask the owner to update the credential", GATEWAY_REASON.outsideWorkspace);
|
|
7541
7924
|
return grant;
|
|
7542
7925
|
}
|
|
7543
7926
|
async #registryRoots() {
|
|
@@ -7562,13 +7945,13 @@ var ClientConnection = class {
|
|
|
7562
7945
|
throw forbidden("Workspace is unavailable to this credential", GATEWAY_REASON.outsideWorkspace);
|
|
7563
7946
|
});
|
|
7564
7947
|
const grant = await this.#registryDirectory(result?.workspace?.directory);
|
|
7565
|
-
const
|
|
7566
|
-
if (
|
|
7948
|
+
const canonical2 = await registryRealpath(result.workspace.directory).catch(() => void 0);
|
|
7949
|
+
if (canonical2 !== grant.canonical || result.workspace.canonical && result.workspace.canonical !== canonical2) throw forbidden("Workspace directory changed", GATEWAY_REASON.outsideWorkspace);
|
|
7567
7950
|
return result;
|
|
7568
7951
|
}
|
|
7569
7952
|
/** Principal-scoped durable IDs without trusting an actor field from the client. @param {string} id */
|
|
7570
7953
|
#registryRequestId(id) {
|
|
7571
|
-
return "gw:" +
|
|
7954
|
+
return "gw:" + createHash4("sha256").update(JSON.stringify([this.#grant.id, id])).digest("hex");
|
|
7572
7955
|
}
|
|
7573
7956
|
/** @param {string} kind @param {any} params */
|
|
7574
7957
|
async #registryList(kind, params) {
|
|
@@ -7633,7 +8016,11 @@ var ClientConnection = class {
|
|
|
7633
8016
|
const result = await this.#registryCall("project.remove", { ...params, authorizedRoots: await this.#registryRoots(), requestId: this.#registryRequestId(params.requestId) });
|
|
7634
8017
|
return { project: this.#registryProjection(result.project, "project"), revision: result.revision };
|
|
7635
8018
|
},
|
|
7636
|
-
|
|
8019
|
+
// Provider errors can name host paths and exit codes: remote clients get each provider's status only (t-e5ee).
|
|
8020
|
+
"catalog.get": async () => {
|
|
8021
|
+
const { providers, ...catalog } = await this.#call("catalog.get", {});
|
|
8022
|
+
return providers && typeof providers === "object" ? { ...catalog, providers: Object.fromEntries(Object.entries(providers).map(([runtime, state]) => [runtime, { status: state?.status, ...typeof state?.fetchedAt === "string" ? { fetchedAt: state.fetchedAt } : {} }])) } : catalog;
|
|
8023
|
+
},
|
|
7637
8024
|
"session.list": async (params) => {
|
|
7638
8025
|
const only = params.projectRoot === void 0 ? void 0 : this.#workspace(params.projectRoot);
|
|
7639
8026
|
const { projectRoot: _projectRoot, cursor: sealed, ...rest } = params;
|
|
@@ -8092,6 +8479,38 @@ ${session.id}`.toLowerCase().includes(word))));
|
|
|
8092
8479
|
if (!Array.isArray(result?.terminals)) throw new GatewayError(ERROR.failed, "The daemon host answered a list the gateway does not pass on");
|
|
8093
8480
|
return { terminals: result.terminals.map((entry) => this.#terminalAnswer(entry, "terminal.list")) };
|
|
8094
8481
|
},
|
|
8482
|
+
"terminal.watch": async (params) => {
|
|
8483
|
+
if (params.workspaceId !== void 0) await this.#registryWorkspace(params.workspaceId);
|
|
8484
|
+
this.#terminalWatching = true;
|
|
8485
|
+
try {
|
|
8486
|
+
const result = (
|
|
8487
|
+
/** @type {any} */
|
|
8488
|
+
await this.#terminalCall("terminal.watch", params)
|
|
8489
|
+
);
|
|
8490
|
+
if (!Array.isArray(result?.terminals) || !/^[0-9a-f]{32}$/.test(result.watchId) || !/^[0-9a-f]{32}$/.test(result.cursor) || typeof result.reset !== "boolean") throw new GatewayError(ERROR.failed, "Invalid terminal snapshot from daemon host");
|
|
8491
|
+
const safe = { terminals: result.terminals.map((entry) => this.#terminalAnswer(entry, "terminal.watch")), watchId: result.watchId, cursor: result.cursor, reset: result.reset };
|
|
8492
|
+
if (Buffer.byteLength(JSON.stringify(safe)) > (this.#limits.maxFrame ?? 512 * 1024) - 1024) throw new GatewayError(GATEWAY_ERROR.unavailable, "Terminal snapshot exceeds this gateway frame limit; select a workspace", { reason: "terminal_snapshot_too_large" });
|
|
8493
|
+
return safe;
|
|
8494
|
+
} catch (error) {
|
|
8495
|
+
this.#terminalWatching = false;
|
|
8496
|
+
throw error;
|
|
8497
|
+
}
|
|
8498
|
+
},
|
|
8499
|
+
"terminal.unwatch": async () => {
|
|
8500
|
+
this.#terminalWatching = false;
|
|
8501
|
+
await this.#call("terminal.unwatch", {});
|
|
8502
|
+
return { closed: true };
|
|
8503
|
+
},
|
|
8504
|
+
"terminal.capture": async (params) => {
|
|
8505
|
+
const result = (
|
|
8506
|
+
/** @type {any} */
|
|
8507
|
+
await this.#terminalCall("terminal.capture", params)
|
|
8508
|
+
);
|
|
8509
|
+
if (!Array.isArray(result?.lines) || !result.lines.every((line) => typeof line === "string") || !Number.isSafeInteger(result.totalLines) || result.totalLines < 0 || result.lines.length > result.totalLines) throw new GatewayError(ERROR.failed, "The daemon host answered a capture the gateway does not pass on");
|
|
8510
|
+
const safe = { lines: result.lines, totalLines: result.totalLines };
|
|
8511
|
+
if (Buffer.byteLength(JSON.stringify(safe)) > (this.#limits.maxFrame ?? 512 * 1024) - 1024) throw new GatewayError(GATEWAY_ERROR.unavailable, "Terminal capture exceeds this gateway frame limit; select a smaller line range", { reason: "terminal_capture_too_large" });
|
|
8512
|
+
return safe;
|
|
8513
|
+
},
|
|
8095
8514
|
"terminal.attach": async (params) => {
|
|
8096
8515
|
const known = this.#terminals.has(params.terminalId);
|
|
8097
8516
|
this.#terminals.add(params.terminalId);
|
|
@@ -8291,9 +8710,9 @@ function resolveConfig(input = {}) {
|
|
|
8291
8710
|
}
|
|
8292
8711
|
|
|
8293
8712
|
// apps/gateway/src/tickets.js
|
|
8294
|
-
import { createHash as
|
|
8713
|
+
import { createHash as createHash5, randomBytes as randomBytes2 } from "node:crypto";
|
|
8295
8714
|
var TICKET = /^alpgwt\.[A-Za-z0-9_-]{43}$/;
|
|
8296
|
-
var key = (ticket) =>
|
|
8715
|
+
var key = (ticket) => createHash5("sha256").update(ticket, "utf8").digest("hex");
|
|
8297
8716
|
var TicketBook = class {
|
|
8298
8717
|
/** @type {Map<string, { principal: string, origin: string | null, expiresAt: number }>} */
|
|
8299
8718
|
#tickets = /* @__PURE__ */ new Map();
|
|
@@ -8446,6 +8865,11 @@ function createGateway({ config, store, openTransport, logger, version, monitorI
|
|
|
8446
8865
|
const tickets = new TicketBook({ ttlMs: limits.ticketTtlMs });
|
|
8447
8866
|
const connections = /* @__PURE__ */ new Set();
|
|
8448
8867
|
const perPrincipal = /* @__PURE__ */ new Map();
|
|
8868
|
+
const decrementPrincipal = (id) => {
|
|
8869
|
+
const next = (perPrincipal.get(id) ?? 1) - 1;
|
|
8870
|
+
if (next <= 0) perPrincipal.delete(id);
|
|
8871
|
+
else perPrincipal.set(id, next);
|
|
8872
|
+
};
|
|
8449
8873
|
let opening = 0;
|
|
8450
8874
|
const failures = /* @__PURE__ */ new Map();
|
|
8451
8875
|
const connectUpstream = upstreamConnector({ openTransport, version, maxPending: limits.maxPending });
|
|
@@ -8611,7 +9035,7 @@ Content-Length: 0\r
|
|
|
8611
9035
|
socket.once("close", () => {
|
|
8612
9036
|
if (!settled) {
|
|
8613
9037
|
release();
|
|
8614
|
-
|
|
9038
|
+
decrementPrincipal(grant.id);
|
|
8615
9039
|
}
|
|
8616
9040
|
});
|
|
8617
9041
|
wss.handleUpgrade(request, socket, head, (ws) => {
|
|
@@ -8622,8 +9046,7 @@ Content-Length: 0\r
|
|
|
8622
9046
|
const uncount = () => {
|
|
8623
9047
|
if (!counted) return;
|
|
8624
9048
|
counted = false;
|
|
8625
|
-
|
|
8626
|
-
if (!perPrincipal.get(grant.id)) perPrincipal.delete(grant.id);
|
|
9049
|
+
decrementPrincipal(grant.id);
|
|
8627
9050
|
};
|
|
8628
9051
|
try {
|
|
8629
9052
|
const connection = new ClientConnection({
|
|
@@ -8698,6 +9121,7 @@ Content-Length: 0\r
|
|
|
8698
9121
|
return {
|
|
8699
9122
|
connections,
|
|
8700
9123
|
tickets,
|
|
9124
|
+
perPrincipal,
|
|
8701
9125
|
get monitor() {
|
|
8702
9126
|
return monitor;
|
|
8703
9127
|
},
|
|
@@ -8762,14 +9186,41 @@ Content-Length: 0\r
|
|
|
8762
9186
|
}
|
|
8763
9187
|
|
|
8764
9188
|
// apps/gateway/src/credentials.js
|
|
8765
|
-
import { createHash as
|
|
8766
|
-
import { lstat as lstat2, readFile as readFile4, realpath as realpath2, rename as rename3, stat as stat3, writeFile as
|
|
8767
|
-
import
|
|
9189
|
+
import { createHash as createHash6, randomBytes as randomBytes4, timingSafeEqual } from "node:crypto";
|
|
9190
|
+
import { lstat as lstat2, readFile as readFile4, realpath as realpath2, rename as rename3, stat as stat3, writeFile as writeFile5, chmod, unlink as unlink5 } from "node:fs/promises";
|
|
9191
|
+
import { setTimeout as sleep } from "node:timers/promises";
|
|
9192
|
+
import path7 from "node:path";
|
|
9193
|
+
var RETRIABLE_RENAME_ERRORS = /* @__PURE__ */ new Set(["EPERM", "EACCES", "EBUSY"]);
|
|
9194
|
+
var RENAME_MAX_RETRIES = 8;
|
|
9195
|
+
var RENAME_INITIAL_BACKOFF_MS = 10;
|
|
9196
|
+
var RENAME_MAX_BACKOFF_MS = 80;
|
|
9197
|
+
async function renameWithRetry(temporary, destination, {
|
|
9198
|
+
retries = RENAME_MAX_RETRIES,
|
|
9199
|
+
initialBackoffMs = RENAME_INITIAL_BACKOFF_MS,
|
|
9200
|
+
maxBackoffMs = RENAME_MAX_BACKOFF_MS,
|
|
9201
|
+
sleep: delayFn = sleep
|
|
9202
|
+
} = {}) {
|
|
9203
|
+
for (let attempt = 0; ; attempt++) {
|
|
9204
|
+
try {
|
|
9205
|
+
await rename3(temporary, destination);
|
|
9206
|
+
return;
|
|
9207
|
+
} catch (error) {
|
|
9208
|
+
if (!RETRIABLE_RENAME_ERRORS.has(
|
|
9209
|
+
/** @type {any} */
|
|
9210
|
+
error?.code
|
|
9211
|
+
) || attempt >= retries) {
|
|
9212
|
+
throw error;
|
|
9213
|
+
}
|
|
9214
|
+
const delay2 = Math.min(initialBackoffMs * 2 ** attempt, maxBackoffMs);
|
|
9215
|
+
await delayFn(delay2);
|
|
9216
|
+
}
|
|
9217
|
+
}
|
|
9218
|
+
}
|
|
8768
9219
|
var TOKEN = /^alpgw1\.([a-f0-9]{16})\.([A-Za-z0-9_-]{43})$/;
|
|
8769
9220
|
var FILE_VERSION = 1;
|
|
8770
9221
|
var MODE = /^[a-z][a-z0-9-]{0,63}$/;
|
|
8771
|
-
var credentialsFile = (home) =>
|
|
8772
|
-
var digest = (secret) =>
|
|
9222
|
+
var credentialsFile = (home) => path7.join(home, "credentials.json");
|
|
9223
|
+
var digest = (secret) => createHash6("sha256").update(secret, "utf8").digest("hex");
|
|
8773
9224
|
function parseToken(token) {
|
|
8774
9225
|
const match = typeof token === "string" ? TOKEN.exec(token) : null;
|
|
8775
9226
|
return match ? { id: match[1], secret: match[2] } : void 0;
|
|
@@ -8799,10 +9250,10 @@ async function writeCredentials(home, data) {
|
|
|
8799
9250
|
const file = credentialsFile(home);
|
|
8800
9251
|
const temporary = `${file}.${process.pid}.${randomBytes4(4).toString("hex")}.tmp`;
|
|
8801
9252
|
try {
|
|
8802
|
-
await
|
|
9253
|
+
await writeFile5(temporary, `${JSON.stringify(data, null, 2)}
|
|
8803
9254
|
`, { mode: 384, flag: "wx" });
|
|
8804
9255
|
await chmod(temporary, 384);
|
|
8805
|
-
await
|
|
9256
|
+
await renameWithRetry(temporary, file);
|
|
8806
9257
|
} catch (error) {
|
|
8807
9258
|
await unlink5(temporary).catch(() => {
|
|
8808
9259
|
});
|
|
@@ -8816,12 +9267,12 @@ async function resolveWorkspaces(workspaces) {
|
|
|
8816
9267
|
if (!Array.isArray(workspaces) || !workspaces.length) throw new Error("A credential needs at least one workspace");
|
|
8817
9268
|
const resolved = [];
|
|
8818
9269
|
for (const entry of workspaces) {
|
|
8819
|
-
if (typeof entry !== "string" || !
|
|
9270
|
+
if (typeof entry !== "string" || !path7.isAbsolute(entry) || path7.resolve(entry) !== entry || entry.includes("\0")) {
|
|
8820
9271
|
throw new Error(`Workspace ${JSON.stringify(entry)} must be an absolute, normalized path`);
|
|
8821
9272
|
}
|
|
8822
|
-
const
|
|
8823
|
-
if (!(await stat3(
|
|
8824
|
-
if (!resolved.some((known) => known.canonical ===
|
|
9273
|
+
const canonical2 = await realpath2(entry);
|
|
9274
|
+
if (!(await stat3(canonical2)).isDirectory()) throw new Error(`Workspace ${entry} is not a directory`);
|
|
9275
|
+
if (!resolved.some((known) => known.canonical === canonical2)) resolved.push({ path: entry, canonical: canonical2 });
|
|
8825
9276
|
}
|
|
8826
9277
|
return resolved;
|
|
8827
9278
|
}
|
|
@@ -8897,7 +9348,7 @@ function grantOf(stored, now) {
|
|
|
8897
9348
|
if (stored.revokedAt) return void 0;
|
|
8898
9349
|
const expiresAt = stored.expiresAt === void 0 ? void 0 : Date.parse(stored.expiresAt);
|
|
8899
9350
|
if (expiresAt !== void 0 && !(expiresAt > now)) return void 0;
|
|
8900
|
-
const workspaces = Array.isArray(stored.workspaces) ? stored.workspaces.filter((entry) => typeof entry?.path === "string" && typeof entry?.canonical === "string" &&
|
|
9351
|
+
const workspaces = Array.isArray(stored.workspaces) ? stored.workspaces.filter((entry) => typeof entry?.path === "string" && typeof entry?.canonical === "string" && path7.isAbsolute(entry.path) && path7.isAbsolute(entry.canonical)) : [];
|
|
8901
9352
|
const permissions = Array.isArray(stored.permissions) ? stored.permissions.filter((permission) => PERMISSIONS.includes(permission)) : [];
|
|
8902
9353
|
if (!workspaces.length || !permissions.length || typeof stored.hash !== "string" || !/^[a-f0-9]{64}$/.test(stored.hash)) return void 0;
|
|
8903
9354
|
let mappingIds;
|
|
@@ -8912,7 +9363,7 @@ function grantOf(stored, now) {
|
|
|
8912
9363
|
{
|
|
8913
9364
|
id: stored.id,
|
|
8914
9365
|
label: String(stored.label ?? ""),
|
|
8915
|
-
workspaces: workspaces.map(({ path: given, canonical }) => ({ path: given, canonical })),
|
|
9366
|
+
workspaces: workspaces.map(({ path: given, canonical: canonical2 }) => ({ path: given, canonical: canonical2 })),
|
|
8916
9367
|
permissions: new Set(permissions),
|
|
8917
9368
|
worktreeMappings: mappingIds,
|
|
8918
9369
|
scopeId: stored.scopeId ?? digest(JSON.stringify([workspaces, permissions, stored.worktreeMappings ?? []])),
|
|
@@ -9055,10 +9506,10 @@ function createGatewayLogger({ write, level, env } = {}) {
|
|
|
9055
9506
|
|
|
9056
9507
|
// packages/cli/src/web/grant.js
|
|
9057
9508
|
import { mkdir as mkdir5, realpath as realpath3, stat as stat4 } from "node:fs/promises";
|
|
9058
|
-
import
|
|
9509
|
+
import path8 from "node:path";
|
|
9059
9510
|
var LABEL = "alp web (this machine)";
|
|
9060
9511
|
var BASE_PERMISSIONS = Object.freeze([...DEFAULT_PERMISSIONS, "workspace.write"]);
|
|
9061
|
-
var webGatewayHome = (home) =>
|
|
9512
|
+
var webGatewayHome = (home) => path8.join(home, "web");
|
|
9062
9513
|
function grantPermissions(extra, warn = () => {
|
|
9063
9514
|
}) {
|
|
9064
9515
|
const wanted = new Set(BASE_PERMISSIONS);
|
|
@@ -9078,10 +9529,10 @@ function grantPermissions(extra, warn = () => {
|
|
|
9078
9529
|
async function existingWorkspaces(paths) {
|
|
9079
9530
|
const found = [];
|
|
9080
9531
|
for (const entry of paths) {
|
|
9081
|
-
if (typeof entry !== "string" || !
|
|
9082
|
-
const
|
|
9083
|
-
if (!
|
|
9084
|
-
if (!found.some((known) => known.canonical ===
|
|
9532
|
+
if (typeof entry !== "string" || !path8.isAbsolute(entry) || path8.resolve(entry) !== entry || entry.includes("\0")) continue;
|
|
9533
|
+
const canonical2 = await realpath3(entry).catch(() => void 0);
|
|
9534
|
+
if (!canonical2 || !await stat4(canonical2).then((info) => info.isDirectory(), () => false)) continue;
|
|
9535
|
+
if (!found.some((known) => known.canonical === canonical2)) found.push({ path: entry, canonical: canonical2 });
|
|
9085
9536
|
}
|
|
9086
9537
|
return found;
|
|
9087
9538
|
}
|
|
@@ -9146,7 +9597,7 @@ var samePermissions = (a, b) => JSON.stringify([...a].sort()) === JSON.stringify
|
|
|
9146
9597
|
function createGrant({ home, store, permissions, project, socket, log = () => {
|
|
9147
9598
|
} }) {
|
|
9148
9599
|
const credentialsHome = webGatewayHome(home);
|
|
9149
|
-
const placeholder =
|
|
9600
|
+
const placeholder = path8.join(credentialsHome, "no-project");
|
|
9150
9601
|
let tail2 = Promise.resolve();
|
|
9151
9602
|
const serial = (run2) => {
|
|
9152
9603
|
const result = tail2.then(run2);
|
|
@@ -9232,7 +9683,7 @@ function createGrant({ home, store, permissions, project, socket, log = () => {
|
|
|
9232
9683
|
// packages/cli/src/web/serve.js
|
|
9233
9684
|
import { createReadStream } from "node:fs";
|
|
9234
9685
|
import { realpath as realpath4, stat as stat5 } from "node:fs/promises";
|
|
9235
|
-
import
|
|
9686
|
+
import path9 from "node:path";
|
|
9236
9687
|
var TYPES = {
|
|
9237
9688
|
".html": "text/html; charset=utf-8",
|
|
9238
9689
|
".js": "text/javascript; charset=utf-8",
|
|
@@ -9286,10 +9737,10 @@ function parseTarget(raw) {
|
|
|
9286
9737
|
var isFile2 = (file) => stat5(file).then((info) => info.isFile(), () => false);
|
|
9287
9738
|
function createStaticServer({ dir, csp, log = () => {
|
|
9288
9739
|
} }) {
|
|
9289
|
-
const configured =
|
|
9740
|
+
const configured = path9.resolve(dir);
|
|
9290
9741
|
let root;
|
|
9291
9742
|
const appRoot = async () => {
|
|
9292
|
-
const found = await (root ??= realpath4(configured).then(async (real) => await isFile2(
|
|
9743
|
+
const found = await (root ??= realpath4(configured).then(async (real) => await isFile2(path9.join(real, "index.html")) ? real : void 0, () => void 0));
|
|
9293
9744
|
if (!found) root = void 0;
|
|
9294
9745
|
return found;
|
|
9295
9746
|
};
|
|
@@ -9308,14 +9759,14 @@ function createStaticServer({ dir, csp, log = () => {
|
|
|
9308
9759
|
response.end(request.method === "HEAD" ? void 0 : text);
|
|
9309
9760
|
}
|
|
9310
9761
|
async function contained(base, segments) {
|
|
9311
|
-
const candidate =
|
|
9762
|
+
const candidate = path9.join(base, ...segments);
|
|
9312
9763
|
let real;
|
|
9313
9764
|
try {
|
|
9314
9765
|
real = await realpath4(candidate);
|
|
9315
9766
|
} catch {
|
|
9316
9767
|
return void 0;
|
|
9317
9768
|
}
|
|
9318
|
-
if (real !== base && !real.startsWith(base +
|
|
9769
|
+
if (real !== base && !real.startsWith(base + path9.sep)) return void 0;
|
|
9319
9770
|
return await isFile2(real) ? real : void 0;
|
|
9320
9771
|
}
|
|
9321
9772
|
return async function serveStatic(request, response) {
|
|
@@ -9335,7 +9786,7 @@ function createStaticServer({ dir, csp, log = () => {
|
|
|
9335
9786
|
let file = segments.length ? await contained(base, segments) : void 0;
|
|
9336
9787
|
if (!file) {
|
|
9337
9788
|
const last = segments.at(-1) ?? "";
|
|
9338
|
-
if (
|
|
9789
|
+
if (path9.extname(last)) {
|
|
9339
9790
|
plain3(request, response, 404, "Not found");
|
|
9340
9791
|
return true;
|
|
9341
9792
|
}
|
|
@@ -9345,8 +9796,8 @@ function createStaticServer({ dir, csp, log = () => {
|
|
|
9345
9796
|
return true;
|
|
9346
9797
|
}
|
|
9347
9798
|
}
|
|
9348
|
-
const relative =
|
|
9349
|
-
const type = TYPES[
|
|
9799
|
+
const relative = path9.relative(base, file).split(path9.sep).join("/");
|
|
9800
|
+
const type = TYPES[path9.extname(file).toLowerCase()] ?? "application/octet-stream";
|
|
9350
9801
|
const cache = relative === "index.html" ? "no-cache" : relative.startsWith("assets/") ? "public, max-age=31536000, immutable" : "no-cache";
|
|
9351
9802
|
const { size } = await stat5(file);
|
|
9352
9803
|
response.writeHead(200, { ...headers(type, cache), "content-length": String(size) });
|
|
@@ -9363,18 +9814,21 @@ function createStaticServer({ dir, csp, log = () => {
|
|
|
9363
9814
|
}
|
|
9364
9815
|
|
|
9365
9816
|
// packages/cli/src/web/main.js
|
|
9366
|
-
var VERSION = true ? "0.0.1-beta.
|
|
9817
|
+
var VERSION = true ? "0.0.1-beta.6" : "0.0.0-source";
|
|
9367
9818
|
var DEFAULT_WEB_PORT = 7433;
|
|
9368
9819
|
var PORT_TRIES = 10;
|
|
9369
9820
|
var REFRESH_MS = Number(process.env.ALP_WEB_GRANT_REFRESH_MS) > 0 ? Number(process.env.ALP_WEB_GRANT_REFRESH_MS) : 5e3;
|
|
9370
9821
|
var WEB_FILE_VERSION = 2;
|
|
9371
|
-
var here =
|
|
9372
|
-
var appDir = () =>
|
|
9373
|
-
|
|
9374
|
-
|
|
9822
|
+
var here = path10.dirname(fileURLToPath(import.meta.url));
|
|
9823
|
+
var appDir = () => {
|
|
9824
|
+
const assets = assetDir();
|
|
9825
|
+
return path10.resolve(process.env.ALP_WEB_APP || (assets ? path10.join(assets, "alp-web") : path10.join(here, "alp-web")));
|
|
9826
|
+
};
|
|
9827
|
+
var daemonEntry = () => process.env.ALP_DAEMON_ENTRY ?? selfEntry(path10.join(here, "alpd.js"));
|
|
9828
|
+
var webFile = (home) => path10.join(home, "web.json");
|
|
9375
9829
|
function serviceLog(home) {
|
|
9376
|
-
const file =
|
|
9377
|
-
|
|
9830
|
+
const file = path10.join(home, "logs", "integrations", "alp-web.log");
|
|
9831
|
+
mkdirSync2(path10.dirname(file), { recursive: true, mode: 448 });
|
|
9378
9832
|
const fd = openSync(file, "a", 384);
|
|
9379
9833
|
for (const stream of [process.stdout, process.stderr]) {
|
|
9380
9834
|
stream.write = /** @type {any} */
|
|
@@ -9389,7 +9843,7 @@ function serviceLog(home) {
|
|
|
9389
9843
|
}
|
|
9390
9844
|
}
|
|
9391
9845
|
async function userSettings(home, log) {
|
|
9392
|
-
const file =
|
|
9846
|
+
const file = path10.join(home, "settings.json");
|
|
9393
9847
|
let text;
|
|
9394
9848
|
try {
|
|
9395
9849
|
text = await readFile5(file, "utf8");
|
|
@@ -9420,10 +9874,10 @@ async function publish(home, info) {
|
|
|
9420
9874
|
const file = webFile(home);
|
|
9421
9875
|
const temporary = `${file}.${process.pid}.${randomBytes5(4).toString("hex")}.tmp`;
|
|
9422
9876
|
try {
|
|
9423
|
-
await
|
|
9877
|
+
await writeFile6(temporary, `${JSON.stringify(info)}
|
|
9424
9878
|
`, { mode: 384, flag: "wx" });
|
|
9425
9879
|
await chmod2(temporary, 384);
|
|
9426
|
-
await
|
|
9880
|
+
await renameWithRetry(temporary, file);
|
|
9427
9881
|
} catch (error) {
|
|
9428
9882
|
await unlink6(temporary).catch(() => {
|
|
9429
9883
|
});
|
|
@@ -9444,10 +9898,10 @@ async function carryPaseoIdentity(home, log) {
|
|
|
9444
9898
|
...typeof legacy.serverId === "string" && /^alp-[a-f0-9]{16}$/.test(legacy.serverId) ? { serverId: legacy.serverId } : {}
|
|
9445
9899
|
};
|
|
9446
9900
|
if (!Object.keys(identity).length) return false;
|
|
9447
|
-
const target =
|
|
9901
|
+
const target = path10.join(home, "paseo.json");
|
|
9448
9902
|
const temporary = `${target}.${process.pid}.${randomBytes5(4).toString("hex")}.tmp`;
|
|
9449
9903
|
try {
|
|
9450
|
-
await
|
|
9904
|
+
await writeFile6(temporary, `${JSON.stringify(identity)}
|
|
9451
9905
|
`, { mode: 384, flag: "wx" });
|
|
9452
9906
|
await chmod2(temporary, 384);
|
|
9453
9907
|
await link2(temporary, target);
|
|
@@ -9520,12 +9974,12 @@ async function run() {
|
|
|
9520
9974
|
if (values.service) serviceLog(home);
|
|
9521
9975
|
const log = createGatewayLogger();
|
|
9522
9976
|
const settings = await userSettings(home, log);
|
|
9523
|
-
if (values.rotate) return rotate(home, values.project ?
|
|
9977
|
+
if (values.rotate) return rotate(home, values.project ? path10.resolve(values.project) : void 0, settings, log);
|
|
9524
9978
|
if (settings?.web?.enabled === false) {
|
|
9525
9979
|
log.info('alp web is disabled by settings ("web.enabled": false)', { code: "ALP_WEB_DISABLED" });
|
|
9526
9980
|
process.exit(0);
|
|
9527
9981
|
}
|
|
9528
|
-
const project = values.project ?
|
|
9982
|
+
const project = values.project ? path10.resolve(values.project) : void 0;
|
|
9529
9983
|
const lock = createIntegrationLock(home, "web");
|
|
9530
9984
|
const { acquired, lock: held } = await lock.acquire();
|
|
9531
9985
|
if (!acquired) {
|
|
@@ -9610,11 +10064,12 @@ async function run() {
|
|
|
9610
10064
|
} catch (error) {
|
|
9611
10065
|
await candidate.close().catch(() => {
|
|
9612
10066
|
});
|
|
9613
|
-
|
|
10067
|
+
const code = (
|
|
9614
10068
|
/** @type {any} */
|
|
9615
|
-
error?.code
|
|
9616
|
-
)
|
|
9617
|
-
|
|
10069
|
+
error?.code
|
|
10070
|
+
);
|
|
10071
|
+
if (code !== "EADDRINUSE" && code !== "EACCES" || attempt + 1 >= PORT_TRIES) throw error;
|
|
10072
|
+
log.info(`port ${port} is ${code === "EACCES" ? "not available" : "in use"}; trying ${port + 1}`, { code: "ALP_WEB_PORT_BUSY" });
|
|
9618
10073
|
}
|
|
9619
10074
|
}
|
|
9620
10075
|
if (shuttingDown) return;
|
|
@@ -9626,6 +10081,27 @@ async function run() {
|
|
|
9626
10081
|
}, REFRESH_MS);
|
|
9627
10082
|
timer.unref();
|
|
9628
10083
|
cleanups.push(async () => clearInterval(timer));
|
|
10084
|
+
const stateDir = path10.join(home, "state");
|
|
10085
|
+
try {
|
|
10086
|
+
await mkdir6(stateDir, { recursive: true, mode: 448 });
|
|
10087
|
+
let debounce;
|
|
10088
|
+
const watcher = watch(stateDir, (_eventType, filename) => {
|
|
10089
|
+
const name2 = typeof filename === "string" ? filename : void 0;
|
|
10090
|
+
if (!name2 || name2 === "web-workspaces.json" || name2.startsWith("web-workspaces.json")) {
|
|
10091
|
+
clearTimeout(debounce);
|
|
10092
|
+
debounce = setTimeout(() => {
|
|
10093
|
+
if (!shuttingDown) void grant.refresh();
|
|
10094
|
+
}, 20);
|
|
10095
|
+
debounce?.unref?.();
|
|
10096
|
+
}
|
|
10097
|
+
});
|
|
10098
|
+
watcher.unref();
|
|
10099
|
+
cleanups.push(async () => {
|
|
10100
|
+
clearTimeout(debounce);
|
|
10101
|
+
watcher.close();
|
|
10102
|
+
});
|
|
10103
|
+
} catch {
|
|
10104
|
+
}
|
|
9629
10105
|
if (!await lock.setReady(true)) throw new Error("the web lock is no longer held by this process");
|
|
9630
10106
|
log.info(`alp web on ${url}`, { code: "ALP_WEB_LISTENING" });
|
|
9631
10107
|
})();
|
|
@@ -9634,7 +10110,10 @@ async function run() {
|
|
|
9634
10110
|
void shutdown(1);
|
|
9635
10111
|
});
|
|
9636
10112
|
}
|
|
9637
|
-
await run()
|
|
10113
|
+
await run().catch((error) => {
|
|
10114
|
+
createGatewayLogger().error("alp web did not start", { code: "ALP_WEB_START_FAILED", error });
|
|
10115
|
+
process.exitCode = 1;
|
|
10116
|
+
});
|
|
9638
10117
|
export {
|
|
9639
10118
|
DEFAULT_WEB_PORT
|
|
9640
10119
|
};
|