ruvnet/ruflo · error

[DEPRECATED] '${oldAPI}' is deprecated since ${mapping.since

Error message

[DEPRECATED] '${oldAPI}' is deprecated since ${mapping.since}. Use '${mapping.replacement}' instead.

What it means

Deprecation notice in translateDeprecatedAPI (warn mode): a caller invoked an old API mapped in DEPRECATED_API_MAP; the call is transparently translated to the replacement (args rewritten) and the warning is emitted once per API.

Source

Thrown at v3/@claude-flow/integration/src/sdk-bridge.ts:201

    oldAPI: string,
    args: unknown[]
  ): { newAPI: string; args: unknown[] } | null {
    const mapping = DEPRECATED_API_MAP[oldAPI];
    if (!mapping) {
      return null;
    }

    // Emit deprecation warning (once per API)
    if (!this.deprecationWarnings.has(oldAPI)) {
      this.deprecationWarnings.add(oldAPI);
      const message = `'${oldAPI}' is deprecated since ${mapping.since}. ` +
        `Use '${mapping.replacement}' instead.`;

      switch (this.config.fallbackBehavior) {
        case 'error':
          throw new Error(message);
        case 'warn':
          console.warn(`[DEPRECATED] ${message}`);
          this.emit('deprecation-warning', { oldAPI, mapping });
          break;
        case 'silent':
          // Log but don't warn
          break;
      }
    }

    const newArgs = mapping.transformer ? mapping.transformer(args) : args;
    return { newAPI: mapping.replacement, args: newArgs };
  }

  /**
   * Wrap an API call with compatibility handling
   */
  async wrapAPICall<T>(
    apiName: string,
    apiCall: () => Promise<T>,

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Migrate calls from the deprecated API to the named replacement before the deprecated API is removed.

When it happens

Trigger: Thrown at v3/@claude-flow/integration/src/sdk-bridge.ts:201 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/26413f5e02975ff9. Report an issue: GitHub.