@mono-agent/context 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @mono-agent/context
+
+## Category
+
+Category: `context`
+
+## Responsibility
+
+Deterministic context assembly for agent prompts. It loads identity and optional SOUL text, normalizes JSON/Markdown blocks, indexes selected skills, appends recent history, and returns a structured prompt context without calling a model.
+
+## Install / Usage
+
+```bash
+pnpm --filter @mono-agent/context run build
+```
+
+```ts
+import { buildAgentContext, loadContextFromFiles } from "@mono-agent/context";
+```
+
+Use file loading at host boundaries and `buildAgentContext` for deterministic prompt assembly in tests or harnesses.
+
+## Public API
+
+- `buildAgentContext`
+- `loadContextFromFiles`
+- `buildSkillIndex`, `loadSkillIndexFromDirectory`
+- `normalizeJsonValue`
+- `DEFAULT_SOUL_TEXT`, `ContextValidationError`
+- Context, JSON, skill-index, history, and section types
+
+## Dependency Boundary
+
+This package is pure TypeScript plus filesystem helpers. It does not depend on runtime execution, adapters, memory persistence, UI, or observability.
+
+## What This Package Does Not Own
+
+It does not decide which tools are allowed, run a model, mutate memory, manage conversation transport, or persist run artifacts.
+
+## Verification
+
+```bash
+pnpm --filter @mono-agent/context run build
+pnpm --filter @mono-agent/context run typecheck
+pnpm --filter @mono-agent/context run test
+```

package/dist/context-builder.d.ts

@@ -0,0 +1,3 @@
+import type { BuildContextInput, BuiltAgentContext } from './types.js';
+export declare function buildAgentContext(input: BuildContextInput): BuiltAgentContext;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../src/context-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAOlB,MAAM,YAAY,CAAC;AASpB,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAgD7E"}

package/dist/context-builder.js

