airband 0.0.4 → 0.0.5
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/airband-hook.js +188 -8
- package/airband-mcp.js +1 -1
- package/airband.js +34515 -32128
- package/companion/ui.css +1 -0
- package/companion/ui.js +98 -0
- package/package.json +2 -1
package/airband-hook.js
CHANGED
|
@@ -982,8 +982,149 @@ function toolNotice(toolName, toolInput, toolResponse, cwd) {
|
|
|
982
982
|
return `\u21AA Airband${where}: ${what}${tail}`;
|
|
983
983
|
}
|
|
984
984
|
|
|
985
|
-
// src/
|
|
985
|
+
// src/station/client.ts
|
|
986
986
|
var fs8 = __toESM(require("node:fs"));
|
|
987
|
+
var http = __toESM(require("node:http"));
|
|
988
|
+
var stationFile = () => airbandFile("station.json");
|
|
989
|
+
var DECISION_MS = 11e4;
|
|
990
|
+
var CONNECT_MS = 400;
|
|
991
|
+
function readStationInfo() {
|
|
992
|
+
try {
|
|
993
|
+
const info = JSON.parse(fs8.readFileSync(stationFile(), "utf8"));
|
|
994
|
+
if (!info.port || !info.token) return void 0;
|
|
995
|
+
try {
|
|
996
|
+
process.kill(info.pid, 0);
|
|
997
|
+
} catch (e) {
|
|
998
|
+
if (e.code === "ESRCH") return void 0;
|
|
999
|
+
}
|
|
1000
|
+
return info;
|
|
1001
|
+
} catch {
|
|
1002
|
+
return void 0;
|
|
1003
|
+
}
|
|
1004
|
+
}
|
|
1005
|
+
function stationPost(info, route, body, budgetMs) {
|
|
1006
|
+
return new Promise((resolve6) => {
|
|
1007
|
+
const data = Buffer.from(JSON.stringify(body));
|
|
1008
|
+
let done = false;
|
|
1009
|
+
const finish = (v) => {
|
|
1010
|
+
if (done) return;
|
|
1011
|
+
done = true;
|
|
1012
|
+
clearTimeout(timer);
|
|
1013
|
+
resolve6(v);
|
|
1014
|
+
};
|
|
1015
|
+
const req = http.request(
|
|
1016
|
+
{ host: "127.0.0.1", port: info.port, path: route, method: "POST", headers: { "content-type": "application/json", "content-length": data.length, "x-airband-token": info.token } },
|
|
1017
|
+
(res) => {
|
|
1018
|
+
let text = "";
|
|
1019
|
+
res.setEncoding("utf8");
|
|
1020
|
+
res.on("data", (c) => text += c);
|
|
1021
|
+
res.on("end", () => {
|
|
1022
|
+
try {
|
|
1023
|
+
finish(res.statusCode === 200 ? JSON.parse(text) : void 0);
|
|
1024
|
+
} catch {
|
|
1025
|
+
finish(void 0);
|
|
1026
|
+
}
|
|
1027
|
+
});
|
|
1028
|
+
res.on("error", () => finish(void 0));
|
|
1029
|
+
}
|
|
1030
|
+
);
|
|
1031
|
+
const timer = setTimeout(() => {
|
|
1032
|
+
req.destroy();
|
|
1033
|
+
finish(void 0);
|
|
1034
|
+
}, budgetMs);
|
|
1035
|
+
req.setTimeout(CONNECT_MS, () => {
|
|
1036
|
+
if (!req.socket || req.socket.connecting) {
|
|
1037
|
+
req.destroy();
|
|
1038
|
+
finish(void 0);
|
|
1039
|
+
}
|
|
1040
|
+
});
|
|
1041
|
+
req.on("socket", (s) => s.once("connect", () => req.setTimeout(0)));
|
|
1042
|
+
req.on("error", () => finish(void 0));
|
|
1043
|
+
req.end(data);
|
|
1044
|
+
});
|
|
1045
|
+
}
|
|
1046
|
+
async function askStation(ask, info = readStationInfo()) {
|
|
1047
|
+
if (!info || info.approvals === false || process.env.AIRBAND_NO_STATION) return void 0;
|
|
1048
|
+
const wait = Math.min(info.waitMs ?? DECISION_MS, DECISION_MS);
|
|
1049
|
+
const res = await stationPost(info, "/api/hook/permission", { ...ask, waitMs: wait }, wait + 2e3);
|
|
1050
|
+
return res?.answer;
|
|
1051
|
+
}
|
|
1052
|
+
|
|
1053
|
+
// src/station/reply.ts
|
|
1054
|
+
var TAKES_DECISIONS = ["claude", "codex"];
|
|
1055
|
+
function questionsOf(toolName, input) {
|
|
1056
|
+
if (toolName !== "AskUserQuestion" || !input || typeof input !== "object") return void 0;
|
|
1057
|
+
const qs = input.questions;
|
|
1058
|
+
if (!Array.isArray(qs) || !qs.length) return void 0;
|
|
1059
|
+
const out2 = [];
|
|
1060
|
+
for (const q of qs) {
|
|
1061
|
+
if (!q || typeof q !== "object") return void 0;
|
|
1062
|
+
const { question, header, options, multiSelect } = q;
|
|
1063
|
+
if (typeof question !== "string" || !Array.isArray(options)) return void 0;
|
|
1064
|
+
const opts = options.map((o) => o && typeof o === "object" ? o : {}).filter((o) => typeof o.label === "string").map((o) => ({ label: o.label, ...typeof o.description === "string" ? { description: o.description } : {} }));
|
|
1065
|
+
out2.push({ question, ...typeof header === "string" ? { header } : {}, options: opts, ...multiSelect === true ? { multiSelect: true } : {} });
|
|
1066
|
+
}
|
|
1067
|
+
return out2;
|
|
1068
|
+
}
|
|
1069
|
+
function answersFit(questions, answers) {
|
|
1070
|
+
if (!questions.length || Object.keys(answers).length !== questions.length) return false;
|
|
1071
|
+
return questions.every((q) => {
|
|
1072
|
+
const labels = q.options.map((o) => o.label);
|
|
1073
|
+
const pick = answers[q.question];
|
|
1074
|
+
if (q.multiSelect) {
|
|
1075
|
+
if (!Array.isArray(pick) || !pick.length || new Set(pick).size !== pick.length) return false;
|
|
1076
|
+
return pick.every((p) => labels.includes(p));
|
|
1077
|
+
}
|
|
1078
|
+
return typeof pick === "string" && labels.includes(pick);
|
|
1079
|
+
});
|
|
1080
|
+
}
|
|
1081
|
+
function permissionReply(agent, toolName, input, answer) {
|
|
1082
|
+
if (!answer || !TAKES_DECISIONS.includes(agent)) return void 0;
|
|
1083
|
+
const wrap = (decision) => JSON.stringify({ hookSpecificOutput: { hookEventName: "PermissionRequest", decision } });
|
|
1084
|
+
switch (answer.decision) {
|
|
1085
|
+
case "allow":
|
|
1086
|
+
case "always": {
|
|
1087
|
+
const questions = agent === "claude" ? questionsOf(toolName, input) : void 0;
|
|
1088
|
+
if (questions) {
|
|
1089
|
+
if (!answer.answers || !answersFit(questions, answer.answers)) return void 0;
|
|
1090
|
+
return wrap({ behavior: "allow", updatedInput: { ...input, answers: answer.answers } });
|
|
1091
|
+
}
|
|
1092
|
+
return wrap({ behavior: "allow" });
|
|
1093
|
+
}
|
|
1094
|
+
case "deny":
|
|
1095
|
+
return wrap({ behavior: "deny", message: (answer.message ?? "").trim() || "The person said no from Airband." });
|
|
1096
|
+
default:
|
|
1097
|
+
return void 0;
|
|
1098
|
+
}
|
|
1099
|
+
}
|
|
1100
|
+
function describeRequest(toolName, input) {
|
|
1101
|
+
const i = input && typeof input === "object" ? input : {};
|
|
1102
|
+
const str = (v) => typeof v === "string" ? v : void 0;
|
|
1103
|
+
const name = toolName ?? "a tool";
|
|
1104
|
+
if (toolName === "Bash" || toolName === "shell" || toolName === "exec_command" || toolName === "local_shell") {
|
|
1105
|
+
const cmd = str(i.command) ?? (Array.isArray(i.command) ? i.command.join(" ") : void 0) ?? str(i.cmd);
|
|
1106
|
+
return { title: "Wants to run a command", ...cmd ? { detail: cmd } : {} };
|
|
1107
|
+
}
|
|
1108
|
+
if (toolName === "Write" || toolName === "Edit" || toolName === "MultiEdit" || toolName === "NotebookEdit") {
|
|
1109
|
+
const file = str(i.file_path) ?? str(i.notebook_path);
|
|
1110
|
+
return { title: toolName === "Write" ? "Wants to write a file" : "Wants to edit a file", ...file ? { detail: file } : {} };
|
|
1111
|
+
}
|
|
1112
|
+
if (toolName === "WebFetch") return { title: "Wants to open a web page", ...str(i.url) ? { detail: str(i.url) } : {} };
|
|
1113
|
+
if (toolName === "WebSearch") return { title: "Wants to search the web", ...str(i.query) ? { detail: str(i.query) } : {} };
|
|
1114
|
+
if (toolName === "AskUserQuestion") {
|
|
1115
|
+
const first = questionsOf(toolName, input)?.[0]?.question;
|
|
1116
|
+
return { title: "Has a question for you", ...first ? { detail: first } : {} };
|
|
1117
|
+
}
|
|
1118
|
+
if (toolName === "ExitPlanMode") return { title: "Has a plan ready for you to approve", ...str(i.plan) ? { detail: str(i.plan).slice(0, 400) } : {} };
|
|
1119
|
+
if (toolName?.startsWith("mcp__")) {
|
|
1120
|
+
const [, server, tool] = toolName.split("__");
|
|
1121
|
+
return { title: `Wants to use ${tool ?? "a tool"} (${server ?? "MCP"})` };
|
|
1122
|
+
}
|
|
1123
|
+
return { title: `Wants to use ${name}` };
|
|
1124
|
+
}
|
|
1125
|
+
|
|
1126
|
+
// src/core/writing.ts
|
|
1127
|
+
var fs9 = __toESM(require("node:fs"));
|
|
987
1128
|
var path7 = __toESM(require("node:path"));
|
|
988
1129
|
var PROJECT_FILE = ".airband.json";
|
|
989
1130
|
function projectFile(cwd) {
|
|
@@ -991,8 +1132,8 @@ function projectFile(cwd) {
|
|
|
991
1132
|
let dir2 = path7.resolve(cwd);
|
|
992
1133
|
for (let i = 0; i < 12; i++) {
|
|
993
1134
|
const f = path7.join(dir2, PROJECT_FILE);
|
|
994
|
-
if (
|
|
995
|
-
if (
|
|
1135
|
+
if (fs9.existsSync(f)) return f;
|
|
1136
|
+
if (fs9.existsSync(path7.join(dir2, ".git"))) return void 0;
|
|
996
1137
|
const up = path7.dirname(dir2);
|
|
997
1138
|
if (up === dir2) return void 0;
|
|
998
1139
|
dir2 = up;
|
|
@@ -1260,7 +1401,7 @@ function checkWrittenDoc(doc) {
|
|
|
1260
1401
|
if (!found.length) return found;
|
|
1261
1402
|
let offset = 0;
|
|
1262
1403
|
try {
|
|
1263
|
-
const whole =
|
|
1404
|
+
const whole = fs9.readFileSync(doc.file, "utf8");
|
|
1264
1405
|
const at = whole.indexOf(doc.text.split("\n").find((l) => l.trim().length > 8) ?? doc.text);
|
|
1265
1406
|
const firstLong = doc.text.split("\n").findIndex((l) => l.trim().length > 8);
|
|
1266
1407
|
if (at >= 0) offset = whole.slice(0, at).split("\n").length - 1 - Math.max(0, firstLong);
|
|
@@ -1288,7 +1429,7 @@ function shellValues(command, flags, cwd) {
|
|
|
1288
1429
|
const name = file && (file[2] ?? file[3] ?? file[4]);
|
|
1289
1430
|
if (name && name !== "-") {
|
|
1290
1431
|
try {
|
|
1291
|
-
out2.push(
|
|
1432
|
+
out2.push(fs9.readFileSync(path7.resolve(cwd ?? ".", name), "utf8").slice(0, 64e3));
|
|
1292
1433
|
} catch {
|
|
1293
1434
|
}
|
|
1294
1435
|
}
|
|
@@ -1354,7 +1495,7 @@ function holdOnce(sessionId, text, now = Date.now()) {
|
|
|
1354
1495
|
|
|
1355
1496
|
// src/hook/airband-hook.ts
|
|
1356
1497
|
var EVENT_ALIASES = {
|
|
1357
|
-
claude: {},
|
|
1498
|
+
claude: { PermissionRequest: "Notification" },
|
|
1358
1499
|
codex: { PermissionRequest: "Notification" },
|
|
1359
1500
|
gemini: { BeforeAgent: "UserPromptSubmit", AfterAgent: "Stop", AfterTool: "PostToolUse", BeforeTool: "PreToolUse" }
|
|
1360
1501
|
};
|
|
@@ -1384,6 +1525,10 @@ function record(input, now = Date.now()) {
|
|
|
1384
1525
|
if (!id || !status || !safeId(id)) return;
|
|
1385
1526
|
const entry = { status, at: now, event: input.hook_event_name, cwd: input.cwd };
|
|
1386
1527
|
if (status === "waiting" && input.message) entry.message = input.message.slice(0, 200);
|
|
1528
|
+
else if (status === "waiting" && input.tool_name) {
|
|
1529
|
+
const d = describeRequest(input.tool_name, input.tool_input);
|
|
1530
|
+
entry.message = (d.detail ? `${d.title}: ${d.detail}` : d.title).slice(0, 200);
|
|
1531
|
+
}
|
|
1387
1532
|
writeFileAtomic(path8.join(statusDir(), `${id}.json`), JSON.stringify(entry));
|
|
1388
1533
|
}
|
|
1389
1534
|
function readSince(tool, file, cursor) {
|
|
@@ -1496,6 +1641,7 @@ function out(tool, event, context, notice) {
|
|
|
1496
1641
|
return Object.keys(o).length ? JSON.stringify(o) : void 0;
|
|
1497
1642
|
}
|
|
1498
1643
|
function handle(raw, now = Date.now(), tool = "claude") {
|
|
1644
|
+
if (process.env.AIRBAND_COMPANION) return void 0;
|
|
1499
1645
|
const input = normalise2(raw, tool);
|
|
1500
1646
|
record(input, now);
|
|
1501
1647
|
switch (input.hook_event_name) {
|
|
@@ -1600,6 +1746,21 @@ function sendCheck(input, tool) {
|
|
|
1600
1746
|
return void 0;
|
|
1601
1747
|
}
|
|
1602
1748
|
}
|
|
1749
|
+
async function permission(raw, tool, now = Date.now()) {
|
|
1750
|
+
try {
|
|
1751
|
+
handle(raw, now, tool);
|
|
1752
|
+
} catch {
|
|
1753
|
+
}
|
|
1754
|
+
if (process.env.AIRBAND_COMPANION || tool !== "claude" && tool !== "codex") return void 0;
|
|
1755
|
+
const answer = await askStation({ agent: tool, session_id: raw.session_id, cwd: raw.cwd, transcript_path: raw.transcript_path, tool_name: raw.tool_name, tool_input: raw.tool_input });
|
|
1756
|
+
if (answer && raw.session_id && safeId(raw.session_id)) {
|
|
1757
|
+
try {
|
|
1758
|
+
writeFileAtomic(path8.join(statusDir(), `${raw.session_id}.json`), JSON.stringify({ status: "working", at: Date.now(), event: "PermissionAnswered", cwd: raw.cwd }));
|
|
1759
|
+
} catch {
|
|
1760
|
+
}
|
|
1761
|
+
}
|
|
1762
|
+
return permissionReply(tool, raw.tool_name, raw.tool_input, answer);
|
|
1763
|
+
}
|
|
1603
1764
|
function main() {
|
|
1604
1765
|
const arg = (process.argv[2] ?? "claude").toLowerCase();
|
|
1605
1766
|
const tool = arg === "codex" || arg === "gemini" ? arg : "claude";
|
|
@@ -1607,14 +1768,33 @@ function main() {
|
|
|
1607
1768
|
process.stdin.setEncoding("utf8");
|
|
1608
1769
|
process.stdin.on("data", (chunk) => raw += chunk);
|
|
1609
1770
|
process.stdin.on("end", () => {
|
|
1771
|
+
let input;
|
|
1772
|
+
try {
|
|
1773
|
+
input = JSON.parse(raw);
|
|
1774
|
+
} catch {
|
|
1775
|
+
process.exit(0);
|
|
1776
|
+
}
|
|
1777
|
+
if (input.hook_event_name === "PermissionRequest") {
|
|
1778
|
+
clearTimeout(limit);
|
|
1779
|
+
setTimeout(() => process.exit(0), 115e3).unref();
|
|
1780
|
+
void permission(input, tool).then(
|
|
1781
|
+
(out2) => {
|
|
1782
|
+
if (out2) process.stdout.write(out2);
|
|
1783
|
+
process.exit(0);
|
|
1784
|
+
},
|
|
1785
|
+
() => process.exit(0)
|
|
1786
|
+
);
|
|
1787
|
+
return;
|
|
1788
|
+
}
|
|
1610
1789
|
try {
|
|
1611
|
-
const out2 = handle(
|
|
1790
|
+
const out2 = handle(input, Date.now(), tool);
|
|
1612
1791
|
if (out2) process.stdout.write(out2);
|
|
1613
1792
|
} catch {
|
|
1614
1793
|
}
|
|
1615
1794
|
process.exit(0);
|
|
1616
1795
|
});
|
|
1617
|
-
setTimeout(() => process.exit(0), 4e3)
|
|
1796
|
+
const limit = setTimeout(() => process.exit(0), 4e3);
|
|
1797
|
+
limit.unref();
|
|
1618
1798
|
}
|
|
1619
1799
|
|
|
1620
1800
|
// src/hook/bin.ts
|
package/airband-mcp.js
CHANGED
|
@@ -44998,7 +44998,7 @@ var INSTRUCTIONS = [
|
|
|
44998
44998
|
"- When the person refers to earlier work or another chat (what was done, which chat changed something, what happened while they were away, a ticket like ENG-142, a PR like #128), call airband_flightlog: with query to search every chat, or with chat to read one.",
|
|
44999
44999
|
"- airband_notes holds notes chats left for this project; read them before working in an unfamiliar area, and save one when you learn something the next chat should know."
|
|
45000
45000
|
].join("\n");
|
|
45001
|
-
var server = new McpServer({ name: "airband", version: "0.0.
|
|
45001
|
+
var server = new McpServer({ name: "airband", version: "0.0.5" }, { instructions: INSTRUCTIONS });
|
|
45002
45002
|
var text = (t, isError = false) => ({ content: [{ type: "text", text: t }], ...isError ? { isError } : {} });
|
|
45003
45003
|
var maps = /* @__PURE__ */ new Map();
|
|
45004
45004
|
async function freshMap(folder = root) {
|