@flutchai/flutch-sdk 0.2.11 → 0.2.15

package/README.md

@@ -522,6 +522,43 @@ Currently supports LangGraph.js. The architecture is designed to support other g
 - **Multi-step Workflows**: Orchestrate complex AI pipelines
 - **Interactive Assistants**: Create agents with callbacks and dynamic UIs
 
+## Publishing
+
+The package is automatically published to [npmjs.org](https://www.npmjs.com/package/@flutchai/flutch-sdk) on every merge to `main` via GitHub Actions.
+
+### How it works
+
+1. On merge to `main`, the [release workflow](.github/workflows/release.yml) runs
+2. It reads the version from `package.json`
+3. If a git tag `v{version}` does not exist yet — it creates the tag and publishes to npm
+4. If the tag already exists — all publish steps are skipped (idempotent)
+
+Publishing uses [npm OIDC Trusted Publishing](https://docs.npmjs.com/generating-provenance-statements) — no npm token secret is required. The GitHub Actions runner authenticates directly with npmjs.org via OpenID Connect.
+
+### Rules
+
+- **Bump the version before merging** — if `package.json` version matches an existing git tag, nothing will be published
+- **Use semantic versioning** — `MAJOR.MINOR.PATCH` (e.g. `0.2.14`)
+  - `PATCH` — bug fixes, minor improvements
+  - `MINOR` — new backward-compatible features
+  - `MAJOR` — breaking changes
+- **One version bump per PR** — keep version changes isolated from feature/fix changes when possible
+
+### Releasing a new version
+
+```bash
+# 1. Create a branch
+git checkout -b chore/bump-version-X.Y.Z
+
+# 2. Update version in package.json
+# "version": "X.Y.Z"
+
+# 3. Push and open a PR
+git push origin chore/bump-version-X.Y.Z
+
+# 4. Merge the PR — publishing happens automatically
+```
+
 ## Links
 
 - [GitHub Repository](https://github.com/flutchai/node-sdk)

package/dist/index.cjs

@@ -4477,11 +4477,17 @@ async function executeToolWithAttachments(params) {
     threshold = DEFAULT_ATTACHMENT_THRESHOLD,
     injectIntoArg = "data",
     sourceAttachmentId,
-    threadId
+    threadId,
+    toolSchema
   } = params;
   const argsWithInjection = { ...enrichedArgs };
   try {
-    if (shouldInjectData(argsWithInjection, attachments, injectIntoArg)) {
+    if (shouldInjectData(
+      argsWithInjection,
+      attachments,
+      injectIntoArg,
+      toolSchema
+    )) {
       const attachment = sourceAttachmentId ? attachments[sourceAttachmentId] : getLatestAttachment(attachments);
       if (attachment) {
         const attachmentKey = sourceAttachmentId || attachment.toolCallId;
@@ -4543,9 +4549,17 @@ async function executeToolWithAttachments(params) {
   });
   return { toolMessage };
 }
-function shouldInjectData(args, attachments, dataArgName) {
+function shouldInjectData(args, attachments, dataArgName, toolSchema) {
   if (Object.keys(attachments).length === 0) return false;
-  return args[dataArgName] === void 0;
+  if (args[dataArgName] !== void 0) return false;
+  if (toolSchema) {
+    const hasProperty = toolSchema.properties && dataArgName in toolSchema.properties;
+    const isRequired = toolSchema.required?.includes(dataArgName);
+    if (!hasProperty && !isRequired) {
+      return false;
+    }
+  }
+  return true;
 }
 var _internals = {
   shouldInjectData,
@@ -6452,12 +6466,19 @@ function hashToolsConfig(toolsConfig) {
   const sorted = toolsConfig.map((t) => `${t.toolName}:${t.enabled}:${JSON.stringify(t.config || {})}`).sort().join("|");
   return crypto.createHash("md5").update(sorted).digest("hex").slice(0, 16);
 }
-function generateModelCacheKey(modelId, temperature, maxTokens, toolsConfig) {
+var DEFAULT_ROUTER_URL = "https://router.flutch.ai";
+function resolveRouterURL(baseURL) {
+  return baseURL ?? process.env.FLUTCH_ROUTER_URL ?? DEFAULT_ROUTER_URL;
+}
+function generateModelCacheKey(modelId, temperature, maxTokens, toolsConfig, baseURL) {
   const parts = [
     modelId,
     temperature ?? "default",
     maxTokens ?? "default"
   ];
+  if (baseURL) {
+    parts.push(baseURL);
+  }
   if (toolsConfig && toolsConfig.length > 0) {
     parts.push(hashToolsConfig(toolsConfig));
   }
@@ -6585,7 +6606,8 @@ var ModelInitializer = class _ModelInitializer {
       config.modelId,
       config.temperature,
       config.maxTokens,
-      config.toolsConfig
+      config.toolsConfig,
+      config.baseURL
     );
   }
   // Chat model creators
@@ -6594,7 +6616,8 @@ var ModelInitializer = class _ModelInitializer {
       modelName,
       defaultTemperature,
       defaultMaxTokens,
-      apiToken
+      apiToken,
+      baseURL
     }) => {
       const config = buildOpenAIModelConfig(
         modelName,
@@ -6602,18 +6625,21 @@ var ModelInitializer = class _ModelInitializer {
         defaultMaxTokens,
         apiToken || this.resolveApiKey("openai" /* OPENAI */) || ""
       );
+      config.configuration = { baseURL: `${resolveRouterURL(baseURL)}/v1` };
       return new openai.ChatOpenAI(config);
     },
     ["anthropic" /* ANTHROPIC */]: ({
       modelName,
       defaultTemperature,
       defaultMaxTokens,
-      apiToken
+      apiToken,
+      baseURL
     }) => new anthropic.ChatAnthropic({
       modelName,
       temperature: defaultTemperature,
       maxTokens: defaultMaxTokens,
-      anthropicApiKey: apiToken || this.resolveApiKey("anthropic" /* ANTHROPIC */)
+      anthropicApiKey: apiToken || this.resolveApiKey("anthropic" /* ANTHROPIC */),
+      anthropicApiUrl: resolveRouterURL(baseURL)
     }),
     ["cohere" /* COHERE */]: ({
       modelName,
@@ -6629,12 +6655,17 @@ var ModelInitializer = class _ModelInitializer {
       modelName,
       defaultTemperature,
       defaultMaxTokens,
-      apiToken
+      apiToken,
+      baseURL
     }) => new mistralai.ChatMistralAI({
       model: modelName,
       temperature: defaultTemperature,
       maxTokens: defaultMaxTokens,
-      apiKey: apiToken || this.resolveApiKey("mistral" /* MISTRAL */)
+      apiKey: apiToken || this.resolveApiKey("mistral" /* MISTRAL */),
+      // Route through the same gateway as OpenAI/Anthropic.
+      // Without serverURL, ChatMistralAI ignores FLUTCH_ROUTER_URL and calls
+      // api.mistral.ai directly — inconsistent with other providers.
+      serverURL: `${resolveRouterURL(baseURL)}/v1`
     }),
     ["voyageai" /* VOYAGEAI */]: () => {
       throw new Error("VoyageAI chat models not implemented");
@@ -6695,7 +6726,8 @@ var ModelInitializer = class _ModelInitializer {
       ),
       defaultMaxTokens: Number(
         config.maxTokens ?? modelConfig.defaultMaxTokens
-      )
+      ),
+      baseURL: config.baseURL ?? modelConfig.baseURL
     };
     this.logger.debug(`Creating new chat model instance: ${cacheKey}`);
     let model;