Function getToolSchema

packages/component-sdk/src/tool-helpers.ts:221–329

(component: ComponentDefinition)

 * - z.record(...) → { type: 'object', additionalProperties: {...} }
 */
export function getToolSchema(component: ComponentDefinition): ToolInputSchema {
  const inputsSchema = component.inputs;
  const parametersSchema = component.parameters;

  // 1. Generate full JSON Schema using Zod's built-in
  const fullSchema = (
    inputsSchema as { toJSONSchema(): Record<string, unknown> }
  ).toJSONSchema() as {
    properties?: Record<string, unknown>;
    required?: string[];
  };

  // 2. Get action input IDs (credentials excluded) - reuse existing function!
  const actionInputIds = getActionInputIds(component);
  const exposedParamIds = getExposedParameterIds(component);

  // 3. Filter properties to only include action inputs
  const filteredProperties = pick(
    (fullSchema.properties ?? {}) as Record<string, unknown>,
    actionInputIds
  );

  // 4. Filter required array
  const filteredRequired = (fullSchema.required ?? []).filter((id: string) =>
    actionInputIds.includes(id)
  );

  // 5. Add descriptions from port metadata
  const inputs = extractPorts(component.inputs);
  for (const input of inputs) {
    if (actionInputIds.includes(input.id)) {
      const prop = filteredProperties[input.id] as Record<string, unknown> | undefined;
      if (prop && !prop.description && (input.description ?? input.label)) {
        prop.description = input.description ?? input.label;
      }
    }
  }

  // 6. Use explicit inputSchema if provided (overrides inferred schema)
  if (component.toolProvider?.inputSchema) {
    const override = component.toolProvider.inputSchema;
    // Merge or replace depending on needs - for now we just use it as is if provided
    return override;
  }

  // 7. Add exposed parameters (if any)
  if (parametersSchema && exposedParamIds.length > 0) {
    const paramSchema = (
      parametersSchema as { toJSONSchema(): Record<string, unknown> }
    ).toJSONSchema() as {
      properties?: Record<string, unknown>;
      required?: string[];
    };

    const paramProperties = pick(
      (paramSchema.properties ?? {}) as Record<string, unknown>,
      exposedParamIds
    );