@nram-ai/setup-agents 0.0.1-pre.0

package/dist/helpers/upsert.d.ts

@@ -0,0 +1,197 @@
+import { ActionResult } from '../types';
+/**
+ * Identifies our SessionStart hook entry among the user's hooks, across every
+ * historical command format
+ */
+export declare const SESSION_START_MARKER = "@nram-ai/setup-agents";
+/**
+ * The shell command injected as a SessionStart hook; its stdout (the agent
+ * instructions, fetched from the configured nram server) is added to the
+ * model's context by the harness
+ *
+ * @param base_url the normalized nram base URL the hook fetches from
+ */
+export declare const session_start_command: (base_url: string) => string;
+export type MarkerStyle = 'hash' | 'html';
+/**
+ * Returns whether the text already carries our marker-fenced block
+ *
+ * @param text the file content
+ * @param style the marker comment style
+ */
+export declare const has_marker_block: (text: string, style: MarkerStyle) => boolean;
+/**
+ * Reads a text file, returning an empty string when the file does not exist
+ *
+ * @param path the file to read
+ */
+export declare const read_text: (path: string) => string;
+/**
+ * Writes a text file, creating parent directories as needed
+ *
+ * @param path the file to write
+ * @param text the file content
+ */
+export declare const write_text: (path: string, text: string) => void;
+export type JsonReadResult = {
+    ok: true;
+    value: any;
+    existed: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Reads and parses a JSON file. A missing file is NOT an error (it yields
+ * `value: undefined`); an existing file that cannot be parsed is, and the
+ * caller MUST leave that file untouched and fall back to a manual snippet
+ *
+ * @param path the file to read
+ */
+export declare const read_json: (path: string) => JsonReadResult;
+/**
+ * Serializes a value as 2-space-indented JSON (with a trailing newline)
+ * and writes it, creating parent directories as needed
+ *
+ * @param path the file to write
+ * @param value the value to serialize
+ */
+export declare const write_json: (path: string, value: unknown) => void;
+/**
+ * Inserts a marker-fenced block into a body of text, or replaces the existing
+ * fenced block in place. Content outside the markers is never modified, and
+ * re-applying the same block is byte-stable
+ *
+ * @param text the current file content (may be empty)
+ * @param block the block content to place between the markers
+ * @param style the marker comment style for the target file type
+ * @param position where to place a NEW block; ignored when replacing
+ * @returns the updated text and whether anything changed
+ */
+export declare const upsert_marker_block: (text: string, block: string, style: MarkerStyle, position?: "prepend" | "append") => {
+    text: string;
+    changed: boolean;
+};
+/**
+ * Upserts our SessionStart hook entry into a hooks-style configuration object
+ * (the SessionStart shape is identical between Claude Code's settings.json
+ * and Codex's hooks.json). An existing entry referencing `@nram-ai/setup-agents` is
+ * replaced in place when its command differs (a different server URL, or the
+ * URL-less command written by older package versions), left alone when it
+ * already matches, and appended when absent. Unrelated hooks are never touched
+ *
+ * @param config the parsed configuration object (mutated in place)
+ * @param base_url the normalized nram base URL embedded in the hook command
+ * @returns the configuration and whether it changed
+ */
+export declare const upsert_session_start_hook: (config: any, base_url: string) => {
+    config: any;
+    changed: boolean;
+};
+/**
+ * Upserts our SessionStart hook into a hooks-style JSON file (Claude Code's
+ * settings.json and Codex's hooks.json share the shape) and reports the
+ * outcome; an unparseable file is left untouched
+ *
+ * @param path the hooks file to update
+ * @param base_url the normalized nram base URL embedded in the hook command
+ */
+export declare const upsert_hooks_json: (path: string, base_url: string) => ActionResult;
+export type JsonUpsertResult = {
+    kind: 'skipped' | 'written' | 'updated';
+} | {
+    kind: 'manual';
+    error: string;
+};
+/**
+ * Merges a value into a JSON file at the given key path (creating intermediate
+ * objects as needed), writing only when the value differs. An unparseable
+ * existing file is left untouched and reported for manual handling
+ *
+ * @param path the JSON file to update
+ * @param key_path the nested key path, e.g. ['mcpServers', 'nram']
+ * @param entry the value to place at the key path
+ * @param fallback the configuration to start from when the file is missing
+ */
+export declare const upsert_json_path: (path: string, key_path: string[], entry: unknown, fallback?: any) => JsonUpsertResult;
+/**
+ * The manual follow-up shown whenever a configuration references the
+ * NRAM_API_KEY environment variable instead of embedding the key
+ */
+export declare const api_key_manual_result: () => ActionResult;
+/**
+ * The manual follow-up shown when a tool's configuration has no verified
+ * environment-variable substitution, so the Authorization header must be
+ * added by hand rather than risking a literal key on disk
+ *
+ * @param path the configuration file the header belongs in
+ */
+export declare const api_key_header_manual_result: (path: string) => ActionResult;
+export interface McpJsonOptions {
+    /** Starting configuration when the file is missing */
+    fallback?: any;
+    /** Replaces the parse-error reason in the manual detail (e.g. a JSONC caveat) */
+    parse_hint?: string;
+    /** Appended to the written/updated detail */
+    note?: string;
+    /** The key path addresses an array merged by entry name instead of a keyed object */
+    array?: boolean;
+}
+/**
+ * Merges an MCP server entry into a JSON configuration and maps the outcome
+ * onto the standard `MCP registration` ActionResult, including the manual
+ * snippet for unparseable files; this is the shared report flow every
+ * JSON-configured harness uses
+ *
+ * @param path the JSON file to update
+ * @param key_path the nested key path (the leaf is the entry key, or the array itself with `array`)
+ * @param entry the entry value
+ * @param options report and merge options
+ */
+export declare const mcp_json_result: (path: string, key_path: string[], entry: any, options?: McpJsonOptions) => ActionResult;
+/**
+ * Upserts a marker-fenced configuration block into a structured text file
+ * (TOML, YAML): parse the existing content (manual on failure), let the
+ * caller veto via a conflict check, apply the marker upsert, validate that
+ * the result re-parses with the expected entry, and only then write. The
+ * file is never re-serialized as a whole, so user comments survive
+ *
+ * @param path the configuration file
+ * @param block the marker-fenced block content
+ * @param parse the format parser (throws on invalid input)
+ * @param format the format name for messaging
+ * @param conflict returns a result to report instead of editing (e.g. the key exists outside our markers)
+ * @param valid post-edit check that the entry is present in the re-parsed file
+ */
+export declare const upsert_block_with_validation: (path: string, block: string, parse: (text: string) => any, format: string, conflict: (parsed: any, text: string) => ActionResult | undefined, valid: (parsed: any) => boolean) => ActionResult;
+/**
+ * Merges an entry into an array-shaped JSON configuration (e.g. Factory's
+ * `servers: []`), keyed by a name field: replace in place when an element
+ * with the same name exists and differs, append when absent, skip when
+ * identical. An unparseable existing file is left untouched
+ *
+ * @param path the JSON file to update
+ * @param array_key_path the nested key path holding the array
+ * @param entry the element to place (must carry the name key)
+ * @param name_key the field that identifies elements (default `name`)
+ */
+export declare const upsert_json_array_entry: (path: string, array_key_path: string[], entry: any, name_key?: string) => JsonUpsertResult;
+/**
+ * Writes a file the tool owns outright (rule files, steering docs,
+ * instruction files): compare, write when different, and report
+ *
+ * @param path the file to write
+ * @param content the full file content
+ * @param action the action name for the result
+ */
+export declare const upsert_own_file: (path: string, content: string, action: string) => ActionResult;
+/**
+ * Upserts the marker-fenced agent-instructions block at the top of an
+ * AGENTS.md-style file and reports the outcome; tools sharing the same file
+ * (the project-root AGENTS.md) dedupe automatically because the second
+ * upsert finds the block unchanged
+ *
+ * @param path the markdown file to update
+ * @param instructions the agent instructions text to place in the block
+ */
+export declare const agents_md_result: (path: string, instructions: string) => ActionResult;

package/dist/helpers/upsert.js

@@ -0,0 +1,428 @@
+"use strict";
+// Copyright (c) 2026, Brandon Lehmann <brandonlehmann@gmail.com>
+//
+// 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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agents_md_result = exports.upsert_own_file = exports.upsert_json_array_entry = exports.upsert_block_with_validation = exports.mcp_json_result = exports.api_key_header_manual_result = exports.api_key_manual_result = exports.upsert_json_path = exports.upsert_hooks_json = exports.upsert_session_start_hook = exports.upsert_marker_block = exports.write_json = exports.read_json = exports.write_text = exports.read_text = exports.has_marker_block = exports.session_start_command = exports.SESSION_START_MARKER = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Identifies our SessionStart hook entry among the user's hooks, across every
+ * historical command format
+ */
+exports.SESSION_START_MARKER = '@nram-ai/setup-agents';
+/**
+ * The shell command injected as a SessionStart hook; its stdout (the agent
+ * instructions, fetched from the configured nram server) is added to the
+ * model's context by the harness
+ *
+ * @param base_url the normalized nram base URL the hook fetches from
+ */
+const session_start_command = (base_url) => `npx -y @nram-ai/setup-agents --session-start --url ${base_url}`;
+exports.session_start_command = session_start_command;
+const MARKERS = {
+    hash: ['# >>> nram setup >>>', '# <<< nram setup <<<'],
+    html: ['<!-- nram:start -->', '<!-- nram:end -->']
+};
+/**
+ * Returns whether the text already carries our marker-fenced block
+ *
+ * @param text the file content
+ * @param style the marker comment style
+ */
+const has_marker_block = (text, style) => text.includes(MARKERS[style][0]);
+exports.has_marker_block = has_marker_block;
+/**
+ * Reads a text file, returning an empty string when the file does not exist
+ *
+ * @param path the file to read
+ */
+const read_text = (path) => (0, fs_1.existsSync)(path) ? (0, fs_1.readFileSync)(path, 'utf8') : '';
+exports.read_text = read_text;
+/**
+ * Writes a text file, creating parent directories as needed
+ *
+ * @param path the file to write
+ * @param text the file content
+ */
+const write_text = (path, text) => {
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
+    (0, fs_1.writeFileSync)(path, text);
+};
+exports.write_text = write_text;
+/**
+ * Reads and parses a JSON file. A missing file is NOT an error (it yields
+ * `value: undefined`); an existing file that cannot be parsed is, and the
+ * caller MUST leave that file untouched and fall back to a manual snippet
+ *
+ * @param path the file to read
+ */
+const read_json = (path) => {
+    if (!(0, fs_1.existsSync)(path)) {
+        return { ok: true, value: undefined, existed: false };
+    }
+    try {
+        return { ok: true, value: JSON.parse((0, fs_1.readFileSync)(path, 'utf8')), existed: true };
+    }
+    catch (error) {
+        return { ok: false, error: error.toString() };
+    }
+};
+exports.read_json = read_json;
+/**
+ * Serializes a value as 2-space-indented JSON (with a trailing newline)
+ * and writes it, creating parent directories as needed
+ *
+ * @param path the file to write
+ * @param value the value to serialize
+ */
+const write_json = (path, value) => (0, exports.write_text)(path, `${JSON.stringify(value, null, 2)}\n`);
+exports.write_json = write_json;
+/**
+ * Inserts a marker-fenced block into a body of text, or replaces the existing
+ * fenced block in place. Content outside the markers is never modified, and
+ * re-applying the same block is byte-stable
+ *
+ * @param text the current file content (may be empty)
+ * @param block the block content to place between the markers
+ * @param style the marker comment style for the target file type
+ * @param position where to place a NEW block; ignored when replacing
+ * @returns the updated text and whether anything changed
+ */
+const upsert_marker_block = (text, block, style, position = 'append') => {
+    const [begin, end] = MARKERS[style];
+    const fenced = `${begin}\n${block.trimEnd()}\n${end}\n`;
+    const begin_idx = text.indexOf(begin);
+    if (begin_idx !== -1) {
+        const end_idx = text.indexOf(end, begin_idx);
+        if (end_idx !== -1) {
+            const after = text.slice(end_idx + end.length).replace(/^\r?\n/, '');
+            const updated = `${text.slice(0, begin_idx)}${fenced}${after}`;
+            return { text: updated, changed: updated !== text };
+        }
+    }
+    if (text.trim().length === 0) {
+        return { text: fenced, changed: true };
+    }
+    if (position === 'prepend') {
+        return { text: `${fenced}\n${text.replace(/^\s*\n/, '')}`, changed: true };
+    }
+    return { text: `${text.trimEnd()}\n\n${fenced}`, changed: true };
+};
+exports.upsert_marker_block = upsert_marker_block;
+/**
+ * Upserts our SessionStart hook entry into a hooks-style configuration object
+ * (the SessionStart shape is identical between Claude Code's settings.json
+ * and Codex's hooks.json). An existing entry referencing `@nram-ai/setup-agents` is
+ * replaced in place when its command differs (a different server URL, or the
+ * URL-less command written by older package versions), left alone when it
+ * already matches, and appended when absent. Unrelated hooks are never touched
+ *
+ * @param config the parsed configuration object (mutated in place)
+ * @param base_url the normalized nram base URL embedded in the hook command
+ * @returns the configuration and whether it changed
+ */
+const upsert_session_start_hook = (config, base_url) => {
+    config ??= {};
+    config.hooks ??= {};
+    config.hooks.SessionStart ??= [];
+    const command = (0, exports.session_start_command)(base_url);
+    for (const group of config.hooks.SessionStart) {
+        for (const hook of group?.hooks ?? []) {
+            if (typeof hook?.command === 'string' && hook.command.includes(exports.SESSION_START_MARKER)) {
+                if (hook.command === command) {
+                    return { config, changed: false };
+                }
+                hook.command = command;
+                return { config, changed: true };
+            }
+        }
+    }
+    config.hooks.SessionStart.push({
+        matcher: '',
+        hooks: [{
+                type: 'command',
+                command
+            }]
+    });
+    return { config, changed: true };
+};
+exports.upsert_session_start_hook = upsert_session_start_hook;
+/**
+ * Upserts our SessionStart hook into a hooks-style JSON file (Claude Code's
+ * settings.json and Codex's hooks.json share the shape) and reports the
+ * outcome; an unparseable file is left untouched
+ *
+ * @param path the hooks file to update
+ * @param base_url the normalized nram base URL embedded in the hook command
+ */
+const upsert_hooks_json = (path, base_url) => {
+    const file = (0, exports.read_json)(path);
+    if (!file.ok) {
+        return {
+            action: 'SessionStart hook',
+            kind: 'manual',
+            detail: `${path} exists but could not be parsed (${file.error}); ` +
+                'add this to hooks.SessionStart yourself: ' +
+                `{ "matcher": "", "hooks": [{ "type": "command", "command": "${(0, exports.session_start_command)(base_url)}" }] }`
+        };
+    }
+    const { config, changed } = (0, exports.upsert_session_start_hook)(file.value ?? {}, base_url);
+    if (!changed) {
+        return { action: 'SessionStart hook', kind: 'skipped', detail: `already present in ${path}` };
+    }
+    (0, exports.write_json)(path, config);
+    return { action: 'SessionStart hook', kind: file.existed ? 'updated' : 'written', detail: path };
+};
+exports.upsert_hooks_json = upsert_hooks_json;
+/**
+ * Merges a value into a JSON file at the given key path (creating intermediate
+ * objects as needed), writing only when the value differs. An unparseable
+ * existing file is left untouched and reported for manual handling
+ *
+ * @param path the JSON file to update
+ * @param key_path the nested key path, e.g. ['mcpServers', 'nram']
+ * @param entry the value to place at the key path
+ * @param fallback the configuration to start from when the file is missing
+ */
+const upsert_json_path = (path, key_path, entry, fallback = {}) => {
+    const file = (0, exports.read_json)(path);
+    if (!file.ok) {
+        return { kind: 'manual', error: file.error };
+    }
+    const config = file.value ?? fallback;
+    let node = config;
+    for (const key of key_path.slice(0, -1)) {
+        node[key] ??= {};
+        node = node[key];
+    }
+    const leaf = key_path[key_path.length - 1];
+    if (JSON.stringify(node[leaf]) === JSON.stringify(entry)) {
+        return { kind: 'skipped' };
+    }
+    node[leaf] = entry;
+    (0, exports.write_json)(path, config);
+    return { kind: file.existed ? 'updated' : 'written' };
+};
+exports.upsert_json_path = upsert_json_path;
+/**
+ * The manual follow-up shown whenever a configuration references the
+ * NRAM_API_KEY environment variable instead of embedding the key
+ */
+const api_key_manual_result = () => ({
+    action: 'API key',
+    kind: 'manual',
+    detail: 'set the NRAM_API_KEY environment variable to your nram API key; ' +
+        'the key is never written to disk'
+});
+exports.api_key_manual_result = api_key_manual_result;
+/**
+ * The manual follow-up shown when a tool's configuration has no verified
+ * environment-variable substitution, so the Authorization header must be
+ * added by hand rather than risking a literal key on disk
+ *
+ * @param path the configuration file the header belongs in
+ */
+const api_key_header_manual_result = (path) => ({
+    action: 'API key',
+    kind: 'manual',
+    detail: `this tool has no verified env-var substitution, so add the header yourself in ${path}: ` +
+        '"headers": { "Authorization": "Bearer <your nram_k_ key>" }'
+});
+exports.api_key_header_manual_result = api_key_header_manual_result;
+/**
+ * Merges an MCP server entry into a JSON configuration and maps the outcome
+ * onto the standard `MCP registration` ActionResult, including the manual
+ * snippet for unparseable files; this is the shared report flow every
+ * JSON-configured harness uses
+ *
+ * @param path the JSON file to update
+ * @param key_path the nested key path (the leaf is the entry key, or the array itself with `array`)
+ * @param entry the entry value
+ * @param options report and merge options
+ */
+const mcp_json_result = (path, key_path, entry, options = {}) => {
+    const merged = options.array
+        ? (0, exports.upsert_json_array_entry)(path, key_path, entry)
+        : (0, exports.upsert_json_path)(path, key_path, entry, options.fallback ?? {});
+    if (merged.kind === 'manual') {
+        const reason = options.parse_hint ?? merged.error;
+        const target = options.array
+            ? `add this to the "${key_path.join('.')}" array yourself`
+            : `add this under "${key_path.slice(0, -1).join('.')}" yourself: "${key_path[key_path.length - 1]}"`;
+        return {
+            action: 'MCP registration',
+            kind: 'manual',
+            detail: `${path} exists but could not be parsed (${reason}); ${target}: ${JSON.stringify(entry)}`
+        };
+    }
+    if (merged.kind === 'skipped') {
+        return { action: 'MCP registration', kind: 'skipped', detail: `already present in ${path}` };
+    }
+    return {
+        action: 'MCP registration',
+        kind: merged.kind,
+        detail: options.note === undefined ? path : `${path} (${options.note})`
+    };
+};
+exports.mcp_json_result = mcp_json_result;
+/**
+ * Upserts a marker-fenced configuration block into a structured text file
+ * (TOML, YAML): parse the existing content (manual on failure), let the
+ * caller veto via a conflict check, apply the marker upsert, validate that
+ * the result re-parses with the expected entry, and only then write. The
+ * file is never re-serialized as a whole, so user comments survive
+ *
+ * @param path the configuration file
+ * @param block the marker-fenced block content
+ * @param parse the format parser (throws on invalid input)
+ * @param format the format name for messaging
+ * @param conflict returns a result to report instead of editing (e.g. the key exists outside our markers)
+ * @param valid post-edit check that the entry is present in the re-parsed file
+ */
+const upsert_block_with_validation = (path, block, parse, format, conflict, valid) => {
+    const text = (0, exports.read_text)(path);
+    if (text.trim().length !== 0) {
+        let parsed;
+        try {
+            parsed = parse(text);
+        }
+        catch {
+            return {
+                action: 'MCP registration',
+                kind: 'manual',
+                detail: `${path} exists but could not be parsed as ${format}; add this yourself:\n${block}`
+            };
+        }
+        const vetoed = conflict(parsed, text);
+        if (vetoed !== undefined) {
+            return vetoed;
+        }
+    }
+    const { text: updated, changed } = (0, exports.upsert_marker_block)(text, block, 'hash', 'append');
+    if (!changed) {
+        return { action: 'MCP registration', kind: 'skipped', detail: `already present in ${path}` };
+    }
+    let ok;
+    try {
+        ok = valid(parse(updated));
+    }
+    catch {
+        ok = false;
+    }
+    if (!ok) {
+        return {
+            action: 'MCP registration',
+            kind: 'failed',
+            detail: `refusing to write ${path}: the updated file did not re-parse cleanly; ` +
+                `add this yourself:\n${block}`
+        };
+    }
+    (0, exports.write_text)(path, updated);
+    return {
+        action: 'MCP registration',
+        kind: text.length === 0 ? 'written' : 'updated',
+        detail: path
+    };
+};
+exports.upsert_block_with_validation = upsert_block_with_validation;
+/**
+ * Merges an entry into an array-shaped JSON configuration (e.g. Factory's
+ * `servers: []`), keyed by a name field: replace in place when an element
+ * with the same name exists and differs, append when absent, skip when
+ * identical. An unparseable existing file is left untouched
+ *
+ * @param path the JSON file to update
+ * @param array_key_path the nested key path holding the array
+ * @param entry the element to place (must carry the name key)
+ * @param name_key the field that identifies elements (default `name`)
+ */
+const upsert_json_array_entry = (path, array_key_path, entry, name_key = 'name') => {
+    const file = (0, exports.read_json)(path);
+    if (!file.ok) {
+        return { kind: 'manual', error: file.error };
+    }
+    const config = file.value ?? {};
+    let node = config;
+    for (const key of array_key_path.slice(0, -1)) {
+        node[key] ??= {};
+        node = node[key];
+    }
+    const leaf = array_key_path[array_key_path.length - 1];
+    node[leaf] ??= [];
+    const list = node[leaf];
+    const index = list.findIndex(element => element?.[name_key] === entry[name_key]);
+    if (index !== -1 && JSON.stringify(list[index]) === JSON.stringify(entry)) {
+        return { kind: 'skipped' };
+    }
+    if (index !== -1) {
+        list[index] = entry;
+    }
+    else {
+        list.push(entry);
+    }
+    (0, exports.write_json)(path, config);
+    return { kind: file.existed ? 'updated' : 'written' };
+};
+exports.upsert_json_array_entry = upsert_json_array_entry;
+/**
+ * Writes a file the tool owns outright (rule files, steering docs,
+ * instruction files): compare, write when different, and report
+ *
+ * @param path the file to write
+ * @param content the full file content
+ * @param action the action name for the result
+ */
+const upsert_own_file = (path, content, action) => {
+    const existing = (0, exports.read_text)(path);
+    if (existing === content) {
+        return { action, kind: 'skipped', detail: `already present at ${path}` };
+    }
+    (0, exports.write_text)(path, content);
+    return {
+        action,
+        kind: existing.length === 0 ? 'written' : 'updated',
+        detail: path
+    };
+};
+exports.upsert_own_file = upsert_own_file;
+/**
+ * Upserts the marker-fenced agent-instructions block at the top of an
+ * AGENTS.md-style file and reports the outcome; tools sharing the same file
+ * (the project-root AGENTS.md) dedupe automatically because the second
+ * upsert finds the block unchanged
+ *
+ * @param path the markdown file to update
+ * @param instructions the agent instructions text to place in the block
+ */
+const agents_md_result = (path, instructions) => {
+    const text = (0, exports.read_text)(path);
+    const { text: updated, changed } = (0, exports.upsert_marker_block)(text, instructions, 'html', 'prepend');
+    if (!changed) {
+        return { action: 'Agent instructions', kind: 'skipped', detail: `already present in ${path}` };
+    }
+    (0, exports.write_text)(path, updated);
+    return {
+        action: 'Agent instructions',
+        kind: text.length === 0 ? 'written' : 'updated',
+        detail: path
+    };
+};
+exports.agents_md_result = agents_md_result;
+//# sourceMappingURL=upsert.js.map

package/dist/helpers/upsert.js.map

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

package/dist/helpers/url.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Normalizes an nram base URL: trims whitespace, requires http/https,
+ * and strips any trailing slash so that paths can be appended safely
+ *
+ * @param input the user-supplied base URL
+ * @returns the normalized base URL
+ * @throws Error when the input is not a valid http(s) URL
+ */
+export declare const normalize_base_url: (input: string) => string;
+/**
+ * Derives the MCP endpoint URL from a normalized base URL
+ *
+ * @param base_url the normalized nram base URL
+ */
+export declare const mcp_url: (base_url: string) => string;