jev-recipes 0.2.0 → 0.4.0

package/dist/examples/support/workflow.d.ts

@@ -1,3 +0,0 @@
-import type { RecipeOptions } from '../../src/schema.js';
-import type { SupportInput, SupportDraftContext, SupportDraft, SupportResult } from './schema.js';
-export declare function answerSupportRequest(input: SupportInput, draftAnswer: (context: SupportDraftContext) => Promise<SupportDraft>, options?: RecipeOptions): Promise<SupportResult>;

package/dist/examples/support/workflow.js

@@ -1,85 +0,0 @@
-import { handoff } from '../../recipes/handoff/index.js';
-import { clarify } from '../../recipes/clarify/index.js';
-import { route } from '../../recipes/route/index.js';
-import { rerank } from '../../recipes/rerank/index.js';
-import { answerability } from '../../recipes/answerability/index.js';
-import { verify } from '../../recipes/verify/index.js';
-import { supportInputSchema, supportDraftSchema } from './schema.js';
-export async function answerSupportRequest(input, draftAnswer, options = {}) {
-    const request = supportInputSchema.parse(input);
-    const { minConfidence = 0.8, minRelevance = 0.5, topK = 5 } = request;
-    const context = request.context ?? '';
-    const decisions = {};
-    decisions.handoff = await handoff({
-        request: request.request,
-        ...(context ? { context } : {}),
-        rules: request.handoffRules,
-        minConfidence,
-    }, options);
-    if (decisions.handoff.decision !== 'continue') {
-        return { outcome: decisions.handoff.decision, stage: 'handoff', decisions };
-    }
-    decisions.clarify = await clarify({
-        request: request.request,
-        ...(context ? { context } : {}),
-        requirements: request.requirements,
-        minConfidence,
-    }, options);
-    if (!decisions.clarify.canProceed) {
-        return {
-            outcome: decisions.clarify.status === 'review' ? 'review' : 'clarification',
-            stage: 'clarify',
-            decisions,
-        };
-    }
-    const question = context
-        ? `${request.request}\n\nConversation context:\n${context}`
-        : request.request;
-    decisions.route = await route({ request: question, routes: request.routes, minConfidence }, options);
-    if (decisions.route.route === null)
-        return { outcome: 'review', stage: 'route', decisions };
-    if (request.evidence.length === 0)
-        return { outcome: 'no_evidence', stage: 'rerank', decisions };
-    decisions.rerank = await rerank({ query: question, items: request.evidence, minRelevance, topK }, options);
-    if (decisions.rerank.items.length === 0)
-        return { outcome: 'no_evidence', stage: 'rerank', decisions };
-    const evidence = decisions.rerank.items.map(({ id, text }) => ({ id, text }));
-    decisions.answerability = await answerability({ question, evidence, minConfidence }, options);
-    if (!decisions.answerability.canAnswer) {
-        return {
-            outcome: decisions.answerability.status === 'review' ? 'review' : 'cannot_answer',
-            stage: 'answerability',
-            decisions,
-        };
-    }
-    const draftContext = {
-        request: request.request,
-        ...(context ? { context } : {}),
-        route: decisions.route.route,
-        evidence,
-    };
-    const draft = validateDraftEvidence(await draftAnswer(draftContext), evidence);
-    decisions.verify = await verify({ claims: pairClaimsWithEvidence(draft, evidence), minConfidence }, options);
-    if (!decisions.verify.allSupported)
-        return { outcome: 'unverified', stage: 'verify', decisions };
-    return {
-        outcome: 'answered',
-        answer: draft.claims.map((claim) => claim.claim).join('\n\n'),
-        draft,
-        decisions,
-    };
-}
-function validateDraftEvidence(draft, evidence) {
-    const selectedIds = new Set(evidence.map((item) => item.id));
-    return supportDraftSchema
-        .refine((candidate) => candidate.claims.every((claim) => claim.evidenceIds.every((id) => selectedIds.has(id))), 'Draft claims may reference only selected evidence IDs.')
-        .parse(draft);
-}
-function pairClaimsWithEvidence(draft, evidence) {
-    const evidenceById = new Map(evidence.map((item) => [item.id, item.text]));
-    return draft.claims.map(({ id, claim, evidenceIds }) => ({
-        id,
-        claim,
-        evidence: evidenceIds.map((evidenceId) => evidenceById.get(evidenceId)).join('\n\n'),
-    }));
-}

