@nanonets/graft 0.24.0 → 0.25.0

package/dist/claude/hook-io.js

@@ -0,0 +1,144 @@
+/**
+ * What every hook shares for talking back to the host and for running the CLI
+ * as a child: the one JSON shape a hook answers in, and the `graft` child with
+ * its time budget. Kept apart from hooks.ts so each event's handler can live in
+ * its own file.
+ */
+import { execFileSync, spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { resolveContextDir } from './state.js';
+import { graftCliPath } from './paths.js';
+/** Default budget for a graft child process invoked from a hook, matching the 8s
+ * the installed hook entries carry. */
+export const CHILD_TIMEOUT_MS = 8000;
+/**
+ * Append `--dir <contextDir>` for the hooks' own `graft ask`/`graft check`
+ * children — the one place the hooks spawn the CLI itself rather
+ * than reading `graft/` off disk (which already resolves through
+ * `resolveContextDir` inside `util/state.ts` and `claude/stats.ts`). A no-op
+ * when `GRAFT_DIR` isn't set, so an unconfigured repo's spawned CLI sees
+ * byte-identical argv to before this existed.
+ */
+export function withContextDirArg(dir, args) {
+    return process.env.GRAFT_DIR ? [...args, '--dir', resolveContextDir(dir)] : args;
+}
+/** The graft child's JSON answer, or null. `input` goes to it on stdin: for anything the person typed, which argv would show to `ps`. */
+export function graftJson(dir, args, timeout = CHILD_TIMEOUT_MS, input) {
+    try {
+        // GRAFT_TEST_CLI is a test seam (mirrors GRAFT_TEST_STDIN/GRAFT_TEST_SYNC_RUN) so
+        // tests can point the prompt hook's `graft ask`/`graft check` calls at a stub
+        // script and observe the exact args it was invoked with, instead of shelling
+        // out to the real CLI (which isn't built relative to the TS source under test).
+        const cliPath = process.env.GRAFT_TEST_CLI ?? graftCliPath();
+        const out = execFileSync(process.execPath, [cliPath, ...args], { cwd: dir, encoding: 'utf8', timeout, input, stdio: [input === undefined ? 'ignore' : 'pipe', 'pipe', 'ignore'], windowsHide: true });
+        return JSON.parse(out);
+    }
+    catch (e) {
+        // `graft check` exits non-zero when the graph is stale (by design) but still
+        // prints valid JSON to stdout; recover it from the thrown error before giving up.
+        if (e && typeof e.stdout === 'string' && e.stdout.trim()) {
+            try {
+                return JSON.parse(e.stdout);
+            }
+            catch { /* not JSON — fall through */ }
+        }
+        return null;
+    }
+}
+/**
+ * The graft child's JSON answer within `timeout` ms, or null. Unlike
+ * {@link graftJson}, the wait really ends at `timeout`: `execFileSync` sends
+ * SIGTERM and then waits for the child to exit, and a `graft ask` refreshing
+ * the graph takes SIGTERM (to release its lock) only once its synchronous
+ * parse is done, which on a large repo is half a minute. Here the child is
+ * sent SIGTERM and let go: it releases its lock and exits on its own, and is
+ * never waited on, so the hook ends on time. `input` goes on stdin.
+ */
+export function graftJsonWithin(dir, args, timeout, input) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let timer;
+        const done = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            resolve(value);
+        };
+        try {
+            const cliPath = process.env.GRAFT_TEST_CLI ?? graftCliPath();
+            const child = spawn(process.execPath, [cliPath, ...args], { cwd: dir, stdio: ['pipe', 'pipe', 'ignore'], windowsHide: true });
+            let out = '';
+            child.stdout.setEncoding('utf8');
+            child.stdout.on('data', (chunk) => { out += chunk; });
+            child.stdout.on('error', () => { });
+            child.stdin.on('error', () => { });
+            child.on('error', () => done(null));
+            child.on('close', () => {
+                try {
+                    done(JSON.parse(out));
+                }
+                catch {
+                    done(null);
+                }
+            });
+            timer = setTimeout(() => {
+                try {
+                    child.kill('SIGTERM');
+                }
+                catch { /* already gone */ }
+                child.stdout.destroy();
+                child.stdin.destroy();
+                child.unref();
+                done(null);
+            }, Math.max(0, timeout));
+            child.stdin.end(input ?? '');
+        }
+        catch {
+            done(null);
+        }
+    });
+}
+/** A hook's answer: `additionalContext` for the event, as Claude Code (and Codex) read it. */
+export function emit(eventName, additionalContext) {
+    process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: eventName, additionalContext } }));
+}
+/**
+ * A hook's whole answer as one JSON object, or nothing when `out` is empty.
+ * A block (Stop: the agent goes on with `reason`; UserPromptSubmit: the
+ * prompt goes no further) is the whole answer, never beside a notice or
+ * context. Otherwise context is `hookSpecificOutput.additionalContext`, which
+ * the agent reads (Stop has none), and a notice is the top-level
+ * `systemMessage`, which the person reads.
+ */
+export function emitHook(eventName, out) {
+    if (out.block) {
+        process.stdout.write(JSON.stringify({ decision: 'block', reason: out.block }));
+        return;
+    }
+    const context = eventName === 'Stop' ? '' : out.context ?? '';
+    const answer = {};
+    if (context)
+        answer.hookSpecificOutput = { hookEventName: eventName, additionalContext: context };
+    if (out.notice)
+        answer.systemMessage = out.notice;
+    if (Object.keys(answer).length)
+        process.stdout.write(JSON.stringify(answer));
+}
+/**
+ * The session a payload belongs to, in every host's shape: Claude Code's
+ * `session_id`, Copilot CLI's `sessionId`, Cursor's `conversation_id`;
+ * 'default' when none. It names a file, so anything but a plain name (a path,
+ * a dot first, very long) is hashed into one.
+ */
+export function payloadSessionId(input) {
+    const p = input && typeof input === 'object' && !Array.isArray(input) ? input : {};
+    const raw = [p.session_id, p.sessionId, p.conversation_id].find((v) => typeof v === 'string' && v !== '');
+    if (raw === undefined)
+        return 'default';
+    if (/^[A-Za-z0-9_-][A-Za-z0-9._-]{0,127}$/.test(raw))
+        return raw;
+    return `h-${createHash('sha256').update(raw).digest('hex').slice(0, 16)}`;
+}
+//# sourceMappingURL=hook-io.js.map

