mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-17 04:45:33 -08:00
Add the plan2code-app desktop app, its CI workflows and docs
AI Assisted
This commit is contained in:
1 parent
681c4a4b85
commit
a5a3a81c5f
55 files changed
+13277
No files matched your search
@@ -0,0 +1,74 @@
|
||||
// The desktop app's signal to an agent it runs: when the agent's own process
|
||||
// carries these variables, `open` shows its page inside the app window instead
|
||||
// of the system browser. Unset (every plain terminal), nothing here does anything.
|
||||
//
|
||||
// PLAN2CODE_IN_APP "1" turns it on
|
||||
// PLAN2CODE_CONSOLE_SID (optional) a session to fall back on when the app cannot be asked
|
||||
// PLAN2CODE_APP_ANNOUNCE this window's loopback URL to tell about a page
|
||||
// PLAN2CODE_APP_TOKEN the token that URL wants
|
||||
//
|
||||
// Every value belongs to one app window, so two windows never meet.
|
||||
|
||||
import http from "node:http";
|
||||
|
||||
/** The signal, or null outside the app. */
|
||||
export function inAppSignal(env = process.env) {
|
||||
if (env.PLAN2CODE_IN_APP !== "1") return null;
|
||||
return {
|
||||
sid: env.PLAN2CODE_CONSOLE_SID || "",
|
||||
announce: env.PLAN2CODE_APP_ANNOUNCE || "",
|
||||
token: env.PLAN2CODE_APP_TOKEN || "",
|
||||
};
|
||||
}
|
||||
|
||||
function request(signal, method, path, body, timeoutMs) {
|
||||
return new Promise((resolve) => {
|
||||
let target;
|
||||
try {
|
||||
target = new URL(path, signal.announce);
|
||||
} catch {
|
||||
return resolve(null);
|
||||
}
|
||||
if (target.protocol !== "http:" || !["127.0.0.1", "localhost"].includes(target.hostname)) {
|
||||
return resolve(null);
|
||||
}
|
||||
const headers = { "x-plan2code-token": signal.token };
|
||||
if (body !== undefined) {
|
||||
headers["content-type"] = "application/json";
|
||||
headers["content-length"] = Buffer.byteLength(body);
|
||||
}
|
||||
const req = http.request(target, { method, timeout: timeoutMs, headers }, (res) => {
|
||||
let text = "";
|
||||
res.on("data", (c) => (text += c));
|
||||
res.on("end", () => resolve({ status: res.statusCode, text }));
|
||||
});
|
||||
req.on("timeout", () => req.destroy());
|
||||
req.on("error", () => resolve(null));
|
||||
req.end(body);
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* The session the app's window shows right now, asked of the app: an agent's
|
||||
* environment is fixed when it starts, the window's session is not. "" when the
|
||||
* app has nothing to show yet or cannot be reached.
|
||||
*/
|
||||
export async function currentSession(signal, timeoutMs = 1500) {
|
||||
const res = await request(signal, "GET", "/session", undefined, timeoutMs);
|
||||
if (!res || res.status !== 200) return "";
|
||||
try {
|
||||
return String(JSON.parse(res.text)?.sid || "");
|
||||
} catch {
|
||||
return "";
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Tell the app which page to show. Resolves true when the app answered 2xx,
|
||||
* false on any failure (no app listening, wrong token, a timeout): the caller
|
||||
* says so and prints the URL, it never falls back to a browser.
|
||||
*/
|
||||
export async function announcePage(signal, page, timeoutMs = 1500) {
|
||||
const res = await request(signal, "POST", "/page", JSON.stringify(page), timeoutMs);
|
||||
return Boolean(res && res.status >= 200 && res.status < 300);
|
||||
}
|
||||
Reference in new issue
Block a user