Luxe 0.1.3: your sessions on your phone, joinable sessions, and nested AGENTS.md
- luxe remote puts the sessions on your computer in reach of your own phone or tablet over Tailscale: write, steer, answer prompts, send photos, browse files, diffs and GitHub, with a paired device and your own Tailscale login. - luxe join lets another program on the same machine join a running session over the RPC protocol. - An AGENTS.md in a subfolder reaches the model the first time it works there. - Long sessions stay fast: no stall before each model call, lighter memory, cheaper drawing. - A session is open in one Luxe at a time, web_search shares results across its phrasings, and a grep glob starting with ! excludes. The CHANGELOG has the full list.
This commit is contained in:
86
crates/luxe-remote/app/pending.js
Normal file
86
crates/luxe-remote/app/pending.js
Normal file
@@ -0,0 +1,86 @@
|
||||
// What's waiting: prompts waiting on you, and steering waiting to reach the agent.
|
||||
//
|
||||
// A pure fold of frames, like the transcript. Prompts come and go by id: `permission_requested`
|
||||
// and `question_asked` add one, `prompt_closed` takes it down whoever answered it. A new
|
||||
// connection starts over, since the session's snapshot sends every prompt still open.
|
||||
//
|
||||
// Steering follows the TUI's tray: a checkpoint delivers everything buffered at once, and a steer
|
||||
// that misses the last one waits for the next turn, so a turn ending leaves it pending. Only a
|
||||
// cancel or a withdrawal empties the buffer.
|
||||
|
||||
import { batch, signal } from "@preact/signals";
|
||||
|
||||
/**
|
||||
* @typedef {{ kind: "permission", id: string, tool: string, summary: string, always_patterns: string[] }} PermissionPrompt
|
||||
* @typedef {{ label: string, description?: string | null, recommended?: boolean }} QuestionOption
|
||||
* @typedef {{ kind: "question", id: string, prompt: string, options: QuestionOption[], multi: boolean }} QuestionPrompt
|
||||
* @typedef {PermissionPrompt | QuestionPrompt} Prompt
|
||||
* @typedef {{ prompts: Signal<Prompt[]>, steering: Signal<number> }} State
|
||||
*/
|
||||
/** @import { Signal } from "@preact/signals" */
|
||||
/** @import { Frame } from "./connection.js" */
|
||||
|
||||
/** Nothing waiting, and the functions that change that. */
|
||||
export function createPending() {
|
||||
/** @type {State} */
|
||||
const state = { prompts: signal([]), steering: signal(0) };
|
||||
return {
|
||||
prompts: state.prompts,
|
||||
steering: state.steering,
|
||||
/** @param {Frame} frame */
|
||||
apply: (frame) => batch(() => apply(state, frame)),
|
||||
/** This device sent a steering message. */
|
||||
steered: () => (state.steering.value += 1),
|
||||
/** This device withdrew or cancelled, which empties the engine's steering buffer. */
|
||||
dropSteering: () => (state.steering.value = 0),
|
||||
};
|
||||
}
|
||||
|
||||
/** @param {State} state @param {Frame} frame */
|
||||
function apply(state, { kind, content }) {
|
||||
switch (kind) {
|
||||
case "ready": state.prompts.value = []; state.steering.value = 0; return;
|
||||
case "permission_requested": return open(state, { kind: "permission", ...content });
|
||||
case "question_asked": return open(state, { kind: "question", ...content });
|
||||
case "prompt_closed": return close(state, content.id);
|
||||
case "steering_delivered": state.steering.value = 0; return;
|
||||
}
|
||||
}
|
||||
|
||||
/** @param {State} state @param {Prompt} prompt */
|
||||
function open(state, prompt) {
|
||||
if (state.prompts.value.some((known) => known.id === prompt.id)) return;
|
||||
state.prompts.value = [...state.prompts.value, prompt];
|
||||
}
|
||||
|
||||
/** @param {State} state @param {string} id */
|
||||
function close(state, id) {
|
||||
state.prompts.value = state.prompts.value.filter((prompt) => prompt.id !== id);
|
||||
}
|
||||
|
||||
/**
|
||||
* The reply frame for a permission prompt.
|
||||
* @param {string} id @param {string} reply @returns {Frame}
|
||||
*/
|
||||
export function permissionReply(id, reply) {
|
||||
return { kind: "respond_permission", content: { id, reply } };
|
||||
}
|
||||
|
||||
/**
|
||||
* The reply frame for a question: the chosen answers, or none for a dismissal.
|
||||
* @param {string} id @param {string[] | null} answered @returns {Frame}
|
||||
*/
|
||||
export function questionReply(id, answered) {
|
||||
return { kind: "answer_question", content: { id, reply: answered ? { answered } : "cancelled" } };
|
||||
}
|
||||
|
||||
/**
|
||||
* What the composer sends: steering for the turn running, or a new turn. Steering carries only
|
||||
* words, so a message with images is always a new turn, which waits for a running one to end.
|
||||
* @param {string} text @param {boolean} busy @param {{ data: string, mime: string, name: string | null }[]} images
|
||||
* @returns {Frame}
|
||||
*/
|
||||
export function messageFrame(text, busy, images = []) {
|
||||
if (images.length) return { kind: "submit_user_message", content: { text, images } };
|
||||
return busy ? { kind: "steer_turn", content: { text } } : { kind: "submit_user_message", content: { text } };
|
||||
}
|
||||
Reference in New Issue
Block a user