@halyard/cli 0.1.1 → 0.2.0

package/dist/lib/setup-hooks.js

@@ -0,0 +1,276 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { asObject, formatError, readJsonFile, writeJsonFile } from './config-files.js';
+/**
+ * `halyard setup` scaffolding for session upload: a tiny launcher plus one
+ * lifecycle-hook config per client, all pointing at `halyard hook`.
+ *
+ * Merges are idempotent and keyed on the launcher path, so re-running setup
+ * (or after a template change) updates our entries and leaves everything else alone.
+ */
+export const HOOK_LAUNCHER_PATH = '.halyard/hook.sh';
+export function launcherScript() {
+    return `#!/bin/sh
+# Generated by \`halyard setup\`. Forwards agent lifecycle hooks to \`halyard hook\`
+# when the Halyard CLI is available, and exits 0 otherwise so the agent is
+# never blocked. Re-run \`halyard setup\` to regenerate.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+if [ -f "$ROOT/apps/cli/dist/cli.js" ] && grep -q '"name": "@halyard/cli"' "$ROOT/apps/cli/package.json" 2>/dev/null; then
+  exec node "$ROOT/apps/cli/dist/cli.js" hook --root "$ROOT" "$@"
+fi
+BIN="$ROOT/node_modules/.bin/halyard"
+[ -x "$BIN" ] || BIN="$(command -v halyard 2>/dev/null || true)"
+[ -n "$BIN" ] || exit 0
+# Older CLI releases have no \`hook\` command (and answer \`--help\` for any word).
+"$BIN" --help 2>/dev/null | grep -q '^  hook' || exit 0
+exec "$BIN" hook --root "$ROOT" "$@"
+`;
+}
+function hookArgs(client, event) {
+    return `--client ${client} --event ${event}`;
+}
+export function claudeHookSpec() {
+    const command = (event) => `"$CLAUDE_PROJECT_DIR"/${HOOK_LAUNCHER_PATH} ${hookArgs('claude', event)}`;
+    return {
+        start: {
+            type: 'command',
+            command: command('start'),
+            timeout: 10,
+            statusMessage: 'Sweeping unsynced agent sessions...',
+        },
+        end: {
+            type: 'command',
+            command: command('end'),
+            timeout: 60,
+            statusMessage: 'Uploading agent session to Halyard...',
+        },
+    };
+}
+/** Codex caps SessionEnd at 3 seconds, so the end hook detaches. */
+export function codexHookSpec() {
+    const prefix = 'cd "${CODEX_CWD:-$PWD}" && ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)" && "$ROOT"/';
+    return {
+        start: {
+            type: 'command',
+            command: `${prefix}${HOOK_LAUNCHER_PATH} ${hookArgs('codex', 'start')}`,
+            timeout: 10,
+        },
+        end: {
+            type: 'command',
+            command: `${prefix}${HOOK_LAUNCHER_PATH} ${hookArgs('codex', 'end')} --detach`,
+            timeout: 3,
+        },
+    };
+}
+/** Gemini timeouts are milliseconds and entries carry a name. */
+export function geminiHookSpec() {
+    const command = (event) => `"$GEMINI_PROJECT_DIR"/${HOOK_LAUNCHER_PATH} ${hookArgs('gemini', event)}`;
+    return {
+        start: {
+            type: 'command',
+            name: 'halyard-session-sweep',
+            command: command('start'),
+            timeout: 10_000,
+        },
+        end: {
+            type: 'command',
+            name: 'halyard-session-upload',
+            command: command('end'),
+            timeout: 60_000,
+        },
+    };
+}
+function isLauncherEntry(entry) {
+    const command = entry['command'] ?? entry['bash'];
+    return typeof command === 'string' && command.includes(HOOK_LAUNCHER_PATH);
+}
+/** Claude-shaped: event → [{ matcher?, hooks: [entry, ...] }]. */
+function upsertGrouped(groupsValue, hook) {
+    const groups = Array.isArray(groupsValue) ? groupsValue.map(asObject) : [];
+    let placed = false;
+    const next = groups.map((group) => {
+        const entries = Array.isArray(group['hooks']) ? group['hooks'].map(asObject) : [];
+        const index = entries.findIndex(isLauncherEntry);
+        if (index === -1)
+            return group;
+        placed = true;
+        entries[index] = hook;
+        return { ...group, hooks: entries };
+    });
+    if (!placed)
+        next.push({ hooks: [hook] });
+    return next;
+}
+/** Cursor-shaped: event → [entry, ...]. */
+function upsertFlat(listValue, entry) {
+    const list = Array.isArray(listValue) ? listValue.map(asObject) : [];
+    const index = list.findIndex(isLauncherEntry);
+    if (index === -1)
+        list.push(entry);
+    else
+        list[index] = entry;
+    return list;
+}
+/** Merge start/end hooks into a Claude-shaped settings object (Claude, Codex, Gemini). */
+export function mergeLifecycleHooks(input, spec, events = { start: 'SessionStart', end: 'SessionEnd' }) {
+    const settings = asObject(input);
+    const hooks = asObject(settings['hooks']);
+    hooks[events.start] = upsertGrouped(hooks[events.start], spec.start);
+    hooks[events.end] = upsertGrouped(hooks[events.end], spec.end);
+    return { ...settings, hooks };
+}
+export function mergeCursorHooks(input) {
+    const config = asObject(input);
+    const hooks = asObject(config['hooks']);
+    const entry = (event) => ({
+        command: `./${HOOK_LAUNCHER_PATH} ${hookArgs('cursor', event)}`,
+        timeout: event === 'end' ? 60 : 10,
+    });
+    hooks['sessionStart'] = upsertFlat(hooks['sessionStart'], entry('start'));
+    hooks['sessionEnd'] = upsertFlat(hooks['sessionEnd'], entry('end'));
+    const version = typeof config['version'] === 'number' ? config['version'] : 1;
+    return { ...config, version, hooks };
+}
+export function copilotHooksFile() {
+    const entry = (event) => ({
+        type: 'command',
+        bash: `./${HOOK_LAUNCHER_PATH} ${hookArgs('copilot', event)}`,
+        timeoutSec: event === 'end' ? 60 : 10,
+    });
+    return `${JSON.stringify({ version: 1, hooks: { sessionStart: [entry('start')], sessionEnd: [entry('end')] } }, null, 2)}\n`;
+}
+export function grokHooksFile() {
+    const entry = (event) => ({
+        hooks: [
+            {
+                type: 'command',
+                command: `"\${GROK_WORKSPACE_ROOT:-.}"/${HOOK_LAUNCHER_PATH} ${hookArgs('grok', event)}`,
+                timeout: event === 'end' ? 60 : 10,
+            },
+        ],
+    });
+    return `${JSON.stringify({ hooks: { SessionStart: [entry('start')], SessionEnd: [entry('end')] } }, null, 2)}\n`;
+}
+export function opencodePluginFile() {
+    return `// Generated by \`halyard setup\`. OpenCode has no shell-command hooks — extensibility
+// is TypeScript plugins on its event bus — so this bridges its session lifecycle
+// to the same uploader every other client uses: ${HOOK_LAUNCHER_PATH} -> \`halyard hook\`.
+//
+//   * startup      -> sweeps sessions that never uploaded
+//   * session.idle -> end-of-session upload, debounced: OpenCode has no
+//                     session-end event, and the ingest endpoint keeps the FIRST
+//                     upload it sees for a session id, so we wait for the
+//                     session to go quiet before sending it.
+
+const QUIET_MS = 10 * 60 * 1000
+
+interface OpencodeEvent {
+  type: string
+  properties?: { sessionID?: string; info?: { id?: string } }
+}
+
+interface PluginContext {
+  directory: string
+  $: (
+    strings: TemplateStringsArray,
+    ...values: unknown[]
+  ) => {
+    quiet(): { nothrow(): Promise<unknown> }
+  }
+}
+
+export const HalyardSessionUpload = async ({ $, directory }: PluginContext) => {
+  const launcher = \`\${directory}/${HOOK_LAUNCHER_PATH}\`
+  const timers = new Map<string, ReturnType<typeof setTimeout>>()
+
+  const run = async (event: 'start' | 'end') => {
+    const result = $\`\${launcher} --client opencode --event \${event} --detach\`
+    await result.quiet().nothrow()
+  }
+
+  await run('start')
+
+  return {
+    event: async ({ event }: { event: OpencodeEvent }) => {
+      const sessionId = event.properties?.sessionID ?? event.properties?.info?.id ?? 'default'
+      if (event.type === 'session.idle') {
+        const pending = timers.get(sessionId)
+        if (pending) clearTimeout(pending)
+        timers.set(
+          sessionId,
+          setTimeout(() => {
+            timers.delete(sessionId)
+            void run('end')
+          }, QUIET_MS),
+        )
+        return
+      }
+      // Any further activity on the session restarts the quiet period.
+      if (event.type === 'message.updated' || event.type === 'session.updated') {
+        const pending = timers.get(sessionId)
+        if (pending) {
+          clearTimeout(pending)
+          timers.delete(sessionId)
+        }
+      }
+    },
+  }
+}
+`;
+}
+function scaffoldResult(target, status, location, detail) {
+    return { target, status, location, detail };
+}
+/** Write a file we own outright (created or replaced when its content differs). */
+function writeOwnedFile(target, filePath, content, dryRun, executable = false) {
+    const current = existsSync(filePath) ? readFileSync(filePath, 'utf8') : null;
+    if (current === content) {
+        return scaffoldResult(target, 'unchanged', filePath, 'Halyard session-upload hook is already in place.');
+    }
+    if (!dryRun) {
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, content);
+        if (executable)
+            chmodSync(filePath, 0o755);
+    }
+    const verb = current === null ? 'create' : 'update';
+    return scaffoldResult(target, 'updated', filePath, dryRun
+        ? `Would ${verb} the Halyard session-upload hook.`
+        : `${verb === 'create' ? 'Created' : 'Updated'} the Halyard session-upload hook.`);
+}
+/** Merge our entries into a JSON config other tools also write to. */
+function mergeJsonFile(target, filePath, merge, dryRun) {
+    const current = readJsonFile(filePath);
+    if (current instanceof Error)
+        return scaffoldResult(target, 'error', filePath, current.message);
+    let next;
+    try {
+        next = merge(current);
+    }
+    catch (error) {
+        return scaffoldResult(target, 'error', filePath, formatError(error));
+    }
+    if (isDeepStrictEqual(current, next)) {
+        return scaffoldResult(target, 'unchanged', filePath, 'Halyard session-upload hooks are already present.');
+    }
+    if (!dryRun)
+        writeJsonFile(filePath, next);
+    return scaffoldResult(target, 'updated', filePath, dryRun
+        ? 'Would add the Halyard session-upload hooks.'
+        : 'Added the Halyard session-upload hooks.');
+}
+/** Everything except Claude's settings.json, which `runSetup` owns (it also enables the plugin there). */
+export function scaffoldHooks(cwd, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    return [
+        writeOwnedFile('launcher', join(cwd, HOOK_LAUNCHER_PATH), launcherScript(), dryRun, true),
+        mergeJsonFile('codex', join(cwd, '.codex', 'hooks.json'), (c) => mergeLifecycleHooks(c, codexHookSpec()), dryRun),
+        mergeJsonFile('cursor', join(cwd, '.cursor', 'hooks.json'), (c) => mergeCursorHooks(c), dryRun),
+        mergeJsonFile('gemini', join(cwd, '.gemini', 'settings.json'), (c) => mergeLifecycleHooks(c, geminiHookSpec()), dryRun),
+        writeOwnedFile('copilot', join(cwd, '.github', 'hooks', 'halyard-session-upload.json'), copilotHooksFile(), dryRun),
+        writeOwnedFile('opencode', join(cwd, '.opencode', 'plugins', 'halyard-session-upload.ts'), opencodePluginFile(), dryRun),
+        writeOwnedFile('grok', join(cwd, '.grok', 'hooks', 'halyard-session-upload.json'), grokHooksFile(), dryRun),
+    ];
+}
+//# sourceMappingURL=setup-hooks.js.map

