@niscorp/signal 0.1.1 → 0.1.4

package/dist/index.js

@@ -50,17 +50,11 @@ var providerRegistry = {
     endpoint: {
       nativeTools: true,
       nativeJsonMode: true,
-      // Groq validates tool args server-side (tool_use_failed 400s).
       validatesToolArgs: true,
       supportsEmbedding: false
     },
     adapter: "openai-compatible",
-    // tool_use_failed / json_validate_failed 400s carry the model's
-    // attempt in failed_generation — recover and route it.
     wire: ["failed-generation"],
-    // Reasoning models stream their trace only when asked to parse it out;
-    // `reasoning_format` is rejected on the non-reasoning ones, which is why
-    // this is opt-in (see reasoningRequest above).
     reasoningRequest: { reasoning_format: "parsed" }
   },
   openai: {
@@ -75,8 +69,6 @@ var providerRegistry = {
       supportsEmbedding: true
     },
     adapter: "openai-compatible",
-    // 4o-era models occasionally emit JSONL where one value was asked
-    // for; the acceptance gate decides, so this can never misfire.
     wire: ["jsonl-lines"]
   },
   openrouter: {
@@ -91,8 +83,6 @@ var providerRegistry = {
       supportsEmbedding: false
     },
     adapter: "openai-compatible",
-    // OpenRouter unifies reasoning across the models it routes; `enabled` turns
-    // the trace on for those that have one and is ignored by those that don't.
     reasoningRequest: { reasoning: { enabled: true } }
   },
   anthropic: {
@@ -125,97 +115,78 @@ var providerRegistry = {
     id: "typesafe",
     baseUrl: "https://api.typesafe.ai/v1",
     envKey: "TYPESAFE_API_KEY",
-    // The moving alias. A caller that records calibration against a model pins
-    // a version (`jev-1.13.0`) with `.model()`.
     defaultModel: "jev-latest",
     adapter: "systemone"
   }
 };
 var modelRegistry = {
-  // ── groq ──
   "groq/qwen/qwen3.8-27b": {
     capabilities: { nativeJsonSchema: false, toolsWithStructuredOutput: false, manglesNestedToolArgs: true, multimodal: true },
-    // nested: 3 of 20 trials failed
     reasoningEfforts: ["none", "default", "low", "medium", "high"],
     verified: "2026-09-24"
   },
   "groq/openai/gpt-oss-120b": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: false, manglesNestedToolArgs: true, multimodal: false },
-    // nested: 1 of 20 trials failed
     reasoningEfforts: ["low", "medium", "high"],
     verified: "2026-09-24"
   },
   "groq/openai/gpt-oss-20b": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: false, manglesNestedToolArgs: true, multimodal: false },
-    // nested: 6 of 20 trials failed
     reasoningEfforts: ["low", "medium", "high"],
     verified: "2026-09-24"
   },
-  // ── openai ──
   "openai/gpt-4o": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: [],
     verified: "2026-09-24"
   },
   "openai/gpt-4o-mini": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: [],
     verified: "2026-09-24"
   },
   "openai/gpt-4.1-mini": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: [],
     verified: "2026-09-24"
   },
