@shardworks/nexus-core 0.1.99 → 0.1.101

package/dist/legacy/1/manifest.d.ts

@@ -1,132 +0,0 @@
-/**
- * Manifest — assembles an anima's identity for a session.
- *
- * Reads the anima's composition from the Register (roles, curricula, temperament),
- * resolves tools by role gating and precondition checks, reads all prompt
- * ingredients from disk, and assembles the composed system prompt.
- *
- * The manifest is the anima's *identity*: who are you, what can you do.
- * The *user prompt* (commission spec, brief, conversation topic) is NOT part
- * of the manifest — it comes from the caller.
- *
- * Absorbed from the former `engine-manifest` package. MCP config generation
- * is NOT here — that's a transport detail owned by session providers.
- */
-import type { GuildConfig } from './guild-config.ts';
-/** An anima's record from the Register, including composition metadata. */
-export interface AnimaRecord {
-    id: string;
-    name: string;
-    status: string;
-    roles: string[];
-    curriculumName: string;
-    curriculumVersion: string;
-    curriculumSnapshot: string;
-    temperamentName: string;
-    temperamentVersion: string;
-    temperamentSnapshot: string;
-}
-/** A resolved tool that the anima has access to. */
-export interface ResolvedTool {
-    /** Tool name — how the anima sees it. */
-    name: string;
-    /** Absolute path to the tool's directory on disk. */
-    path: string;
-    /** Instructions content (if instructions.md exists). */
-    instructions: string | null;
-    /** npm package name for runtime resolution, or null for file-path resolution. */
-    package: string | null;
-}
-/** A tool that was resolved by role but failed precondition checks. */
-export interface UnavailableTool {
-    /** Tool name. */
-    name: string;
-    /** Human-readable reasons why the tool is unavailable. */
-    reasons: string[];
-}
-/** The fully-resolved manifest for an anima session. */
-export interface ManifestResult {
-    /** The anima record from the Register. */
-    anima: AnimaRecord;
-    /** The composed system prompt for the anima. */
-    systemPrompt: string;
-    /** The individual ingredients that produced the system prompt. */
-    composition: {
-        codex: string;
-        roleInstructions: string;
-        curriculum: {
-            name: string;
-            version: string;
-            content: string;
-        } | null;
-        temperament: {
-            name: string;
-            version: string;
-            content: string;
-        } | null;
-        toolInstructions: Array<{
-            toolName: string;
-            instructions: string;
-        }>;
-    };
-    /** Resolved tools the anima has access to. */
-    tools: ResolvedTool[];
-    /** Tools that matched the anima's roles but failed precondition checks. */
-    unavailable: UnavailableTool[];
-    /** Warnings generated during manifest (e.g. undefined roles). */
-    warnings: string[];
-}
-/**
- * Read an anima's full record from the Register, including roles and composition.
- */
-export declare function readAnima(home: string, animaName: string): AnimaRecord;
-/**
- * Resolve the set of tools an anima has access to, based on role
- * definitions and precondition checks.
- *
- * 1. Start with baseTools (available to all animas)
- * 2. For each anima role, look up the role in guild.json.roles
- *    - If defined: union in that role's tools
- *    - If undefined: warn and skip (no tools, no instructions from that role)
- * 3. Deduplicate tool names
- * 4. Resolve each tool from guild.json.tools catalog
- * 5. Run precondition checks — split into available and unavailable
- *
- * Returns available tools, unavailable tools, and any warnings.
- */
-export declare function resolveTools(home: string, config: GuildConfig, animaRoles: string[]): Promise<{
-    available: ResolvedTool[];
-    unavailable: UnavailableTool[];
-    warnings: string[];
-}>;
-/**
- * Read codex documents from the guildhall — guild-wide policy for all animas.
- *
- * Reads all .md files in the codex/ directory (non-recursive top level).
- */
-export declare function readCodex(home: string): string;
-/**
- * Read role-specific instructions for an anima's roles.
- *
- * For each role the anima holds, reads the instructions file pointed to by
- * the role definition in guild.json. Skips undefined roles (warning already
- * emitted by resolveTools). Skips roles without instructions.
- */
-export declare function readRoleInstructions(home: string, config: GuildConfig, animaRoles: string[]): string;
-/**
- * Assemble the composed system prompt for an anima session.
- *
- * Sections are included in order: codex → role instructions → curricula →
- * temperament → tool instructions → unavailable tools notice.
- * Empty sections are omitted.
- */
-export declare function assembleSystemPrompt(codex: string, roleInstructions: string, anima: AnimaRecord, tools: ResolvedTool[], unavailable?: UnavailableTool[]): string;
-/**
- * Manifest an anima for a session.
- *
- * This is the main entry point. Reads the anima's composition, resolves
- * tools by role, assembles the system prompt, and returns the full
- * manifest with composition provenance.
- */
-export declare function manifest(home: string, animaName: string): Promise<ManifestResult>;
-//# sourceMappingURL=manifest.d.ts.map