package/dist/lib/setup-hooks.js.map

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

package/dist/lib/setup.d.ts

@@ -0,0 +1,47 @@
+import { type HookScaffoldTarget } from './setup-hooks.js';
+export declare const HALYARD_MCP_URL = "https://mcp.usehalyard.ai";
+export declare const HALYARD_CLAUDE_MARKETPLACE_NAME = "halyard-labs";
+export declare const HALYARD_CLAUDE_MARKETPLACE_REPO = "halyard-labs/claude-plugin-marketplace";
+export declare const HALYARD_CLAUDE_PLUGIN_ID = "halyard@halyard-labs";
+export type SetupTarget = 'claude' | 'codex' | 'cursor' | HookScaffoldTarget;
+export type SetupStatus = 'updated' | 'unchanged' | 'skipped' | 'error';
+export interface SetupResult {
+    target: SetupTarget;
+    scope: 'project' | 'user';
+    status: SetupStatus;
+    location: string;
+    detail: string;
+}
+export interface CommandRunner {
+    has(command: string): boolean;
+}
+export interface SetupOptions {
+    cwd?: string;
+    dryRun?: boolean;
+    homeDir?: string;
+    runner?: CommandRunner;
+    /** Write the session-upload hooks (launcher + per-client config). Default true. */
+    hooks?: boolean;
+}
+interface ClaudeSettings extends Record<string, unknown> {
+    enabledPlugins?: Record<string, unknown>;
+    extraKnownMarketplaces?: Record<string, unknown>;
+}
+interface CursorConfig extends Record<string, unknown> {
+    mcpServers?: Record<string, unknown>;
+}
+interface CodexConfig extends Record<string, unknown> {
+    mcp_servers?: Record<string, unknown>;
+}
+export declare function createSystemRunner(): CommandRunner;
+export declare function runSetup(options?: SetupOptions): SetupResult[];
+export declare function getSetupPaths(cwd: string, homeDir: string): {
+    claudeProject: string;
+    cursorProject: string;
+    codexUser: string;
+};
+export declare function mergeClaudeSettings(input: unknown): ClaudeSettings;
+export declare function mergeCursorConfig(input: unknown): CursorConfig;
+export declare function mergeCodexConfig(input: unknown): CodexConfig;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/lib/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/lib/setup.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAA;AAEzB,eAAO,MAAM,eAAe,8BAA8B,CAAA;AAC1D,eAAO,MAAM,+BAA+B,iBAAiB,CAAA;AAC7D,eAAO,MAAM,+BAA+B,2CAA2C,CAAA;AACvF,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,kBAAkB,CAAA;AAC5E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAEvE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,UAAU,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjD;AAED,UAAU,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,UAAU,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAMlD;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,EAAE,CAmBlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;EAMzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAkBlE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAc9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAe5D"}

