@qulib/core 0.2.1 → 0.3.0

package/dist/schemas/cost-intelligence.schema.d.ts

@@ -0,0 +1,229 @@
+import { z } from 'zod';
+export declare const LlmDataQualitySchema: z.ZodEnum<["actual", "estimated", "mixed", "none"]>;
+export declare const LlmOperationTypeSchema: z.ZodEnum<["scenario-generation"]>;
+export declare const LlmUsageRecordSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+    operationType: z.ZodEnum<["scenario-generation"]>;
+    timestamp: z.ZodString;
+    promptHash: z.ZodOptional<z.ZodString>;
+    resultHash: z.ZodOptional<z.ZodString>;
+    dataQuality: z.ZodEnum<["actual", "estimated", "mixed", "none"]>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    operationType: "scenario-generation";
+    timestamp: string;
+    dataQuality: "none" | "actual" | "estimated" | "mixed";
+    estimatedCostUsd?: number | undefined;
+    promptHash?: string | undefined;
+    resultHash?: string | undefined;
+    notes?: string | undefined;
+}, {
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    operationType: "scenario-generation";
+    timestamp: string;
+    dataQuality: "none" | "actual" | "estimated" | "mixed";
+    estimatedCostUsd?: number | undefined;
+    promptHash?: string | undefined;
+    resultHash?: string | undefined;
+    notes?: string | undefined;
+}>;
+export declare const RepeatedAiPatternSchema: z.ZodObject<{
+    promptHash: z.ZodString;
+    count: z.ZodNumber;
+    recommendation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    recommendation: string;
+    promptHash: string;
+    count: number;
+}, {
+    recommendation: string;
+    promptHash: string;
+    count: number;
+}>;
+export declare const DeterministicMaturitySchema: z.ZodObject<{
+    level: z.ZodNumber;
+    label: z.ZodString;
+    rationale: z.ZodString;
+    ceilingNote: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    level: number;
+    rationale: string;
+    ceilingNote?: string | undefined;
+}, {
+    label: string;
+    level: number;
+    rationale: string;
+    ceilingNote?: string | undefined;
+}>;
+export declare const CostIntelligenceSchema: z.ZodObject<{
+    maxOutputTokensPerLlmCall: z.ZodNumber;
+    budgetRole: z.ZodLiteral<"max-output-tokens-per-llm-call">;
+    records: z.ZodArray<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+        operationType: z.ZodEnum<["scenario-generation"]>;
+        timestamp: z.ZodString;
+        promptHash: z.ZodOptional<z.ZodString>;
+        resultHash: z.ZodOptional<z.ZodString>;
+        dataQuality: z.ZodEnum<["actual", "estimated", "mixed", "none"]>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        operationType: "scenario-generation";
+        timestamp: string;
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        estimatedCostUsd?: number | undefined;
+        promptHash?: string | undefined;
+        resultHash?: string | undefined;
+        notes?: string | undefined;
+    }, {
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        operationType: "scenario-generation";
+        timestamp: string;
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        estimatedCostUsd?: number | undefined;
+        promptHash?: string | undefined;
+        resultHash?: string | undefined;
+        notes?: string | undefined;
+    }>, "many">;
+    budgetWarnings: z.ZodArray<z.ZodString, "many">;
+    usageSummary: z.ZodObject<{
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        dataQuality: z.ZodEnum<["actual", "estimated", "mixed", "none"]>;
+    }, "strip", z.ZodTypeAny, {
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        totalInputTokens: number;
+        totalOutputTokens: number;
+    }, {
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        totalInputTokens: number;
+        totalOutputTokens: number;
+    }>;
+    repeatedOperations: z.ZodArray<z.ZodObject<{
+        promptHash: z.ZodString;
+        count: z.ZodNumber;
+        recommendation: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        recommendation: string;
+        promptHash: string;
+        count: number;
+    }, {
+        recommendation: string;
+        promptHash: string;
+        count: number;
+    }>, "many">;
+    deterministicMaturity: z.ZodObject<{
+        level: z.ZodNumber;
+        label: z.ZodString;
+        rationale: z.ZodString;
+        ceilingNote: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        level: number;
+        rationale: string;
+        ceilingNote?: string | undefined;
+    }, {
+        label: string;
+        level: number;
+        rationale: string;
+        ceilingNote?: string | undefined;
+    }>;
+    conversionRecommendations: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    maxOutputTokensPerLlmCall: number;
+    budgetRole: "max-output-tokens-per-llm-call";
+    records: {
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        operationType: "scenario-generation";
+        timestamp: string;
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        estimatedCostUsd?: number | undefined;
+        promptHash?: string | undefined;
+        resultHash?: string | undefined;
+        notes?: string | undefined;
+    }[];
+    budgetWarnings: string[];
+    usageSummary: {
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        totalInputTokens: number;
+        totalOutputTokens: number;
+    };
+    repeatedOperations: {
+        recommendation: string;
+        promptHash: string;
+        count: number;
+    }[];
+    deterministicMaturity: {
+        label: string;
+        level: number;
+        rationale: string;
+        ceilingNote?: string | undefined;
+    };
+    conversionRecommendations: string[];
+}, {
+    maxOutputTokensPerLlmCall: number;
+    budgetRole: "max-output-tokens-per-llm-call";
+    records: {
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        operationType: "scenario-generation";
+        timestamp: string;
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        estimatedCostUsd?: number | undefined;
+        promptHash?: string | undefined;
+        resultHash?: string | undefined;
+        notes?: string | undefined;
+    }[];
+    budgetWarnings: string[];
+    usageSummary: {
+        dataQuality: "none" | "actual" | "estimated" | "mixed";
+        totalInputTokens: number;
+        totalOutputTokens: number;
+    };
+    repeatedOperations: {
+        recommendation: string;
+        promptHash: string;
+        count: number;
+    }[];
+    deterministicMaturity: {
+        label: string;
+        level: number;
+        rationale: string;
+        ceilingNote?: string | undefined;
+    };
+    conversionRecommendations: string[];
+}>;
+export type LlmDataQuality = z.infer<typeof LlmDataQualitySchema>;
+export type LlmOperationType = z.infer<typeof LlmOperationTypeSchema>;
+export type LlmUsageRecord = z.infer<typeof LlmUsageRecordSchema>;
+export type RepeatedAiPattern = z.infer<typeof RepeatedAiPatternSchema>;
+export type DeterministicMaturity = z.infer<typeof DeterministicMaturitySchema>;
+export type CostIntelligence = z.infer<typeof CostIntelligenceSchema>;
+//# sourceMappingURL=cost-intelligence.schema.d.ts.map