package/dist/legacy/1/manifest.d.ts.map

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

package/dist/legacy/1/manifest.js

@@ -1,321 +0,0 @@
-/**
- * Manifest — assembles an anima's identity for a session.
- *
- * Reads the anima's composition from the Register (roles, curricula, temperament),
- * resolves tools by role gating and precondition checks, reads all prompt
- * ingredients from disk, and assembles the composed system prompt.
- *
- * The manifest is the anima's *identity*: who are you, what can you do.
- * The *user prompt* (commission spec, brief, conversation topic) is NOT part
- * of the manifest — it comes from the caller.
- *
- * Absorbed from the former `engine-manifest` package. MCP config generation
- * is NOT here — that's a transport detail owned by session providers.
- */
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import fs from 'node:fs';
-import path from 'node:path';
-import Database from 'better-sqlite3';
-import { booksPath } from "./nexus-home.js";
-import { readGuildConfig } from "./guild-config.js";
-import { readPreconditions, checkPreconditions } from "./preconditions.js";
-import { resolveToolFromExport } from "./tool.js";
-/** Extract the npm package name from a package specifier that may include a subpath. */
-function basePackageName(pkg) {
-    // Scoped: @scope/name/subpath → @scope/name
-    if (pkg.startsWith('@')) {
-        const parts = pkg.split('/');
-        return parts.slice(0, 2).join('/');
-    }
-    // Unscoped: name/subpath → name
-    return pkg.split('/')[0];
-}
-// ── Core Functions ─────────────────────────────────────────────────────
-/**
- * Read an anima's full record from the Register, including roles and composition.
- */
-export function readAnima(home, animaName) {
-    const db = new Database(booksPath(home));
-    db.pragma('foreign_keys = ON');
-    try {
-        // Get anima
-        const anima = db.prepare(`SELECT id, name, status FROM animas WHERE name = ?`).get(animaName);
-        if (!anima) {
-            throw new Error(`Anima "${animaName}" not found in the Register.`);
-        }
-        // Get roles
-        const roleRows = db.prepare(`SELECT role FROM roster WHERE anima_id = ? ORDER BY role`).all(anima.id);
-        const roles = roleRows.map(r => r.role);
-        // Get composition — now includes name/version metadata
-        const composition = db.prepare(`SELECT curriculum_name, curriculum_version, curriculum_snapshot,
-              temperament_name, temperament_version, temperament_snapshot
-       FROM anima_compositions WHERE anima_id = ?`).get(anima.id);
-        return {
-            id: anima.id,
-            name: anima.name,
-            status: anima.status,
-            roles,
-            curriculumName: composition?.curriculum_name ?? '',
-            curriculumVersion: composition?.curriculum_version ?? '',
-            curriculumSnapshot: composition?.curriculum_snapshot ?? '',
-            temperamentName: composition?.temperament_name ?? '',
-            temperamentVersion: composition?.temperament_version ?? '',
-            temperamentSnapshot: composition?.temperament_snapshot ?? '',
-        };
-    }
-    finally {
-        db.close();
-    }
-}
-/**
- * Resolve the set of tools an anima has access to, based on role
- * definitions and precondition checks.
- *
- * 1. Start with baseTools (available to all animas)
- * 2. For each anima role, look up the role in guild.json.roles
- *    - If defined: union in that role's tools
- *    - If undefined: warn and skip (no tools, no instructions from that role)
- * 3. Deduplicate tool names
- * 4. Resolve each tool from guild.json.tools catalog
- * 5. Run precondition checks — split into available and unavailable
- *
- * Returns available tools, unavailable tools, and any warnings.
- */
-export async function resolveTools(home, config, animaRoles) {
-    const warnings = [];
-    // Collect tool names: start with base, union in role-specific
-    const toolNames = new Set(config.baseTools ?? []);
-    for (const role of animaRoles) {
-        const roleDef = config.roles[role];
-        if (!roleDef) {
-            warnings.push(`Role "${role}" is assigned to this anima but not defined in guild.json. ` +
-                `No tools or instructions from this role will be available.`);
-            continue;
-        }
-        for (const toolName of roleDef.tools) {
-            toolNames.add(toolName);
-        }
-    }
-    // Resolve each tool from the catalog
-    const available = [];
-    const unavailable = [];
-    for (const name of toolNames) {
-        const entry = config.tools[name];
-        if (!entry) {
-            warnings.push(`Tool "${name}" is referenced by a role or baseTools but not found in guild.json.tools. Skipping.`);
-            continue;
-        }
-        // Resolve on-disk path
-        const toolPath = path.join(home, 'tools', name);
-        const descriptorPath = path.join(toolPath, 'nexus-tool.json');
-        // Check preconditions before including in the available set
-        const preconditions = readPreconditions(descriptorPath);
-        if (preconditions.length > 0) {
-            const results = checkPreconditions(preconditions);
-            const failures = results.filter(r => !r.passed).map(r => r.message);
-            if (failures.length > 0) {
-                unavailable.push({ name, reasons: failures });
-                continue;
-            }
-        }
-        // Read instructions from multiple sources, in priority order:
-        // 1. Descriptor file on disk (nexus-tool.json → instructions field)
-        // 2. Tool definition (import module → instructions or instructionsFile)
-        let instructions = null;
-        // Source 1: descriptor file on disk
-        if (fs.existsSync(descriptorPath)) {
-            try {
-                const descriptor = JSON.parse(fs.readFileSync(descriptorPath, 'utf-8'));
-                if (descriptor.instructions) {
-                    const instructionsPath = path.join(toolPath, descriptor.instructions);
-                    if (fs.existsSync(instructionsPath)) {
-                        instructions = fs.readFileSync(instructionsPath, 'utf-8');
-                    }
-                }
-            }
-            catch {
-                // If descriptor is unreadable, skip instructions from descriptor
-            }
-        }
-        // Source 2: tool definition (for collection packages or tools with
-        // inline instructions / instructionsFile in the tool() definition)
-        if (!instructions && entry.package) {
-            try {
-                const mod = await import(__rewriteRelativeImportExtension(entry.package));
-                const toolDef = resolveToolFromExport(mod.default, name);
-                if (toolDef) {
-                    if (toolDef.instructions) {
-                        // Inline instructions text
-                        instructions = toolDef.instructions;
-                    }
-                    else if (toolDef.instructionsFile) {
-                        // File path relative to the package root in node_modules.
-                        const instrPath = path.join(home, 'node_modules', basePackageName(entry.package), toolDef.instructionsFile);
-                        if (fs.existsSync(instrPath)) {
-                            instructions = fs.readFileSync(instrPath, 'utf-8');
-                        }
-                    }
-                }
-            }
-            catch {
-                // If import fails, skip — instructions are optional
-            }
-        }
-        available.push({
-            name,
-            path: toolPath,
-            instructions,
-            package: entry.package ?? null,
-        });
-    }
-    return { available, unavailable, warnings };
-}
-/**
- * Read codex documents from the guildhall — guild-wide policy for all animas.
- *
- * Reads all .md files in the codex/ directory (non-recursive top level).
- */
-export function readCodex(home) {
-    const codexDir = path.join(home, 'codex');
-    if (!fs.existsSync(codexDir))
-        return '';
-    const sections = [];
-    // Read top-level .md files (included for all animas)
-    for (const entry of fs.readdirSync(codexDir, { withFileTypes: true })) {
-        if (entry.isFile() && entry.name.endsWith('.md')) {
-            const content = fs.readFileSync(path.join(codexDir, entry.name), 'utf-8').trim();
-            if (content)
-                sections.push(content);
-        }
-    }
-    return sections.join('\n\n---\n\n');
-}
-/**
- * Read role-specific instructions for an anima's roles.
- *
- * For each role the anima holds, reads the instructions file pointed to by
- * the role definition in guild.json. Skips undefined roles (warning already
- * emitted by resolveTools). Skips roles without instructions.
- */
-export function readRoleInstructions(home, config, animaRoles) {
-    const sections = [];
-    for (const role of animaRoles) {
-        const roleDef = config.roles[role];
-        if (!roleDef || !roleDef.instructions)
-            continue;
-        const instructionsPath = path.join(home, roleDef.instructions);
-        if (!fs.existsSync(instructionsPath))
-            continue;
-        try {
-            const content = fs.readFileSync(instructionsPath, 'utf-8').trim();
-            if (content) {
-                sections.push(content);
-            }
-        }
-        catch {
-            // If unreadable, skip
-        }
-    }
-    return sections.join('\n\n---\n\n');
-}
-/**
- * Assemble the composed system prompt for an anima session.
- *
- * Sections are included in order: codex → role instructions → curricula →
- * temperament → tool instructions → unavailable tools notice.
- * Empty sections are omitted.
- */
-export function assembleSystemPrompt(codex, roleInstructions, anima, tools, unavailable = []) {
-    const sections = [];
-    // Codex — guild-wide policies and procedures
-    if (codex.trim()) {
-        sections.push(`# Codex\n\n${codex}`);
-    }
-    // Role instructions — role-specific operational guidance
-    if (roleInstructions.trim()) {
-        sections.push(`# Role Instructions\n\n${roleInstructions}`);
-    }
-    // Curricula — the anima's training content
-    if (anima.curriculumSnapshot.trim()) {
-        sections.push(`# Training\n\n${anima.curriculumSnapshot}`);
-    }
-    // Temperament — the anima's personality
-    if (anima.temperamentSnapshot.trim()) {
-        sections.push(`# Temperament\n\n${anima.temperamentSnapshot}`);
-    }
-    // Tool instructions — guidance for each tool the anima has access to
-    const toolInstructions = tools
-        .filter(t => t.instructions)
-        .map(t => t.instructions);
-    if (toolInstructions.length > 0) {
-        sections.push(`# Tool Instructions\n\n${toolInstructions.join('\n\n---\n\n')}`);
-    }
-    // Unavailable tools notice — tell the anima what's broken and why
-    if (unavailable.length > 0) {
-        const notices = unavailable.map(u => {
-            const reasons = u.reasons.map(r => `  - ${r}`).join('\n');
-            return `**${u.name}** — unavailable:\n${reasons}`;
-        });
-        sections.push(`# Unavailable Tools\n\n` +
-            `The following tools are registered for your roles but are currently ` +
-            `unavailable due to unmet environment requirements. Do not attempt to use them. ` +
-            `If a patron or operator asks you to perform work that requires these tools, ` +
-            `explain what is needed to make them available.\n\n` +
-            notices.join('\n\n'));
-    }
-    return sections.join('\n\n---\n\n');
-}
-/**
- * Manifest an anima for a session.
- *
- * This is the main entry point. Reads the anima's composition, resolves
- * tools by role, assembles the system prompt, and returns the full
- * manifest with composition provenance.
- */
-export async function manifest(home, animaName) {
-    const config = readGuildConfig(home);
-    const anima = readAnima(home, animaName);
-    if (anima.status !== 'active') {
-        throw new Error(`Anima "${animaName}" is not active (status: ${anima.status}). Cannot manifest.`);
-    }
-    // Resolve tools based on role definitions + precondition checks
-    const { available, unavailable, warnings } = await resolveTools(home, config, anima.roles);
-    // Read codex (guild-wide, no role filtering)
-    const codex = readCodex(home);
-    // Read role-specific instructions
-    const roleInstructions = readRoleInstructions(home, config, anima.roles);
-    // Assemble system prompt (includes role instructions and unavailability notices)
-    const systemPrompt = assembleSystemPrompt(codex, roleInstructions, anima, available, unavailable);
-    // Build composition provenance
-    const curriculum = anima.curriculumName
-        ? { name: anima.curriculumName, version: anima.curriculumVersion, content: anima.curriculumSnapshot }
-        : null;
-    const temperament = anima.temperamentName
-        ? { name: anima.temperamentName, version: anima.temperamentVersion, content: anima.temperamentSnapshot }
-        : null;
-    const toolInstructions = available
-        .filter(t => t.instructions)
-        .map(t => ({ toolName: t.name, instructions: t.instructions }));
-    return {
-        anima,
-        systemPrompt,
-        composition: {
-            codex,
-            roleInstructions,
-            curriculum,
-            temperament,
-            toolInstructions,
-        },
-        tools: available,
-        unavailable,
-        warnings,
-    };
-}
-//# sourceMappingURL=manifest.js.map