package/dist/lib/setup.js

@@ -0,0 +1,179 @@
+import { spawnSync } from 'node:child_process';
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, relative, resolve } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
+import { asObject, formatError, readJsonFile, writeJsonFile } from './config-files.js';
+import { claudeHookSpec, mergeLifecycleHooks, scaffoldHooks, } from './setup-hooks.js';
+export const HALYARD_MCP_URL = 'https://mcp.usehalyard.ai';
+export const HALYARD_CLAUDE_MARKETPLACE_NAME = 'halyard-labs';
+export const HALYARD_CLAUDE_MARKETPLACE_REPO = 'halyard-labs/claude-plugin-marketplace';
+export const HALYARD_CLAUDE_PLUGIN_ID = 'halyard@halyard-labs';
+export function createSystemRunner() {
+    return {
+        has(command) {
+            return spawnSync('which', [command], { stdio: 'ignore' }).status === 0;
+        },
+    };
+}
+export function runSetup(options = {}) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const dryRun = options.dryRun ?? false;
+    const homeDir = options.homeDir ?? homedir();
+    const runner = options.runner ?? createSystemRunner();
+    const hooks = options.hooks ?? true;
+    const paths = getSetupPaths(cwd, homeDir);
+    const results = [
+        setupClaudeProject(paths.claudeProject, dryRun, hooks),
+        setupCursorProject(paths.cursorProject, dryRun),
+        setupCodexUser(paths.codexUser, dryRun, runner),
+    ];
+    if (hooks) {
+        for (const entry of scaffoldHooks(cwd, { dryRun })) {
+            results.push({ ...entry, scope: 'project' });
+        }
+    }
+    return results;
+}
+export function getSetupPaths(cwd, homeDir) {
+    return {
+        claudeProject: join(cwd, '.claude', 'settings.json'),
+        cursorProject: join(cwd, '.cursor', 'mcp.json'),
+        codexUser: join(homeDir, '.codex', 'config.toml'),
+    };
+}
+export function mergeClaudeSettings(input) {
+    const current = asObject(input);
+    const enabledPlugins = asObject(current['enabledPlugins']);
+    const extraKnownMarketplaces = asObject(current['extraKnownMarketplaces']);
+    const marketplace = asObject(extraKnownMarketplaces[HALYARD_CLAUDE_MARKETPLACE_NAME]);
+    enabledPlugins[HALYARD_CLAUDE_PLUGIN_ID] = true;
+    marketplace['source'] = {
+        source: 'github',
+        repo: HALYARD_CLAUDE_MARKETPLACE_REPO,
+    };
+    extraKnownMarketplaces[HALYARD_CLAUDE_MARKETPLACE_NAME] = marketplace;
+    return {
+        ...current,
+        enabledPlugins,
+        extraKnownMarketplaces,
+    };
+}
+export function mergeCursorConfig(input) {
+    const current = asObject(input);
+    const mcpServers = asObject(current['mcpServers']);
+    const halyard = asObject(mcpServers['halyard']);
+    mcpServers['halyard'] = {
+        ...halyard,
+        url: HALYARD_MCP_URL,
+    };
+    return {
+        ...current,
+        mcpServers,
+    };
+}
+export function mergeCodexConfig(input) {
+    const current = asObject(input);
+    const mcpServers = asObject(current['mcp_servers']);
+    const halyard = asObject(mcpServers['halyard']);
+    mcpServers['halyard'] = {
+        ...halyard,
+        enabled: true,
+        url: HALYARD_MCP_URL,
+    };
+    return {
+        ...current,
+        mcp_servers: mcpServers,
+    };
+}
+function setupClaudeProject(filePath, dryRun, hooks) {
+    const current = readJsonFile(filePath);
+    if (current instanceof Error) {
+        return result('claude', 'project', 'error', filePath, current.message);
+    }
+    let next = mergeClaudeSettings(current);
+    if (hooks)
+        next = mergeLifecycleHooks(next, claudeHookSpec());
+    const what = hooks
+        ? 'the Halyard marketplace, the project plugin and the session-upload hooks'
+        : 'the Halyard marketplace and the project plugin';
+    if (isDeepStrictEqual(current, next)) {
+        return result('claude', 'project', 'unchanged', filePath, `Already scaffolded: ${what}.`);
+    }
+    if (!dryRun) {
+        writeJsonFile(filePath, next);
+    }
+    return result('claude', 'project', 'updated', filePath, dryRun ? `Would add ${what}.` : `Added ${what}.`);
+}
+function setupCursorProject(filePath, dryRun) {
+    const current = readJsonFile(filePath);
+    if (current instanceof Error) {
+        return result('cursor', 'project', 'error', filePath, current.message);
+    }
+    const next = mergeCursorConfig(current);
+    if (isDeepStrictEqual(current, next)) {
+        return result('cursor', 'project', 'unchanged', filePath, 'Halyard MCP is already present in Cursor project config.');
+    }
+    if (!dryRun) {
+        writeJsonFile(filePath, next);
+    }
+    return result('cursor', 'project', 'updated', filePath, dryRun
+        ? 'Would add the Halyard MCP server to Cursor project config.'
+        : 'Added the Halyard MCP server to Cursor project config.');
+}
+function setupCodexUser(filePath, dryRun, runner) {
+    const codexDetected = runner.has('codex') || existsSync(filePath);
+    if (!codexDetected) {
+        return result('codex', 'user', 'skipped', filePath, 'Codex was not detected on this machine, so user-level Codex config was left alone.');
+    }
+    const current = readTomlFile(filePath);
+    if (current instanceof Error) {
+        return result('codex', 'user', 'error', filePath, current.message);
+    }
+    const next = mergeCodexConfig(current);
+    if (isDeepStrictEqual(current, next)) {
+        return result('codex', 'user', 'unchanged', filePath, 'Halyard MCP is already present in Codex user config.');
+    }
+    if (!dryRun) {
+        writeTomlFile(filePath, next);
+    }
+    return result('codex', 'user', 'updated', filePath, dryRun
+        ? 'Would add the Halyard MCP server to Codex user config.'
+        : 'Added the Halyard MCP server to Codex user config.');
+}
+function readTomlFile(filePath) {
+    if (!existsSync(filePath))
+        return {};
+    try {
+        return parseToml(readFileSync(filePath, 'utf8'));
+    }
+    catch (error) {
+        return new Error(`Could not parse TOML at ${filePath}: ${formatError(error)}`);
+    }
+}
+function writeTomlFile(filePath, value) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, `${stringifyToml(asObject(value))}\n`);
+}
+function result(target, scope, status, filePath, detail) {
+    return {
+        target,
+        scope,
+        status,
+        location: displayPath(filePath, scope),
+        detail,
+    };
+}
+function displayPath(filePath, scope) {
+    if (scope === 'project') {
+        return relative(process.cwd(), filePath) || filePath;
+    }
+    const userHome = homedir();
+    const fromHome = relative(userHome, filePath);
+    if (fromHome && !fromHome.startsWith('..')) {
+        return `~/${fromHome}`;
+    }
+    return relative(process.cwd(), filePath) || filePath;
+}
+//# sourceMappingURL=setup.js.map

