netra-sdk 1.0.5 → 1.0.6

package/dist/index.d.cts

@@ -987,6 +987,32 @@ declare class SpanWrapper {
     getCurrentSpan(): Span | undefined;
 }
 
+/**
+ * Prompts API Models
+ */
+interface GetPromptParams {
+    name: string;
+    label?: string;
+}
+/**
+ * Prompt response is intentionally flexible because
+ * backend prompt structures may evolve (variables, templates, metadata etc.)
+ */
+type PromptResponse = Record<string, any>;
+
+declare class Prompts {
+    private config;
+    private client;
+    constructor(config: Config);
+    /**
+     * Fetch prompt version by name and label.
+     *
+     * @param params.name  - Name of the prompt (required)
+     * @param params.label - Label of the prompt version (default: "production")
+     */
+    getPrompt(params: GetPromptParams): Promise<PromptResponse | null>;
+}
+
 /**
  * Decorators for easy instrumentation
  */
@@ -1236,6 +1262,11 @@ declare class Netra {
      */
     static dashboard: Dashboard;
     static simulation: Simulation;
+    /**
+     * Prompts API client for prompt versioning
+     * Available after calling Netra.init()
+     */
+    static prompts: Prompts;
     /**
      * Get the current Netra configuration
      */
@@ -1343,4 +1374,4 @@ declare class Netra {
     static withBlockedSpansLocal: typeof withBlockedSpansLocal;
 }
 
-export { type ActionModel, Aggregation, BaseTask, type CategoricalDataPoint, ChartType, Config, type ConversationResponse, type ConversationResult, ConversationType, type CreateDatasetParams, type CreateRunResult, Dashboard, type DashboardData, type Dataset, type DatasetEntry, type DatasetItem, type Dimension, DimensionField, type DimensionValue, EntryStatus, Evaluation, type EvaluationScore, type EvaluatorFunction, type Filter, type FilterConfig, FilterField, FilterType, FilteringSpanExporter, GroupBy, InstrumentationSpanProcessor, type ListSpansParams, type ListTracesParams, Measure, type Metrics, Netra, NetraInstruments, type NumberResponse, Operator, type QueryDataParams, type QueryResponse, type Run, RunEntryContext, RunStatus, Scope, ScrubbingSpanProcessor, SessionSpanProcessor, type SessionUsageData, Simulation, type SimulationItem, type SimulationOptions, type SimulationResult, SpanType, type SpansPage, type TaskFunction, type TaskResult, type TenantUsageData, type TestSuiteResult, type TimeRange, type TimeSeriesDataPoint, type TimeSeriesResponse, type TimeSeriesWithDimension, type TraceSpan, type TraceSummary, type TracesPage, TrialAwareOTLPExporter, Usage, type UsageModel, agent, Netra as default, metadataField, mistralAIInstrumentor, span, task, workflow };
+export { type ActionModel, Aggregation, BaseTask, type CategoricalDataPoint, ChartType, Config, type ConversationResponse, type ConversationResult, ConversationType, type CreateDatasetParams, type CreateRunResult, Dashboard, type DashboardData, type Dataset, type DatasetEntry, type DatasetItem, type Dimension, DimensionField, type DimensionValue, EntryStatus, Evaluation, type EvaluationScore, type EvaluatorFunction, type Filter, type FilterConfig, FilterField, FilterType, FilteringSpanExporter, type GetPromptParams, GroupBy, InstrumentationSpanProcessor, type ListSpansParams, type ListTracesParams, Measure, type Metrics, Netra, NetraInstruments, type NumberResponse, Operator, type PromptResponse, Prompts, type QueryDataParams, type QueryResponse, type Run, RunEntryContext, RunStatus, Scope, ScrubbingSpanProcessor, SessionSpanProcessor, type SessionUsageData, Simulation, type SimulationItem, type SimulationOptions, type SimulationResult, SpanType, type SpansPage, type TaskFunction, type TaskResult, type TenantUsageData, type TestSuiteResult, type TimeRange, type TimeSeriesDataPoint, type TimeSeriesResponse, type TimeSeriesWithDimension, type TraceSpan, type TraceSummary, type TracesPage, TrialAwareOTLPExporter, Usage, type UsageModel, agent, Netra as default, metadataField, mistralAIInstrumentor, span, task, workflow };

package/dist/index.d.ts

@@ -987,6 +987,32 @@ declare class SpanWrapper {
     getCurrentSpan(): Span | undefined;
 }
 
+/**
+ * Prompts API Models
+ */
+interface GetPromptParams {
+    name: string;
+    label?: string;
+}
+/**
+ * Prompt response is intentionally flexible because
+ * backend prompt structures may evolve (variables, templates, metadata etc.)
+ */
+type PromptResponse = Record<string, any>;
+
+declare class Prompts {
+    private config;
+    private client;
+    constructor(config: Config);
+    /**
+     * Fetch prompt version by name and label.
+     *
+     * @param params.name  - Name of the prompt (required)
+     * @param params.label - Label of the prompt version (default: "production")
+     */
+    getPrompt(params: GetPromptParams): Promise<PromptResponse | null>;
+}
+
 /**
  * Decorators for easy instrumentation
  */
@@ -1236,6 +1262,11 @@ declare class Netra {
      */
     static dashboard: Dashboard;
     static simulation: Simulation;
+    /**
+     * Prompts API client for prompt versioning
+     * Available after calling Netra.init()
+     */
+    static prompts: Prompts;
     /**
      * Get the current Netra configuration
      */
@@ -1343,4 +1374,4 @@ declare class Netra {
     static withBlockedSpansLocal: typeof withBlockedSpansLocal;
 }
 
-export { type ActionModel, Aggregation, BaseTask, type CategoricalDataPoint, ChartType, Config, type ConversationResponse, type ConversationResult, ConversationType, type CreateDatasetParams, type CreateRunResult, Dashboard, type DashboardData, type Dataset, type DatasetEntry, type DatasetItem, type Dimension, DimensionField, type DimensionValue, EntryStatus, Evaluation, type EvaluationScore, type EvaluatorFunction, type Filter, type FilterConfig, FilterField, FilterType, FilteringSpanExporter, GroupBy, InstrumentationSpanProcessor, type ListSpansParams, type ListTracesParams, Measure, type Metrics, Netra, NetraInstruments, type NumberResponse, Operator, type QueryDataParams, type QueryResponse, type Run, RunEntryContext, RunStatus, Scope, ScrubbingSpanProcessor, SessionSpanProcessor, type SessionUsageData, Simulation, type SimulationItem, type SimulationOptions, type SimulationResult, SpanType, type SpansPage, type TaskFunction, type TaskResult, type TenantUsageData, type TestSuiteResult, type TimeRange, type TimeSeriesDataPoint, type TimeSeriesResponse, type TimeSeriesWithDimension, type TraceSpan, type TraceSummary, type TracesPage, TrialAwareOTLPExporter, Usage, type UsageModel, agent, Netra as default, metadataField, mistralAIInstrumentor, span, task, workflow };
+export { type ActionModel, Aggregation, BaseTask, type CategoricalDataPoint, ChartType, Config, type ConversationResponse, type ConversationResult, ConversationType, type CreateDatasetParams, type CreateRunResult, Dashboard, type DashboardData, type Dataset, type DatasetEntry, type DatasetItem, type Dimension, DimensionField, type DimensionValue, EntryStatus, Evaluation, type EvaluationScore, type EvaluatorFunction, type Filter, type FilterConfig, FilterField, FilterType, FilteringSpanExporter, type GetPromptParams, GroupBy, InstrumentationSpanProcessor, type ListSpansParams, type ListTracesParams, Measure, type Metrics, Netra, NetraInstruments, type NumberResponse, Operator, type PromptResponse, Prompts, type QueryDataParams, type QueryResponse, type Run, RunEntryContext, RunStatus, Scope, ScrubbingSpanProcessor, SessionSpanProcessor, type SessionUsageData, Simulation, type SimulationItem, type SimulationOptions, type SimulationResult, SpanType, type SpansPage, type TaskFunction, type TaskResult, type TenantUsageData, type TestSuiteResult, type TimeRange, type TimeSeriesDataPoint, type TimeSeriesResponse, type TimeSeriesWithDimension, type TraceSpan, type TraceSummary, type TracesPage, TrialAwareOTLPExporter, Usage, type UsageModel, agent, Netra as default, metadataField, mistralAIInstrumentor, span, task, workflow };

package/dist/index.js

@@ -9264,6 +9264,67 @@ var Simulation = class {
     }
   }
 };
