@moxxy/plugin-self-update 0.26.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/classify.d.ts

@@ -0,0 +1,33 @@
+import type { EventLogReader } from '@moxxy/sdk';
+/**
+ * Request classification for self-update. The *signals* are gathered
+ * deterministically here; the *decision* is advisory — the orchestrating
+ * skill makes the final call. This keeps mechanical inspection in code and
+ * judgement in the prompt (mirroring how self-improver splits the two).
+ */
+export type Tier = 'skill' | 'plugin' | 'core';
+export interface ClassifyInput {
+    readonly trigger: 'error' | 'request';
+    readonly text?: string;
+}
+export interface ClassifySignals {
+    readonly failedTools: ReadonlyArray<string>;
+    readonly errorMessages: ReadonlyArray<string>;
+    readonly registeredTools: ReadonlyArray<string>;
+}
+export interface ClassifyResult {
+    readonly tier: Tier;
+    readonly candidateName?: string;
+    readonly evidence: ReadonlyArray<string>;
+    readonly rationale: string;
+}
+/** Gather deterministic signals from the session event log. */
+export declare function gatherSignals(log: EventLogReader, registeredTools: ReadonlyArray<string>, lookback?: number): ClassifySignals;
+/** Suggest a kebab-case artifact name from free text. */
+export declare function suggestName(text: string | undefined): string | undefined;
+/**
+ * Decide the lowest-risk tier that can satisfy the request, plus the evidence
+ * behind that suggestion. Always advisory.
+ */
+export declare function classify(input: ClassifyInput, signals: ClassifySignals): ClassifyResult;
+//# sourceMappingURL=classify.d.ts.map

package/dist/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AAEH,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAsCD,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,EACtC,QAAQ,SAAK,GACZ,eAAe,CAsBjB;AAUD,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASxE;AAqBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,CAmFvF"}

package/dist/classify.js

