Function createAttachFileTool

src/node/services/tools/attach_file.ts:14–76

(config: ToolConfiguration)

}

export const createAttachFileTool: ToolFactory = (config: ToolConfiguration) => {
  return tool({
    description: TOOL_DEFINITIONS.attach_file.description,
    inputSchema: TOOL_DEFINITIONS.attach_file.schema,
    execute: async (
      { path, mediaType, filename },
      { abortSignal }
    ): Promise<AttachFileToolResult> => {
      assert(typeof path === "string" && path.trim().length > 0, "attach_file requires a path");

      try {
        const result = await readAttachFileFromPath({
          path,
          mediaType,
          filename,
          cwd: config.cwd,
          runtime: config.runtime,
          abortSignal,
        });

        if (result.type === "display") {
          const label = formatDisplayOnlyFileLabel(result.file);
          return {
            type: "content",
            value: [
              {
                type: "text",
                text:
                  `[File shown to user: ${label}. ` +
                  "This type is not supported as a model attachment, so the model will receive this notice. Use another tool to inspect or convert the file if needed.]",
              },
              createDisplayOnlyFilePart(result.file),
            ],
          };
        }

        const attachment = result.attachment;
        assert(attachment.data.length > 0, "attach_file produced empty attachment data");

        return {
          type: "content",
          value: [
            {
              type: "text",
              text: `[Attachment prepared: ${attachment.filename ?? attachment.mediaType}]`,
            },
            {
              type: "media",
              data: attachment.data,
              mediaType: attachment.mediaType,
              ...(attachment.filename ? { filename: attachment.filename } : {}),
            },
          ],
        };
      } catch (error) {
        return {
          success: false,
          error: getErrorMessage(error),