gnosys 5.4.3 → 5.6.0

package/dist/lib/audioExtract.d.ts

@@ -32,7 +32,7 @@ export interface TranscriptionOptions {
  * 1. If `options.provider` is specified, use that provider
  * 2. Try Groq (if GNOSYS_GROQ_KEY or GROQ_API_KEY is set)
  * 3. Try OpenAI (if GNOSYS_OPENAI_KEY or OPENAI_API_KEY is set)
- * 4. Try local Whisper (if @xenova/transformers is installed)
+ * 4. Try local Whisper (if @huggingface/transformers is installed)
  * 5. Throw an error with setup instructions
  */
 export declare function transcribeAudio(filePath: string, options?: TranscriptionOptions): Promise<TranscriptResult>;

package/dist/lib/audioExtract.js

@@ -71,13 +71,13 @@ async function transcribeWithOpenAI(audioBuffer, fileName, mimeType, apiKey, opt
 async function transcribeWithLocal(filePath, options) {
     let pipeline;
     try {
-        // Dynamic import — @xenova/transformers is an optional dependency
-        const transformers = await import("@xenova/transformers");
+        // Dynamic import — @huggingface/transformers is an optional dependency
+        const transformers = await import("@huggingface/transformers");
         pipeline = transformers.pipeline;
     }
     catch {
-        throw new Error("Local Whisper transcription requires @xenova/transformers. " +
-            'Install it with: npm install @xenova/transformers\n' +
+        throw new Error("Local Whisper transcription requires @huggingface/transformers. " +
+            'Install it with: npm install @huggingface/transformers\n' +
             "Or set a Groq/OpenAI API key for cloud transcription.");
     }
     const modelName = options?.model || "Xenova/whisper-small";
@@ -162,7 +162,7 @@ function resolveOpenAIKey(options) {
  * 1. If `options.provider` is specified, use that provider
  * 2. Try Groq (if GNOSYS_GROQ_KEY or GROQ_API_KEY is set)
  * 3. Try OpenAI (if GNOSYS_OPENAI_KEY or OPENAI_API_KEY is set)
- * 4. Try local Whisper (if @xenova/transformers is installed)
+ * 4. Try local Whisper (if @huggingface/transformers is installed)
  * 5. Throw an error with setup instructions
  */
 export async function transcribeAudio(filePath, options) {
@@ -214,7 +214,7 @@ export async function transcribeAudio(filePath, options) {
     throw new Error("No transcription provider available. Set up one of:\n" +
         "  1. Groq API key: export GROQ_API_KEY=your-key  (cheapest, $0.02/hr)\n" +
         "  2. OpenAI API key: export OPENAI_API_KEY=your-key\n" +
-        "  3. Local Whisper: npm install @xenova/transformers\n" +
+        "  3. Local Whisper: npm install @huggingface/transformers\n" +
         "Or set multimodal.transcriptionProvider in gnosys.json.");
 }
 //# sourceMappingURL=audioExtract.js.map

package/dist/lib/audioExtract.js.map

@@ -1 +1 @@
-{"version":3,"file":"audioExtract.js","sourceRoot":"","sources":["../../src/lib/audioExtract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audioExtract.js","sourceRoot":"","sources":["../../src/lib/audioExtract.ts"],"names":[],"mappings":"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"}

package/dist/lib/chat/choose.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Multi-choice protocol — gnosys-choose fenced YAML.
+ *
+ * The LLM is taught (via system prompt) to emit a fenced block when it wants
+ * the user to pick from a small set of options:
+ *
+ *   ```gnosys-choose
+ *   prompt: Which approach should we take?
+ *   options:
+ *     - id: a
+ *       label: Refactor in place — keep the same module
+ *       detail: Lower risk, but the existing API stays awkward
+ *     - id: b
+ *       label: Extract to a new module
+ *       detail: Cleaner separation; one-time migration cost
+ *   ```
+ *
+ * The TUI parses the fence after the assistant turn completes, renders an
+ * arrow-key selectable list, and on selection injects a synthetic user turn
+ * "[picked: <id> — <label>]" before running the next LLM call.
+ *
+ * The protocol works in reverse too — TUI helpers can pose multiple-choice
+ * questions to the user using the same parser/renderer pieces.
+ *
+ * Failures are soft: a malformed fence renders as plain text in the
+ * conversation buffer. We log a `chat_choose_parse_error` style notice so
+ * agents can debug without blocking the chat.
+ */
+export interface ChooseOption {
+    id: string;
+    label: string;
+    detail?: string;
+}
+export interface ChooseBlock {
+    prompt: string;
+    options: ChooseOption[];
+}
+/** System prompt addendum that teaches the LLM the fence syntax. */
+export declare const CHOOSE_SYSTEM_PROMPT_ADDENDUM = "\nWhen you want the user to pick from a SHORT set of options (2\u20136), emit a fenced block:\n\n```gnosys-choose\nprompt: <one-line question>\noptions:\n  - id: a\n    label: <short>\n    detail: <one-line context, optional>\n  - id: b\n    label: <short>\n```\n\nUse this only when a discrete choice will materially change what you do next. Don't use it for yes/no \u2014 just ask in prose. Don't use it to summarize options that the user has already chosen between.";
+/**
+ * Find the first gnosys-choose fence in a text and parse it. Returns
+ *   - { block, before, after } when a well-formed fence is present
+ *   - { error } when a fence exists but failed to parse
+ *   - null when no fence is present
+ */
+export type ExtractResult = {
+    kind: "ok";
+    block: ChooseBlock;
+    before: string;
+    after: string;
+} | {
+    kind: "parse-error";
+    before: string;
+    rawFence: string;
+    after: string;
+    reason: string;
+} | null;
+export declare function extractChooseFence(text: string): ExtractResult;
+/**
+ * Hand-rolled YAML parser for the minimal gnosys-choose schema.
+ * No external dependency. Tolerates Windows line endings and trailing whitespace.
+ *
+ * Accepts:
+ *   prompt: <text>           # one-line scalar
+ *   options:                 # list literal follows
+ *     - id: <token>
+ *       label: <text>
+ *       detail: <text>       # optional
+ *     - id: <token>
+ *       label: <text>
+ */
+export declare function parseChooseYaml(yaml: string): ChooseBlock;
+/** Format a user's selection as a synthetic user turn. */
+export declare function formatSelection(option: ChooseOption): string;
+//# sourceMappingURL=choose.d.ts.map

package/dist/lib/chat/choose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choose.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/choose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,oEAAoE;AACpE,eAAO,MAAM,6BAA6B,ydAa6J,CAAC;AAIxM;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxF,IAAI,CAAC;AAET,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA+B9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAsDzD;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG5D"}

package/dist/lib/chat/choose.js

@@ -0,0 +1,146 @@
+/**
+ * Multi-choice protocol — gnosys-choose fenced YAML.
+ *
+ * The LLM is taught (via system prompt) to emit a fenced block when it wants
+ * the user to pick from a small set of options:
+ *
+ *   ```gnosys-choose
+ *   prompt: Which approach should we take?
+ *   options:
+ *     - id: a
+ *       label: Refactor in place — keep the same module
+ *       detail: Lower risk, but the existing API stays awkward
+ *     - id: b
+ *       label: Extract to a new module
+ *       detail: Cleaner separation; one-time migration cost
+ *   ```
+ *
+ * The TUI parses the fence after the assistant turn completes, renders an
+ * arrow-key selectable list, and on selection injects a synthetic user turn
+ * "[picked: <id> — <label>]" before running the next LLM call.
+ *
+ * The protocol works in reverse too — TUI helpers can pose multiple-choice
+ * questions to the user using the same parser/renderer pieces.
+ *
+ * Failures are soft: a malformed fence renders as plain text in the
+ * conversation buffer. We log a `chat_choose_parse_error` style notice so
+ * agents can debug without blocking the chat.
+ */
+/** System prompt addendum that teaches the LLM the fence syntax. */
+export const CHOOSE_SYSTEM_PROMPT_ADDENDUM = `
+When you want the user to pick from a SHORT set of options (2–6), emit a fenced block:
+
+\`\`\`gnosys-choose
+prompt: <one-line question>
+options:
+  - id: a
+    label: <short>
+    detail: <one-line context, optional>
+  - id: b
+    label: <short>
+\`\`\`
+
+Use this only when a discrete choice will materially change what you do next. Don't use it for yes/no — just ask in prose. Don't use it to summarize options that the user has already chosen between.`;
+const FENCE_OPEN = /```\s*gnosys-choose\s*\n([\s\S]*?)```/;
+export function extractChooseFence(text) {
+    const match = text.match(FENCE_OPEN);
+    if (!match)
+        return null;
+    const fenceContent = match[1].trim();
+    const start = match.index ?? 0;
+    const end = start + match[0].length;
+    const before = text.slice(0, start).trimEnd();
+    const after = text.slice(end).trimStart();
+    try {
+        const block = parseChooseYaml(fenceContent);
+        if (!block.prompt || block.options.length === 0) {
+            return {
+                kind: "parse-error",
+                before,
+                rawFence: match[0],
+                after,
+                reason: "missing prompt or empty options",
+            };
+        }
+        return { kind: "ok", block, before, after };
+    }
+    catch (err) {
+        return {
+            kind: "parse-error",
+            before,
+            rawFence: match[0],
+            after,
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Hand-rolled YAML parser for the minimal gnosys-choose schema.
+ * No external dependency. Tolerates Windows line endings and trailing whitespace.
+ *
+ * Accepts:
+ *   prompt: <text>           # one-line scalar
+ *   options:                 # list literal follows
+ *     - id: <token>
+ *       label: <text>
+ *       detail: <text>       # optional
+ *     - id: <token>
+ *       label: <text>
+ */
+export function parseChooseYaml(yaml) {
+    const lines = yaml.replace(/\r\n/g, "\n").split("\n");
+    let prompt = "";
+    const options = [];
+    let inOptions = false;
+    let current = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.trim())
+            continue;
+        // Top-level "prompt:" line
+        if (!inOptions) {
+            const m = line.match(/^prompt:\s*(.+?)\s*$/);
+            if (m) {
+                prompt = m[1];
+                continue;
+            }
+            if (/^options:\s*$/.test(line)) {
+                inOptions = true;
+                continue;
+            }
+            // Unknown top-level field — skip (forward-compat)
+            continue;
+        }
+        // Inside options:
+        const itemStart = line.match(/^\s*-\s*id:\s*(.+?)\s*$/);
+        if (itemStart) {
+            // Push previous item if any
+            if (current && current.label)
+                options.push(current);
+            current = { id: itemStart[1], label: "" };
+            continue;
+        }
+        if (!current)
+            continue;
+        const labelMatch = line.match(/^\s*label:\s*(.+?)\s*$/);
+        if (labelMatch) {
+            current.label = labelMatch[1];
+            continue;
+        }
+        const detailMatch = line.match(/^\s*detail:\s*(.+?)\s*$/);
+        if (detailMatch) {
+            current.detail = detailMatch[1];
+            continue;
+        }
+    }
+    // Flush the last option
+    if (current && current.label)
+        options.push(current);
+    return { prompt, options };
+}
+/** Format a user's selection as a synthetic user turn. */
+export function formatSelection(option) {
+    const detail = option.detail ? ` (${option.detail})` : "";
+    return `[picked: ${option.id} — ${option.label}${detail}]`;
+}
+//# sourceMappingURL=choose.js.map

package/dist/lib/chat/choose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choose.js","sourceRoot":"","sources":["../../../src/lib/chat/choose.ts"],"names":[],"mappings":"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"}

package/dist/lib/chat/commands.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Slash command dispatcher for the chat TUI.
+ *
+ * Each command receives the chat state and returns a result describing what
+ * happened. The TUI translates the result into UI updates (system messages,
+ * exit, conversation buffer changes, etc.). Commands run synchronously when
+ * possible; async ones return a Promise.
+ *
+ * Phase 2 commands: /help, /clear, /history, /read, /list, /tags, /dashboard,
+ * /quit, /provider. Phases 3–7 add /pin, /scope, /recall, /threshold,
+ * /reinforce, /remember, /save-turn, /attach, /focus, /branch, /resume-focus,
+ * /dream-here, /search-chats, /export.
+ */
+import { Turn } from "./types.js";
+export interface CommandContext {
+    /** Current session ID. */
+    sessionId: string;
+    /** Conversation buffer as the LLM sees it. Commands may read or mutate (via the result's nextBuffer). */
+    buffer: Turn[];
+    /** Current provider name. */
+    provider: string;
+    /** Current model. */
+    model: string;
+}
+export type CommandResult = {
+    kind: "ok";
+    message?: string;
+} | {
+    kind: "clear-buffer";
+} | {
+    kind: "exit";
+} | {
+    kind: "switch-provider";
+    provider: string;
+    model?: string;
+} | {
+    kind: "show";
+    lines: string[];
+} | {
+    kind: "pin";
+    memoryId: string;
+} | {
+    kind: "unpin";
+    memoryId: string;
+} | {
+    kind: "scope";
+    scope: "project" | "user" | "global" | "federated";
+} | {
+    kind: "threshold";
+    value: number;
+} | {
+    kind: "preview-recall";
+    query: string;
+} | {
+    kind: "reinforce";
+    memoryId: string;
+} | {
+    kind: "remember";
+    text: string;
+} | {
+    kind: "save-turn";
+} | {
+    kind: "attach";
+    filePath: string;
+} | {
+    kind: "focus";
+    topic: string;
+} | {
+    kind: "branch";
+} | {
+    kind: "resume-focus";
+    topic?: string;
+} | {
+    kind: "export-session";
+    filePath: string;
+} | {
+    kind: "search-chats";
+    query: string;
+} | {
+    kind: "dream-here";
+} | {
+    kind: "error";
+    message: string;
+};
+export interface CommandSpec {
+    name: string;
+    aliases?: string[];
+    summary: string;
+    usage?: string;
+    handler: (ctx: CommandContext, args: string[]) => CommandResult | Promise<CommandResult>;
+}
+export declare function listCommands(): CommandSpec[];
+export declare function findCommand(name: string): CommandSpec | undefined;
+/** Parse a raw input line and dispatch if it's a slash command. Returns null if it's not a command. */
+export declare function dispatchCommand(raw: string, ctx: CommandContext): Promise<CommandResult | null>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/lib/chat/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/lib/chat/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,yGAAyG;IACzG,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1F;AA0VD,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAE5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAOjE;AAED,uGAAuG;AACvG,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAa/B"}