@zhanla/sdk-ts 0.3.6 → 0.3.8

package/README.md

@@ -1,6 +1,6 @@
 # @zhanla/sdk-ts
 
-`@zhanla/sdk-ts` is the TypeScript SDK for defining bench components in code.
+`@zhanla/sdk-ts` is the TypeScript SDK for defining zhanla components in code.
 
 You export component instances from a TypeScript module, then run them with `zhanla` or the bundled `@zhanla/sdk-ts` helper CLI.
 

package/bin/cli.js

@@ -12,7 +12,7 @@
 import { spawnSync } from "child_process";
 import { createRequire } from "module";
 
-if (process.env.BENCH_SDK_TS_LOADER_ACTIVE !== "1") {
+if (process.env.ZHANLA_SDK_TS_LOADER_ACTIVE !== "1" && process.env.BENCH_SDK_TS_LOADER_ACTIVE !== "1") {
   const require = createRequire(import.meta.url);
   const loaderPath = require.resolve("tsx");
   const child = spawnSync(
@@ -20,7 +20,7 @@ if (process.env.BENCH_SDK_TS_LOADER_ACTIVE !== "1") {
     ["--import", loaderPath, new URL(import.meta.url).pathname, ...process.argv.slice(2)],
     {
       stdio: "inherit",
-      env: { ...process.env, BENCH_SDK_TS_LOADER_ACTIVE: "1" },
+      env: { ...process.env, ZHANLA_SDK_TS_LOADER_ACTIVE: "1" },
     },
   );
 
@@ -29,14 +29,14 @@ if (process.env.BENCH_SDK_TS_LOADER_ACTIVE !== "1") {
 
 const [, , subcommand, ...args] = process.argv;
 
-const INTERNAL_SUBCOMMANDS = ["discover", "run", "eval-only"];
+const INTERNAL_SUBCOMMANDS = ["discover", "run", "eval-only", "version"];
 
 if (!subcommand) {
   console.error("Usage: zhanla-sdk-ts <discover|run|eval-only> <target>");
   process.exit(1);
 }
 
-if (INTERNAL_SUBCOMMANDS.includes(subcommand) && process.env.ZHANLA_INTERNAL !== "1") {
+if (INTERNAL_SUBCOMMANDS.includes(subcommand) && !/^[0-9a-f]{64}$/.test(process.env.ZHANLA_INTERNAL ?? "")) {
   console.error(
     "Use the `zhanla` CLI for the full experience: https://pypi.org/project/zhanla/"
   );

package/bin/discover.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * zhanla-sdk-ts discover <file.ts[:ExportName]>
+ * zhanla-sdk-ts discover <file.ts[:component-key]>
  *
  * Loads a TypeScript module via tsx, walks the transitive closure from a
  * named root (or all exported roots if no name given), and emits the full
@@ -210,11 +210,20 @@ export function buildDiscoveredManifests({
 }) {
   if (symbolName) {
     const root = allComponents.find(
-      (c) => symbolByComponent.get(c) === symbolName || c.name === symbolName
+      (c) => c.key === symbolName
     );
     if (!root) {
-      const available = allComponents.map((c) => symbolByComponent.get(c) ?? c.name).join(", ");
-      throw new Error(`Component '${symbolName}' not found in ${filePath}. Available: ${available}`);
+      const nameMatches = allComponents.filter(
+        (c) => symbolByComponent.get(c) === symbolName || c.name === symbolName
+      );
+      const available = allComponents.map((c) => c.key).join(", ");
+      if (nameMatches.length > 0) {
+        const matchingKeys = nameMatches.map((c) => c.key).join(", ");
+        throw new Error(
+          `Component '${symbolName}' matched a component name/export, but discovery now requires component keys. Use one of: ${matchingKeys}`
+        );
+      }
+      throw new Error(`Component '${symbolName}' not found in ${filePath}. Available keys: ${available}`);
     }
     return collectClosureManifests([root], toManifest, filePath, symbolByComponent);
   }

package/dist/trace_store.d.ts

@@ -2,7 +2,7 @@
  * In-memory LLM call trace store backed by AsyncLocalStorage.
  *
  * The CLI sets a TraceContext before calling a component's runner.
- * The bench.wrap() interceptors read the active context and record each LLM call.
+ * The zhanla.wrap() interceptors read the active context and record each LLM call.
  * After execution the CLI flushes the calls and writes them to Supabase.
  */
 import { AsyncLocalStorage } from "async_hooks";

package/dist/trace_store.js

@@ -2,7 +2,7 @@
  * In-memory LLM call trace store backed by AsyncLocalStorage.
  *
  * The CLI sets a TraceContext before calling a component's runner.
- * The bench.wrap() interceptors read the active context and record each LLM call.
+ * The zhanla.wrap() interceptors read the active context and record each LLM call.
  * After execution the CLI flushes the calls and writes them to Supabase.
  */
 import { AsyncLocalStorage } from "async_hooks";

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Core types for the bench TypeScript SDK.
+ * Core types for the zhanla TypeScript SDK.
  * Mirrors the Python SDK's class-based component model.
  */
 export type JsonSchemaScalar = {

package/dist/types.js

@@ -1,5 +1,5 @@
 /**
- * Core types for the bench TypeScript SDK.
+ * Core types for the zhanla TypeScript SDK.
  * Mirrors the Python SDK's class-based component model.
  */
 import { parseJsonResponse } from "./json.js";

package/dist/wrap.d.ts

@@ -1,8 +1,8 @@
 /**
- * bench.wrap() — observe LLM clients without executing them.
+ * zhanla.wrap() — observe LLM clients without executing them.
  *
  * Wraps an existing LLM client so every call is recorded in the active
- * TraceContext. The underlying client is unchanged; bench only observes.
+ * TraceContext. The underlying client is unchanged; zhanla only observes.
  *
  * Supported clients:
  *   - Anthropic (from @anthropic-ai/sdk)
@@ -40,7 +40,7 @@ export declare function isGeminiClient(client: unknown): client is {
  *
  * @example
  * import Anthropic from "@anthropic-ai/sdk";
- * import bench from "@benchlabs/sdk";
- * const client = bench.wrap(new Anthropic());
+ * import { wrap } from "@zhanla/sdk-ts";
+ * const client = wrap(new Anthropic());
  */
 export declare function wrap<T>(client: T): T;

package/dist/wrap.js

@@ -1,8 +1,8 @@
 /**
- * bench.wrap() — observe LLM clients without executing them.
+ * zhanla.wrap() — observe LLM clients without executing them.
  *
  * Wraps an existing LLM client so every call is recorded in the active
- * TraceContext. The underlying client is unchanged; bench only observes.
+ * TraceContext. The underlying client is unchanged; zhanla only observes.
  *
  * Supported clients:
  *   - Anthropic (from @anthropic-ai/sdk)
@@ -11,7 +11,8 @@
  *   - GoogleGenAI (from @google/genai)
  */
 import { traceStorage } from "./trace_store.js";
-const WRAPPED_CLIENT = Symbol.for("bench.sdk_ts.wrapped_client");
+const WRAPPED_CLIENT = Symbol.for("zhanla.sdk_ts.wrapped_client");
+const WRAPPED_CLIENT_LEGACY = Symbol.for("bench.sdk_ts.wrapped_client");
 // ---------------------------------------------------------------------------
 // Serialisation helper
 // ---------------------------------------------------------------------------
@@ -232,12 +233,15 @@ export function isGeminiClient(client) {
  *
  * @example
  * import Anthropic from "@anthropic-ai/sdk";
- * import bench from "@benchlabs/sdk";
- * const client = bench.wrap(new Anthropic());
+ * import { wrap } from "@zhanla/sdk-ts";
+ * const client = wrap(new Anthropic());
  */
 export function wrap(client) {
-    if (client != null && typeof client === "object" && client[WRAPPED_CLIENT] === true) {
-        return client;
+    if (client != null && typeof client === "object") {
+        const c = client;
+        if (c[WRAPPED_CLIENT] === true || c[WRAPPED_CLIENT_LEGACY] === true) {
+            return client;
+        }
     }
     let wrapped;
     if (isAnthropicClient(client))
@@ -249,7 +253,7 @@ export function wrap(client) {
     else if (isGeminiClient(client))
         wrapped = wrapGemini(client);
     else {
-        throw new TypeError(`bench.wrap() does not support ${Object.getPrototypeOf(client)?.constructor?.name ?? typeof client}. ` +
+        throw new TypeError(`zhanla.wrap() does not support ${Object.getPrototypeOf(client)?.constructor?.name ?? typeof client}. ` +
             "Supported clients: Anthropic, OpenAI, OpenRouter (OpenAI client with OpenRouter baseURL), GoogleGenAI.");
     }
     if (wrapped != null && typeof wrapped === "object") {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@zhanla/sdk-ts",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "TypeScript SDK for the zhanla CLI — define and run AI components locally",
-  "homepage": "https://benchmark-black.vercel.app/",
+  "homepage": "https://github.com/zhanla-ai",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhanla-ai"
@@ -28,7 +28,6 @@
     "bin"
   ],
   "devDependencies": {
-    "typescript": "^5.4.0",
     "vitest": "^1.4.0",
     "@types/node": "^20.0.0"
   },