@@ -0,0 +1,177 @@
+const CORE_HINTS = [
+    '@moxxy/core',
+    'packages/core',
+    'core/src',
+    'run-turn',
+    'session.ts',
+    'event log',
+    'new event type',
+    'loop strategy internals',
+    'registry internals',
+];
+const SKILL_HINTS = [
+    'always',
+    'whenever',
+    'every time',
+    'remember to',
+    'before you',
+    'workflow',
+    'procedure',
+    'instruction',
+];
+const PLUGIN_HINTS = [
+    'add a tool',
+    'new tool',
+    'integrate',
+    'integration',
+    'connect to',
+    'call the',
+    ' api',
+    'command that',
+    'wrap',
+    'override',
+];
+/** Gather deterministic signals from the session event log. */
+export function gatherSignals(log, registeredTools, lookback = 40) {
+    const callNames = new Map();
+    for (const e of log.ofType('tool_call_requested')) {
+        callNames.set(String(e.callId), e.name);
+    }
+    const recent = log.slice(Math.max(0, log.length - lookback));
+    const failedTools = new Set();
+    const errorMessages = [];
+    for (const e of recent) {
+        if (e.type === 'tool_result' && !e.ok) {
+            const name = callNames.get(String(e.callId));
+            if (name)
+                failedTools.add(name);
+            if (e.error?.message)
+                errorMessages.push(e.error.message);
+        }
+        else if (e.type === 'error') {
+            errorMessages.push(e.message);
+        }
+    }
+    return {
+        failedTools: [...failedTools],
+        errorMessages,
+        registeredTools,
+    };
+}
+function includesAny(haystack, needles) {
+    const lower = haystack.toLowerCase();
+    for (const n of needles) {
+        if (lower.includes(n))
+            return n;
+    }
+    return null;
+}
+/** Suggest a kebab-case artifact name from free text. */
+export function suggestName(text) {
+    if (!text)
+        return undefined;
+    const words = text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !STOP_WORDS.has(w))
+        .slice(0, 4);
+    return words.length > 0 ? words.join('-') : undefined;
+}
+const STOP_WORDS = new Set([
+    'the',
+    'and',
+    'for',
+    'add',
+    'can',
+    'you',
+    'please',
+    'that',
+    'this',
+    'with',
+    'make',
+    'create',
+    'want',
+    'would',
+    'like',
+    'your',
+]);
+/**
+ * Decide the lowest-risk tier that can satisfy the request, plus the evidence
+ * behind that suggestion. Always advisory.
+ */
+export function classify(input, signals) {
+    const evidence = [];
+    const blob = `${input.text ?? ''} ${signals.errorMessages.join(' ')}`;
+    const coreHit = includesAny(blob, CORE_HINTS);
+    if (coreHit) {
+        evidence.push(`mentions core internals ("${coreHit}")`);
+        return {
+            tier: 'core',
+            evidence,
+            rationale: 'The change appears to touch @moxxy/core internals — escalate to a Tier-2 core patch (build + overlay + restart). Confirm a plugin override cannot express it first.',
+        };
+    }
+    // A referenced-but-unregistered capability ⇒ a new plugin/tool is needed.
+    const missing = signals.failedTools.filter((t) => !signals.registeredTools.includes(t));
+    if (missing.length > 0) {
+        evidence.push(`failed call to unregistered tool(s): ${missing.join(', ')}`);
+        return {
+            tier: 'plugin',
+            candidateName: suggestName(input.text) ?? missing[0],
+            evidence,
+            rationale: 'A capability is missing. Author a new plugin (or install a published one) that provides the tool, then hot-reload.',
+        };
+    }
+    // An existing tool misbehaved ⇒ usually instructions (skill) or a hook wrapper.
+    if (signals.failedTools.length > 0) {
+        evidence.push(`registered tool(s) misbehaved: ${signals.failedTools.join(', ')}`);
+        const pluginHit = includesAny(blob, PLUGIN_HINTS);
+        if (pluginHit) {
+            evidence.push(`request implies a behavior override ("${pluginHit}")`);
+            return {
+                tier: 'plugin',
+                candidateName: suggestName(input.text),
+                evidence,
+                rationale: 'An existing tool misbehaves and the fix is a behavior change — wrap it in a plugin (onToolResult / onToolCall) rather than editing core.',
+            };
+        }
+        return {
+            tier: 'skill',
+            candidateName: suggestName(input.text),
+            evidence,
+            rationale: 'The tool exists but was used wrongly — a skill that encodes the correct procedure is the lowest-risk fix.',
+        };
+    }
+    // No error signal: classify the free-text request.
+    const skillHit = includesAny(blob, SKILL_HINTS);
+    const pluginHit = includesAny(blob, PLUGIN_HINTS);
+    if (pluginHit && !skillHit) {
+        evidence.push(`request implies a new capability ("${pluginHit}")`);
+        return {
+            tier: 'plugin',
+            candidateName: suggestName(input.text),
+            evidence,
+            rationale: 'The request asks for a new action/capability — author a plugin tool and hot-reload.',
+        };
+    }
+    if (skillHit) {
+        evidence.push(`request describes a procedure ("${skillHit}")`);
+        return {
+            tier: 'skill',
+            candidateName: suggestName(input.text),
+            evidence,
+            rationale: 'The request is a recurring procedure expressible with existing tools — author a skill.',
+        };
+    }
+    // Default for an unqualified "add XYZ": prefer a plugin (capability), the
+    // common case, but the skill should reconsider a skill if no code is needed.
+    evidence.push('no strong signal; defaulting to the plugin tier');
+    return {
+        tier: 'plugin',
+        candidateName: suggestName(input.text),
+        evidence,
+        rationale: 'Ambiguous request. Default to authoring a plugin; if the change needs no new code (only instructions), drop to the skill tier instead.',
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

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

package/dist/core-tools/apply.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDef } from '@moxxy/sdk';
+import { type CoreToolDeps } from './shared.js';
+export declare function coreApplyTool(cd: CoreToolDeps): ToolDef;
+//# sourceMappingURL=apply.d.ts.map

package/dist/core-tools/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/core-tools/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1E,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAqCvD"}

package/dist/core-tools/apply.js

@@ -0,0 +1,43 @@
+import { defineTool, z } from '@moxxy/sdk';
+import { overlayPackages, readCoreJournal, restoreOverlay, writeCoreJournal } from '../core-update.js';
+import { emitSafe } from '../deps.js';
+import { resolveCore, snapshotDir } from './shared.js';
+// ── self_update_core_apply ──────────────────────────────────────────────────
+export function coreApplyTool(cd) {
+    const { deps } = cd;
+    return defineTool({
+        name: 'self_update_core_apply',
+        description: 'Overlay the verified build into the live global install (snapshotting the previous dist for rollback) and stage a restart. The new core code only activates after moxxy restarts. Requires a prior successful self_update_core_verify.',
+        inputSchema: z.object({ coreTxnId: z.string().min(1) }),
+        permission: { action: 'prompt' },
+        handler: async (input, ctx) => {
+            const journal = await readCoreJournal(deps.moxxyDir, input.coreTxnId);
+            if (journal.state !== 'verified') {
+                throw new Error(`core txn ${input.coreTxnId} is "${journal.state}", not "verified" — run self_update_core_verify first`);
+            }
+            const install = resolveCore(cd);
+            if (!install)
+                throw new Error('could not resolve @moxxy/core');
+            const res = await overlayPackages({
+                repo: journal.repoDir,
+                install,
+                pkgNames: journal.packages,
+                snapshotDir: snapshotDir(deps.moxxyDir, input.coreTxnId),
+            });
+            if (!res.ok) {
+                await restoreOverlay({ install, pkgNames: journal.packages, snapshotDir: snapshotDir(deps.moxxyDir, input.coreTxnId) }).catch(() => undefined);
+                throw new Error(`overlay failed and was rolled back: ${res.message}`);
+            }
+            journal.state = 'staged_restart';
+            await writeCoreJournal(deps.moxxyDir, journal);
+            await emitSafe(deps, ctx, 'core_apply', { txnId: input.coreTxnId, applied: res.applied });
+            return {
+                ok: true,
+                applied: res.applied,
+                restartRequired: true,
+                message: 'Core patch overlaid. RESTART moxxy to activate it (re-run `moxxy`, or it restarts on the next launch under a supervisor). It will be committed automatically on a clean boot; use self_update_core_rollback if needed.',
+            };
+        },
+    });
+}
+//# sourceMappingURL=apply.js.map

package/dist/core-tools/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/core-tools/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,CAAC,EAAkC,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AAE1E,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,EAAgB;IAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACpB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,wOAAwO;QAC1O,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;QAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAgB,EAAE,EAAE;YACzC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACtE,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC,SAAS,QAAQ,OAAO,CAAC,KAAK,uDAAuD,CAAC,CAAC;YAC3H,CAAC;YACD,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC;gBAChC,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,OAAO;gBACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;aACzD,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,cAAc,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC/I,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC;YACjC,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1F,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,eAAe,EAAE,IAAI;gBACrB,OAAO,EACL,wNAAwN;aAC3N,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core-tools/begin.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDef } from '@moxxy/sdk';
+import { type CoreToolDeps } from './shared.js';
+export declare function coreBeginTool(cd: CoreToolDeps): ToolDef;
+//# sourceMappingURL=begin.d.ts.map

