@vraxis/agent-v 0.4.0

package/dist/adapters/ollama/index.js

@@ -0,0 +1,155 @@
+import { createOllama } from "ai-sdk-ollama";
+import { AgentVError, safeFailure, } from "../../core/index.js";
+import { AiSdkStructuredModelEngine, AiSdkToolAgentEngine, } from "../ai-sdk/index.js";
+const DEFAULT_BASE_URL = "http://127.0.0.1:11434";
+const ADAPTER_STRATEGY = "ai-sdk-ollama-v4-native-chat";
+function baseURLOf(options) {
+    const value = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (error) {
+        throw new AgentVError("configuration-invalid", "Ollama baseURL must be a valid absolute URL.", { cause: error });
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+        throw new AgentVError("configuration-invalid", "Ollama baseURL must use HTTP or HTTPS.");
+    if (url.username || url.password)
+        throw new AgentVError("configuration-invalid", "Ollama credentials must be supplied through apiKey or headers, not embedded in baseURL.");
+    if (url.search || url.hash)
+        throw new AgentVError("configuration-invalid", "Ollama baseURL must not contain a query string or fragment.");
+    return url.toString().replace(/\/$/, "");
+}
+function headersOf(options) {
+    const headers = new Headers(options.headers);
+    if (options.apiKey && !headers.has("authorization"))
+        headers.set("authorization", `Bearer ${options.apiKey}`);
+    return headers;
+}
+async function jsonRequest(fetcher, url, headers, signal) {
+    let response;
+    try {
+        response = await fetcher(url, { method: "GET", headers, signal });
+    }
+    catch (error) {
+        if (error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError")) {
+            throw new AgentVError("timeout", "Ollama did not answer the readiness check in time.", { retryable: true, cause: error });
+        }
+        throw new AgentVError("engine-unavailable", "Could not connect to the configured Ollama server.", { retryable: true, cause: error });
+    }
+    if (!response.ok) {
+        const code = response.status === 401 || response.status === 403 ? "authentication-required" : "engine-unavailable";
+        throw new AgentVError(code, `Ollama readiness request failed with HTTP ${response.status}.`, { retryable: response.status >= 500 });
+    }
+    return response.json();
+}
+/** Inspects daemon reachability, version, and installed models without running inference. */
+export async function inspectOllama(options = {}, _context = {}) {
+    const baseURL = baseURLOf(options);
+    const started = Date.now();
+    const checkedAt = new Date().toISOString();
+    try {
+        const fetcher = options.fetch ?? globalThis.fetch;
+        if (!fetcher)
+            throw new AgentVError("engine-unavailable", "This runtime does not provide fetch for Ollama readiness checks.");
+        const signal = AbortSignal.timeout(options.readinessTimeoutMs ?? 3_000);
+        const headers = headersOf(options);
+        const [versionValue, tagsValue] = await Promise.all([
+            jsonRequest(fetcher, `${baseURL}/api/version`, headers, signal),
+            jsonRequest(fetcher, `${baseURL}/api/tags`, headers, signal),
+        ]);
+        const version = versionValue.version;
+        const models = tagsValue.models;
+        if (typeof version !== "string" || !Array.isArray(models)) {
+            throw new AgentVError("output-invalid", "Ollama returned an unexpected readiness response.");
+        }
+        const modelIds = [...new Set(models.flatMap((entry) => {
+                const id = typeof entry.model === "string" ? entry.model : typeof entry.name === "string" ? entry.name : undefined;
+                return id ? [id] : [];
+            }))].sort();
+        return {
+            providerId: "ollama",
+            availability: "ready",
+            baseURL,
+            version,
+            models: modelIds,
+            checkedAt,
+            durationMs: Date.now() - started,
+            detail: `Ollama ${version} is reachable with ${modelIds.length} installed model${modelIds.length === 1 ? "" : "s"}.`,
+        };
+    }
+    catch (error) {
+        const failure = safeFailure(error);
+        const availability = failure.code === "authentication-required" ? "setup-required" : "unreachable";
+        return {
+            providerId: "ollama",
+            availability,
+            baseURL,
+            models: [],
+            checkedAt,
+            durationMs: Date.now() - started,
+            detail: failure.code === "authentication-required" ? "Ollama rejected the configured credentials." : "Ollama is not reachable at the configured base URL.",
+            failure: { code: failure.code, message: failure.message, retryable: failure.retryable },
+        };
+    }
+}
+/** Creates a per-run resolver that fails closed on daemon or installed-model drift. */
+export function createOllamaModelResolver(options = {}) {
+    return async (selection) => {
+        const modelId = selection.modelId ?? options.defaultModel;
+        if (!modelId)
+            throw new AgentVError("configuration-invalid", "An Ollama model id is required on the adapter or run request.");
+        const readiness = await inspectOllama(options, { scope: selection.scope, metadata: selection.metadata });
+        if (readiness.availability !== "ready" || !readiness.version) {
+            throw new AgentVError(readiness.failure?.code ?? "engine-unavailable", readiness.detail, { retryable: readiness.failure?.retryable });
+        }
+        if ((options.requireInstalledModel ?? true) && !readiness.models.includes(modelId)) {
+            throw new AgentVError("engine-unavailable", `Ollama model ${modelId} is not installed at ${readiness.baseURL}.`);
+        }
+        const settings = typeof options.modelSettings === "function" ? await options.modelSettings(selection) : options.modelSettings;
+        const provider = createOllama({ baseURL: readiness.baseURL, apiKey: options.apiKey, headers: options.headers, fetch: options.fetch });
+        return {
+            model: provider(modelId, settings),
+            provenance: {
+                provider: "ollama",
+                model: modelId,
+                runtime: "ollama",
+                runtimeVersion: readiness.version,
+                adapterStrategy: ADAPTER_STRATEGY,
+            },
+        };
+    };
+}
+/** Paired structured and tool-agent engines backed by one Ollama configuration. */
+export class OllamaRuntime {
+    structured;
+    agent;
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        const id = options.id ?? "ollama";
+        const resolveModel = createOllamaModelResolver(options);
+        this.structured = new AiSdkStructuredModelEngine({
+            id: `${id}:structured`,
+            name: `${options.name ?? "Ollama"} structured model`,
+            provider: "ollama",
+            modelId: options.defaultModel,
+            adapterStrategy: ADAPTER_STRATEGY,
+            runtime: "ollama",
+            resolveModel,
+        });
+        this.agent = new AiSdkToolAgentEngine({
+            id: `${id}:agent`,
+            name: `${options.name ?? "Ollama"} tool agent`,
+            provider: "ollama",
+            modelId: options.defaultModel,
+            adapterStrategy: ADAPTER_STRATEGY,
+            runtime: "ollama",
+            resolveModel,
+        });
+    }
+    inspect(context) {
+        return inspectOllama(this.options, context);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/ollama/index.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { doctorAgentV } from "../node/doctor.js";
+import { fileURLToPath } from "node:url";
+const HELP = `agent-v <command> [options]
+
+Commands:
+  doctor                Inspect dependencies and runtime readiness
+  skill-path            Print the packaged agent-v Agent Skill directory
+
+Doctor options:
+
+Options:
+  --runtime <id>        Inspect one runtime; repeat for multiple runtimes
+  --probe               Run a bounded authenticated probe (requires --runtime)
+  --ollama-url <url>    Inspect a specific Ollama server
+  --ollama-model <id>   Require one installed Ollama model
+  --json                Emit the machine-readable report
+  --strict              Exit non-zero for warnings as well as errors
+  --help                Show this help
+
+Live probes may use configured provider credentials. They never weaken sandbox policy.
+`;
+function parseArguments(args) {
+    const runtimeIds = [];
+    const options = {};
+    let command;
+    let json = false;
+    let strict = false;
+    let help = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (!value.startsWith("-") && !command) {
+            command = value;
+            continue;
+        }
+        if (value === "--runtime") {
+            const id = args[++index];
+            if (!id)
+                throw new Error("--runtime requires an id.");
+            runtimeIds.push(id);
+            continue;
+        }
+        if (value === "--ollama-url") {
+            const url = args[++index];
+            if (!url)
+                throw new Error("--ollama-url requires a URL.");
+            options.ollamaBaseURL = url;
+            continue;
+        }
+        if (value === "--ollama-model") {
+            const model = args[++index];
+            if (!model)
+                throw new Error("--ollama-model requires an id.");
+            options.ollamaModel = model;
+            continue;
+        }
+        if (value === "--probe") {
+            options.probe = true;
+            continue;
+        }
+        if (value === "--json") {
+            json = true;
+            continue;
+        }
+        if (value === "--strict") {
+            strict = true;
+            continue;
+        }
+        if (value === "--help" || value === "-h") {
+            help = true;
+            continue;
+        }
+        throw new Error(`Unknown argument: ${value}`);
+    }
+    if (runtimeIds.length)
+        options.runtimeIds = runtimeIds;
+    return { command, options, json, strict, help };
+}
+function printReport(report) {
+    console.log(`agent-v ${report.packageVersion} doctor`);
+    for (const dependency of report.dependencies)
+        console.log(`  ${dependency.installed ? "✓" : "○"} ${dependency.name}${dependency.version ? ` ${dependency.version}` : ""} — ${dependency.purpose}`);
+    for (const runtime of report.runtimes)
+        console.log(`  ${runtime.availability === "installed" ? "✓" : "○"} ${runtime.runtimeId}${runtime.version ? ` ${runtime.version}` : ""} — ${runtime.verification}`);
+    console.log(`  ${report.ollama.availability === "ready" ? "✓" : "○"} ollama${report.ollama.version ? ` ${report.ollama.version}` : ""} — ${report.ollama.availability}`);
+    for (const issue of report.issues)
+        console.log(`  [${issue.severity}] ${issue.component}: ${issue.message}${issue.remediation ? ` ${issue.remediation}` : ""}`);
+}
+async function main() {
+    try {
+        const parsed = parseArguments(process.argv.slice(2));
+        if (parsed.help || !parsed.command) {
+            console.log(HELP);
+            return;
+        }
+        if (parsed.command === "skill-path") {
+            console.log(fileURLToPath(new URL("../../skills/agent-v", import.meta.url)));
+            return;
+        }
+        if (parsed.command !== "doctor")
+            throw new Error(`Unknown command: ${parsed.command}`);
+        const report = await doctorAgentV(parsed.options);
+        if (parsed.json)
+            console.log(JSON.stringify(report, null, 2));
+        else
+            printReport(report);
+        if (!report.ok || (parsed.strict && report.issues.some((issue) => issue.severity === "warning")))
+            process.exitCode = 1;
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : "agent-v doctor failed.");
+        process.exitCode = 1;
+    }
+}
+await main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/agent-v.d.ts

