@agentkitforge/core 0.1.0

package/dist/providers/catalog.d.ts

@@ -0,0 +1,15 @@
+import type { AiProviderType, KnownModel, ProviderCapabilities } from "./types.js";
+export declare const aiProviderTypes: AiProviderType[];
+export declare const modelCatalog: Record<AiProviderType, KnownModel[]>;
+export declare const structuredOutputGuidance: {
+    readonly draftGeneration: "Agent Kit draft generation must return valid JSON matching the AgentKitDraft schema.";
+    readonly reliability: "Providers and models vary in JSON reliability. Validate every returned draft before rendering it.";
+    readonly localModelWarning: "Local and custom models should warn users when structured JSON support is not known or explicitly disabled.";
+};
+export declare function getKnownModelsForProvider(providerType: AiProviderType): KnownModel[];
+export declare function getDefaultModelForProvider(providerType: AiProviderType): string | undefined;
+export declare function getProviderCapabilities(providerType: AiProviderType): ProviderCapabilities;
+export declare function isApiKeyRequiredForProvider(providerType: AiProviderType): boolean;
+export declare function isBaseUrlRequiredForProvider(providerType: AiProviderType): boolean;
+export declare function normalizeBaseUrl(providerType: AiProviderType, baseUrl?: string): string | undefined;
+export declare function providerSupportsStructuredJson(providerType: AiProviderType, modelId?: string, explicitOverride?: boolean): boolean;

package/dist/providers/catalog.js