package/dist/core-tools/begin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"begin.d.ts","sourceRoot":"","sources":["../../src/core-tools/begin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAW3E,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7D,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CA+EvD"}

package/dist/core-tools/begin.js

@@ -0,0 +1,76 @@
+import { defineTool, z } from '@moxxy/sdk';
+import { corePreflight, countCorruptCoreTxns, listCoreTxns, newCoreTxnId, provisionWorkspace, writeCoreJournal, } from '../core-update.js';
+import { emitSafe } from '../deps.js';
+import { resolveCore } from './shared.js';
+// ── self_update_core_begin ──────────────────────────────────────────────────
+export function coreBeginTool(cd) {
+    const { deps } = cd;
+    return defineTool({
+        name: 'self_update_core_begin',
+        description: 'Start a Tier-2 core patch: provision a source clone pinned to the EXACT installed commit (git clone/fetch + checkout gitHead + pnpm install — this can take minutes) and open a transaction. Returns a coreTxnId and the repo path. Edit files ONLY via self_update_core_write / self_update_core_edit, then self_update_core_verify. Prefer a Tier-1 plugin override first — only patch core when truly unavoidable.',
+        inputSchema: z.object({
+            packages: z
+                .array(z.string().min(1))
+                .min(1)
+                .describe('Affected @moxxy/* package names, e.g. ["@moxxy/core"].'),
+        }),
+        permission: { action: 'prompt' },
+        handler: async (input, ctx) => {
+            const install = resolveCore(cd);
+            if (!install)
+                throw new Error('could not resolve the installed @moxxy/core — cannot self-update core');
+            // Fail CLOSED on a corrupt journal: an unparseable in-flight journal would
+            // otherwise vanish from listCoreTxns and let this begin clobber the shared
+            // repoDir. Refuse rather than risk concurrent overlay corruption.
+            const corrupt = await countCorruptCoreTxns(deps.moxxyDir);
+            if (corrupt > 0) {
+                throw new Error(`${corrupt} core-update transaction journal(s) are corrupt/unreadable — refusing to start a ` +
+                    `new core update (the serialization guard can't see them). Inspect ` +
+                    `~/.moxxy/self-update/core-txns and resolve them before retrying.`);
+            }
+            // Serialize core transactions: only ONE may be in flight at a time. Every
+            // txn shares the single provisioned workspace (repoDir), so a second
+            // concurrent txn would clobber the first's edits + build. Refuse rather
+            // than corrupt — the active txn must be finished (verify → commit) or
+            // released (self_update_core_rollback, which is a no-op overlay restore +
+            // marks it rolled_back even when nothing was applied yet).
+            const active = (await listCoreTxns(deps.moxxyDir)).find((j) => j.state !== 'committed' && j.state !== 'rolled_back');
+            if (active) {
+                throw new Error(`a core update is already in progress (txn ${active.txnId}, state "${active.state}"). ` +
+                    `Finish it (self_update_core_verify → self_update_commit) or release it with ` +
+                    `self_update_core_rollback({ coreTxnId: "${active.txnId}" }) before starting another.`);
+            }
+            const pf = await corePreflight(install);
+            if (!pf.ok) {
+                throw new Error(`core update preflight failed: ${pf.checks.filter((c) => !c.ok).map((c) => `${c.id} (${c.detail})`).join('; ')}`);
+            }
+            const prov = await provisionWorkspace({
+                moxxyDir: deps.moxxyDir,
+                install,
+                ...(deps.coreUpdate?.repoUrlOverride ? { repoUrlOverride: deps.coreUpdate.repoUrlOverride } : {}),
+            });
+            if (!prov.ok)
+                throw new Error(`provisioning failed (escalate to the user): ${prov.message}`);
+            const txnId = newCoreTxnId();
+            const journal = {
+                txnId,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                packages: [...input.packages],
+                version: install.version,
+                ...(install.gitHead ? { gitHead: install.gitHead } : {}),
+                repoDir: prov.repoDir,
+                state: 'provisioned',
+                attempts: [],
+            };
+            await writeCoreJournal(deps.moxxyDir, journal);
+            await emitSafe(deps, ctx, 'core_begin', { txnId, packages: journal.packages, version: install.version });
+            return {
+                coreTxnId: txnId,
+                repoDir: prov.repoDir,
+                next: 'Edit files under the repo with self_update_core_write / self_update_core_edit (paths relative to the repo), then call self_update_core_verify.',
+            };
+        },
+    });
+}
+//# sourceMappingURL=begin.js.map