package/dist/lib/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/lib/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,GAEd,MAAM,kBAAkB,CAAA;AAEzB,MAAM,CAAC,MAAM,eAAe,GAAG,2BAA2B,CAAA;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,cAAc,CAAA;AAC7D,MAAM,CAAC,MAAM,+BAA+B,GAAG,wCAAwC,CAAA;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAA;AAuC9D,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,GAAG,CAAC,OAAe;YACjB,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;QACxE,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAAwB,EAAE;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAA;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAA;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAA;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAA;IACnC,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAEzC,MAAM,OAAO,GAAkB;QAC7B,kBAAkB,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;QACtD,kBAAkB,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/C,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;KAChD,CAAA;IACD,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAe;IACxD,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC;QACpD,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC;QAC/C,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC;KAClD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAC1D,MAAM,sBAAsB,GAAG,QAAQ,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAA;IAC1E,MAAM,WAAW,GAAG,QAAQ,CAAC,sBAAsB,CAAC,+BAA+B,CAAC,CAAC,CAAA;IAErF,cAAc,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAA;IAC/C,WAAW,CAAC,QAAQ,CAAC,GAAG;QACtB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,+BAA+B;KACtC,CAAA;IACD,sBAAsB,CAAC,+BAA+B,CAAC,GAAG,WAAW,CAAA;IAErE,OAAO;QACL,GAAG,OAAO;QACV,cAAc;QACd,sBAAsB;KACvB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IAE/C,UAAU,CAAC,SAAS,CAAC,GAAG;QACtB,GAAG,OAAO;QACV,GAAG,EAAE,eAAe;KACrB,CAAA;IAED,OAAO;QACL,GAAG,OAAO;QACV,UAAU;KACX,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;IAE/C,UAAU,CAAC,SAAS,CAAC,GAAG;QACtB,GAAG,OAAO;QACV,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,eAAe;KACrB,CAAA;IAED,OAAO;QACL,GAAG,OAAO;QACV,WAAW,EAAE,UAAU;KACxB,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,MAAe,EAAE,KAAc;IAC3E,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,OAAO,YAAY,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACxE,CAAC;IAED,IAAI,IAAI,GAA4B,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAChE,IAAI,KAAK;QAAE,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,KAAK;QAChB,CAAC,CAAC,0EAA0E;QAC5E,CAAC,CAAC,gDAAgD,CAAA;IACpD,IAAI,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,uBAAuB,IAAI,GAAG,CAAC,CAAA;IAC3F,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,MAAM,CACX,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,CAAC,CAAC,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CACjD,CAAA;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,MAAe;IAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,OAAO,YAAY,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EACR,0DAA0D,CAC3D,CAAA;IACH,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,MAAM,CACX,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM;QACJ,CAAC,CAAC,4DAA4D;QAC9D,CAAC,CAAC,wDAAwD,CAC7D,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,MAAe,EAAE,MAAqB;IAC9E,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,MAAM,CACX,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,oFAAoF,CACrF,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,OAAO,YAAY,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CACX,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,sDAAsD,CACvD,CAAA;IACH,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,MAAM,CACX,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,MAAM;QACJ,CAAC,CAAC,wDAAwD;QAC1D,CAAC,CAAC,oDAAoD,CACzD,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAA;IAEpC,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAY,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,KAAK,CAAC,2BAA2B,QAAQ,KAAK,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChF,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAc;IACrD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,aAAa,CAAC,QAAQ,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;AAChE,CAAC;AAED,SAAS,MAAM,CACb,MAAmB,EACnB,KAAyB,EACzB,MAAmB,EACnB,QAAgB,EAChB,MAAc;IAEd,OAAO;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;QACtC,MAAM;KACP,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,KAAyB;IAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAA;IACtD,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7C,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,QAAQ,EAAE,CAAA;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAA;AACtD,CAAC"}

