@planningo/duul 1.0.0

package/build/schemas/common.d.ts

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+export declare const ArtifactRefSchema: z.ZodObject<{
+    path: z.ZodString;
+    reason: z.ZodString;
+    priority: z.ZodEnum<["high", "medium", "low"]>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    reason: string;
+    priority: "high" | "medium" | "low";
+}, {
+    path: string;
+    reason: string;
+    priority: "high" | "medium" | "low";
+}>;
+export type ArtifactRef = z.infer<typeof ArtifactRefSchema>;
+/**
+ * Reviewer config schema — shared across all review tools.
+ * Allows per-request override of provider, model, and generation parameters.
+ */
+export declare const ReviewerConfigSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodEnum<["openai", "anthropic", "google", "openrouter", "compatible"]>>;
+    model: z.ZodOptional<z.ZodString>;
+    base_url: z.ZodOptional<z.ZodString>;
+    api_key: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    top_p: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    provider?: "openai" | "anthropic" | "google" | "openrouter" | "compatible" | undefined;
+    model?: string | undefined;
+    base_url?: string | undefined;
+    api_key?: string | undefined;
+    temperature?: number | undefined;
+    top_p?: number | undefined;
+}, {
+    provider?: "openai" | "anthropic" | "google" | "openrouter" | "compatible" | undefined;
+    model?: string | undefined;
+    base_url?: string | undefined;
+    api_key?: string | undefined;
+    temperature?: number | undefined;
+    top_p?: number | undefined;
+}>;
+export type ReviewerConfig = z.infer<typeof ReviewerConfigSchema>;
+/**
+ * Iteration tracking fields — added to MCP output (not sent to the reviewer model).
+ */
+export declare const IterationMetaOutputSchema: z.ZodObject<{
+    iteration_count: z.ZodNumber;
+    iteration_limit: z.ZodNumber;
+    iteration_limit_reached: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    iteration_count: number;
+    iteration_limit: number;
+    iteration_limit_reached: boolean;
+}, {
+    iteration_count: number;
+    iteration_limit: number;
+    iteration_limit_reached: boolean;
+}>;
+/**
+ * Token usage fields — added to MCP output for cost/usage tracking.
+ */
+export declare const TokenUsageOutputSchema: z.ZodObject<{
+    token_usage: z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+        api_calls: z.ZodNumber;
+        provider: z.ZodString;
+        model: z.ZodString;
+        estimated_cost_usd: z.ZodNullable<z.ZodNumber>;
+        cached_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        model: string;
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        api_calls: number;
+        estimated_cost_usd: number | null;
+        cached_input_tokens?: number | undefined;
+        cache_creation_input_tokens?: number | undefined;
+    }, {
+        provider: string;
+        model: string;
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        api_calls: number;
+        estimated_cost_usd: number | null;
+        cached_input_tokens?: number | undefined;
+        cache_creation_input_tokens?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    token_usage: {
+        provider: string;
+        model: string;
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        api_calls: number;
+        estimated_cost_usd: number | null;
+        cached_input_tokens?: number | undefined;
+        cache_creation_input_tokens?: number | undefined;
+    };
+}, {
+    token_usage: {
+        provider: string;
+        model: string;
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        api_calls: number;
+        estimated_cost_usd: number | null;
+        cached_input_tokens?: number | undefined;
+        cache_creation_input_tokens?: number | undefined;
+    };
+}>;

package/build/schemas/common.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+export const ArtifactRefSchema = z.object({
+    path: z.string().describe('File path relative to workspace root'),
+    reason: z.string().describe('Why this file is relevant to the review'),
+    priority: z.enum(['high', 'medium', 'low']).describe('Review priority level'),
+});
+/**
+ * Reviewer config schema — shared across all review tools.
+ * Allows per-request override of provider, model, and generation parameters.
+ */
+export const ReviewerConfigSchema = z.object({
+    provider: z
+        .enum(['openai', 'anthropic', 'google', 'openrouter', 'compatible'])
+        .optional()
+        .describe('Review provider. Default: env REVIEW_PROVIDER or "openai".'),
+    model: z
+        .string()
+        .optional()
+        .describe('Model to use. Default: env REVIEW_MODEL or provider default.'),
+    base_url: z
+        .string()
+        .optional()
+        .describe('Custom API base URL (for compatible/self-hosted providers).'),
+    api_key: z
+        .string()
+        .optional()
+        .describe('Per-request API key. Overrides env-based key resolution. Useful for compatible/self-hosted providers.'),
+    temperature: z
+        .number()
+        .min(0)
+        .max(2)
+        .optional()
+        .describe('Sampling temperature override. Default: 0.2.'),
+    top_p: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Top-p override. Default: 0.1.'),
+}).describe('Per-request reviewer configuration override.');
+/**
+ * Iteration tracking fields — added to MCP output (not sent to the reviewer model).
+ */
+export const IterationMetaOutputSchema = z.object({
+    iteration_count: z.number().describe('Current iteration number (1-based) as reported by the caller.'),
+    iteration_limit: z.number().describe('Maximum iterations allowed for this phase.'),
+    iteration_limit_reached: z.boolean().describe('Whether the iteration limit has been reached.'),
+});
+/**
+ * Token usage fields — added to MCP output for cost/usage tracking.
+ */
+export const TokenUsageOutputSchema = z.object({
+    token_usage: z.object({
+        input_tokens: z.number().describe('Total input tokens consumed by the reviewer'),
+        output_tokens: z.number().describe('Total output tokens generated by the reviewer'),
+        total_tokens: z.number().describe('Sum of input + output tokens'),
+        api_calls: z.number().describe('Number of API calls made (1 + tool loop rounds)'),
+        provider: z.string().describe('Provider used (openai, anthropic, google, etc.)'),
+        model: z.string().describe('Model used for the review'),
+        estimated_cost_usd: z.number().nullable().describe('Estimated cost in USD based on model pricing (null if pricing unknown)'),
+        cached_input_tokens: z.number().optional().describe('Input tokens served from the provider prompt cache (billed at ~0.1× input).'),
+        cache_creation_input_tokens: z.number().optional().describe('Input tokens written to the provider prompt cache (Anthropic only; billed at ~1.25× input).'),
+    }).describe('Token usage and estimated cost for this review call'),
+});