@noetic-tools/core 1.2.3 → 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/dist/observability/genai-attributes.d.ts

@@ -22,4 +22,12 @@ export declare const NoeticAttr: {
     readonly WORKFLOW_EDGES: "noetic.workflow.edges";
     /** Id of the declared workflow node an `llm.call`/`tool.call` span belongs to. */
     readonly NODE_ID: "noetic.node.id";
+    /**
+     * Conversation/session this run belongs to (the run's `ctx.threadId`). Stamped
+     * on the root `workflow.run` span so every turn of a multi-turn session shares
+     * one id, letting a consumer group per-run traces back into their session.
+     */
+    readonly SESSION_ID: "noetic.session.id";
+    /** Resource the session is scoped to (the run's `ctx.resourceId`), when set. */
+    readonly RESOURCE_ID: "noetic.resource.id";
 };

package/dist/observability/genai-attributes.js

@@ -25,4 +25,12 @@ export const NoeticAttr = {
     WORKFLOW_EDGES: 'noetic.workflow.edges',
     /** Id of the declared workflow node an `llm.call`/`tool.call` span belongs to. */
     NODE_ID: 'noetic.node.id',
+    /**
+     * Conversation/session this run belongs to (the run's `ctx.threadId`). Stamped
+     * on the root `workflow.run` span so every turn of a multi-turn session shares
+     * one id, letting a consumer group per-run traces back into their session.
+     */
+    SESSION_ID: 'noetic.session.id',
+    /** Resource the session is scoped to (the run's `ctx.resourceId`), when set. */
+    RESOURCE_ID: 'noetic.resource.id',
 };

package/dist/patterns/dynamic-workflow.js

@@ -158,9 +158,12 @@ export async function parseAndRunWorkflow(opts) {
 }
 /**
  * Open the root `workflow.run` span and stamp the static DAG onto it (document,
- * version, node/edge graph). The span is installed on `ctx.span` so the LLM
- * step's model/tool spans nest under it — the trace tree then mirrors the
- * declared workflow graph, with the executed path overlaid (issue #50 follow-up).
+ * version, node/edge graph) plus the session/resource the run belongs to. The
+ * span is installed on `ctx.span` so the LLM step's model/tool spans nest under
+ * it — the trace tree then mirrors the declared workflow graph, with the
+ * executed path overlaid (issue #50 follow-up). The session id (`ctx.threadId`)
+ * is shared by every turn of a conversation, so consumers can group the per-run
+ * traces of one session back together.
  */
 function beginWorkflowRunSpan(harness, ctx, doc) {
     const span = harness.createSpan('workflow.run', null);
@@ -170,6 +173,10 @@ function beginWorkflowRunSpan(harness, ctx, doc) {
     span.setAttribute(NoeticAttr.WORKFLOW_NODE_COUNT, graph.nodes.length);
     span.setAttribute(NoeticAttr.WORKFLOW_NODES, JSON.stringify(graph.nodes));
     span.setAttribute(NoeticAttr.WORKFLOW_EDGES, JSON.stringify(graph.edges));
+    span.setAttribute(NoeticAttr.SESSION_ID, ctx.threadId);
+    if (ctx.resourceId !== undefined) {
+        span.setAttribute(NoeticAttr.RESOURCE_ID, ctx.resourceId);
+    }
     installRunSpan(ctx, span);
     return span;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/core",
-  "version": "1.2.3",
+  "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"
   },