@noetic-tools/core 1.3.0 → 2.0.0

package/dist/harness/agent-harness.d.ts

@@ -61,6 +61,29 @@ interface AgentHarnessOpts<TParams extends Record<string, unknown> = Record<stri
     /** @internal Test-only escape hatch to inject a mock callModel implementation. */
     _testCallModel?: (request: CallModelRequest) => Promise<LLMResponse>;
 }
+/** Env vars consulted when resolving the LLM client (read defensively so the
+ *  harness also works in runtimes without a `process` global, e.g. the browser). */
+interface LlmEnv {
+    noeticApiKey?: string;
+    noeticBaseUrl?: string;
+    openrouterApiKey?: string;
+}
+/** @public Effective client options resolved from config + environment. */
+export interface ResolvedLlmClient {
+    apiKey: string;
+    /** Undefined means "use the SDK's default OpenRouter base URL". */
+    serverURL?: string;
+    cache: boolean;
+}
+/**
+ * Resolve the effective LLM client options from the provider config + environment.
+ * Defaults to the Noetic platform (`provider: 'noetic'`): the `'noetic'` provider
+ * authenticates with `NOETIC_API_KEY` and targets the Noetic platform base URL,
+ * while `'openrouter'` authenticates with `OPENROUTER_API_KEY` and uses the SDK's
+ * default OpenRouter endpoint. Returns undefined when no API key is available.
+ * Exported for testing.
+ */
+export declare function resolveLlmClient(config: LlmProviderConfig | undefined, env: LlmEnv): ResolvedLlmClient | undefined;
 /**
  * Default agent harness for executing agent steps with built-in channel, memory, and trace support.
  * Provides channel store, memory layer lifecycle, and trace export with no external dependencies.

package/dist/harness/agent-harness.js

@@ -36,23 +36,62 @@ function resolveContextCwdState(rootCwdState, parent, cwdInit) {
     }
     return rootCwdState;
 }
-function createClient(config) {
+/** The Noetic platform's OpenAI-Responses-compatible inference base URL. */
+const NOETIC_DEFAULT_BASE_URL = 'https://platform.noetic.tools/v1';
+function readLlmEnv() {
     const processValue = 'process' in globalThis ? globalThis.process : undefined;
-    const envValue = typeof processValue === 'object' && processValue !== null && 'env' in processValue
+    const env = typeof processValue === 'object' && processValue !== null && 'env' in processValue
         ? processValue.env
         : undefined;
-    const openRouterApiKey = typeof envValue === 'object' && envValue !== null && 'OPENROUTER_API_KEY' in envValue
-        ? envValue.OPENROUTER_API_KEY
-        : undefined;
-    const apiKey = config?.apiKey ?? (typeof openRouterApiKey === 'string' ? openRouterApiKey : undefined);
+    if (typeof env !== 'object' || env === null) {
+        return {};
+    }
+    const str = (value) => typeof value === 'string' ? value : undefined;
+    return {
+        noeticApiKey: 'NOETIC_API_KEY' in env ? str(env.NOETIC_API_KEY) : undefined,
+        noeticBaseUrl: 'NOETIC_BASE_URL' in env ? str(env.NOETIC_BASE_URL) : undefined,
+        openrouterApiKey: 'OPENROUTER_API_KEY' in env ? str(env.OPENROUTER_API_KEY) : undefined,
+    };
+}
+/**
+ * Resolve the effective LLM client options from the provider config + environment.
+ * Defaults to the Noetic platform (`provider: 'noetic'`): the `'noetic'` provider
+ * authenticates with `NOETIC_API_KEY` and targets the Noetic platform base URL,
+ * while `'openrouter'` authenticates with `OPENROUTER_API_KEY` and uses the SDK's
+ * default OpenRouter endpoint. Returns undefined when no API key is available.
+ * Exported for testing.
+ */
+export function resolveLlmClient(config, env) {
+    const provider = config?.provider ?? 'noetic';
+    const apiKey = config?.apiKey ?? (provider === 'noetic' ? env.noeticApiKey : env.openrouterApiKey);
     if (!apiKey) {
         return undefined;
     }
-    if (config?.cache) {
-        // Inject `X-OpenRouter-Cache: true` on every request so OpenRouter serves
+    const serverURL = provider === 'noetic'
+        ? (config?.baseUrl ?? env.noeticBaseUrl ?? NOETIC_DEFAULT_BASE_URL)
+        : config?.baseUrl;
+    return {
+        apiKey,
+        serverURL,
+        cache: config?.cache ?? false,
+    };
+}
+function createClient(config) {
+    const resolved = resolveLlmClient(config, readLlmEnv());
+    if (!resolved) {
+        return undefined;
+    }
+    const options = {
+        apiKey: resolved.apiKey,
+    };
+    if (resolved.serverURL) {
+        options.serverURL = resolved.serverURL;
+    }
+    if (resolved.cache) {
+        // Inject `X-OpenRouter-Cache: true` on every request so the upstream serves
         // identical model calls from cache without re-billing (deterministic re-runs).
         return new OpenRouter({
-            apiKey,
+            ...options,
             hooks: {
                 beforeRequest: (_ctx, request) => {
                     request.headers.set('X-OpenRouter-Cache', 'true');
@@ -61,9 +100,7 @@ function createClient(config) {
             },
         });
     }
-    return new OpenRouter({
-        apiKey,
-    });
+    return new OpenRouter(options);
 }
 //#region AgentHarness
 /**

package/dist/harness/model-call.js

@@ -317,7 +317,7 @@ export class AgentHarnessModelCaller {
         throw new NoeticConfigError({
             code: 'NO_LLM_PROVIDER',
             message: 'No LLM provider configured on this harness.',
-            hint: 'Pass `llm: { provider: "openrouter", apiKey: "..." }` in constructor options or set OPENROUTER_API_KEY.',
+            hint: 'Pass `llm: { apiKey: "..." }` (defaults to the Noetic platform) or set NOETIC_API_KEY. For direct OpenRouter, use `llm: { provider: "openrouter", apiKey: "..." }` or set OPENROUTER_API_KEY.',
         });
     }
     async callModel(request) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/core",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "type": "module",
   "description": "Step primitives, interpreter, runtime, and memory layer contract for Noetic agents.",
   "license": "Apache-2.0",
@@ -67,7 +67,7 @@
   },
   "dependencies": {
     "@noetic-tools/memory": "^1.0.1",
-    "@noetic-tools/types": "^1.0.3",
+    "@noetic-tools/types": "^1.1.0",
     "@openrouter/agent": "^0.6.0",
     "zod": "^4.0.0"
   },