package/dist/lib/skill-batches.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Split skill uploads into request-sized batches. Two caps apply at once: a
+ * count (the server processes at most 25 skills per call) and a byte budget
+ * on the JSON body, because file contents now ride inline and the route's
+ * body limit is 8 MiB. A skill whose payload alone exceeds the budget still
+ * ships — as a batch of one — so the server, not the client, gets to reject it.
+ */
+export interface BatchLimits {
+    maxItems: number;
+    /** Budget for the encoded `{"skills":[...]}` body. */
+    maxBytes: number;
+}
+/** Size of one item as it will appear in the request body. */
+export declare function encodedBytes(value: unknown): number;
+export declare function planBatches<T>(items: T[], sizeOf: (item: T) => number, limits?: BatchLimits): T[][];
+//# sourceMappingURL=skill-batches.d.ts.map

package/dist/lib/skill-batches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-batches.d.ts","sourceRoot":"","sources":["../../src/lib/skill-batches.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAOD,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,MAAM,GAAE,WAAkC,GACzC,CAAC,EAAE,EAAE,CAkBP"}

package/dist/lib/skill-batches.js

@@ -0,0 +1,35 @@
+/**
+ * Split skill uploads into request-sized batches. Two caps apply at once: a
+ * count (the server processes at most 25 skills per call) and a byte budget
+ * on the JSON body, because file contents now ride inline and the route's
+ * body limit is 8 MiB. A skill whose payload alone exceeds the budget still
+ * ships — as a batch of one — so the server, not the client, gets to reject it.
+ */
+const DEFAULT_BATCH_LIMITS = { maxItems: 25, maxBytes: 6 * 1024 * 1024 };
+/** Bytes of `{"skills":[]}` — the envelope around the items. */
+const ENVELOPE_BYTES = Buffer.byteLength('{"skills":[]}');
+/** Size of one item as it will appear in the request body. */
+export function encodedBytes(value) {
+    return Buffer.byteLength(JSON.stringify(value));
+}
+export function planBatches(items, sizeOf, limits = DEFAULT_BATCH_LIMITS) {
+    const batches = [];
+    let current = [];
+    let bytes = ENVELOPE_BYTES;
+    for (const item of items) {
+        const size = sizeOf(item);
+        const full = current.length >= limits.maxItems || bytes + size + 1 > limits.maxBytes;
+        if (current.length > 0 && full) {
+            batches.push(current);
+            current = [];
+            bytes = ENVELOPE_BYTES;
+        }
+        // Every item after the first costs its separating comma too.
+        bytes += size + (current.length > 0 ? 1 : 0);
+        current.push(item);
+    }
+    if (current.length > 0)
+        batches.push(current);
+    return batches;
+}
+//# sourceMappingURL=skill-batches.js.map

