@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/save-parse.js

@@ -0,0 +1,172 @@
+/**
+ * Reading a `trail skills add` command (design 4.9 step 1), whatever runs it:
+ * `trail`, `graft`, `npx @trailhq/trail-code`, `node .../trail.js`,
+ * `bash -c "..."`, `eval`, an alias or xargs. `skills add` anywhere in the
+ * command is an add; it must read as exactly `skills add <name> --run <id>`,
+ * once. Re-exported from `save-gate.ts`, where the design names it.
+ *
+ * Phase 2 (4.11): `trail skills update <name> --offer <id>`, read stricter
+ * still: nothing chained and no root options, since its gate writes a file.
+ */
+import { leadingCds, onlyTrail, simpleCommands } from '../trace/shell.js';
+/** /\bskills\s+add\b/: anywhere in the command, whatever binary, wrapper or path runs it. */
+export const SKILLS_ADD_RE = /\bskills\s+add\b/;
+const ALL_ADDS = /\bskills\s+add\b/g;
+/** Where the add's own words end, outside quotes: the next command, a redirect, a comment, a subshell's end. */
+const STOP = new Set([';', '&', '|', ')', '<', '>', '\n', '\r', '`']);
+/** The words after `skills add`, up to the end of that command. A quote never closed ends it (the close of `bash -c "..."`). */
+function tailWords(tail) {
+    const out = [];
+    let cur = '';
+    let has = false;
+    const flush = () => {
+        if (has)
+            out.push(cur);
+        cur = '';
+        has = false;
+    };
+    for (let i = 0; i < tail.length; i++) {
+        const ch = tail[i];
+        if (ch === '"' || ch === "'") {
+            const end = tail.indexOf(ch, i + 1);
+            if (end < 0)
+                break;
+            cur += tail.slice(i + 1, end);
+            has = true;
+            i = end;
+            continue;
+        }
+        if (ch === '\\' && i + 1 < tail.length && tail[i + 1] !== '\n') {
+            cur += tail[i + 1];
+            has = true;
+            i++;
+            continue;
+        }
+        if (STOP.has(ch)) {
+            // `2>&1`: digits right before a redirect are the redirect's, not a word.
+            if ((ch === '>' || ch === '<') && /^\d+$/.test(cur))
+                has = false;
+            break;
+        }
+        if (ch === '#' && !has)
+            break;
+        if (ch === ' ' || ch === '\t') {
+            flush();
+            continue;
+        }
+        cur += ch;
+        has = true;
+    }
+    flush();
+    return out;
+}
+/** null when the command doesn't parse as `<anything> skills add <name> --run <id>`, or adds more than once. */
+export function parseSkillsAdd(command) {
+    const text = String(command ?? '');
+    const hits = [...text.matchAll(ALL_ADDS)];
+    if (hits.length !== 1)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let name = null;
+    let runId = null;
+    const flags = [];
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--run' && runId === null && i + 1 < words.length) {
+            runId = words[++i];
+            continue;
+        }
+        if (w.startsWith('--run=') && runId === null) {
+            runId = w.slice(6);
+            continue;
+        }
+        if (!w.startsWith('-') && name === null) {
+            name = w;
+            continue;
+        }
+        flags.push(w);
+    }
+    if (name === null || runId === null || !runId)
+        return null;
+    return { name, runId, flags };
+}
+/** /\bskills\s+lesson\b/: anywhere in the command, whatever runs it (the lesson gate, R12's twin of SKILLS_ADD_RE). */
+export const SKILLS_LESSON_RE = /\bskills\s+lesson\b/;
+const ALL_LESSONS = /\bskills\s+lesson\b/g;
+/** Every save the gate guards: a skill's add, a lesson's keep, and (phase 2) a skill's update. */
+export const SAVE_GATE_RE = /\bskills\s+(?:add|lesson|update)\b/;
+/** null when the command doesn't parse as `<anything> skills lesson [<skill>] --offer <id>`, or keeps more than one. */
+export function parseSkillsLesson(command) {
+    const text = String(command ?? '');
+    const hits = [...text.matchAll(ALL_LESSONS)];
+    if (hits.length !== 1 || [...text.matchAll(ALL_ADDS)].length)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let skill = null;
+    let offerId = null;
+    const flags = [];
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--offer' && offerId === null && i + 1 < words.length) {
+            offerId = words[++i];
+            continue;
+        }
+        if (w.startsWith('--offer=') && offerId === null) {
+            offerId = w.slice(8);
+            continue;
+        }
+        if (!w.startsWith('-') && skill === null && offerId === null) {
+            skill = w;
+            continue;
+        }
+        flags.push(w);
+    }
+    if (!offerId)
+        return null;
+    return { skill, offerId, flags };
+}
+/** /\bskills\s+update\b/: anywhere in the command, whatever runs it. */
+export const SKILLS_UPDATE_RE = /\bskills\s+update\b/;
+const ALL_UPDATES = /\bskills\s+update\b/g;
+/** Past this the command is not read (D89). */
+const UPDATE_MAX = 64 * 1024;
+/** What comes right before `skills update`: a Trail binary, nothing between it and `skills` (no root option). */
+const TRAIL_BIN = /(?:^|[\s/"'(])(?:trail|graft|trail-code|@trailhq\/trail-code|@nanonets\/graft|(?:trail|graft)\.js)\s+$/;
+const SKILL_NAME = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const OFFER_ID = /^o-[0-9a-f]{6}$/;
+/** A pipe (not `||`): its other side could cut or rewrite what the update prints. */
+const PIPE = /(?:^|[^|])\|(?!\|)/;
+/**
+ * null unless the command is exactly one `<trail> skills update <name> --offer <o-id>`, Trail's own and nothing
+ * else (1a's `onlyTrail`, one simple command after any leading cds, no pipe), with no other add, lesson or update.
+ */
+export function parseSkillsUpdate(command) {
+    const text = String(command ?? '');
+    if (text.length > UPDATE_MAX)
+        return null;
+    const hits = [...text.matchAll(ALL_UPDATES)];
+    if (hits.length !== 1 || SKILLS_ADD_RE.test(text) || SKILLS_LESSON_RE.test(text))
+        return null;
+    if (!TRAIL_BIN.test(text.slice(Math.max(0, hits[0].index - 200), hits[0].index)))
+        return null;
+    if (PIPE.test(text) || !onlyTrail(text) || simpleCommands(leadingCds(text).rest).length !== 1)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let name = null;
+    let offerId = null;
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--offer' && offerId === null && i + 1 < words.length)
+            offerId = words[++i];
+        else if (w.startsWith('--offer=') && offerId === null)
+            offerId = w.slice(8);
+        else if (!w.startsWith('-') && name === null)
+            name = w;
+        else
+            return null;
+    }
+    if (!name || !offerId || !SKILL_NAME.test(name) || !OFFER_ID.test(offerId))
+        return null;
+    return { name, offerId };
+}
+//# sourceMappingURL=save-parse.js.map

package/dist/skills/save-parse.js.map

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

package/dist/skills/save-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * What the save gate reads from the skill store (g4), without changing it:
+ * where a name is taken, which runs are already kept, and the run a held
+ * item was kept from (D65: a live save for the same run replaces it).
+ */
+import type { SkillState } from './types.js';
+export { nameTaken } from './store.js';
+/** The skills state's entries; {} when it can't be read. */
+export declare function readSkillsStateSafe(env?: NodeJS.ProcessEnv): Record<string, SkillState>;
+/** The run id a held item of this name was kept from (`HeldItem.runId`); null when there is none or it doesn't say. */
+export declare function heldRunId(name: string, env?: NodeJS.ProcessEnv): string | null;
+//# sourceMappingURL=save-store.d.ts.map

package/dist/skills/save-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-store.d.ts","sourceRoot":"","sources":["../../src/skills/save-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAMvF;AAED,uHAAuH;AACvH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAM9E"}

package/dist/skills/save-store.js

@@ -0,0 +1,22 @@
+import { allHeld } from './store-held.js';
+import { readSkillsState } from './state.js';
+export { nameTaken } from './store.js';
+/** The skills state's entries; {} when it can't be read. */
+export function readSkillsStateSafe(env) {
+    try {
+        return readSkillsState(env).skills;
+    }
+    catch {
+        return {};
+    }
+}
+/** The run id a held item of this name was kept from (`HeldItem.runId`); null when there is none or it doesn't say. */
+export function heldRunId(name, env) {
+    try {
+        return allHeld(env).find((h) => h.name === name)?.runId ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=save-store.js.map

package/dist/skills/save-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-store.js","sourceRoot":"","sources":["../../src/skills/save-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,GAAuB;IACzD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAuB;IAC7D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/skills/save-verify.d.ts

@@ -0,0 +1,59 @@
+import type { FoldResult } from '../trace/runs.js';
+import type { GateCtx } from '../trace/skill-session.js';
+import type { JobClass, PendingOffer, RunCall, SkillSessionState } from '../trace/types.js';
+import type { CompiledSkill, Receipt } from './types.js';
+import type { SkillsAddCmd } from './save-parse.js';
+import { type DialectUse } from '../trace/dialect.js';
+export interface SaveVerdict {
+    deny?: string;
+    consent: Receipt['consent'];
+    offerId: string | null;
+    typed: Receipt['typed'];
+    stepsTotal: number;
+    stepsVerified: number;
+    verdict: 'live' | 'held';
+    heldWhy?: 'no-yes' | 'host';
+    compiled?: CompiledSkill;
+    /** D93: the checkout the run was compiled in (`runCheckout`), for the receipt; '' for none. */
+    checkout?: string;
+}
+export declare const DENY: {
+    readonly subagent: "trail · not saved: only the main session can keep a skill.";
+    readonly noPerson: "trail · not saved: this session runs without a person at the keyboard (headless, CI or a scratch folder), so Trail keeps nothing from it.";
+    readonly busy: "trail · not saved: Trail was busy. Run the same command again.";
+    readonly flags: "trail · not saved: `trail skills add` takes only a name and --run <id>.";
+    readonly name: "trail · not saved: pick a name with lowercase letters, digits and dashes, with at least one letter.";
+    readonly run: "trail · not saved: that run isn't from this session.";
+    /** D94: a host whose transcript Trail can't read (Cursor, tier D) has no run of this session to keep. */
+    readonly unreadable: "trail · not saved: Trail can't read this tool's session history, so it can't keep skills from it.";
+    readonly secret: "trail · not saved: a step still holds something that looks like a secret.";
+    readonly changed: "trail · not saved: the steps changed after the offer, so they aren't the ones the person said yes to. If they want these, they can say \"save this as a skill\".";
+    readonly askedChanged: "trail · not saved: the steps changed after you asked. Ask again once the job is done.";
+};
+/** The refusal for a tamper mark: a hook script run by hand in its own words (D93), a write naming what it wrote. */
+export declare const tamperDeny: (what: string) => string;
+/** The dialect a session's lines are read with (4.16), and the state its typed lines are judged by. */
+export declare const dialectUse: (host: string, st: SkillSessionState | null) => DialectUse;
+/**
+ * Step 5's second half: the line at `offset` is one the person typed, its words hash to `sha`; and when it was written.
+ * `use`: the host's dialect and the session state (Claude's by default).
+ */
+export declare function personLine(tx: string, offset: number, sha: string, mustBe: (text: string) => boolean, env: NodeJS.ProcessEnv, said?: (text: string) => void, use?: DialectUse): {
+    typed: NonNullable<Receipt['typed']>;
+    at: number;
+} | null;
+/**
+ * Phase 2 (4.7): a yes to which offers keeps a run as a skill. 1a and 1b's moments; of phase 2's, only moment 5's
+ * split, whose new skill is this offer's name. An update, a drift or a retire offer's yes is never a yes to an add.
+ */
+export declare const isSplitOffer: (po: PendingOffer | null | undefined) => boolean;
+/**
+ * The agent's last words before the person's line at `offset`: the text of the main session's last reply, when no
+ * tool call, tool result or other typed line comes between them; null otherwise, or further back than 1 MB.
+ */
+export declare function replyBefore(tx: string, offset: number, env: NodeJS.ProcessEnv, use?: DialectUse): string | null;
+/** 4.9 step 7 for one call: its tool_use and tool_result lines, read at their offsets, show it ran as stored and worked. */
+export declare function ranAndWorked(call: RunCall | undefined, tx: string, job: JobClass | null, how?: DialectUse, env?: NodeJS.ProcessEnv): boolean;
+/** 4.9 steps 1 to 10. `cmd` null: the command matched `skills add` but didn't parse (step 1). */
+export declare function verifySave(cmd: SkillsAddCmd | null, ctx: GateCtx, st: SkillSessionState, _fold: FoldResult | null, env?: NodeJS.ProcessEnv): SaveVerdict;
+//# sourceMappingURL=save-verify.d.ts.map

package/dist/skills/save-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-verify.d.ts","sourceRoot":"","sources":["../../src/skills/save-verify.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAY,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAuD,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAyB3G,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,MAAM,IAAI;;;;;;;IAOf,yGAAyG;;;;;CAKjG,CAAC;AAUX,qHAAqH;AACrH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,WAEkF,CAAC;AAkD1H,uGAAuG;AACvG,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,IAAI,iBAAiB,GAAG,IAAI,KAAG,UAAmE,CAAC;AAE5I;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC1J,GAAG,GAAE,UAAuB,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ3F;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,IAAI,YAAY,GAAG,IAAI,GAAG,SAAS,KAAG,OACkE,CAAC;AAyBtI;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,UAAuB,GAAG,MAAM,GAAG,IAAI,CAmB3H;AA4DD,4HAA4H;AAC5H,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,GAAE,UAAuB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAarK;AAoBD,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,GAAE,MAAM,CAAC,UAAoB,GAAG,WAAW,CAsFjK"}