vgxness 1.20.4 → 1.20.6

package/dist/agents/agent-seed-service.js

@@ -1,157 +1 @@
-import { AgentRepository } from './repositories/agents.js';
-import { projectCanonicalAgentManifestToSeed } from './canonical-agent-projection.js';
-const requiredManagerName = 'vgxness-manager';
-export class AgentSeedService {
-    database;
-    agents;
-    constructor(database) {
-        this.database = database;
-        this.agents = new AgentRepository(database);
-    }
-    loadBuiltInDefaults() {
-        try {
-            return this.loadManifest(projectCanonicalAgentManifestToSeed());
-        }
-        catch (cause) {
-            const message = cause instanceof Error ? cause.message : String(cause);
-            return { ok: false, error: { code: 'validation_failed', message } };
-        }
-    }
-    loadManifest(manifest) {
-        const validation = this.validateManifest(manifest);
-        if (!validation.ok)
-            return validation;
-        const existingNames = new Map();
-        for (const definition of [...manifest.agents, ...manifest.subagents]) {
-            const existing = this.agents.getByName(manifest.project, manifest.scope, definition.name);
-            if (existing.ok)
-                existingNames.set(definition.name, true);
-            else
-                existingNames.set(definition.name, false);
-        }
-        const transaction = this.database.transaction(() => {
-            const agents = [];
-            const subagents = [];
-            const nameToId = new Map();
-            const created = [];
-            const updated = [];
-            for (const definition of manifest.agents) {
-                const registered = this.agents.register(toRegisterInput(manifest, definition, 'agent'));
-                if (!registered.ok)
-                    throw new SeedLoadError(registered.error);
-                agents.push(registered.value);
-                nameToId.set(registered.value.name, registered.value.id);
-                (existingNames.get(definition.name) ? updated : created).push(definition.name);
-            }
-            for (const definition of manifest.subagents) {
-                const parentAgentId = nameToId.get(definition.parentAgentName) ?? this.resolveExistingParentId(manifest, definition.parentAgentName);
-                if (parentAgentId === undefined) {
-                    throw new SeedLoadError({ code: 'validation_failed', message: `Unresolved parentAgentName: ${definition.parentAgentName}` });
-                }
-                const registered = this.agents.register(toRegisterInput(manifest, definition, 'subagent', parentAgentId));
-                if (!registered.ok)
-                    throw new SeedLoadError(registered.error);
-                subagents.push(registered.value);
-                (existingNames.get(definition.name) ? updated : created).push(definition.name);
-            }
-            return { created, updated, agents, subagents, warnings: [] };
-        });
-        if (!transaction.ok) {
-            if (transaction.error.cause instanceof SeedLoadError)
-                return { ok: false, error: transaction.error.cause.failure };
-            return transaction;
-        }
-        return transaction;
-    }
-    validateManifest(manifest) {
-        if (manifest.version !== 1)
-            return validationFailure('Agent seed manifest version must be 1');
-        if (!manifest.project?.trim())
-            return validationFailure('Agent seed manifest project is required');
-        if (manifest.scope !== 'project' && manifest.scope !== 'personal')
-            return validationFailure('Agent seed manifest scope must be project or personal');
-        if (!Array.isArray(manifest.agents))
-            return validationFailure('Agent seed manifest agents must be an array');
-        if (!Array.isArray(manifest.subagents))
-            return validationFailure('Agent seed manifest subagents must be an array');
-        const managerCount = manifest.agents.filter((agent) => agent.name === requiredManagerName).length;
-        if (managerCount !== 1)
-            return validationFailure(`Agent seed manifest must declare exactly one ${requiredManagerName} agent`);
-        const seenNames = new Set();
-        for (const definition of manifest.agents) {
-            const validation = validateDefinition(definition, 'agent');
-            if (!validation.ok)
-                return validation;
-            if (seenNames.has(definition.name))
-                return validationFailure(`Duplicate seed agent name: ${definition.name}`);
-            seenNames.add(definition.name);
-        }
-        for (const definition of manifest.subagents) {
-            const validation = validateDefinition(definition, 'subagent');
-            if (!validation.ok)
-                return validation;
-            if (seenNames.has(definition.name))
-                return validationFailure(`Duplicate seed agent name: ${definition.name}`);
-            seenNames.add(definition.name);
-            if (!definition.parentAgentName.trim())
-                return validationFailure(`Subagent ${definition.name} parentAgentName is required`);
-            if (!manifest.agents.some((agent) => agent.name === definition.parentAgentName) &&
-                this.resolveExistingParentId(manifest, definition.parentAgentName) === undefined) {
-                return validationFailure(`Unresolved parentAgentName: ${definition.parentAgentName}`);
-            }
-        }
-        return { ok: true, value: undefined };
-    }
-    resolveExistingParentId(manifest, parentAgentName) {
-        const parent = this.agents.getByName(manifest.project, manifest.scope, parentAgentName);
-        if (!parent.ok || parent.value.mode !== 'agent')
-            return undefined;
-        return parent.value.id;
-    }
-}
-function validateDefinition(definition, mode) {
-    if (!definition.name?.trim())
-        return validationFailure(`Seed ${mode} name is required`);
-    if (!definition.description?.trim())
-        return validationFailure(`Seed ${mode} ${definition.name} description is required`);
-    if (definition.instructions?.kind !== 'inline' && definition.instructions?.kind !== 'path')
-        return validationFailure(`Seed ${mode} ${definition.name} instructions kind is invalid`);
-    if (!definition.instructions.value.trim())
-        return validationFailure(`Seed ${mode} ${definition.name} instructions are required`);
-    return { ok: true, value: undefined };
-}
-function toRegisterInput(manifest, definition, mode, parentAgentId) {
-    const input = {
-        project: manifest.project,
-        scope: manifest.scope,
-        mode,
-        name: definition.name,
-        description: definition.description,
-        instructions: definition.instructions,
-    };
-    if (definition.capabilities !== undefined)
-        input.capabilities = definition.capabilities;
-    if (definition.permissions !== undefined)
-        input.permissions = definition.permissions;
-    if (definition.memory !== undefined)
-        input.memory = definition.memory;
-    if (definition.workflows !== undefined)
-        input.workflows = definition.workflows;
-    if (definition.skills !== undefined)
-        input.skills = definition.skills;
-    if (definition.adapters !== undefined)
-        input.adapters = definition.adapters;
-    if (parentAgentId !== undefined)
-        input.parentAgentId = parentAgentId;
-    return input;
-}
-function validationFailure(message) {
-    return { ok: false, error: { code: 'validation_failed', message } };
-}
-class SeedLoadError extends Error {
-    failure;
-    constructor(failure) {
-        super(failure.message);
-        this.failure = failure;
-    }
-}
+export * from '../application/agents/agent-seed-service.js';

