@juspay/neurolink 11.13.0 → 11.13.2

package/dist/lib/agent/prompts/routingPrompts.d.ts

@@ -1,63 +0,0 @@
-/**
- * Routing Prompts for Agent Network
- *
- * These prompts guide the routing agent in selecting the appropriate
- * primitive (agent, workflow, or tool) for a given task.
- */
-import type { Primitive, AgentRoutingDecision } from "../../types/index.js";
-/**
- * Prompt templates for routing decisions
- */
-export declare const ROUTING_PROMPTS: {
-    /**
-     * System instructions for the routing agent
-     */
-    SYSTEM_INSTRUCTIONS: string;
-    /**
-     * Template for task analysis and routing
-     */
-    TASK_ROUTING: string;
-    /**
-     * Template for confidence evaluation
-     */
-    CONFIDENCE_EVALUATION: string;
-    /**
-     * Template for multi-step planning
-     */
-    MULTI_STEP_PLANNING: string;
-};
-/**
- * Build a routing prompt with primitives and task
- *
- * @param task - The task to route
- * @param primitives - Available primitives
- * @param options - Additional options
- * @returns The formatted prompt
- */
-export declare function buildRoutingPrompt(task: string, primitives: Primitive[], options?: {
-    includeAlternatives?: boolean;
-    maxPrimitivesToShow?: number;
-}): string;
-/**
- * Parse routing response from LLM
- *
- * @param response - The raw LLM response
- * @returns Parsed routing decision or null if parsing fails
- */
-export declare function parseRoutingResponse(response: string): Partial<AgentRoutingDecision> | null;
-/**
- * Build confidence evaluation prompt
- *
- * @param primitive - The selected primitive
- * @param task - The task being evaluated
- * @returns The formatted prompt
- */
-export declare function buildConfidencePrompt(primitive: Primitive, task: string): string;
-/**
- * Build multi-step planning prompt
- *
- * @param task - The task to plan
- * @param primitives - Available primitives
- * @returns The formatted prompt
- */
-export declare function buildMultiStepPlanningPrompt(task: string, primitives: Primitive[]): string;

package/dist/lib/agent/prompts/routingPrompts.js