package/dist/claude/hook-io.js.map

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

package/dist/claude/hook-layers.d.ts

@@ -2,7 +2,9 @@
  * True when this hook process runs from the repo's shim and the `~/.claude`
  * copy also answers `event`, so this one should do nothing.
  *
- * `shim` is the path the hook was started from (`process.argv[1]`).
+ * `shim` is the path the hook was started from (`process.argv[1]`). `payload`
+ * is the hook's stdin, when the caller has it: a host that doesn't run the
+ * ~/.claude copy never stands down.
  */
-export declare function globalCopyCovers(event: string, shim: string | undefined, home?: string): boolean;
+export declare function globalCopyCovers(event: string, shim: string | undefined, home?: string, env?: NodeJS.ProcessEnv, payload?: unknown): boolean;
 //# sourceMappingURL=hook-layers.d.ts.map

package/dist/claude/hook-layers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-layers.d.ts","sourceRoot":"","sources":["../../src/claude/hook-layers.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CA2B3G"}
+{"version":3,"file":"hook-layers.d.ts","sourceRoot":"","sources":["../../src/claude/hook-layers.ts"],"names":[],"mappings":"AAmCA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,MAAkB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CA+BpK"}

package/dist/claude/hook-layers.js

@@ -12,6 +12,11 @@
  * looks for `@nanonets/graft` alone, and standing down for it would leave a
  * trail-only machine with no hooks at all. The next session start rewrites it.
  *
