@giovannijecha/jecode 0.1.8 → 0.2.0

package/dist/tui/approve.js

@@ -4,28 +4,15 @@
 // worth more than a line of prose and a key to guess at. It is a menu — the
 // generic one — with an attention title and three answers written out.
 // Nothing is approved by a key nobody meant to press.
+import { scopeFor } from "../permissions.js";
+export { scopeFor };
 /**
- * The narrow permission represented by "always".
+ * The three answers, in the order a person actually wants them.
  *
- * File-changing tools share a grant for one displayed path. Shell grants are
- * tied to the exact command line. Unknown dangerous tools fall back to their
- * exact, stable input rather than silently inheriting a tool-wide grant.
+ * "Always" is scoped to the tool and to this session: it is a way to stop being
+ * asked about `write_file` twenty times in a row, not a setting that outlives
+ * the window it was granted in.
  */
-export function scopeFor(call) {
-    const path = typeof call.input.path === "string" ? call.input.path : undefined;
-    if ((call.name === "write_file" || call.name === "edit_file") && path !== undefined) {
-        return { key: `file\0${path}`, label: `changes to ${path}`, summary: `file changes · ${path}` };
-    }
-    const command = typeof call.input.command === "string" ? call.input.command : undefined;
-    if (call.name === "run_command" && command !== undefined) {
-        return { key: `command\0${command}`, label: "this exact command", summary: `command · ${command}` };
-    }
-    return {
-        key: `${call.name}\0${stable(call.input)}`,
-        label: "this exact call",
-        summary: `${call.name} · ${target(call.input)}`,
-    };
-}
 export function promptFor(call, target, pal) {
     const scope = scopeFor(call);
     const options = [
@@ -56,21 +43,6 @@ function scopeNoun(scope) {
         return "this command";
     return "this call";
 }
-function stable(value) {
-    if (Array.isArray(value))
-        return `[${value.map(stable).join(",")}]`;
-    if (value !== null && typeof value === "object") {
-        return `{${Object.entries(value)
-            .sort(([a], [b]) => a.localeCompare(b))
-            .map(([key, item]) => `${JSON.stringify(key)}:${stable(item)}`)
-            .join(",")}}`;
-    }
-    return JSON.stringify(value);
-}
-function target(input) {
-    const value = input.path ?? input.command;
-    return typeof value === "string" ? value : stable(input);
-}
 const ANSWERS = ["once", "always", "no"];
 /** What picking row `index` meant. Anything unrecognised refuses. */
 export function answerAt(index) {

package/dist/tui/blocks.js

@@ -1,6 +1,6 @@
 // Semantic transcript blocks routed to small, owned production components.
 import { renderAnswer, renderReasoning, renderUser } from "./components/messages.js";
-import { renderList, renderNotice } from "./components/misc.js";
+import { renderNotice } from "./components/misc.js";
 import { renderTool } from "./components/tool.js";
 export function render(block, width, pal, context = {}) {
     switch (block.kind) {
@@ -19,8 +19,6 @@ export function render(block, width, pal, context = {}) {
             });
         case "notice":
             return renderNotice(block, width, pal);
-        case "list":
-            return renderList(block, width, pal);
     }
 }
 export function renderAll(blocks, width, pal, context = {}) {

package/dist/tui/complete.js

@@ -1,9 +1,9 @@
 // Completing a slash command.
 //
-// A command the user cannot remember is a command that does not exist, and
-// `/help` only helps someone who already knows to ask. So the menu appears
-// while the line is being typed. Selection is state, not an edit: arrows move
-// through the list without rewriting what the user typed.
+// A command the user cannot remember is a command that does not exist. `/help`
+// owns keyboard controls; discovery belongs here, while the line is being
+// typed. Selection is state, not an edit: arrows move through the list without
+// rewriting what the user typed.
 import { COMMANDS } from "../commands.js";
 /**
  * The commands a half-typed line still matches.

package/dist/tui/components/menu.js

@@ -16,10 +16,11 @@ export function menuWindow(length, selected, visible) {
     return { first, last: Math.min(count, first + room) };
 }
 function renderEntry(entry, labelWidth, width, pal) {
-    // Colour terminals use one quiet selection band. In monochrome the arrow is
-    // structural rather than decorative, so selection remains unambiguous.
+    // Colour terminals use one quiet selection band and keep every label on the
+    // composer's content edge. Monochrome has no band, so it alone reserves a
+    // fixed arrow column to keep selection visible without shifting peer rows.
     const monochrome = !hasColor();
-    const selectedMark = entry.selected && monochrome ? "→ " : "  ";
+    const selectedMark = monochrome ? (entry.selected ? "→ " : "  ") : "";
     const fg = entry.selected ? pal.ink.bright : pal.ink.fg;
     const primary = [
         { text: selectedMark, fg: entry.selected ? pal.accent : fg },

package/dist/tui/components/misc.js

@@ -14,9 +14,3 @@ export function renderNotice(block, width, pal) {
         ], [], undefined, 1)),
     ];
 }
-export function renderList(block, width, pal) {
-    return [
-        "",
-        ...block.items.map((item) => row(width, [{ text: item.text, fg: item.dim ? pal.ink.muted : pal.ink.fg }], [], undefined, 1)),
-    ];
-}

package/dist/tui/components/status.js

@@ -16,15 +16,14 @@ export function renderStatus(info, pal) {
     return info.readiness === undefined ? [] : feedbackSegments(info.readiness, pal);
 }
 function feedbackSegments(feedback, pal) {
-    const mark = feedback.tone === "error" ? "×" : feedback.tone === "warn" ? "!" : "·";
-    const markColor = {
-        info: pal.accent,
-        warn: pal.ink.attention,
-        error: pal.ink.removed,
-    };
+    if (feedback.tone === "info") {
+        return [{ text: feedback.text, fg: pal.ink.muted }];
+    }
+    const mark = feedback.tone === "error" ? "×" : "!";
+    const markColor = feedback.tone === "error" ? pal.ink.removed : pal.ink.attention;
     const textColor = feedback.tone === "error" ? pal.ink.removed : pal.ink.muted;
     return [
-        { text: `${mark} `, fg: markColor[feedback.tone], bold: true },
+        { text: `${mark} `, fg: markColor, bold: true },
         { text: feedback.text, fg: textColor },
     ];
 }

package/dist/tui/feedback.js

@@ -1,5 +1,6 @@
 // Operational feedback belongs in the footer, not in the conversation.
-const INFO_MS = 2_800;
+import { providerLabel } from "../provider-label.js";
+const INFO_MS = 2_200;
 const WARN_MS = 4_200;
 const ERROR_MS = 6_000;
 /** Own replacement and expiry without leaking timers into the TUI shell. */
@@ -41,8 +42,6 @@ export function feedbackController(changed) {
 }
 /** Turn a command notice into one replaceable message in the footer status channel. */
 export function commandFeedback(block) {
-    if (block.kind !== "notice")
-        return undefined;
     return {
         text: block.text,
         tone: block.tone,
@@ -52,23 +51,26 @@ export function commandFeedback(block) {
 /** Explain why a model turn cannot start, without exposing configuration internals. */
 export function turnBlocker(session) {
     const blocked = session.provider.blocked();
-    if (blocked !== undefined && !blocked.startsWith(`${session.provider.keyVar} `)) {
+    const auth = session.provider.auth;
+    const expected = auth.kind === "api-key"
+        ? blocked?.startsWith(`${auth.keyVar} `) === true
+        : blocked !== undefined;
+    if (blocked !== undefined && !expected) {
         return { text: blocked, tone: "error" };
     }
     if (blocked !== undefined) {
         return {
-            text: `${providerName(session.provider.id)} needs an API key · /settings`,
+            text: auth.kind === "oauth"
+                ? `${providerLabel(session.provider.id)} needs ${auth.label} sign-in · /settings`
+                : `${providerLabel(session.provider.id)} needs an API key · /settings`,
             tone: "warn",
         };
     }
     if (session.model === "") {
         return {
-            text: `${providerName(session.provider.id)} needs a model · /models`,
+            text: `${providerLabel(session.provider.id)} needs a model · /models`,
             tone: "warn",
         };
     }
     return undefined;
 }
-function providerName(id) {
-    return id === "" ? "Provider" : `${id[0]?.toUpperCase() ?? ""}${id.slice(1)}`;
-}

package/dist/tui/help.js

@@ -0,0 +1,29 @@
+// The compact, non-persistent keyboard reference shown inside the dock.
+import { row } from "../ui/render.js";
+import { textWidth } from "../ui/width.js";
+const CONTROL_WIDTH = 18;
+const CONTROLS = [
+    { key: "up / down", description: "move through menus or history" },
+    { key: "enter / tab", description: "select or send · complete" },
+    { key: "alt+enter", description: "insert a new line" },
+    { key: "esc", description: "close UI or interrupt work" },
+    { key: "ctrl+c", description: "interrupt work or exit" },
+    { key: "ctrl+o", description: "toggle reasoning or tool details" },
+    { key: "wheel / pgup/dn", description: "scroll the transcript" },
+    { key: "ctrl+l", description: "redraw the screen" },
+];
+export function panel(width, pal, maxRows = CONTROLS.length + 1) {
+    const heading = row(width, [
+        { text: "help  ", fg: pal.accent, bold: true },
+        { text: "keyboard controls", fg: pal.ink.fg },
+    ], [{ text: "esc close", fg: pal.ink.muted }]);
+    const controls = CONTROLS.map((control) => {
+        const gap = Math.max(2, CONTROL_WIDTH - textWidth(control.key));
+        return row(width, [
+            { text: control.key, fg: pal.ink.bright, bold: true },
+            { text: " ".repeat(gap) },
+            { text: control.description, fg: pal.ink.muted },
+        ]);
+    });
+    return [heading, ...controls].slice(0, Math.max(1, maxRows));
+}

package/dist/tui/modal.js

@@ -1,17 +1,23 @@
 // What can take the dock over, and how it draws.
 //
-// Two kinds, and the union exists so that everything between the command that
+// Three kinds, and the union exists so that everything between the command that
 // opens one and the frame that draws it — the view, the shell, the key handler
-// — speaks about "the thing that is open" rather than about a picker and a
-// field separately. A third kind would be added here and nowhere else.
+// — speaks about "the thing that is open" rather than about each interaction
+// separately.
 import * as picker from "./picker.js";
 import * as field from "./field.js";
+import * as help from "./help.js";
 export function panel(modal, width, pal, maxRows) {
-    return modal.kind === "pick"
-        ? picker.panel(modal.picker, width, pal, maxRows)
-        : maxRows === undefined
-            ? field.panel(modal.field, width, pal)
-            : field.panel(modal.field, width, pal).slice(0, maxRows);
+    switch (modal.kind) {
+        case "pick":
+            return picker.panel(modal.picker, width, pal, maxRows);
+        case "type":
+            return maxRows === undefined
+                ? field.panel(modal.field, width, pal)
+                : field.panel(modal.field, width, pal).slice(0, maxRows);
+        case "help":
+            return help.panel(width, pal, maxRows);
+    }
 }
 /**
  * Where the caret goes while this is open, if it goes anywhere.
@@ -20,7 +26,12 @@ export function panel(modal, width, pal, maxRows) {
  * query prompt and place the terminal caret at its real editing position.
  */
 export function caret(modal, width, maxRows) {
-    return modal.kind === "type"
-        ? field.caret(modal.field, width)
-        : picker.caret(modal.picker, width, maxRows);
+    switch (modal.kind) {
+        case "pick":
+            return picker.caret(modal.picker, width, maxRows);
+        case "type":
+            return field.caret(modal.field, width);
+        case "help":
+            return undefined;
+    }
 }

package/dist/tui/overlay.js

@@ -1,16 +1,23 @@
-// The modal interaction layer: one picker or one single-line field.
+// The modal interaction layer: a picker, a single-line field, or read-only help.
 import * as picker from "./picker.js";
 import { oneLine } from "./field.js";
 import { applyKey } from "./input.js";
 export function shown(open) {
     if (open === undefined)
         return undefined;
-    return "picker" in open ? { kind: "pick", picker: open.picker } : { kind: "type", field: open.field };
+    if ("picker" in open)
+        return { kind: "pick", picker: open.picker };
+    if ("field" in open)
+        return { kind: "type", field: open.field };
+    return { kind: "help" };
 }
 export function cancel(open) {
     if (open === undefined)
         return undefined;
-    open.settle(undefined);
+    if ("help" in open)
+        open.settle();
+    else
+        open.settle(undefined);
     return undefined;
 }
 export function handle(open, key) {
@@ -26,7 +33,11 @@ export function handle(open, key) {
         cancel(open);
         return {};
     }
-    return "picker" in open ? handlePicker(open, key) : handleField(open, key);
+    if ("picker" in open)
+        return handlePicker(open, key);
+    if ("field" in open)
+        return handleField(open, key);
+    return { open };
 }
 function handlePicker(open, key) {
     switch (key.name) {

package/dist/tui/picker.js

@@ -64,7 +64,7 @@ function layout(picker, width, pal, maxRows) {
     const options = colors === undefined
         ? []
         : shown.length === 0
-            ? [row(width, [{ text: "  no matches", fg: colors.ink.muted }])]
+            ? [row(width, [{ text: "no matches", fg: colors.ink.muted }])]
             : renderMenuRows(shown.map(({ option, index }) => ({
                 label: option.label,
                 hint: option.hint,

package/dist/tui/session-view.js

@@ -1,10 +1,10 @@
 // Small projections of the live session used by the shell and footer.
 import { credentialSource } from "../credentials.js";
 import { providerFailure } from "../provider-errors.js";
-export function controllerOptions(session) {
+export function controllerOptions(session, tools = session.tools) {
     return {
         provider: session.provider,
-        tools: session.tools,
+        tools,
         model: session.model,
         system: session.system,
         maxTokens: session.config.maxTokens,
@@ -26,10 +26,16 @@ export function turnFailure(session, error, aborted) {
         return { kind: "notice", text: "[interrupted]", tone: "warn" };
     let text = providerFailure(session.provider, error);
     if (/\b401\b/.test(text)) {
-        const source = credentialSource(session.provider.keyVar);
-        text += source === "environment"
-            ? ` · update ${session.provider.keyVar} in the environment and restart`
-            : " · check credentials with /settings";
+        const auth = session.provider.auth;
+        if (auth.kind === "oauth") {
+            text += ` · reconnect ${auth.label} in /settings`;
+        }
+        else {
+            const source = credentialSource(auth.keyVar);
+            text += source === "environment"
+                ? ` · update ${auth.keyVar} in the environment and restart`
+                : " · check credentials with /settings";
+        }
     }
     return { kind: "notice", text, tone: "error" };
 }

package/dist/version.js

@@ -0,0 +1,14 @@
+// The package version is runtime identity, not configuration.
+import { readFileSync } from "node:fs";
+import * as path from "node:path";
+let cached;
+export function applicationVersion() {
+    if (cached !== undefined)
+        return cached;
+    const manifest = JSON.parse(readFileSync(path.resolve(import.meta.dirname, "..", "package.json"), "utf8"));
+    if (typeof manifest.version !== "string" || manifest.version === "") {
+        throw new Error("package version is missing");
+    }
+    cached = manifest.version;
+    return cached;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giovannijecha/jecode",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "An owned coding agent with zero external runtime dependencies.",
   "license": "MIT",
   "repository": {
@@ -16,12 +16,16 @@
     "terminal",
     "tui",
     "ollama",
+    "openai",
+    "chatgpt",
+    "oauth",
     "typescript"
   ],
   "type": "module",
   "files": [
     "bin/",
     "dist/",
+    "docs/assets/brand/jeco-256.png",
     "LICENSE",
     "README.md"
   ],