@dahura/super-agent-runtime 0.1.1

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,YAAY,EAC5D,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAC3B,IAAI,EAAE,kBAAkB,GACvB,WAAW,CAAC,OAAO,CAAC,CAEtB"}

package/dist/proxy.js

@@ -0,0 +1,12 @@
+import { AgentClient } from "./builder";
+/**
+ * Materialize an agent module into a runnable client. This is what consumers
+ * (Playground, codegen wrappers) use as the actual `transcriptAgent` etc.
+ *
+ * The agent module itself stays a passive descriptor — runtime decisions
+ * (model resolution, logging, caching) all live in this layer.
+ */
+export function createAgentClient(agent, opts) {
+    return new AgentClient(agent.definition, opts);
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA2B,MAAM,WAAW,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA2B,EAC3B,IAAwB;IAExB,OAAO,IAAI,WAAW,CAAU,KAAK,CAAC,UAAsC,EAAE,IAAI,CAAC,CAAC;AACtF,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Provider Registry — central registration and discovery for providers.
+ *
+ * The registry allows:
+ * - Registering provider definitions (from defineProvider)
+ * - Discovering available models from filesystem paths
+ * - Probing all providers for availability
+ * - Resolving providers for model IDs
+ */
+import type { ProviderModule, ProviderConfig, ProviderProbeResult, ProviderEnvSchema } from "@dahura/super-agent-kit";
+import type { EnvSource } from "./env";
+/**
+ * Discovered model from filesystem scanning.
+ */
+export type DiscoveredModel = {
+    /** Human-readable model ID extracted by provider's extractModelId. */
+    id: string;
+    /** Full absolute path to the model file. */
+    path: string;
+    /** File size in bytes. */
+    sizeBytes: number;
+    /** Provider that discovered this model. */
+    providerId: string;
+};
+/**
+ * Result of probing a provider, including discovered models.
+ */
+export type ProviderProbeEntry = {
+    provider: ProviderModule;
+    config: ProviderConfig;
+    probe: ProviderProbeResult;
+    discoveredModels?: DiscoveredModel[];
+};
+/**
+ * Options for building provider configuration.
+ */
+export type BuildConfigOptions = {
+    /** Agent export name for per-agent env lookups. */
+    exportName?: string;
+    /** Environment source function. */
+    env?: EnvSource;
+};
+/**
+ * Build configuration object from environment variables.
+ */
+export declare function buildProviderConfig(envSchema: ProviderEnvSchema, providerId: string, options?: BuildConfigOptions): ProviderConfig;
+/**
+ * Check if a provider is configured (all required env vars are set).
+ */
+export declare function isProviderConfigured(envSchema: ProviderEnvSchema, config: ProviderConfig): {
+    ok: boolean;
+    missing: string[];
+};
+/**
+ * Provider Registry — manages provider registration and discovery.
+ */
+export declare class ProviderRegistry {
+    private providers;
+    /**
+     * Register a provider module.
+     */
+    register(provider: ProviderModule): void;
+    /**
+     * Get a provider by ID.
+     */
+    get(id: string): ProviderModule | undefined;
+    /**
+     * List all registered providers.
+     */
+    list(): ProviderModule[];
+    /**
+     * List provider IDs.
+     */
+    ids(): string[];
+    /**
+     * Discover models for a specific provider.
+     */
+    discoverModels(providerId: string): Promise<DiscoveredModel[]>;
+    /**
+     * Discover models for all providers that support model discovery.
+     */
+    discoverAllModels(): Promise<Map<string, DiscoveredModel[]>>;
+    /**
+     * Probe a single provider for availability.
+     */
+    probe(providerId: string, options?: BuildConfigOptions): Promise<ProviderProbeEntry | null>;
+    /**
+     * Probe all registered providers.
+     */
+    probeAll(options?: BuildConfigOptions): Promise<ProviderProbeEntry[]>;
+    /**
+     * Find providers that support a specific capability.
+     */
+    findByCapability(capability: string): ProviderModule[];
+    /**
+     * Resolve which provider should handle a model ID.
+     * Returns the provider ID or undefined if no match.
+     *
+     * Resolution order:
+     * 1. Explicit SUPERAGENT_<EXPORT>_PROVIDER env var
+     * 2. Model ID prefix match (e.g., "local/" → openai-compatible or llama-server)
+     * 3. Capability-based fallback
+     */
+    resolveProviderForModel(modelId: string, options?: BuildConfigOptions): string | undefined;
+}
+/**
+ * Default global registry instance.
+ * Providers are registered here at module load time.
+ */
+export declare const defaultRegistry: ProviderRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB,CAAC;AA2EF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,iBAAiB,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAgChB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,cAAc,GACrB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAapC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAqC;IAEtD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAQxC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C;;OAEG;IACH,IAAI,IAAI,cAAc,EAAE;IAIxB;;OAEG;IACH,GAAG,IAAI,MAAM,EAAE;IAIf;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0CpE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAelE;;OAEG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAqErC;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAa/E;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAMtD;;;;;;;;OAQG;IACH,uBAAuB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,GAAG,SAAS;CA+BtB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,kBAAyB,CAAC"}

package/dist/registry.js

@@ -0,0 +1,328 @@
+/**
+ * Provider Registry — central registration and discovery for providers.
+ *
+ * The registry allows:
+ * - Registering provider definitions (from defineProvider)
+ * - Discovering available models from filesystem paths
+ * - Probing all providers for availability
+ * - Resolving providers for model IDs
+ */
+import { readdir, access, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { readScopedEnv } from "./env";
+/**
+ * Expand ~ to home directory.
+ */
+function expandPath(p) {
+    if (p.startsWith("~/")) {
+        return join(homedir(), p.slice(2));
+    }
+    if (p.startsWith("~")) {
+        return join(homedir(), p.slice(1));
+    }
+    return p;
+}
+/**
+ * Check if a path exists.
+ */
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Recursively scan a directory for files matching a pattern.
+ * Simplified glob: supports ** for recursive and * for wildcard.
+ */
+async function scanDirectory(dir, pattern) {
+    const results = [];
+    const expandedDir = expandPath(dir);
+    if (!(await pathExists(expandedDir))) {
+        return results;
+    }
+    const patternParts = pattern.split("/");
+    const isRecursive = patternParts.includes("**");
+    const filePattern = patternParts[patternParts.length - 1];
+    const fileRegex = new RegExp("^" + filePattern.replace(/\./g, "\\.").replace(/\*/g, ".*") + "$");
+    async function scan(currentDir, depth) {
+        try {
+            const entries = await readdir(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    if (isRecursive || depth < patternParts.length - 1) {
+                        await scan(fullPath, depth + 1);
+                    }
+                }
+                else if (entry.isFile()) {
+                    if (fileRegex.test(entry.name)) {
+                        results.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory not readable, skip
+        }
+    }
+    await scan(expandedDir, 0);
+    return results;
+}
+/**
+ * Build configuration object from environment variables.
+ */
+export function buildProviderConfig(envSchema, providerId, options = {}) {
+    const { exportName, env = (k) => process.env[k] } = options;
+    const config = {};
+    for (const [key, spec] of Object.entries(envSchema)) {
+        let value;
+        // Try per-agent override if exportName provided
+        if (exportName) {
+            value = readScopedEnv(exportName, spec.env, env);
+        }
+        // Try provider-specific
+        if (!value) {
+            const providerKey = `SUPERAGENT_${providerId.replace(/-/g, "_").toUpperCase()}_${spec.env}`;
+            value = env(providerKey);
+        }
+        // Try global SUPERAGENT_ prefix
+        if (!value) {
+            value = env(`SUPERAGENT_${spec.env}`);
+        }
+        // Use default
+        if (!value && spec.default !== undefined) {
+            value = spec.default;
+        }
+        config[key] = value;
+    }
+    return config;
+}
+/**
+ * Check if a provider is configured (all required env vars are set).
+ */
+export function isProviderConfigured(envSchema, config) {
+    const missing = [];
+    for (const [key, spec] of Object.entries(envSchema)) {
+        if (spec.required && !config[key]) {
+            missing.push(spec.env);
+        }
+    }
+    return {
+        ok: missing.length === 0,
+        missing,
+    };
+}
+/**
+ * Provider Registry — manages provider registration and discovery.
+ */
+export class ProviderRegistry {
+    providers = new Map();
+    /**
+     * Register a provider module.
+     */
+    register(provider) {
+        const id = provider.definition.meta.id;
+        if (this.providers.has(id)) {
+            throw new Error(`Provider "${id}" is already registered`);
+        }
+        this.providers.set(id, provider);
+    }
+    /**
+     * Get a provider by ID.
+     */
+    get(id) {
+        return this.providers.get(id);
+    }
+    /**
+     * List all registered providers.
+     */
+    list() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * List provider IDs.
+     */
+    ids() {
+        return Array.from(this.providers.keys());
+    }
+    /**
+     * Discover models for a specific provider.
+     */
+    async discoverModels(providerId) {
+        const provider = this.providers.get(providerId);
+        if (!provider) {
+            return [];
+        }
+        const discovery = provider.definition.modelDiscovery;
+        if (!discovery) {
+            return [];
+        }
+        const models = [];
+        for (const basePath of discovery.paths) {
+            const files = await scanDirectory(basePath, discovery.pattern);
+            for (const filePath of files) {
+                if (discovery.filter && !discovery.filter(filePath)) {
+                    continue;
+                }
+                try {
+                    const stats = await stat(filePath);
+                    const modelId = discovery.extractModelId(filePath);
+                    models.push({
+                        id: modelId,
+                        path: filePath,
+                        sizeBytes: stats.size,
+                        providerId,
+                    });
+                }
+                catch {
+                    // Skip files we can't stat
+                }
+            }
+        }
+        // Sort by model ID
+        models.sort((a, b) => a.id.localeCompare(b.id));
+        return models;
+    }
+    /**
+     * Discover models for all providers that support model discovery.
+     */
+    async discoverAllModels() {
+        const results = new Map();
+        for (const [id, provider] of this.providers) {
+            if (provider.definition.modelDiscovery) {
+                const models = await this.discoverModels(id);
+                if (models.length > 0) {
+                    results.set(id, models);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Probe a single provider for availability.
+     */
+    async probe(providerId, options = {}) {
+        const provider = this.providers.get(providerId);
+        if (!provider) {
+            return null;
+        }
+        const config = buildProviderConfig(provider.definition.env, providerId, options);
+        const { ok, missing } = isProviderConfigured(provider.definition.env, config);
+        // If provider has no probe function, just check if configured
+        if (!provider.definition.probe) {
+            return {
+                provider,
+                config,
+                probe: {
+                    ok,
+                    error: ok ? undefined : `Missing required env vars: ${missing.join(", ")}`,
+                },
+            };
+        }
+        // If not configured, don't try to probe
+        if (!ok) {
+            return {
+                provider,
+                config,
+                probe: {
+                    ok: false,
+                    error: `Missing required env vars: ${missing.join(", ")}`,
+                },
+            };
+        }
+        // Run the probe
+        try {
+            const probeResult = await provider.definition.probe(config);
+            // Include discovered models if available
+            let discoveredModels;
+            if (probeResult.ok && provider.definition.modelDiscovery) {
+                discoveredModels = await this.discoverModels(providerId);
+            }
+            return {
+                provider,
+                config,
+                probe: probeResult,
+                discoveredModels,
+            };
+        }
+        catch (error) {
+            return {
+                provider,
+                config,
+                probe: {
+                    ok: false,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
+    }
+    /**
+     * Probe all registered providers.
+     */
+    async probeAll(options = {}) {
+        const results = [];
+        for (const id of this.providers.keys()) {
+            const entry = await this.probe(id, options);
+            if (entry) {
+                results.push(entry);
+            }
+        }
+        return results;
+    }
+    /**
+     * Find providers that support a specific capability.
+     */
+    findByCapability(capability) {
+        return this.list().filter((p) => p.definition.meta.capabilities.includes(capability));
+    }
+    /**
+     * Resolve which provider should handle a model ID.
+     * Returns the provider ID or undefined if no match.
+     *
+     * Resolution order:
+     * 1. Explicit SUPERAGENT_<EXPORT>_PROVIDER env var
+     * 2. Model ID prefix match (e.g., "local/" → openai-compatible or llama-server)
+     * 3. Capability-based fallback
+     */
+    resolveProviderForModel(modelId, options = {}) {
+        const { exportName, env = (k) => process.env[k] } = options;
+        // Check explicit provider override
+        if (exportName) {
+            const providerHint = readScopedEnv(exportName, "PROVIDER", env);
+            if (providerHint && this.providers.has(providerHint)) {
+                return providerHint;
+            }
+        }
+        // Check model ID prefix
+        const slashIndex = modelId.indexOf("/");
+        if (slashIndex > 0) {
+            const prefix = modelId.slice(0, slashIndex);
+            // Known prefixes
+            if (prefix === "openai")
+                return "openai";
+            if (prefix === "anthropic")
+                return "anthropic";
+            if (prefix === "local") {
+                // Check if llama-server is configured
+                if (exportName) {
+                    const bin = readScopedEnv(exportName, "BIN", env);
+                    if (bin)
+                        return "llama-server";
+                }
+                return "openai-compatible";
+            }
+        }
+        return undefined;
+    }
+}
+/**
+ * Default global registry instance.
+ * Providers are registered here at module load time.
+ */
+export const defaultRegistry = new ProviderRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/resolver.d.ts

@@ -0,0 +1,47 @@
+import type { ModelResolver } from "./builder";
+import { type EnvSource } from "./env";
+import { type ProviderRegistry } from "./registry";
+export type LocalBackend = "openai-compatible" | "llama-server" | "audio-local";
+export type ResolverOptions = {
+    envSource?: EnvSource;
+    /** Optional custom registry. Defaults to the global defaultRegistry. */
+    registry?: ProviderRegistry;
+    /** Override which local backend to use for `local/*` models. */
+    localBackend?: LocalBackend;
+};
+export declare function __findMmprojForModel(modelId: string, modelPath?: string, searchPaths?: readonly string[]): Promise<string | null>;
+/**
+ * Build a `ModelResolver` ready to plug into `createAgentClient`. The same
+ * function powers both consumer code and the Playground.
+ *
+ * Local-first priority order applied each time the resolver runs:
+ *
+ *   1. Honor `override` if given (UI selector / test). Validate against
+ *      `policy.allow` regardless of where it came from.
+ *   2. Otherwise use `policy.default`.
+ *   3. Resolve aliases (e.g. local/qwen3.5-2b → Qwen3.5-2B-Q4_K_M).
+ *   4. Pick provider:
+ *        audio-local/* → audio-local custom provider
+ *        local/*       → openai-compatible (or audio-local/whisper by per-agent env)
+ *        openai/*      → openai (cloud, opt-in)
+ *        anthropic/*   → anthropic (cloud, opt-in)
+ *      Custom per-agent provider override via SUPERAGENT_<EXPORT>_PROVIDER
+ *      always wins (used by transcriptAgent → audio-local or whisper-cpp).
+ *   5. Build the provider config from env and return ResolvedModel.
+ */
+export declare function createResolver(options?: ResolverOptions): ModelResolver;
+export declare const RESOLVER_LOCAL_DEFAULTS: {
+    /** Ollama default endpoint when nothing else is configured. */
+    readonly ollama: "http://localhost:11434/v1";
+    /** llama.cpp's llama-server default endpoint. */
+    readonly llamaServer: "http://localhost:8080/v1";
+};
+/**
+ * Re-export the default registry for consumers who want to:
+ * - Register custom providers
+ * - Discover models from filesystem
+ * - Probe providers for availability (Playground)
+ */
+export { defaultRegistry } from "./registry";
+export type { ProviderRegistry, DiscoveredModel, ProviderProbeEntry } from "./registry";
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAgBtE,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,cAAc,GAAG,aAAa,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,gEAAgE;IAChE,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAiHF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,GAAE,SAAS,MAAM,EAAuC,GAClE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,aAAa,CA8C3E;AA0ND,eAAO,MAAM,uBAAuB;IAzalC,+DAA+D;;IAE/D,iDAAiD;;CAuaE,CAAC;AAEtD;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}