@zespan/sdk 1.0.0 → 1.1.0

package/README.md

@@ -18,7 +18,7 @@ pnpm add @zespan/sdk
 import { init } from "@zespan/sdk";
 
 init({
-  apiKey: "lqt_your_key_here",
+  apiKey: "zsp_your_key_here",
   projectId: "your_project_id",
 });
 ```
@@ -35,7 +35,7 @@ By default, `init()` patches OpenAI, Anthropic, and Google GenAI as soon as they
 import { init } from "@zespan/sdk";
 import OpenAI from "openai";
 
-init({ apiKey: "lqt_...", projectId: "proj_..." });
+init({ apiKey: "zsp_...", projectId: "proj_..." });
 
 const openai = new OpenAI();
 // This call is automatically traced
@@ -48,7 +48,7 @@ const response = await openai.chat.completions.create({
 To disable autopatch and wrap manually:
 
 ```ts
-init({ apiKey: "lqt_...", autopatch: false });
+init({ apiKey: "zsp_...", autopatch: false });
 ```
 
 ## Manual wrappers
@@ -61,7 +61,7 @@ import OpenAI from "openai";
 import Anthropic from "@anthropic-ai/sdk";
 import { GoogleGenerativeAI } from "@google/generative-ai";
 
-init({ apiKey: "lqt_...", autopatch: false });
+init({ apiKey: "zsp_...", autopatch: false });
 
 const openai = wrapOpenAI(new OpenAI());
 const anthropic = wrapAnthropic(new Anthropic());
@@ -85,7 +85,7 @@ const google = wrapGoogle(new GoogleGenerativeAI(process.env.GOOGLE_API_KEY!));
 
 ```ts
 init({
-  apiKey: "lqt_...", // required
+  apiKey: "zsp_...", // required
   projectId: "proj_...", // required — links traces to a project
   environment: "production", // default: "production"
   storePrompts: false, // store prompt/completion text (default: false)
@@ -315,7 +315,7 @@ Enable native OTEL export alongside Zespan:
 
 ```ts
 init({
-  apiKey: "lqt_...",
+  apiKey: "zsp_...",
   enableOTel: true,
   otelEndpoint: "http://localhost:4318",
   otelServiceName: "my-service",

package/dist/index.d.mts

@@ -343,7 +343,7 @@ declare class ZespanADKCallbackHandler {
     private getParentAgentState;
     beforeAgentCallback: (context: any) => undefined;
     afterAgentCallback: (context: any) => undefined;
-    beforeModelCallback: ({ context, request: _request }: any) => undefined;
+    beforeModelCallback: ({ context, request }: any) => undefined;
     afterModelCallback: ({ context, response }: any) => undefined;
     beforeToolCallback: ({ tool, args, context }: any) => undefined;
     afterToolCallback: ({ tool: _tool, args: _args, context, response }: any) => undefined;
@@ -351,7 +351,7 @@ declare class ZespanADKCallbackHandler {
     get callbacks(): {
         beforeAgentCallback: (context: any) => undefined;
         afterAgentCallback: (context: any) => undefined;
-        beforeModelCallback: ({ context, request: _request }: any) => undefined;
+        beforeModelCallback: ({ context, request }: any) => undefined;
         afterModelCallback: ({ context, response }: any) => undefined;
         beforeToolCallback: ({ tool, args, context }: any) => undefined;
         afterToolCallback: ({ tool: _tool, args: _args, context, response }: any) => undefined;
@@ -506,30 +506,14 @@ declare function injectAgentContext(headers: Record<string, string>, delegationR
  */
 declare function extractAgentContext(headers: Record<string, string>): Context;
 
-/**
- * CrewAI context bridge for Zespan.
- *
- * Python-side: use openinference-instrumentation-crewai (PyPI).
- * When a CrewAI agent makes an HTTP call to a Node.js service,
- * the downstream service uses extractAgentContext() to continue the trace.
- *
- * Usage in the receiving Node.js service:
- *   import { extractAgentContext } from '@zespan/sdk';
- *   const ctx = extractAgentContext(req.headers);
- *   const span = tracer.startSpan('invoke_agent SubAgent', undefined, ctx);
- */
 declare const CREWAI_OTEL_ENV: {
     readonly OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318";
     readonly OTEL_SERVICE_NAME: "crewai-agent";
 };
-/**
- * Configuration guide for CrewAI Python instrumentation.
- */
 declare function getCrewAIInstrumentationGuide(): string;
 
 /**
  * Attach trace context to an AutoGen message payload.
- * Call before sending a message to another AutoGen agent over HTTP.
  */
 declare function attachTraceToAutoGenMessage<T extends Record<string, unknown>>(message: T, delegationReason?: string): T & {
     _lumiq_trace: Record<string, string>;

package/dist/index.d.ts

@@ -343,7 +343,7 @@ declare class ZespanADKCallbackHandler {
     private getParentAgentState;
     beforeAgentCallback: (context: any) => undefined;
     afterAgentCallback: (context: any) => undefined;
-    beforeModelCallback: ({ context, request: _request }: any) => undefined;
+    beforeModelCallback: ({ context, request }: any) => undefined;
     afterModelCallback: ({ context, response }: any) => undefined;
     beforeToolCallback: ({ tool, args, context }: any) => undefined;
     afterToolCallback: ({ tool: _tool, args: _args, context, response }: any) => undefined;
@@ -351,7 +351,7 @@ declare class ZespanADKCallbackHandler {
     get callbacks(): {
         beforeAgentCallback: (context: any) => undefined;
         afterAgentCallback: (context: any) => undefined;
-        beforeModelCallback: ({ context, request: _request }: any) => undefined;
+        beforeModelCallback: ({ context, request }: any) => undefined;
         afterModelCallback: ({ context, response }: any) => undefined;
         beforeToolCallback: ({ tool, args, context }: any) => undefined;
         afterToolCallback: ({ tool: _tool, args: _args, context, response }: any) => undefined;
@@ -506,30 +506,14 @@ declare function injectAgentContext(headers: Record<string, string>, delegationR
  */
 declare function extractAgentContext(headers: Record<string, string>): Context;
 
-/**
- * CrewAI context bridge for Zespan.
- *
- * Python-side: use openinference-instrumentation-crewai (PyPI).
- * When a CrewAI agent makes an HTTP call to a Node.js service,
- * the downstream service uses extractAgentContext() to continue the trace.
- *
- * Usage in the receiving Node.js service:
- *   import { extractAgentContext } from '@zespan/sdk';
- *   const ctx = extractAgentContext(req.headers);
- *   const span = tracer.startSpan('invoke_agent SubAgent', undefined, ctx);
- */
 declare const CREWAI_OTEL_ENV: {
     readonly OTEL_EXPORTER_OTLP_ENDPOINT: "http://localhost:4318";
     readonly OTEL_SERVICE_NAME: "crewai-agent";
 };
-/**
- * Configuration guide for CrewAI Python instrumentation.
- */
 declare function getCrewAIInstrumentationGuide(): string;
 
 /**
  * Attach trace context to an AutoGen message payload.
- * Call before sending a message to another AutoGen agent over HTTP.
  */
 declare function attachTraceToAutoGenMessage<T extends Record<string, unknown>>(message: T, delegationReason?: string): T & {
     _lumiq_trace: Record<string, string>;