package/dist/agents/agent-seed-upgrade-service.js

@@ -1,231 +1 @@
-import { canonicalAgentManifest, canonicalPromptContractVersion, canonicalSddSubagentNames } from './canonical-agent-manifest.js';
-import { projectCanonicalAgentManifestToSeed } from './canonical-agent-projection.js';
-export class AgentSeedUpgradeService {
-    agents;
-    history;
-    database;
-    constructor(dependencies) {
-        this.agents = dependencies.agents;
-        this.history = dependencies.history;
-        this.database = dependencies.database;
-    }
-    upgrade(input) {
-        if (!input.project.trim())
-            return validationFailure('Agent seed upgrade project is required');
-        if (input.scope !== 'project' && input.scope !== 'personal')
-            return validationFailure('Agent seed upgrade scope is invalid');
-        const seed = projectCanonicalAgentManifestToSeed();
-        const canonicalByName = new Map();
-        for (const agent of seed.agents)
-            canonicalByName.set(agent.name, agent);
-        for (const subagent of seed.subagents)
-            canonicalByName.set(subagent.name, subagent);
-        const source = input.source ?? 'boot-upgrade';
-        const summary = {
-            created: [],
-            upgraded: [],
-            noop: [],
-            overwritten: [],
-            errors: [],
-            skipped: false,
-        };
-        const expected = canonicalPromptContractVersion;
-        const transaction = this.database.transaction(() => {
-            for (const [name, definition] of canonicalByName) {
-                const outcome = this.upgradeOne(input.project, input.scope, name, definition, source, expected);
-                if (outcome.ok) {
-                    switch (outcome.value.outcome) {
-                        case 'created':
-                            summary.created.push(name);
-                            break;
-                        case 'upgraded':
-                            summary.upgraded.push(name);
-                            break;
-                        case 'overwrote-custom-instructions':
-                            summary.overwritten.push(name);
-                            break;
-                        case 'noop':
-                            summary.noop.push(name);
-                            break;
-                    }
-                }
-                else {
-                    const failureOutcome = outcome.error.code === 'validation_failed' ? 'validation_failed' : 'db_error';
-                    summary.errors.push({ agentName: name, outcome: failureOutcome, reason: outcome.error.message });
-                }
-            }
-            return summary;
-        });
-        if (!transaction.ok) {
-            return { ok: false, error: transaction.error };
-        }
-        return transaction;
-    }
-    hasDrift(input) {
-        const expected = input.expectedVersion ?? canonicalPromptContractVersion;
-        try {
-            const canonicalNames = [canonicalAgentManifest.defaultAgentName, ...canonicalSddSubagentNames];
-            const placeholders = canonicalNames.map(() => '?').join(', ');
-            const row = this.database.connection
-                .prepare(`
-        SELECT COUNT(*) AS stale_count
-        FROM agents
-        WHERE project = ? AND scope = ? AND name IN (${placeholders})
-          AND json_extract(adapters_json, '$.opencode.config.options.vgxnessPromptContractVersion') <> ?
-      `)
-                .get(input.project, input.scope, ...canonicalNames, expected);
-            return ok((row?.stale_count ?? 0) > 0);
-        }
-        catch (cause) {
-            return fail('Failed to detect agent seed drift', cause);
-        }
-    }
-    upgradeOne(project, scope, name, definition, source, expected) {
-        const existing = this.agents.getByName(project, scope, name);
-        const fromVersion = existing.ok ? readPromptContractVersion(existing.value) : null;
-        if (existing.ok && fromVersion === expected && isByteEqualToCanonical(existing.value, definition)) {
-            return ok({ outcome: 'noop', fromVersion: expected });
-        }
-        const parentAgentId = 'parentAgentName' in definition ? this.resolveParentId(project, scope, definition.parentAgentName) : undefined;
-        if ('parentAgentName' in definition && parentAgentId === undefined) {
-            return validationFailure(`Unresolved parentAgentName: ${definition.parentAgentName}`);
-        }
-        const registerInput = toRegisterInput(project, scope, definition, parentAgentId);
-        const registered = this.agents.register(registerInput);
-        if (!registered.ok) {
-            this.appendHistory({
-                project,
-                scope,
-                agentName: name,
-                fromVersion,
-                toVersion: expected,
-                outcome: registered.error.code === 'validation_failed' ? 'validation_failed' : 'db_error',
-                reason: registered.error.message,
-                source,
-            });
-            return registered;
-        }
-        let outcome;
-        if (!existing.ok) {
-            outcome = 'created';
-        }
-        else if (fromVersion !== null && fromVersion !== expected) {
-            outcome = 'upgraded';
-        }
-        else {
-            outcome = 'overwrote-custom-instructions';
-        }
-        this.appendHistory({
-            project,
-            scope,
-            agentName: name,
-            fromVersion,
-            toVersion: expected,
-            outcome,
-            reason: outcomeReason(outcome, fromVersion, expected, existing.ok),
-            source,
-        });
-        return ok({ outcome, fromVersion });
-    }
-    resolveParentId(project, scope, parentAgentName) {
-        const parent = this.agents.getByName(project, scope, parentAgentName);
-        if (!parent.ok || parent.value.mode !== 'agent')
-            return undefined;
-        return parent.value.id;
-    }
-    appendHistory(input) {
-        this.history.append({
-            project: input.project,
-            scope: input.scope,
-            agentName: input.agentName,
-            fromVersion: input.fromVersion,
-            toVersion: input.toVersion,
-            outcome: input.outcome,
-            reason: input.reason,
-            source: input.source,
-        });
-    }
-}
-function toRegisterInput(project, scope, definition, parentAgentId) {
-    const input = {
-        project,
-        scope,
-        mode: 'parentAgentName' in definition ? 'subagent' : 'agent',
-        name: definition.name,
-        description: definition.description,
-        instructions: definition.instructions,
-    };
-    if (definition.capabilities !== undefined)
-        input.capabilities = definition.capabilities;
-    if (definition.permissions !== undefined)
-        input.permissions = definition.permissions;
-    if (definition.memory !== undefined)
-        input.memory = definition.memory;
-    if (definition.workflows !== undefined)
-        input.workflows = definition.workflows;
-    if (definition.skills !== undefined)
-        input.skills = definition.skills;
-    if (definition.adapters !== undefined)
-        input.adapters = definition.adapters;
-    if (parentAgentId !== undefined)
-        input.parentAgentId = parentAgentId;
-    return input;
-}
-function isByteEqualToCanonical(existing, definition) {
-    if (existing.description !== definition.description)
-        return false;
-    if (existing.instructions.value !== definition.instructions.value)
-        return false;
-    if (!adaptersEqual(existing.adapters, definition.adapters ?? {}))
-        return false;
-    if (!arraysEqual(existing.capabilities, definition.capabilities ?? []))
-        return false;
-    if (!arraysEqual(existing.workflows, definition.workflows ?? []))
-        return false;
-    if (!arraysEqual(existing.skills, definition.skills ?? []))
-        return false;
-    return true;
-}
-function adaptersEqual(a, b) {
-    return JSON.stringify(a ?? {}) === JSON.stringify(b ?? {});
-}
-function arraysEqual(a, b) {
-    if (a.length !== b.length)
-        return false;
-    for (let i = 0; i < a.length; i += 1) {
-        if (a[i] !== b[i])
-            return false;
-    }
-    return true;
-}
-function readPromptContractVersion(agent) {
-    const opencode = agent.adapters?.opencode;
-    if (opencode === undefined)
-        return null;
-    const options = opencode.config?.options;
-    const value = options?.vgxnessPromptContractVersion;
-    if (typeof value !== 'number' || !Number.isInteger(value))
-        return null;
-    return value;
-}
-function outcomeReason(outcome, fromVersion, toVersion, existed) {
-    if (outcome === 'created')
-        return `created canonical row at v${toVersion}`;
-    if (outcome === 'upgraded')
-        return `upgraded v${fromVersion ?? 'unknown'} -> v${toVersion}`;
-    if (outcome === 'overwrote-custom-instructions')
-        return `overwrote customized row (was v${fromVersion ?? 'unknown'}) with v${toVersion} canonical`;
-    return existed ? `noop at v${toVersion}` : `noop at v${toVersion}`;
-}
-function ok(value) {
-    return { ok: true, value };
-}
-function validationFailure(message) {
-    return { ok: false, error: { code: 'validation_failed', message } };
-}
-function fail(message, cause) {
-    const error = { code: 'validation_failed', message };
-    if (cause !== undefined)
-        error.cause = cause;
-    return { ok: false, error };
-}
+export * from '../application/agents/agent-seed-upgrade-service.js';