@@ -0,0 +1,211 @@
+export const aiProviderTypes = [
+    "openai",
+    "anthropic",
+    "gemini",
+    "ollama",
+    "openai-compatible"
+];
+export const modelCatalog = {
+    openai: [
+        {
+            id: "gpt-5.5",
+            label: "GPT-5.5",
+            providerTypes: ["openai"],
+            recommendedFor: ["kit-use", "draft-generation"],
+            supportsStructuredJson: true,
+            notes: "Current flagship suggestion for complex reasoning, coding, and agentic workflows. Consumers must allow custom OpenAI model IDs."
+        },
+        {
+            id: "gpt-5.4",
+            label: "GPT-5.4",
+            providerTypes: ["openai"],
+            recommendedFor: ["kit-use", "draft-generation"],
+            supportsStructuredJson: true,
+            notes: "Current affordable GPT-5.4 suggestion for coding and professional work."
+        },
+        {
+            id: "gpt-5.4-mini",
+            label: "GPT-5.4 Mini",
+            providerTypes: ["openai"],
+            recommendedFor: ["kit-use", "fast", "cheap"],
+            supportsStructuredJson: true,
+            notes: "Lower-latency, lower-cost suggestion for well-defined kit use and draft iteration."
+        },
+        {
+            id: "gpt-5.4-nano",
+            label: "GPT-5.4 Nano",
+            providerTypes: ["openai"],
+            recommendedFor: ["fast", "cheap"],
+            supportsStructuredJson: true,
+            notes: "Smallest current GPT-5.4 variant suggestion for fast, cost-sensitive tasks."
+        }
+    ],
+    anthropic: [
+        {
+            id: "claude-opus-4-7",
+            label: "Claude Opus 4.7",
+            providerTypes: ["anthropic"],
+            recommendedFor: ["kit-use", "draft-generation"],
+            supportsStructuredJson: true,
+            notes: "Anthropic's most capable generally available Claude model suggestion for complex reasoning and agentic coding."
+        },
+        {
+            id: "claude-sonnet-4-6",
+            label: "Claude Sonnet 4.6",
+            providerTypes: ["anthropic"],
+            recommendedFor: ["kit-use", "draft-generation", "fast"],
+            supportsStructuredJson: true,
+            notes: "Balanced Claude suggestion for speed and intelligence."
+        },
+        {
+            id: "claude-haiku-4-5",
+            label: "Claude Haiku 4.5",
+            providerTypes: ["anthropic"],
+            recommendedFor: ["kit-use", "fast", "cheap"],
+            supportsStructuredJson: true,
+            notes: "Fast Claude suggestion for lower-latency workflows."
+        }
+    ],
+    gemini: [
+        {
+            id: "gemini-3.1-pro-preview",
+            label: "Gemini 3.1 Pro Preview",
+            providerTypes: ["gemini"],
+            recommendedFor: ["kit-use", "draft-generation"],
+            supportsStructuredJson: true,
+            notes: "Gemini 3.1 Pro preview suggestion for advanced multimodal and agentic work."
+        },
+        {
+            id: "gemini-3.5-flash",
+            label: "Gemini 3.5 Flash",
+            providerTypes: ["gemini"],
+            recommendedFor: ["kit-use", "fast"],
+            supportsStructuredJson: true,
+            notes: "Stable Gemini 3.5 suggestion for speed, scale, and agentic workflows."
+        },
+        {
+            id: "gemini-3.1-flash-lite",
+            label: "Gemini 3.1 Flash-Lite",
+            providerTypes: ["gemini"],
+            recommendedFor: ["fast", "cheap"],
+            supportsStructuredJson: true,
+            notes: "Stable cost-efficient Gemini 3.1 suggestion for high-throughput workflows."
+        }
+    ],
+    ollama: [
+        {
+            id: "gpt-oss:20b",
+            label: "gpt-oss 20B",
+            providerTypes: ["ollama"],
+            recommendedFor: ["kit-use", "local"],
+            supportsStructuredJson: true,
+            notes: "OpenAI open-weight Ollama model suggestion. Installed local model IDs vary by machine."
+        },
+        {
+            id: "qwen3:30b",
+            label: "Qwen3 30B",
+            providerTypes: ["ollama"],
+            recommendedFor: ["kit-use", "draft-generation", "local"],
+            supportsStructuredJson: false,
+            notes: "Strong local reasoning/coding suggestion. JSON reliability depends on local runtime and prompting."
+        },
+        {
+            id: "gemma3:12b",
+            label: "Gemma 3 12B",
+            providerTypes: ["ollama"],
+            recommendedFor: ["kit-use", "fast", "local"],
+            supportsStructuredJson: false,
+            notes: "Local model suggestion. Installed Ollama model IDs vary by machine."
+        }
+    ],
+    "openai-compatible": []
+};
+const providerCapabilities = {
+    openai: {
+        providerType: "openai",
+        apiKeyRequired: true,
+        baseUrlRequired: false,
+        supportsCustomModels: true,
+        supportsStructuredJson: true
+    },
+    anthropic: {
+        providerType: "anthropic",
+        apiKeyRequired: true,
+        baseUrlRequired: false,
+        supportsCustomModels: true,
+        supportsStructuredJson: true
+    },
+    gemini: {
+        providerType: "gemini",
+        apiKeyRequired: true,
+        baseUrlRequired: false,
+        supportsCustomModels: true,
+        supportsStructuredJson: true
+    },
+    ollama: {
+        providerType: "ollama",
+        apiKeyRequired: false,
+        baseUrlRequired: true,
+        supportsCustomModels: true,
+        supportsStructuredJson: false,
+        notes: "Local model JSON reliability depends on the installed model and runtime options."
+    },
+    "openai-compatible": {
+        providerType: "openai-compatible",
+        apiKeyRequired: true,
+        baseUrlRequired: true,
+        supportsCustomModels: true,
+        supportsStructuredJson: false,
+        notes: "Structured JSON support depends on the compatible server and selected model."
+    }
+};
+export const structuredOutputGuidance = {
+    draftGeneration: "Agent Kit draft generation must return valid JSON matching the AgentKitDraft schema.",
+    reliability: "Providers and models vary in JSON reliability. Validate every returned draft before rendering it.",
+    localModelWarning: "Local and custom models should warn users when structured JSON support is not known or explicitly disabled."
+};
+export function getKnownModelsForProvider(providerType) {
+    return [...modelCatalog[providerType]];
+}
+export function getDefaultModelForProvider(providerType) {
+    return modelCatalog[providerType][0]?.id;
+}
+export function getProviderCapabilities(providerType) {
+    return { ...providerCapabilities[providerType] };
+}
+export function isApiKeyRequiredForProvider(providerType) {
+    return providerCapabilities[providerType].apiKeyRequired;
+}
+export function isBaseUrlRequiredForProvider(providerType) {
+    return providerCapabilities[providerType].baseUrlRequired;
+}
+export function normalizeBaseUrl(providerType, baseUrl) {
+    const trimmed = baseUrl?.trim();
+    if (trimmed) {
+        return trimmed.replace(/\/+$/, "");
+    }
+    if (providerType === "openai") {
+        return "https://api.openai.com/v1";
+    }
+    if (providerType === "anthropic") {
+        return "https://api.anthropic.com/v1";
+    }
+    if (providerType === "gemini") {
+        return "https://generativelanguage.googleapis.com/v1beta";
+    }
+    if (providerType === "ollama") {
+        return "http://localhost:11434";
+    }
+    return undefined;
+}
+export function providerSupportsStructuredJson(providerType, modelId, explicitOverride) {
+    if (explicitOverride !== undefined) {
+        return explicitOverride;
+    }
+    const knownModel = modelCatalog[providerType].find((model) => model.id === modelId);
+    if (knownModel?.supportsStructuredJson !== undefined) {
+        return knownModel.supportsStructuredJson;
+    }
+    return providerCapabilities[providerType].supportsStructuredJson;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/providers/catalog.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,30 @@
+export type AiProviderType = "openai" | "anthropic" | "gemini" | "ollama" | "openai-compatible";
+export type ModelRecommendationTag = "kit-use" | "draft-generation" | "fast" | "cheap" | "local";
+export interface AiProviderConfigBase {
+    id: string;
+    name: string;
+    type: AiProviderType;
+    baseUrl?: string;
+    apiKeyRequired?: boolean;
+    defaultModel?: string;
+    supportsStructuredJson?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export type AiProviderConfigShape = AiProviderConfigBase;
+export interface KnownModel {
+    id: string;
+    label: string;
+    providerTypes: AiProviderType[];
+    recommendedFor: ModelRecommendationTag[];
+    supportsStructuredJson?: boolean;
+    notes?: string;
+}
+export interface ProviderCapabilities {
+    providerType: AiProviderType;
+    apiKeyRequired: boolean;
+    baseUrlRequired: boolean;
+    supportsCustomModels: boolean;
+    supportsStructuredJson: boolean;
+    notes?: string;
+}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/schema/agentkit.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+export declare const agentKitSkillSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    description: z.ZodString;
+    triggers: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const agentKitPromptSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+export declare const agentKitManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodString;
+    kind: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>;
+    license: z.ZodString;
+    entrypoints: z.ZodObject<{
+        human: z.ZodString;
+        agent: z.ZodString;
+    }, z.core.$strip>;
+    userExperience: z.ZodObject<{
+        setupLevel: z.ZodString;
+    }, z.core.$strip>;
+    compatibility: z.ZodObject<{
+        targets: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    risk: z.ZodObject<{
+        level: z.ZodString;
+    }, z.core.$strip>;
+    skills: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        description: z.ZodString;
+        triggers: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    prompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>>;
+    scripts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>>;
+}, z.core.$loose>;
+export type AgentKitManifestInput = z.input<typeof agentKitManifestSchema>;

package/dist/schema/agentkit.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { assertSafeRelativePath, isSafeId } from "../fs/safety.js";
+const safeIdSchema = z.string().min(1).refine(isSafeId, "Use lowercase letters, numbers, and hyphens");
+const safePathSchema = z.string().min(1).refine((value) => {
+    try {
+        assertSafeRelativePath(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, "Use a safe relative path inside the Agent Kit");
+export const agentKitSkillSchema = z.object({
+    id: safeIdSchema,
+    path: safePathSchema,
+    description: z.string().min(1),
+    triggers: z.array(z.string().min(1)).min(1)
+});
+export const agentKitPromptSchema = z.object({
+    id: safeIdSchema,
+    path: safePathSchema,
+    description: z.string().min(1)
+});
+export const agentKitManifestSchema = z
+    .object({
+    schemaVersion: z.string().min(1),
+    kind: z.string().min(1),
+    id: safeIdSchema,
+    name: z.string().min(1),
+    version: z.string().min(1),
+    description: z.string().min(1),
+    author: z.object({
+        name: z.string().min(1)
+    }),
+    license: z.string().min(1),
+    entrypoints: z.object({
+        human: z.string().min(1),
+        agent: z.string().min(1)
+    }),
+    userExperience: z.object({
+        setupLevel: z.string().min(1)
+    }),
+    compatibility: z.object({
+        targets: z.array(z.string().min(1)).min(1)
+    }),
+    risk: z.object({
+        level: z.string().min(1)
+    }),
+    skills: z.array(agentKitSkillSchema).min(1),
+    prompts: z.array(agentKitPromptSchema).optional(),
+    scripts: z
+        .array(z.union([
+        safePathSchema,
+        z.object({
+            id: z.string().min(1).optional(),
+            path: safePathSchema,
+            description: z.string().min(1).optional()
+        })
+    ]))
+        .optional()
+})
+    .passthrough();
+//# sourceMappingURL=agentkit.js.map

package/dist/schema/agentkit.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+export type AgentKitValidationProfile = "local-valid" | "publishable" | "trusted" | "verified";
+export type ValidationIssueSeverity = "error" | "warning";
+export interface ValidationIssue {
+    severity: ValidationIssueSeverity;
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface ValidationReport {
+    valid: boolean;
+    profile: AgentKitValidationProfile;
+    rootPath: string;
+    issues: ValidationIssue[];
+}
+export interface AgentKitSkillManifest {
+    id: string;
+    path: string;
+    description: string;
+    triggers: string[];
+}
+export interface AgentKitPromptManifest {
+    id: string;
+    path: string;
+    description: string;
+}
+export interface AgentKitManifest {
+    schemaVersion: string;
+    kind: string;
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author: {
+        name: string;
+    };
+    license: string;
+    entrypoints: {
+        human: string;
+        agent: string;
+    };
+    userExperience: {
+        setupLevel: string;
+    };
+    compatibility: {
+        targets: string[];
+    };
+    risk: {
+        level: string;
+    };
+    skills: AgentKitSkillManifest[];
+    prompts?: AgentKitPromptManifest[];
+    scripts?: Array<string | {
+        id?: string;
+        path: string;
+        description?: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface LoadedAgentKit {
+    rootPath: string;
+    manifestPath: string;
+    manifestRaw: unknown;
+    manifest?: AgentKitManifest;
+}
+export interface SkillDocument {
+    path: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validation/skill.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDocument, ValidationIssue } from "../types.js";
+export declare function parseSkillMarkdown(content: string, filePath: string): SkillDocument;
+export declare function validateSkillFile(filePath: string): Promise<ValidationIssue[]>;

package/dist/validation/skill.js

@@ -0,0 +1,83 @@
+import { readFile } from "node:fs/promises";
+import YAML from "yaml";
+const REQUIRED_FRONTMATTER_FIELDS = [
+    "id",
+    "name",
+    "description",
+    "triggers",
+    "riskLevel"
+];
+const REQUIRED_SECTIONS = ["## Use when", "## Procedure", "## Output"];
+export function parseSkillMarkdown(content, filePath) {
+    if (!content.startsWith("---\n") && !content.startsWith("---\r\n")) {
+        throw new Error("Missing YAML frontmatter block");
+    }
+    const endMatch = /\r?\n---\r?\n/.exec(content.slice(3));
+    if (!endMatch) {
+        throw new Error("Unclosed YAML frontmatter block");
+    }
+    const frontmatterEnd = 3 + endMatch.index;
+    const frontmatterText = content.slice(3, frontmatterEnd);
+    const body = content.slice(frontmatterEnd + endMatch[0].length);
+    const parsed = YAML.parse(frontmatterText);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("YAML frontmatter must be an object");
+    }
+    return {
+        path: filePath,
+        frontmatter: parsed,
+        body
+    };
+}
+export async function validateSkillFile(filePath) {
+    const issues = [];
+    let skill;
+    try {
+        skill = parseSkillMarkdown(await readFile(filePath, "utf8"), filePath);
+    }
+    catch (error) {
+        return [
+            {
+                severity: "error",
+                code: "skill.frontmatter.invalid",
+                message: error instanceof Error ? error.message : "Invalid SKILL.md frontmatter",
+                path: filePath
+            }
+        ];
+    }
+    for (const field of REQUIRED_FRONTMATTER_FIELDS) {
+        const value = skill.frontmatter[field];
+        if (value === undefined ||
+            value === null ||
+            value === "" ||
+            (Array.isArray(value) && value.length === 0)) {
+            issues.push({
+                severity: "error",
+                code: "skill.frontmatter.missing",
+                message: `Missing required SKILL.md frontmatter field: ${field}`,
+                path: filePath
+            });
+        }
+    }
+    if (!/^#\s+\S+/m.test(skill.body)) {
+        issues.push({
+            severity: "error",
+            code: "skill.section.missing_title",
+            message: "Missing required SKILL.md title section: # Title",
+            path: filePath
+        });
+    }
+    for (const section of REQUIRED_SECTIONS) {
+        const escaped = section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        if (!new RegExp(`^${escaped}\\s*$`, "m").test(skill.body)) {
+            issues.push({
+                severity: "error",
+                code: "skill.section.missing",
+                message: `Missing required SKILL.md section: ${section}`,
+                path: filePath
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=skill.js.map

package/dist/validation/skill.js.map

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

package/dist/validation/validator.d.ts

@@ -0,0 +1,2 @@
+import type { AgentKitValidationProfile, ValidationReport } from "../types.js";
+export declare function validateAgentKit(rootPath: string, profile?: AgentKitValidationProfile): Promise<ValidationReport>;