package/dist/legacy/1/manifest.js.map

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

package/dist/legacy/1/migrate.d.ts

@@ -1,84 +0,0 @@
-/**
- * Database migration — applies pending SQL migrations to the guild's Books.
- *
- * Core framework migrations ship with the `@shardworks/nexus-core` package
- * and are applied automatically when the Books are opened (unless the guild
- * opts out via `settings.autoMigrate: false` in guild.json).
- *
- * Migrations are numbered sequentially (001-schema.sql, etc.) and applied in
- * order. The module tracks which migrations have been applied in a
- * `_migrations` table and only runs new ones.
- *
- * ## Migration sources
- *
- * 1. **Core migrations** — bundled with nexus-core, define the framework schema.
- * 2. **Guild migrations** — in the guild's `nexus/migrations/` directory, for
- *    guild-specific schema extensions delivered by bundles.
- *
- * ## Migration file naming
- *
- * Files must match the pattern: NNN-description.sql
- * where NNN is a zero-padded sequence number.
- */
-/** A migration file discovered on disk. */
-export interface MigrationFile {
-    /** Sequence number (e.g. 1, 2, 3). */
-    sequence: number;
-    /** Full filename (e.g. '001-initial-schema.sql'). */
-    filename: string;
-    /** Absolute path to the file. */
-    path: string;
-}
-/** Provenance metadata for migrations installed via bundles. */
-export interface MigrationProvenance {
-    /** Bundle that delivered this migration (e.g. "@shardworks/guild-starter-kit@0.1.5"). */
-    bundle: string;
-    /** Original filename in the bundle before renumbering (e.g. "001-initial-schema.sql"). */
-    originalName: string;
-}
-/** Result of applying migrations. */
-export interface MigrateResult {
-    /** Migrations that were applied in this run. */
-    applied: string[];
-    /** Migrations that were already applied (skipped). */
-    skipped: string[];
-    /** Total number of migrations on disk. */
-    total: number;
-}
-/**
- * Discover migration files in a directory, sorted by sequence.
- */
-export declare function discoverMigrations(migrationsDir: string): MigrationFile[];
-/**
- * Apply pending core framework migrations to the guild's Books.
- *
- * Core migrations are bundled with the nexus-core package and define
- * the framework's required schema (sessions, writs, events, etc.).
- *
- * @param home - Absolute path to the guild root.
- * @returns Summary of what was applied and skipped.
- */
-export declare function applyCoreMigrations(home: string): MigrateResult;
-/**
- * Apply pending guild-local migrations to the guild's Books.
- *
- * Guild-local migrations live in `nexus/migrations/` within the guild
- * directory and are delivered by bundles for guild-specific schema extensions.
- *
- * @param home - Absolute path to the guild root.
- * @param provenance - Optional map of guild filename → bundle provenance.
- * @returns Summary of what was applied and skipped.
- */
-export declare function applyMigrations(home: string, provenance?: Record<string, MigrationProvenance>): MigrateResult;
-/**
- * Ensure the guild's Books database has all pending core migrations applied.
- *
- * Called automatically before database access. Reads `settings.autoMigrate`
- * from guild.json (defaults to `true`). Skips if auto-migration is disabled
- * or if this guild was already migrated in the current process.
- *
- * @param home - Absolute path to the guild root.
- * @returns The migrations that were applied, or null if skipped.
- */
-export declare function ensureBooks(home: string): MigrateResult | null;
-//# sourceMappingURL=migrate.d.ts.map

package/dist/legacy/1/migrate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/legacy/1/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAuDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAoBzE;AAmED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAmB/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC/C,aAAa,CAqBf;AAOD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsB9D"}