package/dist/agents/agent-selector-resolver.js

@@ -1,28 +1 @@
-import { agentLookupContexts } from './agent-lookup-contexts.js';
-export const agentSelectorNameFallbackCode = 'AGENT_SELECTOR_NAME_FALLBACK';
-export function resolveAgentSelector(input, lookup) {
-    const byId = lookup.getById(input.selector);
-    if (byId.ok)
-        return ok({ agent: byId.value });
-    for (const context of agentLookupContexts(input.project, input.scope)) {
-        const byName = lookup.getByName(context.project, context.scope, input.selector);
-        if (byName.ok) {
-            return ok({
-                agent: byName.value,
-                warning: `${agentSelectorNameFallbackCode}: selector "${input.selector}" matched agent name in ${context.project}/${context.scope}; using canonical agent id "${byName.value.id}" name "${byName.value.name}".`,
-            });
-        }
-        if (byName.error.code !== 'not_found')
-            return byName;
-    }
-    return {
-        ok: false,
-        error: {
-            code: 'not_found',
-            message: `Agent selector not found: "${input.selector}". Looked up registry id first, then agent name across project, personal, and VGXNESS global contexts for project "${input.project}" and scope "${input.scope}". Accepted forms: canonical agent id or visible agent name.`,
-        },
-    };
-}
-function ok(value) {
-    return { ok: true, value };
-}
+export * from '../application/agents/agent-selector-resolver.js';