package/dist/core-tools/begin.js.map

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

package/dist/core-tools/edit.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDef } from '@moxxy/sdk';
+import type { CoreToolDeps } from './shared.js';
+export declare function coreEditTool(cd: CoreToolDeps): ToolDef;
+//# sourceMappingURL=edit.d.ts.map

package/dist/core-tools/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/core-tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAyBtD"}

package/dist/core-tools/edit.js

@@ -0,0 +1,33 @@
+import { promises as fs } from 'node:fs';
+import { defineTool, z } from '@moxxy/sdk';
+import { readCoreJournal, safeRepoPath } from '../core-update.js';
+import { emitSafe } from '../deps.js';
+// ── self_update_core_edit ───────────────────────────────────────────────────
+export function coreEditTool(cd) {
+    const { deps } = cd;
+    return defineTool({
+        name: 'self_update_core_edit',
+        description: 'Find-and-replace a unique string in a file inside the provisioned core clone (path relative to the repo root). Approval-gated.',
+        inputSchema: z.object({
+            coreTxnId: z.string().min(1),
+            file: z.string().min(1),
+            oldString: z.string().min(1),
+            newString: z.string(),
+        }),
+        permission: { action: 'prompt' },
+        handler: async (input, ctx) => {
+            const journal = await readCoreJournal(deps.moxxyDir, input.coreTxnId);
+            const abs = safeRepoPath(journal.repoDir, input.file);
+            const cur = await fs.readFile(abs, 'utf8');
+            const count = cur.split(input.oldString).length - 1;
+            if (count === 0)
+                throw new Error(`oldString not found in ${input.file}`);
+            if (count > 1)
+                throw new Error(`oldString is not unique in ${input.file} (${count} matches)`);
+            await fs.writeFile(abs, cur.replace(input.oldString, input.newString), 'utf8');
+            await emitSafe(deps, ctx, 'core_edit', { txnId: input.coreTxnId, file: input.file });
+            return { ok: true, edited: input.file };
+        },
+    });
+}
+//# sourceMappingURL=edit.js.map