package/dist/lib/skill-batches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-batches.js","sourceRoot":"","sources":["../../src/lib/skill-batches.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,oBAAoB,GAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAA;AAErF,gEAAgE;AAChE,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;AAEzD,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAU,EACV,MAA2B,EAC3B,SAAsB,oBAAoB;IAE1C,MAAM,OAAO,GAAU,EAAE,CAAA;IACzB,IAAI,OAAO,GAAQ,EAAE,CAAA;IACrB,IAAI,KAAK,GAAG,cAAc,CAAA;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAA;QACpF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,GAAG,EAAE,CAAA;YACZ,KAAK,GAAG,cAAc,CAAA;QACxB,CAAC;QACD,6DAA6D;QAC7D,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7C,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/lib/skill-files.d.ts

@@ -0,0 +1,4 @@
+import type { SkillFileUpload } from './api-client.js';
+import type { SkillFileEntry } from './skill-fingerprint.js';
+export declare function toSkillFileUpload(entry: SkillFileEntry): SkillFileUpload;
+//# sourceMappingURL=skill-files.d.ts.map

package/dist/lib/skill-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-files.d.ts","sourceRoot":"","sources":["../../src/lib/skill-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AA6B5D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAQxE"}

package/dist/lib/skill-files.js

@@ -0,0 +1,36 @@
+import { SKILL_FILE } from './skills-discovery.js';
+/**
+ * Turn a fingerprinted manifest entry into its wire form. Every supporting
+ * file goes up verbatim: as UTF-8 text when it is text, base64 otherwise.
+ * SKILL.md is the one exception — its bytes already ride as `frontmatterRaw`
+ * + `body`, so its manifest row carries only `path` / `size` / `sha256`.
+ */
+/** A NUL byte this early is the classic binary tell (ELF, woff2, images, UTF-16). */
+const TEXT_SNIFF_BYTES = 8 * 1024;
+/**
+ * Strict so that latin-1 or otherwise malformed bytes fall back to base64:
+ * the server hashes what it decodes, and only a faithful round-trip matches.
+ * `ignoreBOM` keeps a leading BOM in the string so it re-encodes unchanged.
+ */
+const utf8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });
+function decodeText(bytes) {
+    if (bytes.subarray(0, TEXT_SNIFF_BYTES).includes(0))
+        return undefined;
+    try {
+        return utf8.decode(bytes);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function toSkillFileUpload(entry) {
+    const { path, size, sha256, bytes } = entry;
+    if (path === SKILL_FILE)
+        return { path, size, sha256 };
+    const text = decodeText(bytes);
+    if (text === undefined) {
+        return { path, size, sha256, content: bytes.toString('base64'), encoding: 'base64' };
+    }
+    return { path, size, sha256, content: text, encoding: 'utf8' };
+}
+//# sourceMappingURL=skill-files.js.map

package/dist/lib/skill-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-files.js","sourceRoot":"","sources":["../../src/lib/skill-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD;;;;;GAKG;AAEH,qFAAqF;AACrF,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAA;AAEjC;;;;GAIG;AACH,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAEvE,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACrE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAC3C,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;IACtF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AAChE,CAAC"}