@dahura/super-agent-kit 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SuperAgent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/define.d.ts

@@ -0,0 +1,57 @@
+import type { InputsSchema } from "./inputs";
+import type { AgentDefinition, AgentModule, WorkflowCadence, WorkflowDefinition, WorkflowDuration, WorkflowHostSchema, WorkflowModule } from "./types";
+/**
+ * Validation errors thrown synchronously when `defineAgent` is given an
+ * inconsistent definition. These should never reach end users — they fail
+ * fast at module-load time so the compiler refuses to bundle a broken agent.
+ */
+export declare class AgentDefinitionError extends Error {
+    name: string;
+}
+export declare class WorkflowDefinitionError extends Error {
+    name: string;
+}
+/**
+ * Match a single model identifier against a glob pattern.
+ * Supported wildcards: `*` (provider segment or any chars in model id),
+ * `**` (multi-segment / any chars).
+ *
+ * Model ids are `provider/model`. Some local OpenAI-compatible servers expose
+ * namespaced model ids like `local/qwen/qwen3.5-9b`, so the model portion is
+ * treated as an opaque identifier rather than a path with slash-separated
+ * segments.
+ *
+ * Examples:
+ *   matchModelPattern('local/*',  'local/qwen3.5-2b') -> true
+ *   matchModelPattern('local/*',  'openai/gpt-5.4')   -> false
+ *   matchModelPattern('openai/*', 'openai/gpt-5.4')   -> true
+ */
+export declare function matchModelPattern(pattern: string, modelId: string): boolean;
+/**
+ * The author-facing factory. Authors call this in their agent module's
+ * default export. TypeScript binds the inputs schema generic so the `run`
+ * function receives correctly-typed `inputs`.
+ *
+ * The returned `AgentModule` is a thin wrapper — the actual executable
+ * client is materialized by `@dahura/super-agent-runtime` when consumers import it.
+ *
+ * @example
+ *   export default defineAgent({
+ *     meta: { id: 'transcript-agent', exportName: 'transcriptAgent', version: '1.0.0', description: '...' },
+ *     inputs: { audio: { max: 1, formats: ['wav', 'mp3'] } },
+ *     output: { default: 'text' },
+ *     model: { default: 'local/whisper-base', allow: ['local/*'] },
+ *     async run({ inputs, query, model }) { ... },
+ *   });
+ */
+export declare function defineAgent<TInputs extends InputsSchema, TOutput = unknown>(definition: AgentDefinition<TInputs, TOutput>): AgentModule<TInputs, TOutput>;
+export declare const workflow: {
+    duration: {
+        milliseconds(value: number): WorkflowDuration;
+        seconds(value: number): WorkflowDuration;
+        minutes(value: number): WorkflowDuration;
+    };
+    cadence(input: WorkflowCadence): WorkflowCadence;
+};
+export declare function defineWorkflow<TEvents extends WorkflowDefinition["events"], THost extends WorkflowHostSchema | undefined = WorkflowHostSchema | undefined, TState = unknown>(definition: WorkflowDefinition<TEvents, THost, TState>): WorkflowModule<TEvents, THost, TState>;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,SAA0B;CACxC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACvC,IAAI,SAA6B;CAC3C;AAyED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAiB3E;AAuMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,OAAO,SAAS,YAAY,EAC5B,OAAO,GAAG,OAAO,EAEjB,UAAU,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,GAC5C,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAa/B;AAED,eAAO,MAAM,QAAQ;;4BAEG,MAAM,GAAG,gBAAgB;uBAG9B,MAAM,GAAG,gBAAgB;uBAGzB,MAAM,GAAG,gBAAgB;;mBAI3B,eAAe,GAAG,eAAe;CAIjD,CAAC;AAEF,wBAAgB,cAAc,CAC5B,OAAO,SAAS,kBAAkB,CAAC,QAAQ,CAAC,EAC5C,KAAK,SAAS,kBAAkB,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,EAC7E,MAAM,GAAG,OAAO,EAEhB,UAAU,EAAE,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GACrD,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAaxC"}