+
+// src/api/prompts/client.ts
+var PromptsHttpClient = class extends NetraHttpClient {
+  constructor(config2) {
+    super(config2, "NETRA_PROMPTS_TIMEOUT", 30);
+  }
+  /**
+   * Fetch prompt version from backend
+   */
+  async getPromptVersion(name, label) {
+    if (!this.isInitialized()) {
+      console.error(
+        "netra.prompts: Prompts client is not initialized; cannot fetch prompt"
+      );
+      return null;
+    }
+    try {
+      const payload = {
+        promptName: name,
+        label
+      };
+      const response = await this.post("/sdk/prompts/version", payload);
+      if (!response.ok) {
+        const errorMessage = response.data?.error?.message ?? "Unknown error";
+        console.error(`netra.prompts: Failed to fetch prompt: ${errorMessage}`);
+        return null;
+      }
+      return response.data;
+    } catch (err) {
+      const message = err?.response?.data?.error?.message ?? "";
+      console.error("netra.prompts: Failed to fetch prompt:", message);
+      return null;
+    }
+  }
+};
+
+// src/api/prompts/api.ts
+var Prompts = class {
+  constructor(config2) {
+    this.config = config2;
+    this.client = new PromptsHttpClient(config2);
+  }
+  /**
+   * Fetch prompt version by name and label.
+   *
+   * @param params.name  - Name of the prompt (required)
+   * @param params.label - Label of the prompt version (default: "production")
+   */
+  async getPrompt(params) {
+    if (!params || typeof params.name !== "string" || !params.name) {
+      console.error("netra.prompts: name is required to fetch a prompt");
+      return null;
+    }
+    const label = params.label ?? "production";
+    const result = await this.client.getPromptVersion(params.name, label);
+    if (!result) {
+      return null;
+    }
+    return result.data ?? null;
+  }
+};
 function serializeValue(value) {
   try {
     if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null || value === void 0) {
@@ -9514,6 +9575,7 @@ var Netra = class {
     this.evaluation = new Evaluation(cfg);
     this.dashboard = new Dashboard(cfg);
     this.simulation = new Simulation(cfg);
+    this.prompts = new Prompts(cfg);
     this._initialized = true;
     console.info("Netra successfully initialized.");
     if (cfg.debugMode) {
@@ -9802,6 +9864,6 @@ Netra._initialized = false;
 Netra.withBlockedSpansLocal = withBlockedSpansLocal;
 var index_default = Netra;
 
-export { Aggregation, BaseTask, ChartType, Config, ConversationType, Dashboard, DimensionField, EntryStatus, Evaluation, FilterField, FilterType, FilteringSpanExporter, GroupBy, InstrumentationSpanProcessor, Measure, Netra, NetraInstruments, Operator, RunEntryContext, RunStatus, Scope, ScrubbingSpanProcessor, SessionSpanProcessor, Simulation, SpanType, TrialAwareOTLPExporter, Usage, agent, index_default as default, metadataField, mistralAIInstrumentor, span, task, workflow };
+export { Aggregation, BaseTask, ChartType, Config, ConversationType, Dashboard, DimensionField, EntryStatus, Evaluation, FilterField, FilterType, FilteringSpanExporter, GroupBy, InstrumentationSpanProcessor, Measure, Netra, NetraInstruments, Operator, Prompts, RunEntryContext, RunStatus, Scope, ScrubbingSpanProcessor, SessionSpanProcessor, Simulation, SpanType, TrialAwareOTLPExporter, Usage, agent, index_default as default, metadataField, mistralAIInstrumentor, span, task, workflow };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map