@namzu/cli 29.1.0 → 32.0.0

package/dist/tui/triggers/pattern.js

@@ -0,0 +1,243 @@
+/**
+ * The phrase language of composer triggers, compiled to a token automaton.
+ *
+ *   word          one token, matched after folding (`fold.ts`)
+ *   (a|b c)       one of the alternatives; an alternative may be several words
+ *   [a|b]         optional: one of the alternatives, or nothing
+ *   <n>           a run of digits
+ *   word+'        `word` itself, or `word` with an apostrophe suffix: `skill'e`
+ *   {verb|verb}   any positive request form of the verbs, from `verbs.ts`
+ *
+ * No `RegExp` is ever built from a pattern: a pattern compiles to a small
+ * nondeterministic automaton over tokens, and matching simulates it. The
+ * simulation counts its steps so a test can bound the cost on a long draft
+ * without reading a clock.
+ */
+import { fold } from './fold.js';
+import { QUESTION_PARTICLES, verbForms } from './verbs.js';
+/** Flags a verb form carries into the match it ends. */
+export const FORM_POLITE = 1;
+export const FORM_OPTATIVE = 2;
+export class PatternError extends Error {
+    constructor(source, reason) {
+        super(`Trigger phrase "${source}": ${reason}`);
+        this.name = 'PatternError';
+    }
+}
+export function compilePattern(source) {
+    const node = parse(source);
+    const states = [];
+    const state = () => {
+        states.push({ edges: [], empty: [] });
+        return states.length - 1;
+    };
+    const build = (current, from) => {
+        switch (current.kind) {
+            case 'atom': {
+                const to = state();
+                states[from]?.edges.push({ atom: current.atom, to, flags: 0 });
+                return to;
+            }
+            case 'sequence': {
+                let at = from;
+                for (const item of current.items)
+                    at = build(item, at);
+                return at;
+            }
+            case 'choice': {
+                const out = state();
+                for (const option of current.options) {
+                    const end = build(option, from);
+                    states[end]?.empty.push(out);
+                }
+                if (current.optional)
+                    states[from]?.empty.push(out);
+                return out;
+            }
+            case 'verb': {
+                const out = state();
+                for (const verb of current.verbs) {
+                    for (const form of verbForms(verb)) {
+                        let at = from;
+                        form.tokens.forEach((word, index) => {
+                            const to = index === form.tokens.length - 1 ? out : state();
+                            const flags = index === form.tokens.length - 1
+                                ? (form.polite ? FORM_POLITE : 0) | (form.optative ? FORM_OPTATIVE : 0)
+                                : 0;
+                            states[at]?.edges.push({ atom: { kind: 'word', text: word }, to, flags });
+                            at = to;
+                        });
+                    }
+                }
+                return out;
+            }
+        }
+    };
+    const start = state();
+    const accept = build(node, start);
+    const compiled = { source, states, start, accept, firstWords: null };
+    return { ...compiled, firstWords: firstWords(compiled) };
+}
+function firstWords(pattern) {
+    const words = new Set();
+    for (const index of closure(pattern.states, [pattern.start])) {
+        for (const edge of pattern.states[index]?.edges ?? []) {
+            if (edge.atom.kind !== 'word')
+                return null;
+            words.add(edge.atom.text);
+        }
+    }
+    return words;
+}
+function closure(states, seeds) {
+    const seen = new Set(seeds);
+    const stack = [...seeds];
+    while (stack.length > 0) {
+        const index = stack.pop();
+        for (const next of states[index]?.empty ?? []) {
+            if (seen.has(next))
+                continue;
+            seen.add(next);
+            stack.push(next);
+        }
+    }
+    return seen;
+}
+function atomMatches(atom, token) {
+    switch (atom.kind) {
+        case 'word':
+            return token === atom.text;
+        case 'number':
+            return /^\d+$/u.test(token);
+        case 'suffix':
+            return token === atom.base || token.startsWith(`${atom.base}'`);
+    }
+}
+/**
+ * Every match of `pattern` that starts at token `start`, longest first. A
+ * question particle (`mi`, `mu`) right after a match extends it by one token.
+ */
+export function matchAt(pattern, tokens, start, stats) {
+    const first = tokens[start];
+    if (first === undefined)
+        return [];
+    if (pattern.firstWords && !pattern.firstWords.has(first)) {
+        if (stats)
+            stats.steps += 1;
+        return [];
+    }
+    const found = [];
+    // A thread is a state and the flags of the forms it has read.
+    let threads = new Map();
+    for (const state of closure(pattern.states, [pattern.start]))
+        threads.set(`${state}:0`, { state, flags: 0 });
+    for (let at = start; at < tokens.length && threads.size > 0; at += 1) {
+        const token = tokens[at];
+        const next = new Map();
+        for (const thread of threads.values()) {
+            for (const edge of pattern.states[thread.state]?.edges ?? []) {
+                if (stats)
+                    stats.steps += 1;
+                if (!atomMatches(edge.atom, token))
+                    continue;
+                const flags = thread.flags | edge.flags;
+                for (const state of closure(pattern.states, [edge.to]))
+                    next.set(`${state}:${flags}`, { state, flags });
+            }
+        }
+        threads = next;
+        for (const thread of threads.values()) {
+            if (thread.state !== pattern.accept)
+                continue;
+            const end = at + 1;
+            const particle = tokens[end];
+            found.push({
+                start,
+                end: particle !== undefined && QUESTION_PARTICLES.has(particle) ? end + 1 : end,
+                flags: thread.flags,
+            });
+        }
+    }
+    return found.sort((a, b) => b.end - a.end);
+}
+// ---------------------------------------------------------------------------
+// parsing
+function parse(source) {
+    const text = source.trim();
+    let index = 0;
+    const fail = (reason) => {
+        throw new PatternError(source, reason);
+    };
+    const skipSpace = () => {
+        while (text[index] === ' ')
+            index += 1;
+    };
+    const sequence = (closers) => {
+        const items = [];
+        for (;;) {
+            skipSpace();
+            const char = text[index];
+            if (char === undefined || closers.includes(char))
+                break;
+            if (char === '(' || char === '[') {
+                index += 1;
+                const options = alternatives(char === '(' ? ')' : ']');
+                items.push({ kind: 'choice', options, optional: char === '[' });
+                continue;
+            }
+            if (char === '{') {
+                const close = text.indexOf('}', index);
+                if (close < 0)
+                    fail('an unclosed {');
+                const verbs = text
+                    .slice(index + 1, close)
+                    .split('|')
+                    .map((verb) => fold(verb.trim()));
+                if (verbs.some((verb) => verb.length === 0))
+                    fail('an empty verb in {}');
+                items.push({ kind: 'verb', verbs });
+                index = close + 1;
+                continue;
+            }
+            if (text.startsWith('<n>', index)) {
+                items.push({ kind: 'atom', atom: { kind: 'number' } });
+                index += 3;
+                continue;
+            }
+            let end = index;
+            while (end < text.length && !' ()[]{}|<'.includes(text[end]))
+                end += 1;
+            const raw = text.slice(index, end);
+            if (raw.length === 0)
+                fail(`an unexpected "${char}"`);
+            index = end;
+            if (raw.endsWith("+'")) {
+                items.push({ kind: 'atom', atom: { kind: 'suffix', base: fold(raw.slice(0, -2)) } });
+                continue;
+            }
+            const word = fold(raw);
+            if (!/^[\p{L}\p{N}_]+(?:'[\p{L}\p{N}_]+)*$/u.test(word))
+                fail(`"${raw}" is not one word`);
+            items.push({ kind: 'atom', atom: { kind: 'word', text: word } });
+        }
+        if (items.length === 0)
+            fail('an empty alternative');
+        return items.length === 1 ? items[0] : { kind: 'sequence', items };
+    };
+    const alternatives = (closer) => {
+        const options = [sequence(`|${closer}`)];
+        while (text[index] === '|') {
+            index += 1;
+            options.push(sequence(`|${closer}`));
+        }
+        if (text[index] !== closer)
+            fail(`a missing ${closer}`);
+        index += 1;
+        return options;
+    };
+    const node = sequence('');
+    if (index < text.length)
+        fail(`an unexpected "${text[index]}"`);
+    return node;
+}
+//# sourceMappingURL=pattern.js.map

package/dist/tui/triggers/pattern.js.map

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

package/dist/tui/triggers/provenance.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Where the characters of a composer draft came from, kept as the spans that
+ * were NOT typed one key at a time here, and moved along with every edit.
+ *
+ * Only a human keystroke in this composer arms a trigger. A paste, a burst
+ * of input that arrives as one chunk (a paste without bracketed-paste
+ * markers looks exactly like that), a recalled or restored prompt, text from
+ * the external editor, a yank and an accepted completion are all text the
+ * operator did not type here, so a trigger in them is only suggested; Alt+W
+ * arms it.
+ *
+ * Pure: the Composer owns the state and calls these on each edit.
+ */
+export type EditOrigin = 'typed' | 'burst' | 'pasted' | 'recalled' | 'restored' | 'editor' | 'yank' | 'completion';
+/** `[start, end)` in UTF-16 code units of the draft. */
+export type Span = readonly [number, number];
+export interface Edit {
+    /** Where the replaced stretch starts in the previous draft. */
+    readonly start: number;
+    /** Where it ends in the previous draft. */
+    readonly deleteEnd: number;
+    /** How many code units replaced it. */
+    readonly insertLength: number;
+}
+/**
+ * The single replacement that turns `previous` into `next`. The shared
+ * prefix is capped at `cursor` — the cursor before the edit, where every
+ * composer edit starts or ends — so an edit inside a run of identical
+ * characters is placed where it actually happened.
+ */
+export declare function diffEdit(previous: string, next: string, cursor: number): Edit;
+/**
+ * Move the non-typed spans through one edit, adding the inserted text unless
+ * it was typed. A span the edit cuts through keeps the parts on either side;
+ * the replaced part goes, and what replaced it is typed or not by `origin`.
+ */
+export declare function applyEdit(spans: readonly Span[], edit: Edit, origin: EditOrigin): Span[];
+/** The spans of a draft replaced whole (history, restore, editor, reset). */
+export declare function replaceAll(length: number, origin: EditOrigin): Span[];
+/** Sorted and merged. */
+export declare function normalize(spans: readonly Span[]): Span[];
+/** An Alt+W decision about the trigger whose words span `[start, end)`. */
+export interface TriggerOverride {
+    readonly id: string;
+    readonly start: number;
+    readonly end: number;
+    readonly state: 'dropped' | 'armed';
+}
+/**
+ * Move Alt+W decisions through an edit. An edit inside a decided trigger's
+ * words forgets the decision: new keystrokes there are the operator saying
+ * it again, and the trigger is read afresh. Typing before or after the words
+ * keeps it.
+ */
+export declare function shiftOverrides(overrides: readonly TriggerOverride[], edit: Edit): TriggerOverride[];
+/** The overrides as `detectTriggers` reads them: by hit key `id@start`. */
+export declare function overrideMap(overrides: readonly TriggerOverride[]): Map<string, 'dropped' | 'armed'>;
+//# sourceMappingURL=provenance.d.ts.map

package/dist/tui/triggers/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../../src/tui/triggers/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GACnB,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,YAAY,CAAA;AAEf,wDAAwD;AACxD,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5C,MAAM,WAAW,IAAI;IACpB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgB7E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,CAcxF;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,CAErE;AAED,yBAAyB;AACzB,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI,EAAE,CASxD;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAA;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,IAAI,EAAE,IAAI,GACR,eAAe,EAAE,CASnB;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAC1B,SAAS,EAAE,SAAS,eAAe,EAAE,GACnC,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,CAElC"}

package/dist/tui/triggers/provenance.js

@@ -0,0 +1,98 @@
+/**
+ * Where the characters of a composer draft came from, kept as the spans that
+ * were NOT typed one key at a time here, and moved along with every edit.
+ *
+ * Only a human keystroke in this composer arms a trigger. A paste, a burst
+ * of input that arrives as one chunk (a paste without bracketed-paste
+ * markers looks exactly like that), a recalled or restored prompt, text from
+ * the external editor, a yank and an accepted completion are all text the
+ * operator did not type here, so a trigger in them is only suggested; Alt+W
+ * arms it.
+ *
+ * Pure: the Composer owns the state and calls these on each edit.
+ */
+/**
+ * The single replacement that turns `previous` into `next`. The shared
+ * prefix is capped at `cursor` — the cursor before the edit, where every
+ * composer edit starts or ends — so an edit inside a run of identical
+ * characters is placed where it actually happened.
+ */
+export function diffEdit(previous, next, cursor) {
+    let prefix = 0;
+    const limit = Math.min(previous.length, next.length, Math.max(0, cursor));
+    while (prefix < limit && previous.charCodeAt(prefix) === next.charCodeAt(prefix))
+        prefix += 1;
+    let suffix = 0;
+    const room = Math.min(previous.length, next.length) - prefix;
+    while (suffix < room &&
+        previous.charCodeAt(previous.length - 1 - suffix) === next.charCodeAt(next.length - 1 - suffix))
+        suffix += 1;
+    return {
+        start: prefix,
+        deleteEnd: previous.length - suffix,
+        insertLength: next.length - suffix - prefix,
+    };
+}
+/**
+ * Move the non-typed spans through one edit, adding the inserted text unless
+ * it was typed. A span the edit cuts through keeps the parts on either side;
+ * the replaced part goes, and what replaced it is typed or not by `origin`.
+ */
+export function applyEdit(spans, edit, origin) {
+    const delta = edit.insertLength - (edit.deleteEnd - edit.start);
+    const moved = [];
+    for (const [from, to] of spans) {
+        if (to <= edit.start)
+            moved.push([from, to]);
+        else if (from >= edit.deleteEnd)
+            moved.push([from + delta, to + delta]);
+        else {
+            if (from < edit.start)
+                moved.push([from, edit.start]);
+            if (to > edit.deleteEnd)
+                moved.push([edit.deleteEnd + delta, to + delta]);
+        }
+    }
+    if (origin !== 'typed' && edit.insertLength > 0)
+        moved.push([edit.start, edit.start + edit.insertLength]);
+    return normalize(moved);
+}
+/** The spans of a draft replaced whole (history, restore, editor, reset). */
+export function replaceAll(length, origin) {
+    return origin === 'typed' || length === 0 ? [] : [[0, length]];
+}
+/** Sorted and merged. */
+export function normalize(spans) {
+    const sorted = [...spans].sort((a, b) => a[0] - b[0]);
+    const merged = [];
+    for (const [from, to] of sorted) {
+        const last = merged[merged.length - 1];
+        if (last && from <= last[1])
+            last[1] = Math.max(last[1], to);
+        else
+            merged.push([from, to]);
+    }
+    return merged;
+}
+/**
+ * Move Alt+W decisions through an edit. An edit inside a decided trigger's
+ * words forgets the decision: new keystrokes there are the operator saying
+ * it again, and the trigger is read afresh. Typing before or after the words
+ * keeps it.
+ */
+export function shiftOverrides(overrides, edit) {
+    const delta = edit.insertLength - (edit.deleteEnd - edit.start);
+    const kept = [];
+    for (const override of overrides) {
+        if (edit.deleteEnd <= override.start)
+            kept.push({ ...override, start: override.start + delta, end: override.end + delta });
+        else if (edit.start >= override.end)
+            kept.push(override);
+    }
+    return kept;
+}
+/** The overrides as `detectTriggers` reads them: by hit key `id@start`. */
+export function overrideMap(overrides) {
+    return new Map(overrides.map((override) => [`${override.id}@${override.start}`, override.state]));
+}
+//# sourceMappingURL=provenance.js.map

package/dist/tui/triggers/provenance.js.map

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

package/dist/tui/triggers/registry.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Composer triggers: words typed into the TUI composer that name one namzu
+ * action for the message being written, shown before Enter and dropped with
+ * Alt+W. See docs/cli/composer-triggers.md.
+ *
+ * A trigger is a shorthand for something namzu already does. It grants
+ * nothing, skips no confirmation and lasts one turn: `TriggerEffect` has no
+ * kind for a permission mode, a directory, a credential, the sandbox, a tool
+ * list or a limit, and a test pins that. The operator's words reach the model
+ * and the log unchanged; namzu's own words for a trigger travel beside them as
+ * request-only context (`context-text.ts`).
+ *
+ * This module is the TUI's alone: `exec`, `drain`, ACP, the scheduler and
+ * sub-agents never import it (a test says so).
+ */
+import type { ComposerTriggerId } from '../../config/schema.js';
+import { type CompiledPattern } from './pattern.js';
+export type TriggerId = ComposerTriggerId;
+export declare const TRIGGER_IDS: readonly TriggerId[];
+/**
+ * What a trigger does when the text arms it.
+ *
+ * - `arm`: a strict match arms; a loose one, or text not typed here, suggests.
+ * - `suggest`: never arms from text; the tag row offers it, Alt+W arms it.
+ * - `off`: not matched at all.
+ */
+export type Arming = 'arm' | 'suggest' | 'off';
+export type TriggerLocale = 'en' | 'tr';
+/** The fixed texts namzu adds for a turn; operator text never enters them. */
+export type ContextTextId = 'hypermode' | 'save-skill' | 'schedule';
+/** A command a trigger may run after its turn. Only this one exists. */
+export type TriggerableCommand = '/skills save';
+export type TriggerEffect = 
+/**
+ * Request-only context for the turn, and optionally an effort for it:
+ * `hypermode`, the level `/hypermode` pins (`xhigh`, or the nearest below).
+ */
+{
+    readonly kind: 'turn-context';
+    readonly text: ContextTextId;
+    readonly effort?: 'hypermode';
+}
+/** The model's highest published effort for this turn only (max effort). */
+ | {
+    readonly kind: 'turn-effort';
+    readonly effort: 'highest';
+}
+/** A command run once after the turn the message lands in, when that turn did work. */
+ | {
+    readonly kind: 'after-turn';
+    readonly command: TriggerableCommand;
+    readonly text: ContextTextId;
+};
+export interface PhraseSpec {
+    readonly pattern: string;
+    /**
+     * Which edges of the match must be clause edges for it to be strict.
+     * English puts the verb first, so both; Turkish puts it last, so the right
+     * edge carries the request and the left may be any object.
+     */
+    readonly edges: 'both' | 'right';
+}
+/**
+ * A loose match: every slot has a token in one clause, in any order. A slot
+ * entry is a word, `word*` for a prefix (loanwords with Turkish suffixes:
+ * `skille`, `skillerimi`), or `{verb}` for any of its forms' first token.
+ */
+export type LooseSpec = readonly (readonly string[])[];
+export interface TriggerDefinition {
+    readonly id: TriggerId;
+    /** Shown in the tag row. */
+    readonly label: string;
+    /** Invented single words; they arm only at a clause edge. */
+    readonly keywords: readonly string[];
+    readonly phrases: Readonly<Partial<Record<TriggerLocale, readonly PhraseSpec[]>>>;
+    readonly loose: Readonly<Partial<Record<TriggerLocale, readonly LooseSpec[]>>>;
+    readonly effect: TriggerEffect;
+    /** `turn`: the new turn this message starts. `after-turn`: once, after the turn it lands in. */
+    readonly scope: 'turn' | 'after-turn';
+    /** A whole message that is only this trigger runs this command instead of a prompt. */
+    readonly standalone?: TriggerableCommand;
+    readonly arming: Arming;
+}
+/** The built-in triggers, in the order their tags are shown. */
+export declare const BUILTIN_TRIGGERS: readonly TriggerDefinition[];
+/** A trigger with its phrases compiled, as the matcher reads it. */
+export interface CompiledTrigger {
+    readonly definition: TriggerDefinition;
+    readonly arming: Arming;
+    readonly keywords: ReadonlySet<string>;
+    readonly phrases: readonly {
+        readonly pattern: CompiledPattern;
+        readonly edges: PhraseSpec['edges'];
+        readonly locale: TriggerLocale;
+    }[];
+    readonly loose: readonly {
+        readonly slots: readonly ((token: string) => boolean)[];
+        readonly locale: TriggerLocale;
+    }[];
+}
+export interface RegistryOptions {
+    /** Per-trigger arming, after config; absent keeps the built-in default. */
+    readonly arming?: Readonly<Partial<Record<TriggerId, Arming>>>;
+    readonly locales?: readonly TriggerLocale[];
+}
+export interface TriggerRegistry {
+    readonly triggers: readonly CompiledTrigger[];
+    /** Changes whenever the compiled set does; part of the detection memo key. */
+    readonly version: string;
+}
+export declare function compileRegistry(definitions?: readonly TriggerDefinition[], options?: RegistryOptions): TriggerRegistry;
+export declare function triggerDefinition(id: TriggerId): TriggerDefinition;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tui/triggers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tui/triggers/registry.ts"],"names":[],"mappings":"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"}