@niscorp/signal 0.1.3 → 0.1.5

package/dist/index.d.cts

@@ -516,6 +516,8 @@ declare const modelRegistry: Record<string, ModelEntry>;
 declare const UNMEASURED_MODEL: ModelCapabilities;
 declare const modelKey: (provider: string, model: string) => string;
 declare const modelEntry: (provider: string, model: string) => ModelEntry | undefined;
+type ModelDefaults = Pick<SignalOptions, 'temperature' | 'topP' | 'maxTokens'>;
+declare const modelDefaults: Record<string, ModelDefaults>;
 declare const chatProviderEntry: (id: string) => ChatProviderEntry | undefined;
 
 type ErrorWireStrategy = {
@@ -588,4 +590,4 @@ type ResolvedTransport = {
 declare const RESPOND_TOOL_NAME = "respond";
 declare const resolveTransport: (spec: TransportSpec, caps: Capabilities) => ResolvedTransport;
 
-export { type AssistantToolCall, type CalibratedDecision, type Capabilities, type ChatProviderEntry, type ChoiceQuestion, type ContentPart, type CountInput, type CustomChatProviderConfig, type CustomDecisionProviderConfig, type CustomProviderConfig, type DecideMeta, type DecideRequest, type DecideResult, type DecideState, type DecisionProviderEntry, type EmbedOptions, type EmbedRequest, type EmbedResponse, type EndpointCapabilities, ErrorCode, type ErrorWireStrategy, type ExtractResult, type ImageSource, type Message, type ModelCapabilities, type ModelEntry, type NoulQuestion, type OutputTransport, type ProviderEntry, type ProviderError, type Question, type Questions, REASONING_EFFORTS, RESPOND_TOOL_NAME, type ReasoningEffort, type Rejection, type ResolvedTransport, type ResponseFormat, type ResponseWireStrategy, type ScoreQuestion, type Signal, type SignalConfig, type SignalDescription, SignalError, type SignalMeta, type SignalOptions, type SignalResult, type StepInputMessage, type StepOutcome, type StepRequest, type StepResult, type StepStreamEvent, type StepToolCall, type StepToolDescriptor, type StreamEvent, type StreamOptions, type Tool, type ToolCallRecord, type ToolConfig, type TransportSpec, UNMEASURED_MODEL, type UncalibratedDecision, type WireReport, type WireStrategy, chatProviderEntry, closeTruncated, createSignal, decodeJsonish, deepDecodeJsonish, defineTool, extractJson, isTruncatedJson, modelEntry, modelKey, modelRegistry, providerRegistry, repairEscapeDamage, resolveTransport, routeRejection, routeResponse };
+export { type AssistantToolCall, type CalibratedDecision, type Capabilities, type ChatProviderEntry, type ChoiceQuestion, type ContentPart, type CountInput, type CustomChatProviderConfig, type CustomDecisionProviderConfig, type CustomProviderConfig, type DecideMeta, type DecideRequest, type DecideResult, type DecideState, type DecisionProviderEntry, type EmbedOptions, type EmbedRequest, type EmbedResponse, type EndpointCapabilities, ErrorCode, type ErrorWireStrategy, type ExtractResult, type ImageSource, type Message, type ModelCapabilities, type ModelDefaults, type ModelEntry, type NoulQuestion, type OutputTransport, type ProviderEntry, type ProviderError, type Question, type Questions, REASONING_EFFORTS, RESPOND_TOOL_NAME, type ReasoningEffort, type Rejection, type ResolvedTransport, type ResponseFormat, type ResponseWireStrategy, type ScoreQuestion, type Signal, type SignalConfig, type SignalDescription, SignalError, type SignalMeta, type SignalOptions, type SignalResult, type StepInputMessage, type StepOutcome, type StepRequest, type StepResult, type StepStreamEvent, type StepToolCall, type StepToolDescriptor, type StreamEvent, type StreamOptions, type Tool, type ToolCallRecord, type ToolConfig, type TransportSpec, UNMEASURED_MODEL, type UncalibratedDecision, type WireReport, type WireStrategy, chatProviderEntry, closeTruncated, createSignal, decodeJsonish, deepDecodeJsonish, defineTool, extractJson, isTruncatedJson, modelDefaults, modelEntry, modelKey, modelRegistry, providerRegistry, repairEscapeDamage, resolveTransport, routeRejection, routeResponse };

package/dist/index.d.ts

@@ -516,6 +516,8 @@ declare const modelRegistry: Record<string, ModelEntry>;
 declare const UNMEASURED_MODEL: ModelCapabilities;
 declare const modelKey: (provider: string, model: string) => string;
 declare const modelEntry: (provider: string, model: string) => ModelEntry | undefined;
+type ModelDefaults = Pick<SignalOptions, 'temperature' | 'topP' | 'maxTokens'>;
+declare const modelDefaults: Record<string, ModelDefaults>;
 declare const chatProviderEntry: (id: string) => ChatProviderEntry | undefined;
 
 type ErrorWireStrategy = {
@@ -588,4 +590,4 @@ type ResolvedTransport = {
 declare const RESPOND_TOOL_NAME = "respond";
 declare const resolveTransport: (spec: TransportSpec, caps: Capabilities) => ResolvedTransport;
 
-export { type AssistantToolCall, type CalibratedDecision, type Capabilities, type ChatProviderEntry, type ChoiceQuestion, type ContentPart, type CountInput, type CustomChatProviderConfig, type CustomDecisionProviderConfig, type CustomProviderConfig, type DecideMeta, type DecideRequest, type DecideResult, type DecideState, type DecisionProviderEntry, type EmbedOptions, type EmbedRequest, type EmbedResponse, type EndpointCapabilities, ErrorCode, type ErrorWireStrategy, type ExtractResult, type ImageSource, type Message, type ModelCapabilities, type ModelEntry, type NoulQuestion, type OutputTransport, type ProviderEntry, type ProviderError, type Question, type Questions, REASONING_EFFORTS, RESPOND_TOOL_NAME, type ReasoningEffort, type Rejection, type ResolvedTransport, type ResponseFormat, type ResponseWireStrategy, type ScoreQuestion, type Signal, type SignalConfig, type SignalDescription, SignalError, type SignalMeta, type SignalOptions, type SignalResult, type StepInputMessage, type StepOutcome, type StepRequest, type StepResult, type StepStreamEvent, type StepToolCall, type StepToolDescriptor, type StreamEvent, type StreamOptions, type Tool, type ToolCallRecord, type ToolConfig, type TransportSpec, UNMEASURED_MODEL, type UncalibratedDecision, type WireReport, type WireStrategy, chatProviderEntry, closeTruncated, createSignal, decodeJsonish, deepDecodeJsonish, defineTool, extractJson, isTruncatedJson, modelEntry, modelKey, modelRegistry, providerRegistry, repairEscapeDamage, resolveTransport, routeRejection, routeResponse };
+export { type AssistantToolCall, type CalibratedDecision, type Capabilities, type ChatProviderEntry, type ChoiceQuestion, type ContentPart, type CountInput, type CustomChatProviderConfig, type CustomDecisionProviderConfig, type CustomProviderConfig, type DecideMeta, type DecideRequest, type DecideResult, type DecideState, type DecisionProviderEntry, type EmbedOptions, type EmbedRequest, type EmbedResponse, type EndpointCapabilities, ErrorCode, type ErrorWireStrategy, type ExtractResult, type ImageSource, type Message, type ModelCapabilities, type ModelDefaults, type ModelEntry, type NoulQuestion, type OutputTransport, type ProviderEntry, type ProviderError, type Question, type Questions, REASONING_EFFORTS, RESPOND_TOOL_NAME, type ReasoningEffort, type Rejection, type ResolvedTransport, type ResponseFormat, type ResponseWireStrategy, type ScoreQuestion, type Signal, type SignalConfig, type SignalDescription, SignalError, type SignalMeta, type SignalOptions, type SignalResult, type StepInputMessage, type StepOutcome, type StepRequest, type StepResult, type StepStreamEvent, type StepToolCall, type StepToolDescriptor, type StreamEvent, type StreamOptions, type Tool, type ToolCallRecord, type ToolConfig, type TransportSpec, UNMEASURED_MODEL, type UncalibratedDecision, type WireReport, type WireStrategy, chatProviderEntry, closeTruncated, createSignal, decodeJsonish, deepDecodeJsonish, defineTool, extractJson, isTruncatedJson, modelDefaults, modelEntry, modelKey, modelRegistry, providerRegistry, repairEscapeDamage, resolveTransport, routeRejection, routeResponse };

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"
   }
@@ -228,6 +199,11 @@ var UNMEASURED_MODEL = {
 };
 var modelKey = (provider, model) => `${provider}/${model}`;
 var modelEntry = (provider, model) => modelRegistry[modelKey(provider, model)];
+var GPT_OSS_ON_GROQ = { temperature: 1, topP: 1, maxTokens: 16384 };
+var modelDefaults = {
+  "groq/openai/gpt-oss-120b": GPT_OSS_ON_GROQ,
+  "groq/openai/gpt-oss-20b": GPT_OSS_ON_GROQ
+};
 var resolveApiKey = (envKey, explicitKey) => explicitKey ?? (typeof process !== "undefined" ? process.env?.[envKey] : void 0);
 var chatProviderEntry = (id) => {
   const entry = providerRegistry[id];
@@ -379,9 +355,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 +682,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;
@@ -1341,6 +1314,10 @@ var modelRowOf = (config) => {
   const model = config.model ?? entry.defaultModel;
   return { provider: config.provider, model, row: modelEntry(config.provider, model) };
 };
+var defaultsOf = (config) => {
+  const resolved = modelRowOf(config);
+  return resolved === void 0 ? void 0 : modelDefaults[modelKey(resolved.provider, resolved.model)];
+};
 var resolveCapabilities = (config) => {
   if (typeof config.provider === "string") {
     const entry = providerRegistry[config.provider];
@@ -1387,10 +1364,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,
@@ -1409,6 +1383,7 @@ var createSignalFromConfig = (config) => {
   let cachedAdapterKey;
   const wireStrategies = resolveWireStrategies(wireIdsOf(config));
   assertEffort(config, config.options?.reasoningEffort);
+  const defaults = defaultsOf(config);
   const getAdapter = async () => {
     const resolved = resolveProvider(config);
     const key = `${resolved.adapterType}:${resolved.baseUrl}:${resolved.apiKey}`;
@@ -1445,12 +1420,8 @@ 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 }
+      ...(defaults !== void 0 || config.options !== void 0 || request.options !== void 0) && {
+        options: { ...defaults, ...config.options, ...request.options }
       }
     };
     assertEffort(config, providerRequest.options?.reasoningEffort);
@@ -1483,8 +1454,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
@@ -1505,7 +1475,7 @@ var createSignalFromConfig = (config) => {
       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;
+      const merged = defaults !== void 0 || config.options !== void 0 || request.options !== void 0 ? { ...request, options: { ...defaults, ...config.options, ...request.options } } : request;
       assertEffort(config, merged.options?.reasoningEffort);
       try {
         for await (const event of executeStepStream({
@@ -1580,8 +1550,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 }
@@ -1589,7 +1558,6 @@ var createSignalFromConfig = (config) => {
     };
   };
   return {
-    // Builder methods
     apiKey: (key) => fork({ apiKey: key }),
     model: (m) => fork({ model: m }),
     systemPrompt: (prompt) => fork({ systemPrompt: prompt }),
@@ -1619,7 +1587,6 @@ var createSignalFromConfig = (config) => {
         modelKnown: false
       };
     },
-    // Execution — thin wrappers over the step core (src/complete.ts).
     complete: async (input) => runComplete(
       {
         messages: buildMessages(config, input),
@@ -1645,10 +1612,8 @@ var createSignalFromConfig = (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) {
@@ -1668,7 +1633,6 @@ var createSignalFromConfig = (config) => {
       }
       return response.embeddings;
     }),
-    // ─── Decisions ────────────────────────────────────────────
     decide: async (request) => {
       assertQuestions(request.questions);
       const started = Date.now();
@@ -1676,7 +1640,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") {
@@ -1784,8 +1747,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,
@@ -1821,6 +1783,6 @@ var resolveTransport = (spec, caps) => {
 // src/types.ts
 var REASONING_EFFORTS = ["none", "default", "minimal", "low", "medium", "high", "xhigh", "max"];
 
-export { ErrorCode, REASONING_EFFORTS, RESPOND_TOOL_NAME, SignalError, UNMEASURED_MODEL, chatProviderEntry, closeTruncated, createSignal, decodeJsonish, deepDecodeJsonish, defineTool, extractJson, isTruncatedJson, modelEntry, modelKey, modelRegistry, providerRegistry, repairEscapeDamage, resolveTransport, routeRejection, routeResponse };
+export { ErrorCode, REASONING_EFFORTS, RESPOND_TOOL_NAME, SignalError, UNMEASURED_MODEL, chatProviderEntry, closeTruncated, createSignal, decodeJsonish, deepDecodeJsonish, defineTool, extractJson, isTruncatedJson, modelDefaults, modelEntry, modelKey, modelRegistry, providerRegistry, repairEscapeDamage, resolveTransport, routeRejection, routeResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map