@@ -0,0 +1,29 @@
+import type { EventSink } from "./events.js";
+import type { AgentBlueprint } from "./extensions.js";
+import { ExtensionRegistry } from "./extensions.js";
+import type { ConfigStore } from "./config.js";
+import type { AgentRunStream, RunEventStore, SessionStore, ToolAgentRequest, ToolAgentResult } from "./contracts.js";
+import { EngineRegistry } from "./registry.js";
+export interface AgentVOptions {
+    engines?: EngineRegistry;
+    extensions?: ExtensionRegistry;
+    config?: ConfigStore;
+    events?: EventSink;
+    sessions?: SessionStore;
+    runEvents?: RunEventStore;
+}
+export declare class AgentV {
+    readonly engines: EngineRegistry;
+    readonly extensions: ExtensionRegistry;
+    readonly config: ConfigStore;
+    readonly events: EventSink;
+    readonly sessions?: SessionStore;
+    readonly runEvents?: RunEventStore;
+    constructor(options?: AgentVOptions);
+    private prepare;
+    private eventSink;
+    private saveSession;
+    run<T = string>(blueprint: AgentBlueprint, request: Omit<ToolAgentRequest<T>, "tools" | "maxSteps">): Promise<ToolAgentResult<T>>;
+    stream<T = string>(blueprint: AgentBlueprint, request: Omit<ToolAgentRequest<T>, "tools" | "maxSteps">): Promise<AgentRunStream<T>>;
+}
+//# sourceMappingURL=agent-v.d.ts.map