package/dist/recipes/action-scope/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "workflow";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/action-scope/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'action-scope',
-    title: 'Check proposed action scope',
-    description: 'Is proposedAction within the work requested in request and constraints?',
-    category: 'workflow',
-    tags: ['workflow', 'action', 'scope'],
-    limitations: [
-        'Assesses semantic scope only. User authorization and access controls must be enforced by the application.',
-    ],
-};

package/dist/recipes/answer-consistency/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/answer-consistency/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'answer-consistency',
-    title: 'Check answer consistency',
-    description: 'Do firstStatement and secondStatement make compatible claims about the same subject and circumstances?',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'answer', 'consistency', 'rag', 'evidence'],
-    limitations: [
-        'Checks semantic consistency between two statements. Exact numeric and date comparisons belong in code.',
-    ],
-};

package/dist/recipes/answer-coverage/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/answer-coverage/metadata.js

@@ -1,11 +0,0 @@
-export const metadata = {
-    id: 'answer-coverage',
-    title: 'Check answer coverage',
-    description: 'Check whether a draft answers each supplied question.',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'answer', 'coverage', 'rag', 'evidence'],
-    limitations: [
-        'Checks supplied question IDs only. It does not extract questions or verify the draft against sources.',
-        'Supply 1 to 50 items per list, each with a unique non-empty ID and non-empty text.',
-    ],
-};

package/dist/recipes/answer-invalidation/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "knowledge";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/answer-invalidation/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'answer-invalidation',
-    title: 'Check an answer after a source change',
-    description: 'Does updatedEvidence still support the entire claim that was based on previousEvidence?',
-    category: 'knowledge',
-    tags: ['knowledge', 'answer', 'invalidation'],
-    limitations: [
-        'Assesses one supplied claim and source revision. It does not monitor changes, compare release dates, or invalidate a cache automatically.',
-    ],
-};

package/dist/recipes/answer-relevance/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/answer-relevance/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'answer-relevance',
-    title: 'Check answer relevance',
-    description: 'How directly does draft address request?',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'answer', 'relevance', 'rag', 'evidence'],
-    limitations: [
-        'Relevance does not establish correctness or complete coverage. Use answer-coverage and verify for those decisions.',
-    ],
-};

package/dist/recipes/answerability/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "retrieval";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/answerability/metadata.js

@@ -1,11 +0,0 @@
-export const metadata = {
-    id: 'answerability',
-    title: 'Check answerability',
-    description: 'Decide whether supplied evidence can answer an entire question.',
-    category: 'retrieval',
-    tags: ['rag', 'abstention', 'evidence'],
-    limitations: [
-        'Does not generate an answer or establish source truth.',
-        'Provide 1 to 50 evidence passages with unique IDs; handle empty retrieval in application code.',
-    ],
-};

package/dist/recipes/argument-fit/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "workflow";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/argument-fit/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'argument-fit',
-    title: 'Check argument meaning',
-    description: 'Does proposedValue for argument express the intended value in request and context?',
-    category: 'workflow',
-    tags: ['workflow', 'argument', 'fit'],
-    limitations: [
-        'Does not validate schemas, compare identifiers, or enforce authorization. Check those deterministically before acting.',
-    ],
-};

package/dist/recipes/attempted-step/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "support";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/attempted-step/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'attempted-step',
-    title: 'Check a previously attempted step',
-    description: 'Does conversation establish whether the customer already performed step?',
-    category: 'support',
-    tags: ['support', 'attempted', 'step'],
-    limitations: [
-        'Interprets reports of an attempt. It does not verify that the step was completed correctly or repeat the action.',
-    ],
-};

package/dist/recipes/audience-fit/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "knowledge";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/audience-fit/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'audience-fit',
-    title: 'Check audience fit',
-    description: 'Does the level of explanation in document fit the knowledge and needs explicitly described in audience?',
-    category: 'knowledge',
-    tags: ['knowledge', 'audience', 'fit'],
-    limitations: [
-        'Uses only the supplied audience description. It does not infer ability from identity or rewrite the document.',
-    ],
-};