package/dist/agents/boot-upgrade.js

@@ -1,59 +1 @@
-import { AgentSeedUpgradeService } from './agent-seed-upgrade-service.js';
-import { AgentRepository } from './repositories/agents.js';
-import { AgentSeedHistoryRepository } from './repositories/agent-seed-history.js';
-import { canonicalAgentManifest } from './canonical-agent-manifest.js';
-const skipEnvVar = 'VGXNESS_SKIP_AGENT_SEED_AUTO_UPGRADE';
-export function runBootAgentSeedUpgrade(database, env = process.env, project = canonicalAgentManifest.project, scope = canonicalAgentManifest.scope) {
-    if (isOptOut(env)) {
-        return { ok: true, skipped: true, created: 0, upgraded: 0, overwritten: 0, noop: 0, errors: 0 };
-    }
-    try {
-        const service = new AgentSeedUpgradeService({
-            agents: new AgentRepository(database),
-            history: new AgentSeedHistoryRepository(database),
-            database,
-        });
-        const result = service.upgrade({ project, scope, source: 'boot-upgrade' });
-        if (!result.ok) {
-            const message = `boot-upgrade failed: ${result.error.message} (code=${result.error.code})`;
-            process.stderr.write(`[vgxness] ${message}\n`);
-            return { ok: false, skipped: false, created: 0, upgraded: 0, overwritten: 0, noop: 0, errors: 1, message };
-        }
-        const value = result.value;
-        const touched = value.created.length + value.upgraded.length + value.overwritten.length + value.errors.length;
-        if (touched > 0) {
-            const parts = [];
-            if (value.created.length > 0)
-                parts.push(`created ${value.created.length}`);
-            if (value.upgraded.length > 0)
-                parts.push(`upgraded ${value.upgraded.length}`);
-            if (value.overwritten.length > 0)
-                parts.push(`overwrote ${value.overwritten.length}`);
-            if (value.errors.length > 0)
-                parts.push(`errors ${value.errors.length}`);
-            process.stderr.write(`[vgxness] boot-upgrade: ${parts.join(', ')}\n`);
-            for (const error of value.errors) {
-                process.stderr.write(`[vgxness] boot-upgrade: ${error.agentName} ${error.outcome}: ${error.reason}\n`);
-            }
-        }
-        return {
-            ok: true,
-            skipped: false,
-            created: value.created.length,
-            upgraded: value.upgraded.length,
-            overwritten: value.overwritten.length,
-            noop: value.noop.length,
-            errors: value.errors.length,
-        };
-    }
-    catch (cause) {
-        const detail = cause instanceof Error ? `${cause.name}: ${cause.message}` : String(cause);
-        const message = `boot-upgrade threw: ${detail}`;
-        process.stderr.write(`[vgxness] ${message}\n`);
-        return { ok: false, skipped: false, created: 0, upgraded: 0, overwritten: 0, noop: 0, errors: 1, message };
-    }
-}
-function isOptOut(env) {
-    const value = env[skipEnvVar];
-    return value === '1' || value === 'true';
-}
+export * from '../application/agents/boot-upgrade.js';