-  // ── openrouter ──
   "openrouter/qwen/qwen3.8-27b": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: ["none", "minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/openai/gpt-4o": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: ["none", "minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/openai/gpt-4o-mini": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: ["none", "minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/openai/gpt-oss-120b": {
     capabilities: { nativeJsonSchema: false, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: false },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: ["minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/z-ai/glm-5.2": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: true, multimodal: false },
-    // nested: 1 of 20 trials failed
     reasoningEfforts: ["none", "minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/openai/gpt-5.6-luna": {
     capabilities: { nativeJsonSchema: true, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: true },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: ["none", "minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/openai/gpt-oss-20b": {
     capabilities: { nativeJsonSchema: false, toolsWithStructuredOutput: true, manglesNestedToolArgs: false, multimodal: false },
-    // nested: 0 of 20 trials failed
     reasoningEfforts: ["minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   },
   "openrouter/meta-llama/llama-3.3-70b-instruct": {
     capabilities: { nativeJsonSchema: false, toolsWithStructuredOutput: true, manglesNestedToolArgs: true, multimodal: false },
-    // nested: 9 of 20 trials failed
     reasoningEfforts: ["none", "minimal", "low", "medium", "high", "xhigh", "max"],
     verified: "2026-09-24"
   }
@@ -379,9 +350,8 @@ var createOpenAICompatibleAdapter = async (config) => {
   async function* chatStream(request, options) {
     const streamParams = {
       ...buildParams(request),
-      // Ask for the reasoning trace only when the caller wants reasoning — the
-      // opt-in that keeps `reasoning_format` off a plain Groq call. Stream-only:
-      // the non-stream `chat` path never sees these, so its content is unmoved.
+      // Only when the caller set reasoningEffort: Groq answers `reasoning_format` with a 400
+      // on its non-reasoning models.
       ...request.options?.reasoningEffort !== void 0 && config.reasoningRequest !== void 0 ? config.reasoningRequest : {},
       stream: true,
       stream_options: { include_usage: true }
@@ -707,8 +677,6 @@ async function* executeStepStream(config) {
           contentBuffer += delta.text;
           yield { type: "text", text: delta.text };
           break;
-        // Reasoning is passed straight through and deliberately NOT added to
-        // contentBuffer: it is the model thinking, not its answer.
         case "reasoning":
           yield { type: "reasoning", text: delta.text };
           break;
@@ -1387,10 +1355,7 @@ var buildMessages = (config, input) => {
 var recoveredStepResult = (recovered, routed, raw, sent) => ({
   content: "",
   toolCalls: routed.outcome.kind === "tool_calls" ? routed.outcome.calls : [],
-  // A rejected generation costs tokens — the provider processed the request and
-  // billed for it — and the 400 body carries none. The prompt is known exactly
-  // and the model's attempt is in the rejection, so this is countable rather
-  // than lost. Marked unreported, because it is a reckoning.
+  // The provider bills a rejected generation and its 400 carries no usage.
   usage: estimateUsage(sent, recovered.rejection.argsText, routed.outcome.kind === "tool_calls" ? routed.outcome.calls : []),
   finishReason: "error_recovered",
   raw,
@@ -1445,10 +1410,6 @@ var createSignalFromConfig = (config) => {
       ...providerTools && { tools: providerTools },
       ...request.toolChoice !== void 0 && { toolChoice: request.toolChoice },
       ...request.responseFormat !== void 0 && { responseFormat: request.responseFormat },
-      // The client's own options are the floor; a request may override them
-      // field by field. `complete`/`stream` already run on config.options —
-      // step used to drop them, so a configured client behaved differently
-      // depending on which door the caller came through.
       ...(config.options !== void 0 || request.options !== void 0) && {
         options: { ...config.options, ...request.options }
       }
@@ -1483,8 +1444,7 @@ var createSignalFromConfig = (config) => {
     const result = {
       content: response.content,
       toolCalls,
-      // The non-streaming body always carries usage, so a zero here is a real
-      // zero rather than a missing frame.
+      // A non-streaming body always carries usage, so a zero here is a reported zero.
       usage: { ...response.usage, reported: true },
       finishReason: response.finishReason,
       raw: response.raw
@@ -1500,9 +1460,9 @@ var createSignalFromConfig = (config) => {
     });
     return { ...result, outcome: routed.outcome, wire: routed.wire };
   };
-  const stepStream = (request, streamOptions) => {
+  const stepStreamAs = (verb) => (request, streamOptions) => {
     const run = async function* () {
-      const adapter = await getChatAdapter("stepStream");
+      const adapter = await getChatAdapter(verb);
       const resolved = resolveProvider(config);
       const declared = new Set((request.tools ?? []).map((tool) => tool.name));
       const merged = config.options !== void 0 || request.options !== void 0 ? { ...request, options: { ...config.options, ...request.options } } : request;
@@ -1542,6 +1502,7 @@ var createSignalFromConfig = (config) => {
     };
     return run();
   };
+  const stepStream = stepStreamAs("stepStream");
   const decideCalibrated = async (adapter, model, request, started) => {
     const response = await adapter.decide(
       { model, state: request.state, questions: request.questions },
@@ -1579,8 +1540,7 @@ var createSignalFromConfig = (config) => {
       decisions: acceptUncalibrated(request.questions, result.response, result.meta.provider.raw),
       meta: {
         model: result.meta.model,
-        // complete() sums what providers reported with what it had to estimate
-        // and does not say which, so this total cannot be vouched for as measured.
+        // complete() adds reported usage to estimated usage and does not say which.
         usage: { ...result.meta.usage, reported: false },
         durationMs: Date.now() - started,
         provider: { raw: result.meta.provider.raw }
@@ -1588,7 +1548,6 @@ var createSignalFromConfig = (config) => {
     };
   };
   return {
-    // Builder methods
     apiKey: (key) => fork({ apiKey: key }),
     model: (m) => fork({ model: m }),
     systemPrompt: (prompt) => fork({ systemPrompt: prompt }),
@@ -1618,7 +1577,6 @@ var createSignalFromConfig = (config) => {
         modelKnown: false
       };
     },
-    // Execution — thin wrappers over the step core (src/complete.ts).
     complete: async (input) => runComplete(
       {
         messages: buildMessages(config, input),
@@ -1629,7 +1587,7 @@ var createSignalFromConfig = (config) => {
         onRetry: config.onRetry,
         onToolCall: config.onToolCall
       },
-      { stepStream, model: resolveProvider(config).model, capabilities: resolveCapabilities(config) }
+      { stepStream: stepStreamAs("complete"), model: resolveProvider(config).model, capabilities: resolveCapabilities(config) }
     ),
     stream: (input, streamOptions) => runStream(
       {
@@ -1642,12 +1600,10 @@ var createSignalFromConfig = (config) => {
         onRetry: config.onRetry,
         onToolCall: config.onToolCall
       },
-      { stepStream, model: resolveProvider(config).model, capabilities: resolveCapabilities(config) }
+      { stepStream: stepStreamAs("stream"), model: resolveProvider(config).model, capabilities: resolveCapabilities(config) }
     ),
-    // ─── Low-level primitives — the execution core itself ────
     step,
     stepStream,
-    // ─── Embedding ────────────────────────────────────────────
     embed: (async (input, options) => {
       const adapter = await getChatAdapter("embed");
       if (!adapter.embed) {
@@ -1667,7 +1623,6 @@ var createSignalFromConfig = (config) => {
       }
       return response.embeddings;
     }),
-    // ─── Decisions ────────────────────────────────────────────
     decide: async (request) => {
       assertQuestions(request.questions);
       const started = Date.now();
@@ -1675,7 +1630,6 @@ var createSignalFromConfig = (config) => {
       const model = resolveProvider(config).model;
       return adapter.kind === "decisions" ? decideCalibrated(adapter, model, request, started) : decideEmulated(model, request, started);
     },
-    // ─── Low-level: token counting (heuristic) ───────────────
     count: async (input) => {
       const CHARS_PER_TOKEN2 = 4;
       if (typeof input === "string") {
@@ -1783,8 +1737,7 @@ var resolveTransport = (spec, caps) => {
       responseMode: spec.responseMode,
       responseFormat: {
         type: "json_schema",
-        // strict:false — strict mode rejects open records and several
-        // keywords; non-strict still constrains and never hard-fails.
+        // Strict mode rejects open records and several keywords; non-strict still constrains.
         jsonSchema: { name: "envelope", strict: false, schema: serialized }
       },
       injectSchemaDoc: injectSchemaDoc2,