@nanonets/graft 0.23.1 → 0.24.1

package/dist/trace/typed.js

@@ -0,0 +1,132 @@
+/**
+ * Every reader of what the person typed, for learned skills: a save request
+ * and the scope words in it, the answer to an offer, a correction, and the
+ * hash, the only form typed text is ever stored in.
+ *
+ * An answer is a closed list of whole-message forms. "ok now fix the lint
+ * errors" starts like a yes and is not one: a skill is saved only on a reply
+ * that says nothing else. So the answer reads the whole message: a quote, a
+ * pasted block, a second line with more in it or a question mark makes it
+ * not a yes. The other matchers read `askText`: pasted code, quoted lines and
+ * very long lines are not the person's words.
+ *
+ * Pure: no files, no clock.
+ */
+import { createHash } from 'node:crypto';
+import { ownText } from './claude.js';
+import { askText, wordCount, MAX_ASK_WORDS, STATUS_OR_HISTORY } from './jobs.js';
+/** The person's words in a UserPromptSubmit `prompt`: phase 0's ownText(raw); null when that gives ''. */
+export function typedPrompt(raw) {
+    return ownText(String(raw ?? '')) || null;
+}
+/** 4.4: the spec's phrasings and the self-learning worktree's keep asks. A file (`skill.md`) or a "skill issue" is not a skill. */
+export const SAVE_REQUEST = new RegExp([
+    String.raw `\b(?:save|keep|make|turn)\s+(?:this|that|it|these(?:\s+steps)?|what\s+(?:you\s+)?(?:just\s+)?did|the\s+steps)\s+(?:as|into)\s+(?:a\s+)?skill(?!\w|[.-]\w|\s+issues?\b)`,
+    String.raw `\b(?:save|keep)\s+(?:this|that|it|these\s+steps)\s+for\s+next\s+time\b`,
+    String.raw `\bmake\s+(?:a\s+)?skill\s+(?:out\s+of|from)\s+(?:this|that|it)\b`,
+    String.raw `\bremember\s+how\s+(?:to\s+do\s+(?:this|that)|you\s+did\s+(?:this|that))\b`,
+].join('|'), 'i');
+/** A no before the verb, in the same clause: "don't save", "I don't want to save", "you shouldn't keep", "I'd rather not keep". */
+export const NOT_SAVE = /\b(?:don'?t|do not|never|no need to|not|shouldn'?t|should not|won'?t|will not|wouldn'?t|would not|didn'?t|did not)\b[^,.;:!?\n]*?\b(?:sav\w*|keep\w*|kept|mak\w*|made|turn\w*|remember\w*)\b/i;
+/** Asked, then taken back ("... actually no", "... ? nah", "never mind"), or not now ("not yet, ... later"). */
+const TAKEN_BACK = /\b(?:actually,? no|no,? wait|wait,? no|never ?mind|on second thought|scratch that|forget (?:it|that)|just kidding)\b|\b(?:nah|nope|no|don'?t|later)\W*$|^\W*not (?:yet|now)\b/i;
+/** Wondering, asking why or how, not asking for it. */
+const WONDERING = /^\s*why\b|\bwhy (?:did|didn'?t|would|do|does|is|are)\b|\bwhat (?:happens|if)\b|(?<!remember )\bhow (?:do|does|would|can|could|should|to)\b|\bexplain (?:how|what|why)\b|\bshould (?:i|we)\b|\bwhether\b/i;
+/** Asking whether the agent recalls a past run: "do you remember how...", "remember how you did this last time?". */
+const RECALLING = /\b(?:do|did|can|could) (?:you|u) remember\b|\bremember how\b[^.?!\n]*\b(?:last time|before|yesterday|earlier)\b/i;
+/**
+ * SAVE_REQUEST on 25 words or fewer, and not NOT_SAVE. Also not a status or history question ("did you
+ * save this as a skill?"), not taken back, not wondering, not recalling: a wrong yes here saves a skill
+ * nobody asked for, a wrong no only means the person says it plainly.
+ */
+export function isSaveRequest(typed) {
+    const ask = askText(typed).replace(/[\u2018\u2019]/g, "'");
+    if (wordCount(ask) > MAX_ASK_WORDS || !SAVE_REQUEST.test(ask) || NOT_SAVE.test(ask))
+        return false;
+    return !STATUS_OR_HISTORY.test(ask) && !TAKEN_BACK.test(ask) && !WONDERING.test(ask) && !RECALLING.test(ask);
+}
+export function scopeWords(typed) {
+    const t = askText(typed).toLowerCase();
+    if (/\b(always|everywhere|every repo|all (my )?repos|on this (mac|machine|laptop))\b/.test(t))
+        return 'every repo';
+    if (/\bfor (the|my|our) team\b/.test(t))
+        return 'team';
+    if (/\bfor (the )?(whole )?repo\b/.test(t) || /\b(for|in) (this|the) repo\b.*\b(everyone|team|all of us)\b/.test(t))
+        return 'repo';
+    return 'this repo';
+}
+const YES = [
+    // "ok thanks" closes a turn more often than it agrees to anything: ok and okay take no thanks.
+    /^(y|yes|yeah|yep|yup|sure)( please| do it| go ahead| save it| keep it| keep them| thanks| thank you)?$/,
+    /^(ok|okay)( please| do it| go ahead| save it| keep it| keep them)?$/,
+    /^(go ahead|do it|please do|save it|keep it|keep them|save them|sounds good)( please)?$/,
+    /^(yes|yeah|sure|ok|okay),? (keep|save) (it|this|that|them)( as a skill)?( please)?$/,
+    // Seen in real answers: praise, then the verb. Never praise alone.
+    /^(looks good|looks great|looks right|perfect|great|nice),? (keep|save) (it|this|that|them)( as a skill)?( please)?$/,
+];
+const SHOW = /^(show( me)?( it| the steps| the draft| first)?|let me see( it)?|what are the steps|see the steps|what'?s in it)( please)?$/;
+const NO = [
+    /^(n|no|nope|nah|not now|no thanks|no thank you|don'?t|skip( it)?|never ?mind|pass)( thanks| thank you)?$/,
+    /^(no )?(don'?t|do not)( (save|keep) (it|this|that|them)( as a skill)?)?( thanks| thank you)?$/,
+];
+const TRAILING_EMOJI = /[\s\p{Extended_Pictographic}\u{FE0F}\u{200D}\u{1F3FB}-\u{1F3FF}]+$/u;
+/**
+ * The whole message as one answer: lowercased, outer punctuation and a trailing emoji gone, commas and
+ * spaces as single spaces. The whole message, not `askText`: a quote, a pasted block or a long line is
+ * more than an answer, so it can't be one.
+ */
+function answerForm(typed) {
+    return String(typed ?? '').replace(/[\u2018\u2019]/g, "'").toLowerCase().trim()
+        .replace(TRAILING_EMOJI, '')
+        .replace(/^[\s.!?,;:]+|[\s.!?,;:]+$/g, '')
+        .replace(/\s*,\s*/g, ' ')
+        .replace(/\s+/g, ' ');
+}
+/** D116 item 3: the go-ahead phrases a run spans turns on, as the line's whole first clause. */
+const GO_AHEAD = /^(?:y|yes|yeah|yep|yup|sure|ok|okay|k|continue|go on|go ahead|do it|proceed|carry on|keep going|please do|please continue|please proceed|sounds good)(?: please)?$/;
+/**
+ * D116 item 3: the person said to go on: the line's first clause (up to `,` `:` `;` `.` `!` or a dash) is a
+ * go-ahead (yes, ok, continue, go on, do it, proceed), whatever follows it. Never a question.
+ */
+export function isGoAhead(typed) {
+    const t = String(typed ?? '').replace(/[\u2018\u2019]/g, "'").toLowerCase().trim();
+    if (!t || /\?\s*$/.test(t))
+        return false;
+    const first = t.split(/\s*(?:[,:;.!]|\s-\s|\s\u2014\s|$)/)[0].replace(TRAILING_EMOJI, '').trim();
+    return GO_AHEAD.test(first.replace(/\s+/g, ' '));
+}
+/** 4.12. afterShow: the offer already got its one 'show me'. A yes is never a question. */
+export function classifyAnswer(typed, afterShow) {
+    const t = answerForm(typed);
+    if (!t)
+        return 'other';
+    if (!String(typed).includes('?') && YES.some((re) => re.test(t)))
+        return 'yes';
+    if (!afterShow && SHOW.test(t))
+        return 'show';
+    if (NO.some((re) => re.test(t)))
+        return 'no';
+    if (isCorrection(askText(typed)))
+        return 'correction';
+    return 'other';
+}
+/* Ported from the self-learning worktree's detect.ts. */
+const CORRECTION_START = /^(no[,.!\s]|nope\b|not like that|that'?s (wrong|not)|wrong\b|actually[,\s]|i (said|told you)|why did you|you (keep|always|again)|again[,!]|stop\b|please don'?t|don'?t\b|do not\b|never\b|(it|you) (didn'?t|did not|forgot to|never)\b)/i;
+const AGAIN = /\b(i told you|i said|as i said|you keep \w+ing|every single time|again and again|yet again|(did|doing|broke|happened) (it|that|this) again|again\?)/i;
+const OUTPUT_CORRECTION = /\b(should (be|use|go|live) \S+.{0,30}\bnot\b|it'?s actually|is wrong|that'?s not (right|how)|you (got|have) (it|that) wrong)\b/i;
+const MAX_CORRECTION_CHARS = 400;
+/**
+ * The person is correcting what the agent just did. Ported from the worktree's detect.ts `isCorrection`; D111 adds
+ * "it didn't X" and "you forgot to X" without a leading no (moment 4's forms, 4.14 step 2).
+ */
+export function isCorrection(typed) {
+    // The person's own words: a quoted ('>') line or a fenced block is what they quoted, not their correction (b4 review).
+    const t = askText(String(typed ?? '')).replace(/[\u2018\u2019]/g, "'").trim();
+    return t.length <= MAX_CORRECTION_CHARS && (CORRECTION_START.test(t) || OUTPUT_CORRECTION.test(t) || AGAIN.test(t));
+}
+/** sha256 hex of the text NFC-normalised, trimmed, whitespace collapsed. The only form typed text is ever stored in. */
+export function typedSha(typed) {
+    const t = String(typed ?? '').normalize('NFC').trim().replace(/\s+/g, ' ');
+    return createHash('sha256').update(t).digest('hex');
+}
+//# sourceMappingURL=typed.js.map

package/dist/trace/typed.js.map

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

package/dist/trace/types.d.ts

@@ -0,0 +1,477 @@
+/**
+ * The shapes the trace layer folds a session into: runs of tool work that
+ * serve one typed ask, their calls, the checks that prove a job worked, and
+ * the per-session state the skills hooks keep under the `skills` key of
+ * `~/.trail/sessions/<id>.json`.
+ *
+ * Types only (a type import of skills/types.ts for the fold ops). Typed text never appears here: a run carries job words from a
+ * fixed vocabulary, parameter values of known shapes, counts, hashes of typed
+ * lines, and the commands that ran (secret-checked).
+ */
+import type { FoldOp } from '../skills/types.js';
+export type JobClass = 'release' | 'ship' | 'pr-green' | 'sweep' | 'run-local' | 'report' | 'tests';
+export interface JobMatch {
+    job: JobClass;
+    /** Canonical vocabulary words that matched, e.g. ['push', 'beta', 'ff', 'prod']. Never raw text. */
+    words: string[];
+}
+/** Parameter values of known shapes found in a typed ask. Values only, never the text around them. */
+export type PromptParams = Partial<Record<'version' | 'sha' | 'pr' | 'port' | 'branch' | 'date', string>>;
+/** What a Bash call is, decided at fold time from its raw command (4.1). */
+export type CallKind = 'step' | 'look' | 'plumbing' | 'work';
+export interface RunCall {
+    /** tool_use id */
+    id: string;
+    at: string;
+    /** The command after redactSecrets (4.10). null when it held a secret that could not be named, or ran over 2,000 characters (then `parts` holds it piece by piece, D58c). */
+    cmd: string | null;
+    /** For a call with `parts`, the worst of its pieces' (refused over named). */
+    secret?: 'named' | 'refused';
+    /** Repo key of the effective folder (4.1); null outside git. */
+    key: string | null;
+    /** Effective folder (4.1), relative to that checkout's root ('' = root); null outside git. A sheet stores null for calls in another repo than the run's. */
+    cwd: string | null;
+    /** tool_input.run_in_background === true, or the command ends in a top-level `&`. */
+    bg: boolean;
+    /** !ok from the trace: is_error, or failure text in head or tail. */
+    failed: boolean;
+    /** The host's own error flag only. */
+    isError: boolean;
+    /** errorLine(result), cleanLine(.., 160). */
+    errorLine?: string;
+    /** Last 200 chars of the result, cleanLine'd. Kept for check-family calls, polls, `git rev-parse`, `git push` and publish calls only. */
+    tail?: string;
+    check?: CheckHit;
+    /** Raw command over 2,000 chars: never kept whole; its pieces are in `parts` (D58c). */
+    truncated?: boolean;
+    /** isMultiLine(raw command). */
+    multiLine?: boolean;
+    kind: CallKind;
+    /** Byte offsets of the tool_use line and the tool_result line, for the gate (4.9). -1 / null when unknown. */
+    src: {
+        use: number;
+        result: number | null;
+    };
+    /** The outcome came from a PostToolUse(Failure) mark because the transcript had no result yet (3.4). A later transcript result replaces it. */
+    fromMark?: true;
+    /** Only when the raw command ran over 2,000 characters (then `cmd` is null and `truncated` set): its top-level pieces in order (D58c). */
+    parts?: RunCallPart[];
+    /**
+     * Not a Bash call: a deployment status tool over MCP (D59b, `mcp__claude_ai_Vercel__get_deployment`). Then `cmd` is
+     * null, `kind` is 'look', `key`/`cwd` are null, and `check` is the deploy check its result gave. Never a step,
+     * never counted in `commands` or `failedCount`.
+     */
+    tool?: string;
+    /**
+     * D116 item 5: the call only fed keystrokes into a login (`... | script -q /dev/null npm login`): the service it logs
+     * in to. Then `cmd` is the login alone (`npm login`): what was fed is never kept, and compile drops the step.
+     */
+    loginFeed?: string;
+}
+/**
+ * One top-level piece of a call over 2,000 characters (D58c), as `splitTop` cuts it: a subshell, a loop or an `if`
+ * is one piece, a heredoc body belongs to the piece that opened it. The call's `id` and `src` are every piece's
+ * `from` (the save gate re-reads that one transcript line).
+ */
+export interface RunCallPart {
+    /** Word for word what ran, after redactSecrets; null when it held a secret that could not be named, or is `long`. */
+    cmd: string | null;
+    /** The top-level separator after it; '' for the last. A newline reads as ';'. */
+    sep: '&&' | '||' | ';' | '|' | '&' | '';
+    /** 4.1 kinds for the piece alone; always 'work' when `long`. */
+    kind: CallKind;
+    secret?: 'named' | 'refused';
+    /** The piece ran over 2,000 characters (a heredoc body, an inline edit): a work marker, never a step, never kept. */
+    long?: true;
+}
+/** `push`: a `git push` whose output shows the remote ref moved (D56a); a step, like `tests` and `query`. */
+export type CheckFamily = 'tests' | 'npm-view' | 'deploy' | 'gh-checks' | 'ls-remote' | 'query' | 'push';
+export interface CheckHit {
+    family: CheckFamily;
+    passed: boolean;
+    facts: {
+        version?: string;
+        sha?: string;
+        state?: string;
+        pr?: string;
+        branch?: string;
+        remote?: string;
+        pkg?: string;
+        passedCount?: number;
+    };
+}
+export type RunEnd = 'done' | 'failure' | 'question' | 'open';
+export interface RunState {
+    id: string;
+    epoch: number;
+    startedAt: string;
+    lastAt: string;
+    /** Repo key that most of the run's commands ran in (4.1). */
+    repoKey: string;
+    /** D93: the top of the checkout `repoKey` names, as the fold found it; absent when no call ran in it. */
+    checkout?: string;
+    /** gitBranch of its first step call; null when unknown. */
+    branch: string | null;
+    job: JobClass | null;
+    jobWords: string[];
+    promptParams: PromptParams;
+    /** Words both in the typed ask and in the kept commands (moment 1 cue words when job is null). */
+    sharedWords: string[];
+    typedCount: number;
+    toolCalls: number;
+    edits: number;
+    commands: number;
+    failedCount: number;
+    stepCalls: number;
+    /** Open run only, newest last, at most 200. Emptied when the run closes, after its sheet is written. */
+    calls: RunCall[];
+    closed: boolean;
+    /** Recomputed at every Stop while the run is open (4.2), kept when it closes. */
+    end: RunEnd;
+    /** Set when a run block was injected for this run (not "from scratch"). */
+    skillId?: string;
+    /** The run a compaction cut before it checked out, whose job this run continues (D59a). The agent started it with no typed ask. */
+    carriedFrom?: string;
+    /**
+     * D116 item 3: a go-ahead continued this run after a turn the agent ended in failure; this many calls had run then.
+     * Only a check at or after that call can check the run out.
+     */
+    failedTurn?: number;
+    sheet: 'none' | 'draft' | 'checked';
+    checkIndex: number | null;
+    poolNoted: boolean;
+}
+/** ~/.trail/runs/<id>.json. What compile copies from. */
+export interface RunSheet {
+    v: 1;
+    id: string;
+    session: string;
+    repoKey: string;
+    /** D93: the checkout the run ran in (RunState.checkout). The save gate's halves read it, never their own cwd. */
+    checkout?: string;
+    branch: string | null;
+    host: string;
+    tier: 'A' | 'B' | 'C' | 'D';
+    epoch: number;
+    startedAt: string;
+    endedAt: string;
+    job: JobClass | null;
+    jobWords: string[];
+    sharedWords: string[];
+    promptParams: PromptParams;
+    calls: RunCall[];
+    /** Index into calls of the passing check that made it a checked success, or null. */
+    checkIndex: number | null;
+    checked: boolean;
+    end: RunEnd;
+    counts: {
+        commands: number;
+        failed: number;
+        toolCalls: number;
+        edits: number;
+    };
+    /** Absolute paths of helper scripts the run executed from scratch folders (4.5 step 7). */
+    helpers: string[];
+    /** The skill whose block drove this run, or null. */
+    skillId: string | null;
+    /** The run (and sheet) before the compaction that this one continues (D59a); its calls are the job's first part. */
+    carriedFrom?: string;
+    /** Set only by `joinCarriedSheet`: the earlier parts joined in, oldest first, and how many calls each brought (they come first). */
+    joined?: Array<{
+        id: string;
+        calls: number;
+    }>;
+}
+/** Phase 2: 'retire', the retire proposal's and drift's retire (4.10, classifyFor); 1a's classifyAnswer never gives it. */
+export type TypedAnswer = 'yes' | 'no' | 'show' | 'correction' | 'retire' | 'other';
+export type GatedKind = 'publish' | 'push-prod' | 'deploy' | 'merge' | 'migrate' | 'prune' | 'login';
+export interface SkillInjection {
+    injId: string;
+    skillId: string;
+    name: string;
+    epoch: number;
+    at: string;
+    cue: 'job' | 'name' | 'check' | 'compact';
+    params: Record<string, string>;
+    /** Steps with params filled, in order (step n = index + 1). [] for a check cue. */
+    steps: string[];
+    gated: Array<{
+        step: number;
+        kind: GatedKind;
+    }>;
+    check: string | null;
+    /**
+     * D66: the skill's `metadata.check-tool` (e.g. 'get_deployment') when its check is a deploy status read over MCP,
+     * not a command. Credit then takes the check from that tool's result (READY passes). Absent for a command check.
+     */
+    checkTool?: string | null;
+    /**
+     * D106: the version a version check should show (the skill's `check-shows` is a `{version}` param, filled with a
+     * literal version). Credit passes the check only when it shows this version. Absent otherwise.
+     */
+    checkVersion?: string;
+    /**
+     * The ready probes (their text, from the skill's `ready` line) that failed when the block came in. Credit puts
+     * their forms in the use line; they never count against the skill (g4 open issue 4, D71 d). Absent when none failed.
+     */
+    readyFailed?: string[];
+    /** Set by the fold: the run of the first typed event at or after `at` minus 5 s. */
+    runId: string | null;
+    /** Its gated ask applies (3.3). Ends per 3.1 step 3, 3.2 step 7 and 3.5 step 5. */
+    live: boolean;
+}
+export type OfferChannel = 'stop' | 'notice' | 'post-tool';
+export interface PendingOffer {
+    offerId: string;
+    moment: OfferMoment;
+    runId: string;
+    name: string;
+    key: string;
+    /**
+     * The 2 lines (4.12). 1b: null only for a 'correction' offer, rebuilt from the transcript (P17); every reader goes
+     * through offerLinesOf (b4, R12). Until then each 1a reader treats null as no offer: never shown, answered or saved.
+     */
+    lines: [string, string] | null;
+    channel: OfferChannel;
+    shownAt: string | null;
+    showMe: boolean;
+    /** Set by the prompt hook from the UserPromptSubmit payload: the person's yes, as a hash. */
+    yes: {
+        at: string;
+        typedSha: string;
+    } | null;
+    /** Set by the fold: the first typed events after shownAt (at most 2: a 'show' then the answer). */
+    typedAfter: Array<{
+        offset: number;
+        sha: string;
+        answer: TypedAnswer;
+    }>;
+    /** g5 review: `skillSha` of the skill the offer counted (offerDue). The gate saves only that skill on its yes. */
+    skillSha?: string;
+    /** D101: how often the job worked out from scratch (line 1's count), for Trail's own reason in the Stop and post-tool text. */
+    seen?: {
+        n: number;
+        unit: 'day' | 'time';
+    };
+}
+export interface CreditState {
+    useId: string;
+    injId: string;
+    skillId: string;
+    epoch: number;
+    runId: string | null;
+    stepsRan: number[];
+    failedStep: number | null;
+    check: 'passed' | 'failed' | 'none';
+    calls: number;
+    failed: number;
+    flushed: boolean;
+    promptsAfter: number;
+}
+/** The `skills` key of ~/.trail/sessions/<id>.json. The `trace` key beside it is the catch-up cursor (0.1). */
+export interface SkillSessionState {
+    v: 1;
+    sessionHash: string;
+    host: string;
+    tier: 'A' | 'B' | 'C' | 'D';
+    /** GateCtx.learn when this state was made (0 rule 2). */
+    learn: boolean;
+    /** Repo keys in scope for recall: the cwd's key, plus child checkouts when cwd is not in git (3.1). */
+    scopeKeys: string[];
+    epoch: number;
+    /** SessionStart(compact) bumped the epoch before the fold met the compaction line (4.1). */
+    pendingBoundary: boolean;
+    /** At most 20, open run last. */
+    runs: RunState[];
+    pendingOffer: PendingOffer | null;
+    /** The one offer of this session is spent (an offer, an asked save, or the shim's install line, D27). */
+    offerUsed: boolean;
+    offerUsedBy: 'offer' | 'asked' | 'install-line' | null;
+    /** typed: set by the fold when it meets the typed line with this typedSha at or after `at` minus 5 s. */
+    saveRequest: {
+        runId: string;
+        at: string;
+        typedSha: string;
+        scope: 'this repo' | 'every repo' | 'repo' | 'team';
+        typed: {
+            offset: number;
+            sha: string;
+        } | null;
+        /** D73: `skillSha` of the skill compiled when the person asked. The gate saves only that skill; missing: refused. */
+        skillSha?: string;
+        /** The name Trail gave that skill (the add it told the agent to run). The gate keeps it under this name, or
+         *  a numbered one when it was taken since; missing: refused. */
+        name?: string;
+    } | null;
+    /** All epochs this session, newest last, at most 20. */
+    injected: SkillInjection[];
+    /** Newest last, at most 10. */
+    credit: CreditState[];
+    /** The first call that wrote Trail's or the host's files (4.1), as '<tool> <path or program>'. Never cleared. */
+    tampered: string | null;
+    /**
+     * The run the last compaction cut mid-job, before it checked out (D59a): the next run the agent starts with no
+     * typed ask continues its job. Spent by that run; cleared by any typed line.
+     */
+    cut?: string;
+    /**
+     * D116 item 3: how the agent's last reply ended (4.3: failure first, then a question, else done), from the fold's
+     * last assistant text before a typed line or a call; cleared by a call, a typed line and a compaction. Never text.
+     */
+    replyEnd?: 'failure' | 'question' | 'done';
+    updatedAt: string;
+    /**
+     * What was already folded, so a block of history the transcript repeats, or a transcript read again from
+     * the top, folds once (D56d): 10 hex of sha256 per tool_use id, typed line and compaction line, concatenated,
+     * oldest first, at most 6,000. Never an id in the clear.
+     */
+    seen?: string;
+}
+/** The wall catalog's classes (spec 12). Closed: equal to telemetry's wall_hit.class values, in the catalog's order. */
+export type WallClass = 'timeout-missing' | 'zsh-no-match' | 'git-https-auth' | 'docker-rootless' | 'npm-e401-eotp' | 'claude-not-logged-in' | 'enospc';
+/** What changed between a failing call and the retry that worked (4.12). */
+export type FixDeltaKind = 'env' | 'flag' | 'wrapper' | 'enable-step';
+export interface FixDelta {
+    kind: FixDeltaKind;
+    /** env: the variable name; flag: the flag; wrapper: the program put in front; enable-step: that call's program. */
+    name: string;
+    /** The text as it ran, secret-checked and relativized ($HOME, repo-relative). Never a typed word. */
+    text: string;
+    /** The tool_use id that carried it. */
+    callId: string;
+}
+export interface RepairEvent {
+    cls: WallClass;
+    program: string;
+    failCallId: string;
+    /** The retry that worked. */
+    fixCallId: string;
+    /** Non-empty, else it is not a repair. */
+    delta: FixDelta[];
+    epoch: number;
+    runId: string | null;
+    at: string;
+}
+/** Phase 2: moment 5 'update', moment 6 'drift', and the retire proposal 'retire' (4.7 to 4.10). */
+export type OfferMoment = 'repeated' | 'repaired' | 'correction' | 'update' | 'drift' | 'retire';
+export interface RunCall {
+    /** Set by run-calls.ts makeCall (b2, R8): matchWall(result text, command, failed). Kept in run sheets as a class name only. */
+    wall?: WallClass;
+    /** The run's Edit/Write tool calls before this one, when any (b2 review): an edit between a failure and its retry may be the fix, so no repair. */
+    editsBefore?: number;
+}
+export interface RunState {
+    /** Filled at run close (4.12): at most 5 per run. The wall hits themselves are RunCall.wall. */
+    repairs?: RepairEvent[];
+}
+export interface PendingOffer {
+    /** b4: the repo the offer is for (its `offers.jsonl` line's `repo`). A correction's key names the skill, not the repo. */
+    repo?: string;
+    /** Moment 3. as 'lesson': lessonSha is the sha256 of the lesson text line 2 shows (R26). */
+    repair?: {
+        cls: WallClass;
+        program: string;
+        nth: number;
+        firstAt: string;
+        as: 'skill' | 'lesson';
+        delta: FixDelta[];
+        lessonSha?: string;
+    };
+    /** Moment 4: the person's correction line (offset and sha), the first new step that worked after it, the lesson as offered. */
+    correction?: {
+        skillId: string;
+        useId: string;
+        typed: {
+            offset: number;
+            sha: string;
+        };
+        fixCallId: string | null;
+        lessonSha: string;
+        /** b4: the fix command as the lesson holds it (params put back, relativized, risk-checked), or null: the agent's
+         *  command, never the person's words, so line 2 is rebuilt from the typed line and this (P17). */
+        fix?: string | null;
+    };
+}
+export interface SkillInjection {
+    /** 8 hex of sha256 of the asks phrase that fired a 'job' cue; null for name, check, compact. Never the phrase (D71 b, R30). */
+    phraseSha?: string | null;
+}
+export interface CreditState {
+    /** Copied from the injection. */
+    phraseSha?: string | null;
+    /** creditWindow sets sha; the fold fills offset from an origin-human typed line only. */
+    corrected?: {
+        offset: number | null;
+        sha: string;
+    } | null;
+}
+export interface SkillSessionState {
+    lessonWatch?: {
+        skillId: string;
+        useId: string;
+        typedSha: string;
+        at: string;
+    } | null;
+    /** The correction that withdrew this session's offer: only the moment-4 offer for that same correction may use the freed slot (P18, R40). */
+    withdrewFor?: {
+        typedSha: string;
+    } | null;
+    /** Lines of sessions/<id>.denied.jsonl Stop has counted (3.5 step 5). */
+    deniedSeen?: number;
+}
+/** The facts of a Codex rollout's first line (`session_meta`, 4.15), read once. No text but `cwd`. c6's `codexMeta` returns it. */
+export interface CodexMeta {
+    id: string;
+    originator: string | null;
+    source: string | null;
+    cliVersion: string | null;
+    cwd: string | null;
+    historyMode: 'legacy' | 'paginated' | null;
+}
+export interface PendingOffer {
+    /** Moments 5 and 6 (4.7, 4.8): the change shown, pinned to the file it was computed from and to the text it would write. */
+    fold?: {
+        op: FoldOp | 'replace';
+        skillId: string;
+        baseHash: string;
+        proposalSha: string;
+        handEdited: boolean;
+        splitName?: string;
+        lessonIds?: string[];
+        version: number;
+    };
+    /** The retire proposal and drift (4.9): the skill a 'retire' answer retires. */
+    retire?: {
+        skillId: string;
+        name: string;
+    };
+}
+export interface SkillSessionState {
+    /** c7: Codex only. The rollout's first line, read once (4.17), and the keyed hashes (HMAC with its own key file,
+     *  state/typed-key, D138 (3); 16 hex, last 20) of prompts the prompt hook saw (P30, R7). Never a prompt. */
+    codex?: {
+        meta: CodexMeta | null;
+        typedShas: string[];
+    };
+    /** c8 (4.9): not-followed firings the prompt hook's settle wrote, for the next Stop's retire proposal. At most 4. */
+    firedLater?: Array<{
+        skillId: string;
+        name: string;
+        followed: boolean;
+        runId: string;
+        at: string;
+    }>;
+}
+/** Phase 2 c8 (D137): a gated step this session couldn't ask for was denied and handed to the person to run. */
+export interface SkillInjection {
+    /** The gated steps handed to the person (from the gate file's marks): credit counts each as handed, not failed. */
+    handed?: Array<{
+        n: number;
+        at: string;
+    }>;
+}
+export interface RunState {
+    /** The newest hand-off of one of its block's gated steps: the person's next ask of the job continues this run. */
+    handedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/trace/types.d.ts.map

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

package/dist/trace/types.js

@@ -0,0 +1,12 @@
+/**
+ * The shapes the trace layer folds a session into: runs of tool work that
+ * serve one typed ask, their calls, the checks that prove a job worked, and
+ * the per-session state the skills hooks keep under the `skills` key of
+ * `~/.trail/sessions/<id>.json`.
+ *
+ * Types only (a type import of skills/types.ts for the fold ops). Typed text never appears here: a run carries job words from a
+ * fixed vocabulary, parameter values of known shapes, counts, hashes of typed
+ * lines, and the commands that ran (secret-checked).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/trace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/trace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}