veryfront 0.1.519 → 0.1.521

package/src/src/extensions/compat/index.ts

@@ -1,5 +1,5 @@
 /**
- * Compat category barrel — Node/Deno compatibility surfaces (sqlite, kreuzberg).
+ * Compat category barrel — optional native runtime services.
  *
  * @module extensions/compat
  */
@@ -7,8 +7,9 @@ import "../../../_dnt.polyfills.js";
 
 
 export type {
+  DocumentExtractor,
   KreuzbergExtractor,
-  NodeCompat,
-  NodeCompatSqliteDatabase,
+  SqliteDatabase,
   SqliteStatement,
-} from "./node-compat.js";
+  SqliteStore,
+} from "./native-services.js";

package/src/src/extensions/compat/{node-compat.ts → native-services.ts}

@@ -1,9 +1,11 @@
 /**
- * Contract interface for Node.js compatibility shims.
+ * Contract interfaces for optional native runtime services.
  *
- * Default implementation: `@veryfront/ext-node-compatibility`
+ * Default implementations:
+ * - `@veryfront/ext-document-kreuzberg` for `DocumentExtractor`
+ * - `@veryfront/ext-db-sqlite` for `SqliteStore`
  *
- * @module extensions/compat/node-compat
+ * @module extensions/compat/native-services
  */
 
 /**
@@ -20,12 +22,12 @@ export interface SqliteStatement {
  * Minimal interface for a SQLite database connection, compatible with
  * `better-sqlite3`'s `Database` shape as consumed by `SqliteKv`.
  *
- * Mirrors `SqliteDatabase` in `src/platform/compat/kv/types.ts` — kept
+ * Mirrors `SqliteDatabase` in `src/platform/compat/kv/types.ts`. Kept
  * separate here so extensions can import from the public
  * `veryfront/extensions/compat` entrypoint without taking a dependency
  * on internal platform paths.
  */