package/dist/recipes/cache-match/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "retrieval";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/cache-match/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'cache-match',
-    title: 'Check a cached answer',
-    description: 'Does cachedAnswer address question with the same relevant meaning and conditions as originalQuestion?',
-    category: 'retrieval',
-    tags: ['retrieval', 'cache', 'match', 'rag', 'evidence'],
-    limitations: [
-        'Enforce tenant, permissions, version, and freshness checks in code before calling. A semantic match does not verify the cached answer.',
-    ],
-};

package/dist/recipes/cancellation-check/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "conversation";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/cancellation-check/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'cancellation-check',
-    title: 'Check cancellation intent',
-    description: 'Does message ask to cancel, pause, or continue task?',
-    category: 'conversation',
-    tags: ['conversation', 'cancellation', 'check'],
-    limitations: [
-        'Does not stop running work or infer permission to continue from silence. The caller applies the decision.',
-    ],
-};

package/dist/recipes/certainty-match/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/certainty-match/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'certainty-match',
-    title: 'Check certainty wording',
-    description: 'Does the certainty expressed in draft match assessment?',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'certainty', 'match', 'rag', 'evidence'],
-    limitations: [
-        'Compares wording with a supplied assessment. It does not calibrate probabilities or establish the assessment itself.',
-    ],
-};

package/dist/recipes/change-meaning/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "knowledge";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/change-meaning/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'change-meaning',
-    title: 'Assess a text revision',
-    description: 'Does the revision from before to after change material meaning, conditions, or obligations?',
-    category: 'knowledge',
-    tags: ['knowledge', 'change', 'meaning'],
-    limitations: [
-        'Compares supplied passages. It does not parse a repository diff or perform exact numeric and date comparisons.',
-    ],
-};

package/dist/recipes/citation-match/metadata.d.ts

@@ -1,9 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-    uses: string[];
-};

package/dist/recipes/citation-match/metadata.js

@@ -1,12 +0,0 @@
-export const metadata = {
-    id: 'citation-match',
-    title: 'Match claims to citations',
-    description: 'Find supplied passages that independently support an entire claim.',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'citation', 'match', 'rag', 'evidence'],
-    limitations: [
-        'Returns passages that independently support the entire claim. Joint support across several individually incomplete passages is not assessed.',
-        'Supply 1 to 50 items per list, each with a unique non-empty ID and non-empty text.',
-    ],
-    uses: ['verify'],
-};

package/dist/recipes/citation-needed/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/citation-needed/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'citation-needed',
-    title: 'Check citation requirements',
-    description: 'Do citationRules require evidence for statement?',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'citation', 'needed', 'rag', 'evidence'],
-    limitations: [
-        'Assesses a supplied citation policy; does not find sources or determine whether a statement is true.',
-    ],
-};

package/dist/recipes/clarify/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "conversation";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/clarify/metadata.js

@@ -1,11 +0,0 @@
-export const metadata = {
-    id: 'clarify',
-    title: 'Check required information',
-    description: 'Identify missing or ambiguous information before proceeding.',
-    category: 'conversation',
-    tags: ['requirements', 'ambiguity', 'clarification'],
-    limitations: [
-        'Checks only the requirements you supply; does not generate follow-up questions.',
-        'Provide 1 to 50 requirements with unique IDs.',
-    ],
-};

package/dist/recipes/confirmation-match/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "conversation";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/confirmation-match/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'confirmation-match',
-    title: 'Interpret a confirmation',
-    description: 'Does response clearly agree to or reject this exact proposal?',
-    category: 'conversation',
-    tags: ['conversation', 'confirmation', 'match'],
-    limitations: [
-        'Interprets language only. Approval identity, authority, scope, expiration, and action permissions remain application checks.',
-    ],
-};

