@staix/agent-hub 0.12.23 → 0.12.24

package/src/pet/config.ts

@@ -0,0 +1,31 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { characterId, type CharacterId, type PetSize, type PetGlyphs } from "./frame.ts";
+
+export interface PetConfig { enabled: boolean; blink: boolean; bell: boolean; character?: CharacterId; size?: PetSize; glyphs?: PetGlyphs; notice?: string }
+/** Console-local presentation only; this reader never writes config or grants authority. */
+export function loadPetConfig(cwd: string): PetConfig {
+  let value: unknown;
+  for (const name of ["config.json", "config.local.json"]) {
+    try {
+      const file = JSON.parse(readFileSync(join(cwd, ".agenthub", name), "utf8"));
+      if (file.pet !== undefined) value = value && typeof value === "object" && file.pet && typeof file.pet === "object" ? { ...value, ...file.pet } : file.pet;
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
+    }
+  }
+  if (value === false) return { enabled: false, blink: true, bell: false };
+  const defaults = { enabled: true, blink: true, bell: false };
+  if (value === undefined) return defaults;
+  if (!value || typeof value !== "object" || Array.isArray(value)) return { ...defaults, notice: "Unknown pet configuration; using stai line defaults." };
+  const row = value as Record<string, unknown>;
+  const invalid = Object.keys(row).some(key => !["character", "size", "glyphs", "blink", "bell"].includes(key)) ||
+    row.character !== undefined && !characterId(row.character) || row.size !== undefined && !["line", "mini", "full"].includes(row.size as string) ||
+    row.glyphs !== undefined && (typeof row.glyphs !== "string" || !["auto", "ascii", "blocks"].includes(row.glyphs)) ||
+    row.blink !== undefined && typeof row.blink !== "boolean" || row.bell !== undefined && typeof row.bell !== "boolean";
+  return { enabled: true, blink: typeof row.blink === "boolean" ? row.blink : true, bell: typeof row.bell === "boolean" ? row.bell : false,
+    ...(characterId(row.character) && row.character !== "stai" ? { character: row.character } : {}),
+    ...(row.size === "mini" || row.size === "full" ? { size: row.size } : {}),
+    ...(row.glyphs === "ascii" || row.glyphs === "blocks" ? { glyphs: row.glyphs } : {}),
+    ...(invalid ? { notice: "Unknown pet option; using stai line defaults for that option." } : {}) };
+}

package/src/pet/frame.ts

@@ -0,0 +1,17 @@
+import { CHARACTERS, CHARACTER_IDS, type CharacterId, type PetGlyphs, type PetPose, type PetSize } from "./characters.ts";
+export { CHARACTERS, CHARACTER_IDS };
+export type { CharacterId, PetGlyphs, PetPose, PetSize };
+export function characterId(value: unknown): value is CharacterId { return typeof value === "string" && (CHARACTER_IDS as readonly string[]).includes(value); }
+export function petSize(requested: PetSize = "line", columns: number, rows: number): PetSize {
+  if (requested === "full" && columns >= 100 && rows >= 40) return "full";
+  return requested !== "line" && columns >= 100 ? "mini" : "line";
+}
+export function petGlyphs(requested: PetGlyphs = "auto", env: Record<string, string | undefined> = process.env): "ascii" | "blocks" {
+  const locale = env.LC_ALL || env.LC_CTYPE || env.LANG || "";
+  return requested !== "ascii" && /utf-?8/i.test(locale) && !!env.TERM && !["dumb", "linux"].includes(env.TERM) ? "blocks" : "ascii";
+}
+export function petFrame(character: CharacterId = "stai", pose: PetPose, size: PetSize = "line", glyphs: "ascii" | "blocks" = "ascii"): readonly string[] {
+  return CHARACTERS[character].frames[glyphs][pose][size];
+}
+/** A full footer reserves the catalog maximum, independent of state and session character cycling. */
+export function petFooterRows(size: PetSize): number { return size === "full" ? 9 : 4; }

package/src/pet/pixels.ts

@@ -0,0 +1,28 @@
+/** Self-contained glyph pixels for the shared literal frame data; browser injection needs no font/image decoder. */
+export function petPixels(frame: readonly string[]): { width: number; height: number; pixels: [number, number][] } {
+  const font: Record<string, string[]> = {
+    O:["01110","10001","10001","10001","10001","10001","01110"],
+    o:["00000","00000","01110","10001","10001","01110","00000"],
+    X:["10001","10001","01010","00100","01010","10001","10001"],
+    S:["01111","10000","10000","01110","00001","00001","11110"],
+    T:["11111","00100","00100","00100","00100","00100","00100"],
+    A:["01110","10001","10001","11111","10001","10001","10001"],
+    I:["11111","00100","00100","00100","00100","00100","11111"],
+    ">": ["10000","01000","00100","00010","00100","01000","10000"],
+    "<": ["00001","00010","00100","01000","00100","00010","00001"],
+    "^": ["00100","01010","10001"],
+    "~": ["00000","01001","10110"],
+    "/": ["00001","00001","00010","00100","01000","10000","10000"],
+    "\\": ["10000","10000","01000","00100","00010","00001","00001"],
+    "-": ["00000","00000","00000","11111"],
+    "'": ["00100","00100"],
+  };
+  const pixels: [number, number][] = [];
+  for (const [row, text] of frame.entries()) for (const [column, glyph] of [...text].entries()) {
+    for (let y=0;y<8;y++) for (let x=0;x<5;x++) {
+      const on = glyph === "█" || glyph === "▀" && y<4 || glyph === "▄" && y>=4 || glyph === "▟" && (y>=4 || x>=2) || glyph === "▙" && (y>=4 || x<3) || font[glyph]?.[y]?.[x] === "1";
+      if (on) pixels.push([column*5+x,row*8+y]);
+    }
+  }
+  return { width: Math.max(0,...frame.map(row=>[...row].length))*5, height: frame.length*8, pixels };
+}

package/src/role-text.d.ts

@@ -0,0 +1 @@
+declare module "*.md" { const text: string; export default text; }