package/dist/core-tools/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/core-tools/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,CAAC,EAAkC,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACpB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,gIAAgI;QAClI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,CAAC;QACF,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;QAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAgB,EAAE,EAAE;YACzC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,IAAI,KAAK,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,CAAC,IAAI,KAAK,KAAK,WAAW,CAAC,CAAC;YAC9F,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;YAC/E,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core-tools/index.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDef } from '@moxxy/sdk';
+import type { SelfUpdateDeps } from '../deps.js';
+export type { CoreToolDeps } from './shared.js';
+/**
+ * Composes the Tier-2 core-update tools from per-tool factories (mirroring the
+ * Tier-1 layout). `fromUrl` is the module URL used to resolve the live
+ * `@moxxy/core` install (the plugin entry's `import.meta.url`). Order preserved
+ * exactly as before extraction.
+ */
+export declare function coreTools(deps: SelfUpdateDeps, fromUrl: string): ToolDef[];
+//# sourceMappingURL=index.d.ts.map

package/dist/core-tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAY1E"}

package/dist/core-tools/index.js

@@ -0,0 +1,28 @@
+import { coreApplyTool } from './apply.js';
+import { coreBeginTool } from './begin.js';
+import { coreEditTool } from './edit.js';
+import { corePreflightTool } from './preflight.js';
+import { coreRollbackTool } from './rollback.js';
+import { coreStatusTool } from './status.js';
+import { coreVerifyTool } from './verify.js';
+import { coreWriteTool } from './write.js';
+/**
+ * Composes the Tier-2 core-update tools from per-tool factories (mirroring the
+ * Tier-1 layout). `fromUrl` is the module URL used to resolve the live
+ * `@moxxy/core` install (the plugin entry's `import.meta.url`). Order preserved
+ * exactly as before extraction.
+ */
+export function coreTools(deps, fromUrl) {
+    const cd = { deps, fromUrl };
+    return [
+        corePreflightTool(cd),
+        coreBeginTool(cd),
+        coreWriteTool(cd),
+        coreEditTool(cd),
+        coreVerifyTool(cd),
+        coreApplyTool(cd),
+        coreRollbackTool(cd),
+        coreStatusTool(cd),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/core-tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core-tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAoB,EAAE,OAAe;IAC7D,MAAM,EAAE,GAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3C,OAAO;QACL,iBAAiB,CAAC,EAAE,CAAC;QACrB,aAAa,CAAC,EAAE,CAAC;QACjB,aAAa,CAAC,EAAE,CAAC;QACjB,YAAY,CAAC,EAAE,CAAC;QAChB,cAAc,CAAC,EAAE,CAAC;QAClB,aAAa,CAAC,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,CAAC;QACpB,cAAc,CAAC,EAAE,CAAC;KACnB,CAAC;AACJ,CAAC"}

package/dist/core-tools/preflight.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDef } from '@moxxy/sdk';
+import { type CoreToolDeps } from './shared.js';
+export declare function corePreflightTool(cd: CoreToolDeps): ToolDef;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/core-tools/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/core-tools/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAS3D"}

package/dist/core-tools/preflight.js

@@ -0,0 +1,14 @@
+import { defineTool, z } from '@moxxy/sdk';
+import { corePreflight } from '../core-update.js';
+import { resolveCore } from './shared.js';
+// ── self_update_core_preflight ──────────────────────────────────────────────
+export function corePreflightTool(cd) {
+    return defineTool({
+        name: 'self_update_core_preflight',
+        description: 'Read-only. Check whether a Tier-2 core patch is even possible: git + pnpm present, @moxxy/core resolvable, a pinned source commit (gitHead) and repo URL in its published metadata. Run this BEFORE attempting to patch @moxxy/core; if any check fails, do not start — tell the user.',
+        inputSchema: z.object({}),
+        permission: { action: 'allow' },
+        handler: async () => corePreflight(resolveCore(cd)),
+    });
+}
+//# sourceMappingURL=preflight.js.map

package/dist/core-tools/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/core-tools/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,CAAC,EAAgB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AAE7D,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,EAAgB;IAChD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,wRAAwR;QAC1R,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAC/B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/core-tools/rollback.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDef } from '@moxxy/sdk';
+import { type CoreToolDeps } from './shared.js';
+export declare function coreRollbackTool(cd: CoreToolDeps): ToolDef;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/core-tools/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/core-tools/rollback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAuB1D"}

package/dist/core-tools/rollback.js