package/dist/define.js

@@ -0,0 +1,303 @@
+/**
+ * Validation errors thrown synchronously when `defineAgent` is given an
+ * inconsistent definition. These should never reach end users — they fail
+ * fast at module-load time so the compiler refuses to bundle a broken agent.
+ */
+export class AgentDefinitionError extends Error {
+    name = "AgentDefinitionError";
+}
+export class WorkflowDefinitionError extends Error {
+    name = "WorkflowDefinitionError";
+}
+/**
+ * Validate the meta section of an agent definition. Performs runtime checks
+ * that complement TypeScript's compile-time guarantees (e.g. a JS-valid
+ * camelCase identifier for the export name).
+ */
+function validateMeta(meta) {
+    if (!meta || typeof meta !== "object") {
+        throw new AgentDefinitionError("meta is required");
+    }
+    if (!meta.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(meta.id)) {
+        throw new AgentDefinitionError(`meta.id must be kebab-case (got: ${JSON.stringify(meta.id)})`);
+    }
+    if (!meta.exportName || !/^[a-z][a-zA-Z0-9]*$/.test(meta.exportName)) {
+        throw new AgentDefinitionError(`meta.exportName must be a camelCase JS identifier (got: ${JSON.stringify(meta.exportName)})`);
+    }
+    if (!meta.version || !/^\d+\.\d+\.\d+/.test(meta.version)) {
+        throw new AgentDefinitionError(`meta.version must be semver (got: ${JSON.stringify(meta.version)})`);
+    }
+    if (!meta.description || meta.description.length === 0) {
+        throw new AgentDefinitionError("meta.description is required");
+    }
+}
+function validateWorkflowMeta(meta) {
+    try {
+        validateMeta(meta);
+    }
+    catch (error) {
+        throw new WorkflowDefinitionError(error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Validate that the model policy default is covered by the allow list.
+ *
+ * `allow` patterns use simple glob: `*` matches one path segment,
+ * `**` matches any chars. We compile to a RegExp here.
+ */
+function validateModelPolicy(model) {
+    if (!model || typeof model !== "object") {
+        throw new AgentDefinitionError("model policy is required");
+    }
+    if (!model.default) {
+        throw new AgentDefinitionError("model.default is required");
+    }
+    if (!Array.isArray(model.allow) || model.allow.length === 0) {
+        throw new AgentDefinitionError("model.allow must be a non-empty array (use ['<provider>/*'] for permissive)");
+    }
+    const matches = model.allow.some((pattern) => matchModelPattern(pattern, model.default));
+    if (!matches) {
+        throw new AgentDefinitionError(`model.default "${model.default}" is not covered by model.allow ${JSON.stringify(model.allow)}`);
+    }
+}
+/**
+ * Match a single model identifier against a glob pattern.
+ * Supported wildcards: `*` (provider segment or any chars in model id),
+ * `**` (multi-segment / any chars).
+ *
+ * Model ids are `provider/model`. Some local OpenAI-compatible servers expose
+ * namespaced model ids like `local/qwen/qwen3.5-9b`, so the model portion is
+ * treated as an opaque identifier rather than a path with slash-separated
+ * segments.
+ *
+ * Examples:
+ *   matchModelPattern('local/*',  'local/qwen3.5-2b') -> true
+ *   matchModelPattern('local/*',  'openai/gpt-5.4')   -> false
+ *   matchModelPattern('openai/*', 'openai/gpt-5.4')   -> true
+ */
+export function matchModelPattern(pattern, modelId) {
+    const patternSlash = pattern.indexOf("/");
+    const modelSlash = modelId.indexOf("/");
+    if (patternSlash === -1 || modelSlash === -1) {
+        return compileGlob(pattern, false).test(modelId);
+    }
+    const patternProvider = pattern.slice(0, patternSlash);
+    const patternModel = pattern.slice(patternSlash + 1);
+    const modelProvider = modelId.slice(0, modelSlash);
+    const concreteModel = modelId.slice(modelSlash + 1);
+    return (compileGlob(patternProvider, false).test(modelProvider) &&
+        compileGlob(patternModel, true).test(concreteModel));
+}
+function compileGlob(pattern, starMatchesSlash) {
+    const starPattern = starMatchesSlash ? ".*" : "[^/]+";
+    const regexSrc = pattern
+        .split("**")
+        .map((part) => part
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*/g, starPattern))
+        .join(".*");
+    return new RegExp(`^${regexSrc}$`);
+}
+/**
+ * Validate the output declaration. For `default: 'json'` an explicit Zod
+ * schema is required; the compiler will serialize it to JSON Schema.
+ */
+function validateOutput(output) {
+    if (!output || typeof output !== "object") {
+        throw new AgentDefinitionError("output declaration is required");
+    }
+    if (output.default === "json") {
+        if (!("schema" in output) || !output.schema) {
+            throw new AgentDefinitionError("output.default = 'json' requires output.schema (a zod type)");
+        }
+    }
+    else if (output.default !== "text") {
+        throw new AgentDefinitionError(`output.default must be "text" or "json" (got: ${JSON.stringify(output.default)})`);
+    }
+}
+function validateProcessors(processors) {
+    if (!processors)
+        return;
+    const seen = new Set();
+    for (const processor of processors) {
+        if (!processor.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(processor.id)) {
+            throw new AgentDefinitionError(`processor.id must be kebab-case (got: ${JSON.stringify(processor.id)})`);
+        }
+        if (!processor.description || processor.description.length === 0) {
+            throw new AgentDefinitionError(`processor "${processor.id}" must have a description`);
+        }
+        if (processor.phase !== "before" && processor.phase !== "after") {
+            throw new AgentDefinitionError(`processor "${processor.id}" phase must be "before" or "after"`);
+        }
+        if (seen.has(processor.id)) {
+            throw new AgentDefinitionError(`duplicate processor id "${processor.id}"`);
+        }
+        seen.add(processor.id);
+    }
+}
+function validateSubagents(subagents) {
+    if (!subagents)
+        return;
+    const seen = new Set();
+    for (const subagent of subagents) {
+        if (!subagent.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(subagent.id)) {
+            throw new AgentDefinitionError(`subagent.id must be kebab-case (got: ${JSON.stringify(subagent.id)})`);
+        }
+        if (!subagent.description || subagent.description.length === 0) {
+            throw new AgentDefinitionError(`subagent "${subagent.id}" must have a description`);
+        }
+        if (seen.has(subagent.id)) {
+            throw new AgentDefinitionError(`duplicate subagent id "${subagent.id}"`);
+        }
+        seen.add(subagent.id);
+    }
+}
+function validateWorkflowEvents(events) {
+    if (!events || typeof events !== "object" || Array.isArray(events)) {
+        throw new WorkflowDefinitionError("events must be an object map");
+    }
+    const entries = Object.entries(events);
+    if (entries.length === 0) {
+        throw new WorkflowDefinitionError("events must declare at least one event");
+    }
+    for (const [name, schema] of entries) {
+        if (!/^[a-z0-9]+(?:[.-][a-z0-9]+)*$/.test(name)) {
+            throw new WorkflowDefinitionError(`workflow event "${name}" must use dot-separated lowercase segments`);
+        }
+        if (!schema || typeof schema !== "object") {
+            throw new WorkflowDefinitionError(`workflow event "${name}" must have a zod schema`);
+        }
+    }
+}
+function validateWorkflowHost(host) {
+    if (!host)
+        return;
+    for (const [name, declaration] of Object.entries(host)) {
+        if (!/^[a-z][a-zA-Z0-9]*$/.test(name)) {
+            throw new WorkflowDefinitionError(`host adapter "${name}" must be a camelCase identifier`);
+        }
+        if (!declaration || typeof declaration !== "object") {
+            throw new WorkflowDefinitionError(`host adapter "${name}" must declare a zod function`);
+        }
+    }
+}
+function validateWorkflowCadence(cadence) {
+    if (!cadence)
+        return;
+    if (!cadence.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(cadence.id)) {
+        throw new WorkflowDefinitionError(`workflow cadence id must be kebab-case (got: ${JSON.stringify(cadence.id)})`);
+    }
+    if (!cadence.description || cadence.description.length === 0) {
+        throw new WorkflowDefinitionError(`workflow cadence "${cadence.id}" must have a description`);
+    }
+    if (!cadence.every || typeof cadence.every.ms !== "number" || cadence.every.ms <= 0) {
+        throw new WorkflowDefinitionError(`workflow cadence "${cadence.id}" must declare a positive duration`);
+    }
+}
+function validateWorkflowNodes(definition) {
+    if (!Array.isArray(definition.nodes) || definition.nodes.length === 0) {
+        throw new WorkflowDefinitionError("nodes must be a non-empty array");
+    }
+    const knownEvents = new Set(Object.keys(definition.events));
+    const seen = new Set();
+    for (const node of definition.nodes) {
+        if (!node.id || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(node.id)) {
+            throw new WorkflowDefinitionError(`workflow node id must be kebab-case (got: ${JSON.stringify(node.id)})`);
+        }
+        if (seen.has(node.id)) {
+            throw new WorkflowDefinitionError(`duplicate workflow node id "${node.id}"`);
+        }
+        seen.add(node.id);
+        const triggers = Array.isArray(node.on) ? node.on : [node.on];
+        if (triggers.length === 0) {
+            throw new WorkflowDefinitionError(`workflow node "${node.id}" must declare at least one trigger`);
+        }
+        for (const eventName of triggers) {
+            if (!knownEvents.has(eventName)) {
+                throw new WorkflowDefinitionError(`workflow node "${node.id}" references unknown trigger event "${eventName}"`);
+            }
+        }
+        const emits = node.emits
+            ? Array.isArray(node.emits)
+                ? node.emits
+                : [node.emits]
+            : [];
+        for (const eventName of emits) {
+            if (!knownEvents.has(eventName)) {
+                throw new WorkflowDefinitionError(`workflow node "${node.id}" references unknown emitted event "${eventName}"`);
+            }
+        }
+        validateWorkflowCadence(node.policy?.cadence);
+        if (typeof node.run !== "function") {
+            throw new WorkflowDefinitionError(`workflow node "${node.id}" run must be a function`);
+        }
+    }
+}
+function validateWorkflowOutput(output) {
+    if (typeof output !== "function") {
+        throw new WorkflowDefinitionError("workflow output must be a function");
+    }
+}
+/**
+ * The author-facing factory. Authors call this in their agent module's
+ * default export. TypeScript binds the inputs schema generic so the `run`
+ * function receives correctly-typed `inputs`.
+ *
+ * The returned `AgentModule` is a thin wrapper — the actual executable
+ * client is materialized by `@dahura/super-agent-runtime` when consumers import it.
+ *
+ * @example
+ *   export default defineAgent({
+ *     meta: { id: 'transcript-agent', exportName: 'transcriptAgent', version: '1.0.0', description: '...' },
+ *     inputs: { audio: { max: 1, formats: ['wav', 'mp3'] } },
+ *     output: { default: 'text' },
+ *     model: { default: 'local/whisper-base', allow: ['local/*'] },
+ *     async run({ inputs, query, model }) { ... },
+ *   });
+ */
+export function defineAgent(definition) {
+    validateMeta(definition.meta);
+    validateModelPolicy(definition.model);
+    validateOutput(definition.output);
+    validateProcessors(definition.processors);
+    validateSubagents(definition.subagents);
+    if (typeof definition.run !== "function") {
+        throw new AgentDefinitionError("run must be a function");
+    }
+    return {
+        __isAgent: true,
+        definition,
+    };
+}
+export const workflow = {
+    duration: {
+        milliseconds(value) {
+            return { ms: value };
+        },
+        seconds(value) {
+            return { ms: value * 1000 };
+        },
+        minutes(value) {
+            return { ms: value * 60 * 1000 };
+        },
+    },
+    cadence(input) {
+        validateWorkflowCadence(input);
+        return input;
+    },
+};
+export function defineWorkflow(definition) {
+    validateWorkflowMeta(definition.meta);
+    validateWorkflowEvents(definition.events);
+    validateWorkflowHost(definition.host);
+    if (!definition.state || typeof definition.state.initial !== "function") {
+        throw new WorkflowDefinitionError("workflow state.initial must be a function");
+    }
+    validateWorkflowNodes(definition);
+    validateWorkflowOutput(definition.output);
+    return {
+        __isWorkflow: true,
+        definition,
+    };
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @dahura/super-agent-kit — SDK for agent authors.
+ *
+ * Authors import `defineAgent` (typed factory) and `z` (zod re-export) from
+ * this package. They never need to depend on @dahura/super-agent-runtime directly —
+ * the runtime materializes their definitions on the consumer side.
+ */
+export { defineAgent, defineWorkflow, workflow, AgentDefinitionError, WorkflowDefinitionError, matchModelPattern, } from "./define";
+export type { AgentDefinition, AgentMeta, AgentManifest, AgentModule, AgentRunContext, AgentLogger, AgentRequireRuntime, AiSdkModelRequirement, CustomModelRequirement, ProcessorDefinition, ProcessorPhase, ProcessorStep, ProcessorRuntime, ProcessorSelection, ProcessorMode, SubagentDefinition, SubagentMode, SubagentSelection, SubagentRuntime, SubagentStep, SubagentStepResult, SubagentTraceEntry, SubagentTraceChange, SubagentUsage, ModelPolicy, OutputDecl, FixtureEntry, FixtureInputs, WorkflowMeta, WorkflowEventSchemas, WorkflowHostSchema, WorkflowDuration, WorkflowCadence, WorkflowNodePolicy, WorkflowOutputSelector, WorkflowStateDecl, WorkflowEventEnvelope, WorkflowAskLike, WorkflowAgentLike, WorkflowNodeRunContext, WorkflowNode, WorkflowDefinition, WorkflowManifest, WorkflowModule, } from "./types";
+export type { InputsSchema, ImageInputDecl, AudioInputDecl, TextInputDecl, FileInputDecl, InputItem, RuntimeInputs, } from "./inputs";
+export { DEFAULT_IMAGE_FORMATS, DEFAULT_AUDIO_FORMATS, } from "./inputs";
+export { defineProvider, isProviderModule, providerToManifest, ProviderDefinitionError, } from "./provider";
+export type { ProviderKind, ProviderCapability, ProviderMeta, ProviderEnvVar, ProviderEnvSchema, ProviderModelDiscovery, ProviderProbeResult, ProviderConfig, ProviderDefinition, ProviderModule, ProviderManifest, } from "./provider";
+export { z } from "zod";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,eAAe,EACf,SAAS,EACT,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @dahura/super-agent-kit — SDK for agent authors.
+ *
+ * Authors import `defineAgent` (typed factory) and `z` (zod re-export) from
+ * this package. They never need to depend on @dahura/super-agent-runtime directly —
+ * the runtime materializes their definitions on the consumer side.
+ */
+export { defineAgent, defineWorkflow, workflow, AgentDefinitionError, WorkflowDefinitionError, matchModelPattern, } from "./define";
+export { DEFAULT_IMAGE_FORMATS, DEFAULT_AUDIO_FORMATS, } from "./inputs";
+// Provider definition types and factory
+export { defineProvider, isProviderModule, providerToManifest, ProviderDefinitionError, } from "./provider";
+// One source of truth for zod across kit, agents, and consumer code.
+export { z } from "zod";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAwDlB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,wCAAwC;AACxC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAepB,qEAAqE;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/inputs.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Input declarations for agents.
+ *
+ * Each agent declares which inputs it accepts. The shape of `inputs` in the
+ * agent definition drives:
+ *   1. Which `loadXxx()` methods are available on the agent client.
+ *   2. The maximum number of items per loader.
+ *   3. UI form generation in the Playground.
+ *   4. Runtime input validation at the boundary.
+ */
+export type ImageInputDecl = {
+    /** Maximum number of images allowed for a single ask. Defaults to 1. */
+    max?: number;
+    /** Allowed file format extensions (lowercase, no dot). Defaults to png + jpeg. */
+    formats?: ReadonlyArray<"png" | "jpeg" | "jpg" | "webp" | "gif">;
+};
+export type AudioInputDecl = {
+    /** Maximum number of audio chunks allowed for a single ask. Defaults to 1. */
+    max?: number;
+    /** Allowed file format extensions. Defaults to wav + mp3 + m4a. */
+    formats?: ReadonlyArray<"wav" | "mp3" | "m4a" | "flac" | "ogg">;
+    /** Maximum duration per chunk in seconds. Optional. */
+    maxDurationSec?: number;
+};
+export type TextInputDecl = {
+    /** Whether the text input is required for any ask. Defaults to false. */
+    required?: boolean;
+    /** Soft maximum byte length of the text payload. Optional. */
+    maxBytes?: number;
+};
+export type FileInputDecl = {
+    /** Maximum number of files. Defaults to 1. */
+    max?: number;
+    /** Allowed mime types as glob-like patterns (e.g. "application/json", "text/*"). */
+    mimeTypes?: ReadonlyArray<string>;
+};
+/**
+ * The full inputs schema declared by an agent. All fields are optional;
+ * an agent that declares none is a "text-only" agent driven by the `query` only.
+ */
+export type InputsSchema = {
+    image?: ImageInputDecl;
+    audio?: AudioInputDecl;
+    text?: TextInputDecl;
+    file?: FileInputDecl;
+};
+/**
+ * A single normalized input item passed to the agent's `run` function at
+ * runtime. The runtime is responsible for reading file paths or URLs and
+ * producing this representation.
+ */
+export type InputItem<TKind extends "image" | "audio" | "text" | "file"> = {
+    kind: TKind;
+    /** Original source descriptor (file path, URL, or "<inline>" for buffers). */
+    source: string;
+    /** Inferred mime type. */
+    mime: string;
+    /** Binary payload for image/audio/file. Empty for text. */
+    data: Uint8Array;
+    /** Decoded UTF-8 text for text inputs (null otherwise). */
+    text: string | null;
+};
+/**
+ * The shape of `inputs` passed into agent.run() — keyed by input kind, with
+ * arrays of normalized items. Empty arrays mean "loader was not called".
+ */
+export type RuntimeInputs = {
+    image: ReadonlyArray<InputItem<"image">>;
+    audio: ReadonlyArray<InputItem<"audio">>;
+    text: ReadonlyArray<InputItem<"text">>;
+    file: ReadonlyArray<InputItem<"file">>;
+};
+/**
+ * Default values for input declarations. Used by both manifest emission and
+ * runtime validation so the two cannot drift.
+ */
+export declare const DEFAULT_IMAGE_FORMATS: ReadonlyArray<string>;
+export declare const DEFAULT_AUDIO_FORMATS: ReadonlyArray<string>;
+//# sourceMappingURL=inputs.d.ts.map

package/dist/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;IAChE,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,IAAI;IACzE,IAAI,EAAE,KAAK,CAAC;IACZ,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAA0B,CAAC;AACnF,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAyB,CAAC"}

package/dist/inputs.js

@@ -0,0 +1,17 @@
+/**
+ * Input declarations for agents.
+ *
+ * Each agent declares which inputs it accepts. The shape of `inputs` in the
+ * agent definition drives:
+ *   1. Which `loadXxx()` methods are available on the agent client.
+ *   2. The maximum number of items per loader.
+ *   3. UI form generation in the Playground.
+ *   4. Runtime input validation at the boundary.
+ */
+/**
+ * Default values for input declarations. Used by both manifest emission and
+ * runtime validation so the two cannot drift.
+ */
+export const DEFAULT_IMAGE_FORMATS = ["png", "jpeg", "jpg"];
+export const DEFAULT_AUDIO_FORMATS = ["wav", "mp3", "m4a"];
+//# sourceMappingURL=inputs.js.map

package/dist/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAA0B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC"}