/**
 * Residual Connection Kernels
 *
 * Provides element-wise addition operations for:
 * - Residual connections (add two tensors)
 * - Bias addition
 */

import type { Tensor } from '../tensor.js';
import type { CommandRecorder } from '../command-recorder.js';
import type { OutputBufferOptions } from './types.js';
import type { ExecutionV1PoliciesSchema } from '../../config/schema/execution-v1.schema.js';

/** Residual kernel options */
export interface ResidualOptions extends OutputBufferOptions {
  useVec4?: boolean;
  outputScale?: number | null;
  dataOffset?: number;
  biasOffset?: number;
  executionPolicies?: ExecutionV1PoliciesSchema | null;
}

/**
 * Run residual add (element-wise addition)
 */
export declare function runResidualAdd(
  a: Tensor,
  b: Tensor,
  size: number,
  options?: ResidualOptions
): Promise<Tensor>;

/**
 * Run bias add
 */
export declare function runBiasAdd(
  data: Tensor,
  bias: Tensor,
  numTokens: number,
  dim: number,
  options?: ResidualOptions
): Promise<Tensor>;

/**
 * Record residual add (batched, no submit)
 */
export declare function recordResidualAdd(
  recorder: CommandRecorder,
  a: Tensor,
  b: Tensor,
  size: number,
  options?: ResidualOptions
): Promise<Tensor>;

/**
 * Record bias add (batched, no submit)
 */
export declare function recordBiasAdd(
  recorder: CommandRecorder,
  data: Tensor,
  bias: Tensor,
  numTokens: number,
  dim: number,
  options?: ResidualOptions
): Promise<Tensor>;