+ * Who sent the payload decides first. Claude Code runs both copies, and so
+ * does Cursor (it loads ~/.claude/settings.json beside the repo's). Copilot
+ * CLI reads only the repo's settings, so under it, and under any payload no
+ * host claims, the repo copy answers: twice is better than never.
+ *
  * Reads two small files and imports nothing heavier than node:fs, since every
  * hook loads it.
  */
@@ -19,17 +24,29 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
 import { PACKAGE_FOR } from "../brand.js";
-/** `node "<shim>" <event>`, the form hosts/claude-global.ts writes. */
-const COMMAND = /^node\s+"([^"]+)"\s+(\S+)$/;
+import { detectHost } from "../trace/host.js";
+/** Hosts that run the ~/.claude copy as well as the repo's. */
+const RUNS_GLOBAL_COPY = new Set(["claude", "cursor"]);
+/** `node "<shim>" <event>`, the form hosts/claude-global.ts writes, with the
+ * `|| exit 0` PreToolUse carries (settings-merge.ts failOpen). */
+const COMMAND = /^node\s+"([^"]+)"\s+(\S+)(?:\s+\|\|\s+exit\s+0)?$/;
 /**
  * True when this hook process runs from the repo's shim and the `~/.claude`
  * copy also answers `event`, so this one should do nothing.
  *
- * `shim` is the path the hook was started from (`process.argv[1]`).
+ * `shim` is the path the hook was started from (`process.argv[1]`). `payload`
+ * is the hook's stdin, when the caller has it: a host that doesn't run the
+ * ~/.claude copy never stands down.
  */