@@ -0,0 +1,30 @@
+import { defineTool, z } from '@moxxy/sdk';
+import { gcCoreTxns, readCoreJournal, restoreOverlay, writeCoreJournal } from '../core-update.js';
+import { emitSafe } from '../deps.js';
+import { resolveCore, snapshotDir } from './shared.js';
+// ── self_update_core_rollback ───────────────────────────────────────────────
+export function coreRollbackTool(cd) {
+    const { deps } = cd;
+    return defineTool({
+        name: 'self_update_core_rollback',
+        description: 'Undo a core overlay: restore the previous dist from the snapshot. A restart is required to drop the patched code. Use if a core patch built+loaded but misbehaves.',
+        inputSchema: z.object({ coreTxnId: z.string().min(1), reason: z.string().optional() }),
+        permission: { action: 'allow' },
+        handler: async (input, ctx) => {
+            const journal = await readCoreJournal(deps.moxxyDir, input.coreTxnId);
+            const install = resolveCore(cd);
+            if (!install)
+                throw new Error('could not resolve @moxxy/core');
+            await restoreOverlay({ install, pkgNames: journal.packages, snapshotDir: snapshotDir(deps.moxxyDir, input.coreTxnId) });
+            journal.state = 'rolled_back';
+            await writeCoreJournal(deps.moxxyDir, journal);
+            await emitSafe(deps, ctx, 'core_rollback', { txnId: input.coreTxnId, reason: input.reason ?? null });
+            // Reclaim disk now: this txn is terminal, and its (large) dist snapshot is
+            // no longer needed. Prune older terminal core txns too. Best-effort — keep
+            // the freshly-rolled-back one + recent history. Mirrors maxTxnRetained.
+            await gcCoreTxns(deps.moxxyDir, deps.maxTxnRetained ?? 5).catch(() => undefined);
+            return { ok: true, restored: journal.packages, restartRequired: true };
+        },
+    });
+}
+//# sourceMappingURL=rollback.js.map

package/dist/core-tools/rollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.js","sourceRoot":"","sources":["../../src/core-tools/rollback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,CAAC,EAAkC,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AAE1E,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,EAAgB;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACpB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,oKAAoK;QACtK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtF,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAgB,EAAE,EAAE;YACzC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/D,MAAM,cAAc,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACxH,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC;YAC9B,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;YACrG,2EAA2E;YAC3E,2EAA2E;YAC3E,wEAAwE;YACxE,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACjF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core-tools/shared.d.ts

@@ -0,0 +1,16 @@
+import { type SelfUpdateDeps } from '../deps.js';
+import type { CoreInstallInfo } from '../core-update.js';
+/**
+ * Context threaded into every Tier-2 core-tool factory. `fromUrl` is the
+ * module URL used to resolve the live `@moxxy/core` install (defaults to the
+ * plugin entry's `import.meta.url`, overridable via deps.coreUpdate.fromUrl).
+ */
+export interface CoreToolDeps {
+    readonly deps: SelfUpdateDeps;
+    readonly fromUrl: string;
+}
+/** Where a given core transaction parks its pre-overlay dist snapshot. */
+export declare function snapshotDir(moxxyDir: string, txnId: string): string;
+/** Resolve the live `@moxxy/core` install for this plugin's deps. */
+export declare function resolveCore(c: CoreToolDeps): CoreInstallInfo | null;
+//# sourceMappingURL=shared.d.ts.map

package/dist/core-tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/core-tools/shared.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,eAAe,GAAG,IAAI,CAEnE"}

package/dist/core-tools/shared.js

@@ -0,0 +1,12 @@
+import * as path from 'node:path';
+import { coreTxnDir } from '../core-update.js';
+import { resolveCoreInstall } from '../deps.js';
+/** Where a given core transaction parks its pre-overlay dist snapshot. */
+export function snapshotDir(moxxyDir, txnId) {
+    return path.join(coreTxnDir(moxxyDir, txnId), 'snapshot');
+}
+/** Resolve the live `@moxxy/core` install for this plugin's deps. */
+export function resolveCore(c) {
+    return resolveCoreInstall(c.deps, c.fromUrl);
+}
+//# sourceMappingURL=shared.js.map

package/dist/core-tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/core-tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AAarE,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,KAAa;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,CAAe;IACzC,OAAO,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core-tools/status.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDef } from '@moxxy/sdk';
+import type { CoreToolDeps } from './shared.js';
+export declare function coreStatusTool(cd: CoreToolDeps): ToolDef;
+//# sourceMappingURL=status.d.ts.map

package/dist/core-tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/core-tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAoBxD"}