-export interface NodeCompatSqliteDatabase {
+export interface SqliteDatabase {
   exec(sql: string): void;
   prepare(sql: string): SqliteStatement;
   close(): void;
@@ -44,17 +46,9 @@ export interface KreuzbergExtractor {
 }
 
 /**
- * NodeCompat contract interface.
- *
- * Implementations provide access to Node.js-only packages
- * (`@kreuzberg/wasm`, `better-sqlite3`) in environments where those
- * packages are available (i.e. a full Node/Deno runtime, not a compiled
- * binary or edge runtime).
- *
- * Both methods are optional on the interface so that partial
- * implementations (e.g. SQLite-only or kreuzberg-only) are valid.
+ * Document extraction contract.
  */
-export interface NodeCompat {
+export interface DocumentExtractor {
   /**
    * Initialise and return the kreuzberg document-extraction module.
    *
@@ -64,18 +58,18 @@ export interface NodeCompat {
   importKreuzberg?(): Promise<KreuzbergExtractor>;
 
   /**
-   * Run kreuzberg extraction inside an isolated Worker thread.
-   *
-   * Owned by the extension so that the worker script lives in a module
-   * graph where `@kreuzberg/wasm` resolves and the NodeCompat contract
-   * is reachable (Deno worker isolates do not share the main-thread
-   * contract registry).
+   * Extract text from a document buffer.
    *
-   * Callers on Node/Bun can skip workers and use `importKreuzberg()`
-   * directly — native bindings don't need WASM-hang isolation.
+   * Implementations may run extraction inside an isolated worker or call a
+   * native implementation directly.
    */
   extractInWorker?(buffer: ArrayBuffer, mimeType: string): Promise<string>;
+}
 
+/**
+ * SQLite-backed storage contract.
+ */
+export interface SqliteStore {
   /**
    * Open (or create) a SQLite database at `path`.
    *
@@ -85,5 +79,5 @@ export interface NodeCompat {
    * Callers should fall back to the in-memory KV when this method is
    * absent or throws.
    */
-  openSqliteDatabase?(path?: string): Promise<NodeCompatSqliteDatabase>;
+  openSqliteDatabase?(path?: string): Promise<SqliteDatabase>;
 }

package/src/src/extensions/{transform → content}/content-processor.ts

@@ -1,13 +1,13 @@
 /**
  * Contract interface for content processing pipelines.
  *
- * Default implementation: `@veryfront/ext-transform-mdx`
+ * Default implementation: `@veryfront/ext-content-mdx`
  *
  * Implementations process MDX / Markdown source into renderable JavaScript
  * modules plus extracted metadata. Core's `src/transforms/md/compiler` and
  * `src/transforms/mdx/compiler` delegate to the registered implementation;
  * when none is registered, the compile paths throw an actionable install
- * message pointing at `@veryfront/ext-transform-mdx`.
+ * message pointing at `@veryfront/ext-content-mdx`.
  *
  * The two compile methods have the same option shape on purpose so a single
  * dispatcher (see `src/transforms/mdx/compiler/index.ts::compileContent`)
@@ -16,7 +16,7 @@
  * and defaults are preserved so the extension boundary is a pure refactor,
  * not a behavior change.
  *
- * @module extensions/transform/content-processor
+ * @module extensions/content/content-processor
  */
 
 /** Compilation mode. Dev surfaces extra diagnostics. */
@@ -59,6 +59,12 @@ export interface ContentCompileOptions {
   baseUrl?: string;
   /** When true, preserves node-position metadata for studio overlays. */
   studioEmbed?: boolean;
+  /** MDX output shape. Defaults to "program". */
+  outputFormat?: "program" | "function-body";
+  /** Additional remark plugins supplied by legacy build helpers. */
+  remarkPlugins?: ContentPlugin[];
+  /** Additional rehype plugins supplied by legacy build helpers. */
+  rehypePlugins?: ContentPlugin[];
 }
 
 /**

package/src/src/extensions/{transform → content}/index.ts

@@ -1,7 +1,7 @@
 /**
  * Content category barrel for the MDX/Markdown content processor contract.
  *
- * @module extensions/transform
+ * @module extensions/content
  */
 
 // Type aliases (unions / shape aliases)

package/src/src/extensions/contracts.ts

@@ -3,6 +3,8 @@
  *
  * @module extensions/contracts
  */
+import "../../_dnt.polyfills.js";
+
 
 import { MISSING_EXTENSION_ERROR } from "./errors.js";
 import { getRecommendation } from "./recommendations.js";
@@ -31,6 +33,10 @@ export function register<T>(name: string, impl: T): void {
   contracts.set(name, impl);
 }
 
+export function unregister(name: string): void {
+  contracts.delete(name);
+}
+
 export function reset(): void {
   contracts.clear();
 }

package/src/src/extensions/database/database-client.ts

@@ -1,7 +1,7 @@
 /**
  * Contract interface for database clients.
  *
- * Default implementation: `@veryfront/ext-postgres`
+ * No default first-party implementation is currently shipped.
  *
  * @module extensions/database/database-client
  */

package/src/src/extensions/index.ts

@@ -77,3 +77,14 @@ export {
   EXTENSION_VALIDATION_ERROR,
   MISSING_EXTENSION_ERROR,
 } from "./errors.js";
+
+// Sandbox
+export type {
+  CreateSandboxShellToolsInput,
+  SandboxShellClient,
+  SandboxShellToolDefinition,
+  SandboxShellToolExecute,
+  SandboxShellToolSet,
+  SandboxShellToolsProvider,
+} from "./sandbox/index.js";
+export { SandboxShellToolsProviderName } from "./sandbox/index.js";

package/src/src/extensions/llm/embedding-provider.ts

@@ -1,7 +1,7 @@
 /**
  * Contract interface for text embedding providers.
  *
- * Default implementation: `@veryfront/ext-embeddings`
+ * No default first-party implementation is currently shipped.
  *
  * @module extensions/llm/embedding-provider
  */

package/src/src/extensions/recommendations.ts

@@ -9,21 +9,20 @@ const recommendations = new Map<string, string>([
   // ModuleLexer ships in the same package as Bundler (es-module-lexer +
   // esbuild are co-bundled into ext-bundler-esbuild).
   ["ModuleLexer", "@veryfront/ext-bundler-esbuild"],
-  ["CacheStore", "@veryfront/ext-cache-redis"],
   ["TokenCacheStore", "@veryfront/ext-cache-redis"],
   ["CSSProcessor", "@veryfront/ext-css-tailwind"],
-  ["ContentProcessor", "@veryfront/ext-transform-mdx"],
-  ["DatabaseClient", "@veryfront/ext-postgres"],
+  ["ContentProcessor", "@veryfront/ext-content-mdx"],
+  ["DocumentExtractor", "@veryfront/ext-document-kreuzberg"],
   ["AuthProvider", "@veryfront/ext-auth-jwt"],
   ["TracingExporter", "@veryfront/ext-tracing-opentelemetry"],
-  ["LLMProviderRegistry", "@veryfront/ext-llm-openai"],
+  ["NodeTelemetryProvider", "@veryfront/ext-tracing-opentelemetry"],
   ["LLMProvider:openai", "@veryfront/ext-llm-openai"],
   ["LLMProvider:anthropic", "@veryfront/ext-llm-anthropic"],
   ["LLMProvider:google", "@veryfront/ext-llm-google"],
-  ["EmbeddingProvider", "@veryfront/ext-embeddings"],
   ["CodeParser", "@veryfront/ext-parser-babel"],
-  ["SchemaValidator", "@veryfront/ext-zod"],
-  ["NodeCompat", "@veryfront/ext-node-compatibility"],
+  ["SchemaValidator", "@veryfront/ext-schema-zod"],
+  ["SqliteStore", "@veryfront/ext-db-sqlite"],
+  ["SandboxShellToolsProvider", "@veryfront/ext-sandbox-shell-tools"],
 ]);
 
 export function getRecommendation(contractName: string): string | undefined {

package/src/src/extensions/sandbox/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Sandbox category barrel.
+ *
+ * @module extensions/sandbox
+ */
+import "../../../_dnt.polyfills.js";
+
+
+export type {
+  CreateSandboxShellToolsInput,
+  SandboxShellClient,
+  SandboxShellToolDefinition,
+  SandboxShellToolExecute,
+  SandboxShellToolSet,
+  SandboxShellToolsProvider,
+} from "./shell-tools.js";
+
+export { SandboxShellToolsProviderName } from "./shell-tools.js";

package/src/src/extensions/sandbox/shell-tools.ts

@@ -0,0 +1,42 @@
+import type { Tool, ToolExecutionContext } from "../../tool/index.js";
+import type { JsonSchema } from "../../tool/schema/json-schema.js";
+
+export const SandboxShellToolsProviderName = "SandboxShellToolsProvider";
+
+export type SandboxShellToolExecute = {
+  bivarianceHack: (input: unknown, options?: ToolExecutionContext) => Promise<unknown> | unknown;
+}["bivarianceHack"];
+
+export type SandboxShellToolDefinition = {
+  id?: string;
+  type?: Tool["type"];
+  title?: string;
+  description?: string;
+  inputSchema?: unknown;
+  inputSchemaJson?: JsonSchema;
+  parameters?: unknown;
+  providerOptions?: unknown;
+  execute?: Tool["execute"] | SandboxShellToolExecute;
+  mcp?: Tool["mcp"];
+};
+
+export type SandboxShellToolSet = Record<string, SandboxShellToolDefinition>;
+
+export type SandboxShellClient = {
+  ensure?: () => Promise<void> | void;
+  executeCommand: (command: string, options?: unknown) => Promise<unknown>;
+  readFile?: (path: string) => Promise<unknown> | unknown;
+  writeFiles?: (files: unknown[]) => Promise<unknown> | unknown;
+};
+
+export type CreateSandboxShellToolsInput = {
+  sandbox: SandboxShellClient;
+  destination: string;
+  promptOptions: {
+    toolPrompt: string;
+  };
+};
+
+export type SandboxShellToolsProvider = (
+  input: CreateSandboxShellToolsInput,
+) => Promise<{ tools: Record<string, unknown> }>;

package/src/src/extensions/schema/schema-validator.ts

@@ -1,7 +1,7 @@
 /**
  * Contract interface for schema validation.
  *
- * Default implementation: `@veryfront/ext-zod`
+ * Default implementation: `@veryfront/ext-schema-zod`
  *
  * The interface exposes a small DSL (inspired by zod) that lets core modules
  * declare validation schemas without importing zod directly. Schemas are

package/src/src/extensions/tracing/index.ts

@@ -1,5 +1,5 @@
 /**
- * Tracing category barrel — TracingExporter contract.
+ * Tracing category barrel: tracing and Node telemetry contracts.
  *
  * @module extensions/tracing
  */
@@ -7,3 +7,11 @@ import "../../../_dnt.polyfills.js";
 
 
 export type { SpanData, TracerProvider, TracingExporter } from "./tracing-exporter.js";
+export type {
+  NodeTelemetryInitializeOptions,
+  NodeTelemetryInstrumentationConfig,
+  NodeTelemetryLogger,
+  NodeTelemetryProcessTarget,
+  NodeTelemetryProvider,
+} from "./node-telemetry-provider.js";
+export { NodeTelemetryProviderName } from "./node-telemetry-provider.js";

package/src/src/extensions/tracing/node-telemetry-provider.ts

@@ -0,0 +1,45 @@
+/**
+ * Contract interface for Node.js OpenTelemetry runtime bootstrap.
+ *
+ * Default implementation: `@veryfront/ext-tracing-opentelemetry`
+ *
+ * @module extensions/tracing/node-telemetry-provider
+ */
+
+export const NodeTelemetryProviderName = "NodeTelemetryProvider";
+
+export type NodeTelemetryInstrumentationConfig = {
+  http: boolean;
+  express: boolean;
+  fs: boolean;
+};
+
+export type NodeTelemetryLogger = {
+  info(message: string, metadata?: Record<string, unknown>): void;
+  error(message: string, metadata?: Record<string, unknown>): void;
+};
+
+export type NodeTelemetryProcessTarget = {
+  on(event: "SIGTERM", listener: () => void | Promise<void>): unknown;
+};
+
+export type NodeTelemetryInitializeOptions = {
+  serviceName: string;
+  serviceVersion: string;
+  deploymentEnvironment: string;
+  samplingRatio: number;
+  exporterHeaders?: Record<string, string>;
+  instrumentation: NodeTelemetryInstrumentationConfig;
+  logger?: NodeTelemetryLogger;
+  processTarget?: NodeTelemetryProcessTarget;
+};
+
+/**
+ * Initializes Node-specific OpenTelemetry SDK behavior.
+ *
+ * This contract covers NodeSDK and auto-instrumentation setup. It is separate
+ * from `TracingExporter`, which only exposes tracing APIs to the core shim.
+ */
+export interface NodeTelemetryProvider {
+  initialize(options: NodeTelemetryInitializeOptions): Promise<boolean>;
+}

package/src/src/html/schemas/html.schema.ts

@@ -1,4 +1,4 @@
-import { defineSchema } from "../../schemas/index.js";
+import { defineSchema, lazySchema } from "../../schemas/index.js";
 import type { InferSchema } from "../../extensions/schema/index.js";
 
 export const getColorSchemeSchema = defineSchema((v) => v.enum(["light", "dark"]));
@@ -80,9 +80,9 @@ export type HTMLGenerationOptions = InferSchema<ReturnType<typeof getHTMLGenerat
 export type HydrationData = InferSchema<ReturnType<typeof getHydrationDataSchema>>;
 
 // Backward compat aliases
-export const colorSchemeSchema = getColorSchemeSchema();
-export const environmentSchema = getEnvironmentSchema();
-export const pageTypeSchema = getPageTypeSchema();
-export const clientModuleStrategySchema = getClientModuleStrategySchema();
-export const HTMLGenerationOptionsSchema = getHTMLGenerationOptionsSchema();
-export const HydrationDataSchema = getHydrationDataSchema();
+export const colorSchemeSchema = lazySchema(getColorSchemeSchema);
+export const environmentSchema = lazySchema(getEnvironmentSchema);
+export const pageTypeSchema = lazySchema(getPageTypeSchema);
+export const clientModuleStrategySchema = lazySchema(getClientModuleStrategySchema);
+export const HTMLGenerationOptionsSchema = lazySchema(getHTMLGenerationOptionsSchema);
+export const HydrationDataSchema = lazySchema(getHydrationDataSchema);

package/src/src/integrations/schema.ts

@@ -1,4 +1,4 @@
-import { defineSchema } from "../schemas/index.js";
+import { defineSchema, lazySchema } from "../schemas/index.js";
 import type { InferSchema } from "../extensions/schema/index.js";
 
 const integrationNames = [
@@ -55,7 +55,7 @@ const integrationNames = [
 ] as const;
 
 export const getIntegrationNameSchema = defineSchema((v) => v.enum(integrationNames));
-export const IntegrationNameSchema = getIntegrationNameSchema();
+export const IntegrationNameSchema = lazySchema(getIntegrationNameSchema);
 
 export const getEnvVarSchema = defineSchema((v) =>
   v.object({
@@ -68,7 +68,7 @@ export const getEnvVarSchema = defineSchema((v) =>
     default: v.string().optional(),
   })
 );
-export const EnvVarSchema = getEnvVarSchema();
+export const EnvVarSchema = lazySchema(getEnvVarSchema);
 
 export const getOAuthFieldSchema = defineSchema((v) =>
   v.object({
@@ -80,7 +80,7 @@ export const getOAuthFieldSchema = defineSchema((v) =>
     default: v.string().optional(),
   })
 );
-export const OAuthFieldSchema = getOAuthFieldSchema();
+export const OAuthFieldSchema = lazySchema(getOAuthFieldSchema);
 
 export const getOAuthConfigSchema = defineSchema((v) =>
   v.object({
@@ -110,7 +110,7 @@ export const getOAuthConfigSchema = defineSchema((v) =>
     docsUrl: v.string().optional(),
   })
 );
-export const OAuthConfigSchema = getOAuthConfigSchema();
+export const OAuthConfigSchema = lazySchema(getOAuthConfigSchema);
 
 export const getIntegrationEndpointParamSchema = defineSchema((v) =>
   v.object({
@@ -121,7 +121,7 @@ export const getIntegrationEndpointParamSchema = defineSchema((v) =>
     default: v.unknown().optional(),
   })
 );
-export const IntegrationEndpointParamSchema = getIntegrationEndpointParamSchema();
+export const IntegrationEndpointParamSchema = lazySchema(getIntegrationEndpointParamSchema);
 
 export const getIntegrationEndpointBodyFieldSchema = defineSchema((v) =>
   v.object({
@@ -131,7 +131,7 @@ export const getIntegrationEndpointBodyFieldSchema = defineSchema((v) =>
     default: v.unknown().optional(),
   })
 );
-export const IntegrationEndpointBodyFieldSchema = getIntegrationEndpointBodyFieldSchema();
+export const IntegrationEndpointBodyFieldSchema = lazySchema(getIntegrationEndpointBodyFieldSchema);
 
 export const getIntegrationEndpointSchema = defineSchema((v) =>
   v.object({
@@ -145,7 +145,7 @@ export const getIntegrationEndpointSchema = defineSchema((v) =>
     response: v.object({ transform: v.string().optional() }).optional(),
   })
 );
-export const IntegrationEndpointSchema = getIntegrationEndpointSchema();
+export const IntegrationEndpointSchema = lazySchema(getIntegrationEndpointSchema);
 
 export const getIntegrationToolSchema = defineSchema((v) =>
   v.object({
@@ -157,7 +157,7 @@ export const getIntegrationToolSchema = defineSchema((v) =>
     endpoint: getIntegrationEndpointSchema().optional(),
   })
 );
-export const IntegrationToolSchema = getIntegrationToolSchema();
+export const IntegrationToolSchema = lazySchema(getIntegrationToolSchema);
 
 export const getIntegrationPromptSchema = defineSchema((v) =>
   v.object({
@@ -168,7 +168,7 @@ export const getIntegrationPromptSchema = defineSchema((v) =>
     icon: v.string().optional(),
   })
 );
-export const IntegrationPromptSchema = getIntegrationPromptSchema();
+export const IntegrationPromptSchema = lazySchema(getIntegrationPromptSchema);
 
 export const getIntegrationConfigSchema = defineSchema((v) =>
   v.object({
@@ -193,7 +193,7 @@ export const getIntegrationConfigSchema = defineSchema((v) =>
     category: v.string().optional(),
   })
 );
-export const IntegrationConfigSchema = getIntegrationConfigSchema();
+export const IntegrationConfigSchema = lazySchema(getIntegrationConfigSchema);
 
 export type IntegrationName = InferSchema<ReturnType<typeof getIntegrationNameSchema>>;
 export type EnvVarConfig = InferSchema<ReturnType<typeof getEnvVarSchema>>;

package/src/src/internal-agents/run-stream.ts

@@ -7,7 +7,7 @@ import {
 import { normalizeAgUiRuntimeMessages } from "../agent/ag-ui/runtime-support.js";
 import { SKILL_TOOL_IDS } from "../skill/types.js";
 import { type Tool, toolRegistry } from "../tool/index.js";
-import { defineSchema } from "../schemas/index.js";
+import { defineSchema, lazySchema } from "../schemas/index.js";
 import type { Schema } from "../extensions/schema/index.js";
 import {
   createStreamTransformState,
@@ -21,7 +21,7 @@ import type { RuntimeRunAgentInput } from "./schema.js";
 import { serverLogger } from "../utils/index.js";
 
 const getAnyObjectSchema = defineSchema((v) => v.record(v.string(), v.unknown()));
-const anyObjectSchema = getAnyObjectSchema() as Schema<Record<string, unknown>>;
+const anyObjectSchema = lazySchema(getAnyObjectSchema) as Schema<Record<string, unknown>>;
 const logger = serverLogger.component("internal-agent-run-stream");
 
 type RuntimeFilteredAgent = Agent & {

package/src/src/issues/mcp.ts

@@ -6,7 +6,7 @@
  * @module issues/mcp
  */
 
-import { defineSchema } from "../schemas/index.js";
+import { defineSchema, lazySchema } from "../schemas/index.js";
 import type { InferSchema } from "../extensions/schema/index.js";
 import { cwd } from "../platform/compat/process.js";
 import type { MCPTool } from "../mcp/types.js";
@@ -53,7 +53,7 @@ const getIssuesCreateInput = defineSchema((v) =>
     prefix: getIssuePrefixSchema().optional().describe("ID prefix: ISSUE, TASK, or PLAN"),
   }).merge(getProjectDirSchema())
 );
-const issuesCreateInput = getIssuesCreateInput();
+const issuesCreateInput = lazySchema(getIssuesCreateInput);
 
 type IssuesCreateInput = InferSchema<ReturnType<typeof getIssuesCreateInput>>;
 
@@ -87,7 +87,7 @@ const getIssuesGetInput = defineSchema((_v) =>
     id: getIssueIdSchema().describe("Issue ID (e.g., ISSUE-001, TASK-042)"),
   })
 );
-const issuesGetInput = getIssuesGetInput();
+const issuesGetInput = lazySchema(getIssuesGetInput);
 
 type IssuesGetInput = InferSchema<ReturnType<typeof getIssuesGetInput>>;
 
@@ -121,7 +121,7 @@ const getIssuesUpdateInput = defineSchema((v) =>
     assignees: v.array(v.string()).optional().describe("Assignees to set (replaces existing)"),
   }).merge(getProjectDirSchema())
 );
-const issuesUpdateInput = getIssuesUpdateInput();
+const issuesUpdateInput = lazySchema(getIssuesUpdateInput);
 
 type IssuesUpdateInput = InferSchema<ReturnType<typeof getIssuesUpdateInput>>;
 
@@ -173,7 +173,7 @@ const getIssuesListInput = defineSchema((v) =>
     limit: v.number().optional().describe("Maximum results"),
   }).merge(getProjectDirSchema())
 );
-const issuesListInput = getIssuesListInput();
+const issuesListInput = lazySchema(getIssuesListInput);
 
 type IssuesListInput = InferSchema<ReturnType<typeof getIssuesListInput>>;
 
@@ -213,7 +213,7 @@ const getIssuesCloseInput = defineSchema((_v) =>
     id: getIssueIdSchema().describe("Issue ID to close"),
   })
 );
-const issuesCloseInput = getIssuesCloseInput();
+const issuesCloseInput = lazySchema(getIssuesCloseInput);
 
 type IssuesCloseInput = InferSchema<ReturnType<typeof getIssuesCloseInput>>;
 
@@ -244,7 +244,7 @@ const getIssuesDeleteInput = defineSchema((_v) =>
     id: getIssueIdSchema().describe("Issue ID to delete"),
   })
 );
-const issuesDeleteInput = getIssuesDeleteInput();
+const issuesDeleteInput = lazySchema(getIssuesDeleteInput);
 
 type IssuesDeleteInput = InferSchema<ReturnType<typeof getIssuesDeleteInput>>;
 

package/src/src/issues/schemas/issue.schema.ts

@@ -1,4 +1,4 @@
-import { defineSchema } from "../../schemas/index.js";
+import { defineSchema, lazySchema } from "../../schemas/index.js";
 import type { InferSchema } from "../../extensions/schema/index.js";
 
 export const ISSUE_PREFIXES = ["ISSUE", "TASK", "PLAN"] as const;
@@ -7,25 +7,25 @@ const ISSUE_ID_BODY = `(${ISSUE_PREFIXES.join("|")})-(\\d{3,})`;
 export const ISSUE_ID_PATTERN = new RegExp(`^${ISSUE_ID_BODY}$`);
 
 export const getIssueStateSchema = defineSchema((v) => v.enum(["open", "closed"]));
-export const issueStateSchema = getIssueStateSchema();
+export const issueStateSchema = lazySchema(getIssueStateSchema);
 
 export const getIssuePrefixSchema = defineSchema((v) => v.enum(ISSUE_PREFIXES));
-export const issuePrefixSchema = getIssuePrefixSchema();
+export const issuePrefixSchema = lazySchema(getIssuePrefixSchema);
 
 export const getIssueIdSchema = defineSchema((v) =>
   v.string()
     .regex(ISSUE_ID_PATTERN, "Issue ID must be in format PREFIX-NNN (e.g., ISSUE-001, TASK-042)")
 );
-export const issueIdSchema = getIssueIdSchema();
+export const issueIdSchema = lazySchema(getIssueIdSchema);
 
 export const getLabelSchema = defineSchema((v) => v.string().min(1).max(50));
-export const labelSchema = getLabelSchema();
+export const labelSchema = lazySchema(getLabelSchema);
 
 export const getIsoDateSchema = defineSchema((v) =>
   v.string()
     .refine((val: string) => !Number.isNaN(Date.parse(val)), "Must be a valid ISO 8601 date string")
 );
-export const isoDateSchema = getIsoDateSchema();
+export const isoDateSchema = lazySchema(getIsoDateSchema);
 
 export const getIssueMetadataSchema = defineSchema((v) =>
   v.object({
@@ -39,7 +39,7 @@ export const getIssueMetadataSchema = defineSchema((v) =>
     updated_at: getIsoDateSchema(),
   })
 );
-export const issueMetadataSchema = getIssueMetadataSchema();
+export const issueMetadataSchema = lazySchema(getIssueMetadataSchema);
 
 export const getIssueSchema = defineSchema((v) =>
   v.object({
@@ -48,7 +48,7 @@ export const getIssueSchema = defineSchema((v) =>
     path: v.string(),
   })
 );
-export const issueSchema = getIssueSchema();
+export const issueSchema = lazySchema(getIssueSchema);
 
 export const getCreateIssueSchema = defineSchema((v) =>
   v.object({
@@ -60,7 +60,7 @@ export const getCreateIssueSchema = defineSchema((v) =>
     prefix: getIssuePrefixSchema().optional(),
   })
 );
-export const createIssueSchema = getCreateIssueSchema();
+export const createIssueSchema = lazySchema(getCreateIssueSchema);
 
 export const getUpdateIssueSchema = defineSchema((v) =>
   v.object({
@@ -72,7 +72,7 @@ export const getUpdateIssueSchema = defineSchema((v) =>
     assignees: v.array(v.string()).optional(),
   })
 );
-export const updateIssueSchema = getUpdateIssueSchema();
+export const updateIssueSchema = lazySchema(getUpdateIssueSchema);
 
 export const getListIssuesSchema = defineSchema((v) =>
   v.object({
@@ -86,7 +86,7 @@ export const getListIssuesSchema = defineSchema((v) =>
     limit: v.number().positive().optional(),
   })
 );
-export const listIssuesSchema = getListIssuesSchema();
+export const listIssuesSchema = lazySchema(getListIssuesSchema);
 
 export const getListIssuesResultSchema = defineSchema((v) =>
   v.object({
@@ -94,7 +94,7 @@ export const getListIssuesResultSchema = defineSchema((v) =>
     total: v.number(),
   })
 );
-export const listIssuesResultSchema = getListIssuesResultSchema();
+export const listIssuesResultSchema = lazySchema(getListIssuesResultSchema);
 
 // Inferred types
 export type IssueState = InferSchema<ReturnType<typeof getIssueStateSchema>>;