package/dist/schemas/cost-intelligence.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-intelligence.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/cost-intelligence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB,qDAAmD,CAAC;AAErF,eAAO,MAAM,sBAAsB,oCAAkC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAKtC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAajC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/cost-intelligence.schema.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export const LlmDataQualitySchema = z.enum(['actual', 'estimated', 'mixed', 'none']);
+export const LlmOperationTypeSchema = z.enum(['scenario-generation']);
+export const LlmUsageRecordSchema = z.object({
+    provider: z.string(),
+    model: z.string(),
+    inputTokens: z.number().int().min(0),
+    outputTokens: z.number().int().min(0),
+    estimatedCostUsd: z.number().optional(),
+    operationType: LlmOperationTypeSchema,
+    timestamp: z.string().datetime(),
+    promptHash: z.string().optional(),
+    resultHash: z.string().optional(),
+    dataQuality: LlmDataQualitySchema,
+    notes: z.string().optional(),
+});
+export const RepeatedAiPatternSchema = z.object({
+    promptHash: z.string(),
+    count: z.number().int().min(2),
+    recommendation: z.string(),
+});
+export const DeterministicMaturitySchema = z.object({
+    level: z.number().int().min(0).max(5),
+    label: z.string(),
+    rationale: z.string(),
+    ceilingNote: z.string().optional(),
+});
+export const CostIntelligenceSchema = z.object({
+    maxOutputTokensPerLlmCall: z.number().int().positive(),
+    budgetRole: z.literal('max-output-tokens-per-llm-call'),
+    records: z.array(LlmUsageRecordSchema),
+    budgetWarnings: z.array(z.string()),
+    usageSummary: z.object({
+        totalInputTokens: z.number().int().min(0),
+        totalOutputTokens: z.number().int().min(0),
+        dataQuality: LlmDataQualitySchema,
+    }),
+    repeatedOperations: z.array(RepeatedAiPatternSchema),
+    deterministicMaturity: DeterministicMaturitySchema,
+    conversionRecommendations: z.array(z.string()),
+});

package/dist/schemas/decision-log.schema.d.ts

@@ -6,14 +6,14 @@ export declare const DecisionLogEntrySchema: z.ZodObject<{
     reason: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    reason: string;
     timestamp: string;
+    reason: string;
     phase: "observe" | "think" | "act" | "harness";
     decision: string;
     metadata?: Record<string, unknown> | undefined;
 }, {
-    reason: string;
     timestamp: string;
+    reason: string;
     phase: "observe" | "think" | "act" | "harness";
     decision: string;
     metadata?: Record<string, unknown> | undefined;