@@ -0,0 +1,239 @@
+import { DEFAULT_SOUL_TEXT } from './default-soul.js';
+import { ContextValidationError } from './errors.js';
+import { normalizeJsonValue } from './json.js';
+import { buildSkillIndex, renderSkillIndexEntries } from './skill-index.js';
+import { normalizeInlineText } from './text.js';
+const VALID_HISTORY_ROLES = new Set(['system', 'user', 'assistant', 'tool']);
+export function buildAgentContext(input) {
+    const rawInput = input;
+    if (rawInput === null || typeof rawInput !== 'object') {
+        throw new ContextValidationError('invalid_context_block', 'Context input must be an object.');
+    }
+    const usedDefaultCore = input.core === undefined;
+    const core = normalizeContextBlock(input.core === undefined ? DEFAULT_SOUL_TEXT : input.core, 'core');
+    const identity = normalizeContextBlock(input.identity, 'identity');
+    const memory = normalizeMemory(input.memory);
+    const history = normalizeHistory(input.history);
+    const skills = input.skills === undefined ? [] : buildSkillIndex(input.skills);
+    const skillInstructions = normalizeSkillInstructions(input.skillInstructions);
+    const userMessage = normalizeRequiredMarkdown(input.userMessage, 'userMessage');
+    const sections = [
+        makeSection('core', 'Core Guardrails', core),
+        makeSection('identity', 'Identity', identity),
+    ];
+    if (memory.length > 0) {
+        sections.push(makeSection('memory', 'Memory', renderNumberedBlocks(memory, 'Memory')));
+    }
+    if (history.length > 0) {
+        sections.push(makeSection('history', 'Conversation History', renderHistory(history)));
+    }
+    if (skills.length > 0) {
+        sections.push(makeSection('skills', 'Skill Index', { content: renderSkillIndexEntries(skills) }));
+    }
+    if (skillInstructions.length > 0) {
+        sections.push(makeSection('skill-instructions', 'Selected Skill Instructions', renderNumberedBlocks(skillInstructions, 'Skill Instruction')));
+    }
+    sections.push(makeSection('user-message', 'Current User Message', { content: userMessage }));
+    return {
+        prompt: sections.map(renderSection).join('\n\n'),
+        sections,
+        metadata: {
+            usedDefaultCore,
+            skillCount: skills.length,
+            historyCount: history.length,
+            sources: collectSources(core, identity, memory, skills, skillInstructions),
+        },
+    };
+}
+function normalizeMemory(memory) {
+    if (memory === undefined) {
+        return [];
+    }
+    const blocks = Array.isArray(memory) ? memory : [memory];
+    return blocks.map((block, index) => normalizeContextBlock(block, `memory[${index}]`));
+}
+function normalizeSkillInstructions(skillInstructions) {
+    if (skillInstructions === undefined) {
+        return [];
+    }
+    const blocks = Array.isArray(skillInstructions) ? skillInstructions : [skillInstructions];
+    return blocks.map((block, index) => normalizeContextBlock(block, `skillInstructions[${index}]`));
+}
+function normalizeHistory(history) {
+    if (history === undefined) {
+        return [];
+    }
+    if (!Array.isArray(history)) {
+        throw new ContextValidationError('invalid_history', 'History must be an ordered array of messages.');
+    }
+    return history.map((message, index) => {
+        const raw = message;
+        if (raw === null || typeof raw !== 'object') {
+            throw new ContextValidationError('invalid_history', 'History messages must be objects.', { index });
+        }
+        const role = raw.role;
+        if (typeof role !== 'string' || !VALID_HISTORY_ROLES.has(role)) {
+            throw new ContextValidationError('invalid_history', 'History message role is invalid.', {
+                index,
+                role,
+            });
+        }
+        const content = normalizeRequiredMarkdown(raw.content, `history[${index}].content`);
+        const normalized = {
+            role: role,
+            content,
+        };
+        if (raw.name !== undefined) {
+            normalized.name = normalizeOptionalInlineString(raw.name, `history[${index}].name`);
+        }
+        if (raw.timestamp !== undefined) {
+            normalized.timestamp = normalizeOptionalInlineString(raw.timestamp, `history[${index}].timestamp`);
+        }
+        return normalized;
+    });
+}
+function normalizeContextBlock(block, label) {
+    if (typeof block === 'string') {
+        return { content: normalizeRequiredMarkdown(block, label) };
+    }
+    const raw = block;
+    if (raw === null || typeof raw !== 'object') {
+        throw new ContextValidationError('invalid_context_block', 'Context blocks must be strings or typed block objects.', {
+            label,
+        });
+    }
+    if (raw.kind === 'markdown') {
+        return withOptionalSource({ content: normalizeRequiredMarkdown(raw.content, `${label}.content`) }, raw.source, label);
+    }
+    if (raw.kind === 'json') {
+        const normalizedJson = normalizeJsonValue(raw.value);
+        return withOptionalSource({ content: `\`\`\`json\n${JSON.stringify(normalizedJson, null, 2)}\n\`\`\`` }, raw.source, label);
+    }
+    throw new ContextValidationError('invalid_context_block', 'Context block kind must be markdown or json.', {
+        label,
+        kind: raw.kind,
+    });
+}
+function withOptionalSource(block, rawSource, label) {
+    if (rawSource === undefined) {
+        return block;
+    }
+    if (typeof rawSource !== 'string') {
+        throw new ContextValidationError('invalid_context_block', 'Context block source must be a string when provided.', {
+            label,
+        });
+    }
+    const source = rawSource.trim();
+    if (source.length === 0) {
+        throw new ContextValidationError('invalid_context_block', 'Context block source must not be empty.', {
+            label,
+        });
+    }
+    return {
+        ...block,
+        source,
+    };
+}
+function normalizeRequiredMarkdown(value, field) {
+    if (typeof value !== 'string') {
+        throw new ContextValidationError('empty_required_field', `${field} must be a string.`, {
+            field,
+        });
+    }
+    const normalized = normalizeMarkdown(value);
+    if (normalized.length === 0) {
+        throw new ContextValidationError('empty_required_field', `${field} must not be empty.`, {
+            field,
+        });
+    }
+    return normalized;
+}
+function normalizeMarkdown(value) {
+    return value.replace(/\r\n?/g, '\n').trim();
+}
+function normalizeOptionalInlineString(value, field) {
+    if (typeof value !== 'string') {
+        throw new ContextValidationError('invalid_history', `${field} must be a string when provided.`, {
+            field,
+        });
+    }
+    const normalized = normalizeInlineText(value);
+    if (normalized.length === 0) {
+        throw new ContextValidationError('invalid_history', `${field} must not be empty when provided.`, {
+            field,
+        });
+    }
+    return normalized;
+}
+function makeSection(id, title, block) {
+    const section = {
+        id,
+        title,
+        content: block.content,
+    };
+    if (block.source === undefined) {
+        return section;
+    }
+    return {
+        ...section,
+        source: block.source,
+    };
+}
+function renderSection(section) {
+    return `## ${section.title}\n\n${section.content}`;
+}
+function renderNumberedBlocks(blocks, label) {
+    if (blocks.length === 1) {
+        const [onlyBlock] = blocks;
+        if (onlyBlock === undefined) {
+            throw new ContextValidationError('invalid_context_block', `${label} block is unexpectedly missing.`);
+        }
+        return onlyBlock;
+    }
+    return {
+        content: blocks
+            .map((block, index) => {
+            const sourceSuffix = block.source === undefined ? '' : ` (${block.source})`;
+            return `### ${label} ${index + 1}${sourceSuffix}\n\n${block.content}`;
+        })
+            .join('\n\n'),
+    };
+}
+function renderHistory(history) {
+    return {
+        content: history
+            .map((message, index) => {
+            const labelParts = [`${index + 1}. ${message.role}`];
+            if (message.name !== undefined) {
+                labelParts.push(message.name);
+            }
+            if (message.timestamp !== undefined) {
+                labelParts.push(message.timestamp);
+            }
+            return `### ${labelParts.join(' — ')}\n\n${message.content}`;
+        })
+            .join('\n\n'),
+    };
+}
+function collectSources(core, identity, memory, skills, skillInstructions) {
+    const sources = [];
+    addSource(sources, core.source);
+    addSource(sources, identity.source);
+    for (const block of memory) {
+        addSource(sources, block.source);
+    }
+    for (const skill of skills) {
+        addSource(sources, skill.mainFile);
+    }
+    for (const block of skillInstructions) {
+        addSource(sources, block.source);
+    }
+    return sources;
+}
+function addSource(sources, source) {
+    if (source === undefined || sources.includes(source)) {
+        return;
+    }
+    sources.push(source);
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/context-builder.js.map

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

package/dist/default-soul.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_SOUL_TEXT = "You are a careful, source-grounded agent.\n\nCore guardrails:\n- Follow the instruction hierarchy and project-local guidance before making changes.\n- Read and research the current context before acting; distinguish confirmed facts from assumptions.\n- Keep scope small, reversible, and aligned with the user's requested outcome.\n- Preserve secrets and never expose credentials, tokens, or private local configuration.\n- Do not fake success, readiness, tests, data sources, or product behavior.\n- Surface model, runtime, provider, and tool failures honestly instead of hiding them behind broad fallbacks.\n- Ask for clarification when missing information would change the implementation or outcome.\n- Leave clear handoff notes with decisions, verification, and remaining risks.";
+//# sourceMappingURL=default-soul.d.ts.map

package/dist/default-soul.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-soul.d.ts","sourceRoot":"","sources":["../src/default-soul.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,kxBAUiD,CAAC"}

package/dist/default-soul.js

@@ -0,0 +1,12 @@
+export const DEFAULT_SOUL_TEXT = `You are a careful, source-grounded agent.
+
+Core guardrails:
+- Follow the instruction hierarchy and project-local guidance before making changes.
+- Read and research the current context before acting; distinguish confirmed facts from assumptions.
+- Keep scope small, reversible, and aligned with the user's requested outcome.
+- Preserve secrets and never expose credentials, tokens, or private local configuration.
+- Do not fake success, readiness, tests, data sources, or product behavior.
+- Surface model, runtime, provider, and tool failures honestly instead of hiding them behind broad fallbacks.
+- Ask for clarification when missing information would change the implementation or outcome.
+- Leave clear handoff notes with decisions, verification, and remaining risks.`;
+//# sourceMappingURL=default-soul.js.map

package/dist/default-soul.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-soul.js","sourceRoot":"","sources":["../src/default-soul.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;+EAU8C,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export type ContextValidationErrorCode = 'empty_required_field' | 'invalid_context_block' | 'invalid_history' | 'invalid_json' | 'invalid_skill_index' | 'file_read_failed';
+export interface ContextValidationErrorDetails {
+    readonly [key: string]: unknown;
+}
+export declare class ContextValidationError extends Error {
+    readonly code: ContextValidationErrorCode;
+    readonly details: ContextValidationErrorDetails;
+    constructor(code: ContextValidationErrorCode, message: string, details?: ContextValidationErrorDetails);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAClC,sBAAsB,GACtB,uBAAuB,GACvB,iBAAiB,GACjB,cAAc,GACd,qBAAqB,GACrB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;gBAG9C,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,6BAAkC;CAO9C"}

package/dist/errors.js

@@ -0,0 +1,11 @@
+export class ContextValidationError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = 'ContextValidationError';
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,CAA6B;IACjC,OAAO,CAAgC;IAEhD,YACE,IAAgC,EAChC,OAAe,EACf,UAAyC,EAAE;QAE3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/file-loader.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltAgentContext, FileContextInput } from './types.js';
+export declare function loadContextFromFiles(input: FileContextInput): Promise<BuiltAgentContext>;
+//# sourceMappingURL=file-loader.d.ts.map

package/dist/file-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../src/file-loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,gBAAgB,EAAyC,MAAM,YAAY,CAAC;AAEhI,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqB9F"}

package/dist/file-loader.js

@@ -0,0 +1,49 @@
+import { readFile } from 'node:fs/promises';
+import { buildAgentContext } from './context-builder.js';
+import { ContextValidationError } from './errors.js';
+import { resolveRequiredPath } from './fs-paths.js';
+import { buildSkillIndex, loadSkillIndexFromDirectory } from './skill-index.js';
+export async function loadContextFromFiles(input) {
+    const rawInput = input;
+    if (rawInput === null || typeof rawInput !== 'object') {
+        throw new ContextValidationError('invalid_context_block', 'File context input must be an object.');
+    }
+    const identity = await readMarkdownFile(input.identityPath, 'identityPath');
+    const core = input.soulPath === undefined ? undefined : await readMarkdownFile(input.soulPath, 'soulPath');
+    const skills = await loadMergedSkillIndex(input);
+    const buildInput = {
+        identity,
+        userMessage: input.userMessage,
+        ...(core === undefined ? {} : { core }),
+        ...(input.memory === undefined ? {} : { memory: input.memory }),
+        ...(input.history === undefined ? {} : { history: input.history }),
+        ...(skills.length === 0 ? {} : { skills }),
+        ...(input.skillInstructions === undefined ? {} : { skillInstructions: input.skillInstructions }),
+    };
+    return buildAgentContext(buildInput);
+}
+async function loadMergedSkillIndex(input) {
+    const discovered = input.skillsRoot === undefined ? [] : await loadSkillIndexFromDirectory(input.skillsRoot);
+    const explicit = input.skills ?? [];
+    if (explicit.length === 0 && discovered.length === 0) {
+        return [];
+    }
+    return buildSkillIndex([...explicit, ...discovered]);
+}
+async function readMarkdownFile(filePath, field) {
+    const resolvedPath = resolveRequiredPath(filePath, field);
+    try {
+        return {
+            kind: 'markdown',
+            content: await readFile(resolvedPath, 'utf8'),
+            source: resolvedPath,
+        };
+    }
+    catch (error) {
+        throw new ContextValidationError('file_read_failed', `Unable to read ${field}.`, {
+            path: resolvedPath,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=file-loader.js.map

package/dist/file-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../src/file-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAGhF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAuB;IAChE,MAAM,QAAQ,GAAG,KAAgB,CAAC;IAClC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,sBAAsB,CAAC,uBAAuB,EAAE,uCAAuC,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3G,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAsB;QACpC,QAAQ;QACR,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1C,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;KACjG,CAAC;IAEF,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,KAAuB;IACzD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,2BAA2B,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7G,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,eAAe,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,KAAa;IAC7D,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;YAC7C,MAAM,EAAE,YAAY;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,kBAAkB,KAAK,GAAG,EAAE;YAC/E,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/fs-paths.d.ts

@@ -0,0 +1,4 @@
+import { ContextValidationError } from './errors.js';
+export declare function resolveRequiredPath(value: string, field: string): string;
+export declare function fileReadError(message: string, filePath: string, error: unknown): ContextValidationError;
+//# sourceMappingURL=fs-paths.d.ts.map

package/dist/fs-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-paths.d.ts","sourceRoot":"","sources":["../src/fs-paths.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAKvG"}

package/dist/fs-paths.js

@@ -0,0 +1,17 @@
+import { resolve } from 'node:path';
+import { ContextValidationError } from './errors.js';
+export function resolveRequiredPath(value, field) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new ContextValidationError('file_read_failed', `${field} must be a non-empty path.`, {
+            field,
+        });
+    }
+    return resolve(value);
+}
+export function fileReadError(message, filePath, error) {
+    return new ContextValidationError('file_read_failed', message, {
+        path: filePath,
+        cause: error instanceof Error ? error.message : String(error),
+    });
+}
+//# sourceMappingURL=fs-paths.js.map

package/dist/fs-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-paths.js","sourceRoot":"","sources":["../src/fs-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,GAAG,KAAK,4BAA4B,EAAE;YACzF,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,QAAgB,EAAE,KAAc;IAC7E,OAAO,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,OAAO,EAAE;QAC7D,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { buildAgentContext } from './context-builder.js';
+export { DEFAULT_SOUL_TEXT } from './default-soul.js';
+export { ContextValidationError } from './errors.js';
+export type { ContextValidationErrorCode, ContextValidationErrorDetails } from './errors.js';
+export { loadContextFromFiles } from './file-loader.js';
+export { buildSkillIndex, loadSkillFilesFromDirectory, loadSkillIndexFromDirectory } from './skill-index.js';
+export type { LoadedSkillFile } from './skill-index.js';
+export { normalizeInlineText } from './text.js';
+export type { BuildContextInput, BuiltAgentContext, ContextBlockInput, ContextRole, ContextSection, ContextSectionId, FileContextInput, HistoryMessage, MarkdownContextBlock, SkillIndexEntry, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC7G,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { buildAgentContext } from './context-builder.js';
+export { DEFAULT_SOUL_TEXT } from './default-soul.js';
+export { ContextValidationError } from './errors.js';
+export { loadContextFromFiles } from './file-loader.js';
+export { buildSkillIndex, loadSkillFilesFromDirectory, loadSkillIndexFromDirectory } from './skill-index.js';
+export { normalizeInlineText } from './text.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE7G,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,8 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export type JsonArray = readonly JsonValue[];
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export declare function normalizeJsonValue(value: unknown): JsonValue;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAE5D"}

package/dist/json.js

@@ -0,0 +1,79 @@
+import { ContextValidationError } from './errors.js';
+export function normalizeJsonValue(value) {
+    return normalizeJsonValueAtPath(value, '$', new WeakSet());
+}
+function normalizeJsonValueAtPath(value, path, stack) {
+    if (value === null) {
+        return null;
+    }
+    switch (typeof value) {
+        case 'string':
+        case 'boolean':
+            return value;
+        case 'number':
+            if (!Number.isFinite(value)) {
+                throw new ContextValidationError('invalid_json', 'JSON values must use finite numbers.', {
+                    path,
+                    value,
+                });
+            }
+            return value;
+        case 'object':
+            return normalizeJsonObjectOrArray(value, path, stack);
+        case 'undefined':
+        case 'function':
+        case 'symbol':
+        case 'bigint':
+            throw new ContextValidationError('invalid_json', `Unsupported JSON value at ${path}.`, {
+                path,
+                valueType: typeof value,
+            });
+    }
+    throw new ContextValidationError('invalid_json', `Unsupported JSON value at ${path}.`, {
+        path,
+        valueType: typeof value,
+    });
+}
+function normalizeJsonObjectOrArray(value, path, stack) {
+    if (stack.has(value)) {
+        throw new ContextValidationError('invalid_json', 'Circular JSON values are not supported.', {
+            path,
+        });
+    }
+    stack.add(value);
+    try {
+        if (Array.isArray(value)) {
+            const normalizedItems = [];
+            for (let index = 0; index < value.length; index += 1) {
+                if (!Object.prototype.hasOwnProperty.call(value, index)) {
+                    throw new ContextValidationError('invalid_json', 'Sparse arrays are not valid JSON values.', {
+                        path: `${path}[${index}]`,
+                    });
+                }
+                normalizedItems.push(normalizeJsonValueAtPath(value[index], `${path}[${index}]`, stack));
+            }
+            return normalizedItems;
+        }
+        if (!isPlainObject(value)) {
+            throw new ContextValidationError('invalid_json', 'JSON objects must be plain objects.', {
+                path,
+                objectType: Object.prototype.toString.call(value),
+            });
+        }
+        const normalized = {};
+        const keys = Object.keys(value).sort();
+        for (const key of keys) {
+            const propertyValue = value[key];
+            normalized[key] = normalizeJsonValueAtPath(propertyValue, `${path}.${key}`, stack);
+        }
+        return normalized;
+    }
+    finally {
+        stack.delete(value);
+    }
+}
+function isPlainObject(value) {
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/skill-index.d.ts

@@ -0,0 +1,11 @@
+import type { SkillIndexEntry } from './types.js';
+export interface LoadedSkillFile {
+    readonly entry: SkillIndexEntry;
+    readonly markdown: string;
+}
+export declare function buildSkillIndex(entries: readonly SkillIndexEntry[]): readonly SkillIndexEntry[];
+export declare function loadSkillIndexFromDirectory(root: string): Promise<readonly SkillIndexEntry[]>;
+export declare function loadSkillFilesFromDirectory(root: string): Promise<readonly LoadedSkillFile[]>;
+export declare function renderSkillIndex(entries: readonly SkillIndexEntry[]): string;
+export declare function renderSkillIndexEntries(entries: readonly SkillIndexEntry[]): string;
+//# sourceMappingURL=skill-index.d.ts.map

package/dist/skill-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-index.d.ts","sourceRoot":"","sources":["../src/skill-index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,eAAe,EAAE,CAkB/F;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAGnG;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAiDnG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAE5E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAInF"}

package/dist/skill-index.js

@@ -0,0 +1,165 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ContextValidationError } from './errors.js';
+import { fileReadError, resolveRequiredPath } from './fs-paths.js';
+import { normalizeInlineText } from './text.js';
+export function buildSkillIndex(entries) {
+    const normalized = entries.map((entry, index) => normalizeSkillEntry(entry, index));
+    const seen = new Map();
+    for (const entry of normalized) {
+        const key = entry.name.toLowerCase();
+        const existing = seen.get(key);
+        if (existing !== undefined) {
+            throw new ContextValidationError('invalid_skill_index', 'Duplicate skill names are not allowed.', {
+                name: entry.name,
+                existing: existing.mainFile,
+                duplicate: entry.mainFile,
+            });
+        }
+        seen.set(key, entry);
+    }
+    return [...normalized].sort(compareSkillEntries);
+}
+export async function loadSkillIndexFromDirectory(root) {
+    const files = await loadSkillFilesFromDirectory(root);
+    return files.map((file) => file.entry);
+}
+export async function loadSkillFilesFromDirectory(root) {
+    const rootPath = resolveRequiredPath(root, 'skillsRoot');
+    let entries;
+    try {
+        entries = await readdir(rootPath, { withFileTypes: true });
+    }
+    catch (error) {
+        throw fileReadError('Unable to read skills directory.', rootPath, error);
+    }
+    const discovered = [];
+    const markdownByMainFile = new Map();
+    const childDirectories = entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+    for (const childName of childDirectories) {
+        const skillFile = join(rootPath, childName, 'SKILL.md');
+        let markdown;
+        try {
+            markdown = await readFile(skillFile, 'utf8');
+        }
+        catch (error) {
+            if (isErrorWithCode(error, 'ENOENT')) {
+                continue;
+            }
+            throw fileReadError('Unable to read skill file.', skillFile, error);
+        }
+        const description = deriveSkillDescription(markdown);
+        if (description.length === 0) {
+            throw new ContextValidationError('invalid_skill_index', 'Skill file must contain a non-heading description paragraph.', {
+                mainFile: skillFile,
+                name: childName,
+            });
+        }
+        discovered.push({
+            name: childName,
+            description,
+            mainFile: skillFile,
+        });
+        markdownByMainFile.set(skillFile, markdown);
+    }
+    const index = buildSkillIndex(discovered);
+    return index.map((entry) => ({
+        entry,
+        markdown: markdownByMainFile.get(entry.mainFile) ?? '',
+    }));
+}
+export function renderSkillIndex(entries) {
+    return renderSkillIndexEntries(buildSkillIndex(entries));
+}
+export function renderSkillIndexEntries(entries) {
+    return entries
+        .map((entry) => `- **${entry.name}** — ${entry.description}\n  - Main file: \`${entry.mainFile}\``)
+        .join('\n');
+}
+function normalizeSkillEntry(entry, index) {
+    const raw = entry;
+    if (raw === null || typeof raw !== 'object') {
+        throw new ContextValidationError('invalid_skill_index', 'Skill entries must be objects.', {
+            index,
+        });
+    }
+    return {
+        name: normalizeRequiredInlineString(raw.name, 'name', index),
+        description: normalizeRequiredInlineString(raw.description, 'description', index),
+        mainFile: normalizeRequiredInlineString(raw.mainFile, 'mainFile', index),
+    };
+}
+function normalizeRequiredInlineString(value, field, index) {
+    if (typeof value !== 'string') {
+        throw new ContextValidationError('invalid_skill_index', `Skill ${field} must be a string.`, {
+            field,
+            index,
+        });
+    }
+    const normalized = normalizeInlineText(value);
+    if (normalized.length === 0) {
+        throw new ContextValidationError('invalid_skill_index', `Skill ${field} must not be empty.`, {
+            field,
+            index,
+        });
+    }
+    return normalized;
+}
+function compareSkillEntries(left, right) {
+    const leftKey = left.name.toLowerCase();
+    const rightKey = right.name.toLowerCase();
+    if (leftKey < rightKey) {
+        return -1;
+    }
+    if (leftKey > rightKey) {
+        return 1;
+    }
+    if (left.name < right.name) {
+        return -1;
+    }
+    if (left.name > right.name) {
+        return 1;
+    }
+    return 0;
+}
+function deriveSkillDescription(markdown) {
+    const paragraphs = [];
+    let currentParagraph = [];
+    const flush = () => {
+        if (currentParagraph.length > 0) {
+            paragraphs.push(normalizeInlineText(currentParagraph.join(' ')));
+            currentParagraph = [];
+        }
+    };
+    for (const rawLine of stripFrontmatter(markdown).replace(/\r\n?/g, '\n').split('\n')) {
+        const line = rawLine.trim();
+        if (line.length === 0) {
+            flush();
+            continue;
+        }
+        if (/^#{1,6}\s+/.test(line)) {
+            flush();
+            continue;
+        }
+        currentParagraph.push(line);
+    }
+    flush();
+    return paragraphs.find((paragraph) => paragraph.length > 0) ?? '';
+}
+/**
+ * Skill files shared with other harnesses (e.g. Claude Code) open with a YAML
+ * frontmatter block. The block is metadata, not prose, so the derived
+ * description starts after it.
+ */
+function stripFrontmatter(markdown) {
+    const normalized = markdown.replace(/\r\n?/g, '\n');
+    const match = /^---\n[\s\S]*?\n---[ \t]*(?:\n|$)/u.exec(normalized);
+    return match === null ? normalized : normalized.slice(match[0].length);
+}
+function isErrorWithCode(error, code) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=skill-index.js.map

package/dist/skill-index.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeInlineText(value: string): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD"}

package/dist/text.js

@@ -0,0 +1,9 @@
+export function normalizeInlineText(value) {
+    return value
+        .replace(/\r\n?/g, '\n')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .join(' ');
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK;SACT,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+import type { JsonValue } from './json.js';
+export type ContextRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface MarkdownContextBlock {
+    readonly kind: 'markdown';
+    readonly content: string;
+    readonly source?: string;
+}
+export interface JsonContextBlock {
+    readonly kind: 'json';
+    readonly value: JsonValue;
+    readonly source?: string;
+}
+export type ContextBlockInput = string | MarkdownContextBlock | JsonContextBlock;
+export interface HistoryMessage {
+    readonly role: ContextRole;
+    readonly content: string;
+    readonly name?: string;
+    readonly timestamp?: string;
+}
+export interface SkillIndexEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly mainFile: string;
+}
+export interface BuildContextInput {
+    readonly identity: ContextBlockInput;
+    readonly userMessage: string;
+    readonly core?: ContextBlockInput;
+    readonly memory?: ContextBlockInput | readonly ContextBlockInput[];
+    readonly history?: readonly HistoryMessage[];
+    readonly skills?: readonly SkillIndexEntry[];
+    readonly skillInstructions?: ContextBlockInput | readonly ContextBlockInput[];
+}
+export type ContextSectionId = 'core' | 'identity' | 'memory' | 'history' | 'skills' | 'skill-instructions' | 'user-message';
+export interface ContextSection {
+    readonly id: ContextSectionId;
+    readonly title: string;
+    readonly content: string;
+    readonly source?: string;
+}
+export interface BuiltAgentContext {
+    readonly prompt: string;
+    readonly sections: readonly ContextSection[];
+    readonly metadata: {
+        readonly usedDefaultCore: boolean;
+        readonly skillCount: number;
+        readonly historyCount: number;
+        readonly sources: readonly string[];
+    };
+}
+export interface FileContextInput {
+    readonly identityPath: string;
+    readonly userMessage: string;
+    readonly soulPath?: string;
+    readonly memory?: ContextBlockInput | readonly ContextBlockInput[];
+    readonly history?: readonly HistoryMessage[];
+    readonly skills?: readonly SkillIndexEntry[];
+    readonly skillsRoot?: string;
+    readonly skillInstructions?: ContextBlockInput | readonly ContextBlockInput[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@mono-agent/context",
+  "version": "0.1.0",
+  "description": "Deterministic context assembly for host-compatible agents.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}