@@ -1,202 +0,0 @@
-/**
- * Routing Prompts for Agent Network
- *
- * These prompts guide the routing agent in selecting the appropriate
- * primitive (agent, workflow, or tool) for a given task.
- */
-/**
- * Prompt templates for routing decisions
- */
-export const ROUTING_PROMPTS = {
-    /**
-     * System instructions for the routing agent
-     */
-    SYSTEM_INSTRUCTIONS: `You are a task routing agent responsible for analyzing tasks and selecting the best primitive to handle them.
-
-Your role is to:
-1. Analyze the incoming task to understand what needs to be done
-2. Review the available primitives (agents, workflows, tools)
-3. Select the most appropriate primitive based on capabilities
-4. Format the input appropriately for the selected primitive
-5. Provide your reasoning and confidence level
-
-Always respond in valid JSON format.`,
-    /**
-     * Template for task analysis and routing
-     */
-    TASK_ROUTING: `Analyze the following task and select the most appropriate primitive to handle it.
-
-Available Primitives:
-{{PRIMITIVES}}
-
-Task to route:
-{{TASK}}
-
-Consider:
-1. The primitive's description and capabilities
-2. The complexity of the task
-3. Required tools or skills
-4. Expected output format
-
-Respond in JSON format:
-{
-  "selectedPrimitive": {
-    "type": "agent" | "workflow" | "tool",
-    "id": "<primitive_id>",
-    "name": "<primitive_name>"
-  },
-  "confidence": <0.0-1.0>,
-  "reasoning": "<explanation of why this primitive was chosen>",
-  "formattedInput": "<the input formatted for the selected primitive>",
-  "alternatives": [
-    {
-      "type": "agent" | "workflow" | "tool",
-      "id": "<alternative_id>",
-      "confidence": <0.0-1.0>
-    }
-  ]
-}`,
-    /**
-     * Template for confidence evaluation
-     */
-    CONFIDENCE_EVALUATION: `Evaluate the confidence that the selected primitive can successfully complete the task.
-
-Selected Primitive:
-- Type: {{PRIMITIVE_TYPE}}
-- Name: {{PRIMITIVE_NAME}}
-- Description: {{PRIMITIVE_DESCRIPTION}}
-
-Task: {{TASK}}
-
-Rate the confidence from 0.0 to 1.0 based on:
-- How well the primitive's capabilities match the task
-- The specificity of the primitive's description
-- The complexity of the task vs primitive's scope
-- Potential edge cases or limitations`,
-    /**
-     * Template for multi-step planning
-     */
-    MULTI_STEP_PLANNING: `Plan the execution of this complex task that may require multiple primitives.
-
-Task: {{TASK}}
-
-Available Primitives:
-{{PRIMITIVES}}
-
-Create an execution plan with the following structure:
-{
-  "isMultiStep": true/false,
-  "steps": [
-    {
-      "stepNumber": 1,
-      "primitiveId": "<primitive_id>",
-      "description": "<what this step accomplishes>",
-      "dependsOn": [<step numbers this depends on>]
-    }
-  ],
-  "expectedOutcome": "<description of final result>"
-}`,
-};
-/**
- * Build a routing prompt with primitives and task
- *
- * @param task - The task to route
- * @param primitives - Available primitives
- * @param options - Additional options
- * @returns The formatted prompt
- */
-export function buildRoutingPrompt(task, primitives, options) {
-    const { includeAlternatives = true, maxPrimitivesToShow = 20 } = options ?? {};
-    // Format primitives list
-    const primitivesDescription = primitives
-        .slice(0, maxPrimitivesToShow)
-        .map((p) => {
-        const tools = p.type === "agent" && "agent" in p
-            ? p.agent.tools
-            : undefined;
-        const toolsInfo = tools && tools.length > 0 ? `\n  Tools: ${tools.join(", ")}` : "";
-        return `- [${p.type.toUpperCase()}] ${p.id}: ${p.name}\n  Description: ${p.description}${toolsInfo}`;
-    })
-        .join("\n");
-    let prompt = ROUTING_PROMPTS.TASK_ROUTING.replace("{{PRIMITIVES}}", primitivesDescription).replace("{{TASK}}", task);
-    if (!includeAlternatives) {
-        // Remove alternatives section from expected output
-        prompt = prompt.replace(`"alternatives": [
-    {
-      "type": "agent" | "workflow" | "tool",
-      "id": "<alternative_id>",
-      "confidence": <0.0-1.0>
-    }
-  ]`, "");
-    }
-    return prompt;
-}
-/**
- * Parse routing response from LLM
- *
- * @param response - The raw LLM response
- * @returns Parsed routing decision or null if parsing fails
- */
-export function parseRoutingResponse(response) {
-    try {
-        // Try to extract JSON from the response
-        const jsonMatch = response.match(/\{[\s\S]*\}/);
-        if (!jsonMatch) {
-            return null;
-        }
-        const parsed = JSON.parse(jsonMatch[0]);
-        // Validate required fields
-        if (!parsed.selectedPrimitive ||
-            !parsed.selectedPrimitive.id ||
-            !parsed.selectedPrimitive.type) {
-            return null;
-        }
-        return {
-            selectedPrimitive: {
-                type: parsed.selectedPrimitive.type,
-                id: parsed.selectedPrimitive.id,
-                name: parsed.selectedPrimitive.name || parsed.selectedPrimitive.id,
-            },
-            confidence: typeof parsed.confidence === "number" ? parsed.confidence : 0.8,
-            reasoning: parsed.reasoning || "No reasoning provided",
-            formattedInput: parsed.formattedInput,
-            alternatives: Array.isArray(parsed.alternatives)
-                ? parsed.alternatives.map((alt) => ({
-                    type: alt.type,
-                    id: alt.id,
-                    confidence: typeof alt.confidence === "number" ? alt.confidence : 0.5,
-                }))
-                : undefined,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Build confidence evaluation prompt
- *
- * @param primitive - The selected primitive
- * @param task - The task being evaluated
- * @returns The formatted prompt
- */
-export function buildConfidencePrompt(primitive, task) {
-    return ROUTING_PROMPTS.CONFIDENCE_EVALUATION.replace("{{PRIMITIVE_TYPE}}", primitive.type)
-        .replace("{{PRIMITIVE_NAME}}", primitive.name)
-        .replace("{{PRIMITIVE_DESCRIPTION}}", primitive.description)
-        .replace("{{TASK}}", task);
-}
-/**
- * Build multi-step planning prompt
- *
- * @param task - The task to plan
- * @param primitives - Available primitives
- * @returns The formatted prompt
- */
-export function buildMultiStepPlanningPrompt(task, primitives) {
-    const primitivesDescription = primitives
-        .map((p) => `- [${p.type.toUpperCase()}] ${p.id}: ${p.name} - ${p.description}`)
-        .join("\n");
-    return ROUTING_PROMPTS.MULTI_STEP_PLANNING.replace("{{TASK}}", task).replace("{{PRIMITIVES}}", primitivesDescription);
-}
-//# sourceMappingURL=routingPrompts.js.map

package/dist/lib/agent/structuredRecovery.d.ts

@@ -1,30 +0,0 @@
-/**
- * Structured-output recovery ladder for the isolated-agent runner.
- *
- * Ports the production-hardened pattern the framework's consumers built by
- * hand: candidates are tried in a fixed order — provider `structuredData` →
- * raw JSON object → ```json fence → first/last-brace span → top-level array —
- * each passed through the caller's `coerce` normalizer and validated against
- * the (lenient) local schema. The first schema-valid candidate wins;
- * validation errors are collected for corrective re-asks.
- */
-import type { z } from "zod";
-import type { StructuredRecoveryCandidate, StructuredRecoveryResult } from "../types/index.js";
-/**
- * Collect parse candidates from model text (and provider structuredData) in
- * ladder order. Never throws.
- */
-export declare function collectStructuredCandidates(content: string | undefined, structuredData?: unknown): StructuredRecoveryCandidate[];
-/**
- * Run the full ladder: candidates (through `coerce`) validated against
- * `schema`; first success wins. Never throws — coerce/validation failures
- * become entries in `errors`.
- */
-export declare function recoverStructuredData(args: {
-    content: string | undefined;
-    structuredData?: unknown;
-    schema: z.ZodSchema;
-    coerce?: (candidate: unknown) => unknown;
-}): StructuredRecoveryResult;
-/** Bounded, prompt-friendly summary of a Zod validation error. */
-export declare function summarizeZodError(error: z.ZodError): string;

package/dist/lib/agent/structuredRecovery.js

@@ -1,105 +0,0 @@
-/**
- * Structured-output recovery ladder for the isolated-agent runner.
- *
- * Ports the production-hardened pattern the framework's consumers built by
- * hand: candidates are tried in a fixed order — provider `structuredData` →
- * raw JSON object → ```json fence → first/last-brace span → top-level array —
- * each passed through the caller's `coerce` normalizer and validated against
- * the (lenient) local schema. The first schema-valid candidate wins;
- * validation errors are collected for corrective re-asks.
- */
-function tryParse(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Collect parse candidates from model text (and provider structuredData) in
- * ladder order. Never throws.
- */
-export function collectStructuredCandidates(content, structuredData) {
-    const candidates = [];
-    if (structuredData !== undefined && structuredData !== null) {
-        candidates.push({ source: "structured-data", value: structuredData });
-    }
-    const text = (content ?? "").trim();
-    if (!text) {
-        return candidates;
-    }
-    // Raw JSON object/array/scalar
-    const raw = tryParse(text);
-    if (raw !== undefined) {
-        candidates.push({ source: "raw-json", value: raw });
-    }
-    // ```json fenced block (first fence wins)
-    const fenceMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/i);
-    if (fenceMatch?.[1]) {
-        const fenced = tryParse(fenceMatch[1].trim());
-        if (fenced !== undefined) {
-            candidates.push({ source: "json-fence", value: fenced });
-        }
-    }
-    // First-brace .. last-brace span
-    const firstBrace = text.indexOf("{");
-    const lastBrace = text.lastIndexOf("}");
-    if (firstBrace !== -1 && lastBrace > firstBrace) {
-        const span = tryParse(text.slice(firstBrace, lastBrace + 1));
-        if (span !== undefined) {
-            candidates.push({ source: "brace-span", value: span });
-        }
-    }
-    // Top-level array span
-    const firstBracket = text.indexOf("[");
-    const lastBracket = text.lastIndexOf("]");
-    if (firstBracket !== -1 && lastBracket > firstBracket) {
-        const arraySpan = tryParse(text.slice(firstBracket, lastBracket + 1));
-        if (arraySpan !== undefined && Array.isArray(arraySpan)) {
-            candidates.push({ source: "top-level-array", value: arraySpan });
-        }
-    }
-    return candidates;
-}
-/**
- * Run the full ladder: candidates (through `coerce`) validated against
- * `schema`; first success wins. Never throws — coerce/validation failures
- * become entries in `errors`.
- */
-export function recoverStructuredData(args) {
-    const errors = [];
-    const candidates = collectStructuredCandidates(args.content, args.structuredData);
-    for (const candidate of candidates) {
-        let value = candidate.value;
-        if (args.coerce) {
-            try {
-                value = args.coerce(value);
-            }
-            catch (coerceError) {
-                errors.push(`${candidate.source}: coerce failed — ${coerceError instanceof Error
-                    ? coerceError.message
-                    : String(coerceError)}`);
-                continue;
-            }
-        }
-        const parsed = args.schema.safeParse(value);
-        if (parsed.success) {
-            return { data: parsed.data, source: candidate.source, errors };
-        }
-        errors.push(`${candidate.source}: ${summarizeZodError(parsed.error)}`);
-    }
-    if (candidates.length === 0) {
-        errors.push("no JSON-shaped candidates found in output");
-    }
-    return { errors };
-}
-/** Bounded, prompt-friendly summary of a Zod validation error. */
-export function summarizeZodError(error) {
-    const issues = error.issues
-        .slice(0, 5)
-        .map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`);
-    const extra = error.issues.length > 5 ? ` (+${error.issues.length - 5})` : "";
-    return issues.join("; ") + extra;
-}
-//# sourceMappingURL=structuredRecovery.js.map

package/dist/lib/analytics/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Analytics Module Exports (runtime values only — types live in src/lib/types)
- */
-export { calculateAdvancedCost } from "./pricing.js";
-export { InMemoryAnalyticsStorage, DEFAULT_ANALYTICS_STORAGE_MAX_RECORDS, } from "./storage.js";
-export { AnalyticsService } from "./service.js";
-export { parseAnalyticsQualityScore } from "./parseQualityScore.js";

package/dist/lib/analytics/index.js

@@ -1,8 +0,0 @@
-/**
- * Analytics Module Exports (runtime values only — types live in src/lib/types)
- */
-export { calculateAdvancedCost } from "./pricing.js";
-export { InMemoryAnalyticsStorage, DEFAULT_ANALYTICS_STORAGE_MAX_RECORDS, } from "./storage.js";
-export { AnalyticsService } from "./service.js";
-export { parseAnalyticsQualityScore } from "./parseQualityScore.js";
-//# sourceMappingURL=index.js.map

package/dist/lib/analytics/parseQualityScore.d.ts

@@ -1,9 +0,0 @@
-/**
- * Safe narrowing of unknown event payloads into AnalyticsQualityScore.
- */
-import type { AnalyticsQualityScore } from "../types/index.js";
-/**
- * Convert an unknown quality-score payload into AnalyticsQualityScore.
- * Returns undefined for missing, null, or malformed values.
- */
-export declare function parseAnalyticsQualityScore(value: unknown): AnalyticsQualityScore | undefined;

package/dist/lib/analytics/parseQualityScore.js

@@ -1,30 +0,0 @@
-/**
- * Safe narrowing of unknown event payloads into AnalyticsQualityScore.
- */
-/**
- * Convert an unknown quality-score payload into AnalyticsQualityScore.
- * Returns undefined for missing, null, or malformed values.
- */
-export function parseAnalyticsQualityScore(value) {
-    if (!value || typeof value !== "object") {
-        return undefined;
-    }
-    const record = value;
-    // Reject NaN/Infinity — typeof NaN === "number"
-    if (!Number.isFinite(record.overall) ||
-        !Number.isFinite(record.relevance) ||
-        !Number.isFinite(record.accuracy) ||
-        !Number.isFinite(record.completeness)) {
-        return undefined;
-    }
-    return {
-        overall: record.overall,
-        relevance: record.relevance,
-        accuracy: record.accuracy,
-        completeness: record.completeness,
-        ...(typeof record.reasoning === "string"
-            ? { reasoning: record.reasoning }
-            : {}),
-    };
-}
-//# sourceMappingURL=parseQualityScore.js.map

package/dist/lib/analytics/pricing.d.ts

@@ -1,27 +0,0 @@
-/**
- * Analytics cost helpers.
- *
- * Prefer costs already computed by the telemetry/pricing pipeline
- * (`utils/pricing.calculateCost` / span `ai.cost.total`). This module
- * is a thin compatibility wrapper — it does not maintain a second
- * hardcoded pricing table.
- */
-/**
- * Calculate cost from token counts using the canonical SDK pricing table.
- * Returns 0 when the provider/model combination is unknown.
- *
- * Partial model-name matching uses longest-prefix preference inside
- * `calculateCost` / `findRates` — shorter keys (e.g. `gpt-4o`) never
- * win over more specific ones (e.g. `gpt-4o-mini`).
- *
- * @param model - Model name
- * @param inputTokens - Number of input tokens
- * @param outputTokens - Number of output tokens
- * @param provider - Provider name (improves rate lookup; defaults to
- *   cross-provider search via openrouter alias)
- * @returns Total cost in USD
- */
-export declare function calculateAdvancedCost(model: string | undefined, inputTokens: number, outputTokens: number, provider?: string, cacheTokens?: {
-    cacheReadTokens?: number;
-    cacheCreationTokens?: number;
-}): number;

package/dist/lib/analytics/pricing.js

@@ -1,42 +0,0 @@
-/**
- * Analytics cost helpers.
- *
- * Prefer costs already computed by the telemetry/pricing pipeline
- * (`utils/pricing.calculateCost` / span `ai.cost.total`). This module
- * is a thin compatibility wrapper — it does not maintain a second
- * hardcoded pricing table.
- */
-import { calculateCost } from "../utils/pricing.js";
-/**
- * Calculate cost from token counts using the canonical SDK pricing table.
- * Returns 0 when the provider/model combination is unknown.
- *
- * Partial model-name matching uses longest-prefix preference inside
- * `calculateCost` / `findRates` — shorter keys (e.g. `gpt-4o`) never
- * win over more specific ones (e.g. `gpt-4o-mini`).
- *
- * @param model - Model name
- * @param inputTokens - Number of input tokens
- * @param outputTokens - Number of output tokens
- * @param provider - Provider name (improves rate lookup; defaults to
- *   cross-provider search via openrouter alias)
- * @returns Total cost in USD
- */
-export function calculateAdvancedCost(model, inputTokens, outputTokens, provider, cacheTokens) {
-    if (!model) {
-        return 0;
-    }
-    // When provider is unknown, use the openrouter/litellm cross-provider
-    // search path in findRates (PROVIDER_ALIASES → __cross_provider__).
-    const resolvedProvider = provider && provider.length > 0 ? provider : "openrouter";
-    const cacheReadTokens = cacheTokens?.cacheReadTokens ?? 0;
-    const cacheCreationTokens = cacheTokens?.cacheCreationTokens ?? 0;
-    return calculateCost(resolvedProvider, model, {
-        input: inputTokens,
-        output: outputTokens,
-        total: inputTokens + cacheReadTokens + cacheCreationTokens + outputTokens,
-        ...(cacheReadTokens > 0 ? { cacheReadTokens } : {}),
-        ...(cacheCreationTokens > 0 ? { cacheCreationTokens } : {}),
-    });
-}
-//# sourceMappingURL=pricing.js.map

package/dist/lib/analytics/service.d.ts

@@ -1,36 +0,0 @@
-/**
- * Advanced Analytics Service Layer
- * Handles metrics collection, aggregation, cost analysis, and projections.
- */
-import type { AnalyticsStorage, CostAnalysisOptions, CostAnalysisResult, ProviderMetricsOptions, ProviderMetricsResult, TeamAnalyticsOptions, TeamAnalyticsResult, TelemetryRecord } from "../types/index.js";
-export declare class AnalyticsService {
-    private storage;
-    constructor(storage?: AnalyticsStorage);
-    /**
-     * Helper to parse dynamic time range formats safely
-     */
-    private parseTimeRange;
-    /**
-     * Capture a request lifecycle record
-     */
-    trackRequest(record: Omit<TelemetryRecord, "id" | "cost"> & {
-        cost?: number;
-    }): Promise<void>;
-    /**
-     * getProviderMetrics implementation
-     */
-    getProviderMetrics(options?: ProviderMetricsOptions): Promise<ProviderMetricsResult>;
-    /**
-     * Helper to format timestamps for date groupings.
-     * Clones the Date so week arithmetic never mutates the caller's value.
-     */
-    private formatGroupDate;
-    /**
-     * getCostAnalysis implementation
-     */
-    getCostAnalysis(options?: CostAnalysisOptions): Promise<CostAnalysisResult>;
-    /**
-     * getTeamAnalytics implementation
-     */
-    getTeamAnalytics(options?: TeamAnalyticsOptions): Promise<TeamAnalyticsResult>;
-}