@wix/evalforge-types 0.3.0

package/build/types/evaluation/metrics.d.ts

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+/**
+ * Token usage schema.
+ */
+export declare const TokenUsageSchema: z.ZodObject<{
+    prompt: z.ZodNumber;
+    completion: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type TokenUsage = z.infer<typeof TokenUsageSchema>;
+/**
+ * Evaluation metrics schema.
+ */
+export declare const EvalMetricsSchema: z.ZodObject<{
+    totalAssertions: z.ZodNumber;
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    skipped: z.ZodNumber;
+    errors: z.ZodNumber;
+    passRate: z.ZodNumber;
+    avgDuration: z.ZodNumber;
+    totalDuration: z.ZodNumber;
+}, z.core.$strip>;
+export type EvalMetrics = z.infer<typeof EvalMetricsSchema>;
+/**
+ * Evaluation status enum.
+ */
+export declare enum EvalStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+export declare const EvalStatusSchema: z.ZodEnum<typeof EvalStatus>;
+/**
+ * LLM step type enum.
+ */
+export declare enum LLMStepType {
+    COMPLETION = "completion",
+    TOOL_USE = "tool_use",
+    TOOL_RESULT = "tool_result",
+    THINKING = "thinking"
+}
+/**
+ * LLM trace step schema.
+ */
+export declare const LLMTraceStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    stepNumber: z.ZodNumber;
+    type: z.ZodEnum<typeof LLMStepType>;
+    model: z.ZodString;
+    provider: z.ZodString;
+    startedAt: z.ZodString;
+    durationMs: z.ZodNumber;
+    tokenUsage: z.ZodObject<{
+        prompt: z.ZodNumber;
+        completion: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+    costUsd: z.ZodNumber;
+    toolName: z.ZodOptional<z.ZodString>;
+    toolArguments: z.ZodOptional<z.ZodString>;
+    inputPreview: z.ZodOptional<z.ZodString>;
+    outputPreview: z.ZodOptional<z.ZodString>;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LLMTraceStep = z.infer<typeof LLMTraceStepSchema>;
+/**
+ * LLM breakdown stats schema.
+ */
+export declare const LLMBreakdownStatsSchema: z.ZodObject<{
+    count: z.ZodNumber;
+    durationMs: z.ZodNumber;
+    tokens: z.ZodNumber;
+    costUsd: z.ZodNumber;
+}, z.core.$strip>;
+export type LLMBreakdownStats = z.infer<typeof LLMBreakdownStatsSchema>;
+/**
+ * LLM trace summary schema.
+ */
+export declare const LLMTraceSummarySchema: z.ZodObject<{
+    totalSteps: z.ZodNumber;
+    totalDurationMs: z.ZodNumber;
+    totalTokens: z.ZodObject<{
+        prompt: z.ZodNumber;
+        completion: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+    totalCostUsd: z.ZodNumber;
+    stepTypeBreakdown: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        count: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        tokens: z.ZodNumber;
+        costUsd: z.ZodNumber;
+    }, z.core.$strip>>>;
+    modelBreakdown: z.ZodRecord<z.ZodString, z.ZodObject<{
+        count: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        tokens: z.ZodNumber;
+        costUsd: z.ZodNumber;
+    }, z.core.$strip>>;
+    modelsUsed: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type LLMTraceSummary = z.infer<typeof LLMTraceSummarySchema>;
+/**
+ * LLM trace schema.
+ */
+export declare const LLMTraceSchema: z.ZodObject<{
+    id: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        stepNumber: z.ZodNumber;
+        type: z.ZodEnum<typeof LLMStepType>;
+        model: z.ZodString;
+        provider: z.ZodString;
+        startedAt: z.ZodString;
+        durationMs: z.ZodNumber;
+        tokenUsage: z.ZodObject<{
+            prompt: z.ZodNumber;
+            completion: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+        costUsd: z.ZodNumber;
+        toolName: z.ZodOptional<z.ZodString>;
+        toolArguments: z.ZodOptional<z.ZodString>;
+        inputPreview: z.ZodOptional<z.ZodString>;
+        outputPreview: z.ZodOptional<z.ZodString>;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        totalSteps: z.ZodNumber;
+        totalDurationMs: z.ZodNumber;
+        totalTokens: z.ZodObject<{
+            prompt: z.ZodNumber;
+            completion: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>;
+        totalCostUsd: z.ZodNumber;
+        stepTypeBreakdown: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            count: z.ZodNumber;
+            durationMs: z.ZodNumber;
+            tokens: z.ZodNumber;
+            costUsd: z.ZodNumber;
+        }, z.core.$strip>>>;
+        modelBreakdown: z.ZodRecord<z.ZodString, z.ZodObject<{
+            count: z.ZodNumber;
+            durationMs: z.ZodNumber;
+            tokens: z.ZodNumber;
+            costUsd: z.ZodNumber;
+        }, z.core.$strip>>;
+        modelsUsed: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type LLMTrace = z.infer<typeof LLMTraceSchema>;

package/build/types/improvement/improvement.d.ts

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+/**
+ * Improvement target types.
+ */
+export declare const ImprovementTargetTypeSchema: z.ZodEnum<{
+    prompt_agent: "prompt_agent";
+    skill: "skill";
+    agent: "agent";
+}>;
+export type ImprovementTargetType = z.infer<typeof ImprovementTargetTypeSchema>;
+/**
+ * Improvement run status.
+ */
+export declare const ImprovementRunStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    pending: "pending";
+    running: "running";
+    completed: "completed";
+}>;
+export type ImprovementRunStatus = z.infer<typeof ImprovementRunStatusSchema>;
+/**
+ * Iteration change schema - represents a single change made during an improvement iteration.
+ */
+export declare const IterationChangeSchema: z.ZodObject<{
+    field: z.ZodString;
+    before: z.ZodString;
+    after: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type IterationChange = z.infer<typeof IterationChangeSchema>;
+/**
+ * Improvement iteration schema - represents a single iteration in an improvement run.
+ */
+export declare const ImprovementIterationSchema: z.ZodObject<{
+    id: z.ZodString;
+    iterationNumber: z.ZodNumber;
+    passRate: z.ZodNumber;
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    changes: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        before: z.ZodString;
+        after: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    feedback: z.ZodString;
+    targetSnapshot: z.ZodAny;
+    evaluatedAt: z.ZodString;
+}, z.core.$strip>;
+export type ImprovementIteration = z.infer<typeof ImprovementIterationSchema>;
+/**
+ * Improvement run schema - represents a complete improvement run with iterations.
+ *
+ * Extends TenantEntity for multi-tenancy support.
+ */
+export declare const ImprovementRunSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+    targetType: z.ZodEnum<{
+        prompt_agent: "prompt_agent";
+        skill: "skill";
+        agent: "agent";
+    }>;
+    targetId: z.ZodString;
+    targetName: z.ZodString;
+    testSuiteId: z.ZodString;
+    testSuiteName: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+    }>;
+    maxIterations: z.ZodNumber;
+    iterations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        iterationNumber: z.ZodNumber;
+        passRate: z.ZodNumber;
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        changes: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            before: z.ZodString;
+            after: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        feedback: z.ZodString;
+        targetSnapshot: z.ZodAny;
+        evaluatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    initialPassRate: z.ZodNumber;
+    finalPassRate: z.ZodNumber;
+    improvement: z.ZodNumber;
+    startedAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImprovementRun = z.infer<typeof ImprovementRunSchema>;
+/**
+ * Input schema for creating a new improvement run.
+ */
+export declare const CreateImprovementRunInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    targetId: z.ZodString;
+    targetName: z.ZodString;
+    targetType: z.ZodEnum<{
+        prompt_agent: "prompt_agent";
+        skill: "skill";
+        agent: "agent";
+    }>;
+    testSuiteId: z.ZodString;
+    testSuiteName: z.ZodString;
+    maxIterations: z.ZodNumber;
+}, z.core.$strip>;
+export type CreateImprovementRunInput = z.infer<typeof CreateImprovementRunInputSchema>;
+/**
+ * Input schema for updating an improvement run.
+ */
+export declare const UpdateImprovementRunInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    deleted: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    targetId: z.ZodOptional<z.ZodString>;
+    targetName: z.ZodOptional<z.ZodString>;
+    targetType: z.ZodOptional<z.ZodEnum<{
+        prompt_agent: "prompt_agent";
+        skill: "skill";
+        agent: "agent";
+    }>>;
+    testSuiteId: z.ZodOptional<z.ZodString>;
+    testSuiteName: z.ZodOptional<z.ZodString>;
+    maxIterations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UpdateImprovementRunInput = z.infer<typeof UpdateImprovementRunInputSchema>;

package/build/types/improvement/index.d.ts

@@ -0,0 +1 @@
+export * from './improvement.js';

package/build/types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @wix/evalforge-types
+ *
+ * Unified types for the agent evaluation system.
+ *
+ * Entity Hierarchy:
+ * - BaseEntity: id, name, description, dates
+ * - TenantEntity: extends BaseEntity with projectId
+ * - Target: extends TenantEntity (base for testable entities)
+ *   - Agent: CLI-based agent (runCommand, modelConfig)
+ *   - Skill: SKILL.md-based capability
+ *
+ * Test Types (9 total):
+ * - LLM, TOOL, SITE_CONFIG, COMMAND_EXECUTION (from old system)
+ * - FILE_PRESENCE, FILE_CONTENT, BUILD_CHECK, VITEST, PLAYWRIGHT_NL (new)
+ */
+export * from './common/index.js';
+export * from './target/index.js';
+export * from './test/index.js';
+export * from './scenario/index.js';
+export * from './suite/index.js';
+export * from './evaluation/index.js';
+export * from './project/index.js';
+export * from './template/index.js';

package/build/types/project/index.d.ts

@@ -0,0 +1 @@
+export * from './project.js';

package/build/types/project/project.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Project schema - represents a tenant/workspace for data isolation.
+ *
+ * All entities belong to a project. Projects are the top-level
+ * organizational unit for multi-tenancy.
+ *
+ * Note: Project extends BaseEntity (not TenantEntity) since
+ * Project IS the tenant and doesn't need a projectId.
+ */
+export declare const ProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    appId: z.ZodOptional<z.ZodString>;
+    appSecret: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Project = z.infer<typeof ProjectSchema>;
+/**
+ * Input schema for creating a new Project.
+ */
+export declare const CreateProjectInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    appId: z.ZodOptional<z.ZodString>;
+    appSecret: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateProjectInput = z.infer<typeof CreateProjectInputSchema>;
+/**
+ * Input schema for updating a Project.
+ */
+export declare const UpdateProjectInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    appId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    appSecret: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type UpdateProjectInput = z.infer<typeof UpdateProjectInputSchema>;

package/build/types/scenario/environment.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+/**
+ * Local project configuration schema.
+ */
+export declare const LocalProjectConfigSchema: z.ZodObject<{
+    templateId: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LocalProjectConfig = z.infer<typeof LocalProjectConfigSchema>;
+/**
+ * Meta site configuration schema for API-based setup.
+ */
+export declare const MetaSiteConfigSchema: z.ZodObject<{
+    configurations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        apiCalls: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            method: z.ZodEnum<{
+                POST: "POST";
+                PUT: "PUT";
+            }>;
+            body: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type MetaSiteConfig = z.infer<typeof MetaSiteConfigSchema>;
+/**
+ * Environment configuration schema.
+ *
+ * Defines the environment setup required for running a test scenario.
+ * Migrated from the old Prompt schema.
+ */
+export declare const EnvironmentSchema: z.ZodObject<{
+    localProject: z.ZodOptional<z.ZodObject<{
+        templateId: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    metaSite: z.ZodOptional<z.ZodObject<{
+        configurations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            apiCalls: z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                method: z.ZodEnum<{
+                    POST: "POST";
+                    PUT: "PUT";
+                }>;
+                body: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Environment = z.infer<typeof EnvironmentSchema>;

package/build/types/scenario/index.d.ts

@@ -0,0 +1,2 @@
+export * from './environment.js';
+export * from './test-scenario.js';

package/build/types/scenario/test-scenario.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/**
+ * Expected file schema - a file the agent is expected to create or modify.
+ * Used by eval results; not persisted on test_scenarios table.
+ */
+export declare const ExpectedFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ExpectedFile = z.infer<typeof ExpectedFileSchema>;
+/**
+ * TestScenario schema - defines a single test scenario.
+ *
+ * Persisted shape matches test_scenarios table:
+ * id, project_id, name, description, trigger_prompt, template_id, created_at, updated_at, deleted.
+ */
+export declare const TestScenarioSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+    triggerPrompt: z.ZodString;
+    templateId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TestScenario = z.infer<typeof TestScenarioSchema>;
+/**
+ * Input schema for creating a new TestScenario.
+ */
+export declare const CreateTestScenarioInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    projectId: z.ZodString;
+    templateId: z.ZodOptional<z.ZodString>;
+    triggerPrompt: z.ZodString;
+}, z.core.$strip>;
+export type CreateTestScenarioInput = z.infer<typeof CreateTestScenarioInputSchema>;
+/**
+ * Input schema for updating a TestScenario.
+ */
+export declare const UpdateTestScenarioInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    triggerPrompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateTestScenarioInput = z.infer<typeof UpdateTestScenarioInputSchema>;

package/build/types/suite/index.d.ts

@@ -0,0 +1 @@
+export * from './test-suite.js';

package/build/types/suite/test-suite.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * TestSuite schema - a collection of test scenarios.
+ *
+ * Suites are used to organize and group related test scenarios.
+ */
+export declare const TestSuiteSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+    scenarioIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type TestSuite = z.infer<typeof TestSuiteSchema>;
+/**
+ * Input schema for creating a new TestSuite.
+ */
+export declare const CreateTestSuiteInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    projectId: z.ZodString;
+    scenarioIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type CreateTestSuiteInput = z.infer<typeof CreateTestSuiteInputSchema>;
+/**
+ * Input schema for updating a TestSuite.
+ */
+export declare const UpdateTestSuiteInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    scenarioIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type UpdateTestSuiteInput = z.infer<typeof UpdateTestSuiteInputSchema>;

package/build/types/target/agent.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+/**
+ * Agent schema - a CLI-based coding agent.
+ *
+ * Agents are external CLI tools that can execute coding tasks.
+ * Examples: Claude Code CLI, Codex CLI, Cursor CLI.
+ */
+export declare const AgentSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+    runCommand: z.ZodString;
+    modelConfig: z.ZodOptional<z.ZodObject<{
+        model: z.ZodEnum<typeof import("../common/models.js").ModelIds>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Agent = z.infer<typeof AgentSchema>;
+/**
+ * Input schema for creating a new Agent.
+ */
+export declare const CreateAgentInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    projectId: z.ZodString;
+    runCommand: z.ZodString;
+    modelConfig: z.ZodOptional<z.ZodObject<{
+        model: z.ZodEnum<typeof import("../common/models.js").ModelIds>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateAgentInput = z.infer<typeof CreateAgentInputSchema>;
+/**
+ * Input schema for updating an Agent.
+ */
+export declare const UpdateAgentInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    runCommand: z.ZodOptional<z.ZodString>;
+    modelConfig: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        model: z.ZodEnum<typeof import("../common/models.js").ModelIds>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type UpdateAgentInput = z.infer<typeof UpdateAgentInputSchema>;

package/build/types/target/index.d.ts

@@ -0,0 +1,4 @@
+export * from './target.js';
+export * from './agent.js';
+export * from './skill.js';
+export * from './skills-group.js';

package/build/types/target/skill.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+/**
+ * Skill metadata parsed from SKILL.md frontmatter.
+ *
+ * Following the agentskills.io specification:
+ * - name: Skill identifier (max 64 chars, lowercase + hyphens)
+ * - description: What the skill does and when to use it
+ * - allowedTools: Pre-approved tools the skill may use
+ * - skills: Sub-skills for composite agents
+ */
+export declare const SkillMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type SkillMetadata = z.infer<typeof SkillMetadataSchema>;
+/**
+ * Skill version - historical snapshot of a Skill's content.
+ */
+export declare const SkillVersionSchema: z.ZodObject<{
+    id: z.ZodString;
+    skillId: z.ZodString;
+    skillMd: z.ZodString;
+    metadata: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    model: z.ZodOptional<z.ZodObject<{
+        model: z.ZodEnum<typeof import("../common/models.js").ModelIds>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    version: z.ZodNumber;
+    createdAt: z.ZodString;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SkillVersion = z.infer<typeof SkillVersionSchema>;
+/**
+ * Skill schema - a coding capability defined by SKILL.md.
+ *
+ * Skills represent coding capabilities that can be tested.
+ * Persisted shape: id, projectId, name, description, createdAt, updatedAt, deleted, skillMd.
+ */
+export declare const SkillSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+    skillMd: z.ZodString;
+}, z.core.$strip>;
+export type Skill = z.infer<typeof SkillSchema>;
+/**
+ * Input schema for creating a new Skill.
+ */
+export declare const CreateSkillInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    projectId: z.ZodString;
+    skillMd: z.ZodString;
+}, z.core.$strip>;
+export type CreateSkillInput = z.infer<typeof CreateSkillInputSchema>;
+/**
+ * Input schema for updating a Skill.
+ */
+export declare const UpdateSkillInputSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    skillMd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateSkillInput = z.infer<typeof UpdateSkillInputSchema>;