@niscorp/signal 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @niscorp/signal
 
+## 0.1.5
+
+### Patch Changes
+
+- c952ab0: A request to a model gets the options its maker or provider documents for whatever the caller leaves unset: `modelDefaults`, exported beside `modelRegistry`. gpt-oss on Groq gets temperature 1 and top_p 1, OpenAI's sampling for it (at temperature 0 its reasoning repeats one sentence until the budget runs out), and maxTokens 16,384, because Groq ends a completion at 3,072 tokens unless asked for more and reasoning alone can pass that. The caller's options always win.
+
 ## 0.1.4
 
 ### Patch Changes

package/DOCS.md

@@ -146,6 +146,13 @@ Set LLM options: `temperature`, `maxTokens`, `topP`, `stopSequences`, `seed`, `s
 signal.options({ temperature: 0 })
 ```
 
+### Model defaults
+Some models need options their caller does not know to set. `modelDefaults` (beside `modelRegistry` in `src/registry.ts`, exported) holds them, and a request gets them for whatever the caller leaves unset: the caller's options always win. gpt-oss on Groq gets `temperature: 1` and `topP: 1`, OpenAI's sampling for it (at temperature 0 its reasoning repeats one sentence until the budget runs out), and `maxTokens: 16384`, because Groq ends a completion at 3,072 tokens unless asked for more, and reasoning alone can pass that.
+```typescript
+createSignal('groq').model('openai/gpt-oss-120b')                      // temperature 1, top_p 1, max_completion_tokens 16384
+createSignal('groq').model('openai/gpt-oss-120b').options({ maxTokens: 4000 }) // temperature 1, top_p 1, max_completion_tokens 4000
+```
+
 ### Capabilities — looked up, not configured
 What a client can do is the provider's registry row (what the ENDPOINT
 does) joined with the model's registry row (what the MODEL does, as

package/dist/index.cjs

@@ -201,6 +201,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];
@@ -1311,6 +1316,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];
@@ -1376,6 +1385,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}`;
@@ -1412,8 +1422,8 @@ var createSignalFromConfig = (config) => {
       ...providerTools && { tools: providerTools },
       ...request.toolChoice !== void 0 && { toolChoice: request.toolChoice },
       ...request.responseFormat !== void 0 && { responseFormat: request.responseFormat },
-      ...(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);
@@ -1467,7 +1477,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({
@@ -1788,6 +1798,7 @@ exports.deepDecodeJsonish = deepDecodeJsonish;
 exports.defineTool = defineTool;
 exports.extractJson = extractJson;
 exports.isTruncatedJson = isTruncatedJson;
+exports.modelDefaults = modelDefaults;
 exports.modelEntry = modelEntry;
 exports.modelKey = modelKey;
 exports.modelRegistry = modelRegistry;