@dahura/super-agent-runtime 0.1.1

package/dist/builder.js

@@ -0,0 +1,477 @@
+import { DEFAULT_AUDIO_FORMATS, DEFAULT_IMAGE_FORMATS } from "@dahura/super-agent-kit";
+import { Ask } from "./ask";
+import { AgentValidationError } from "./errors";
+import { normalizeAudio, normalizeFile, normalizeImage, normalizeText, stripPathArtifacts, } from "./loaders";
+/**
+ * Optional dispatcher for "run" output. Adapts whatever the agent's `run`
+ * returns into the `AskProduction` shape consumed by `Ask`. The default
+ * dispatcher handles strings, async-iterables, ReadableStreams, and arbitrary
+ * JSON-serializable values.
+ */
+function adaptRunOutput(value) {
+    if (typeof value === "string")
+        return { text: value };
+    if (value && typeof value === "object" && Symbol.asyncIterator in value) {
+        return { stream: textChunks(value) };
+    }
+    if (value instanceof ReadableStream) {
+        return { stream: bytesStreamToTextIter(value) };
+    }
+    // arbitrary value -> JSON
+    return { text: JSON.stringify(value) };
+}
+async function* textChunks(source) {
+    for await (const chunk of source) {
+        if (typeof chunk === "string") {
+            yield chunk;
+        }
+        else if (chunk instanceof Uint8Array) {
+            yield new TextDecoder().decode(chunk);
+        }
+        else {
+            yield typeof chunk === "object" ? JSON.stringify(chunk) : String(chunk);
+        }
+    }
+}
+async function* bytesStreamToTextIter(stream) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            if (value)
+                yield decoder.decode(value, { stream: true });
+        }
+        const tail = decoder.decode();
+        if (tail)
+            yield tail;
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+const noopLogger = {
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * The agent client surface that consumer code holds:
+ *   client.loadAudio(...).loadImage(...).ask(query).text()
+ *   client.withModel('local/qwen2.5-vl').ask(query).text()
+ *   client.ask(query).json(schema)
+ *
+ * Designed to be immutable: every loadXxx / withModel returns a NEW instance.
+ */
+export class AgentClient {
+    definition;
+    opts;
+    accumulated;
+    constructor(definition, opts, accumulated = emptyInputs()) {
+        this.definition = definition;
+        this.opts = opts;
+        this.accumulated = accumulated;
+    }
+    // --- loaders (accept single OR array; manifest decides max) ---
+    loadImage(input) {
+        if (!this.definition.inputs.image) {
+            throw new AgentValidationError(`Agent "${this.definition.meta.exportName}" does not accept image inputs`);
+        }
+        return this.cloneWithLoader("image", input);
+    }
+    loadAudio(input) {
+        if (!this.definition.inputs.audio) {
+            throw new AgentValidationError(`Agent "${this.definition.meta.exportName}" does not accept audio inputs`);
+        }
+        return this.cloneWithLoader("audio", input);
+    }
+    loadText(input) {
+        if (!this.definition.inputs.text) {
+            throw new AgentValidationError(`Agent "${this.definition.meta.exportName}" does not accept text inputs`);
+        }
+        return this.cloneWithLoader("text", input);
+    }
+    loadFile(input) {
+        if (!this.definition.inputs.file) {
+            throw new AgentValidationError(`Agent "${this.definition.meta.exportName}" does not accept file inputs`);
+        }
+        return this.cloneWithLoader("file", input);
+    }
+    /**
+     * Override the model for this and downstream calls without mutating the
+     * agent definition. Useful for the Playground UI selector and for
+     * per-call overrides like `agent.withModel('local/qwen2.5-vl').ask(q)`.
+     */
+    withModel(modelId) {
+        return new AgentClient(this.definition, { ...this.opts, modelOverride: modelId }, this.accumulated);
+    }
+    /**
+     * Override which processors are active for this and downstream calls without
+     * mutating the underlying client.
+     */
+    withProcessors(selection) {
+        validateProcessorSelection(this.definition, selection);
+        return new AgentClient(this.definition, { ...this.opts, processorSelection: normalizeProcessorSelection(selection) }, this.accumulated);
+    }
+    /**
+     * Override which subagents are active for this and downstream calls without
+     * mutating the underlying client.
+     */
+    withSubagents(selection) {
+        validateSubagentSelection(this.definition, selection);
+        return new AgentClient(this.definition, { ...this.opts, subagentSelection: normalizeSubagentSelection(selection) }, this.accumulated);
+    }
+    /** Fire the ask and return the smart Ask result. */
+    ask(query) {
+        if (typeof query !== "string" || query.length === 0) {
+            throw new AgentValidationError("ask(query) requires a non-empty string");
+        }
+        return new Ask(async () => {
+            const inputs = await materializeInputs(this.accumulated, this.definition.inputs);
+            const log = this.opts.logger ?? noopLogger;
+            log.info("env_resolved", { exportName: this.definition.meta.exportName });
+            const model = await this.opts.resolver({
+                exportName: this.definition.meta.exportName,
+                policy: this.definition.model,
+                override: this.opts.modelOverride,
+            });
+            log.info("model_selected", {
+                provider: model.provider,
+                resolvedId: model.resolvedId,
+            });
+            const ctx = {
+                inputs,
+                query,
+                model,
+                signal: new AbortController().signal,
+                log,
+                processors: resolveProcessorRuntime(this.definition, this.opts.processorSelection, log),
+                subagents: resolveSubagentRuntime(this.definition, this.opts.subagentSelection, log),
+                require: createRequireRuntime(model, this.definition.meta.exportName),
+            };
+            log.info("processors_resolved", {
+                enabled: ctx.processors.enabled,
+            });
+            log.info("subagents_resolved", {
+                enabled: ctx.subagents.enabled,
+            });
+            log.info("inference_started", {});
+            const startedAt = performance.now();
+            const value = await this.definition.run(ctx);
+            const production = adaptRunOutput(value);
+            log.info("output_validated", {
+                durationMs: Math.round(performance.now() - startedAt),
+            });
+            return {
+                ...production,
+                meta: {
+                    ...(production.meta ?? {}),
+                    durationMs: Math.round(performance.now() - startedAt),
+                    trace: ctx.subagents.trace(),
+                },
+            };
+        });
+    }
+    // --- internal ---
+    cloneWithLoader(kind, input) {
+        const next = {
+            image: [...this.accumulated.image],
+            audio: [...this.accumulated.audio],
+            text: [...this.accumulated.text],
+            file: [...this.accumulated.file],
+        };
+        const items = Array.isArray(input) ? input : [input];
+        next[kind].push(...items);
+        return new AgentClient(this.definition, this.opts, next);
+    }
+}
+function normalizeProcessorSelection(selection) {
+    return {
+        mode: selection.mode,
+        enable: selection.enable ? [...selection.enable] : undefined,
+        disable: selection.disable ? [...selection.disable] : undefined,
+    };
+}
+function normalizeSubagentSelection(selection) {
+    return {
+        mode: selection.mode,
+        enable: selection.enable ? [...selection.enable] : undefined,
+        disable: selection.disable ? [...selection.disable] : undefined,
+    };
+}
+function validateProcessorSelection(definition, selection) {
+    const knownIds = new Set((definition.processors ?? []).map((processor) => processor.id));
+    for (const id of selection.enable ?? []) {
+        if (!knownIds.has(id)) {
+            throw new AgentValidationError(`Unknown processor "${id}" for agent "${definition.meta.exportName}"`);
+        }
+    }
+    for (const id of selection.disable ?? []) {
+        if (!knownIds.has(id)) {
+            throw new AgentValidationError(`Unknown processor "${id}" for agent "${definition.meta.exportName}"`);
+        }
+    }
+}
+function validateSubagentSelection(definition, selection) {
+    const knownIds = new Set((definition.subagents ?? []).map((subagent) => subagent.id));
+    for (const id of selection.enable ?? []) {
+        if (!knownIds.has(id)) {
+            throw new AgentValidationError(`Unknown subagent "${id}" for agent "${definition.meta.exportName}"`);
+        }
+    }
+    for (const id of selection.disable ?? []) {
+        if (!knownIds.has(id)) {
+            throw new AgentValidationError(`Unknown subagent "${id}" for agent "${definition.meta.exportName}"`);
+        }
+    }
+}
+function resolveProcessorRuntime(definition, selection, log = noopLogger) {
+    const processors = definition.processors ?? [];
+    const enabled = new Set();
+    if (selection?.mode === "all") {
+        for (const processor of processors)
+            enabled.add(processor.id);
+    }
+    else if (selection?.mode === "none") {
+        // leave empty
+    }
+    else {
+        for (const processor of processors) {
+            if (processor.defaultEnabled !== false) {
+                enabled.add(processor.id);
+            }
+        }
+    }
+    for (const id of selection?.enable ?? [])
+        enabled.add(id);
+    for (const id of selection?.disable ?? [])
+        enabled.delete(id);
+    const ordered = processors
+        .map((processor) => processor.id)
+        .filter((id) => enabled.has(id));
+    const definitionsById = new Map(processors.map((processor) => [processor.id, processor]));
+    return {
+        enabled: ordered,
+        isEnabled: (id) => enabled.has(id),
+        before: (initial, steps) => runProcessorPhase({
+            initial,
+            steps,
+            phase: "before",
+            enabled,
+            definitionsById,
+            log,
+        }),
+        after: (initial, steps) => runProcessorPhase({
+            initial,
+            steps,
+            phase: "after",
+            enabled,
+            definitionsById,
+            log,
+        }),
+    };
+}
+function resolveSubagentRuntime(definition, selection, log = noopLogger) {
+    const subagents = definition.subagents ?? [];
+    const enabled = new Set();
+    if (selection?.mode === "all") {
+        for (const subagent of subagents)
+            enabled.add(subagent.id);
+    }
+    else if (selection?.mode === "none") {
+        // leave empty
+    }
+    else {
+        for (const subagent of subagents) {
+            if (subagent.defaultEnabled !== false) {
+                enabled.add(subagent.id);
+            }
+        }
+    }
+    for (const id of selection?.enable ?? [])
+        enabled.add(id);
+    for (const id of selection?.disable ?? [])
+        enabled.delete(id);
+    const ordered = subagents
+        .map((subagent) => subagent.id)
+        .filter((id) => enabled.has(id));
+    const definitionsById = new Map(subagents.map((subagent) => [subagent.id, subagent]));
+    const trace = [];
+    return {
+        enabled: ordered,
+        isEnabled: (id) => enabled.has(id),
+        run: async (initial, steps, options) => {
+            const execute = async (step) => {
+                const definition = definitionsById.get(step.id);
+                if (!definition) {
+                    throw new AgentValidationError(`Unknown subagent step "${step.id}"`);
+                }
+                const startedAt = performance.now();
+                try {
+                    const result = await step.run(initial);
+                    const durationMs = Math.round(performance.now() - startedAt);
+                    trace.push({
+                        kind: "subagent",
+                        id: step.id,
+                        label: definition.description,
+                        durationMs,
+                        modelUsed: result.modelUsed,
+                        usage: result.usage,
+                        output: result.output,
+                        rawText: result.rawText,
+                    });
+                    log.info("subagent_completed", { id: step.id, durationMs });
+                    return { id: step.id, durationMs, ...result };
+                }
+                catch (error) {
+                    const durationMs = Math.round(performance.now() - startedAt);
+                    trace.push({
+                        kind: "subagent",
+                        id: step.id,
+                        label: definition.description,
+                        durationMs,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    log.error("subagent_failed", {
+                        id: step.id,
+                        durationMs,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                }
+            };
+            const activeSteps = steps.filter((step) => {
+                if (!definitionsById.has(step.id)) {
+                    throw new AgentValidationError(`Unknown subagent step "${step.id}"`);
+                }
+                return enabled.has(step.id);
+            });
+            if (options?.parallel) {
+                return Promise.all(activeSteps.map((step) => execute(step)));
+            }
+            const results = [];
+            for (const step of activeSteps) {
+                results.push(await execute(step));
+            }
+            return results;
+        },
+        recordTrace: (entry) => {
+            trace.push(entry);
+        },
+        trace: () => [...trace],
+    };
+}
+function runProcessorPhase(args) {
+    let state = args.initial;
+    for (const step of args.steps) {
+        const definition = args.definitionsById.get(step.id);
+        if (!definition) {
+            throw new AgentValidationError(`Unknown processor step "${step.id}"`);
+        }
+        if (definition.phase !== args.phase) {
+            throw new AgentValidationError(`Processor "${step.id}" is declared for phase "${definition.phase}" but was used in "${args.phase}"`);
+        }
+        if (!args.enabled.has(step.id))
+            continue;
+        state = step.run(state);
+        args.log.info("processor_applied", { id: step.id, phase: args.phase });
+    }
+    return state;
+}
+function createRequireRuntime(model, exportName) {
+    return {
+        aiSdkModel() {
+            if (model.kind !== "ai-sdk") {
+                throw new AgentValidationError(`${exportName} requires an AI-SDK compatible model`);
+            }
+            return model;
+        },
+        customModel() {
+            if (model.kind !== "custom") {
+                throw new AgentValidationError(`${exportName} requires a custom provider model`);
+            }
+            return {
+                kind: model.kind,
+                provider: model.provider,
+                invoke: async (input) => model.invoke(input),
+            };
+        },
+        customProvider(provider) {
+            if (model.kind !== "custom" || model.provider !== provider) {
+                throw new AgentValidationError(`${exportName} requires the custom provider "${provider}"`);
+            }
+            return {
+                kind: model.kind,
+                provider: model.provider,
+                invoke: async (input) => model.invoke(input),
+            };
+        },
+    };
+}
+function emptyInputs() {
+    return { image: [], audio: [], text: [], file: [] };
+}
+/**
+ * Validate accumulated inputs against the inputs schema (max, formats),
+ * then normalize each item into an InputItem. Returns the strongly-typed
+ * RuntimeInputs object passed into agent.run().
+ */
+async function materializeInputs(acc, schema) {
+    const image = [];
+    if (acc.image.length > 0) {
+        const decl = schema.image;
+        const max = decl.max ?? 1;
+        if (acc.image.length > max) {
+            throw new AgentValidationError(`Too many image inputs: ${acc.image.length} > max ${max}`);
+        }
+        const allowed = (decl.formats ?? DEFAULT_IMAGE_FORMATS);
+        for (const item of acc.image) {
+            const normalized = await normalizeImage(item);
+            const ext = stripPathArtifacts(normalized.source)
+                .toLowerCase()
+                .match(/\.([a-z0-9]+)$/)?.[1];
+            if (ext && !allowed.includes(ext) && !(ext === "jpg" && allowed.includes("jpeg"))) {
+                throw new AgentValidationError(`Image format "${ext}" not allowed (allowed: ${allowed.join(", ")})`);
+            }
+            image.push(normalized);
+        }
+    }
+    const audio = [];
+    if (acc.audio.length > 0) {
+        const decl = schema.audio;
+        const max = decl.max ?? 1;
+        if (acc.audio.length > max) {
+            throw new AgentValidationError(`Too many audio inputs: ${acc.audio.length} > max ${max}`);
+        }
+        const allowed = (decl.formats ?? DEFAULT_AUDIO_FORMATS);
+        for (const item of acc.audio) {
+            const normalized = await normalizeAudio(item);
+            const ext = stripPathArtifacts(normalized.source)
+                .toLowerCase()
+                .match(/\.([a-z0-9]+)$/)?.[1];
+            if (ext && !allowed.includes(ext)) {
+                throw new AgentValidationError(`Audio format "${ext}" not allowed (allowed: ${allowed.join(", ")})`);
+            }
+            audio.push(normalized);
+        }
+    }
+    const text = [];
+    if (acc.text.length > 0) {
+        for (const item of acc.text)
+            text.push(normalizeText(item));
+    }
+    const file = [];
+    if (acc.file.length > 0) {
+        const decl = schema.file;
+        const max = decl.max ?? 1;
+        if (acc.file.length > max) {
+            throw new AgentValidationError(`Too many file inputs: ${acc.file.length} > max ${max}`);
+        }
+        for (const item of acc.file)
+            file.push(await normalizeFile(item));
+    }
+    return { image, audio, text, file };
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Convention-driven environment reader. Encapsulates the local-first
+ * priority order documented in the design doc:
+ *
+ *   1. Per-agent override:  SUPERAGENT_<EXPORT_NAME_SCREAMING_SNAKE>_<KEY>
+ *   2. Global default:      SUPERAGENT_<KEY>
+ *   3. Provider-specific:   OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.
+ */
+export type EnvSource = (key: string) => string | undefined;
+/**
+ * Convert "screenshotAnalyzerAgent" → "SCREENSHOT_ANALYZER_AGENT". The
+ * resolver uses this to build per-agent env keys.
+ */
+export declare function exportNameToScreaming(exportName: string): string;
+/**
+ * Look up a value following the per-agent → global priority order.
+ * Returns the first defined non-empty string, or undefined.
+ */
+export declare function readScopedEnv(exportName: string, key: string, source?: EnvSource): string | undefined;
+/**
+ * Read a model alias mapping. Aliases let agents use stable names like
+ * `local/qwen3.5-2b` while the consumer's `.env` maps them to whatever
+ * concrete name their local server reports (e.g. `Qwen3.5-2B-Q4_K_M`).
+ *
+ *   SUPERAGENT_MODEL_ALIAS_LOCAL_QWEN3_5_2B=Qwen3.5-2B-Q4_K_M
+ *
+ * The key is the model id with `/` and `.` replaced by `_` and uppercased.
+ */
+export declare function readModelAlias(modelId: string, source?: EnvSource): string | undefined;
+/** Mask a sensitive value for safe display (`sk-abc…3f4a`). */
+export declare function maskSecret(value: string | undefined): string;
+/**
+ * Re-export for tests so they can substitute a fake env.
+ */
+export declare const __defaultEnvSource: EnvSource;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAI5D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,SAAyB,GAChC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,SAAyB,GAChC,MAAM,GAAG,SAAS,CAIpB;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,WAAgB,CAAC"}

package/dist/env.js

@@ -0,0 +1,63 @@
+/**
+ * Convention-driven environment reader. Encapsulates the local-first
+ * priority order documented in the design doc:
+ *
+ *   1. Per-agent override:  SUPERAGENT_<EXPORT_NAME_SCREAMING_SNAKE>_<KEY>
+ *   2. Global default:      SUPERAGENT_<KEY>
+ *   3. Provider-specific:   OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.
+ */
+const SUPERAGENT_PREFIX = "SUPERAGENT_";
+const defaultSource = (key) => process.env[key];
+/**
+ * Convert "screenshotAnalyzerAgent" → "SCREENSHOT_ANALYZER_AGENT". The
+ * resolver uses this to build per-agent env keys.
+ */
+export function exportNameToScreaming(exportName) {
+    return exportName
+        .replace(/([A-Z])/g, "_$1")
+        .replace(/^_/, "")
+        .toUpperCase();
+}
+/**
+ * Look up a value following the per-agent → global priority order.
+ * Returns the first defined non-empty string, or undefined.
+ */
+export function readScopedEnv(exportName, key, source = defaultSource) {
+    const screamingExport = exportNameToScreaming(exportName);
+    const perAgentKey = `${SUPERAGENT_PREFIX}${screamingExport}_${key}`;
+    const globalKey = `${SUPERAGENT_PREFIX}${key}`;
+    const perAgent = source(perAgentKey);
+    if (perAgent && perAgent.trim().length > 0)
+        return perAgent.trim();
+    const global = source(globalKey);
+    if (global && global.trim().length > 0)
+        return global.trim();
+    return undefined;
+}
+/**
+ * Read a model alias mapping. Aliases let agents use stable names like
+ * `local/qwen3.5-2b` while the consumer's `.env` maps them to whatever
+ * concrete name their local server reports (e.g. `Qwen3.5-2B-Q4_K_M`).
+ *
+ *   SUPERAGENT_MODEL_ALIAS_LOCAL_QWEN3_5_2B=Qwen3.5-2B-Q4_K_M
+ *
+ * The key is the model id with `/` and `.` replaced by `_` and uppercased.
+ */
+export function readModelAlias(modelId, source = defaultSource) {
+    const sanitized = modelId.replace(/[/.\-]/g, "_").toUpperCase();
+    const value = source(`${SUPERAGENT_PREFIX}MODEL_ALIAS_${sanitized}`);
+    return value && value.trim().length > 0 ? value.trim() : undefined;
+}
+/** Mask a sensitive value for safe display (`sk-abc…3f4a`). */
+export function maskSecret(value) {
+    if (!value)
+        return "";
+    if (value.length <= 8)
+        return "●●●●";
+    return `${value.slice(0, 3)}…${value.slice(-4)}`;
+}
+/**
+ * Re-export for tests so they can substitute a fake env.
+ */
+export const __defaultEnvSource = defaultSource;
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAIxC,MAAM,aAAa,GAAc,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,UAAU;SACd,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,GAAW,EACX,SAAoB,aAAa;IAEjC,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,GAAG,iBAAiB,GAAG,eAAe,IAAI,GAAG,EAAE,CAAC;IACpE,MAAM,SAAS,GAAG,GAAG,iBAAiB,GAAG,GAAG,EAAE,CAAC;IAE/C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,SAAoB,aAAa;IAEjC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,iBAAiB,eAAe,SAAS,EAAE,CAAC,CAAC;IACrE,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACrC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Typed errors thrown at the runtime boundary. Consumers can `instanceof`
+ * them to render targeted UI / take corrective action.
+ */
+export declare class AgentError extends Error {
+    name: string;
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Input failed schema validation BEFORE the agent's `run` is invoked.
+ * Indicates the consumer passed an unsupported file type, exceeded the
+ * declared `max`, etc.
+ */
+export declare class AgentValidationError extends AgentError {
+    name: string;
+}
+/**
+ * The model resolver could not find a usable model. Usually one of:
+ *   - `model.allow` blocks the requested override
+ *   - all configured providers are unreachable
+ *   - required env vars (e.g. `WHISPER_CPP_BIN`) are missing
+ */
+export declare class ProviderError extends AgentError {
+    name: string;
+}
+/**
+ * The model returned a response, but it failed output validation against
+ * the agent's declared `output.schema`.
+ */
+export declare class OutputValidationError extends AgentError {
+    name: string;
+}
+/**
+ * Catch-all for failures inside the model call (HTTP error, timeout, etc).
+ */
+export declare class ModelError extends AgentError {
+    name: string;
+}
+//# 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;;;GAGG;AAEH,qBAAa,UAAW,SAAQ,KAAK;IAC1B,IAAI,SAAgB;IAC7B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IACzC,IAAI,SAA0B;CACxC;AAED;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAClC,IAAI,SAAmB;CACjC;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;IAC1C,IAAI,SAA2B;CACzC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;IAC/B,IAAI,SAAgB;CAC9B"}