package/dist/core/agent-v.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-v.d.ts","sourceRoot":"","sources":["../../src/core/agent-v.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAgB,aAAa,EAAE,YAAY,EAAmB,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpJ,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAUD,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;gBAEvB,OAAO,GAAE,aAAkB;YASzB,OAAO;IA0DrB,OAAO,CAAC,SAAS;YAKH,WAAW;IAqBnB,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAejI,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAqB1I"}

package/dist/core/agent-v.js

@@ -0,0 +1,153 @@
+import { fanOutEventSink, noopEventSink } from "./events.js";
+import { ExtensionRegistry } from "./extensions.js";
+import { AgentVError } from "./errors.js";
+import { MemoryConfigStore } from "./config.js";
+import { EngineRegistry } from "./registry.js";
+import { assertExecutionScope } from "./types.js";
+export class AgentV {
+    engines;
+    extensions;
+    config;
+    events;
+    sessions;
+    runEvents;
+    constructor(options = {}) {
+        this.engines = options.engines ?? new EngineRegistry();
+        this.extensions = options.extensions ?? new ExtensionRegistry();
+        this.config = options.config ?? new MemoryConfigStore();
+        this.events = options.events ?? noopEventSink;
+        this.sessions = options.sessions;
+        this.runEvents = options.runEvents;
+    }
+    async prepare(blueprint, request) {
+        assertExecutionScope(request.scope);
+        const config = await this.config.load();
+        const profile = blueprint.profileId ? config.profiles.find((candidate) => candidate.id === blueprint.profileId) : undefined;
+        if (blueprint.profileId && !profile)
+            throw new AgentVError("configuration-invalid", `No engine profile named ${blueprint.profileId} is configured.`);
+        if (profile && profile.kind !== "tool-agent")
+            throw new AgentVError("configuration-invalid", `Engine profile ${profile.id} is not a tool-agent profile.`);
+        const engineId = profile?.engineId ?? blueprint.engineId;
+        if (!engineId)
+            throw new AgentVError("configuration-invalid", `Agent ${blueprint.id} does not resolve to an engine.`);
+        const engine = this.engines.require(engineId, "tool-agent");
+        for (const capability of blueprint.requiredCapabilities ?? []) {
+            if (!engine.descriptor.capabilities.includes(capability)) {
+                throw new AgentVError("unsupported-capability", `${engine.descriptor.name} does not support ${capability}.`);
+            }
+        }
+        const skills = (blueprint.skills ?? []).map((id) => this.extensions.skills.require(id));
+        const hasToolRestrictions = skills.length > 0;
+        const allowedBySkills = new Set(skills.flatMap((skill) => skill.tools));
+        const requestedTools = blueprint.tools;
+        const deniedTools = hasToolRestrictions ? requestedTools.filter((name) => !allowedBySkills.has(name)) : [];
+        if (deniedTools.length) {
+            throw new AgentVError("permission-denied", `Agent ${blueprint.id} requests tools not allowed by its selected skills: ${deniedTools.join(", ")}.`);
+        }
+        const tools = requestedTools.map((name) => this.extensions.tools.require(name));
+        const skillInstructions = skills.map((skill) => `Skill: ${skill.name}\n${skill.instructions}`).join("\n\n");
+        const session = request.sessionId && this.sessions ? await this.sessions.get(request.scope, request.sessionId) : undefined;
+        if (session && session.agentId !== blueprint.id) {
+            throw new AgentVError("session-conflict", `Session ${session.id} belongs to agent ${session.agentId}, not ${blueprint.id}.`);
+        }
+        const sessionMessages = session?.messages ?? [];
+        let enriched = {
+            ...request,
+            runId: request.runId ?? crypto.randomUUID(),
+            input: {
+                ...request.input,
+                instructions: [blueprint.instructions, skillInstructions, request.input.instructions].filter(Boolean).join("\n\n"),
+                messages: [...sessionMessages, ...(request.input.messages ?? [])],
+                artifacts: [...skills.flatMap((skill) => skill.artifacts ?? []), ...(request.input.artifacts ?? [])],
+            },
+            tools,
+            model: request.model ?? profile?.model,
+            credentialRef: request.credentialRef ?? profile?.credentialRef,
+            engineOptions: request.engineOptions ?? profile?.options,
+            maxSteps: blueprint.maxSteps ?? config.execution.maxSteps,
+        };
+        const middleware = this.extensions.middleware.list();
+        const entered = [];
+        try {
+            for (const item of middleware) {
+                enriched = await item.beforeRun?.(enriched) ?? enriched;
+                entered.push(item);
+            }
+        }
+        catch (error) {
+            for (const item of entered.reverse())
+                await item.onError?.(error);
+            throw error;
+        }
+        return { blueprint, engine, request: enriched, middleware, session };
+    }
+    eventSink() {
+        if (!this.runEvents)
+            return this.events;
+        return fanOutEventSink(this.events, { emit: (event) => this.runEvents.append(event) });
+    }
+    async saveSession(prepared, result) {
+        const sessionId = prepared.request.sessionId;
+        if (!sessionId || !this.sessions)
+            return;
+        const now = new Date().toISOString();
+        const previous = prepared.session?.messages ?? [];
+        await this.sessions.save({
+            id: sessionId,
+            agentId: prepared.blueprint.id,
+            createdAt: prepared.session?.createdAt ?? now,
+            updatedAt: now,
+            messages: [
+                ...previous,
+                ...(prepared.request.input.messages ?? []).slice(previous.length),
+                { role: "user", parts: [{ type: "text", text: prepared.request.input.prompt }] },
+                { role: "assistant", parts: [{ type: "text", text: result.text }] },
+            ],
+            metadata: prepared.request.metadata,
+            scope: prepared.request.scope,
+        });
+    }
+    async run(blueprint, request) {
+        let middleware = [];
+        try {
+            const prepared = await this.prepare(blueprint, request);
+            middleware = prepared.middleware;
+            let result = await prepared.engine.run(prepared.request, this.eventSink());
+            for (const item of [...middleware].reverse())
+                result = await item.afterRun?.(result) ?? result;
+            await this.saveSession(prepared, result);
+            return result;
+        }
+        catch (error) {
+            for (const item of [...middleware].reverse())
+                await item.onError?.(error);
+            throw error;
+        }
+    }
+    async stream(blueprint, request) {
+        let middleware = [];
+        try {
+            const prepared = await this.prepare(blueprint, request);
+            middleware = prepared.middleware;
+            const stream = await prepared.engine.stream(prepared.request, this.eventSink());
+            const result = stream.result.then(async (initial) => {
+                let transformed = initial;
+                for (const item of [...middleware].reverse())
+                    transformed = await item.afterRun?.(transformed) ?? transformed;
+                await this.saveSession(prepared, transformed);
+                return transformed;
+            }).catch(async (error) => {
+                for (const item of [...middleware].reverse())
+                    await item.onError?.(error);
+                throw error;
+            });
+            return { events: stream.events, result };
+        }
+        catch (error) {
+            for (const item of [...middleware].reverse())
+                await item.onError?.(error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=agent-v.js.map

package/dist/core/agent-v.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,31 @@
+import type { EngineKind, JsonObject } from "./types.js";
+export interface EngineProfile {
+    id: string;
+    name: string;
+    kind: EngineKind;
+    engineId: string;
+    model?: string;
+    runtimeId?: string;
+    credentialRef?: string;
+    options?: JsonObject;
+}
+export interface AgentVConfig {
+    version: 1;
+    profiles: readonly EngineProfile[];
+    defaults: Partial<Record<EngineKind, string>>;
+    execution: {
+        maxSteps: number;
+    };
+}
+export interface ConfigStore {
+    load(): Promise<AgentVConfig>;
+    save(config: AgentVConfig): Promise<void>;
+}
+export declare function defaultConfig(): AgentVConfig;
+export declare class MemoryConfigStore implements ConfigStore {
+    private config;
+    constructor(initial?: AgentVConfig);
+    load(): Promise<AgentVConfig>;
+    save(config: AgentVConfig): Promise<void>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,wBAAgB,aAAa,IAAI,YAAY,CAO5C;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,GAAE,YAA8B;IAI7C,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAI7B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD"}

package/dist/core/config.js

@@ -0,0 +1,21 @@
+export function defaultConfig() {
+    return {
+        version: 1,
+        profiles: [],
+        defaults: {},
+        execution: { maxSteps: 20 },
+    };
+}
+export class MemoryConfigStore {
+    config;
+    constructor(initial = defaultConfig()) {
+        this.config = structuredClone(initial);
+    }
+    async load() {
+        return structuredClone(this.config);
+    }
+    async save(config) {
+        this.config = structuredClone(config);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAe;IAE7B,YAAY,UAAwB,aAAa,EAAE;QACjD,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAoB;QAC7B,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;CACF"}