package/dist/recipes/context-role/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "retrieval";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/context-role/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'context-role',
-    title: 'Identify a passage role',
-    description: 'What role does passage play in answering question?',
-    category: 'retrieval',
-    tags: ['retrieval', 'context', 'role', 'rag', 'evidence'],
-    limitations: [
-        'Classifies a passage contribution. It does not rank sources or prove the answer is supported.',
-    ],
-};

package/dist/recipes/correction-target/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "conversation";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/correction-target/metadata.js

@@ -1,11 +0,0 @@
-export const metadata = {
-    id: 'correction-target',
-    title: 'Locate a correction target',
-    description: 'Which supplied field or statement is message correcting?',
-    category: 'conversation',
-    tags: ['conversation', 'correction', 'target'],
-    limitations: [
-        'Selects one correction target. It does not extract a replacement value or update a record.',
-        'Supply 1 to 50 items per list, each with a unique non-empty ID and non-empty text.',
-    ],
-};

package/dist/recipes/document-role/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "knowledge";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/document-role/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'document-role',
-    title: 'Identify document purpose',
-    description: 'What is the primary purpose of document?',
-    category: 'knowledge',
-    tags: ['knowledge', 'document', 'role'],
-    limitations: [
-        'Returns one primary role from the supplied text. It does not read files, split mixed documents, or create an index.',
-    ],
-};

package/dist/recipes/draft-compare/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "answer-quality";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/draft-compare/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'draft-compare',
-    title: 'Compare two drafts',
-    description: 'Which draft better satisfies request under rubric?',
-    category: 'answer-quality',
-    tags: ['answer-quality', 'draft', 'compare', 'rag', 'evidence'],
-    limitations: [
-        'Makes a relative judgment against your rubric. A preferred draft can still contain unsupported facts.',
-    ],
-};

package/dist/recipes/evidence-conflict/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "retrieval";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/evidence-conflict/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'evidence-conflict',
-    title: 'Compare evidence for conflicts',
-    description: 'Do firstPassage and secondPassage give incompatible evidence relevant to question under the same conditions?',
-    category: 'retrieval',
-    tags: ['retrieval', 'evidence', 'conflict', 'rag'],
-    limitations: [
-        'Does not decide which source is authoritative. Exact numbers, timestamps, and version ordering should be compared in code.',
-    ],
-};

package/dist/recipes/evidence-novelty/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "retrieval";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/evidence-novelty/metadata.js

@@ -1,11 +0,0 @@
-export const metadata = {
-    id: 'evidence-novelty',
-    title: 'Check new evidence',
-    description: 'Does passage add material information relevant to question beyond existingEvidence?',
-    category: 'retrieval',
-    tags: ['retrieval', 'evidence', 'novelty', 'rag'],
-    limitations: [
-        'Assesses novelty within the supplied set. It does not establish correctness or decide when retrieval must stop.',
-        'Supply 1 to 50 items per list, each with a unique non-empty ID and non-empty text.',
-    ],
-};

package/dist/recipes/fact-stability/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "memory";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/fact-stability/metadata.js

@@ -1,10 +0,0 @@
-export const metadata = {
-    id: 'fact-stability',
-    title: 'Assess fact stability',
-    description: 'Is fact about an enduring or historical attribute, or a state that is expected to change?',
-    category: 'memory',
-    tags: ['memory', 'fact', 'stability'],
-    limitations: [
-        'Does not establish truth, expiration times, or freshness. Refresh policies and timestamp comparisons belong in code.',
-    ],
-};

package/dist/recipes/failure-kind/metadata.d.ts

@@ -1,8 +0,0 @@
-export declare const metadata: {
-    id: string;
-    title: string;
-    description: string;
-    category: "workflow";
-    tags: string[];
-    limitations: string[];
-};

package/dist/recipes/failure-kind/metadata.js

@@ -1,11 +0,0 @@
-export const metadata = {
-    id: 'failure-kind',
-    title: 'Classify a described failure',
-    description: 'Which supplied category best describes the observed failure?',
-    category: 'workflow',
-    tags: ['workflow', 'failure', 'kind'],
-    limitations: [
-        'Maps text to your categories. Use structured error codes first; this recipe does not diagnose a root cause or initiate retries.',
-        'Supply 1 to 50 items per list, each with a unique non-empty ID and non-empty text.',
-    ],
-};