-export function globalCopyCovers(event, shim, home = homedir()) {
+export function globalCopyCovers(event, shim, home = homedir(), env = process.env, payload) {
     if (!shim)
         return false;
+    if (payload !== undefined && !RUNS_GLOBAL_COPY.has(detectHost(payload).host))
+        return false;
+    // Claude Code reads its user settings from CLAUDE_CONFIG_DIR when that is
+    // set, and then never runs the ~/.claude copy: this one has to answer.
+    if (env.CLAUDE_CONFIG_DIR && resolve(env.CLAUDE_CONFIG_DIR) !== resolve(home, ".claude"))
+        return false;
     const at = resolve(dirname(shim));
     // Only Claude Code's repo copy, in `.claude/helpers/` or trail's `.trail/`:
     // Cursor's and Codex's shims call the same entry, and Claude's ~/.claude

package/dist/claude/hook-layers.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-layers.js","sourceRoot":"","sources":["../../src/claude/hook-layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,uEAAuE;AACvE,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAwB,EAAE,OAAe,OAAO,EAAE;IAChG,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,4EAA4E;IAC5E,yEAAyE;IACzE,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAClH,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,EAAE,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,CAAC,6BAA6B;IAC/D,IAAI,QAA6C,CAAC;IAClD,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAK,KAAkD,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;gBACpF,MAAM,CAAC,GAAG,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACvF,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,KAAK,OAAO;oBAAE,SAAS;gBAC1E,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;oBAAE,OAAO,IAAI,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mEAAmE;AACnE,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"hook-layers.js","sourceRoot":"","sources":["../../src/claude/hook-layers.ts"],"names":[],"mappings":"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"}

package/dist/claude/hooks.d.ts

@@ -1,19 +1,6 @@
+import type { HookOut } from '../skills/types.js';
+export { lastFileScopeHint, promptAskTimeout } from './prompt-hook.js';
 export declare function underGraft(dir: string, file: string): boolean;
-/**
- * How long the prompt hook may let `graft ask` run — derived from the budget that is
- * *actually installed* in this repo's `.claude/settings.json`, not from what the
- * current version of `settings-merge.ts` would install.
- *
- * A query now brings the graph up to date first, so `graft init` raises the
- * UserPromptSubmit budget to 15s to cover the one cold rebuild after an upgrade. But
- * `mergeGraftSettings` only runs during `graft init` — upgrading the npm package does
- * not re-run it. So every repo wired before that change keeps `"timeout": 8000`, and
- * hard-coding a 13s child there means Claude Code kills the hook first: `emit()` and
- * `writeSession()` never run, the turn gets no retrieval pack at all, and the SIGKILLed
- * child can't even release the build lock. Reading the installed number keeps the child
- * strictly inside whatever budget this repo really has.
- */
-export declare function promptAskTimeout(dir: string): number;
 /**
  * The absolute path of the file a PostToolUse edit touched, across host edit-tool
  * shapes:
@@ -27,22 +14,6 @@ export declare function promptAskTimeout(dir: string): number;
  * Returns null when neither shape yields a path, so the hook stays a clean no-op.
  */
 export declare function editedFilePath(input: any, dir: string): string | null;
-/**
- * The "you're working in backend/, weight it" hint: on a multi-scope repo,
- * narrow the prompt hook's `ask` call to whatever scope the last-edited file
- * (`stats.lastFile`, captured at {@link handlePostEdit}) sits in.
- *
- * `lastFile` is only a basename (not a repo-relative path — see
- * `handlePostEdit`), so this is a best-effort lookup against the CURRENT
- * graph: any file node whose path ends in `/<lastFile>` (or equals it, for a
- * repo-root file). Fails soft in every direction a hook must never crash on —
- * no graph, a single-scope graph, a lastFile no longer in the graph (moved,
- * deleted, or edited before the first build), or a basename that lands in
- * more than one scope (ambiguous: could be either sub-project) all skip the
- * hint silently, logging one line to stderr so the miss is visible without
- * ever failing the hook.
- */
-export declare function lastFileScopeHint(dir: string, lastFile: string | null | undefined): string | null;
 /**
  * Under trail, the learnings about the file a Read, Edit or Write just touched,
  * or that a shell command (`sed -n 1,40p src/a.ts`, `cat`, a test run) names,
@@ -50,6 +21,12 @@ export declare function lastFileScopeHint(dir: string, lastFile: string | null |
  * carries the learnings that bear on it. Never throws.
  */
 export declare function learningsOnTouch(input: any, dir: string): string | null;
+/**
+ * PostToolUse's one answer: the skills part's, with the learnings about what
+ * the call touched added to its context. Two JSON objects on stdout would be
+ * read as neither. A block is the whole answer, so then no learning is used up.
+ */
+export declare function withTouchLearnings(out: HookOut, input: any, dir: string): HookOut;
 /**
  * Once a day per repo, the `repo_seen` event: whether `.trail/` is committed
  * here, how many learnings it holds, and whether this machine shares the repo
@@ -65,7 +42,7 @@ export declare function trackRepoSeen(dir: string, now?: number): void;
  */
 export declare function trackLearningsCommitted(dir: string): void;
 /**
- * Team learnings sitting uncommitted in `.trail/learnings/` (from trail init's
+ * Learnings added to this repo but sitting uncommitted in `.trail/learnings/` (from trail init's
  * read of past sessions, or a session that ended before committing) reach no
  * teammate. Once a day per repo, the first reply says so, with the line that
  * makes the case for committing them. Empty when everything is committed.

package/dist/claude/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/claude/hooks.ts"],"names":[],"mappings":"AAgDA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI7D;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAkGD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAgDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAyBjG;AA4BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBvE;AAsKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,IAAI,CAgBjE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAqBzD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAuB1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAa1D;AAED,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAiCxC,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FvD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/claude/hooks.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAUlD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAevE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI7D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAwED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBvE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAKjF;AAoED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,IAAI,CAgBjE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAqBzD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAuB1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAa1D;AAED,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAwGxC,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFvD"}